Passer au contenu principal
L’activité Script est conçue pour mettre en œuvre des règles de script dans une compétence, en plus des règles disponibles dans diverses activités d’extraction. Un script peut contenir des règles pour traiter ou corriger des 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, p. ex. séparer un code alpha (un code de devise à trois lettres) d’un montant indiqué dans le document.
  • Choisir l’une de plusieurs valeurs de champ, p. ex. préciser laquelle doit être retenue 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 pu être trouvées dans le document, p. ex. calculer la taxe exigible en utilisant un taux d’imposition connu lorsque tous les champs comportant des montants imposables ont été extraits.
Contrairement aux règles métier, les règles de script ne mettent pas en évidence les valeurs contenant des erreurs lors de la relecture manuelle. En effet, elles sont conçues pour compléter et corriger diverses données obtenues lors du traitement des documents et constituent une partie intégrante des Compétences de document. Pour configurer une activité Script, suivez les étapes ci-dessous :
  1. Ajoutez une activité Script au flux de traitement des documents dans l’onglet Activities. Notez que vous devez ajouter l’activité après toute autre activité d’extraction de champ que votre règle peut exploiter.
  2. Dans le volet 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 utilisant JavaScript pour créer un script qui exécute toutes les actions requises. Vous pouvez utiliser les boutons d’édition rapide dans la partie supérieure de l’écran pour ajouter à votre script des extraits de code prédéfinis. Voici quelques exemples de règles de script que vous pouvez utiliser.

Exemples de règles de script

  • Cette règle de script est conçue pour ajouter un code de devise à trois lettres à la valeur du champ Total. La règle vérifie d’abord la valeur du champ Country. Si la valeur de ce champ est « USA » ou « United States », un code « USD » est ajouté à la valeur numérique dans le champ Total. Si la valeur du champ Country est « United Kingdom » ou « Great Britain », un code « GBP » est ajouté à la valeur numérique dans le champ 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 destinée à ajouter les noms des organisations sélectionnées aux champs spécifiés. Le champ répétitif Preamble Org contient les noms de toutes les organisations mentionnées dans le préambule d’un document, extraits par l’activité d’extraction d’entités nommées (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("Preamble Org");
 
if (preambleOrgsFields.length > 2)
{
   Context.GetField("Party 1").Value = preambleOrgsFields[1].Value;
   Context.GetField("Party 2").Value = preambleOrgsFields[preambleOrgsFields.length - 1].Value;
}
  1. Une fois votre script prêt, cliquez sur Save. Cette action affichera une liste dans le volet Activity Properties contenant tous les champs utilisés dans le script. Vérifiez que la liste inclut 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 a été correctement rédigé. Par ailleurs, contrôlez la qualité d’extraction de tous les champs utilisés dans la règle du script.