Workflows-Guide avancé

<languages/>
<translate>
==Valorisation des champs de saisie== <!--T:1-->

<!--T:2-->
Dans tous les types d’objet d’un Workflow, des champs ou zones de saisie sont utilisé(e)s, que ce soit pour définir une condition, une commande ou des paramètres. Les champs peuvent être les opérandes d’une condition, les paramètres d’exécution d’une commande ou bien les noms et valeurs affectés à un paramètre.

<!--T:3-->
Deux familles de champs peuvent apparaitre dans les Workflows : les zones de textes libres et les listes déroulantes. Les champs de type texte acceptent la saisie libre alors que les listes déroulantes sont limitées à une sélection de valeurs (oui/non, type de fichier…).

<!--T:4-->
Les champs de saisie ont un type par défaut qui peut être modifié en fonction des besoins à l’aide du bouton droit de la souris (menu contextuel). En fonction du type de champ choisi, des aides à la saisie sont proposées permettant de structurer correctement la valeur du champ.

<!--T:5-->
[[Fichier:OX S WRKFL Saisie.png|centré|sans_cadre|800x800px]]


===Fonctions sur les champs=== <!--T:6-->

<!--T:7-->
Des fonctions sont disponibles sur les champs (de type texte ou liste) afin de récupérer des valeurs automatiquement.
Les fonctions sur les champs permettent de définir la valeur des champs d’une commande, d’une condition ou d’un paramètre en utilisant au choix des variables, le contenu d’un fichier ou le résultat de commandes.

<!--T:8-->
Certains champs sont prédéfinis avec une fonction telle que la liste des utilisateurs, la liste des formats M-Designer, … alors que d’autres non.
Pour faire appel à une fonction, cliquer avec le bouton droit de la souris sur un champ et de choisir la fonction voulue dans le menu contextuel :

<!--T:9-->
[[Fichier:OX S wrkfl champ.png|centré|sans_cadre|624x624px]]


<!--T:10-->
Remarque :

<!--T:11-->
Pour modifier la valeur donnée à un champ, seuls les deux premiers types ci-dessus (paramètre et texte libre) sont éditables directement dans la zone de saisie. Pour tous les autres, il convient de passer par la fonction sur le champ.


===Champs propres à ONYX Server=== <!--T:12-->

<!--T:13-->
Certains champs ont un typage particulier et bénéficient d’une aide à la saisie prédéfinie. Leurs valeurs possibles sont alors limitées à une liste d’éléments définis dans ONYX Server. Comme ce typage est indépendant des fonctions sur les champs, il est donc possible d’avoir deux possibilités d’aide au remplissage sur un champ.

<!--T:14-->
[[Fichier:OX S WRKFLW CHAMP.png|centré|sans_cadre|677x677px]]


===Paramètres d'environnement=== <!--T:15-->

<!--T:16-->
Les champs de type <FONT color="blue"> Parameter </FONT> prennent dynamiquement la valeur des paramètres d’environnement de l’application.

<!--T:17-->
La fonction paramètre permet d’utiliser tous les paramètres disponibles lors de l’exécution du fichier :

<!--T:18-->
-	attributs du fichier en cours de traitement : utilisateur (<FONT color="blue"> MAP_USER </FONT>), nom du fichier (<FONT color="blue"> MAP_FILE</FONT>), ...

<!--T:19-->
-	paramètres liés au traitement en cours : connecteur d’entrée du traitement (<FONT color="blue"> MAP_PRINTER </FONT>, <FONT color="blue"> MAP_SOAP </FONT>, <FONT color="blue"> SCANFOLDER_NAME</FONT>...), date de la soumission (<FONT color="blue"> MAP_DATE</FONT>), ...

<!--T:20-->
-	paramètres personnalisés : userdatas, passage de paramètres du workflow, ...

<!--T:21-->
-	variables d’environnement du système : répertoire temporaire (<FONT color="blue"> TEMP</FONT>), nom du système (<FONT color="blue"> COMPUTERNAME</FONT>),

<!--T:22-->
-	variables de session :

<!--T:23-->
*fichiers d’entrée / sortie de la boîte en cours : <FONT color="blue"> MAP_FILE_IN / MAP_FILE_OUT </FONT>
*identifiant du dernier spool inséré pour la session (exécution) en cours : <FONT color="blue"> LAST_SPOOL_ID </FONT>
*date, heure, date et heure courante, évaluées par Mapping au moment de l’appel de la variable (la syntaxe de récupération des informations est pilotée par les variables d’environnement Mapping correspondante) : <FONT color="blue"> MAP_CURRENT_DATE / MAP_CURRENT_TIME / MAP_CURRENT_TIMESTAMP</FONT>


===Valeur « DIRECTE »=== <!--T:24-->
Les champs de type Value prennent statiquement la valeur saisie dans le champ :

<!--T:25-->
[[Fichier:OX S valD1.png|centré|sans_cadre|378x378px]]


