Saltar al contenido principal
En el archivo de configuración XML o en el script (según cómo haya elegido configurar la exportación), debe especificar las opciones que se usarán para la exportación. Estas incluyen los parámetros de conexión para conectarse a UiPath Orchestrator, las opciones de imagen de salida, la forma de nombrar los archivos exportados y la Asignación de campos.
  1. Configuración de conexión de UiPath Orchestrator.
1.1. En la opción Server, especifique la dirección del servidor donde se encuentra Orchestrator.
  • Si está usando UiPath Enterprise Orchestrator, especifique la dirección de la aplicación web de Orchestrator en la opción Server de la siguiente manera:
connectorSettings.DmsConnectionSettings.Server = "https://orchestrator.mydomain.com";
  • Si utiliza UiPath Cloud Platform Orchestrator, especifique la siguiente dirección del servidor:
connectorSettings.DmsConnectionSettings.Server = "https://platform.uipath.com";
1.2. En la opción Repository:
  • Si utiliza UiPath Enterprise Orchestrator, especifique el nombre de su tenant de Orchestrator.
    • Si utiliza UiPath Cloud Platform, especifique el nombre de su servicio en su cuenta de la siguiente manera:
connectorSettings.DmsConnectionSettings.Repository = "test_service";
Puede consultar el nombre de un servicio disponible abriendo su cuenta de UiPath Cloud Platform y yendo a la pestaña Services: 1.3. En la opción Username:
  • Si utiliza UiPath Enterprise Orchestrator, especifique el nombre o el correo electrónico del usuario de Orchestrator.
1.4. En la opción Password, especifique la contraseña del usuario de Orchestrator.
Si utiliza UiPath Cloud Platform con cuentas antiguas de UiPath Community Orchestrator, primero debe migrarlas al nuevo método de autenticación restableciendo la contraseña.
A un usuario de Orchestrator se le deben asignar los siguientes roles: view queues, create transactions y view units.
  1. En el campo FileName, especifique la plantilla que se usará para generar los nombres de los archivos de exportación.
Lista de etiquetas dinámicas reemplazables admitidas:
  • <Project> – nombre del proyecto de ABBYY FlexiCapture;
  • <Batch> – nombre del lote;
  • <DocumentDefinition> – nombre de la definición de documento en ABBYY FlexiCapture;
  • <Identifier> – identificador del documento;
  • <BatchType> – nombre del tipo de lote;
  • <Time> – hora actual en formato yyyy-MM-dd_HH-mm-ss;
  • <Index:> – valor del campo Index.
Además, puede usar la etiqueta <FileNameWithoutExtension> para usar el nombre del archivo de origen (si la imagen se recibió desde una Activity de UiPath, el lote contiene este parámetro de registro con el nombre del archivo de imagen de origen).
  1. En el campo DmsMetadataTemplate.Name, especifique el nombre de la cola de Orchestrator, por ejemplo:
connectorSettings.MappedFields.DmsMetadataTemplate.Name = "Verification queue"
Después de ejecutar el script de exportación, se creará una nueva transacción con datos en esta cola. Cree una cola de este tipo en Orchestrator:
  1. ExportImageSavingOptions: las opciones disponibles para las imágenes de salida (por ejemplo, las opciones de formato de imagen o la posibilidad de redactar campos que contienen información confidencial) se describen en la Ayuda de ABBYY FlexiCapture (consulte la descripción de la interface IExportImageSavingOptions).
  2. Asigne los campos para exportar los metadatos reconocidos. Para cada campo de la Definición de Document cuyo valor desee exportar, debe especificar su nombre en la transacción.
Solo se exportarán a la transacción los campos de la Definición de Document que se hayan asignado. Se puede asignar cualquier número de campos.
Si configura las opciones de exportación mediante un script, el par de campos debe tener el siguiente formato:
{ @"Invoice Layout\InvoiceNumber", "InvoiceNumber" }
El primer valor es la ruta completa del campo en la Definición de Document de FlexiCapture. El segundo valor es el nombre del campo en la transacción de UiPath Orchestrator. En el segundo valor, puede especificar el nombre que desea usar para el campo en la transacción. Los campos con los nombres especificados se crearán en la transacción en tiempo de ejecución. Si configura las opciones de exportación mediante XML, el par de campos debe tener el siguiente formato:
<FieldPair>
<AfcField>Invoice Layout\InvoiceNumber</AfcField>
<DmsField>InvoiceNumber</DmsField>
</FieldPair>
Donde AfcField representa el nombre completo del campo en la Definición de Document de ABBYY FlexiCapture, y DmsField representa el nombre del campo en la transacción de UiPath Orchestrator.
  1. También puede especificar ajustes de exportación adicionales de UiPath mediante la propiedad DmsSpecificOptions:
