Processo di certificazione dell'editore indipendente

Questo processo è 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 dei connettori di editori indipendenti in App per la logica di Azure, Power Automate e Power Apps. Prima di seguire i passaggi in questo articolo, leggi Certificazione del connettore.

Dopo aver identificato un connettore personalizzato da creare nel programma Independent Publisher, attieniti alla procedura in Preparare e inviare il connettore per la certificazione. Questo processo lo prepara per la certificazione e genera i file del connettore da inviare a Microsoft. Il processo di invio avviene attraverso il repository GitHub per connettori di editori indipendenti.

Leggere il manifesto

Il gruppo Connettori editori indipendenti consente a chiunque di pubblicare un connettore nell'elenco ufficiale dei connettori Microsoft. Questo gruppo richiede che i partecipanti siano a conoscenza del contenuto del relativo manifesto e che lo accettino.

Se prevedi anche di contribuire a questo progetto o di farne parte, devi leggere e comprendere questo documento.

Preparare e inviare il connettore per la certificazione

Il processo di certificazione del connettore come editore indipendente è semplice. Prima di inviarlo al repository GitHub, assicurati di eseguire i passaggi in questa sezione.

Quando invii un connettore di editore indipendente, vieni visualizzato nel nostro prodotto come editore ufficiale e un'icona generica viene applicata al connettore.

  1. Prima di iniziare a creare un connettore, condividi la tua proposta di connettore con Microsoft: verifica che il connettore non sia già stato creato. Per farlo, cerca il connettore nella documentazione Power Platform e nelle richieste pull del repository GitHub. La tabella seguente fornisce le opzioni disponibili con in tuo connettore in base allo stato dello stesso.

    Se il connettore proposto Opzione
    Esiste già in Power Platform. Non puoi creare il connettore.
    Esiste già come connettore di editore indipendente È possibile aggiungere più funzionalità al connettore
    Attualmente è una richiesta pull e una proposta. Puoi contattare l'editore indipendente 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.
  2. Dopo aver verificato che il connettore non è sulla piattaforma, condividi la tua proposta di connettore sul repository GitHub: in questo modo eviti ai tuoi colleghi di sprecare tempo nell'elaborare una proposta che esiste già. Potrebbe anche creare un'opportunità per trovare altri con cui collaborare mentre crei il tuo connettore.

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

    • Intitola la richiesta pull "Proposta - <Connector Name> (Independent Publisher)". Ad esempio: Proposal - HubSpotCRM (Independent Publisher).

    • Esegui il commit di un file intro.md con tutti i dettagli che puoi 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 10.

  3. Crea il connettore e/o il plugin:

  4. Crea un titolo per il tuo connettore che soddisfi i requisiti Microsoft: per istruzioni ed esempi, vedi Assegnare un titolo al connettore.

  5. Scrivi una descrizione per il connettore: per istruzioni, vedi Scrivere una descrizione per il connettore.

  6. Definisci riepiloghi e descrizioni: per istruzioni, vedi Definire riepiloghi e descrizioni di operazioni e parametri.

  7. Definisci risposte esatte per le operazioni: per istruzioni, vedi Definire risposte esatte per le operazioni.

  8. Aggiungi metadati che descrivono il connettore e/o il plug-in e il relativo servizio finale: per istruzioni, vedi Aggiungere metadati.

  9. Preparare gli artefatti del connettore: per istruzioni, vedi Preparare il connettore e/o gli artefatti.

  10. Invia il connettore per la distribuzione:

    1. Esegui le operazioni seguenti:

      1. Invia gli artefatti del connettore alla richiesta pull creata nel passaggio 2.
      2. Compilare l'elenco di controllo nel modello di richiesta pull.
      3. Rimuovi "Proposta -" dal titolo della richiesta pull.
    2. Un tecnico di certificazione Microsoft fornisce feedback entro una o due settimane dalla richiesta iniziale. Se il feedback richiede un aggiornamento al connettore, è necessario inviare un aggiornamento alla richiesta pull. Prevedi da una a due settimane anche per questa fase. Se hai bisogno di risolvere gli errori relativi allo swagger, vedi Correggere gli errori di convalida Swagger.

      Durante questo periodo rimani proprietario del connettore e puoi accettare o rifiutare le eventuali modifiche proposte.

    3. Microsoft approva e unisce la richiesta pull.

  11. Il connettore viene inviato per la certificazione: durante la certificazione, prevedi di ricevere notizie dal tuo contatto Microsoft nel giro di 1-2 settimane.

  12. Attendi la distribuzione: dopo che il connettore è stato convalidato e preparato per la distribuzione della produzione, lo distribuiremo in tutte le aree di produzione.

    Importante

    In media, la distribuzione del connettore richiede 15 giorni lavorativi. Ciò è necessario indipendentemente dalle dimensioni o dalla complessità del connettore, che si tratti di un nuovo connettore o di un aggiornamento. Per proteggere l'integrità, il connettore viene sottoposto alle stesse attività di convalida per testare funzionalità e contenuto che vengono seguiti in ogni distribuzione.

    • Pianificazione 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: ti inviamo 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. In caso di ritardo o interruzione della distribuzione, riceverai una notifica via e-mail. Per ulteriori informazioni, vedi Distribuzione nelle aree.

    Una volta completata la certificazione del connettore, forniremo un'opportunità di marketing per il connettore pubblicizzandolo nel blog di Power Automate.

  13. Aggiorna il connettore in qualsia momento: una volta effettuata la certificazione e pubblicato il connettore, puoi aggiungere in qualsiasi momento nuove operazioni e funzionalità al connettore nel repository GitHub. Forniremo una nuova certificazione per il tuo connettore come necessario.

Procedure consigliate per l'invio

  • Puoi inviare un solo connettore per richiesta pull. Ciò garantisce una corretta esecuzione del nostro processo di convalida.

  • La richiesta pull per il tuo connettore deve seguire lo schema Connector Name (Independent Publisher).

  • Aggiungi un messaggio e-mail alla sezione E-mail supporto nel caso in cui abbiamo bisogno di contattarti.

  • Assicurati di compilare il parametro Informativa sulla privacy con l'informativa sulla privacy del servizio finale.

  • Assicurati che le descrizioni delle operazioni siano dettagliate. Ciò garantisce che l'utente possa comprendere l'operazione.

  • Se il tuo connettore utilizza OAuth, assicurati di fornire passaggi dettagliati su come creare un'app nel file readme.md. In caso contrario, si verificheranno ritardi nella certificazione. Per un esempio di documentazione da includere, vedi Esempio di gile Leggimi.md.

  • Assicurati di aggiungere schemi di risposta alle tue azioni, a meno che lo schema di risposta non sia dinamico. Ciò garantisce un maggiore utilizzo del connettore.

  • 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.

  • Microsoft esaminerà i problemi relativi alla piattaforma e alla sicurezza man mano che si presentano e deprecherà i connettori di editori indipendenti non funzionanti.

Sai che puoi estendere il tuo connettore come plugin?

I connettori Power Platform possono essere estesi come plugin in Microsoft Copilot Studio e possono essere pubblicati per i tenant. Per ulteriori informazioni sull'estensione dei connettori come plug-in, vedi Creare plug-in IA per Microsoft Copilot. Presto estenderemo il supporto per editori indipendenti per certificare e pubblicare i plugin in Copilot per M365.

Passaggio successivo

Testare il connettore durante la certificazione.