Syfre : /* Prise en compte des droits utilisateurs */

2009-07-25T07:16:46Z

Prise en compte des droits utilisateurs

Syfre : /* Contrôle des erreurs métiers */

2009-07-18T17:10:50Z

Contrôle des erreurs métiers

Syfre : Nouvelle page : ===Ecriture de processus=== Un processus (ou traitement) est une opération réalisée sur un ensemble d’objets. ===Modélisation d’un processus=== Il est commode d’implément...

2009-07-18T16:54:12Z

Nouvelle page : ===Ecriture de processus=== Un processus (ou traitement) est une opération réalisée sur un ensemble d’objets. ===Modélisation d’un processus=== Il est commode d’implément...

Nouvelle page

===Ecriture de processus===
Un processus (ou traitement) est une opération réalisée sur un ensemble d’objets.

===Modélisation d’un processus===
Il est commode d’implémenter les processus à l’aide d’une ou plusieurs classes non persistantes.

En général un processus comprendra :
*Une ou plusieurs classes non persistantes définies au cours de la modélisation.
*Un écran d’exécution réalisant l’interface utilisateur.

L’écran d’exécution du processus doit comporter un « dataset » portant sur la classe non persistante du processus. A l’ouverture de l’écran, une instance de cette classe est automatiquement créée par le framwork d’interface. Cette instance est responsable de l’exécution du processus.

Exemple

'''Processus de régularisation du lettrage'''

Les zones de sélection de la fenêtre se retrouvent dans les attributs et dans les rôles de la classe processus.
Les autres attributs et rôles n’apparaissent pas dans la fenêtre mais sont utilisés dans le programme des fonctions et des règles.
La fonction Executer() est exécutée lorsque le bouton Exécuter est actionné.

Fenêtre d’exécution du processus de régularisation du lettrage.

Ecrans d’exécution et contrôle du processus
Un écran d’exécution doit au moins comporter les éléments suivants :
*Un composant « dataset » portant sur la classe non persistante implémentant le processus.
*Un composant « invoker » permettant de déclencher et contrôler l’exécution du processus.
*Un contrôle de déclenchement de l’exécution du processus, généralement un bouton.
L’écran peut comporter des éléments permettant au code métier du processus d’interagir avec l’utilisateur :
*Un contrôle affichant les messages émis par le code métier, généralement un contrôle de type mémo.
*Un contrôle « barre de progression » permettant d’afficher la progression de réalisation du traitement.
*Un contrôle de déclenchement permettant d’interrompre le processus, généralement un bouton.

===Messages utilisateur, progression et interruption===
Le framework offre un ensemble de services permettant au code métier d’interagir avec l’utilisateur.

Voir [[Interactions utilisateur (code)|Interactions utilisateur]]

{{info|Il n’existe pas de service permettant l’ouverture de boîte de dialogue directement à partir du code métier.}}

===Gestion des transactions dans les processus===
Dans un écran portant sur une classe non persistante la modification d’un attribut ne déclenche pas une transaction implicite. La transaction doit donc être gérée explicitement par le code métier du processus à l’aide des API de contrôle de transaction .

Voir [[Transactions (code)|La gestion des transactions]]

===Contrôle des erreurs===
====Contrôle des erreurs d’exécution====
Le code métier a la possibilité de gérer les erreurs d’exécution à l’aide d’un bloc d’exception ; il peut alors intercepter l'exception et émettre le message vers l'interface utilisateur.

Exemple
<source lang='delphi'>
procedure doMiseAJourAxeAnalytiqueAPlat;
try
_SupprimerEspaces;
_MajEspaces ;
ClassManager.CommitLongTran;
except
ClassManager.RollBackLongTran;
ProgressMessage('Erreur dans la mise à jour de l''axe analytique à plat') ;
ProgressMessage(E.Message) ;
Completed := False ;
end;
</source>

