Guide de migration du SDK ScanDifFinder vers l’API Document Comparison

Cette rubrique s’applique à FRE pour Windows.

Cette section a pour but de vous aider à migrer votre code utilisant le SDK ABBYY ScanDifFinder vers la nouvelle API Document Comparison implémentée dans ABBYY FineReader Engine.

ABBYY ScanDifFinder SDK:

• Utilise des mécanismes intégrés de reconnaissance pour traiter les documents
• Compare un fichier avec sa copie et enregistre le résultat sous forme d’images de pages

ABBYY FineReader Engine avec l’API Document Comparison:

• Utilise l’ensemble des méthodes d’ABBYY FineReader Engine pour préparer les documents à la comparaison
• Nécessite l’utilisation de documents ou de pages reconnus à l’aide d’ABBYY FineReader Engine
• Compare un document ou une plage de pages sélectionnée à la copie correspondante et exporte le résultat au format XML ou DOCX

Dans cette version, l’API Document Comparison ne prend pas en charge :

• Objet PictureChange

Cet objet sera implémenté dans de prochaines versions.

​

Exemples

ABBYY ScanDifFinder SDK et API Document Comparison utilisent des méthodes très différentes pour comparer les fichiers. Les exemples ci-dessous illustrent cette différence.

Exemple de code pour ABBYY ScanDifFinder SDK

Code C#

//Indiquez les chemins des documents à comparer,
//ainsi que le chemin du résultat de la comparaison
 
try
{
    string refFile = Path.GetFullPath( args[0] );
    string userFile = Path.GetFullPath( args[1] );
    ScanDifFinder difFinder = new ScanDifFinder();
    difFinder.TempDir = tempDir;
    ProcessFiles( difFinder, refFile, userFile );
}
catch (Exception)
{
}
finally
{
    if (Directory.Exists( tempDir ))
    Directory.Delete( tempDir, true );
}

Exemple de API Document Comparison

Code C#

// Effectuer le traitement complet du document de référence
FREngine.FRDocument referenceFRDocument = engine.CreateFRDocument();
referenceFRDocument.AddImageFile( "C:\\ReferenceDocument.pdf", null, null );
referenceFRDocument.Process( dpParams );
// Effectuer le traitement complet du document utilisateur
FREngine.FRDocument userFRDocument = engine.CreateFRDocument();
userFRDocument.AddImageFile( "C:\\UserDocument.pdf", null, null );
userFRDocument.Process( dpParams );
// Effectuer la comparaison
FREngine.IComparator comparator = engineLoader.Engine.CreateComparator();
FREngine.IComparisonResult comparisonResult = 
    comparator.CompareDocuments( referenceFRDocument, userFRDocument, null, null );
FREngine.IChanges changes = comparisonResult.Changes;
// Utiliser le résultat de la comparaison
foreach (FREngine.IChange change in changes)
{
FREngine.IChangeLocation userLocation = change.UserLocation;
FREngine.IChangePosition userChangeStartPosition = userLocation.StartPosition;
FREngine.IChangePosition userChangeEndPosition = userLocation.EndPosition;
}
// Exporter le résultat vers un fichier dans le format spécifié
comparisonResult.Export( "C:\\ComparisonResult.xml", FREngine.ComparatorExportFormatEnum.CEF_Xml, null );

​

Comparaison des API

Les méthodes et propriétés d’ABBYY FineReader Engine qui remplacent celles d’ABBYY ScanDifFinder SDK sont décrites dans le tableau ci-dessous.

		Utilisez comme objet principal pour comparer des documents ou des pages.
		Utilisez la méthode pour comparer des documents et la méthode pour comparer des pages.
		L’enregistrement des images s’effectue à l’aide des méthodes d’ABBYY FineReader Engine, par exemple avec la méthode de l’objet .
		Utilisez la de l’objet .
		Utilisez plutôt les propriétés des objets , et .
		La gestion des licences de l’API de comparaison de documents s’effectue à l’aide d’ABBYY FineReader Engine (voir Gestion des licences).
		Utilisez la méthode pour spécifier le chemin d’accès au dossier des fichiers temporaires d’ABBYY FineReader Engine, ainsi que d’autres paramètres supplémentaires.
		Utilisez l’objet à la place. Pour représenter le résultat de la comparaison du document ou de la page d’origine avec sa copie, utilisez les et méthodes. Pour exporter le résultat vers un fichier, utilisez la méthode.
		Utilisez plutôt l’objet pour obtenir la liste de toutes les différences détectées lors de la comparaison des documents.
		Utilisez la propriété de l objet pour obtenir le nombre de pages d’un document.
		Utilisez l’objet pour représenter une différence entre le document original et sa copie. La méthode vous aidera à obtenir la modification apportée au texte du document.
		Utilisez plutôt les et de l’objet . Ces propriétés renvoient des informations sur le type de contenu modifié et le type de modification effectuée.
		Utilisez plutôt la propriété de lobjet au lieu.
		Utilisez plutôt la propriété de l’objet au lieu de celle-ci.
		Utilisez plutôt comme propriété de l’objet .
		Use the property of the object instead.
		Utilisez plutôt l’ objet pour obtenir des informations sur une modification.
		Cette propriété est supprimée, car l’API de comparaison de documents repose sur une autre structure logique.
		Utilisez plutôt la propriété de l’objet à la place.
		Ces propriétés sont supprimées, car l’API de comparaison de documents repose sur une autre structure logique.
		Utilisez l’objet pour obtenir des informations sur l’emplacement de la modification.
		Utilisez plutôt la propriété de l’objet . Cette propriété renvoie la région correspondant à la modification sur la page spécifiée.
		Utilisez l objet à la place.
		Utilisez plutôt la propriété de l’objet , définie sur CRM_DoNotReuse. Cette propriété indique comment utiliser les calques de texte et d’image du fichier PDF source.
		Utilisez plutôt la propriété de l’ objet. UseDoubleLanguageAgreementMode n’est pas actuellement implémenté.
		Utilisez la méthode de l’objet .
		Cette propriété a été supprimée, car l’API de comparaison de documents utilise une structure logique différente.
		Utilisez plutôt la de l’ objet. Cette propriété indique si les objets colorés doivent être filtrés de l’image avant l’analyse de la mise en page et la reconnaissance.
		Utilisez la propriété de l’objet à la place.
		Utilisez plutôt la propriété de l’objet .
		Utilisez plutôt la propriété de l’objet .
		Utilisez plutôt la propriété de l’ objet.
		Cette propriété a été modifiée et remplit désormais une autre fonction (voir la propriété de l’objet ).
		Cette propriété a été supprimée, car l’API de comparaison de documents repose sur une autre structure logique.
		L’enregistrement des images s’effectue à l’aide des méthodes d’ABBYY FineReader Engine, par exemple avec la méthode de l’objet .
		Utilisez la méthode de l’objet .
		Utilisez et à la place. Ces énumérations indiquent le type de modification apportée au contenu du document et le type de contenu modifié.
		L’enregistrement des images s’effectue à l’aide des méthodes d’ABBYY FineReader Engine, par exemple de la méthode de l’objet .

​

Voir aussi

Objets de comparaison de documents