Guía de migración de ScanDifFinder SDK a la API de comparación de documentos

Este tema se aplica a FRE para Windows.

Esta sección pretende ayudarle a actualizar el código que usa ABBYY ScanDifFinder SDK a la nueva API de comparación de documentos implementada en ABBYY FineReader Engine.

ABBYY ScanDifFinder SDK:

• Usa mecanismos de reconocimiento integrados para el procesamiento de documentos
• Compara un archivo con su copia y guarda el resultado como imágenes de páginas

ABBYY FineReader Engine con la API de comparación de documentos:

• Usa la gama completa de métodos de ABBYY FineReader Engine para preparar los documentos para la comparación
• Requiere el uso de documentos o páginas reconocidos con ABBYY FineReader Engine
• Compara un documento o un intervalo seleccionado de páginas con sus respectivas copias y exporta el resultado en formato XML o DOCX

En esta versión, la API de comparación de documentos no admite:

• objeto PictureChange

Este objeto se implementará en futuras versiones.

​

Ejemplos

ABBYY ScanDifFinder SDK y API de comparación de documentos utilizan métodos muy diferentes para comparar archivos. Los ejemplos siguientes ilustran esta diferencia.

Ejemplo de código de ABBYY ScanDifFinder SDK

Código C#

//Especifique las rutas de los documentos que se van a comparar,
//y la ruta del resultado de la comparación
 
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 );
}

Ejemplo de API de comparación de documentos

Código C#

// Procesar por completo el documento de referencia
FREngine.FRDocument referenceFRDocument = engine.CreateFRDocument();
referenceFRDocument.AddImageFile( "C:\\ReferenceDocument.pdf", null, null );
referenceFRDocument.Process( dpParams );
// Procesar por completo el documento del usuario
FREngine.FRDocument userFRDocument = engine.CreateFRDocument();
userFRDocument.AddImageFile( "C:\\UserDocument.pdf", null, null );
userFRDocument.Process( dpParams );
// Realizar la comparación
FREngine.IComparator comparator = engineLoader.Engine.CreateComparator();
FREngine.IComparisonResult comparisonResult = 
    comparator.CompareDocuments( referenceFRDocument, userFRDocument, null, null );
FREngine.IChanges changes = comparisonResult.Changes;
// Trabajar con el resultado de la comparación
foreach (FREngine.IChange change in changes)
{
FREngine.IChangeLocation userLocation = change.UserLocation;
FREngine.IChangePosition userChangeStartPosition = userLocation.StartPosition;
FREngine.IChangePosition userChangeEndPosition = userLocation.EndPosition;
}
// Exportar el resultado a un archivo en el formato especificado
comparisonResult.Export( "C:\\ComparisonResult.xml", FREngine.ComparatorExportFormatEnum.CEF_Xml, null );

​

Comparación de API

En la siguiente tabla se describen los métodos y las propiedades de ABBYY FineReader Engine que sustituyen a los métodos y las propiedades de ABBYY ScanDifFinder SDK.

		Utilice el objeto en su lugar como objeto principal para comparar documentos o páginas.
		Utilice el método para comparar documentos y el método para comparar páginas.
		Las imágenes se guardan mediante métodos de ABBYY FineReader Engine; por ejemplo, con el método del objeto .
		Use el método del objeto .
		Utilice en su lugar las propiedades de los objetos , y .
		La licencia de la API de comparación de documentos se gestiona mediante ABBYY FineReader Engine (consulte Licencias).
		Use el método para especificar la ruta de la carpeta de archivos temporales de ABBYY FineReader Engine y otros parámetros adicionales.
		Use el objeto en su lugar. Para representar el resultado de comparar el documento original o la página original con su copia, use los y métodos. Para exportar el resultado a un archivo, use el método.
		Use el objeto en su lugar para obtener la lista de todos los cambios detectados durante la comparación de documentos.
		Utilice la propiedad del objeto para obtener el número de páginas de un documento.
		Utilice el para representar una diferencia entre el documento original y su copia. El le permitirá obtener el cambio realizado en el texto del documento.
		Use en su lugar las y Propiedades del objeto. Estas propiedades devuelven información sobre el tipo de contenido modificado y el tipo de modificación realizada.
		Use the en su lugar la propiedad del objeto .
		Utilice la propiedad del objeto en su lugar.
		Use la propiedad del objeto en su lugar.
		Use la propiedad del objeto en su lugar.
		Utilice el objeto para obtener información sobre un cambio.
		Esta propiedad se ha eliminado porque la API de comparación de documentos utiliza una estructura lógica diferente.
		Use la propiedad del objeto en su lugar.
		Estas propiedades se eliminan porque la API de comparación de documentos utiliza una estructura lógica diferente.
		Utilice el objeto para obtener información sobre la ubicación del cambio.
		Use la del en su lugar. Esta propiedad devuelve la región del cambio en la Página especificada.
		Use el objeto en su lugar.
		Utilice la del objeto con el valor CRM_DoNotReuse. Esta propiedad especifica cómo se usan las capas de texto e imagen del archivo PDF de origen.
		Utilice la propiedad del objeto en su lugar. UseDoubleLanguageAgreementMode no está implementado actualmente.
		Use el método del objeto .
		Esta propiedad se ha eliminado porque la API de comparación de documentos utiliza otra estructura lógica.
		Use la propiedad del objeto en su lugar. Esta propiedad especifica si los objetos de color deben filtrarse de la imagen antes del análisis de diseño y el reconocimiento.
		Utilice en su lugar la propiedad del objeto.
		Use la propiedad del objeto en su lugar.
		Use en su lugar la propiedad del objeto.
		Use en su lugar la propiedad del objeto .
		Esta propiedad se modificó y ahora cumple otra función (consulte la propiedad del objeto).
		Esta propiedad se ha eliminado porque la API de comparación de documentos utiliza una estructura lógica diferente.
		Las imágenes se guardan con métodos de ABBYY FineReader Engine, por ejemplo, con el método del objeto .
		Utilice el método del objeto .
		Use y en su lugar. Estas enumeraciones especifican el tipo de modificación realizada en el contenido del documento y el tipo de contenido que ha cambiado.
		Las imágenes se guardan con métodos de ABBYY FineReader Engine; por ejemplo, con el método del objeto.

​

Consulte también

Objetos de comparación de documentos