ONYX - 9.0 - Utilisation - Gestion des workflows-Les fondamentaux

Différence entre versions

De MappingDoc
(Cette version a été marquée pour être traduite)
Ligne 1 : Ligne 1 :
 
<languages/>
 
<languages/>
 
<translate>
 
<translate>
===Introduction===
+
===Introduction=== <!--T:1-->
  
 +
<!--T:2-->
 
[[Fichier:OX S wrkf1.png|centré|sans_cadre|959x959px]]
 
[[Fichier:OX S wrkf1.png|centré|sans_cadre|959x959px]]
  
  
 +
<!--T:3-->
 
Les Workflows composent le Moteur d’exécution ONYX Server. Un Workflow est défini comme un ensemble de conditions et de commandes paramétrables, exécutées lorsqu’un nouveau fichier arrive sur un connecteur d’entrée (robot Scanfolder, serveur d’écoute, point d’entrée, ou par requête Web Service). Les commandes sont traitées séquentiellement c’est-à-dire que la deuxième commande sera traitée après exécution correcte de la première, jusqu’à la fin du Workflow.
 
Les Workflows composent le Moteur d’exécution ONYX Server. Un Workflow est défini comme un ensemble de conditions et de commandes paramétrables, exécutées lorsqu’un nouveau fichier arrive sur un connecteur d’entrée (robot Scanfolder, serveur d’écoute, point d’entrée, ou par requête Web Service). Les commandes sont traitées séquentiellement c’est-à-dire que la deuxième commande sera traitée après exécution correcte de la première, jusqu’à la fin du Workflow.
  
 +
<!--T:4-->
 
Un Workflow se définit graphiquement en connectant différents objets de type commandes, conditions et/ou paramètres. Il est nommé de façon unique et doit être attaché au moins à un connecteur pour être actif.
 
Un Workflow se définit graphiquement en connectant différents objets de type commandes, conditions et/ou paramètres. Il est nommé de façon unique et doit être attaché au moins à un connecteur pour être actif.
  
 +
<!--T:5-->
 
Les Workflows sont sauvegardés sur disque dans des fichiers au format XML dans le sous-répertoire workflow du répertoire des règles spécifié par la variable de configuration RULES_PATH.
 
Les Workflows sont sauvegardés sur disque dans des fichiers au format XML dans le sous-répertoire workflow du répertoire des règles spécifié par la variable de configuration RULES_PATH.
  
 +
<!--T:6-->
 
Sur l’interface Web d'ONYX Server, la page d’administration et de configuration des Workflows s’obtient par le Menu d’Administration puis Gestion des Workflows ou par le lien direct :
 
Sur l’interface Web d'ONYX Server, la page d’administration et de configuration des Workflows s’obtient par le Menu d’Administration puis Gestion des Workflows ou par le lien direct :
 
http://127.0.0.1:8004/JS_Common/workflow/index.html
 
http://127.0.0.1:8004/JS_Common/workflow/index.html
  
 +
<!--T:7-->
 
Conseil : Pour un meilleur confort d’utilisation, le navigateur Firefox est vivement recommandé.
 
Conseil : Pour un meilleur confort d’utilisation, le navigateur Firefox est vivement recommandé.
  
===Configuration===
+
===Configuration=== <!--T:8-->
  
 +
<!--T:9-->
 
Une nouvelle section WORKFLOW est ajoutée dans le fichier de configuration d'ONYX Server contenant un certain nombre de paramètres de configuration pour le moteur d’exécution des Workflows ainsi que pour les fonctionnalités Web Service (SOAP_*) :
 
Une nouvelle section WORKFLOW est ajoutée dans le fichier de configuration d'ONYX Server contenant un certain nombre de paramètres de configuration pour le moteur d’exécution des Workflows ainsi que pour les fonctionnalités Web Service (SOAP_*) :
  
 +
<!--T:10-->
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
Ligne 28 : Ligne 36 :
 
On / Off (par défaut)
 
On / Off (par défaut)
  
 +
<!--T:11-->
 
|-
 
|-
 
|SOAP_PATH_TEMP||Chemin local des fichiers temporaires
 
|SOAP_PATH_TEMP||Chemin local des fichiers temporaires
 
E:\MappingWindows\Temp\HTTPServer
 
E:\MappingWindows\Temp\HTTPServer
  
 +
<!--T:12-->
 
|-
 
|-
 
|SOAP_PATH_LOG||Chemin local des journaux de log
 
|SOAP_PATH_LOG||Chemin local des journaux de log
 
E:\MappingWindows\Temp\HTTPServer
 
E:\MappingWindows\Temp\HTTPServer
  
 +
<!--T:13-->
 
|-
 
|-
 
|SOAP_LOCAL_URL||Chemin distant du répertoire partagé (échanges de fichiers)
 
|SOAP_LOCAL_URL||Chemin distant du répertoire partagé (échanges de fichiers)
 
http://127.0.0.1:8004/shareFolder
 
http://127.0.0.1:8004/shareFolder
  
 +
<!--T:14-->
 
|-
 
|-
 
|SOAP_DOCUMENT_URL||Chemin distant du répertoire partagé (échanges de fichiers)
 
|SOAP_DOCUMENT_URL||Chemin distant du répertoire partagé (échanges de fichiers)
 
http://127.0.0.1:8004/shareFolder
 
http://127.0.0.1:8004/shareFolder
  
 +
<!--T:15-->
 
|-
 
|-
 
|SOAP_LOCATION||Chemin distant du moteur Web Services Mapping
 
|SOAP_LOCATION||Chemin distant du moteur Web Services Mapping
 
http://127.0.0.1:8004/cgi-bin/mapsoapserver.exe
 
http://127.0.0.1:8004/cgi-bin/mapsoapserver.exe
  
 +
<!--T:16-->
 
|-
 
|-
 
|SOAP_HOST_PROXY||Adresse IP ou nom DNS du serveur Proxy (si besoin)
 
|SOAP_HOST_PROXY||Adresse IP ou nom DNS du serveur Proxy (si besoin)
Ligne 56 : Ligne 70 :
 
On (par défaut) / Off
 
On (par défaut) / Off
  
 +
<!--T:17-->
 
|-
 
|-
 
|MAIL_SERVER||Adresse IP ou nom DNS du serveur SMTP (commandes Mail)
 
|MAIL_SERVER||Adresse IP ou nom DNS du serveur SMTP (commandes Mail)
 
outlook.office365.com
 
outlook.office365.com
  
 +
<!--T:18-->
 
|-
 
|-
 
|MAIL_DOMAIN||Nom de domaine du serveur SMTP outlook.com
 
|MAIL_DOMAIN||Nom de domaine du serveur SMTP outlook.com
Ligne 82 : Ligne 98 :
 
tracking
 
tracking
  
 +
<!--T:19-->
 
|-
 
|-
 
|TRACKING_LIB_PATH||Chemin des exécutables PostGreSQL
 
|TRACKING_LIB_PATH||Chemin des exécutables PostGreSQL
 
C:\Program Files\PostgreSQL\9.0\bin
 
C:\Program Files\PostgreSQL\9.0\bin
  
 +
<!--T:20-->
 
