Passer au contenu principal
L’activité Script est conçue pour mettre en œuvre des règles de script dans une Skill, en complément des règles disponibles dans diverses activités d’extraction. Un script peut contenir des règles pour traiter ou corriger les données extraites par d’autres activités. Vous pouvez avoir besoin d’utiliser des règles de script dans les cas suivants :
  • Normaliser la valeur d’un champ, par exemple séparer un code alpha (un code devise à trois lettres) d’un montant indiqué dans le document.
  • Choisir l’une de plusieurs valeurs de champ, par exemple préciser laquelle doit être sélectionnée et enregistrée dans le champ de résultat si la valeur d’un même champ est extraite par plus d’une activité.
  • Calculer les valeurs de champs qui n’ont pas été trouvées dans le document, par exemple calculer la taxe exigible à l’aide d’un taux d’imposition connu lorsque tous les champs contenant des montants imposables ont été extraits.
Contrairement aux règles métiers, les règles de script ne mettent pas en évidence, lors de la relecture manuelle, les valeurs contenant des erreurs. En effet, elles sont conçues pour compléter et corriger les données obtenues lors du traitement des documents et constituent une partie intégrante des Compétences de document. Pour configurer une activité Script, procédez comme suit :
  1. Ajoutez une activité Script au flux de traitement de documents dans l’onglet Activities. Veillez à l’ajouter après toutes les autres activités d’extraction de champ auxquelles votre règle peut faire référence.
  2. Dans le panneau Activity Properties, cliquez sur Script Editor.
  3. Dans la boîte de dialogue qui s’ouvre, définissez votre règle sous forme de script en JavaScript afin d’exécuter toutes les actions requises. Vous pouvez utiliser les boutons d’édition rapide dans la partie supérieure de l’écran pour ajouter des extraits de code prédéfinis à votre script. Vous trouverez ci-dessous quelques exemples de règles de script que vous pouvez utiliser.

​
Exemples de règles de script

  • Cette règle de script ajoute un code de devise à trois lettres à la valeur du Total. La règle vérifie d’abord la valeur du champ Country. Si la valeur de ce champ est « USA » ou « United States », le code « USD » est ajouté à la valeur numérique du Total. Si la valeur du champ Country est « United Kingdom » ou « Great Britain », le code « GBP » est ajouté à la valeur numérique du Total.
if ( Context.GetField("Country").Value == "USA"|"United States" ) {
               Context.GetField("Total").Value = Context.GetField("Total").Value + " USD";
} else 
if( Context.GetField("Country").Value == "United Kingdom"|"Great Britain" ) {
               Context.GetField("Total").Value = Context.GetField("Total").Value + " GBP";
}
  • Cette règle de script est conçue pour ajouter les noms des organisations sélectionnées aux champs spécifiés. Le champ répétitif Preamble Org regroupe les noms de toutes les organisations mentionnées dans le préambule d’un document, extraits par l’activité Named Entities (NER). La règle de script est configurée de sorte que, si le champ Preamble Org contient les noms de plus de deux organisations, la première valeur extraite sera placée dans le champ Party 1, et la dernière dans le champ Party 2.
var preambleOrgsFields = Context.GetFields("Organisation du préambule");
 
if (preambleOrgsFields.length > 2)
{
   Context.GetField("Partie 1").Value = preambleOrgsFields[1].Value;
   Context.GetField("Partie 2").Value = preambleOrgsFields[preambleOrgsFields.length - 1].Value;
}
  1. Une fois votre script prêt, cliquez sur Save. Une liste s’affiche alors dans le volet Activity Properties avec tous les champs utilisés dans le script. Vérifiez que la liste contient tous les champs requis.
  2. Testez votre Skill en cliquant sur Test Activity et en analysant les résultats d’extraction. Si la règle n’a pas fonctionné comme prévu, vérifiez que le script est correctement écrit. Vérifiez également la qualité d’extraction de tous les champs utilisés dans la règle du script.