Introduzione
Questo modulo esplora l'uso di criteri con i connettori personalizzati e spiega come configurarli con i modelli di criteri.
Contenuto del modulo:
Informazioni su come i criteri possono modificare il comportamento dei connettori personalizzati al runtime.
Applicazioni di modelli di criteri a un connettore personalizzato.
I criteri possono modificare il comportamento di un connettore personalizzato durante il runtime. È possibile usare i criteri per eseguire la conversione dei dati, instradare richieste, impostare i valori dei parametri e altro ancora. È possibile configurare i criteri direttamente nel file delle proprietà dell'API del connettore personalizzato prima dell'importazione oppure è possibile farlo dal portale di creazione nella finestra di progettazione del connettore personalizzato applicando modelli di criteri.
I casi d'uso più comuni per i criteri sono:
Imposta URL host: per impostazione predefinita, l'URL host è hardcoded nella configurazione del connettore. Un criterio, combinato con un parametro di connessione, consente di specificare l'URL host ogni volta che si crea una connessione con quel connettore. Ad esempio, questo caso d'uso può gestire una versione di sviluppo, test e produzione dell'API di sistema.
Imposta intestazioni: usato per promuovere i dati da parametri di connessione, query o corpo della richiesta all'intestazione. Di solito, questo processo viene eseguito per gestire le API che richiedono la configurazione di informazioni specifiche nell'intestazione. Un esempio di questo caso d'uso è un ID di correlazione per tenere traccia dell'intero processo aziendale che viene eseguito.
Imposta parametri di query: usato per gestire i valori predefiniti, se necessario, ma non è configurato dal creatore. Ad esempio, se un'API richiede, tramite un criterio, un parametro superiore per il numero di record da restituire, è possibile impostare un valore predefinito che viene applicato se il creatore non ne configura uno.
È possibile usare i criteri per gestire esigenze specifiche dell'API e semplificare l'uso del connettore nascondendo le complessità non necessarie.
Applicazione di un criterio
L'applicazione di un modello di criteri a un connettore personalizzato consente di selezionare un criterio da un elenco di modelli. Per ogni modello selezionato va compilata la configurazione del relativo criterio. Quando si completa il modulo, il criterio viene attivato dopo aver aggiornato il connettore. Lo screenshot seguente mostra un esempio di creazione di un nuovo criterio con uno dei modelli.
Quando si applica un modello di criteri, è possibile scegliere di applicarlo a tutte le azioni e i trigger oppure solo ad alcuni di essi.
Ad esempio, il modello Imposta URL host viene generalmente applicato a tutte le azioni e i trigger, mentre Converti una matrice in un oggetto (anteprima) viene applicato solo a una o due azioni che restituiscono dati simili.
Quando si configura un criterio da eseguire su tutte le azioni e i trigger, è necessario verificare che tutti i percorsi dei dati usati nei parametri del criterio siano validi per tutte le azioni e i trigger. In caso contrario, possono verificarsi errori di runtime.
Nell'elenco dei criteri configurati, è possibile selezionare i puntini di sospensione (...) accanto a ogni criterio per spostarlo in alto o in basso nell'elenco. Questa funzionalità consente di configurare l'ordine in cui i criteri vengono applicati durante il runtime e può essere utile negli scenari con più modelli di criteri per la conversione dei dati. Ad esempio, un criterio potrebbe analizzare una stringa delimitata in una matrice e un altro potrebbe convertire la matrice in oggetto. In questo esempio, l'ordine di implementazione è importante.
La configurazione di un modello di criteri comporta la modifica delle proprietà API del connettore. Le proprietà API vengono archiviate separatamente dalla definizione API per il connettore. È possibile importare una definizione API aggiornata tramite il portale senza sovrascrivere i criteri configurati.
Visualizzazione e modifica con l'interfaccia della riga di comando
Oltre a visualizzare i criteri nel portale, è anche possibile esportarli nel file delle proprietà dell'API con il comando paconn download dall'interfaccia della riga di comando.
Il download include quattro file (apiDefintion.swagger.json, apiProperties.json, icon.png, settings.json).
Nella sezione policyTemplateInstances del file apiProperties.json sono elencati tutti i criteri configurati.
Lo screenshot seguente mostra un esempio della sezione policyTemplateInstances.
Gli utenti esperti di JSON possono anche modificare direttamente il file apiProperties.json. Con alcuni criteri, ad esempio Imposta URL host, per richiedere l'URL quando viene creata una connessione è necessario modificare connectionParameters nel file apiPropertiess.json per completare la configurazione dei criteri. Il comando paconn update può essere usato per importare le modifiche.
Potrebbe essere utile esaminare come vengono usati i criteri dagli altri connettori. Il repository GitHub dei connettori di Microsoft Power Platform fornisce ottimi esempi di connettori certificati e non certificati. Inoltre, è possibile cercare ed esaminare il file apiProperties.json dei connettori. Cercando un nome di modello di criteri nel repository, ad esempio setHeader, è possibile scoprire rapidamente quali connettori stanno usando il criterio.