Condividi tramite

Preparare e inviare il connettore per la certificazione

Il processo di certificazione dei connettori descritto in questo articolo è per gli editori indipendenti. Se possiedi il servizio sottostante al tuo connettore, vai a Processo di certificazione dell'editore verificato.

Nota

Questo articolo fornisce informazioni per la certificazione di connettori personalizzati in App per la logica di Azure, Microsoft Power Automate, Microsoft Power Apps e usandoli in Microsoft Copilot Studio. Prima di seguire i passaggi in questo articolo, leggi Certificazione del connettore.

Quando Microsoft certifica il connettore per il programma Editore Indipendente e pubblica il connettore, il nome dell'utente viene visualizzato nel prodotto come editore ufficiale e sul connettore viene visualizzata un'icona generica. La preparazione e l'invio del connettore per la certificazione sono facili. Prima di inviare i file dei connettori a Microsoft, rivedi e completa tutti i passaggi descritti in questo articolo.

Prerequisiti

Il gruppo Connettori editori indipendenti consente a chiunque di pubblicare un connettore nell'elenco ufficiale dei connettori Microsoft. Se vuoi contribuire al gruppo, esamina le risorse del gruppo e intraprendi le azioni necessarie:

Passaggio 1: verifica che il connettore non sia già creato

Prima di iniziare a creare un connettore, verifica che non sia già stato creato. Per verificare, puoi cercare il connettore in queste posizioni:

Usa questa tabella per vedere cosa puoi fare con il tuo connettore in base al suo stato:

Se il connettore proposto: Opzione:
Esiste già per Copilot Studio e Power Platform. Non puoi creare il connettore.
Esiste già come connettore independent publisher. È possibile aggiungere più funzionalità al connettore.
Attualmente è una richiesta pull e una proposta. Puoi contattare l'independent publisher per collaborare sul connettore.
È una richiesta pull e non è una proposta. Attendere fino a che il connettore non è certificato e distribuito. Aggiungi quindi un aggiornamento a quel connettore.

Passaggio 2: condividi la proposta di connettore con Microsoft

Dopo aver verificato che il connettore non sia presente nella piattaforma, condividi la proposta di connettore nel repository GitHub dell'Independent Publisher Connector Group. Condividere la tua proposta aiuta a evitare sforzi duplicati e può aiutarti a trovare collaboratori.

Per condividere la tua proposta, invia una richiesta pull nel repository GitHub con i seguenti criteri:

  • Intitola la richiesta pull Proposta - Nome connettore (Editore indipendente). Ad esempio: Proposal - HubSpotCRM (Independent Publisher).
  • Eseguire il commit di un file intro.md con tutti i dettagli che è possibile fornire. Se sei disponibile a trovare un collaboratore, includi la tua e-mail di contatto.

Nota

Utilizza la stessa richiesta pull quando sei pronto per inviare tutti i file per la certificazione nel passaggio 4.

Passaggio 3: creare il connettore

Crea il connettore. per iniziare, vedi Creare un connettore personalizzato da zero. Prima di inviare il connettore per la convalida e la distribuzione da parte dell'editore indipendente, segui le procedure consigliate per la preparazione dei connettori:

Esamina tutti i passaggi nell'articolo Preparare i file del connettore per la certificazione.

Passaggio 4: Inviare gli artefatti del connettore

Quando sei pronto per inviare gli artefatti del connettore per la convalida, la certificazione e la distribuzione di Microsoft, assicurati di:

  • Invia gli artefatti del connettore alla richiesta pull creata nel passaggio 2.
  • Compilare l'elenco di controllo nel modello di richiesta pull.
  • Rimuovi Proposal - dal titolo della richiesta pull.

Passaggio 5: seguire il processo di convalida e certificazione dei connettori