|-
 
|-
 
|TRACKING_SERVERSCHEMA||Schéma de la base de données de tracking
 
|TRACKING_SERVERSCHEMA||Schéma de la base de données de tracking
 
public
 
public
  
 +
<!--T:21-->
 
|-
 
|-
 
|DEFAULT_ADMINISTRATOR_RESPONSE||Chemin d’un fichier HTML de réponse par défaut (commandes Web Interactivity)
 
|DEFAULT_ADMINISTRATOR_RESPONSE||Chemin d’un fichier HTML de réponse par défaut (commandes Web Interactivity)
Ligne 96 : Ligne 115 :
 
text/html
 
text/html
  
 +
<!--T:22-->
 
|-
 
|-
 
|DEFAULT_RESPONSE_BODY||Chemin d’un fichier HTML de corps de réponse par défaut (commandes Web Interactivity)
 
|DEFAULT_RESPONSE_BODY||Chemin d’un fichier HTML de corps de réponse par défaut (commandes Web Interactivity)
Ligne 106 : Ligne 126 :
 
E:\MappingWindows\Settings\configCustomAccess
 
E:\MappingWindows\Settings\configCustomAccess
  
 +
<!--T:23-->
 
|-
 
|-
 
|PATH_DJDE||Chemin des ressources DJDE (conversions Xerox)
 
|PATH_DJDE||Chemin des ressources DJDE (conversions Xerox)
 
E:\MappingWindows\Temp\DJDE
 
E:\MappingWindows\Temp\DJDE
  
 +
<!--T:24-->
 
|-
 
|-
 
|RESOLVE_PERPAGE||Nombre de lignes par page pour l’affichage des tables de résolution 25
 
|RESOLVE_PERPAGE||Nombre de lignes par page pour l’affichage des tables de résolution 25
Ligne 116 : Ligne 138 :
 
%d/%m/%Y
 
%d/%m/%Y
  
 +
<!--T:25-->
 
|-
 
|-
 
|MAP_CURRENT_TIME||Contrôle de syntaxe pour la récupération de l’heure courante
 
|MAP_CURRENT_TIME||Contrôle de syntaxe pour la récupération de l’heure courante
 
%H:%M:%S
 
%H:%M:%S
  
 +
<!--T:26-->
 
|-
 
|-
 
|MAP_CURRENT_TIMESTAMP||Contrôle de syntaxe pour la récupération de date et heure courante %d-%m-%Y_%H%M%S
 
|MAP_CURRENT_TIMESTAMP||Contrôle de syntaxe pour la récupération de date et heure courante %d-%m-%Y_%H%M%S
 
|}<br />
 
|}<br />
  
===Barre d'outils===
+
===Barre d'outils=== <!--T:27-->
 
<br />
 
<br />
 
[[Fichier:OX S Outilswrkf.png|centré|sans_cadre|975x975px]]
 
[[Fichier:OX S Outilswrkf.png|centré|sans_cadre|975x975px]]
  
  
 +
<!--T:28-->
 
*Créer un nouveau Workflow. Saisir un nom pour le Workflow, l’extension .rules.xml est automatiquement ajoutée.
 
*Créer un nouveau Workflow. Saisir un nom pour le Workflow, l’extension .rules.xml est automatiquement ajoutée.
 
*Ouvrir un Workflow. Sélectionner un Workflow dans la liste.
 
*Ouvrir un Workflow. Sélectionner un Workflow dans la liste.
Ligne 141 : Ligne 166 :
 
*Gérer les tables de résolution= permet de créer, modifier et supprimer des tables de résolutions
 
*Gérer les tables de résolution= permet de créer, modifier et supprimer des tables de résolutions
  
===Créer un nouveau workflow===
+
===Créer un nouveau workflow=== <!--T:29-->
  
 +
<!--T:30-->
 
Cliquer sur l’icône [[Fichier:OX S iconewrkflw.png|frameless|160px]]    et de nommer le Workflow (ici Factures) puis valider.
 
Cliquer sur l’icône [[Fichier:OX S iconewrkflw.png|frameless|160px]]    et de nommer le Workflow (ici Factures) puis valider.
 
<br />
 
<br />
Ligne 149 : Ligne 175 :
  
  
 +
<!--T:31-->
 
Le nouveau Workflow s’affiche dans la fenêtre d’édition, avec une première boite, qui correspond à un point de départ de la séquence de traitements à venir :
 
Le nouveau Workflow s’affiche dans la fenêtre d’édition, avec une première boite, qui correspond à un point de départ de la séquence de traitements à venir :
  
 +
<!--T:32-->
 
[[Fichier:OX S wrkfl1.png|centré|sans_cadre|947x947px]]
 
[[Fichier:OX S wrkfl1.png|centré|sans_cadre|947x947px]]
  
  
  
 +
<!--T:33-->
 
Remarque: Pour importer un Workflow, il suffit de le copier sous <code> C:\ProgramDta\M-Processing Server\Settings\rules\workflow</code>
 
Remarque: Pour importer un Workflow, il suffit de le copier sous <code> C:\ProgramDta\M-Processing Server\Settings\rules\workflow</code>
  
 +
<!--T:34-->
 
Pour visualiser le Workflow importé,  Aller dans Menu->Menu d'Administration->Gestion des Workflows, après cliquer sur ouvrir.
 
Pour visualiser le Workflow importé,  Aller dans Menu->Menu d'Administration->Gestion des Workflows, après cliquer sur ouvrir.
  
===Ajouter un paramètre===
+
===Ajouter un paramètre=== <!--T:35-->
  
 +
<!--T:36-->
 
<u>Définition</u>
 
<u>Définition</u>
  
 +
<!--T:37-->
 
[[Fichier:OX S WRKFL param.png|centré|sans_cadre|251x251px]]
 
[[Fichier:OX S WRKFL param.png|centré|sans_cadre|251x251px]]
  
  
 +
<!--T:38-->
 
Les objets de type paramètre permettent de définir la valeur d’un paramètre ou d’en créer un nouveau. Un paramètre peut ensuite être utilisé dans une condition ou une commande. Cela permet la réutilisation d’une valeur dans plusieurs commandes, par exemple, tout en ne la définissant qu’une seule fois.
 
Les objets de type paramètre permettent de définir la valeur d’un paramètre ou d’en créer un nouveau. Un paramètre peut ensuite être utilisé dans une condition ou une commande. Cela permet la réutilisation d’une valeur dans plusieurs commandes, par exemple, tout en ne la définissant qu’une seule fois.
  
 +
<!--T:39-->
 
<u>Creation/Edition</u>
 
<u>Creation/Edition</u>
  
 +
<!--T:40-->
 
Pour créer un nouveau paramètre, sélectionner la boite après laquelle le nouveau paramètre doit être ajouté, puis de cliquer sur l’icône    [[Fichier:OX S iconewrkflwParam.jpg|sans_cadre]]. Pour éditer un paramètre existant, double-cliquer sur la boite correspondante.
 
Pour créer un nouveau paramètre, sélectionner la boite après laquelle le nouveau paramètre doit être ajouté, puis de cliquer sur l’icône    [[Fichier:OX S iconewrkflwParam.jpg|sans_cadre]]. Pour éditer un paramètre existant, double-cliquer sur la boite correspondante.
 