<!--T:26-->
Mais les valeurs saisies peuvent également être dynamiques en utilisant les mêmes variables d’environnement que précédemment avec la syntaxe particulière Mapping :

<!--T:27-->
<FONT color="red"> [%</FONT><FONT color="blue"> PARAMETRE</FONT><FONT color="red"> %]</FONT>. Elles sont très utilisées pour la construction de chemins complets ou noms de fichiers où plusieurs paramètres peuvent être utilisés en une seule fois :
[[Fichier:OX S ValD2.png|centré|sans_cadre|372x372px]]


<!--T:28-->
Pour certains traitements particuliers (tris, éclatement ou fusion de documents, ...), il est enfin possible d’utiliser des valeurs de critères d’indexation du document (XPS) dans une valeur de champs avec la syntaxe particulière Mapping : <FONT color="red"> [[</FONT><FONT color="blue"> CRITERE</FONT> <FONT color="red"> ]]</FONT>. Ainsi par exemple, à partir d’un document XPS unique, pour créer un PDF par client en sortie, dans la boîte de Commande <FONT color="blue"> To PDF </FONT>, on utilisera :

<!--T:29-->
[[Fichier:OX S ValD3.png|centré|sans_cadre|628x628px|alt=]]


===RuleFile=== <!--T:30-->

<!--T:31-->
Les champs de type <FONT color="blue"> Rulefile </FONT>prennent la valeur d’une information lue dans un fichier (exemple : le fichier en entrée <FONT color="blue"> MAP_FILE_IN </FONT> ou un autre).
Plusieurs méthodes de lecture dans le fichier source sont proposées et détaillées ci-après.

<!--T:32-->
POINT D'ATTENTION : les différentes méthodes permettant de récupérer une valeur dans un fichier sont optimisées en ne chargeant qu'une petite partie du fichier de données. Cela se fait via le paramètre '''maxsize'''. Sa valeur par défaut (20000) limite le chargement aux 20000 premiers octets du fichier. Ainsi, si la valeur recherchée se trouve plus loin, il sera impossible de l'atteindre sans modifier la valeur de ce paramètre. Il s'agit bien d'un nombre d'octets et non de caractères. Aussi, pour un fichier UCS ou UTF-16, il conviendra de multiplier par 2 cette valeur par rapport au nombre de caractères devant réellement être chargés. 


====Keyword : Recherche par mot clé==== <!--T:33-->
La lecture se fait en mode texte et la valeur récupérée dans le fichier source est identifiée par la recherche d’un mot clé :

<!--T:34-->
[[Fichier:OX S motclé.png|centré|sans_cadre|905x905px]]


<!--T:35-->
-	Value : Valeur du mot clé à rechercher

<!--T:36-->
-	Skip :  Nombre de caractères à ignorer après le mot clé

<!--T:37-->
-	Len :  Nombre de caractères à retourner

<!--T:38-->
-	maxsize : Taille du buffer maxi pour la lecture du fichier source

<!--T:39-->
-	charset : Page de code du fichier source

<!--T:40-->
-	trim :  Suppression des éventuels espaces en fin de chaine retournée (0 ou 1)

<!--T:41-->
-	file :  Fichier source

<!--T:42-->
Remarque : 
Pour faire appel à la recherche par mot clé, cliquer avec le bouton droit de la souris sur un champ et de choisir la fonction '''rulefile''' dans le menu contextuel, après cliquer sur la loupe.


====Line : Recherche par position==== <!--T:43-->

<!--T:44-->
Pour faire une recherche par position, il suffit de cliquer sur liste déroulante et choisir '''line'''.

<!--T:45-->
[[Fichier:OX S Rulefile line.png|centré|sans_cadre|895x895px]]


<!--T:46-->
La lecture se fait en mode texte et la valeur récupérée dans le fichier source est localisée par sa position (ligne / colonne) et sa longueur :

<!--T:47-->
[[Fichier:OX S Line pos.png|centré|sans_cadre|912x912px]]



<!--T:48-->
-	line :  Numéro de ligne

<!--T:49-->
-	pos :  Numéro de colonne de départ dans la ligne

<!--T:50-->
-	len : Nombre de caractères à retourner

<!--T:51-->
-	maxsize : Taille du buffer maxi pour la lecture du fichier source

<!--T:52-->
-	charset :  Page de code du fichier source

<!--T:53-->
-	trim : Suppression des éventuels espaces en fin de chaine retournée

<!--T:54-->
-	file : Fichier source


====XML : Lecture directe dans un fichier XML==== <!--T:55-->
Pour faire une recherche par position, il suffit de cliquer sur liste déroulante et choisir '''xml :'''
[[Fichier:Workflow-rulefile-xml.png|centré|vignette|300x300px]]


<!--T:56-->
La lecture se fait en mode XML et la valeur récupérée dans le fichier source est identifiée par la requête <FONT color="blue"> XPath</FONT> renseignée.

