Utilisation de l'API text › API text › Format d'entrée

Format d'entrée

L’entrée dans l’API text est spécifié selon les méthodes suivantes :

• Dans l'interface de ligne de commande, l'entrée est généralement insérée dans un fichier texte transmis à la commande pdm_text_cmd.
• Dans l'interface de messagerie électronique, l'entrée est insérée dans le texte du courriel. Indiquez une expression régulière pour rechercher les identificateurs d'objet cible.

Formatez l'entrée de l'API text de la même façon, quelle que soit l'interface vous utilisez.

Le format de base pour les entrées est le suivant :

%keyword=valeur

ou

%PROPERTY={{property_label}}valeur

Le comportement normal des commandes API text a les exceptions suivantes, où la dernière commande à apparaître sur deux ou plusieurs commandes en conflit est prioritaire :

• Lorsqu'un message contient plusieurs artefacts d'ID de billet valides correspondant à la chaîne de filtrage de la règle de la boîte aux lettres, ou plusieurs commandes d'ID de billet d'API text, la première commande rencontrée est celle qui sera utilisée. En outre, un artefact d'ID de billet, qui est identifié en utilisant la chaîne de filtrage de la règle de la boîte aux lettres, remplace toute commande d'ID de billet d'API text, quelle que soit la commande qui apparaît en premier.
• Lorsqu'un message contient plusieurs commandes API text de commentaire de journal, tous les commentaires sont publiés, bien que l'ordre dans lequel ils apparaissent dans le journal d'activité de billet puisse varier.

Tous les artefacts d'ID de billet qui correspondent au filtrage, valides ou pas et les commandes d'ID de billet d'API text dans le message, applicables ou pas, appliquées ou pas, sont commentés avant la publication du message. Les artefacts d'ID de billet identifiés à travers les filtrages de la règle de la boîte aux lettres apparaissent sous la forme -((...))-. Les signes de pourcentage figurant en tête (%) dans les commandes d'ID de billet d'API text sont convertis en deux parenthèses ouvrantes ((, et deux parenthèses fermantes)) suivent la commande. Si une commande d'ID de billet d'API text apparaît après une autre commande d'API text avec un commentaire de journal (%LOG=…), ensuite, la commande d'ID de billet d'API text commentée est effectuée dans un commentaire de journal séparé.

Remarque : Le commentaire de journal est la seule commande d'API text qui peut apparaître plusieurs fois dans un message et avoir chaque occurrence appliquée. Pour toute autre commande, l'API text utilise uniquement la dernière occurrence car des occurrences multiples d'autres commandes entrent en conflit les unes avec les autres. Des commandes de commentaire de journal multiples publient des messages de commentaire de journal séparés sur le billet et pas nécessairement dans un ordre spécifique.

De plus, si une commande d'ID de billet d'API text apparaît dans le message au début du message ou en entre deux autres commandes d'API text, elle est convertie en commentaire de journal. Si la commande précédente est un commentaire de journal (%LOG=…) ou une description de mise à jour (%DESCRIPTION=…), elle est ajoutée à cette commande, au lieu d'être convertie en commentaire de journal distinct.

Les messages entrants qui sont envoyés au format HTML uniquement, sans inclure une version de texte brut, perdent leur corps de message. Si le message correspond à des filtrages de la règle de la boîte aux lettres avec un corps de message vide, un billet peut être créé avec une description vide ou avec l'objet du message entre guillemets comme l'intégralité de la description de billet.