Introduzione
È possibile creare un connettore personalizzato open source e certificarlo per renderlo disponibile a tutti gli utenti. Se lo si rende open source, il connettore viene pubblicato nel repository GitHub di Microsoft Power Platform.
Repository GitHub di Microsoft Power Platform
Il repository GitHub di Microsoft Power Platform presenta più tipi di connettori che possono essere suddivisi in due gruppi: personalizzati e certificati.
I connettori personalizzati possono essere importati da qualsiasi utente dal repository GitHub in un ambiente, dove si possono usare o dove si possono proporre modifiche al connettore che l'autore può scegliere se adottare. Durante la creazione, un connettore personalizzato è disponibile solo all'autore e agli utenti con cui l'autore lo condivide esplicitamente. L'aggiunta del connettore personalizzato al repository GitHub di Microsoft Power Platform semplifica l'importazione del connettore nel proprio ambiente da parte degli utenti.
Quando certificare un connettore personalizzato
Per rendere visibile un connettore nell'elenco dei connettori ufficiali a tutti gli utenti di Microsoft Power Automate, Microsoft Power Apps o App per la logica di Microsoft Azure, è necessario certificarlo.
Esistono molti motivi per certificare un connettore personalizzato. I principali sono la facilità d'uso, la visibilità e l'espansione della portata dell'API. Certificare il connettore personalizzato se fornisce l'accesso a un'API utile a un ampio gruppo di destinatari e non incentrata sull'uso interno. Non è necessario ospitare il servizio sottostante dell'API in tecnologie Microsoft. I connettori, infatti, consentono di integrare le soluzioni Microsoft Power Platform con le soluzioni non Microsoft. È possibile certificare i connettori gratuitamente o tramite API a pagamento.
Microsoft esamina i connettori certificati prima della pubblicazione per garantire che soddisfino i criteri di certificazione. Sono disponibili due tipi di editori di connettori:
Editori verificati: un requisito fondamentale per gli editori verificati è che si deve essere proprietari del servizio sottostante oppure si devono presentare espliciti diritti di uso dell'API e fornire uno scenario utente che si adatti bene ai prodotti.
Editori indipendenti: questi editori non sono proprietari del servizio sottostante al connettore. Ad esempio, un utente di un'API che non è affiliato alla società può inviare un connettore per l'API per ottenere la certificazione. Questo tipo consente agli utenti della community di partecipare all'ecosistema di connettori di Microsoft Power Platform.
La certificazione iniziale e gli aggiornamenti al connettore sono gratuiti. La prossima unità spiega il processo di certificazione.
Quando creare un connettore personalizzato open source
Qualsiasi connettore personalizzato può essere candidato a diventare un connettore open source se si ritiene che possa essere utile ad altri utenti. Quando si certifica un connettore, il primo passo è rendere open source la definizione. Quindi, si deve controllare che non esista una definizione di connettore personalizzato per l'API che si sta creando all'interno del repository. Se è già presente una definizione, si consiglia di contribuire con delle proposte per migliorarla inviando una richiesta pull invece di provare a creare un connettore duplicato.
Negli esempi seguenti viene descritto quando conviene creare un connettore personalizzato open source e quando non è opportuno.
| Candidato open source ottimale | Candidato open source non ottimale |
|---|---|
| Connettore per un'API pubblicamente disponibile | Connettore per un'API privata disponibile solo all'interno della rete aziendale |
La maggior parte dei contributi richiede l'accettazione di un contratto di licenza di collaborazione (CLA, Contributor License Agreement). Tale contratto dichiara che l'utente ha il diritto di concedere, e di fatto concede, i diritti di uso del proprio contributo. Per altre informazioni, vedere i contratti di licenza di collaborazione (CLA, Contributor License Agreement).
Il repository GitHub include tre cartelle principali che contengono i connettori:
custom-connectors
independent-publisher-connectors
certified-connectors
La cartella custom-connectors contiene esempi di connettori con funzionalità complete che si possono distribuire in Microsoft Power Platform a scopo di estensione e uso. Questi esempi non sono connettori certificati, ma sono creati e gestiti dalla community open source per offrire scenari utili o esempi di concetti relativi ai connettori. Tali connettori non sono distribuiti in Power Apps, Power Automate e App per la logica per impostazione predefinita e per questo motivo la cartella è diversa dalle altre due.
La cartella independent-publisher-connectors contiene i connettori inviati da editori che non sono proprietari del servizio sottostante al connettore. Questi connettori sono distribuiti e disponibili all'interno di Microsoft Power Platform come connettori Premium. Chiunque può inviare un nuovo connettore in questa cartella, aggiungere funzionalità ai connettori in questa cartella e risolvere problemi relativi ai connettori in questa cartella. La cartella è gestita dalla community per i connettori di editori indipendenti, che include editori indipendenti e coordinatori di progetto. Il team di certificazione connettori Microsoft gestisce il ramo master, per assicurarsi che la versione del connettore sia identica a quella distribuita in Microsoft Power Platform. I responsabili della manutenzione e il team di certificazione dei connettori Microsoft gestiscono il ramo dev per consentire lo sviluppo nella community del connettore prima della certificazione e della distribuzione di una versione.
La cartella certified-connectors contiene connettori certificati già distribuiti e disponibili per l'uso in modo preconfigurato in Microsoft Power Platform. Il programma di certificazione dei connettori Microsoft richiede che i nuovi connettori certificati debbano essere open source per ricevere i contributi della community. Il team di certificazione dei connettori Microsoft gestisce la cartella certified-connectors per garantire che, all'interno del ramo master, la versione del connettore sia identica a quella distribuita in Microsoft Power Platform. Il proprietario del connettore e il team di certificazione dei connettori Microsoft gestiscono il ramo dev per consentire lo sviluppo nella community del connettore prima della certificazione e della distribuzione di una versione.
Per contribuire al repository GitHub, si inizia prendendo la propria copia (o creando una copia tramite fork) del repository. I passaggi sono spiegati nella documentazione sulla creazione di fork. Dopo aver creato una copia tramite fork, si può preparare il connettore per il contributo usando una richiesta pull. Le risorse del connettore si possono scaricare usando l'interfaccia della riga di comando dei connettori Microsoft Power Platform.
Interfaccia della riga di comando dei connettori Microsoft Power Platform
Per usare le risorse del connettore, scaricare l'interfaccia della riga di comando dei connettori Microsoft Power Platform seguendo le istruzioni di installazione per l'interfaccia della riga di comando dei connettori Microsoft Power Platform.
Nota
L'altro nome dell'interfaccia della riga di comando dei connettori Microsoft Power Platform è paconn.
Accesso tramite l'interfaccia della riga di comando dei connettori Microsoft Power Platform
Prima di scaricare i file del connettore, è necessario aver effettuato l'accesso nell'interfaccia della riga di comando dei connettori Microsoft Power Platform. Per accedere, eseguire questo comando:
paconn login
Il comando richiede di accedere usando il processo di accesso con codice dispositivo. Seguire la richiesta per il processo di accesso.
Download tramite l'interfaccia della riga di comando dei connettori Microsoft Power Platform
Per preparare i file necessari per creare un connettore open source, usare il comando paconn download dall'interfaccia della riga di comando dei connettori Microsoft Power Platform.
Scaricare i file del connettore personalizzato con il seguente comando:
paconn download
Quando si esegue questo comando, viene chiesto di accedere al dispositivo per consentire a paconn di entrare automaticamente nell'ambiente Microsoft Power Platform. Dopo l'autenticazione, paconn fornisce un elenco di ambienti tra cui scegliere, seguito da un elenco di connettori.
Se si conoscono l'ID ambiente e l'ID connettore, è possibile usare la seguente sintassi della riga di comando per evitare che vengano richiesti:
paconn download -e [Microsoft Power Platform Environment GUID] -c [Connector ID]
Il download include quattro file:
apiDefintion.swagger.json: definizione OpenAPI per il connettore che include, ad esempio, tutti i trigger e le azioni.
apiProperties.json: definisce i modelli di criteri e altre proprietà estese del connettore che non fanno parte delle specifiche OpenAPI.
icon.png: una piccola icona che rappresenta il servizio nella finestra di progettazione quando si usa il connettore.
settings.json: questo file viene usato al posto dell'inserimento dei parametri in
paconn.
Se si rende open source il connettore personalizzato e lo si certifica, la visibilità dell'API aumenta. Contribuendo alla definizione del connettore nel repository open source si rende disponibile il connettore personalizzato anche agli altri utenti. Quando qualcuno usa un connettore certificato, usa una definizione aggiornata automaticamente quando si pubblicano aggiornamenti. Quando si usa la definizione del connettore open source, gli utenti devono applicare gli aggiornamenti alla propria copia. Il resto del modulo spiega come certificare il connettore personalizzato e come gestirne il ciclo di vita durante lo sviluppo.