Dopo aver inviato il connettore per la convalida, puoi aspettarti di ricevere un messaggio dal tuo tecnico di certificazione Microsoft entro 1-2 settimane.

  • Se il feedback richiede un aggiornamento del connettore, dovrai aggiornare direttamente la tua richiesta pull. Attendi 1 - 2 settimane. Potrebbe essere necessario correggere gli errori di convalida Swagger.
  • Durante questo processo, si manterrà la proprietà del connettore e si avrà la possibilità di accettare o rifiutare le eventuali modifiche proposte.
  • Dopo che Microsoft approva e unisce la richiesta pull, il connettore viene sottoposto alla certificazione. Durante il processo di certificazione, aspettati di ricevere notizie dal tuo contatto Microsoft entro 1-2 settimane.
  • Poiché il tuo connettore sta completando la certificazione, verrai anche coinvolto in un'opportunità di marketing per il connettore sul blog di Power Automate.

Passaggio 6: attendere la distribuzione del connettore

Al termine del processo di convalida e certificazione, Microsoft prepara e distribuisce i file del connettore certificato in un'area di anteprima. L'area di anteprima consente di testare il connettore dopo la certificazione per la distribuzione e di confermare il passaggio allo stato live a Microsoft. L'ambiente di test di anteprima è disponibile solo per due giorni.

Importante

In media, la distribuzione del connettore richiede 15 giorni lavorativi. Questo tempo è necessario indipendentemente dalle dimensioni o dalla complessità del connettore, che si tratti di un nuovo connettore o di un aggiornamento. Per proteggere l'integrità, tutti i connettori sono sottoposti alle stesse attività di convalida per testare funzionalità e contenuto che vengono seguiti in ogni distribuzione.

  • Pianificazioni di distribuzione: le nostre pianificazioni di distribuzione del connettore per la produzione iniziano venerdì mattina, PST/PDT. Quando sei pronto per la distribuzione della produzione, avvisa il tuo contatto Microsoft con almeno 24 ore di anticipo per consentirci di includere il connettore nella distribuzione pianificata successiva.

  • Distribuzione nelle aree: Microsoft invierà una notifica via e-mail con i nomi delle aree in cui verrà distribuito il connettore, poiché la distribuzione nelle aree viene eseguita in passaggi. Se si verifica un ritardo o un blocco della distribuzione, si riceve una notifica tramite e-mail. Per ulteriori informazioni, vedi Distribuzione nelle aree.

Seguire le procedure consigliate per l'invio

Seguire le procedure consigliate per un invio corretto del connettore:

  • Invia un solo connettore per richiesta pull per garantire che il processo di convalida venga eseguito senza problemi.
  • Segui lo schema Connector Name (Independent Publisher) nella richiesta pull del connettore.
  • Aggiungere un messaggio e-mail alla sezione E-mail supporto. nel caso in cui abbiamo bisogno di contattarti.
  • Compila il parametro Informativa sulla privacy con l'informativa sulla privacy del servizio finale.
  • Scrivi descrizioni dettagliate delle operazioni in modo che gli utenti possano comprenderle.
  • Se il tuo connettore utilizza OAuth, assicurati di fornire passaggi dettagliati su come creare un'app nel file readme.md. In caso contrario, la certificazione viene ritardata. Per un esempio di documentazione da includere, vedi Esempio di gile Leggimi.md.
  • Aggiungi schemi di risposta alle tue azioni, a meno che lo schema di risposta non sia dinamico. In questo modo, il connettore viene utilizzato di più.
  • Esamina l'elenco di controllo prima dell'invio.

Garanzie Microsoft

Microsoft si impegna a soddisfare le seguenti garanzie:

  • In caso di aggiornamento del connettore, eseguiremo nuovamente lo strumento per le modifiche sostanziali e tutti gli altri strumenti di convalida.
  • Se non ci sono aggiornamenti per un connettore, garantiamo che funzioni a meno che non ci sia una modifica o un aggiornamento dell'API o un problema con la piattaforma.
  • Se ci sono problemi relativi alla piattaforma e alla sicurezza, Microsoft li esaminerà man mano che si presentano e deprecherà i connettori di editori indipendenti non funzionanti.

Passaggio successivo

Spostare il connettore dall'anteprima alla disponibilità generale