====Contrôle des erreurs métiers====
Le [[ClassManager (code)|ClassManager]] dispose de services pour contrôler le déclenchement des messages d'erreurs et d'alertes des règles.

<source lang='delphi'>Classmanager.hasgui:Boolean;</source>
Bloque tous les messages d’erreurs ou d’alertes tant qu’il est positionné à False. Aucun message n’apparaît. Cela permet de ne pas bloquer des traitements longs par des messages d’alerte ou d’erreur. Ceux-ci sont gérés en bloc dans le traitement.

<source lang='delphi'>Classmanager.NoAlert:Boolean ;</source>
Bloque tous les messages d’alerte tant qu’il est positionné à True.

===Déclenchement d’exceptions métier===
Le code métier a la possibilité de lever des exceptions métiers qui permettent d’interrompre élégamment un traitement.

<source lang='delphi'>Raise ERule.Create</source>

Exemple
<source lang='delphi'>
begin
...
if Assigned(deviseBR) and (deviseBR.CodeISO = 'FRF')
then Result := 'F'
else
if Assigned(deviseBR) and (deviseBR.CodeISO = 'EUR')
then Result := 'E'
else raise ERule.Create('La devise de compte bancaire doit être FRF ou EUR');
...
end;
</source>

===Prise en compte des droits utilisateurs===
Les droits utilisateurs ajoutés dans l’administration permettent de poser des restrictions sur les données accessibles à l’utilisateur et sur les actions qu’il est autorisé à effectuer.

Cependant ces droits ne sont pas pris en compte automatiquement dans les processus pour deux raisons :
*La première est qu’il aurait été très difficile de le faire du fait que le processus peut écrire du code SQL directement à travers des curseurs.
*La seconde est qu’il aurait été très difficile d’assurer un fonctionnement cohérent des traitements, les droits pouvant affecter de manière imprévisible le déroulement normal d’un traitement.

Dans certain cas particulier il peut être néanmoins nécessaire de prendre en compte les droits dans certains processus, par exemple ceux effectuant des consultations de données. Pour ce faire une API a été ajoutée au langage de script permettant au code métier de récupérer les éléments de droits et de les appliquer dans le code métier.

En générale les droits de lecture se traduisent par des filtres qui doivent être appliqué aux différentes requêtes.

Voir [[Prise en compte des droits (code)|La prise en compte des droits dans les processus]]

{{Footer|Code métier}}
[[category:Code métier]]

@@ Ligne 97 : / Ligne 97 : @@
 En générale les droits de lecture se traduisent par des filtres qui doivent être appliqué aux différentes requêtes.
-Voir [[Prise en compte des droits (code)|La prise en compte des droits dans les processus]]
+Voir aussi :
 {{Footer|Code métier}}
 [[category:Code métier]]

@@ Ligne 65 : / Ligne 65 : @@
 Le [[ClassManager (code)|ClassManager]] dispose de services pour contrôler le déclenchement des messages d'erreurs et d'alertes des règles.
-<source lang='delphi'>Classmanager.hasgui:Boolean;</source>
+Voir [[Contrôle du contexte de session (CM)|Contrôle du contexte de session]]
-Bloque tous les messages d’erreurs ou d’alertes tant qu’il est positionné à False. Aucun message n’apparaît. Cela permet de ne pas bloquer des traitements longs par des messages d’alerte ou d’erreur. Ceux-ci sont gérés en bloc dans le traitement.
-−
-<source lang='delphi'>Classmanager.NoAlert:Boolean ;</source>
-Bloque tous les messages d’alerte tant qu’il est positionné à True.
 ===Déclenchement d’exceptions métier===

Conseils pour l'écriture des processus (code) - Historique des versions

Syfre : /* Prise en compte des droits utilisateurs */

Syfre : /* Contrôle des erreurs métiers */

Syfre : Nouvelle page : ===Ecriture de processus=== Un processus (ou traitement) est une opération réalisée sur un ensemble d’objets. ===Modélisation d’un processus=== Il est commode d’implément...