6.1. AuthenticationType le permite elegir el tipo de autenticación que se utilizará al iniciar sesión en UiPath Orchestrator. Solo puede tener 2 valores: Basic y OAuth2.
Si está configurando la exportación a UiPath Cloud Platform Orchestrator, es obligatorio usar esta opción. En este caso, especifíquela como OAuth2.
Si está configurando la exportación a UiPath Enterprise Orchestrator, especifique el valor como Basic. Para UiPath Enterprise Orchestrator, no es obligatorio utilizar esta opción. Puede establecer un valor para esta opción con el siguiente código:
connectorSettings.DmsSpecificOptions = new Option[] { 
new Option(new KeyValuePair<string, object>("AuthenticationType", "OAuth2"))
};
donde AuthenticationType es el nombre de la opción y el segundo atributo, el valor de la opción. 6.2. Reference permite especificar una referencia al crear una transacción. Para configurar esta opción, incluya el siguiente fragmento de código en el script de exportación:
connectorSettings.DmsSpecificOptions = new Option[] { 
new Option(new KeyValuePair<string, object>("Reference", Document.Batch.Id.ToString()))
};
donde Reference es el nombre de la opción y el segundo atributo es el valor de la opción. Especifique Document.Batch.Id.ToString() como valor para usar el identificador del lote como referencia. 6.3. OrganizationUnitName le permite exportar los resultados del procesamiento a la unidad organizativa de Orchestrator especificada. Esta opción solo está disponible para UiPath Enterprise Orchestrator.
en Orchestrator, la función unidad organizativa debe estar habilitada.
Para configurar esta opción, incluya el siguiente código en el script de exportación:
connectorSettings.DmsSpecificOptions = new Option[] { 
new Option(new KeyValuePair<string, object>("OrganizationUnitName", "ORG_UNIT_NAME"))
};
donde OrganizationUnitName es el nombre de la opción y el segundo atributo es su valor. Especifique el nombre de la unidad organizativa que desea establecer como valor de la opción. 6.4. AccountLogicalName le permite especificar a qué cuenta de UiPath Cloud Platform se exportarán los resultados del procesamiento. Esta opción se usa si el usuario tiene varias cuentas de UiPath Cloud Platform disponibles. Solo está disponible para UiPath Cloud Platform Orchestrator. El nombre lógico de la cuenta se usa como valor de esta opción. El nombre lógico se puede encontrar en la Configuración de la cuenta de Orchestrator; es la parte editable de la URL del sitio de Orchestrator. El nombre lógico también aparece en la barra de direcciones del navegador una vez que haya iniciado sesión en su cuenta. El siguiente código de ejemplo ilustra el uso de esta opción:
connectorSettings.DmsSpecificOptions = new Option[] { 
new Option(new KeyValuePair<string, object>("AccountLogicalName", "testaccount123"))
};
donde AccountLogicalName es el nombre de la opción y el segundo atributo es su valor. Si necesita usar varias opciones en un mismo script de exportación, inclúyalas como elementos del array Option (separados por comas). Por ejemplo:
connectorSettings.DmsSpecificOptions = new Option[] {
new Option(new KeyValuePair<string, object>("AuthenticationType", "OAuth2")),
new Option(new KeyValuePair<string, object>("AccountLogicalName", "ACCOUNT_LOGICAL_NAME")),
new Option(new KeyValuePair<string, object>("Reference", Document.Batch.Id.ToString()))
};
  1. La opción SaveDocumentImages indica si los archivos de imagen deben guardarse en una transacción de UiPath Orchestrator. Establezca esta opción en true si deben guardarse las imágenes; establézcala en false si no debe guardarse ninguna.
El código de ejemplo siguiente ilustra el uso de esta opción:
connectorSettings.SaveDocumentImages = true;
Puede encontrar ejemplos de cómo configurar las opciones de exportación en la carpeta [Connector installation path]\Single-task package\Samples\FlexiCapture Scripts. Busque los archivos llamados default.config.xml y UiPath - ExportScript - Configure by script (Attended service).cs.