Structures communes

Cette catégorie contient toutes les structures communes dans les actions qui peuvent se retrouver dans toutes les catégories d’actions

Filtre (Filtre des requêtes)

Key (Identifiant d'un record)

Page (Selection d'une page)

Presentation (Présentation d'une tâche)

Screen (paramétrage des champs d'une tâche)

Filtre (Filtre des requêtes)

Le filter d’une tâche permet de limiter les entrées chargées dans le navigateur à l’ouverture

Exemple

<filter>
  <elem datafieldId="GTPEVT.SOURCE">CRM</elem>
  <elem datafieldId="GTPEVT.EVENTSTART"><![CDATA[> ${current_iso_date}]]></elem>
</filter>

Dans cet exemple, la tâche ouverte filtrera les données pour n’afficher que les entrées (ici des évènements) qui ont comme source CRMand comme date de début une date plus grande que le moment actuel de l’appel.

Structure

Un filter est un ensemble d’entrées elem

Chaque elem indique le datafieldId sur lequel il faut filter avec comme text sa valeur

Key (Identifiant d'un record)

Une key est une structure permettant de référencer un record dans le model standard SAINET.

Exemple

<key>
  <datafield datafieldId="CRMPRJ.ID_PK">15-00091</datafield>
</key>

Dans cet exemple, la clé fait référence à une table CRMPRJ dont la clé est ID_PK. La valeur de cette clé est 15-00091. En d’autres termes, imaginons que cette table soit une table de dossier, cette clé référence le dossier 15-00091

Structure

Une key est un ensemble de datafields. Ces datafields doivent correspondre aux datafields clés de la table ciblée. Un record ne pouvant pas être identifié par une key pouvant pointer sur plusieurs records.

Chaque datafield possède un attribut datafieldId qui pointe vers un champ clé de la table.

Chaque noeud possède comme valeur texte la valeur de ce champ dans la base.

Utilisation

Les key sont principalement utilisées pour cibler des records lors de download de documents, ou pour ouvrir des records particuliers dans les navigateurs dans les tâches de saisies.

Page (Selection d'une page)

Le noeud xml page permet de selectionner une page particulière du dossier.

Exemple

<page occurrence="3">PAGE_INTERVENANT</page>

Dans cet exemple, seule la 3ème page intervenant est sélectionnée.

Structure

L’attribut occurrence représente le numéro unique de la page pour ce type de page.

Le texte du noeud représente l’identifiant de ce type de page.

Presentation (Présentation d'une tâche)

La presentation d’une tâche permet de limiter les composants visibles sur une tâche.

Exemple

<presentation state="maximized" type="full_simplified">
  ...
</presentation>

Dans cet exemple, la tâche sera affichée en plein écran et sera simplifiée au maximum. Dans le cas d’une tâche de vue, seule la grille de résultat serait affichée, sans les propriétés de lancement ni les actions d’exports.

Structure

L’attribut state représente la taille de la tâche et peut contenir les valeurs suivantes :

normal - La tâche est affichée selon son paramétrage
hidden - La tâche est lancée mais l’utilisateur ne la voit pas
maximized - La tâche est lancée en pleine écran.
minimized - La tâche est lancée minimisée. L’utilisateur pourra cliquer dessus pour l’agrandir à nouveau

L’attribut type permet de cacher des éléments visuels basé sur des pré-définitions codées dans le framework. Les valeurs possibles sont les suivantes :

normal - Aucun changement n’est appliqué
simplified - Pas de header, pas d’aide, pas de navigateur, pas de raccourcis
full_simplified - Pas de header, pas d’aide, pas de navigateur, pas de bannière
micro_popup - Pas de header, pas d’aide, pas de navigateur, pas de raccourcis, pas de cadre, les boutons de validation sont intégrés dans l’écran directement

Screen (paramétrage des champs d'une tâche)

Un screen est un noeud xml qui permet de remplir les champs d’une tâche avec des valeurs.

Exemple

<screen operation="create">
  <field id="MOIS_DEBUT" datafieldId="SAL_MOIS_DEBANN">1</field>
  <field id="MOIS_FIN" datafieldId="SAL_MOIS_FINANN">12</field>
</screen>

Dans cet exemple, l’écran de la tâche liée à l’action qui utilise ce screen remplira les champs qui ont pour fieldId MOIS_DEBUT et MOIS_FIN avec leur valeur respectives 1 et 12. La tâche sera mise en mode nouveau avant de remplir les champs

Structure

Un screen est un ensemble de field, chaque représentant une champ dans l’ecran. Chaque field est référencé par son id et son datafieldId qui doivent correspondre à ceux de la tâche à remplir.

L’operation indique l’état de la tâche au moment du remplissage. Les valeurs possibles sont :

create cette operation va mettre la tâche ne mode création de nouveau record avant de remplir les champs
selectAndLoad après remplissage, la tâche va se lancer. Ceci est un raccourci qui éviter d’avoir à appeller execute_task après le remplissage

Le fillMode permet, lorsque l’attribut operation est en mode nouveau, de remplir les valeurs du descripteur à priori ou à posteriori. Par exemple, si un OnPrepareNewPage ou un OnPrepareNewEntry est éxécuté, il arrive parfois que le descripteur contienne les valeurs avant d’appeler le serveur, et des fois écraser simplement le retour par les valeurs données. Les deux valeurs possibles sont :

before : Le descripteur est rempli avant de faire l’appel serveur
after(défaut) : Le descripteur est rempli après avoir fait l’appel au serveur

Enfin, le field contient la valeur en tant que texte du noeud. Dans le cas de caractère spéciaux, il faut ajouter du <![CDATA[ ... ]]> pour maintenir le xml valide

Utilisation

Il est notament utilisé en fonction des actions pour pré-remplir les écrans de tâche pour accelérer la création de nouvelles entrées liées au contexte courant, ou alors pour remplir les champs d’une tâche d’output (liste, traitement) pour accelérer le processus.