Saltar al contenido principal

​
Uso de parámetros de registro

Los parámetros de registro de transacción y archivo son parámetros que consisten en pares clave-valor de cadenas diseñados para proporcionar información adicional del usuario (por ejemplo, nombre del cliente, tipo de documento e información sobre el origen del archivo). Se pasan para procesamiento junto con la transacción o los documentos de la transacción. Estos parámetros están disponibles para todos los workers y se pueden utilizar en diversos escenarios de producción:
  • Un programa que utiliza ABBYY Vantage marca cada transacción con un atributo del cliente final para compilar informes y crear procedimientos de procesamiento personalizados (por ejemplo, filtrando catálogos de datos de contrapartes por cliente).
  • Un cliente de Scanning Station (u otro origen de transacciones) puede proporcionar los parámetros de registro de un lote de documentos (como un ID de correlación externo).
Los parámetros de registro se pueden configurar mediante Vantage API:
  1. Al crear una transacción vacía o al inicializar una transacción mediante el método launch. Para ello, envíe una solicitud POST al recurso transactions como en el siguiente ejemplo:
o En el cuerpo de la solicitud, especifique los parámetros de registro y ejecute el siguiente comando:
  1. Al cargar archivos en una transacción o en un documento. Para ello, envíe una solicitud POST al recurso transactions/<transaction-id>/files, como se muestra en el siguiente ejemplo:
En el cuerpo de la solicitud, especifique los parámetros de registro y ejecute el siguiente comando:
¡Importante! Puede haber como máximo 10 Parameters de tipo clave-valor, donde el Parameter de clave puede contener hasta 128 caracteres y el Parameter de valor, hasta 256 caracteres. Los valores de estos Parameters no se pueden modificar una vez establecidos.
Los valores de los parámetros de registro se pueden leer:
  • en scripts de actividades personalizadas,
  • en los scripts de exportación externa de la actividad Output,
  • en las reglas de negocio.
Puede obtener los valores de los parámetros de registro mediante la API de Vantage de la siguiente manera:
  1. Llamando al método registrationParameters del recurso transactions/<transaction-id>/registrationParameters:
La respuesta tendrá el siguiente aspecto: 
[
  {
    "key": "key1",
    "value": "value1"
  }
]
  1. Mediante una llamada al método download para el recurso transactions/<transaction-id>/files/<file-id>/download para obtener los valores en formato JSON junto con el archivo que se va a cargar:

​
Uso de parámetros de skill

Además de los parámetros de registro, puede pasar parámetros de skill al crear o iniciar una transacción. Los parámetros de skill son pares clave-valor de tipo cadena que determinan cómo una skill procesa la transacción. Los parámetros de skill se pueden establecer al crear una transacción o al usar el método launch:
Importante: Puede haber un máximo de 10 parámetros de skill por transacción.
Puede recuperar los valores de los parámetros de skill usando la Vantage API llamando al método skillParameters: La respuesta tendrá el siguiente formato: 
[
  {
    "key": "parameterName",
    "value": "parameterValue",
    "type": "string"
  }
]