Configurazione di URL e percorsi di trasferimento dell'host
Un uso comune dei modelli di criteri è consentire la configurazione dinamica dell'API che i trigger e le azioni dell'endpoint useranno in fase di runtime. Sono disponibili i seguenti modelli di criteri:
Imposta URL host: sostituisce l'URL completo dell'host con uno creato dai criteri.
Instrada richiesta: instrada una richiesta in entrata a un endpoint specificato sull'URL dell'host configurato.
Imposta URL host
Per impostazione predefinita, l'URL dell'host usato viene configurato in modo statico, così come avviene per tutti i trigger e le azioni sul connettore. L'uso del modello Imposta criteri URL host permette di configurare l'URL per i trigger e le azioni singolarmente. Un esempio di questo scenario potrebbe essere avere le azioni relative agli ordini in un URL (ad esempio, ordersapi.contoso.com) e le azioni relative all'utente in un altro (ad esempio, userapi.contoso.com). Questo scenario richiederebbe la configurazione di due modelli di criteri mediante la selezione dell'utente appropriato o delle azioni dell'ordine per applicare i nuovi URL degli host.
Probabilmente, l'uso più comune è consentire agli utenti di fornire l'URL host in fase di runtime quando creano una nuova connessione usando il connettore personalizzato, come mostrato in precedenza in questo modulo. In questo esempio, è stata aggiunta una proprietà denominata hostURL all'espressione connectionParameters e l'utente ha fornito l'URL completo dell'host al momento della connessione.
Un altro modo comune di usare il modello Imposta criteri URL host consiste nel creare in modo dinamico parte dell'URL dell'host, lasciandone una parte statica. Usando questo approccio, l'utente deve solo fornire il nome del proprio account o altri dati chiave per completare l'URL. Un esempio di questo scenario è il connettore Azure Key Vault, in cui l'URL dell'host è univoco per ogni insieme di credenziali. Anziché chiedere all'utente di fornire l'URL dell'insieme di credenziali completo (https://contosokv.vault.azure.net), è possibile aggiungere una proprietà di connessione denominata keyVaultName e chiedere all'utente di fornire solo quella parte dell'URL (contosokv, in questo esempio). L'esempio seguente mostra l'aspetto di questo modello di criteri.
È inoltre possibile includere dati utilizzando le espressioni @headers e @queryParameters, oltre a usare @connectionParameters.
Instrada richiesta
Ogni azione sul connettore personalizzato ha un URL completo (come https://api.contoso.com/AddInvoice) che viene usato per effettuare la richiesta all'API sottostante. Questo URL è formato dalla combinazione dell'host (ad esempio, api.contoso.com) specificato nella scheda Generale e del percorso (ad esempio, /AddInvoice) proveniente da una definizione importata o estratta da una richiesta di esempio quando è stata eseguita una richiesta di esempio di importazione. I criteri Imposta URL host consentono di modificare l'host, mentre Instrada richiesta permette di modificare il percorso.
Un altro scenario che è possibile realizzare con i criteri Instrada richiesta è avere più azioni che puntano allo stesso percorso. Si immagini ad esempio di avere l'azione Elenca fatture con fromAmount come parametro e di voler creare un'azione Elenca fatture importanti con un valore predefinito per fromAmount: in questo caso verrebbe restituito un errore poiché entrambe puntano allo stesso percorso, /ListInvoices. Invece, è possibile definire l'azione List Big Invoices con percorso /ListBigInvoices, che non esiste nell'API. È quindi possibile usare un modello Route request per inviare queste chiamate all'azione a / ListInvoices. L'esempio seguente mostra l'aspetto del modello di criteri.
È anche possibile includere parametri e altre espressioni per semplificare la creazione del percorso. Ad esempio, il connettore Microsoft Outlook Tasks ha un percorso predefinito nelle cartelle Elenco in un gruppo di /v2/me/taskgroups('{group_id}')/taskfolders. Usando il seguente modello di criteri Instrada richiesta, le richieste verranno inoltrate al nuovo percorso.
Si noti che, in {group_id}, le richieste facevano riferimento a uno dei parametri dell'azione, in modo simile a ciò che avveniva nel percorso originale.
L'uso dei modelli di criteri Imposta URL host e Instrada richiesta offre la flessibilità per instradare le richieste all'API sottostante in base alle esigenze.