6. Balises de macro pour Corbit

Macro spéciale qui renvoie une seule virgule (,).

Macro spéciale qui renvoie un seul signe de pourcentage « % ».

Le nom de l’action dans le contexte en cours où la macro est évaluée.

Cette macro renvoie un identifiant de ressource Portfolio. L’identifiant renvoyé provient de la ressource en cours dans l’étendue du traitement. Pour plus de détails, voir la section Ressources dans l’étendue.

Récupère la clé du champ nommé d’après la ressource actuelle dans l’étendue du traitement. Pour plus de détails, voir la section Ressources dans l’étendue.
Si, par exemple, le champ Filename est désiré, la macro %ASSET[Filename]% doit être utilisée. La clé est sensible à la casse.

Cette macro est similaire à la macro ASSET ci-dessus. La différence réside dans le fait que la macro ASSET_LIST est utilisée lorsque la clé du champ peut comporter plusieurs valeurs, par exemple le champ « Keywords ».
Le délimiteur est la séquence de caractères qui sera utilisée pour séparer les valeurs et créer le texte résultant.

Exemple : Si nous avons une ressource dont le champ Keywords est défini comme Pomme et Banane, la macro %ASSET_LIST[Keywords,#]% aura pour résultat « Pomme#Banane ».

Cette macro renvoie une structure XML pour la ressource en cours dans l’étendue du traitement; voir la section Ressources en contexte pour plus de détails.
Le résultat aura la structure suivante;

 

<asset id="[id]" [nom de champ]="[valeur]" ...>

<[nom de champ]>[valeur]</[nom de champ]>

<[nom de champ]-list>

<[nom de champ]>[valeur]</[nom de champ]>

</[nom de champ]-list>

...

</asset>

 

Chaque clé de la ressource de type booléen, date, décimale, nombre ou URL figurera dans la liste des paramètres racine de la ressource avec l’identifiant de la ressource.
Les champs de type geojson, geopoint, image, chaîne ou blocs de textes auront leurs propres balises (le nom de la balise est le nom du champ).
Les autres champs qui peuvent avoir plusieurs valeurs seront insérés dans leurs propres balises qui auront pour nom le nom du champ avec le suffixe « -list ».
Cette balise contient alors toutes les valeurs séparées dans des balises dont le nom est celui du champ.

Par exemple, si une ressource comporte le champ Keywords avec les valeurs « Pomme » et « Banane », le résultat sera

 

<asset id="12345" ...>

<Keywords-list>

<Keywords>Pomme</Keywords>

<Keywords>Banane</Keywords>

</Keywords-list>

...

</asset>

À partir de cette macro ASSET_XML, la macro XPATH peut être utilisée pour récupérer des valeurs spécifiques.

Renverra l’ID de catalogue qui appartient à l’actif Portfolio actuel. Cette macro n’est utile que s’il existe un tel actif dans le périmètre actuel.
Ceci est disponible dans le champ d’application si vous avez par exemple une source Portfolio ou si vous avez une « action pour chaque actif »

La macro est destinée principalement à un usage interne.

Dans le conteneur de l’application, servlet ou applet en cours d’exécution se trouvent certains paramètres internes qui peuvent être appelés à l’aide de cette macro. La clé de paramètre diffère pour chaque conteneur.

Ceci va capturer un texte et le convertir en un texte codé en Base64. Le codage optionnel peut être utilisé si le texte source est sous un format spécifique.

Cette macro est l’opposé de BASE64. La macro traitera un texte codé en BASE64 et le décodera.
Par exemple : utiliser %BASE64_DECODE[%BASE64[ceci est un texte]%]% donnera le résultat « ceci est un texte », (d’abord il sera codé en BASE64, puis il sera décodé.

Ceci capture un fichier et transforme son contenu en une chaîne codée en Base64. L’argument chemin est le chemin complet vers le fichier à coder.

Récupère une valeur à partir du compartiment d’objet (c.-à-d. l’objet en cours de traitement). Ceci peut être utile par exemple pour récupérer une valeur d’une autre action qui a été invoquée avant l’action en cours.

<key> est la clé que l’action précédente a utilisée pour placer la valeur dans le compartiment. Voir la documentation des différentes actions pour savoir ce qu'elles placent dans le compartiment.

Notez que le flux de travail lui-même place certaines valeurs dans ce compartiment avant qu'une action quelconque ne soit exécutée.

Ce compartiment est différent du compartiment de flux de travail qui peut être utilisé avec la macro %Workflow_BUCKET[...]%.

Vous trouverez plus d’informations au sujet des différents compartiments dans le chapitre 2.

Renvoie le nombre de fichiers présents dans le compartiment d’objet avec la clé <key>. Si <onlyFiles> est « true», le décompte ne comprendra que les fichiers ; s’il est « false», le décompte comprendra les fichiers et les dossiers. La valeur dans le compartiment doit être une liste de fichiers (voir les différentes actions pour plus d’informations sur ce qu’elles placent dans le compartiment).

Renvoie les noms des fichiers présents dans le compartiment d’objet avec la clé <key>. Si <onlyFiles> est « true», alors les noms ne comprendront que les fichiers ; s’il est « false», les noms comprendront les fichiers et les dossiers. La valeur dans le compartiment doit être une liste de fichiers (voir les différentes actions pour plus d’informations sur ce qu’elles placent dans le compartiment).

La liste renvoyée est une liste de noms de fichiers séparés par des virgules.

Ceci est une macro qui va concaténer une liste en une seule chaîne avec un délimiteur défini.

Cette macro prend une valeur de compartiment, considère cette valeur comme une liste d’éléments (par exemple depuis la clé de compartiment -list spéciale créée pendant l’action sur la base de données) et concatène ces éléments avec le délimiteur spécifié.

Exemple : Si la clé de compartiment paper-list contient une liste résultant d’une action sur une base de données et comporte les éléments suivants: actualités, sports, publicités. L’utilisation de la macro %BUCKET_LIST[paper-list,#]% résultera en la chaîne suivante: actualités#sports#publicités

NB! Si l’on désire insérer une virgule (,) comme délimiteur, celle-ci doit être précédée d’un signe de pourcentage (%,).

Cette macro fonctionne sur une liste de compartiment (p. ex. une valeur issue de l’appel d’une base de données). La macro ne renvoie rien, elle supprime seulement toutes les entrées en double dans la valeur de compartiment concernée.

Exemple : Si la clé de compartiment paper-list contient une liste résultant d’une action sur une base de données et comporte les éléments suivants: actualités, sports, actualités, publicités. L’utilisation de la macro %BUCKET_LIST_REMOVE_DUPLCIATES[paper-list]% change les éléments du compartiment pour donner les éléments suivants: actualités, sports, publicités

Cette macro vérifie une condition et renvoie différentes valeurs en fonction du résultat de la condition.

Le paramètre <exp> qui est vérifié doit être une expression valide ; voir ci-dessous.

Si l’expression est vraie, le texte <t> (qui peut contenir d’autres macros) est analysé et renvoyé. Si l'expression est fausse, le texte <f> est analysé et renvoyé.

L’expression <exp> doit contenir l›une des expressions mathématiques suivantes (la première occurrence est retenue)

Renvoie le caractère qui contient le nombre décimal unicode <no>.

ple chemin peut être vide, alors le fichier courant sera utilisé comme source, sinon le chemin est utilisé comme source pour le fichier à analyser.
le compartiment spécifie quelle valeur de compartiment doit être définie. Les valeurs de compartiment seront une liste (où vous pourrez utiliser par exemple plus tard %BUCKET_LIST…%) avec le nom de tous les chemins de détourage qu’un fichier image contient.

Cette macro est similaire à %SEPARATE_BY_ROW[…]% mais attendra un texte structuré CSV qui gérera les guillemets, etc.

Paramètres:

Cette macro est utilisée pour séparer une seule ligne d’un texte au format CSV. Cette macro est normalement utilisée dans le paramètre de gestion de la macro %CSV_PARSE_ROWS[…]%.

Paramètres:

Forme simple

La forme simple renvoie la date du jour au format aaaa-mm-jj.

Variante [<format>]

Si le format <format> est spécifié, le résultat sera exprimé sous ce format. Le format peut contenir des caractères spéciaux tels que le point (.), la virgule (,) (dans ce cas, celle-ci doit être suivie de « % » afin d’être traitée correctement) et le trait d’union (-). Les caractères ci-dessous montrent comment obtenir un format spécifique. Le nombre de répétition de chaque caractère détermine la chaîne de date résultante, p. ex. pour l’année 2006, yyyy donne le résultat 2006 tandis que yy donne 06.

Variante[+<d>,<format>] ou [-<d>,<format>]

Si le premier paramètre commence par les signes plus ou moins, le nombre de jours spécifié <d> sera ajouté ou soustrait respectivement de la date du jour avant que le résultat ne soit calculé. Le <format> est décrit ci-dessus.

Cette macro utilisera une date/heure et ajoutera (ou soustraira si un nombre négatif est utilisé) et renverra la nouvelle date/heure.
sourcedate est la date/heure d’entrée
sourceformat est le format de spécification de la date source
unit indique l’une des valeurs suivantes (jour, heure, minute, seconde) et il s’agit alors de l’unité à changer.
amount indique combien d’une donnée unit qui doit être ajouté (ou soustrait si un nombre négatif est utilisé)
outputformat spécifie le format final souhaité de sortie de l’heure.

Example: %DATE_CHANGE[2022-05-04,yyyy-MM-dd,day,7,ww]% Renverra le numéro de la semaine si 7 jours sont ajoutés à la date 2022-05-04, donc le résultat serait « 19 »

Cette macro compare deux dates et renvoie la différence en secondes entre les deux.

Les paramètres date1 et date2 sont des chaînes représentant des dates. Chacun d’eux doit se conformer aux formats date1 et date2 (voir la macro %D% pour plus d’informations sur les formats).

La valeur renvoyée est la différence entre les deux dates exprimée en secondes. Si les dates sont identiques, 0 est renvoyé. Si date1 est antérieure à date2, un nombre négatif est renvoyé.

Cette macro n’est utilisée que dans les actions qui créent un fichier de destination. Cette macro n’aura pas d’effet si le fichier créé n’existe pas. Si le fichier en cours de création existe, cette macro détermine la façon de créer un nouveau nom. Notez que la macro spéciale %FREE_INDEX% peut être utilisée dans le paramètre texte de cette macro.

Dans la plupart des cas où cette macro peut être utilisée, il existe une case à cocher dans la configuration qui permet d’écraser le fichier. Cette case à cocher n’a pas d’effet si cette macro est utilisée dans l’action.

Cette macro remplace la configuration de Corbit version 5 et plus ancienne, dans laquelle l‘utilisateur pouvait spécifier un préfixe qui s’ajoutait au nom de fichier si le fichier résultant existait déjà. Avec cette macro, il est possible de modifier le nom de fichier autrement qu’en ajoutant simplement un préfixe.

NB! Actuellement, cette macro ne peut pas être utilisée dans une action d’envoi vers un serveur FTP!

 

 

Notez que cette macro n’est utile que dans le contexte où il n’est fait référence qu’à un seul fichier.

Suffixe du File name (point inclus) le cas échéant. Si le fichier ne contient aucun suffixe, le résultat est une chaîne vide.

Forme simple

Si l’objet traité est un courriel, le corps du message est renvoyé. Si le courriel contient plus d’un corps, le texte renvoyé sera d’abord le corps en texte simple, puis le corps codé en HTML.

Variante [<mime>]

Ceci renvoie d’abord le corps du courriel en format mime spécial <mime>. Si le courriel ne contient aucun corps au mime spécifié, une chaîne vide est renvoyée. Exemple de types de mime: texte/simple ou texte/html

Si l’objet traité est un courriel, la date de réception du message est renvoyée.

Cette macro fonctionne comme la macro date %D% avec toutes les variantes de paramètres.

Si l’objet traité est un courriel, l’adresse électronique de l’expéditeur est renvoyée.

Si l’objet traité est un courriel, le nom complet de l’expéditeur est renvoyé.

Si l’objet traité est un courriel, la date d’envoi du message est renvoyée.

Cette macro fonctionne comme la macro date %D% avec toutes les variantes de paramètres.

Si l’objet traité est un courriel, le texte de l’objet du message est renvoyé.

Semblable à la macro EMAIL_SENDER_ADDRESS (qui récupère l’adresse à partir de laquelle un e-mail a été envoyé).
EMAIL_TO renverra l’adresse à laquelle l’e-mail actuel est envoyé. Si l’e-mail est envoyé à plusieurs destinataires, toutes les adresses seront reçues avec une virgule entre elles.

Si l’objet traité est une image contenant des informations EXIF, la macro renvoie les informations EXIF trouvées dans le numéro de champ EXIF <no>.

Notez que cette macro n’est utile que dans le contexte où il n’est fait référence qu’à un seul fichier.

Forme simple
Corps du nom de fichier (c.-à-d. le nom de fichier amputé de son suffixe et du point).

Variante [<s>,<e>]

Partie du corps du nom de fichier. Démarre à l’indice <s> (l’indice 1 est affecté au premier caractère) et se termine à l’indice <e>. Si <s> n’est pas spécifié, 1 est utilisé. Si <e> est absent, l’indice du dernier caractère est utilisé. Notez que les virgules doivent être présentes même si <s> ou <e> sont omis.

Variante [O,<ch]>

Le premier paramètre est la lettre « O ». Ceci donne une partie du corps du nom de fichier, en débutant au premier caractère et en prenant tous les caractères jusqu’à la première occurrence de <ch>. Si <ch> ne se trouve pas dans le nom de fichier, le résultat est le même que pour %F%.

Variante [O,<ch>,<no>,<l>]

Le premier paramètre est la lettre « O ». Ceci donne une partie du corps du nom de fichier commençant à la première occurrence de <ch>. Ensuite, la macro se déplace de <no> caractères (un signe moins peut précéder <no> pour revenir en arrière). Ceci représente maintenant la position de départ, et un nombre <l> de caractères sont lus. Si <l> est omis, le reste du corps du nom de fichier est sélectionné. Notez que la dernière virgule doit être présente même si <l> est omis.

Variante[OI,<index>,<no>,<l>]

Le premier paramètre comprend les lettres « O » et « I ». Cela donne une partie du corps du nom de fichier commençant au caractère <index> (le premier caractère est l’indice 1 ; si vous désirez le dernier caractère, utilisez -1). Ensuite <no> (nombre) de caractères seront lus (un signe moins peut précéder <no> pour revenir en arrière). Ceci représente le début, puis <l> caractères sont sélectionnés à partir de là. Si <l> est omis, le reste du corps du nom de fichier est sélectionné. Notez que la dernière virgule doit être présente même si <l> est omis.

Lit le fichier dont le chemin est <file> (le chemin dépend de l’environnement depuis lequel cette macro est appelée) et renvoie le contenu du fichier dans le format de texte sélectionné avec <format>.

Si le format est omis, « UTF-8 » est utilisé comme format par défaut. Notez que la virgule doit être présente même si <format> est omis.

En option, les paramètres <start> et <end> peuvent être utilisés. Ceux-ci indiquent l’emplacement du début et de la fin de la portion du contenu du fichier à récupérer. Les paramètres de début et de fin représentent l’emplacement de l’octet correspondant. Le premier emplacement dans le fichier est zéro (0).

La macro simple sans paramètres récupérera le contenu du fichier actuellement dans l’étendue de la macro.

Lorsque vous utilisez des paramètres, le paramètre <file> peut être vide ;dans ce cas le fichier actuellement dans l’étendue sera utilisé, p. ex. %FILE_CONTENT[,ISO-8859-1]%

Cette macro n’est utile que dans les contextes où un fichier est présent.

Ceci récupère les dimensions du fichier en mm. La valeur renvoyée sera la largeur suivie de « x » (espace, x, puis un autre espace) suivi de la hauteur.

Le premier paramètre est le nombre de décimales à utiliser; si ce paramètre est omis, la valeur par défaut est définie sur zéro (0) décimales.

Le second paramètre est utile uniquement dans le cas d’un fichier PDF. Ceci est alors la case PDF à utiliser lorsque l’on obtient la dimension. Si c’est omis, l’ordre par défaut sera trimBox,mediaBox,cropBox,bleedBox,artBox.

Voir également les macros FILE_DIMENSION_W et FILE_DIMENSION_H pour plus d’informations.

Cette macro est similaire à FILE_DIMENSION mais n’obtiendra que la valeur de la hauteur.

Cette macro est similaire à FILE_DIMENSION mais n’obtiendra que la valeur de la largeur.

Vérifie si un certain fichier (de chemin <path>) existe. Ceci renvoie « true» si le fichier existe et « false» dans le cas contraire. Le chemin donné doit être disponible sur le serveur Corbit. Voir également %SOURCE_FILE_EXISTS[...]%.

Renvoie le nombre de pages dans le fichier. La macro par défaut sans paramètre vérifie le fichier actuellement dans l’étendue. Si le paramètre est présent, il représente le chemin vers le fichier à vérifier.

Seuls les fichiers PDF renverront un calcul effectif du nombre de pages, les autres fichiers renverront la valeur « 1 ».

Notez que cette macro n’est utile que dans le contexte où il n’est fait référence qu’à un seul fichier.

Chemin du dossier parent du fichier actuel.

Notez que cette macro n’est utile que dans le contexte où il n’est fait référence qu’à un seul fichier.

Chemin complet vers le fichier.

Ceci va remplir le <text> avec un certain <filler> (caractères de remplissage). Le premier paramètre est soit start soit end selon que vous désiriez que les caractères de remplissage précèdent le texte ou s’ajoutent à la fin. Le paramètre max length

est le nombre maximal de caractères du résultat.

Exemple : %FILL[start,12345,0,10]% résultera en 0000012345

Nom du filtre dans le contexte actuel où la macro est évaluée.

Cette macro vérifie un certain dossier (dossier de disque disponible depuis le serveur Corbit), compte tous les fichiers contenus dans ce dossier et renvoie ce nombre.

Le résultat est le nombre de fichiers non masqués (à l’exclusion des dossiers) trouvés directement dans le dossier.

Cette macro vérifie un certain dossier (dossier de disque disponible depuis le serveur Corbit), compte le nombre d’octets de tous les fichiers, y compris les sous-dossiers et renvoie ce nombre.

Le résultat est la taille en octets de tous les fichiers non masqués (y compris les sous-dossiers) trouvés dans le dossier.

Cette macro agit sur chaque élément d’une liste de compartiment.

Le paramètre clé est la clé de compartiment qui contient actuellement une liste de valeurs (par exemple résultant d’une recherche dans une base de données).

Le paramètre tmpKey peut avoir n'importe quelle valeur ; il est utilisé pour placer chaque entrée dans la liste de compartiment afin d’exécuter ce qui est défini dans le paramètre de la macro. Assurez-vous que vous utilisez une valeur unique pour le paramètre tmpKey.

Le dernier paramètre, macro, peut prendre la valeur de toute autre macro ou texte statique. Chaque entrée de la liste de compartiment sera définie par le résultat de ce paramètre de macro.

 

Cette macro est utilisée pour convertir un texte d’un format de date en un autre format de date. Pour les différents caractères du format, voyez la macro %D%.

<text> est la date source spécifiée dans le format <from>. Le résultat est la même date, au format <to>.

Cette macro est une macro spéciale utilisée uniquement dans la macro %DUPLICATE_FILE_EXTRA[...]%

Cette macro renvoie le premier indice libre dans un scénario de fichier dupliqué.

Renvoie un texte au format HTML basé sur le <text>. Les entités telles que ä seront utilisées à la place des caractères « ä » et autres.

Renvoie la hauteur de l’image du fichier image en cours de traitement (le cas échéant). Le paramètre format est facultatif et peut être soit mm soit px, ce qui a pour effet d’exprimer la hauteur de l'image en millimètres ou en pixels. Si le paramètre de format est absent (en utilisant %IMAGE_HEIGHT%), la hauteur est exprimée en pixels.

Renvoie la largeur de l’image du fichier image en cours de traitement (le cas échéant). Le paramètre de format est facultatif et peut être soit mm soit px, ce qui a pour effet d’exprimer la largeur de l'image en millimètres ou en pixels. Si le paramètre de format est absent (en utilisant %IMAGE_WIDTH%), la largeur est exprimée en pixels.

Macro spéciale utilisée dans les actions de fractionnement de fichiers PDF dans laquelle l’indice en cours du fichier PDF fractionné peut être utilisé par exemple dans le nom de fichier résultant.

Le texte <s> est recherché et l’indice de la première occurrence de <t> est renvoyé. L’indice est numéroté à partir de zéro, ce qui signifie que si <s> commence par <t>, l’indice renvoyé est « 0 ». Si <t> n’est pas trouvé dans <s>, « -1 » est renvoyé.

<s> et <t> peuvent tous deux contenir des textes de macros.

Si le paramètre optionnel <start> est présent, c’est l’indice de début du texte à partir duquel la recherche doit démarrer. Toute occurrence de <t> avant cet indice est ignorée. L’indice <start> est numéroté à partir de zéro, ce qui signifie que le premier caractère contenu dans <s> reçoit l'indice 0 (zéro).

Si l’objet traité est une image comportant des informations IPTC, la macro renvoie les informations IPTC trouvées dans le numéro <no> du IPTC field.

NB Seules les informations IPTC peuvent être lues, et non les informations XMP. Pour les données XMP, utilisez la macro XMP.

Le texte <s> est recherché et l’indice de la dernière occurrence de <t> est renvoyé. L’indice est numéroté à partir de zéro, ce qui signifie que si <s> commence par <t>, l’indice renvoyé est « 0 ». Si <t> n’est pas trouvé dans <s>, « -1 » est renvoyé.

<s> et <t> peuvent tous deux contenir des textes de macros.

Si le paramètre optionnel <start> est présent, il indique l’indice du texte à partir duquel la recherche démarre (en progressant depuis la fin). Toute occurrence de <t> après cet indice est ignorée. L’indice <start> est numéroté à partir de zéro, ce qui signifie que le premier caractère contenu dans <s> reçoit l'indice 0 (zéro).

Renvoie la longueur de <text>. Le nombre de caractères contenu dans <text> est compté et renvoyé.

Cette macro peut être très utile, par exemple dans une expression; voir la macro CASE pour plus d’informations.

La valeur renvoyée est <text>, dans laquelle chaque caractère apparaît en minuscule.

Ceci invoque l’expression mathématique <math command> sur <leftExpression> et <rightExpression>. Le nombre renvoyé aura le nombre maximal de décimales défini dans le paramètre <decimals>. Les paramètres <leftExpression> et <rightExpression> peuvent contenir des nombres (provenant éventuellement d’autres macros).

Le paramètre <decimals> est facultatif. Si <decimals> est omis, la dernière virgule doit également être omise.

Le paramètre <math command> peut être l'un des éléments suivants :

Notez que cette macro n’est utile que dans le contexte où il n’est fait référence qu’à un seul fichier.

La macro renvoie l’heure de modification du fichier actuellement référencé. Les variantes de la macro sont identiques à celles de la macro D, où vous trouverez plus d’informations sur les différents paramètres.

Récupère l’heure de modification d’un fichier en millisecondes.

La version par défaut récupère l’heure de modification du fichier en cours dans l’étendue. La méthode alternative consiste à passer un chemin de fichier comme paramètre, ce qui récupérera l’heure de modification de ce fichier.

Si l'objet en cours de traitement contient des balises ID3, la valeur de la balise d’album est renvoyée.

Si l'objet en cours de traitement contient des balises ID3, la valeur de la balise d’artiste est renvoyée.

Si l'objet en cours de traitement contient des balises ID3, la valeur de la balise de commentaire est renvoyée.

Si l'objet en cours de traitement contient des balises ID3, la valeur de la balise de genre est renvoyée.

Si l'objet en cours de traitement contient des balises ID3, la valeur de la balise de titre est renvoyée.

Si l'objet en cours de traitement contient des balises ID3, la valeur de la balise de piste est renvoyée.

Si l'objet en cours de traitement contient des balises ID3, la valeur de la balise de nombre de pistes est renvoyée.

Si l'objet en cours de traitement contient des balises ID3, la valeur de la balise de l’année est renvoyée.

La valeur renvoyée est <text>, dans laquelle chaque retour chariot et saut de ligne ont été supprimés. Le retour chariot est remplacé par un espace si aucun espace ne précède le retour chariot. Cela signifie que si le texte original comprend plusieurs retours chariot qui se succèdent immédiatement, ceux-ci ne seront remplacés que par un seul espace au maximum.

Notez que cette macro n’est utile que dans le contexte où i est fait référence à un fichier.

Cette macro est similaire à la macro F, mais le nom provient du dossier parent. Toutes les variantes de la macro applicables à la macro F sont également disponibles pour cette macro.

Renvoie une version modifiée de <s> où toutes les occurrences de <source> sont remplacées par <target>.

type peut être « objet », « flux de travail » ou « système » (« objet » est par défaut, c’est-à-dire la variante de la macro sans type signifie que l’objet est utilisé comme type.)
key est la clé et value est la valeur. Cette macro définira ensuite une valeur de compartiment (similaire à une action de compartiment)

Cette macro va séparer un texte source (la source doit être structurée avec un ou plusieurs délimiteurs).

Paramètres:

Très similaire à %SEPARATE[…]% mais cette macro fonctionnera avec plusieurs lignes. Chaque gestion aura lieu sur chaque ligne et colonne et des macros telles que %SEPROWNUM% peuvent être utilisées.

Paramètres:

Cette macro renverra le numéro de ligne actuel (la première ligne a le numéro de ligne 1). Ceci n’est utile que lorsqu’il est présent dans la gestion de %SEPARATE_BY_ROW[…]% ou %CSV_PARSE_ROWS[…]%.
Si les macros de séparation sont imbriquées, le paramètre name peut être utilisé pour obtenir les données de cette séparation spécifiquement nommée.

Cette macro renverra le numéro de colonne actuel (la première colonne a le numéro de colonne 1). Ceci n’est utile que lorsqu’il est présent dans la gestion de %SEPARATE_BY_ROW[…]% ou %CSV_PARSE_ROWS[…]%.
Si les macros de séparation sont imbriquées, le paramètre name peut être utilisé pour obtenir les données de cette séparation spécifiquement nommée.

Cette macro renverra la valeur actuelle dans la portée. Ceci n’est utile que lorsqu’il est présent dans la gestion de %SEPARATE_BY_ROW[…]% ou %CSV_PARSE_ROWS[…]%.
Si les macros de séparation sont imbriquées, le paramètre name peut être utilisé pour obtenir les données de cette séparation spécifiquement nommée.

Cette macro renverra une valeur d’en-tête (le nom de l’en-tête si des en-têtes sont présents). L’utilisation de la macro sans paramètres renverra la valeur d’en-tête de la colonne actuelle.
Si le paramètre column index est présent, l’en-tête de cette colonne particulière (les colonnes sont numérotées à partir de 1) sera renvoyé.
Si les macros de séparation sont imbriquées, le paramètre name peut être utilisé pour obtenir les données de cette séparation spécifiquement nommée.

Cette macro est similaire à %SEPVALUE[…]% mais cette macro renverra la valeur de n’importe quel index de colonne donné à la ligne actuelle.
Cette macro peut être utile si la gestion de la colonne actuelle dépend d’une autre valeur dans la même ligne.

Paramètres:

Cette macro est similaire à %SEPVALUE[…]% mais cette macro renverra la valeur de n’importe quel en-tête donné à la ligne actuelle.
Cette macro peut être utile si la gestion de la colonne actuelle dépend d’une autre valeur dans la même ligne.

Paramètres:

Safe File Name (Nom de fichier valide) - Cette macro renvoie le texte <text> dans lequel toutes les occurrences des caractères suivants sont remplacées par le caractère de soulignement (_);

La macro peut être utilisée pour vérifier si un fichier spécifique existe. La macro utilise la source spécifique dans l’étendue de la macro pour trouver le fichier. Si cette source est une source FTP, le serveur FTP sera analysé pour localiser le fichier désiré.

Comparée à la macro %FILE_EXISTS[...]%, cette macro peut également être utilisée dans un contexte de source FTP pour vérifier si un certain fichier existe sur le serveur FTP.

Cette macro va analyser un dossier spécifique trouvé sur la source, compter tous les fichiers dans ce dossier et renvoyer ce nombre.

Le résultat est le nombre de fichiers non masqués (à l’exclusion des dossiers) trouvés directement dans le dossier. La macro utilise la source spécifique dans l’étendue de la macro pour trouver le fichier. Si cette source est une source FTP, le serveur FTP sera analysé pour localiser le fichier désiré.

Comparée à la macro %FOLDER_FILE_COUNT[...]%, cette macro peut également être utilisée dans un contexte de source FTP pour obtenir le nombre à partir du serveur FTP.

Le nom de la source qui est la source invoquant l’objet dans le contexte en cours où la macro est évaluée.

Récupère une valeur du compartiment du flux de travail en cours. Le compartiment de flux de travail est un compartiment statique contenant des informations qui resteront dans le flux de travail aussi longtemps que le flux de travail existera. Ce compartiment est différent du compartiment d’objet qui est utilisé avec la macro %BUCKET[...]%.

Vous trouverez plus d’informations au sujet des différents compartiments dans le chapitre 2.

Le nom du flux de travail dans lequel le contexte de la macro est évalué.

Macro spéciale qui remplace tous les caractères exceptés ceux figurant dans la liste ci-dessous par un caractère de soulignement (_)

Les caractères qui restent inchangés sont :

. (point)

- (tiret)

_ (soulignement)

0-9 (chiffres)

a-z (caractères a-z)

A-Z (caractères A-Z)

Renvoie une portion de la chaîne source <s>. La portion débute à l’indice <start> (inclus) et se termine à l’indice <end> (exclu). Si <end> est omis, le reste de la chaîne est sélectionné depuis le début. Si <start> est omis, la sous-chaîne est sélectionnée depuis le début. L’indice est numéroté à partir de zéro, ce qui signifie que le premier caractère contenu dans <s> reçoit l'indice 0.

Notez que si <start> et/ou <end> est/sont omis, les virgules doivent néanmoins être présentes.

Renvoie une version modifiée de <text>. La valeur renvoyée est spécialisée afin de s’insérer dans les documents XML où les caractères sont remplacés par des entités, p. ex. « å » est remplacé par « å » . Les caractères dont le code UTF est supérieur à 128 sont remplacés par l’entité « &#<no>; » où <no> représente la valeur UTF du caractère.

La chaîne <text> peut contenir des macros.

Le résultat de cette macro est le paramètre texte sans espace(s) avant et après le texte proprement dit. Les espaces qui seront supprimés comprennent les espaces, les tabulations, le retour chariot et le saut de ligne.

La valeur renvoyée est <text> dans lequel chaque caractère est en majuscule.

La valeur renvoyée est un identifiant unique.

Les données XMP du fichier sont lues et la valeur de l’identifiant xmpID spécifié est renvoyée.

xmpID est un identifiant qui est unique pour chaque donnée XMP. Les identifiants par défaut des champs de données XMP sont visibles sous forme d’infobulle dans les menus contextuels spéciaux XMP disponibles dans la configuration. Les données XMP personnalisées disposent de leur propre identifiant spécifié par l’utilisateur lors de la création. xmpID est égal au préfixe XMP suivi par deux points et le nom de champ de propriété, p. ex. tiff:Compression

La valeur renvoyée est toujours sous forme de chaîne même si la valeur est une date ou un autre objet.

Si aucun paramètre filePath (chemin de fichier) n’est mentionné, le fichier en cours dans l’étendue de la macro sera lu, sinon ce sera le fichier défini par le chemin de fichier.

Cette macro calcule une expression XPath à partir de la chaîne donnée (format XML). Le résultat renvoyé est une chaîne représentant le résultat de l’expression XPath.

Le paramètre string est la chaîne XML sur laquelle l’expression XPath sera calculée.

Seuls les paramètres string et xpath sont obligatoires ; le reste des paramètres est optionnel et s’ils existent, ils doivent avoir la structure suivante: préfixe=URI. Ces paramètres sont utilisés pour identifier des espaces de nom dans la chaîne XML, le préfixe étant le préfixe de l’espace de nom et l’URI étant l’URI de l’espace de nom. Par exemple, l’espace de nom IPTC Core aurait la valeur suivante: Iptc4xmpCore=http://iptc.org/std/Iptc4xmpCore/1.0/xmlns/

Pour plus d’informations sur les expressions XPath valides, voir http://docs.oracle.com/javase/tutorial/jaxp/xslt/xpath.html

Très similaire à la macro XPATH. Le résultat de cette expression XPath sera considérée comme une valeur de nœud et le résultat sera ce nœud comme XML, comparé à la macro XPATH qui forcera le résultat sous forme de valeur de chaîne.

Les paramètres sont les mêmes que pour la macro XPATH.

Pour plus d’informations sur les expressions XPath, voir http://docs.oracle.com/javase/tutorial/jaxp/xslt/xpath.html

Cette macro calcule une expression XPath à partir de la chaîne donnée (format XML). Le résultat renvoyé est une liste de valeurs qui sera enregistrée dans le compartiment en cours avec la clé de compartiment donnée.

Le paramètre string est la chaîne XML sur laquelle l’expression XPath sera calculée.

Seules la chaîne, l’expression xpath et la clé de compartiment sont obligatoires, le reste des paramètres étant facultatif; si ceux-ci existent, ils doivent tous avoir la structure suivante: préfixe=URI. Ces paramètres sont utilisés pour identifier des espaces de nom dans la chaîne XML, le préfixe étant le préfixe de l’espace de nom et l’URI étant l’URI de l’espace de nom. Par exemple, l’espace de nom IPTC Core aurait la valeur suivante: Iptc4xmpCore=http://iptc.org/std/Iptc4xmpCore/1.0/xmlns/

La liste qui est placée dans la clé de compartiment peut être utilisée dans d’autres listes de traitement macros spéciales, p. ex. %BUCKET_LIST[...]%.

Pour plus d’informations sur les expressions XPath, voir http://docs.oracle.com/javase/tutorial/jaxp/xslt/xpath.html

Notez que cette macro n’est utile que dans le contexte où il est fait référence à un fichier compressé.

Cette macro est similaire à la macro F, mais le nom provient du fichier compressé (p. ex. dans l’action de décompression, où %F% renvoie le nom de fichier décompressé mais %ZIPF% renvoie le nom original du fichier compressé). Toutes les variantes de la macro applicables à la macro F sont également disponibles pour cette macro.

Récupère la valeur du compartiment de système nommé « key »

Date : date originale/heure d’expiration, p. ex. 2017-12-13
format : Le format de « date », p. ex. yyyy-MM-dd; voir % D% pour obtenir tous les formats
unit : l’un des éléments suivants: « jour », « heure », « minute » ou « seconde »
amount: nombre d’ « unités » à ajouter ou déduire
resultFormat : Le format désiré pour la date/heure finale
ex% DATE_CHANGE [2017-12-13, yyyy-MM-dd, day, 11, dd / MM-yyyy]% donnera « 24 / 12-2017 »

Analyse un texte Json pour récupérer une propriété. json : Un texte au format json – désiré : la propriété désirée du json

Supprime tout caractère Indicateur d'ordre des octets (BOM) du paramètre « text ».

Remplace le paramètre « text » par « replacement » lorsqu'il existe un caractère non approprié pour un nom de fichier. Les caractères suivants sont supprimés:
Tous les caractères sous forme de code ASCII <32
char 34 (")
char 38 (& )
char 39 (')
char 42 (* )
char 47 (/)
char 58 (: )
char 59 (; )
char 60 (<)
char 62 (>)
char 63 (?)
char 92 (\)
char 124 (|)
tout caractère entre 57344 et 63743
le caractère 65533 (caractère de remplacement unicode)
+ tout autre caractère qui est indéfini

Notez que si « replacement » est omis, le remplacement par défaut sera vide (c.-à-d. les caractères illégaux seront supprimés sans aucun caractère de remplacement).

Traduit « text » en format application/x-www-form-urlencoded. Tout signe « + » sera également codé comme en « %20 »

Très similaire à XPATHLIST. La clé de compartiment résultante sera renseignée avec une liste au lieu d’un texte. Il est donc possible d’utiliser des macros de liste après cette macro, p. ex. BUCKET_LIST.