Aggiornare il connettore certificato

Nota

Questo argomento contiene informazioni sulla certificazione di connettori personalizzati in App per la logica di Azure, Power Automate e Power Apps. Assicurati di avere un certificatore certificato e rilasciato da Microsoft prima di seguire la procedura di seguito.

Per aggiornare il connettore certificato, dovrai inviare un nuovo set di artefatti del connettore per la certificazione. Segui le stesse istruzioni che hai usato durante la prima certificazione del connettore.

Inoltre, assicurati che la tua nuova versione del connettore sia ancora conforme alle nostre linee guida e requisiti.

Il tempo necessario per completare il processo di aggiornamento della certificazione per il connettore dipende se gli aggiornamenti sono principali o secondari. Un aggiornamento principale richiederà circa 6-10 settimane per la distribuzione. Un aggiornamento secondario richiederà solo 4-5 settimane. Gli ingegneri Microsoft valuteranno i tuoi aggiornamenti e prenderanno la decisione finale. Questo articolo descrive i criteri per gli aggiornamenti secondari. Se il tuo connettore non soddisfa nessuno dei criteri, verrà considerato un aggiornamento principale.

Inviare un aggiornamento

Importante

È necessario rendere open source il connettore prima che venga aggiunto al portale di certificazione per ridurre le incoerenze.

Per istruzioni, consulta Inviare il connettore per la certificazione Microsoft.

  1. Assicurati di aver convalidato i file del connettore prima di procedere all'invio dell'aggiornamento. Il mancato rispetto di questo passaggio può comportare ritardi nel processo di aggiornamento

  2. Per gli editori verificati esclusi gli editori indipendenti: dopo aver preparato i nuovi artefatti del connettore per l'invio, tornare alla scheda Certificazione connettore in Studio ISV.

    Se sono già stati inviati artefatti al portale di Certificazione del connettore, l'esperienza è ora disponibile in ISV Studio.

  3. Non creare un nuovo invio per l'aggiornamento di un connettore certificato esistente.

    Seleziona l'invio esistente dall'elenco, quindi scegli Invia nuova versione. Viene visualizzata l'area di invio degli artefatti del connettore, dove puoi caricare la nuova versione degli artefatti del connettore.

  4. Dopo aver inviato gli artefatti, il connettore viene distribuito e testato allo stesso modo della prima versione. Per maggiori informazioni, vai a Provare il connettore durante la certificazione.

    Importante

    Sono necessari quindici giorni per la distribuzione 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 sarà sottoposto alle stesse attività di convalida per testare funzionalità e contenuto che vengono seguiti in ogni distribuzione.

    Per ulteriori informazioni, consulta la programmazione di produzione.

  5. Assicurati che il tuo ambiente di test in Anteprima sia ancora accessibile. Se il tuo ambiente era di tipo Versione di prova, potrebbe essere scaduto, nel qual caso dovrai creare un nuovo ambiente.

Informare il cliente delle modifiche sostanziali

Se la nuova versione del connettore modifica la funzionalità delle operazioni all'interno del connettore (ad es. modifica di un percorso operativo), l'aggiornamento introdurrà modifiche che causano un'interruzione. Il connettore avrà bisogno di una gestione speciale.

Dovrai fornire ai clienti le modifiche che causano un'interruzione che utilizzerai nel nuovo aggiornamento. In tal modo, i clienti che utilizzano la versione del connettore attualmente pubblicata riceveranno gli aggiornamenti per la nuova versione aggiornata.

In genere, suggeriamo il controllo delle versioni operative come soluzione per le modifiche che causano un'interruzione. In questo modo i flussi di lavoro esistenti continueranno a funzionare e sarà possibile introdurre nuove versioni delle operazioni secondo necessità. Esistono alcuni casi di modifiche che causano un'interruzione che potrebbero non richiedere il controllo delle versioni operative. Contatta Microsoft per discutere di questi casi.

Nota

Non è consentito cambiare il tipo di autenticazione del connettore in un aggiornamento.

Contatta Microsoft per esporre i tuoi dubbi o se si verificano errori imprevisti durante l'invio di un aggiornamento.

Criteri di un aggiornamento secondario

Microsoft potrebbe considerare la richiesta del connettore un aggiornamento secondario. Ciò lo qualificherebbe per un tempo di completamento accelerato di 4-5 settimane per il processo di certificazione. Verrà preso in considerazione un aggiornamento secondario solo per i connettori certificati esistenti. Non si applica alle nuove richieste di certificazione del connettore.

Le modifiche a uno o più dei seguenti elementi qualificheranno il tuo connettore come un aggiornamento secondario.

Artefatto Campo Definizione
ApiDefinition.swagger.json Informazioni sul connettore
  • Descrizione
  • Contatto
  • ApiDefinition.swagger.json Azioni
  • Descrizione
  • Riepilogo
  • ApiDefinition.swagger.json Risposte
  • Descrizione
  • Descrizione del messaggio
  • ApiProperties.json
  • Descrizione
  • Descrizione comando
  • iconBrandColor
  • Server di pubblicazione
  • StackOwner
  • File Readme Il contenuto cambia
    Icona Sostituzione

    Inviare commenti

    L'invio da parte degli utenti di feedback sui problemi riscontrati con la piattaforma di connettori o di idee su nuove funzionalità è molto apprezzato. Per fornire un feedback, vai a Inviare problemi o ottenere assistenza per i connettori e seleziona il tipo di commenti.