La fenêtre d’édition de paramètre s’ouvre afin de définir les différents champs :
 
La fenêtre d’édition de paramètre s’ouvre afin de définir les différents champs :
  
 +
<!--T:41-->
 
[[Fichier:OX S paramwrkflw.png|centré|sans_cadre|897x897px|alt=]]
 
[[Fichier:OX S paramwrkflw.png|centré|sans_cadre|897x897px|alt=]]
  
  
 +
<!--T:42-->
 
Remarque : Un paramètre sera généralement réutilisé ultérieurement dans le Workflow dans une condition ou une commande, voire même dans un autre Workflow. Il est donc conseillé de choisir des noms pertinents quant à l’information véhiculée.
 
Remarque : Un paramètre sera généralement réutilisé ultérieurement dans le Workflow dans une condition ou une commande, voire même dans un autre Workflow. Il est donc conseillé de choisir des noms pertinents quant à l’information véhiculée.
  
 +
<!--T:43-->
 
<u>Valorisation</u>
 
<u>Valorisation</u>
  
 +
<!--T:44-->
 
Pour valoriser le paramètre, différentes méthodes sont disponibles par le menu contextuel sur le champ de saisie :
 
Pour valoriser le paramètre, différentes méthodes sont disponibles par le menu contextuel sur le champ de saisie :
  
 +
<!--T:45-->
 
*param = valeur dynamique d’un paramètre d’environnement du système, de M-Processing Server, du Workflow ou du spool d’entrée.
 
*param = valeur dynamique d’un paramètre d’environnement du système, de M-Processing Server, du Workflow ou du spool d’entrée.
 
*value = valeur statique saisie par l’utilisateur.
 
*value = valeur statique saisie par l’utilisateur.
Ligne 191 : Ligne 231 :
 
*rulefile_multiple = permet de définir en une fois plusieurs paramètres valorisés dynamiquement par des informations contenues dans le même fichier en entrée (en mode XML uniquement.
 
*rulefile_multiple = permet de définir en une fois plusieurs paramètres valorisés dynamiquement par des informations contenues dans le même fichier en entrée (en mode XML uniquement.
  
 +
<!--T:46-->
 
Suivant le type de champs voulu, une fonction d’aide à la saisie est proposée affichant une nouvelle interface pour paramétrer la récupération dynamique de la valeur :
 
Suivant le type de champs voulu, une fonction d’aide à la saisie est proposée affichant une nouvelle interface pour paramétrer la récupération dynamique de la valeur :
  
 +
<!--T:47-->
 
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
Ligne 214 : Ligne 256 :
 
|}
 
|}
  
===Ajouter une condition===
+
===Ajouter une condition=== <!--T:48-->
  
 +
<!--T:49-->
 
<u>Définition</u>
 
<u>Définition</u>
  
 +
<!--T:50-->
 
Les objets de type condition permettent de définir deux traitements différents en fonction de la validité d’une condition. Les boites conditions sont donc les seules à avoir deux sorties :
 
Les objets de type condition permettent de définir deux traitements différents en fonction de la validité d’une condition. Les boites conditions sont donc les seules à avoir deux sorties :
  
 +
<!--T:51-->
 
*en bas (chemin direct) si la condition est vraie (= Vrai)
 
*en bas (chemin direct) si la condition est vraie (= Vrai)
 
*à droite (chemin détourné) si la condition est fausse (= Faux)
 
*à droite (chemin détourné) si la condition est fausse (= Faux)
  
  
 +
<!--T:52-->
 
[[Fichier:OX S wrkflFactures.png|centré|sans_cadre|879x879px]]
 
[[Fichier:OX S wrkflFactures.png|centré|sans_cadre|879x879px]]
 
Une condition est une comparaison entre au moins deux valeurs. Une valeur peut être un paramètre, une constante, le résultat d’une commande ou d’un script, d’une recherche dans une table de résolution, d’une requête SQL, d’une lecture dans un fichier de données.
 
Une condition est une comparaison entre au moins deux valeurs. Une valeur peut être un paramètre, une constante, le résultat d’une commande ou d’un script, d’une recherche dans une table de résolution, d’une requête SQL, d’une lecture dans un fichier de données.
  
 +
<!--T:53-->
 
<u>Création/Édition</u>
 
<u>Création/Édition</u>
  
 +
<!--T:54-->
 
Pour créer une nouvelle condition, sélectionner la boite après laquelle la condition doit être ajoutée puis cliquer sur l’icône [[Fichier:OX S icone cd.png|sans_cadre|frameless|120px]].  
 
Pour créer une nouvelle condition, sélectionner la boite après laquelle la condition doit être ajoutée puis cliquer sur l’icône [[Fichier:OX S icone cd.png|sans_cadre|frameless|120px]].  
 
Pour éditer une condition existante, il suffit de double-cliquer sur la boite correspondante.
 
Pour éditer une condition existante, il suffit de double-cliquer sur la boite correspondante.
Ligne 236 : Ligne 284 :
  
  
 +
<!--T:55-->
 
*Condition: Nom de l'objet condition (1)
 
*Condition: Nom de l'objet condition (1)
 
*title: Titre de l'objet
 
*title: Titre de l'objet
Ligne 242 : Ligne 291 :
 
*Note: Note (champ libre pour commentaires).
 
*Note: Note (champ libre pour commentaires).
  
 +
<!--T:56-->
 
Une condition doit avoir au moins un filtre de condition.
 
Une condition doit avoir au moins un filtre de condition.
  
 +
<!--T:57-->
 
<u>Conseil</u> :
 
<u>Conseil</u> :
 
Le champ Nom de l’objet (1) est optionnel, mais il est vivement conseillé de le renseigner. En effet, cette information sera reprise dans le journal d’événements associé à l’exécution du Workflow permettant de facilement identifier les différentes étapes du Workflow.
 
Le champ Nom de l’objet (1) est optionnel, mais il est vivement conseillé de le renseigner. En effet, cette information sera reprise dans le journal d’événements associé à l’exécution du Workflow permettant de facilement identifier les différentes étapes du Workflow.
 
Exemples : « Condition '' failed » si pas de nom, « Condition 'Nom de la condition' failed » sinon.''
 
Exemples : « Condition '' failed » si pas de nom, « Condition 'Nom de la condition' failed » sinon.''
  
 +
<!--T:58-->
 
<u>Filtre de condition</u>
 
<u>Filtre de condition</u>
 
La création d’une nouvelle condition propose automatiquement un premier filtre à paramétrer. Un double-clic sur un filtre de condition permet de l’éditer.
 
La création d’une nouvelle condition propose automatiquement un premier filtre à paramétrer. Un double-clic sur un filtre de condition permet de l’éditer.
  
  
 +
<!--T:59-->
 
Param1 EGAL Valeur1
 
Param1 EGAL Valeur1
  
 +
<!--T:60-->
 
*parma1:Valeur à comparer
 
*parma1:Valeur à comparer
 
*EGAL:Opérateur de comparaison
 
