Vai al contenuto principale
I parametri di registrazione della Transaction e dei file sono parametri costituiti da coppie chiave-valore di tipo string progettati per fornire informazioni aggiuntive sull’utente (ad esempio, nome del cliente, tipo di documento e informazioni sulla fonte del file). Vengono passati per l’elaborazione insieme alla Transaction o ai documenti della Transaction. Questi parametri sono disponibili per tutti i worker e possono essere utilizzati in vari scenari di produzione:
  • Un programma che utilizza ABBYY Vantage contrassegna ogni transaction utilizzando un attributo del cliente finale ai fini della compilazione di report e della creazione di procedure di elaborazione personalizzate (ad es. filtrando i cataloghi di dati delle controparti in base al cliente).
  • Un client di Scanning Station (o un’altra origine per le transaction) può passare i Parameter di registrazione di un batch di documenti (ad esempio un ID di correlazione esterno).
I Parameter di registrazione possono essere impostati utilizzando la Vantage API:
  1. Quando si crea una transaction vuota o si inizializza una transaction utilizzando il metodo launch. Per farlo, inviare una richiesta POST alla risorsa transactions come nell’esempio seguente:
POST https://your-server/api/publicapi/v1/transactions
o 
POST https://your-server/api/publicapi/v1/transactions/launch?skillId=skill-id
Nel corpo della richiesta, specificare i parametri di registrazione ed eseguire il comando seguente: Per Windows: 
curl -X POST "https://your-server/api/publicapi/v1/transactions" \
-H "Authorization: Bearer token" \
-H "Content-Type: application/json" \
-d "{\"skillId\":\"123\"}" \
   "registrationParameters": [
     {
       "key": "key1",
       "value": "value1"
     }
   ]
Per Linux: 
curl -X POST 'https://your-server/api/publicapi/v1/transactions' \
-H 'Authorization: Bearer token' \
-H 'Content-Type: application/json' \
-d '{"skillId":"123"}' \
   'registrationParameters': [
     {
       'key': 'key1',
       'value': 'value1'
     }
   ]
  1. Per caricare file in una transaction o in un documento, inviare una richiesta POST alla risorsa transactions/<transaction-id>/files come nell’esempio seguente:
POST https://your-server/api/publicapi/v1/transactions/transaction-id/files
Nel corpo della richiesta, specificare i parametri di registrazione ed eseguire il comando seguente: Per Windows: 
curl -X POST "https://your-server/api/publicapi/v1/transactions/transaction-id/files" \
-H "accept: */*" \
-H "Authorization: Bearer token" \
-H "Content-Type: multipart/form-data" \
-F "Model={
   \"files\": [
     {
       \"index\": 0,
       \"imageProcessingOptions\": {
         \"autoCrop\": \"Default\",
         \"autoOrientation\": \"Default\"
       },
       \"registrationParameters\": [
         {
           \"key\": \"key1\",
           \"value\": \"value1\"
         }
       ]
     }
   ]
}" \
-F "[email protected];type=image/tiff"
Per Linux: 
curl -X POST 'https://your-server/api/publicapi/v1/transactions/transaction-id/files' \
-H 'accept: */*' \
-H 'Authorization: Bearer token' \
-H 'Content-Type: multipart/form-data' \
-F 'Model={
   "files": [
     {
       "index": 0,
       "imageProcessingOptions": {
         "autoCrop": "Default",
         "autoOrientation": "Default"
       },
       "registrationParameters": [
         {
           "key": "key1",
           "value": "value1"
         }
       ]
     }
   ]
}' \
-F '[email protected];type=image/tiff'
Importante! È possibile definire al massimo 10 Parameter di tipo chiave-valore, in cui il Parameter della chiave può contenere fino a 128 caratteri e il Parameter del valore fino a 256 caratteri. I valori di questi Parameter non possono essere modificati una volta impostati.
I valori dei parametri di registrazione possono essere letti:
  • negli script delle attività personalizzate,
  • negli script di esportazione esterna dell’attività Output,
  • nelle regole aziendali.
È possibile ottenere i valori dei parametri di registrazione utilizzando la Vantage API come segue:
  1. Chiamando il metodo registrationParameters per la risorsa transactions/<transaction-id>/registrationParameters:
GET https://your-server/api/publicapi/v1/transactions/transaction-id/registrationParameters/
La risposta sarà simile alla seguente: 
[
  {
    "key": "key1",
    "value": "value1"
  }
]
  1. Mediante una chiamata al metodo download per la risorsa transactions/<transaction-id>/files/<file-id>/download per ottenere i valori in formato JSON insieme al file che viene caricato:
GET https://your-server/api/publicapi/v1/transactions/transaction-id/files/file-id/download