Condividere un connettore personalizzato
Dopo aver creato un connettore personalizzato per l'API Printer Framer, si vuole rendere disponibile il connettore per tutti gli utenti dell'organizzazione. In questo modo potranno chiamare tale API dai propri flussi di lavoro di App per la logica di Azure. Si sa anche che molti clienti usano App per la logica di Azure. Se si pubblica il connettore, i clienti possono effettuare chiamate all'API in modo semplice.
Condividere un connettore con l'organizzazione
Se il connettore personalizzato è stato creato e usato in un flusso di lavoro delle app per la logica, per impostazione predefinita il connettore è disponibile per gli altri utenti di App per la logica di Azure nell'organizzazione. Tali utenti potranno aggiungere il connettore ai flussi di lavoro nelle aree dell'app per la logica se soddisfano i criteri seguenti:
- Condividono lo stesso tenant di Microsoft Entra.
- Condividano la stessa sottoscrizione di Azure.
App per la logica di Azure condivide automaticamente i connettori personalizzati, che gli altri utenti possono visualizzare quando selezionano i connettori per i loro flussi di lavoro. È possibile, tuttavia, che si voglia informarli del nuovo connettore, sugli scopi, su come usarlo e così via.
Condividere un connettore con la community
Se gli utenti esterni possono chiamare l'API, è consigliabile pubblicare il connettore personalizzato nella community di Azure. La pubblicazione semplifica notevolmente la creazione di flussi di lavoro con App per la logica di Azure e l'accesso ai dati tramite l'API. Una disponibilità più ampia del connettore personalizzato consente anche di pubblicizzare l'API e promuoverne l'adozione da parte della community.
L'API Print Framer è un buon esempio. L'API è accessibile per chiunque abbia una sottoscrizione e possa scrivere codice che effettua chiamate all'API REST. Tuttavia, se si pubblica il connettore personalizzato, gli utenti che usano App per la logica di Azure possono chiamare l'API dai loro flussi di lavoro senza scrivere alcun codice. È possibile che alcune persone non conoscano l'API, pertanto, se trovassero il connettore tramite la raccolta di connettori di App per la logica di Azure, potrebbero decidere di provare l'API e persino di acquistare una sottoscrizione.
Per pubblicare il connettore nella raccolta di connettori di App per la logica di Azure, è necessario inviare il connettore a Microsoft per la certificazione. Se il connettore soddisfa i criteri di certificazione, Microsoft pubblicherà il connettore, che diventerà visibile e disponibile per tutti gli utenti di App per la logica di Azure.
Criteri di certificazione
Microsoft certifica solo i connettori che soddisfano i criteri seguenti:
| Funzionalità | Obbligatorio o Consigliato | Descrizione |
|---|---|---|
| Titolarità SaaS (Software-as-a-Service) | Richiesto | L'organizzazione deve essere proprietaria dell'API a cui il connettore consente l'accesso. |
| Authentication | Richiesto | L'API deve supportare OAuth2, la chiave API o l'autenticazione di base. |
| Supporto tecnico | Richiesto | È necessario offrire un contratto di supporto agli utenti in modo che i clienti possano richiedere assistenza per problemi tecnici. |
| Disponibilità | Consigliato | Occorre garantire almeno il 99,9% di tempo di attività nel contratto di servizio (SLA). |
Elenco di controllo prima di inviare un connettore
Testare il connettore prima di inviarlo per la certificazione. Assicurarsi di essere certi che non siano presenti bug o altri problemi. L'elenco seguente include i problemi comuni da controllare e risolvere:
- Errori nella definizione OpenAPI: eliminare qualsiasi codice JSON non valido nel file di definizione dell'API. Assicurarsi che la definizione dell'API sia conforme allo schema OpenAPI.
- Informazioni complete nella definizione: verificare che ogni operazione, parametro di input e attributo della risposta nella specifica OpenAPI inviata includa riepilogo, descrizione e informazioni sulla visibilità.
Inviare un connettore per la certificazione
Il processo di certificazione richiede circa due settimane, ma questa sequenza temporale dipende dal modo in cui il connettore soddisfa i criteri precedenti. Il processo prevede più o meno i passaggi seguenti:
Nomina: aprire il modulo per la nomina per inviare il connettore. Microsoft invierà un accordo tra partner.
Revisione: dopo la firma dei contratti, un dipendente Microsoft revisiona il connettore. Potrebbe essere necessario specificare l'ID del connettore, la definizione OpenAPI, un file di icona, un account di test, un indirizzo di posta elettronica per l'assistenza e altre informazioni.
Pubblicazione: Microsoft rende disponibile e pubblica il connettore con il tag "Anteprima".
Supporto e aggiornamenti: dopo che Microsoft pubblica il connettore e gli utenti iniziano a usarlo, monitorare i forum del prodotto correlati per scoprire se i clienti riscontrano problemi. Se è necessario inviare una nuova versione, usare lo stesso modulo per la nomina. Quando è trascorso del tempo dalla pubblicazione del connettore, è possibile richiedere al contatto della nomina di rimuovere il tag "Anteprima".
Per altre informazioni, consultare Inviare il connettore per la certificazione Microsoft.