*EGAL:Opérateur de comparaison
Ligne 259 : Ligne 313 :
  
  
 +
<!--T:61-->
 
Les opérateurs de comparaison disponibles sont :
 
Les opérateurs de comparaison disponibles sont :
  
 +
<!--T:62-->
 
*égal / différent : comparaison alphanumérique stricte entre deux valeurs,
 
*égal / différent : comparaison alphanumérique stricte entre deux valeurs,
 
*contient / ne contient pas : recherche alphanumérique d’une valeur dans une autre,
 
*contient / ne contient pas : recherche alphanumérique d’une valeur dans une autre,
Ligne 269 : Ligne 325 :
  
  
 +
<!--T:63-->
 
Une condition peut être définie par plusieurs filtres de conditions.  
 
Une condition peut être définie par plusieurs filtres de conditions.  
 
Le bouton [[Fichier:OX S iconeajoutcdt.png|sans_cadre|frameless|120px]] permet d’ajouter un nouveau filtre de condition.
 
Le bouton [[Fichier:OX S iconeajoutcdt.png|sans_cadre|frameless|120px]] permet d’ajouter un nouveau filtre de condition.
Ligne 274 : Ligne 331 :
 
[[Fichier:OX S operateurOR.png|sans_cadre|frameless|120px]]   
 
[[Fichier:OX S operateurOR.png|sans_cadre|frameless|120px]]   
  
 +
<!--T:64-->
 
Dans l’exemple, la logique de condition vaut : filtre A et (filtre B ou filtre C).
 
Dans l’exemple, la logique de condition vaut : filtre A et (filtre B ou filtre C).
 
Le bouton [[Fichier:OX S deletecdt.png|sans_cadre|frameless|120px]]      permet de supprimer un filtre de condition sélectionné ou une logique de condition (et ses filtres associés) sélectionnée.
 
Le bouton [[Fichier:OX S deletecdt.png|sans_cadre|frameless|120px]]      permet de supprimer un filtre de condition sélectionné ou une logique de condition (et ses filtres associés) sélectionnée.
  
===Ajouter une commande===
+
===Ajouter une commande=== <!--T:65-->
 
<u>Définition</u>
 
<u>Définition</u>
  
 +
<!--T:66-->
 
Les objets de type commande permettent d’exécuter un traitement unitaire. Un même Workflow comportera autant de commandes qu’il y a de traitements à effectuer.
 
Les objets de type commande permettent d’exécuter un traitement unitaire. Un même Workflow comportera autant de commandes qu’il y a de traitements à effectuer.
 
Les objets de type commande permettent d’exécuter quatre grandes familles de traitements : des commandes prédéfinies natives ONYX Server, des scripts utilisateurs, des requêtes SQL, ou des appels à d’autres Workflows.
 
Les objets de type commande permettent d’exécuter quatre grandes familles de traitements : des commandes prédéfinies natives ONYX Server, des scripts utilisateurs, des requêtes SQL, ou des appels à d’autres Workflows.
  
 +
<!--T:67-->
 
<u>Création/Édition</u>
 
<u>Création/Édition</u>
  
 +
<!--T:68-->
 
Pour créer une nouvelle commande, sélectionner la boite après laquelle la commande doit être ajoutée puis cliquer sur l’icône [[Fichier:OX S cmd icone.png|sans_cadre|frameless|120px]]. Pour éditer une commande existante, double-cliquer sur la boite correspondante.
 
Pour créer une nouvelle commande, sélectionner la boite après laquelle la commande doit être ajoutée puis cliquer sur l’icône [[Fichier:OX S cmd icone.png|sans_cadre|frameless|120px]]. Pour éditer une commande existante, double-cliquer sur la boite correspondante.
 
La fenêtre d’édition de commande s’ouvre afin de définir les différents champs :
 
La fenêtre d’édition de commande s’ouvre afin de définir les différents champs :
Ligne 291 : Ligne 352 :
  
  
 +
<!--T:69-->
 
*Type d'objet: Type de traitement au choix entre Command, Cmd, Sql, Call,
 
*Type d'objet: Type de traitement au choix entre Command, Cmd, Sql, Call,
 
*Nom de l’objet,
 
*Nom de l’objet,
Ligne 298 : Ligne 360 :
 
*Source et Dossier de destination: Paramètres de la commande
 
*Source et Dossier de destination: Paramètres de la commande
  
                   o Présente l’ensemble des paramètres requis ou optionnels pour la bonne exécution de la commande
+
                   <!--T:70-->
 +
o Présente l’ensemble des paramètres requis ou optionnels pour la bonne exécution de la commande
 
                   o L’onglet Standard regroupe les paramètres principaux de la commande
 
                   o L’onglet Standard regroupe les paramètres principaux de la commande
 
                   o En fonction des commandes, d’autres onglets spécifiques présentent les paramétrages avancés Advanced
 
                   o En fonction des commandes, d’autres onglets spécifiques présentent les paramétrages avancés Advanced
  
 +
<!--T:71-->
 
*Note: champ libre pour commentaires.
 
*Note: champ libre pour commentaires.
  
  
 +
<!--T:72-->
 
<u>Les commandes prédéfinies (COMMAND)</u>
 
<u>Les commandes prédéfinies (COMMAND)</u>
  
 +
<!--T:73-->
 
Cette première famille de traitement regroupe les commandes génériques et natives Onyx Server. Elles sont organisées par groupes de commandes en fonction de leur utilisation : Spooler, File, Mapping, XPS Toolbox, Mail…
 
Cette première famille de traitement regroupe les commandes génériques et natives Onyx Server. Elles sont organisées par groupes de commandes en fonction de leur utilisation : Spooler, File, Mapping, XPS Toolbox, Mail…
  
 +
<!--T:74-->
 
Parmi les plus utilisées, nous pouvons citer notamment :
 
Parmi les plus utilisées, nous pouvons citer notamment :
  
 +
<!--T:75-->
 
<FONT color="green"> Mapping / Text M-Designer  </FONT>: application d’un format Designer sur un fichier de données en mode texte
 
<FONT color="green"> Mapping / Text M-Designer  </FONT>: application d’un format Designer sur un fichier de données en mode texte
  
 +
<!--T:76-->
 
*Standard :
 
*Standard :
  
 +
<!--T:77-->
 
-Nom du format Designer à appliquer. La liste des formats importés sur le serveur est disponible par le bouton l’aide à la saisie  
 
-Nom du format Designer à appliquer. La liste des formats importés sur le serveur est disponible par le bouton l’aide à la saisie  
 
   
 
   
 
-Numéro de séquence (00010, ou *MRG, ou *ALL, etc.)
 
-Numéro de séquence (00010, ou *MRG, ou *ALL, etc.)
  
 +
<!--T:78-->
 
-Fichier d’entrée (le fichier de données)
 
-Fichier d’entrée (le fichier de données)
  
 +
<!--T:79-->
 
-Fichier de sortie (le document XPS produit)
 
-Fichier de sortie (le document XPS produit)
  
 +
<!--T:80-->
 
*Advanced :
 
*Advanced :
  
 +
<!--T:81-->
 
-Langue de traduction (consulter le Guide Utilisateur de Designer pour l’utilisation des traductions)
 
