Aktualizace vašeho certifikovaného konektoru

Tento článek vysvětluje, jak aktualizovat certifikované konektory pro Microsoft Copilot Studio, Microsoft Power Automate, Microsoft Power Apps a Azure Logic Apps. Než budete postupovat podle těchto kroků, ujistěte se, že máte certifikovaný konektor vydaný s Microsoftem.

Důležité

Pokud váš konektor používá OAuth, je důležité pravidelně monitorovat a obnovovat ID klienta a tajné přihlašovací údaje klienta, aby zákazníci mohli váš konektor dál používat. Nezapomeňte odeslat aktualizaci konektoru jeden měsíc před datem, kdy id klienta a tajný klíč klienta vyprší.

Pokud chcete certifikovaný konektor aktualizovat, odešlete k certifikaci novou sadu artefaktů konektoru. Postupujte podle stejných pokynů, které jste použili při prvním certifikaci konektoru.

Zajistěte také, aby vaše nová verze konektoru stále dodržovala naše pokyny a požadavky.

Microsoft zkontroluje aktualizace a nasadí aktualizovanou verzi konektoru. Tento článek popisuje kritéria pro aktualizace.

Odeslání aktualizace

Důležité

Opensourcový konektor předtím, než ho Microsoft přidá na certifikační portál, pro snížení nekonzistencí. Viz Proces certifikace ověřeného vydavatele.

  1. Před odesláním aktualizace se ujistěte, že splňujete požadavky na odeslání . Pokud ne, proces aktualizace se může zpozdit.

  2. (Pro ověřené vydavatele) Až budou nové artefakty konektoru připravené, přejděte do Partnerského centra.

    V Microsoft 365 a programu Copilot už musíte odeslat artefakty do Partnerského centra. Znovu otevřete stejnou nabídku a aktualizujte příslušnou kartu v přehledu produktu.

    V Microsoft 365 a programu Copilot musíte mít dříve odeslané artefakty do Partnerského centra. Znovu otevřete stejnou nabídku a aktualizujte příslušnou kartu Přehled produktu své nabídky.

  3. Nevytvádejte novou nabídku pro aktualizaci stávajícího certifikovaného konektoru.

  4. Po odeslání artefaktů Microsoft novou verzi certifikuje a pošle vám ho zpět k testování. Otestujte konektor stejně jako u první verze.

    Další informace najdete v tématu Testování konektoru v certifikaci. Potvrďte příspěvek spuštění v Partnerském centru a Microsoft váš konektor nasadí.

    Důležité

    Nasazení trvá 15 dnů bez ohledu na velikost nebo složitost konektoru, ať už je to nová nebo aktualizace. Kvůli ochraně integrity spouští Microsoft stejné úlohy ověřování, které testuje funkce a obsah pro každé nasazení.

    Více se dozvíte v plán produkce.

Upozorněte zákazníky na zásadní změny

Pokud nová verze konektoru změní funkčnost operací – například změnu cesty operace – aktualizace zavádí zásadní změny. Konektor potřebuje speciální zpracování a potřebujete informovat zákazníky.

Řada scénářů aktualizací může představovat zásadní změny. Tady jsou běžné příklady.

Název Description
MetodaOvěřeníOdebrána Neodebírejte existující metody ověřování. Změna typu ověřování konektoru v aktualizaci není povolená.
OdstraněnyParametryPřipojení Neodebírejte parametry připojení k poli. Tato změna může rozbít stávající toky, protože jejich připojení stále používají toto pole.
OdstraněnéPoleVstupu Vstupní pole se odstraní.
ZměnaViditelnostiVstupníhoPoleNaInterní Viditelnost vstupního pole se změní na interní. Tato změna může způsobit, že výchozí hodnota nahradí existující hodnoty nebo existující hodnoty se po aktualizaci odeberou pro existující toky.
OperaceSmazána Operace byla odstraněna. Tato změna může narušit stávající toky.
OperationHidden Operace je skrytá. Tato změna může rozbít designer pro existující toky.
OutputFieldAddedWhenRestricted Výstupní pole se přidá, pokud nejsou povoleny další vlastnosti. Tato změna může přerušit ověřování stávajících toků.
OutputFieldChangedToOptionalFromRequired Výstupní pole se změní z povinné na volitelné. Tato změna může narušit stávající toky, které podle potřeby spoléhají na toto pole.
OutputFieldDeleted Výstupní pole se odstraní. Tato změna může rozbít stávající procesy, pokud toto pole používají a změní se aktuální datová část.
OutputFieldTypeChanged Pro výstupní pole se změní typ. Tato změna může rozbít stávající procesy, pokud toto pole používají a změní se aktuální datová část.
OutputFieldTypeFormatChanged Formát typu se změní pro výstupní pole. Tato změna může rozbít stávající procesy, pokud toto pole používají a změní se aktuální datová část.
OutputSchemaRemoved Definice výstupního schématu je odebrána. Tato změna může narušit stávající toky, které tento výstup používají, a skutečná náplň se již změnila.
ParametrViditelnostZměněnaNaInterní Viditelnost se změní na interní pro parametr. Tato změna může způsobit, že výchozí hodnota nahradí existující hodnoty nebo existující hodnoty se po aktualizaci odeberou pro existující toky.
ResponseHeaderRemoved Záhlaví odpovědi se odebere. Tato změna může rozbít všechny existující toky, které používají tuto hlavičku, protože konkrétní datová část se změní.
TypZáhlavíOdpovědiZměněn Typ hlavičky odpovědi se změní. Tato změna může rozbít existující toky, které používají tuto hlavičku, protože konkrétní datová část se změní.
ResponseHeaderTypeFormatChanged Formát typu hlavičky odpovědi se změní. Tato změna může rozbít existující toky, které používají tuto hlavičku, protože konkrétní datová část se změnila.
Úroveň změněna na Premium Úroveň konektoru se změní na Premium. Tato změna znamená, že zákazníci s plány Free už nemůžou konektor používat.

Ujistěte se, že podrobně popíšete všechny aktualizace konektoru a veškeré nekompatibilní změny v souboru intro.md ve vašem certifikačním balíčku. Veřejná dokumentace generovaná ze souboru intro.md vám pomůže informovat zákazníky o zásadních změnách. Další informace najdete v článku Vytvoření artefaktu intro.md.

Osvědčeným postupem je používání provozního verzování k řešení nekompatibilních změn. Stávající pracovní postupy tak budou fungovat a podle potřeby zavádějí nové verze operací. Některé zásadní změny nevyžadují provozní verzování. Spojte se s kontaktem společnosti Microsoft a diskutujte o těchto případech.