Script de classification de documents

Un classificateur ABBYY FlexiCapture traite les documents soumis et détermine leur classe. Cela vous permet de choisir une définition de document à utiliser pour l’extraction de champs. Chaque classificateur correspond à un lot d’entraînement à la classification spécifique. Pour utiliser plusieurs classificateurs pour un même lot, configurez un script de classification. Cela peut être utile lorsque certains documents nécessitent une classification supplémentaire : le premier classificateur attribue une classe à chaque document, puis le script sélectionne un classificateur supplémentaire en fonction du résultat. Par exemple, les documents peuvent d’abord être classés en « factures » et « contrats », puis les factures peuvent être classées plus finement selon le nom de l’entreprise.

Ce script ne peut être configuré que pour un lot d’entraînement à la classification déjà existant. Vous ne pouvez pas le configurer lors de la création d’un nouveau lot.

Configurer un script de classification

Ouvrir les propriétés du projet

Cliquez sur Project → Propriétés du projet.

Ouvrir l’onglet Recognition

Dans la fenêtre des propriétés du projet, accédez à l’onglet Recognition.

Ouvrir l’éditeur de script de classification

Dans la section Classification, cliquez sur Définir à droite de Utiliser un script.

Ajouter un classificateur

Dans la boîte de dialogue, cliquez sur Ajouter et choisissez un lot de classification dans la liste.

Définir un nom d’alias

Si vous le souhaitez, modifiez le Nom d’alias du classificateur. Le script fait référence au nom indiqué dans la colonne Nom d’alias ; vous n’avez donc pas besoin de le réécrire si le nom d’un classificateur change pendant le traitement.

Ouvrir l’éditeur de script

Cliquez sur Edit Script pour ouvrir la fenêtre Script Editor.

Paramètres

Name	Type	Accès	Description
`BatchTypeClassifier`	IBatchTypeClassifier	Lecture seule	Un classificateur du type de lot.
`IsConfident`	bool	Lecture seule	Niveau de confiance de la classification. Contrairement aux classificateurs automatiques, lorsque vous utilisez le script, ce paramètre doit être spécifié manuellement dans les propriétés de la page. Voir l’exemple suivant.
`Page`	IPage	Lecture/écriture	Page du document.
`Processing`	IProcessingCallback	Lecture/écriture	Objet permettant de consigner des informations sur le traitement.

L’exemple suivant spécifie IsConfident dans les propriétés de la page :

IClassificationResult result = Classifiers[0].ClassifyPage( Page );
Page.ResultClassName = result.ClassName;
Page.IsResultClassConfident = result.IsConfident;

Classer une page et définir le nom de la classe

Ce script classe les pages et ajoute le nom de la classe à leurs propriétés :

IBatchTypeClassifierResult classifierResult = BatchTypeClassifier.ClassifyPage( Page, null );
Page.ResultClassName = classifierResult.ClassName;

Obtenir les niveaux de confiance de la classification

Ce script récupère les niveaux de confiance de la classification :

IClassificationResult result = Classifiers[0].ClassifyPage( Page );
FCTools.ShowMessage( "Class: " + result.ClassName );
Page.ResultClassName = result.ClassName;
FCTools.ShowMessage( "IsConfident: " + result.IsConfident );
Page.IsResultClassConfident = result.IsConfident;

Combiner plusieurs classificateurs pour une classification en cascade

var res0 = Classifiers.Get ( "Batch" ).ClassifyPage( Page );
IClassConfidences classVars = res0.Classes;
foreach( IClassConfidence c in classVars )
{
    FCTools.ShowMessage( c.Name + " --> " + c.Confidence.ToString() );
}
FCTools.ShowMessage( "Class res0: " + res0.ClassName);
if (res0.ClassName == "Invoice")
{
    var res1 = Classifiers.Get ( "Batch2" ).ClassifyPage( Page );
    IClassConfidences classVars1 = res1.Classes;
    foreach( IClassConfidence d in classVars1 )
    {
        FCTools.ShowMessage( d.Name + " --> " + d.Confidence.ToString() );
    }
    FCTools.ShowMessage( "Class res1: " + res1.ClassName);
    Page.ResultClassName = res1.ClassName;
}
else
{
    Page.ResultClassName = res0.ClassName;
}
FCTools.ShowMessage( "Page.ResultClassName: " +Page.ResultClassName);

Attribuer la classe Unknown aux documents présentant un faible niveau de confiance

Utilisez ce script si, dans votre scénario, les documents présentant un faible niveau de confiance ne doivent pas se voir attribuer de classe, même si une classe a déjà été définie pour eux. Un opérateur doit classer manuellement ces documents.

Pour que le script fonctionne, créez au préalable une nouvelle classe — par exemple, “Unknown” — et associez-la à la définition de document dans la boîte de dialogue Mise en correspondance des classes. Pour plus d’informations, voir Mise en correspondance des classes avec les sections de définition de document.

using System;

IClassificationResult result = Classifiers.Get ( "ClassifierBatch" ).ClassifyPage(Page);
Page.ResultClassName = result.ClassName;
IClassConfidences classVars = result.Classes;
Page.Comment = "";

foreach( IClassConfidence c in classVars )
{
    //FCTools.ShowMessage( c.Name + " -- " + c.Confidence.ToString() ); // enregistre la valeur de confiance de classification dans le journal des événements
    Page.Comment = Page.Comment + c.Name + "-" + c.Confidence.ToString() + "; "; // enregistre la valeur de confiance de classification dans les commentaires de la page
}

if (classVars.Count>0)
{
    if (classVars[0].Confidence<80) Page.IsResultClassConfident=false; // seuil de confiance en dessous duquel un document sera classé comme incertain
    else Page.IsResultClassConfident=true;

    if (classVars[0].Confidence<20) Page.ResultClassName="Unknown"; // seuil de confiance en dessous duquel un document se verra attribuer la classe « Unknown »
    if (classVars.Count>1) {
        int classesToShow = Math.Min(classVars.Count, 3);
        for(int i=0; i<classesToShow; i++)
        {
            Page.Comment = Page.Comment + classVars[i].Name + "-" + classVars[i].Confidence.ToString() + "; ";
        }
    }
}

FCTools.ShowMessage( "Class: " + Page.ResultClassName );

Les seuils de confiance dans ce script sont fournis uniquement à des fins de démonstration. Modifiez-les en fonction de votre workflow.

​Configurer un script de classification

​Paramètres

​Classer une page et définir le nom de la classe

​Obtenir les niveaux de confiance de la classification

​Combiner plusieurs classificateurs pour une classification en cascade

​Attribuer la classe Unknown aux documents présentant un faible niveau de confiance

Configurer un script de classification

Paramètres

Classer une page et définir le nom de la classe

Obtenir les niveaux de confiance de la classification

Combiner plusieurs classificateurs pour une classification en cascade

Attribuer la classe Unknown aux documents présentant un faible niveau de confiance