-Langue de traduction (consulter le Guide Utilisateur de Designer pour l’utilisation des traductions)
  
 +
<!--T:82-->
 
-Fichier XPS à incorporer comme calque, avec possibilité de reprendre ses index
 
-Fichier XPS à incorporer comme calque, avec possibilité de reprendre ses index
  
 +
<!--T:83-->
 
*Text options :
 
*Text options :
  
 +
<!--T:84-->
 
-Nombre de lignes maximum = possibilité de fixer un overflow sur le fichier de données en entrée et de provoquer un saut de page automatique,
 
-Nombre de lignes maximum = possibilité de fixer un overflow sur le fichier de données en entrée et de provoquer un saut de page automatique,
 
-Largeur de page : nombre de caractères maximum par ligne à lire dans le fichier de données en entrée,
 
-Largeur de page : nombre de caractères maximum par ligne à lire dans le fichier de données en entrée,
  
 +
<!--T:85-->
 
-Page de code du fichier en entrée : permet de réaliser une conversion à la volée en Unicode UTF-16 si besoin. La liste des codes pages gérés dans Onyx Server est disponible par le bouton d’aide à la saisie .
 
-Page de code du fichier en entrée : permet de réaliser une conversion à la volée en Unicode UTF-16 si besoin. La liste des codes pages gérés dans Onyx Server est disponible par le bouton d’aide à la saisie .
  
 +
<!--T:86-->
 
*Output options :
 
*Output options :
  
 +
<!--T:87-->
 
-Page de début / page de fin : intervalle de pages à produire,
 
-Page de début / page de fin : intervalle de pages à produire,
  
 +
<!--T:88-->
 
-Bac d’entrée / bac de sortie : ajout d’options de finition (PrintTicket) sur le document XPS produit pour la gestion des bacs d’imprimantes.
 
-Bac d’entrée / bac de sortie : ajout d’options de finition (PrintTicket) sur le document XPS produit pour la gestion des bacs d’imprimantes.
  
 +
<!--T:89-->
 
<FONT color="green">Spooler / Imprimer</FONT> : envoi d’un spool dans une file d’attente du Spooler Onyx Server
 
<FONT color="green">Spooler / Imprimer</FONT> : envoi d’un spool dans une file d’attente du Spooler Onyx Server
  
 +
<!--T:90-->
 
*Standard :
 
*Standard :
  
 +
<!--T:91-->
 
-Nom de la file d’attente de destination. La liste des files d’attente déclarées dans le Spooler est disponible par le bouton d’aide à la saisie ,
 
-Nom de la file d’attente de destination. La liste des files d’attente déclarées dans le Spooler est disponible par le bouton d’aide à la saisie ,
  
 +
<!--T:92-->
 
-Nom du fichier à envoyer,
 
-Nom du fichier à envoyer,
  
 +
<!--T:93-->
 
-Titre : nom donné au spool dans la file d’attente,
 
-Titre : nom donné au spool dans la file d’attente,
 
-Envoyer le spool en état suspendu dans la file d’attente de destination,
 
-Envoyer le spool en état suspendu dans la file d’attente de destination,
  
 +
<!--T:94-->
 
-Conserver le spool après traitement dans la file d’attente de destination,
 
-Conserver le spool après traitement dans la file d’attente de destination,
  
 +
<!--T:95-->
 
-Conserver les attributs courants = affecter au spool en sortie les attributs du spool en cours,
 
-Conserver les attributs courants = affecter au spool en sortie les attributs du spool en cours,
  
 +
<!--T:96-->
 
-Ajouter les paramètres courants = affecter au spool en sortie les paramètres de la session en cours,
 
-Ajouter les paramètres courants = affecter au spool en sortie les paramètres de la session en cours,
  
 +
<!--T:97-->
 
*Page :
 
*Page :
  
 +
<!--T:98-->
 
-Page de début / page de fin : positionne les attributs correspondants sur le spool de destination pour son intervalle de traitement,
 
-Page de début / page de fin : positionne les attributs correspondants sur le spool de destination pour son intervalle de traitement,
  
 +
<!--T:99-->
 
-Nombre de copies : positionne l’attribut correspondant sur le spool de destination.
 
-Nombre de copies : positionne l’attribut correspondant sur le spool de destination.
  
 +
<!--T:100-->
 
*Security :
 
*Security :
  
 +
<!--T:101-->
 
-Propriétaire du spool de destination,
 
-Propriétaire du spool de destination,
  
 +
<!--T:102-->
 
-Droits d’accès sur le spool de destination,
 
-Droits d’accès sur le spool de destination,
  
 +
<!--T:103-->
 
-Code comptabilité : affectation de l’attribut correspondant.
 
-Code comptabilité : affectation de l’attribut correspondant.
  
 +
<!--T:104-->
 
*Userdatas :
 
*Userdatas :
  
 +
<!--T:105-->
 
-Possibilité de définir des attributs supplémentaires sur le spool de destination.
 
-Possibilité de définir des attributs supplémentaires sur le spool de destination.
  
 +
<!--T:106-->
 
*Advanced :
 
*Advanced :
  
 +
<!--T:107-->
 
-Priorité du spool de destination,
 
-Priorité du spool de destination,
  
 +
<!--T:108-->
 
-Nombre de jours de conservation du spool de destination,
 
-Nombre de jours de conservation du spool de destination,
  
 +
<!--T:109-->
 
-Nombre de jours avant compression du spool de destination (attribut hérité du monde AS/400, parfois utilisé par les applications clientes en amont et en aval),
 
-Nombre de jours avant compression du spool de destination (attribut hérité du monde AS/400, parfois utilisé par les applications clientes en amont et en aval),
  
 +
<!--T:110-->
 
-Type de support papier,
 
-Type de support papier,
  
 +
<!--T:111-->
 
-Fidélité : attribut hérité du monde AS400 parfois utilisé par les applications clientes en amont et en aval
 
-Fidélité : attribut hérité du monde AS400 parfois utilisé par les applications clientes en amont et en aval
  
 +
<!--T:112-->
 
-Nom du fichier spool de destination.
 
-Nom du fichier spool de destination.
  
 +
<!--T:113-->
 
La liste exhaustive des commandes prédéfinies Onyx Server est détaillée dans le Chapitre 4.
 
La liste exhaustive des commandes prédéfinies Onyx Server est détaillée dans le Chapitre 4.
  
 +
<!--T:114-->
 
<u>Les scripts utilisateurs</u>
 
<u>Les scripts utilisateurs</u>
  
 +
<!--T:115-->
 
Le mode '''CMD''' permet de passer l’objet de type commande en mode éditeur de texte afin de taper une commande complète comme il serait fait en mode telnet ou en fenêtre de commandes MS-DOS. Tous les paramètres d’environnement (système et Mapping) ainsi que les attributs du fichier en cours de traitement sont accessibles.
 
Le mode '''CMD''' permet de passer l’objet de type commande en mode éditeur de texte afin de taper une commande complète comme il serait fait en mode telnet ou en fenêtre de commandes MS-DOS. Tous les paramètres d’environnement (système et Mapping) ainsi que les attributs du fichier en cours de traitement sont accessibles.
 