<!--T:57-->
-	xpath :  requête xpath permettant de sélectionner la valeur désirée, avec la syntaxe "SELECTML .... FROM ...."

<!--T:58-->
-	default : valeur par défaut si aucune valeur n'est trouvée

<!--T:59-->
-	maxsize : Taille du buffer maxi pour la lecture du fichier source

<!--T:60-->
-	file : Fichier source


<!--T:61-->
Exemples de recherche XML avec le fichier suivant :


<!--T:62-->
[[Fichier:OX S XML.png|centré|sans_cadre|694x694px]]


<!--T:63-->
-	Recherche du nom de la balise page :
 SELECTXML @name FROM /doc/page

<!--T:64-->
-	Recherche de la valeur du champ nommé id_lang :
 SELECTXML . FROM /doc/page/field[@name=id_lang]

<!--T:65-->
-	Recherche de la valeur du premier champ SRLNBR :
 SELECTXML . FROM /doc/page/group[@name=Items]/line[@name=item]/field[@name=SRLNBR]
 SELECTXML . FROM /doc/page/group[@name=Items]/line/field[@name=SRLNBR]
 SELECTXML . FROM /doc/page/group[@name=Items]/line/field[@title=Serial Number]

<!--T:66-->
-	Recherche de la valeur du deuxième champ SRLNBR :
 SELECTXML . FROM /doc/page/group[@name=Items]/line[2]/field[@name=SRLNBR]
 SELECTXML . FROM /doc/page/group[@name=Items]/line[2]/field[@title=Serial Number]

===Commande=== <!--T:67-->

<!--T:68-->
Les champs de type Command prennent la valeur retournée par l’exécution d’une commande prédéfinie ONYX Server. L’ensemble des commandes prédéfinies sont détaillées ci-après.

<!--T:69-->
Attention : toute les commandes prédéfinies Mapping ne sont pas susceptibles de retourner une valeur exploitable dans un champ.


===CMD=== <!--T:70-->
Les champs de type CMD prennent la valeur retournée par l’exécution d’une commande utilisateur (un script par exemple).


===SQL=== <!--T:71-->
Les champs de type SQL prennent la valeur retournée par l’exécution d’une requête SQL (SELECT).


===Table de résolution=== <!--T:72-->
Les champs de type Resolve prennent la valeur retournée par la recherche dans une table de Résolution ONYX Server. 

Leurs fichiers XML se retrouvent dans ''/rules/workflow/resolve''
===Rulefile Multiple=== <!--T:73-->
Les champs de type <FONT color="blue"> Rulefile_multiple</FONT> permettent de définir en une seule fois plusieurs paramètres valorisés par des informations lues à différents endroits dans un même fichier (par exemple, le fichier en entrée <FONT color="blue"> MAP_FILE_IN</FONT> ou un autre). Disponible uniquement en lecture XML pour l’instant, c’est une optimisation de la définition de plusieurs paramètres de type "rulefile", réduisant à une seule ouverture et fermeture de fichier.

<!--T:74-->
[[Fichier:OX S RulefileM.png|centré|sans_cadre|644x644px]]


<!--T:75-->
-	(1) Sélection du type de lecture (XML uniquement pour l’instant)

<!--T:76-->
-	(2) Taille du buffer maxi pour la lecture du fichier source

<!--T:77-->
-	(3) Nom du fichier source à lire

<!--T:78-->
-	(4) Suppression d’un paramètre

<!--T:79-->
-	(5) Ajout d’un nouveau paramètre


<!--T:80-->
Puis définition de n paramètres, avec pour chacun :

<!--T:81-->
-	<FONT color="blue"> Param </FONT>: Nom du paramètre

<!--T:82-->
-	<FONT color="blue"> XPath </FONT>: Requête XPath de lecture de l’information dans le fichier XML source

<!--T:83-->
-	<FONT color="blue"> Default </FONT>: Valeur par défaut (optionnelle) si l’information n’est pas trouvée dans le fichier


==Commandes prédéfinies== <!--T:84-->

<!--T:85-->
Pour afficher la liste des commandes prédéfinies, il suffit de cliquer avec le bouton droit de la souris sur un champ, choisir " Command " dans le menu contextuel, cliquer sur le l’icône de l'éclair et enfin choisir le groupe de commandes voulus(Spooler, String,File ... )

<!--T:86-->
[[Fichier:OX S Commande.png|centré|sans_cadre|931x931px]]


===Groupe de commandes Spooler=== <!--T:87-->
[[Fichier:OX S Groupe Spooler.png|centré|sans_cadre|771x771px]]
 

====Suspendre Queue==== <!--T:88-->
[[Fichier:OX S suspQ.png|gauche|sans_cadre|60x60px]]

<!--T:89-->
*Action : suspendre une file d’attente du spooler
*Paramètre : nom de la file d’attente M-Processing Server à suspendre
*Retour : aucun.


