Creación de una jerarquía de documentos con las API de objeto de Datacap

Puede utilizar las API del objeto de Datacap para crear una jerarquía de documentos. Por ejemplo, puede utilizar estas API para leer un archivo XML de DCO de configuración y agregar objetos hijo, incluyendo documentos, páginas y campos.

Antes de empezar

En esta tarea también se presupone que ha exportado correctamente un lote de documentos desde una base de datos a un archivo XML.

Acerca de esta tarea

Como el uso de las API de objeto de Datacap está limitado a los lote de tiempo de ejecución y las jerarquías de documentos, la tarea no incluye pasos para el reconocimiento de datos y el cálculo inicial de los niveles de confianza.

Procedimiento

Para crear una jerarquía de documentos mediante las API de objeto de Datacap, realice los pasos siguientes:

Utilice el método ReadSetup para leer una jerarquía de documentos que haya exportado:
```
m_oDCO.ReadSetup("C:\\temp_location\\exported_application.XML");
```
Utilice el método WriteSetup para rellenar su nuevo objeto de configuración y guardar la jerarquía de documentos como un archivo XML:
```
m_oDCO.WriteSetup("C:\\Datacap\\NEW\\dco_NEW\\NEW.XML")
```
Opcional: Utilice el método AddNode para agregar objetos hijo (documentos, páginas o campos) en el objeto de configuración.
El método AddNode utiliza dos argumentos nType lpszNodeName. El valor de nType (1) especifica que el nodo nuevo es un objeto de documento. El valor de lpszNodeName especifica que el nombre de objeto de documento es NewNode, según se muestra en el ejemplo siguiente:
```
m_oDCOSetup.AddNode(1, "NewNode");
```
El nodo resultante en el archivo XML de configuración de DCO es <D type="NewNode">.
Consejo: De la misma forma, puede agregar páginas, campos o caracteres estableciendo el valor de nType en 2 (para páginas), 3 (para campos) o 4 (para caracteres).
Utilice el método AddRule para especificar la estructura de un documento.
En este paso se obtiene el objeto SetupNode para el documento NewNode en el DCO de configuración. A continuación, el paso añade una regla que precisa de la existencia de una instancia de la página NewPage para que la estructura del documento sea válida. Si no existe un nodo de página para NewPage, el método crea NewPage automáticamente.
```
TDCOLib.DCOSetup m_oDCOSetup = m_oDCO.SetupObject();
TDCOLib.DCOSetupNode m_oDCOSetupNode = 
   m_oDCOSetup.GetNodeByName(1, "NewNode");
m_oDCOSetupNode.AddRule(2, "NewPage", 0, 1, 1);
```
Después de la ejecución del código, la línea siguiente se añade al DCO de configuración bajo el tipo de documento NewNode.
```
	<D type="NewNode">
	.
	.
	.
	<P type="NewPage" pos="0" min="1" max="1"/> 
```
Además, si NewPage no existe, se crea el nuevo nodo de página siguiente en el DCO de configuración:
```
<P type="NewPage">
	<V n="ID">0</V>
	<V n="TYPE">Page</V>
	<V n="STATUS">0</V>
	<V n="IMAGEFILE"></V>
	<V n="DATAFILE"></V>
	<V n="TEMPLATE IMAGE"></V>
	<V n="MIN_TYPES">0</V>
	<V n="MAX_TYPES">0</V>
</P>
```
Utilice el método Read, el método Write y la propiedad XML para exportar la jerarquía de documentos a una ubicación externa, que puede ser un repositorio de contenido, una base de datos o un servidor web. En este ejemplo se exporta la jerarquía de documentos a una ubicación temporal en un servidor local:
```
m_oDCO.Read("C:\\C:\\Datacap\\NEW\\dco_NEW\\NEW.XML");
strDCOXml = m_oDCO.XML;
m_oDCO.Write ("c:\\temp_location\\new_application.xml")
```
El método Read almacena la jerarquía de documentos en un objeto de configuración. La propiedad XML asigna el archivo XML a una variable, y el método Write graba la jerarquía de documentos (DCO de configuración) en una ubicación nueva.