La commande exécutée peut être une commande Onyx Server spécifique et non disponible en commande prédéfinie ou alors un script (*.bat ou *.sh) complexe.
 
La commande exécutée peut être une commande Onyx Server spécifique et non disponible en commande prédéfinie ou alors un script (*.bat ou *.sh) complexe.
  
  
 +
<!--T:116-->
 
[[Fichier:OX S CMD Line.png|centré|sans_cadre|874x874px|alt=]]
 
[[Fichier:OX S CMD Line.png|centré|sans_cadre|874x874px|alt=]]
  
  
  
 +
<!--T:117-->
 
<u>Les requêtes SQL </u>
 
<u>Les requêtes SQL </u>
  
 +
<!--T:118-->
 
Le mode '''SQL''' permet de passer l’objet de type commande en mode éditeur de texte afin d’exécuter des ordres SQL. Tous les paramètres d’environnement (système et Mapping) ainsi que les attributs du fichier en cours de traitement sont accessibles. Les paramètres de connexion à la base de données doivent être définis dans la configuration de Onyx Server.
 
Le mode '''SQL''' permet de passer l’objet de type commande en mode éditeur de texte afin d’exécuter des ordres SQL. Tous les paramètres d’environnement (système et Mapping) ainsi que les attributs du fichier en cours de traitement sont accessibles. Les paramètres de connexion à la base de données doivent être définis dans la configuration de Onyx Server.
  
  
 +
<!--T:119-->
 
[[Fichier:OX S SQL CMD.png|centré|sans_cadre|951x951px]]
 
[[Fichier:OX S SQL CMD.png|centré|sans_cadre|951x951px]]
  
  
 +
<!--T:120-->
 
<u>Les appels à des WORKFLOWS(CALL)</u>
 
<u>Les appels à des WORKFLOWS(CALL)</u>
  
 +
<!--T:121-->
 
Le mode '''CALL''' permet d’exécuter, dans le Workflow en cours, un autre Workflow puis de continuer l’exécution du Workflow en cours une fois que le second est correctement terminé. Tous les paramètres d’environnement (système et Mapping) ainsi que les attributs du fichier en cours de traitement sont automatiquement transmis au sous-Workflow et utilisables dans celui-ci.
 
Le mode '''CALL''' permet d’exécuter, dans le Workflow en cours, un autre Workflow puis de continuer l’exécution du Workflow en cours une fois que le second est correctement terminé. Tous les paramètres d’environnement (système et Mapping) ainsi que les attributs du fichier en cours de traitement sont automatiquement transmis au sous-Workflow et utilisables dans celui-ci.
  
  
 +
<!--T:122-->
 
[[Fichier:OX S Call wrkflow.png|centré|sans_cadre|963x963px]]
 
[[Fichier:OX S Call wrkflow.png|centré|sans_cadre|963x963px]]
 
<br />
 
<br />
  
 
</translate>
 
</translate>

Version du 8 août 2019 à 14:34

Autres langues :
English • ‎français

Introduction

OX S wrkf1.png


Les Workflows composent le Moteur d’exécution ONYX Server. Un Workflow est défini comme un ensemble de conditions et de commandes paramétrables, exécutées lorsqu’un nouveau fichier arrive sur un connecteur d’entrée (robot Scanfolder, serveur d’écoute, point d’entrée, ou par requête Web Service). Les commandes sont traitées séquentiellement c’est-à-dire que la deuxième commande sera traitée après exécution correcte de la première, jusqu’à la fin du Workflow.

Un Workflow se définit graphiquement en connectant différents objets de type commandes, conditions et/ou paramètres. Il est nommé de façon unique et doit être attaché au moins à un connecteur pour être actif.

Les Workflows sont sauvegardés sur disque dans des fichiers au format XML dans le sous-répertoire workflow du répertoire des règles spécifié par la variable de configuration RULES_PATH.

Sur l’interface Web d'ONYX Server, la page d’administration et de configuration des Workflows s’obtient par le Menu d’Administration puis Gestion des Workflows ou par le lien direct : http://127.0.0.1:8004/JS_Common/workflow/index.html

Conseil : Pour un meilleur confort d’utilisation, le navigateur Firefox est vivement recommandé.

Configuration

Une nouvelle section WORKFLOW est ajoutée dans le fichier de configuration d'ONYX Server contenant un certain nombre de paramètres de configuration pour le moteur d’exécution des Workflows ainsi que pour les fonctionnalités Web Service (SOAP_*) :

Nom Signification / Exemple
SOAP_DEBUG Activation du mode verbeux pour les Web Services

On / Off (par défaut)

SOAP_PATH_TEMP Chemin local des fichiers temporaires

E:\MappingWindows\Temp\HTTPServer

SOAP_PATH_LOG Chemin local des journaux de log

E:\MappingWindows\Temp\HTTPServer

SOAP_LOCAL_URL Chemin distant du répertoire partagé (échanges de fichiers)

http://127.0.0.1:8004/shareFolder

SOAP_DOCUMENT_URL Chemin distant du répertoire partagé (échanges de fichiers)

http://127.0.0.1:8004/shareFolder

SOAP_LOCATION Chemin distant du moteur Web Services Mapping

http://127.0.0.1:8004/cgi-bin/mapsoapserver.exe

SOAP_HOST_PROXY Adresse IP ou nom DNS du serveur Proxy (si besoin)
SOAP_PORT_PROXY Port de connexion au serveur Proxy (si besoin)
USE_NEW_RULES Activation du moteur de Workflows ou retour au moteur v6

On (par défaut) / Off

MAIL_SERVER Adresse IP ou nom DNS du serveur SMTP (commandes Mail)

outlook.office365.com

MAIL_DOMAIN Nom de domaine du serveur SMTP outlook.com
MAIL_PORT Port de connexion du serveur SMTP 587
MAIL_LOGIN Identifiant d’authentification du serveur SMTP
MAIL_PASSWORD Mot de passe de l’identifiant précédent
MAIL_FROM Adresse d’expéditeur par défaut
TRACKING_SERVERADDRESS Adresse IP de la base de données PostGreSQL de tracking 127.0.0.1
TRACKING_SERVERPORT Port de connexion à la base de données de tracking 5432
TRACKING_SERVERUSER Identifiant de connexion à la base de données de tracking
TRACKING_SERVERPASSWORD Mot de passe de l’identifiant précédent
TRACKING_SERVERBASENAME Nom de la base de données de tracking

tracking

TRACKING_LIB_PATH Chemin des exécutables PostGreSQL

C:\Program Files\PostgreSQL\9.0\bin

TRACKING_SERVERSCHEMA Schéma de la base de données de tracking

public

DEFAULT_ADMINISTRATOR_RESPONSE Chemin d’un fichier HTML de réponse par défaut (commandes Web Interactivity)
DEFAULT_ADMINISTRATOR_RESPONSE_HEADER Type (content-type) de la réponse par défaut

text/html