====Libérer Queue==== <!--T:90-->
[[Fichier:OX S librQ.png|gauche|sans_cadre]]

<!--T:91-->
*Action : libérer une file d’attente du spooler
*Paramètre : nom de la file d’attente M-Processing Server à libérer
*Retour : aucun.


====Suspendre un travail==== <!--T:92-->
Remarque : action non applicable sur le travail en cours.

<!--T:93-->
[[Fichier:OX S SusJob.png|gauche|sans_cadre]]

<!--T:94-->
*Action : suspendre un travail dans le Spooler ONYX Server
*Paramètre : le numéro (identifiant ONYX Server) du travail à suspendre (valeur numérique)
*Retour : aucun.


====Supprimer un travail==== <!--T:95-->
Remarque : action non applicable sur le travail en cours.
[[Fichier:OX S deleteJob.png|gauche|sans_cadre]]

<!--T:96-->
*Action : supprimer un travail dans le Spooler ONYX Server
*Paramètre : le numéro (identifiant ONYX Server) du travail à supprimer (valeur numérique)
*Retour : aucun.


====Libérer un travail==== <!--T:97-->
Remarque : action non applicable sur le travail en cours.
[[Fichier:OX S libJob.png |gauche|sans_cadre]]

<!--T:98-->
*Action : libérer un travail dans le Spooler ONYX Server
*Paramètre : le numéro (identifiant ONYX Server) du travail à libérer (valeur numérique)
*Retour : aucun.


====Suspendre le travail courant==== <!--T:99-->
[[Fichier:OX S susOccrtJob.png|gauche|sans_cadre]]

<!--T:100-->
*Action : suspendre le travail en cours d’exécution
*Paramètre : aucun
*Retour : aucun.


====Imprimer==== <!--T:101-->
[[Fichier:OX S IMPRT.png|gauche|sans_cadre|53x53px]]





<!--T:102-->
Action : envoyer un travail dans une file d’attente du Spooler ONYX Server

<!--T:103-->
<u>Paramètres Standards</u> :

<!--T:104-->
-	Nom de la file d’attente de destination

<!--T:105-->
-	Nom complet du fichier à envoyer

<!--T:106-->
-	Titre donné au travail dans la file d’attente de destination

<!--T:107-->
-	Envoyer le travail à l’état suspendu : Oui / Non (par défaut)

<!--T:108-->
-	Conserver le travail dans la file d’attente de destination après traitement : Oui / Non (par défaut)

<!--T:109-->
-	Transporter les attributs du travail en cours au travail de destination : Oui (par défaut) / Non

<!--T:110-->
-	Ajouter au travail de destination les paramètres de la session en cours : Oui (par défaut) / Non


<!--T:111-->
<u>Paramètres Pages</u> :

<!--T:112-->
-	Page de début (1 par défaut)

<!--T:113-->
-	Page de fin (0 par défaut, signifiant la fin du travail en cours)

<!--T:114-->
-	Nombre de copies (1 par défaut)


<!--T:115-->
<u>Paramètres Security</u> :

<!--T:116-->
-	Propriétaire du travail de destination (<FONT color="blue">MAP_USER</FONT> par défaut)

<!--T:117-->
-	Droits d’accès du travail de destination dans le système de fichiers (777 par défaut, soit lecture/écriture pour tout le monde)

<!--T:118-->
-	Code comptabilité (valeur alphanumérique)


<!--T:119-->
<u>Paramètres Userdata</u> : possibilité d’ajouter jusqu’à 10 attributs personnalisés supplémentaires

<!--T:120-->
<u>Paramètres Advanced</u> :

<!--T:121-->
-	Priorité du travail en sortie

<!--T:122-->
-	Nombre de jours de conservation du travail en sortie

<!--T:123-->
-	Nombre de jours avant compression du travail en sortie

<!--T:124-->
-	Type de support papier

<!--T:125-->
-	Fidélité

<!--T:126-->
-	Nom du fichier spool

<!--T:127-->
Retour : Aucun. Un nouveau travail est créé dans la file d’attente de destination et son identifiant ONYX Server est stocké dans la variable de session <FONT color="blue"> LAST_SPOOL_ID</FONT>.


