...

Le Framework SFK fournit un mécanisme qui permet de filtrer l’accès aux données.
Ce mécanisme est comparable à la mécanique de filtre de synchro du Mobile.
On va ainsi fournir un moyen de construire la liste des éléments accessibles pour un utilisateur connecté.

Comment fonctionne le rowaccess ?

...

Deux tables systèmes contiennent les informations nécessaires pour la gestion des droits d’accès.

sw_sys_rowaccessstatus

Liste les demandes de calculs de droits d’accès

...

BEL : on n’indique jamais le type des colonnes; normal?

...

de

...

droits d’accès

...

...

computeDate
La date de calcul de droits d’accès

...

computeDuration
La durée de calcul en millisecondes

Liste les tables ayant un calcul de rowaccess (en comptant le nombre de comptecomptes)

SELECT
  ras.metatable_ID, mt.schemaTable, COUNT(ras.device_ID) AS nbDevice
FROM sw_sys_rowaccessstatus AS ras
INNER JOIN sw_sys_metatable AS mt
  ON mt.metatable_ID = ras.metatable_ID
GROUP BY ras.metatable_ID;

...

Liste les éléments pour lesquelles l’utilisateur a le droit d’accéder

...

...

...

...

Liste les tables et comptes ayant des rowaccess (en comptant le nombre d'éléments accessibles par table) :

...

Le rowaccess est lié à une table.
Le calcul est lancé pour un compte connecté.
Pour construire la liste des rowID, il faut utiliser un datasource de type “rowaccess”.
Avec les 3 propriétés suivantes

...

...

...

...

...

...

Pour demander le calcul d’un rowaccess, il faut utiliser une des méthodes de script client suivantes

...

SFK a un mécanisme pour éviter la surcharge du serveur avec des demandes de calcul trop fréquentes.
S’il y a moins de 5 minutes entre une demande de calcul et la précédente, alors SFK refuse le calcul de droit d’accès. La propriété optionnelle foreceUpdate permet d’obliger le recalcul.
En standard, à la connexion (aussi valable avec F5), on utilise la demande de calcul sans forcer. Par contre lors d’une création ou avec à l’utilisation du bouton de la barre de notification qui permet de mettre à jour les droits d’accès, on force le calcul.

Bouton pour forcer le recalcul de rowaccess

Pour un projet, il est possible d’activer un bouton dans la barre de notification avec la variable RowAccess.ManualRefresh.Enabled.

...

Ce bouton permet de lancer un recalcul manuel sans tenir compte du délai du cache de tous les rowaccess.
Ce bouton est disponible depuis la version 5.5.

Application du rowaccess

A partir du moment où l’on a une demande de calcul dans la table sw_sys_rowaccessstatus pour une table, cette table sera alors soumise à un droit d’accès. Et tous les comptes qui n’ont pas de ligne pour la table dans sw_sys_rowaccess n’ont aucun accès pour cette table.
Note : c’est valable aussi pour les comptes externes (Extranet). Donc lorsqu’on ajoute un rowaccess, il faut s’assurer que les comptes externes ne sont pas altérés.

...

• un formulaire (crud)
  Si le crud utilise un datasource de type “table” dont la table est soumise à un rowaccess, les droits d’accès sont automatiquement gérés. Il faut alors avoir accès à l’ID pour accéder au que les données soient chargées dans le formulaire.

• dans n’importe quel datasource avec une requête SQL (utilisé par une grid, un graph, une combobox, …)
  Si l’on utilise la syntaxe {{TABLE(<nom_de_table>, <alias_de_table>)}} avec une table soumise à un rowaccess alors la requête va intègrer un filtre avec sw_sys_rowaccess.
  Note : la syntaxe peut être utilisé pour les clauses FROM et INNER JOIN.

• un élément dans une liste d’entité (entityviews)
  Si l’entité est une table soumise à un rowaccess, alors la requête pour construire la liste va intégrer un filtre avec sw_sys_rowaccess.
  Si la propriété Data.ApplyRestrictions est utilisée sur une colonne de type foreign dont le schema est définit sur une table soumise à un rowaccess alors la requête pour construire la liste va intégrer un filtre avec sw_sys_rowaccess.

...

Il faut retirer toutes les occurrences des fonctions $rowAccess.setByDatasourceAsync et $rowAccess.setByDatasourcesAsync utilisant le(s) datasource de type “rowaccess” avec le TableName correspondant à la table pour laquelle on veut désactiver.Note : ne

Historique d’utilisation

Ce mécanisme est mis à disposition par le Framework SFK depuis février 2021.
Il a d’abord été intégré pour filtrer l’accès au tiers (table sw_data_customer) dans les versions suivantes de weavy 5.3, 5.4, 5.5, 5.6 et 5.7.

...

• Parallélisation de l’exécution des requêtes listant les ID accessibles par l'utilisateur connecté.
  Attention : l’ajout L’ajout et la suppression étant dans l’unique table sw_sys_rowaccess, ces traitements ne sont pas parallélisables car il y a un lock de la table.

• Réécriture des requêtes et ajouts d’index pour optimiser l’exécution.

• Algorithme d’optimisation de traitements

  • Supprimer tous les ID d’une table; puis insérer tous les ID d’une table

  • Faire le diff de modifications apportées; s’il est inférieur à 500 changements alors la modification est faite de manière plus fine