Vai al contenuto principale
È possibile configurare la funzione di caricamento da mobile utilizzando i seguenti parametri aggiuntivi:
  • Il parametro md consente di personalizzare il numero e i nomi dei documenti, nonché le pagine di ciascun documento da acquisire in un’unica transaction.
  • Il parametro dt consente di configurare il caricamento da mobile per acquisire un singolo tipo di documento.
  • Il parametro redirect_uri consente di configurare il collegamento al sito web che verrà aperto al termine del caricamento da mobile.
  • Il parametro ma abilita l’uso delle microapplicazioni negli ambienti on-premises.

Il parametro md

Puoi definire la struttura dei documenti, indicando numero, tipi e nomi dei documenti da elaborare in un’unica transaction, utilizzando il parametro md. Vantage Mobile Input guiderà gli utenti nell’acquisizione corretta dei documenti specificati per l’elaborazione successiva. Per impostazione predefinita, il parametro md è presente nel link di caricamento da mobile con un valore pari a 0 o 1, a seconda della skill selezionata. Puoi specificare uno dei seguenti valori:
ValoreDescrizione
0Acquisisce un documento con un numero qualsiasi di pagine.
1Acquisisce un numero qualsiasi di documenti con un numero qualsiasi di pagine.
URL codificato al file JSONAcquisisce un numero specifico di documenti con nomi personalizzati, insieme al numero e ai nomi delle pagine definiti per ciascun documento.
File JSON codificatoAcquisisce un numero specifico di documenti con nomi personalizzati, insieme al numero e ai nomi delle pagine definiti per ciascun documento.
Nota: Il file JSON per il parametro md è disponibile solo per il caricamento da mobile tramite micro applicazioni.
Esempio di utilizzo dell’URL codificato al file JSON per il parametro md:
https://your-server/mobile?baseUrl=<base URL>&transactionId=<transaction-id>&md=https%3A%2F%2Fdomain.tld%2Fstructure.json&token=<token>&v=<2.4>
Esempio di utilizzo del file JSON codificato per il Parameter md:
https://your-server/mobile?baseUrl=<base URL>&transactionId=<transaction-id>&md=<encoded_json_structure>&token=<token>&v=<2.4>
Nota: Se il Parameter dt viene utilizzato nel link di caricamento da mobile, il valore del Parameter md verrà ignorato.

Il parametro dt

Per personalizzare il caricamento da dispositivo mobile e acquisire un singolo tipo di documento, usa il parametro dt:
  1. Aggiungi il parametro dt al link di caricamento da dispositivo mobile.
  2. Specifica uno dei seguenti valori:
ValoreDescrizione
idcardAcquisisce entrambi i lati (fronte e retro) di una carta d’identità.
passportAcquisisce la prima pagina di un passaporto.
documentAcquisisce qualsiasi altro documento.
Esempio di utilizzo del parametro dt:
https://your-server/mobile?baseUrl=<base URL>&transactionId=<transaction-id>&dt=idcard&token=<token>&v=<2.4>
Nota: Se il Parameter dt viene utilizzato nel link di caricamento da mobile, il valore del Parameter md verrà ignorato.

Il parametro redirect_uri

Puoi personalizzare un link a un sito web che verrà aperto una volta completato il caricamento da mobile e avviata l’elaborazione della transaction. Questo ti consente di gestire il flusso di lavoro dell’utente dopo il completamento del caricamento da mobile. Per farlo, aggiungi il Parameter redirect_uri al link di caricamento da mobile. Esempio di utilizzo del Parameter redirect_uri:
https://your-server/mobile?baseUrl=<base URL>&transactionId=<transaction-id>&redirect_uri=https%3A%2F%2Fwww.example.com&token=<token>&v=<2.4>
Nota: Quando si utilizza il parametro redirect_uri, assicurarsi di aggiungere l’URL di base (ad esempio https://www.example.com) del collegamento del sito web da aprire nella sezione Allowed redirect URLs delle impostazioni del tenant. Per ulteriori informazioni, vedere Configuring Allowed Redirect URLs.

Il Parameter ma

Per impostazione predefinita, il ma Parameter non è presente nel link di caricamento da dispositivi mobili. Per usare le micro application negli ambienti on‑premises, aggiungere il ma Parameter al link di caricamento da dispositivi mobili con il valore true. Esempio di utilizzo del ma Parameter:
https://your-server/mobile?baseUrl=<base URL>&transactionId=<transaction-id>&ma=true&token=<token>&v=<2.4>
Nota: Il Parameter ma non è supportato negli ambienti cloud.