Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Questo articolo illustra come aggiornare i connettori certificati per Microsoft Copilot Studio, Microsoft Power Automate, Microsoft Power Apps e Azure Logic Apps. Assicurarsi di disporre di un connettore certificato rilasciato con Microsoft prima di seguire questa procedura.
Importante
Se il connettore usa OAuth, è importante monitorare e rinnovare regolarmente l'ID client e le credenziali dei segreti client in scadenza in modo che i clienti possano continuare a usare il connettore. Assicurarsi di inviare l'aggiornamento del connettore un mese prima della data di scadenza dell'ID client e del segreto client.
Per aggiornare il connettore certificato, inviare un nuovo set di artefatti del connettore per la certificazione. Seguire le stesse istruzioni usate per la prima volta per la certificazione del connettore.
- Se sei un editore verificato, vai a Processo di certificazione dell'editore verificato per le istruzioni.
- Se sei un editore indipendente, vai a Processo di certificazione dell'editore indipendente per le istruzioni.
Inoltre, assicurati che la tua nuova versione del connettore sia ancora conforme alle nostre linee guida e requisiti.
Microsoft esamina gli aggiornamenti e distribuisce la versione aggiornata del connettore. Questo articolo descrive i criteri per gli aggiornamenti.
Inviare un aggiornamento
Importante
Rendi open source il connettore prima che Microsoft lo aggiunga al portale di certificazione per ridurre le incoerenze. Vedere Processo di certificazione dell'editore verificato.
Assicurarsi di soddisfare i requisiti di invio prima di inviare l'aggiornamento. In caso contrario, il processo di aggiornamento può essere ritardato.
(Per gli editori verificati) Quando i nuovi artefatti del connettore sono pronti, passare al Partner Center.
È necessario aver già inviato elementi al Centro per i partner in Microsoft 365 e Copilot Program. Riaprire la stessa offerta e aggiornare la scheda pertinente in Panoramica del prodotto.
È necessario aver inviato in precedenza elementi al Centro per i partner in Microsoft 365 e Copilot Program. Riapri la stessa offerta e aggiorna la scheda pertinente in Panoramica del prodotto per la tua offerta.
Non creare una nuova offerta per aggiornare il connettore certificato esistente.
Dopo aver inviato gli artefatti, Microsoft certifica la nuova versione e la invia di nuovo per il test. Testare il connettore come è stato fatto per la prima versione.
Per altre informazioni, vedere Testare il connettore per la certificazione. Verifica il messaggio di go-live nel Partner Center, e Microsoft distribuisce il tuo connettore.
Importante
La distribuzione richiede 15 giorni, indipendentemente dalle dimensioni o dalla complessità del connettore, sia che si tratti di uno nuovo o di un aggiornamento. Per proteggere l'integrità, Microsoft esegue le stesse attività di convalida per testare funzionalità e contenuto per ogni distribuzione.
Altre informazioni in pianificazione di produzione.
Informare i clienti delle modifiche che causano un'interruzione
Se la nuova versione del connettore modifica la funzionalità delle operazioni, ad esempio la modifica di un percorso operativo, l'aggiornamento introduce modifiche di rilievo. Il connettore necessita di una gestione speciale ed è necessario informare i clienti.
Molti scenari di aggiornamento possono introdurre modifiche di rilievo. Di seguito sono riportati esempi comuni.
| Nome | Description |
|---|---|
| MetodoAutenticazioneRimosso | Non rimuovere i metodi di autenticazione esistenti. La modifica del tipo di autenticazione del connettore in un aggiornamento non è consentita. |
| ConnectionParametersRemoved | Non rimuovere i parametri di connessione al campo. Questa modifica può interrompere i flussi esistenti perché le connessioni usano ancora questo campo. |
| CampoDiInputEliminato | Il campo di input viene eliminato. |
| InputFieldVisibilityChangedToInternal | La visibilità del campo di input viene modificata in interno. Questa modifica può causare la sostituzione dei valori esistenti con il valore predefinito o la rimozione dei valori esistenti per i flussi esistenti dopo l'aggiornamento. |
| OperationDeleted | L'operazione viene eliminata. Questa modifica può interrompere i flussi esistenti. |
| OperationHidden | L'operazione è nascosta. Questa modifica può interrompere la finestra di progettazione per i flussi esistenti. |
| OutputFieldAddedWhenRestricted | Il campo di output viene aggiunto quando non sono consentite proprietà aggiuntive. Questa modifica può interrompere la convalida per i flussi esistenti. |
| OutputFieldChangedToOptionalFromRequired | Il campo di output viene modificato da obbligatorio a facoltativo. Questa modifica può interrompere i flussi esistenti che si basano su questo campo, in base alle esigenze. |
| CampoDiOutputEliminato | Il campo di output viene eliminato. Questa modifica può interrompere i flussi esistenti se usano questo campo e il payload effettivo viene modificato. |
| OutputFieldTypeChanged | Il tipo viene modificato per il campo di output. Questa modifica può interrompere i flussi esistenti se usano questo campo e il payload effettivo viene modificato. |
| OutputFieldTypeFormatChanged | Il formato del tipo viene modificato per il campo di output. Questa modifica può interrompere i flussi esistenti se usano questo campo e il payload effettivo viene modificato. |
| OutputSchemaRemoved | La definizione dello schema di output viene rimossa. Questa modifica può interrompere i flussi esistenti che usano questo output e il payload effettivo viene modificato. |
| ParameterVisibilityChangedToInternal | La visibilità è stata modificata in interna per il parametro. Questa modifica può causare la sostituzione dei valori esistenti con il valore predefinito o la rimozione dei valori esistenti per i flussi esistenti dopo l'aggiornamento. |
| ResponseHeaderRemoved | L'intestazione della risposta viene rimossa. Questa modifica può interrompere tutti i flussi esistenti che usano questa intestazione e il payload effettivo viene modificato. |
| ResponseHeaderTypeChanged | Il tipo di intestazione della risposta viene modificato. Questa modifica può interrompere tutti i flussi esistenti che usano questa intestazione e il payload effettivo viene modificato. |
| ResponseHeaderTypeFormatChanged | Il formato del tipo di intestazione della risposta viene modificato. Questa modifica può interrompere i flussi esistenti che usano quest'intestazione e il payload effettivo è stato cambiato. |
| TierChangedToPremium | Il livello connettore viene modificato in Premium. Questa modifica significa che i clienti con piani gratuiti non possono più usare il connettore. |
Assicurati di dettagliare tutti gli aggiornamenti del connettore e le eventuali modifiche di rilievo nel file di intro.md nel pacchetto di certificazione. La documentazione pubblica generata dal file di intro.md consente di informare i clienti di eventuali modifiche di rilievo. Per altre informazioni, vedere Creare un elemento intro.md.
Come procedura consigliata, seguire il controllo delle versioni operative per gestire le modifiche di rilievo. In questo modo, i flussi di lavoro esistenti continuano a funzionare e introducono nuove versioni delle operazioni in base alle esigenze. Alcune modifiche di rilievo non richiedono il controllo delle versioni operative. Contatta Microsoft per discutere di questi casi.