====Envoyer à la file d'attente et revenir==== <!--T:128-->
[[Fichier:OX S Envoyerà la file d'aatente.png|gauche|sans_cadre|alt=|73x73px]]






<!--T:129-->
*Action : interrompre le traitement en cours, envoyer le travail en cours dans une autre file d’attente ONYX Server, attendre le bon

<!--T:130-->
traitement du travail dans la file d’attente de destination puis reprendre le traitement en cours.

<!--T:131-->
*Paramètre : nom de la file d’attente de destination
*Retour : aucun.

====Définir un attribut du travail==== <!--T:132-->
[[Fichier:OX S Attribut Travail.png|gauche|sans_cadre]]






<!--T:133-->
*Action : définir ou modifier la valeur d’un attribut d’un travail dans une file d’attente du spooler.

<!--T:134-->
<U>Paramètres Standards</U> :

<!--T:135-->
-	Identifiant ONYX Server unique du travail

<!--T:136-->
-	Nom de la file d’attente ONYX Server

<!--T:137-->
-	Nom de l’attribut

<!--T:138-->
-	Valeur donnée à l’attribut

<!--T:139-->
*Retour : aucun.

===Groupe de commandes file=== <!--T:140-->
[[Fichier:OX S Commande File.png|centré|sans_cadre|839x839px]]


====Renommer un fichier==== <!--T:141-->
[[Fichier:OX S renameFile.png|gauche|sans_cadre]]




<!--T:142-->
*Action : renommer un fichier

<!--T:143-->
<u>Paramètres Standard</u> :
-	Nom complet du fichier d’origine

<!--T:144-->
-	Nom du fichier de destination (le répertoire de destination étant le répertoire courant)

<!--T:145-->
<u>Paramètres Avancés</u> :

<!--T:146-->
-	Ecraser le fichier de destination s’il existe déjà : Oui / Non (par défaut)

<!--T:147-->
*Retour : aucun.

====Copier /déplacer un fichier==== <!--T:148-->
[[Fichier:OX S deplcefile.png|gauche|sans_cadre]]




<!--T:149-->
*Action : Copier un fichier, en le renommant ou non, en supprimant l’original ou non.

<!--T:150-->
<u>Paramètres Standard</u> :

<!--T:151-->
-	Nom complet du chemin d’origine

<!--T:152-->
-	Nom complet du fichier de destination

<!--T:153-->
<u>Paramètres Avancés</u> :

<!--T:154-->
-	Ecraser le fichier de destination s’il existe déjà : Oui / Non (par défaut)

<!--T:155-->
-	Supprimer le fichier d’origine : Oui / Non (par défaut)

<!--T:156-->
*Retour : aucun.

====Copier dans un dossier==== <!--T:157-->

<!--T:158-->
[[Fichier:OX S Copier Foldr.png|gauche|sans_cadre]]






<!--T:159-->
*Action : copier un fichier dans un dossier de destination, en supprimant l’original ou non.

<!--T:160-->
<u>Paramètres Standard</u> :

<!--T:161-->
-	Nom complet du chemin d’origine

<!--T:162-->
-	Chemin du dossier de destination (le nom du fichier étant conservé de l’original)

<!--T:163-->
<u>Paramètres Avancés</u> :

<!--T:164-->
-	Ecraser le fichier de destination s’il existe déjà : Oui / Non (par défaut)

<!--T:165-->
-	Supprimer le fichier d’origine : Oui / Non (par défaut)

<!--T:166-->
*Retour : aucun.

====Copie sécurisée==== <!--T:167-->
[[Fichier:OX S SecureCopie.png|gauche|sans_cadre]]






<!--T:168-->
Action : copier un fichier sur un server SFTP.

<!--T:169-->
<u>Paramètres Standard</u> :

<!--T:170-->
-	Nom du fichier d’entrée.

<!--T:171-->
-	IP du serveur.

<!--T:172-->
-	Port.

<!--T:173-->
-	Identifiant.

<!--T:174-->
-	Mot de passe (à laisser vide en cas d’utilisation d’une clé privée).

<!--T:175-->
-	Chemin sur le serveur.

<!--T:176-->
-	Nom du fichier sur le serveur.

<!--T:177-->
-	Permissions du fichier après copie.

<!--T:178-->
-	Nombre de tentative de copie avant échec.

<!--T:179-->
-	Ecraser le fichier de destination s’il existe déjà : Oui / Non (par défaut)

<!--T:180-->
<u>Paramètres Avancés</u> :

<!--T:181-->
-	Utiliser une clé privée : Oui / Non (par défaut).

<!--T:182-->
-	Chemin vers le fichier contenant la clé privée.

<!--T:183-->
-	Mot de passe de la clé privée.

<!--T:184-->
Variables : Cette commande stocke également un certain nombre de variables.

<!--T:185-->
-	Timestamp begin : date du début de la copie.

<!--T:186-->
-	Timestamp end : date de la fin de la copie.

<!--T:187-->
-	Filename : nom du fichier copié.

<!--T:188-->
-	File Size (local) : taille du fichier local.

<!--T:189-->
-	File Size (remote) : taille du fichier après copie.

<!--T:190-->
-	Return Code : code retour du serveur SFTP.

====Ajout de texte dans un fichier==== <!--T:191-->

<!--T:192-->
[[Fichier:OX S addtxt.png|gauche|sans_cadre]]







<!--T:193-->
Action : Ajouter du texte dans un fichier.

<!--T:194-->
<u>Paramètres Standard</u> :

<!--T:195-->
-	Nom du fichier d’entrée.

<!--T:196-->
-	Page de code du fichier en sortie.

<!--T:197-->
-	Contenu du fichier.

====Supprimer un fichier==== <!--T:198-->
[[Fichier:OX S Deletefile.png|gauche|sans_cadre]]

<!--T:199-->
*Action : supprimer un fichier
*Paramètre : le nom complet du fichier à supprimer
*Retour : aucun.


====Remplacer une chaine dans un fichier==== <!--T:200-->
[[Fichier:OX S rplce.png|gauche|sans_cadre]]








<!--T:201-->
Action : Remplacer une chaine de caractères par une autre dans un fichier de données. Le fichier en entrée peut être Unicode ou non. Les chaines à remplacer et de remplacement peuvent être ASCII, hexadécimales, ou un mixe des deux.

<!--T:202-->
<u>Paramètres Standard</u> :

<!--T:203-->
-	Nom du fichier d’entrée.

<!--T:204-->
-	Nom du fichier de sortie.

<!--T:205-->
-	Chaine de caractères à remplacer.

<!--T:206-->
-	Chaine de caractères de remplacement.

<!--T:207-->
Retour : aucun. Un nouveau fichier est créé en sortie.

<!--T:208-->
Exemple 1: Remplacement d'une chaine ASCII
[[Fichier:OX S wrkflexepl1.png|centré|sans_cadre|580x580px]]



<!--T:209-->
Exemple 2 : Remplacement d'ue chaine HEXA(pour ajouter un saut de page avant un mot clé par exemple)
[[Fichier:OX S wrklow expl2.png|centré|sans_cadre|580x580px]]

====Nettoyer un dossier==== <!--T:210-->

<!--T:211-->
[[Fichier:OX S NettoyDossier.png|gauche|sans_cadre]]







<!--T:212-->
Action : Supprimer les fichiers d’un répertoire, en fonction des filtres utilisés.

<!--T:213-->
<u>Paramètre Standard</u> : Nom du répertoire à nettoyer

<!--T:214-->
<u>Paramètres Avancés</u>:

<!--T:215-->
-	Filtre sur le nom des fichiers à supprimer (ex : *[%MAP_JOBNUM%]*)

<!--T:216-->
-	Filtre sur l’extension des fichiers à supprimer (ex : *.tmp)

<!--T:217-->
Retour : Aucun.

====Existence d'un fichier==== <!--T:218-->

<!--T:219-->
Remarque : Ne s’utilise pas en mode commande seule mais dans une condition ou pour définir un paramètre.
[[Fichier:OX S Existencefile.png|gauche|sans_cadre]]






<!--T:220-->
*Action : vérifier l’existence d’un fichier.
*Paramètre : nom complet du fichier
*Retour : chaine de caractère « yes » ou « no ».


===Groupe de commandes String=== <!--T:221-->
<br />
[[Fichier:OX S Commande-String.png|centré|sans_cadre|763x763px]]


<!--T:222-->
Aucune des fonctions de cet ensemble ne s’utilise en mode commande seule. Elles sont à exécuter dans des conditions ou pour définir des paramètres.

====Découper par position==== <!--T:223-->

<!--T:224-->
[[Fichier:OX S CUTPOS.png|gauche|sans_cadre]]






<!--T:225-->
Action : extraire une partie d’une chaine de caractèr

<!--T:226-->
es en se basant sur la position de l’information à extraire.

<!--T:227-->
<u>Paramètres Standard</u> :

<!--T:228-->
-	Chaine de caractères d’origine (de laquelle l’information doit être extraite)

<!--T:229-->
-	Valeur par défaut à retourner si l’information n’est pas trouvée

<!--T:230-->
-	Position de début de l’information à extraire (valeur numérique)

<!--T:231-->
-	Position de fin de l’information à extraire (valeur numérique)

<!--T:232-->
<u>Paramètre Avancés</u> : nombre de caractères à ignorer à partir de la position de début (valeur numérique)

<!--T:233-->
Retour : chaine de caractères alphanumériques.

====Découper par séparateur==== <!--T:234-->
[[Fichier:OX S CUT SEP.png|gauche|sans_cadre]]







<!--T:235-->
Action : extraire une partie d’une chaine de caractères en se basant sur des séparateurs de sous-chaines.

<!--T:236-->
<u>Paramètres Standard</u> :

<!--T:237-->
-	Chaine de caractères d’origine (de laquelle l’information doit être extraite)

<!--T:238-->
-	Valeur par défaut à retourner si l’information n’est pas trouvée

<!--T:239-->
-	Séparateur de début de l’information à extraire (valeur alphanumérique)

<!--T:240-->
-	Séparateur de fin de l’information à extraire (valeur alphanumérique)

<!--T:241-->
Retour : chaine de caractères alphanumériques.

====Découper par champ==== <!--T:242-->

<!--T:243-->
[[Fichier:OX S CUT CH.png|gauche|sans_cadre]]







<!--T:244-->
Action : Extraire une partie d’une chaine de caractères, en se basant sur un séparateur de sous-chaines (chaines de type CSV).

<!--T:245-->
<u>Paramètres Standard</u> :

<!--T:246-->
-	Chaine de caractères d’origine (de laquelle l’information doit être extraite)

<!--T:247-->
-	Valeur par défaut à retourner si l’information n’est pas trouvée

<!--T:248-->
-	Séparateur de champs (valeur alphanumérique)

<!--T:249-->
-	Numéro du champ à retourner (valeur numérique)

<!--T:250-->
Retour : chaine de caractères alphanumériques.

====BASENAME==== <!--T:251-->
[[Fichier:OX S Basename.png|gauche|alt=|sans_cadre]]

<!--T:252-->
*Action : extraire le nom de fichier à partir d’un chemin complet.
*Paramètre : chemin complet d’un fichier
*Retour : chaine de caractères alphanumériques.


====DIRNAME==== <!--T:253-->
[[Fichier:OX S DIRENAME.png|gauche|sans_cadre]]

<!--T:254-->
*Action : extraire le chemin du fichier à partir d’un chemin complet, sans le nom.
*Paramètre : chemin complet d’un fichier
*Retour : chaine de caractères alphanumériques


====Remplacer une chaine par une autre==== <!--T:255-->
[[Fichier:OX S Replacechaine.png|gauche|sans_cadre]]





<!--T:256-->
Action : dans une chaine de caractères, remplacer récursivement une sous-chaine par une autre.

<!--T:257-->
<u>Paramètres Standard</u> :

<!--T:258-->
-	Chaine de caractères d’origine

<!--T:259-->
-	Sous-chaine à remplacer (valeur alphanumérique)

<!--T:260-->
-	Sous-chaine de remplacement (valeur alphanumérique)

<!--T:261-->
Retour : chaine de caractères alphanumériques.

====Supprimer les espaces significatifs==== <!--T:262-->
[[Fichier:OX S Delete space.png|gauche|sans_cadre]]






<!--T:263-->
Action : supprimer les espaces en début et/ou en fin d’une chaine de caractères.

<!--T:264-->
<u>Paramètres Standard</u> :

<!--T:265-->
-	Chaine de caractères d’origine

<!--T:266-->
-	Supprimer les espaces en début : Oui (par défaut) / Non

<!--T:267-->
-	Supprimer les espaces en fin : Oui (par défaut) / Non

<!--T:268-->
Retour : chaine de caractères alphanumériques.

====Mettre en majuscules==== <!--T:269-->
[[Fichier:OX S maj.png|gauche|sans_cadre]]

<!--T:270-->
*Action : mettre une chaine de caractères en majuscules.
*Paramètre : chaine de caractère d’origine.
*Retour : chaine de caractères alphanumériques.


====Mettre en minuscules==== <!--T:271-->
[[Fichier:OX S min.png|gauche|sans_cadre]]

<!--T:272-->
*Action : mettre une chaine de caractères en minuscules.
*Paramètre : chaine de caractère d’origine.
*Retour : chaine de caractères alphanumériques.


====Capitaliser==== <!--T:273-->
[[Fichier:OX S Capitaliser.png|gauche|sans_cadre]]





<!--T:274-->
Action : mettre une majuscule en début d’une chaine de caractères ou au début de chaque mot d’une chaine de caractères.

<!--T:275-->
<u>Paramètres Standard</u> :

<!--T:276-->
-	Chaine de caractère d’origine.

<!--T:277-->
-	Au début de chaque mot : Oui / Non (par défaut)

<!--T:278-->
Retour : chaine de caractères alphanumériques.

====Inverser la casse==== <!--T:279-->
[[Fichier:OX S Inversecasse.png|gauche|sans_cadre]]

<!--T:280-->
*Action : inverser la casse (majuscule / minuscule) d’une chaine de caractères.
*Paramètre : chaine de caractère d’origine.
*Retour : chaine de caractères alphanumériques.


===Groupe de commandes Mapping=== <!--T:281-->

====Conversion de page de code==== <!--T:282-->
[[Fichier:OX S CVRT CODEPAGE.png|gauche|sans_cadre]]





<!--T:283-->
Action : convertir un fichier d’une page de code dans une autre. Cette commande est usuellement employée pour convertir un fichier en Unicode (UTF-16, ou page de code 1200).

<!--T:284-->
<u>Paramètres Standard</u> :

<!--T:285-->
-	Nom du fichier source (à convertir)

<!--T:286-->
-	Nom du fichier de destination (converti)

<!--T:287-->
-	Page de code d’origine (valeur alphanumérique à sélectionner par la fonction d’aide à la saisie)

<!--T:288-->
-	Page de code de destination (valeur alphanumérique à sélectionner par la fonction d’aide à la saisie, 1200 par défaut)

<!--T:289-->
<u>Paramètres Avancés</u> :

<!--T:290-->
-	Convertir les chiffres en chiffres arabes : Oui / Non (par défaut)

<!--T:291-->
-	Remplacer les caractères inconnus par des espaces : Oui / Non (par défaut)

<!--T:292-->
Retour : aucun. Un fichier est créé en sortie.


====Conversion de spool ISERIES==== <!--T:293-->
Remarque : les valeurs par défaut reprennent les attributs du fichier émis par l’iSeries distant.
[[Fichier:OX S CVRT ISERIES.png|gauche|sans_cadre]]







<!--T:294-->
Action : convertir un fichier EBCDIC en ASCII Unicode. Cette commande est usuellement employée pour convertir les spools produits sur iSeries puis traités dans ONYX Server version Unix ou Windows.

<!--T:295-->
<u>Paramètres Standard</u> :

<!--T:296-->
-	Nom du fichier source (à convertir)

<!--T:297-->
-	Nom du fichier de destination (converti)

<!--T:298-->
-	Page de code d’origine (valeur alphanumérique à sélectionner par la fonction d’aide à la saisie)

<!--T:299-->
<u>Paramètres Avancés</u> :

<!--T:300-->
-	Type des données issues de l’iSeries (*SCS, *AFPDS, …)

<!--T:301-->
-	Nombre de lignes par page (valeur numérique)

<!--T:302-->
-	Largeur en sortie (valeur numérique)

<!--T:303-->
-	Option pour conserver les informations de SO/SI pour les fichiers DBCS

<!--T:304-->
Retour : aucun. Un fichier est créé en sortie.

====Exécution M-CONNECT, sortie TXT==== <!--T:305-->

<!--T:306-->
[[Fichier:OX S EXEC TXT.png|gauche|sans_cadre]]






<!--T:307-->
Action : exécuter un format M-Connect produisant une sortie texte.

<!--T:308-->
<u>Paramètres Standard</u> :

<!--T:309-->
-	Nom du format M-Connect (valeur à sélectionner par la fonction d’aide à la saisie)

<!--T:310-->
-	Nom du fichier de sortie

<!--T:311-->
<u>Paramètres Avancés</u> :

<!--T:312-->
-	Activation du mode debug : Oui / Non (par défaut)

<!--T:313-->
-	Numéro du port si fonctionnement en mode persistant (valeur numérique)

<!--T:314-->
-	Nom du journal des erreurs si fonctionnement en mode persistant (valeur alphanumérique)

<!--T:315-->
-	Type des données en sortie (agit sur le calcul des sauts de page automatiques)

<!--T:316-->
<u>Paramètres Custom</u> : paramètres d’entrée pour l’exécution du format M-Connect de type DB.PARAM=value.

<!--T:317-->
Retour : aucun. Un fichier est créé en sortie.


====Exécution M-CONNECT, sortie XML==== <!--T:318-->
[[Fichier:OX S CVRT XML.png|gauche|sans_cadre]]






<!--T:319-->
Action : exécuter un format M-Connect produisant une sortie XML.

<!--T:320-->
<u>Paramètres Standard</u> :

<!--T:321-->
-	Nom du format M-Connect (valeur à sélectionner par la fonction d’aide à la saisie)

<!--T:322-->
-	Nom du fichier de sortie

<!--T:323-->
-	Schéma XML à utiliser pour produire la sortie

<!--T:324-->
<u>Paramètres Avancés</u> :

<!--T:325-->
-	Activation du mode debug : Oui / Non (par défaut)

<!--T:326-->
-	Numéro du port si fonctionnement en mode persistant (valeur numérique)

<!--T:327-->
-	Nom du journal des erreurs si fonctionnement en mode persistant (valeur alphanumérique)

<!--T:328-->
<u>Paramètres Custom</u> : paramètres d’entrée pour l’exécution du format M-Connect, de type DB.PARAM=value.

<!--T:329-->
Retour : aucun. Un fichier est créé en sortie.


====Exécution M-CONNECT, sortie XLSX==== <!--T:330-->
[[Fichier:OX S CVRT XLSX.png|gauche|sans_cadre]]







<!--T:331-->
Action : Exécuter un format M-Connect produisant une sortie XLSX.

<!--T:332-->
<u>Paramètres Standard</u> :

<!--T:333-->
-	Nom du format M-Connect (valeur à sélectionner par la fonction d’aide à la saisie)

<!--T:334-->
-	Nom du fichier de sortie

<!--T:335-->
<u>Paramètres Avancés</u> :

<!--T:336-->
-	Activation du mode debug : Oui / Non (par défaut)

<!--T:337-->
-	Numéro du port si fonctionnement en mode persistant (valeur numérique)

<!--T:338-->
-	Nom du journal des erreurs si fonctionnement en mode persistant (valeur alphanumérique)

<!--T:339-->
Paramètres Custom : Paramètres d’entrée pour l’exécution du format M-Connect, de type DB.PARAM=value.

<!--T:340-->
Retour : Aucun. Un fichier est créé en sortie.
</translate>