DEFAULT_RESPONSE_BODY Chemin d’un fichier HTML de corps de réponse par défaut (commandes Web Interactivity)
DEFAULT_FILE_TYPE Chemin d’un fichier HTML d’entête de message par défaut (commandes Web Interactivity)
DEFAULT_MAIL_BODY Chemin d’un fichier HTML de corps de message par défaut (commandes Web Interactivity)
PATH_CONFIG_CUSTOM_ACCESS Chemin des préférences utilisateurs d’affichage (MOM 2.0)

E:\MappingWindows\Settings\configCustomAccess

PATH_DJDE Chemin des ressources DJDE (conversions Xerox)

E:\MappingWindows\Temp\DJDE

RESOLVE_PERPAGE Nombre de lignes par page pour l’affichage des tables de résolution 25
MAP_CURRENT_DATE Contrôle de syntaxe pour la récupération de la date courante

%d/%m/%Y

MAP_CURRENT_TIME Contrôle de syntaxe pour la récupération de l’heure courante

%H:%M:%S

MAP_CURRENT_TIMESTAMP Contrôle de syntaxe pour la récupération de date et heure courante %d-%m-%Y_%H%M%S


Barre d'outils


OX S Outilswrkf.png


  • Créer un nouveau Workflow. Saisir un nom pour le Workflow, l’extension .rules.xml est automatiquement ajoutée.
  • Ouvrir un Workflow. Sélectionner un Workflow dans la liste.
  • Sauvegarder le Workflow actif.
  • Sauvegarder le Workflow actif sous un autre nom.
  • Supprimer le Workflow actif.
  • Insérer une condition dans le Workflow actif. La nouvelle condition sera ajoutée après la boite sélectionnée.
  • Insérer une commande dans le Workflow actif. La nouvelle commande sera ajoutée après la boite sélectionnée.
  • Insérer un paramètre dans le Workflow actif. Le nouveau paramètre sera ajouté après la boite sélectionnée.
  • Redessiner le Workflow actif = permet de redessiner graphiquement le Workflow : alignements des boîtes, des liens, etc…
  • Dupliquer un objet = permet de dupliquer, à l’identique (nom, paramètres, etc.) l’objet sélectionné, sans ses liens.
  • Gérer les tables de résolution= permet de créer, modifier et supprimer des tables de résolutions

Créer un nouveau workflow

Cliquer sur l’icône OX S iconewrkflw.png et de nommer le Workflow (ici Factures) puis valider.

OX S newWrkfl.png



Le nouveau Workflow s’affiche dans la fenêtre d’édition, avec une première boite, qui correspond à un point de départ de la séquence de traitements à venir :

OX S wrkfl1.png


Remarque: Pour importer un Workflow, il suffit de le copier sous C:\ProgramDta\M-Processing Server\Settings\rules\workflow

Pour visualiser le Workflow importé, Aller dans Menu->Menu d'Administration->Gestion des Workflows, après cliquer sur ouvrir.

Ajouter un paramètre

Définition

OX S WRKFL param.png


Les objets de type paramètre permettent de définir la valeur d’un paramètre ou d’en créer un nouveau. Un paramètre peut ensuite être utilisé dans une condition ou une commande. Cela permet la réutilisation d’une valeur dans plusieurs commandes, par exemple, tout en ne la définissant qu’une seule fois.

Creation/Edition

Pour créer un nouveau paramètre, sélectionner la boite après laquelle le nouveau paramètre doit être ajouté, puis de cliquer sur l’icône OX S iconewrkflwParam.jpg. Pour éditer un paramètre existant, double-cliquer sur la boite correspondante. La fenêtre d’édition de paramètre s’ouvre afin de définir les différents champs :


Remarque : Un paramètre sera généralement réutilisé ultérieurement dans le Workflow dans une condition ou une commande, voire même dans un autre Workflow. Il est donc conseillé de choisir des noms pertinents quant à l’information véhiculée.

Valorisation

Pour valoriser le paramètre, différentes méthodes sont disponibles par le menu contextuel sur le champ de saisie :

  • param = valeur dynamique d’un paramètre d’environnement du système, de M-Processing Server, du Workflow ou du spool d’entrée.
  • value = valeur statique saisie par l’utilisateur.
  • rulefile = valeur dynamique lue dans un fichier texte ou XML (peut être le spool d’entrée, ou tout autre fichier).
  • command = valeur dynamique résultant de l’exécution d’une commande prédéfinie Onyx Server.
  • cmd = valeur dynamique résultant de l’exécution d’un script utilisateur.
  • SQL = valeur dynamique résultant de l’exécution d’une requête SQL (de type SELECT en l’occurrence).
  • resolve =: valeur dynamique résultant de la recherche dans une table de résolution.
  • rulefile_multiple = permet de définir en une fois plusieurs paramètres valorisés dynamiquement par des informations contenues dans le même fichier en entrée (en mode XML uniquement.

Suivant le type de champs voulu, une fonction d’aide à la saisie est proposée affichant une nouvelle interface pour paramétrer la récupération dynamique de la valeur :

Type de fonction Contenu Icône Indicateur de type
Paramètre Paramètre de l’application Texte en bleu
Aucune Texte libre ou liste aucun Texte en noir
RuleFile Valeur lue dans un fichier de données Texte de la cellule rulefile : keyword(Test)
Commande Retour d’une commande prédéfinie Texte de la cellule Command : cutposition
Cmd Retour d’une ligne commande Texte de la cellule cmd : chemincomplet...
SQL Retour d’une requête SQL Texte de la cellule SQL : Select...
Table de résolution Retour d’une table de résolution Texte de la cellule Resolve : TABLE[PARAM]
Rulefile multiple Valeurs lues dans un même fichier (XML) Texte de la cellule rulefile_multiple : xml

Ajouter une condition

Définition

Les objets de type condition permettent de définir deux traitements différents en fonction de la validité d’une condition. Les boites conditions sont donc les seules à avoir deux sorties :

  • en bas (chemin direct) si la condition est vraie (= Vrai)
  • à droite (chemin détourné) si la condition est fausse (= Faux)


OX S wrkflFactures.png

Une condition est une comparaison entre au moins deux valeurs. Une valeur peut être un paramètre, une constante, le résultat d’une commande ou d’un script, d’une recherche dans une table de résolution, d’une requête SQL, d’une lecture dans un fichier de données.

Création/Édition

Pour créer une nouvelle condition, sélectionner la boite après laquelle la condition doit être ajoutée puis cliquer sur l’icône frameless. Pour éditer une condition existante, il suffit de double-cliquer sur la boite correspondante. La fenêtre d’édition de condition s’ouvre afin de définir les différents champs :


  • Condition: Nom de l'objet condition (1)
  • title: Titre de l'objet
  • AND , OR: Outils pour définir la logique de la condition : ajout/suppression d’un filtre, opérateurs logiques AND et OR.
  • Param1 egal value1: Filtres de condition
  • Note: Note (champ libre pour commentaires).

Une condition doit avoir au moins un filtre de condition.

Conseil : Le champ Nom de l’objet (1) est optionnel, mais il est vivement conseillé de le renseigner. En effet, cette information sera reprise dans le journal d’événements associé à l’exécution du Workflow permettant de facilement identifier les différentes étapes du Workflow. Exemples : « Condition failed » si pas de nom, « Condition 'Nom de la condition' failed » sinon.

Filtre de condition La création d’une nouvelle condition propose automatiquement un premier filtre à paramétrer. Un double-clic sur un filtre de condition permet de l’éditer.


Param1 EGAL Valeur1

  • parma1:Valeur à comparer
  • EGAL:Opérateur de comparaison
  • à la valeur:Valeur de comparaison


Les opérateurs de comparaison disponibles sont :

  • égal / différent : comparaison alphanumérique stricte entre deux valeurs,
  • contient / ne contient pas : recherche alphanumérique d’une valeur dans une autre,
  • est vide / n’est pas vide : un paramètre a-t-il ou non une valeur ?
  • supérieur à / supérieur ou égal à : comparaison numérique,
  • inférieur à / inférieur ou égal à : comparaison numérique.


Une condition peut être définie par plusieurs filtres de conditions. Le bouton frameless permet d’ajouter un nouveau filtre de condition. La logique complète entre ces filtres est définie graphiquement en utilisant les cases à cocher devant chaque filtre et les outils frameless et frameless

Dans l’exemple, la logique de condition vaut : filtre A et (filtre B ou filtre C). Le bouton frameless permet de supprimer un filtre de condition sélectionné ou une logique de condition (et ses filtres associés) sélectionnée.

Ajouter une commande

Définition

Les objets de type commande permettent d’exécuter un traitement unitaire. Un même Workflow comportera autant de commandes qu’il y a de traitements à effectuer. Les objets de type commande permettent d’exécuter quatre grandes familles de traitements : des commandes prédéfinies natives ONYX Server, des scripts utilisateurs, des requêtes SQL, ou des appels à d’autres Workflows.

Création/Édition

Pour créer une nouvelle commande, sélectionner la boite après laquelle la commande doit être ajoutée puis cliquer sur l’icône frameless. Pour éditer une commande existante, double-cliquer sur la boite correspondante. La fenêtre d’édition de commande s’ouvre afin de définir les différents champs :

OX S editCMD.png


  • Type d'objet: Type de traitement au choix entre Command, Cmd, Sql, Call,
  • Nom de l’objet,
  • titre: Titre de l’objet,
  • File: groupe de commandes prédéfinies
  • Copier vers un dossier: la commande prédéfinie à exécuter
  • Source et Dossier de destination: Paramètres de la commande
                 o Présente l’ensemble des paramètres requis ou optionnels pour la bonne exécution de la commande
                 o L’onglet Standard regroupe les paramètres principaux de la commande
                 o En fonction des commandes, d’autres onglets spécifiques présentent les paramétrages avancés Advanced
  • Note: champ libre pour commentaires.


Les commandes prédéfinies (COMMAND)

Cette première famille de traitement regroupe les commandes génériques et natives Onyx Server. Elles sont organisées par groupes de commandes en fonction de leur utilisation : Spooler, File, Mapping, XPS Toolbox, Mail…

Parmi les plus utilisées, nous pouvons citer notamment :

Mapping / Text M-Designer : application d’un format Designer sur un fichier de données en mode texte

  • Standard :

-Nom du format Designer à appliquer. La liste des formats importés sur le serveur est disponible par le bouton l’aide à la saisie

-Numéro de séquence (00010, ou *MRG, ou *ALL, etc.)

-Fichier d’entrée (le fichier de données)

-Fichier de sortie (le document XPS produit)

  • Advanced :

-Langue de traduction (consulter le Guide Utilisateur de Designer pour l’utilisation des traductions)

-Fichier XPS à incorporer comme calque, avec possibilité de reprendre ses index

  • Text options :

-Nombre de lignes maximum = possibilité de fixer un overflow sur le fichier de données en entrée et de provoquer un saut de page automatique, -Largeur de page : nombre de caractères maximum par ligne à lire dans le fichier de données en entrée,

-Page de code du fichier en entrée : permet de réaliser une conversion à la volée en Unicode UTF-16 si besoin. La liste des codes pages gérés dans Onyx Server est disponible par le bouton d’aide à la saisie .

  • Output options :

-Page de début / page de fin : intervalle de pages à produire,

-Bac d’entrée / bac de sortie : ajout d’options de finition (PrintTicket) sur le document XPS produit pour la gestion des bacs d’imprimantes.

Spooler / Imprimer : envoi d’un spool dans une file d’attente du Spooler Onyx Server

  • Standard :

-Nom de la file d’attente de destination. La liste des files d’attente déclarées dans le Spooler est disponible par le bouton d’aide à la saisie ,

-Nom du fichier à envoyer,

-Titre : nom donné au spool dans la file d’attente, -Envoyer le spool en état suspendu dans la file d’attente de destination,

-Conserver le spool après traitement dans la file d’attente de destination,

-Conserver les attributs courants = affecter au spool en sortie les attributs du spool en cours,

-Ajouter les paramètres courants = affecter au spool en sortie les paramètres de la session en cours,

  • Page :

-Page de début / page de fin : positionne les attributs correspondants sur le spool de destination pour son intervalle de traitement,

-Nombre de copies : positionne l’attribut correspondant sur le spool de destination.

  • Security :

-Propriétaire du spool de destination,

-Droits d’accès sur le spool de destination,

-Code comptabilité : affectation de l’attribut correspondant.

  • Userdatas :

-Possibilité de définir des attributs supplémentaires sur le spool de destination.

  • Advanced :

-Priorité du spool de destination,

-Nombre de jours de conservation du spool de destination,

-Nombre de jours avant compression du spool de destination (attribut hérité du monde AS/400, parfois utilisé par les applications clientes en amont et en aval),

-Type de support papier,

-Fidélité : attribut hérité du monde AS400 parfois utilisé par les applications clientes en amont et en aval

-Nom du fichier spool de destination.

La liste exhaustive des commandes prédéfinies Onyx Server est détaillée dans le Chapitre 4.

Les scripts utilisateurs

Le mode CMD permet de passer l’objet de type commande en mode éditeur de texte afin de taper une commande complète comme il serait fait en mode telnet ou en fenêtre de commandes MS-DOS. Tous les paramètres d’environnement (système et Mapping) ainsi que les attributs du fichier en cours de traitement sont accessibles. La commande exécutée peut être une commande Onyx Server spécifique et non disponible en commande prédéfinie ou alors un script (*.bat ou *.sh) complexe.



Les requêtes SQL

Le mode SQL permet de passer l’objet de type commande en mode éditeur de texte afin d’exécuter des ordres SQL. Tous les paramètres d’environnement (système et Mapping) ainsi que les attributs du fichier en cours de traitement sont accessibles. Les paramètres de connexion à la base de données doivent être définis dans la configuration de Onyx Server.


OX S SQL CMD.png


Les appels à des WORKFLOWS(CALL)

Le mode CALL permet d’exécuter, dans le Workflow en cours, un autre Workflow puis de continuer l’exécution du Workflow en cours une fois que le second est correctement terminé. Tous les paramètres d’environnement (système et Mapping) ainsi que les attributs du fichier en cours de traitement sont automatiquement transmis au sous-Workflow et utilisables dans celui-ci.


OX S Call wrkflow.png