Použití vlastního konektoru z pracovního postupu aplikace logiky

Poznámka:

Tento článek je součástí série kurzů o vytváření a používání vlastních konektorů v Azure Logic Apps, Microsoft Power Automate a Microsoft Power Apps a volání konektorů jako nástrojů v nástroji Microsoft Copilot Studio. Přečtěte si přehled vlastních konektorů, abyste porozuměli procesu.

V tomto článku vytvoříte ukázkový pracovní postup aplikace logiky Consumption, který ukazuje, jak používat vlastní konektor, který jste vytvořili v předchozím kurzu. Tento ukázkový pracovní postup se aktivuje, když je položka přidána do seznamu SharePoint Online. Pracovní postup potom pomocí vlastního konektoru zavolá rozhraní API pro textovou analýzu Cognitive Services. Konektor vrací skóre mínění (0 až 1) pro text v položce seznamu a pracovní tok zapíše skóre zpět do seznamu.

Dokončený pracovní postup aplikace logiky vypadá jako na následujícím příkladu:

Předpoklady

• Předplatné Office 365 Business Premium nebo se zaregistrujte k odběru bezplatné zkušební verze.

• Účet a předplatné Azure.

• Základní zkušenosti s vytvářením aplikací logiky. Další informace zjistíte v části Sestavení prvního pracovního postupu aplikace logiky.

• Vlastní konektor, který jste vytvořili v jednom z těchto článku:

  • Vytvoření vlastního konektoru z definice OpenAPI
  • Vytvoření vlastního konektoru z kolekce Postman

• (Pokud váš vlastní konektor přistupuje k místní zdrojům prostřednictvím místní brány dat) Nastavte instalaci brány tak, aby umožňovala odchozí přístup odpovídajícím odchozím IP adresám předem připravených konektorů. Všechny logické aplikace ve stejné oblasti používají stejné rozsahy IP adres.

  Další informace najdete v tématech Úprava nastavení komunikace pro místní datovou bránu a Konfigurace nastavení proxy serveru pro místní datovou bránu.

Vytvoření seznamu SharePoint Online

Nejprve vytvořte třísloupcový seznam v SharePoint Online. V tomto seznamu jsou uložena data o kontrole filmů, která pracovní postup aplikace logiky analyzuje z hlediska mínění. Další informace o seznamech SharePoint Online najdete v článku Úvod do seznamů.

1. Na svém webu SharePoint Online vyberte Nový>Seznam k vytvoření nového seznamu.

2. Do pole Název zadejte Filmové recenze

3. Vyberte Vytvořit.

   Ve výchozím nastavení SharePoint Online vytvoří seznam se sloupcem Název.

4. Vyberte znaménko plus >Jeden řádek textu.

5. Zadejte název Recenze a vyberte Uložit.

6. K přidání dalšího s datovým typem Číslo jako datovým typem a Skóre jako názvem opakujte kroky 3 a 4.

Vytvoření zdroje aplikace logiky

Nyní, když máte seznam, vytvořte zdroj a pracovní postup aplikace logiky Spotřeba v portálu Azure Portal.

1. Přihlaste se k portálu Azure Portal pomocí přihlašovacích údajů ke svému účtu Azure.

2. Do vyhledávacího pole zadejte aplikace logiky a potom vyberte Aplikace logiky.

3. Vyberte plán Spotřeba.

4. Do prostředku aplikace logiky zadejte následující informace:

   Vlastnost	Hodnota	Description
   Předplatné	<Název předplatného Azure>	Název vašeho předplatného Azure.
   Skupina zdrojů	<název skupiny prostředků>	Název skupiny zdrojů Azure používaný k uspořádání souvisejících zdrojů. V tomto příkladu se používá My-First-LA-RG.
   Název aplikace Logic	<název aplikace logiky>	Název aplikace logiky. Tento příklad používá SentimentAnalysis.
   Oblast	<Region Azure>	Oblast Azure pro hostování vaší aplikace logiky. Poznámka: Váš zdroj aplikace logiky a vlastní konektor musí existovat ve stejné oblasti. Tento příklad používá Východ USA 2.
   Zapnutí analytiky protokolů	No	Nechte protokolování diagnostiky vypnuté.

5. Dokončete vytváření aplikace logiky.

6. Poté, co Azure nasadí aplikaci, vyberte Přejít k prostředku.

   Případně vyhledejte a vyberte aplikaci logiky zadáním názvu do vyhledávacího pole Azure.

Přidání triggeru

Jako první krok v pracovním postupu přidejte trigger SharePoint. Tento trigger se aktivuje, když je položka přidána do zadaného seznamu SharePoint Online.

1. V nabídce aplikace logiky v části Vývojové nástroje vyberte Logic Apps Designer, pokud ještě není vybraný.

2. V návrháři vyberte Přidat trigger.

3. Ve vyhledávacím poli podokna galerie konektorů zadejte SharePoint a vyberte aktivační událost SharePoint s názvem Při vytvoření položky. Pokud se aktivační událost v seznamu nezobrazuje, vyberte v pravém horním rohu seznamu aktivačních SharePoint událostí Zobrazit další.

   

4. Po otevření podokna Vytvořit připojení se přihlaste pomocí svých přihlašovacích údajů SharePoint.

5. Zadejte následující informace pro trigger SharePoint:

   Parametr	Hodnota
   Adresa webu	<Adresa sharepointového webu>
   Název seznamu:	Recenze filmu

6. Rozbalte část s názvem Jak často chcete kontrolovat položky, abyste dokončili nastavení triggeru:

   Parametr	Hodnota
   Interval	10
   Četnost	Second

   Až skončíte, trigger bude vypadat jako v následujícím příkladu:

   

Přidání akce z vlastního konektoru

Po triggeru můžete přidat jednu nebo více akcí, které chcete provést. Pokud chcete přidat akci z vlastního konektoru, postupujte takto:

1. Pod triggerem vyberte znaménko plus (+) a pak vyberte Přidat akci.

2. Do vyhledávacího pole podokna galerie konektorů zadejte název vlastního konektoru, což je v tomto příkladu SentimentDemo, a vyberte požadovanou akci.

   Tip

   Pro snadnější vyhledávání v části Runtime vyberte Vlastní.

   

   Název akce a popis akce pocházejí z informací, které jste zadali při vytvoření konektoru.

3. Zadejte název formuláře a klikněte na tlačítko API.

   Parametr	Hodnota
   Název připojení	Název připojením, například SentimentDemoConnection.
   Klíč rozhraní API	Klíč rozhraní API pro rozhraní API Analýza textu. Další informace naleznete v tématu Získání klíče rozhraní API.

4. Zadejte informace o akci, například:

   Parametr	Hodnota
   ID dokumentů	1 Tato hodnota je povinná, protože konektor dokáže zpracovat více dokumentů. Tento příklad odesílá jeden dokument po druhém. V produkční aplikaci logiky mohou hodnoty Jazyk dokumentů a ID dokumentů pocházet ze seznamu nebo jiného zdroje dat.
   Jazyk dokumentů	en
   Text dokumentů	Pole SharePoint Recenze. Chcete-li hodnotu zadat, postupujte takto: 1. Vyberte uvnitř pole Text dokumentů a výběrem ikony blesku otevřete seznam dynamického obsahu. 2. Ze seznamu v části triggeru SharePoint vyberte Recenze.

5. Přidejte do pracovního postupu akci SharePoint s názvem Aktualizovat položku a zadejte následující hodnoty:

   Parametr	Hodnota
   Adresa webu	< Adresa sharepointového webu>
   Název seznamu:	Recenze filmu
   Id	Pole SharePoint ID
   Titulek	Výstup triggeru SharePoint s názvem Název. Chcete-li hodnotu zadat, postupujte takto: 1. Vyberte uvnitř pole Název a výběrem ikony blesku otevřete seznam dynamického obsahu. 2. Ze seznamu v části triggeru SharePoint vyberte Název.

6. V podokně akcí Aktualizovat položku otevřete seznam Pokročilé parametry, vyberte požadované parametry, které se liší v závislosti na seznamu SharePoint Online a přidejte je do akce. Pro každý přidaný parametr otevřete seznam dynamického obsahu a vyberte odpovídající výstup z triggeru SharePoint s názvem Při vytvoření položky a z akce vlastního konektoru.

   Tento příklad přidá následující parametry a odpovídající výstupy triggeru a akce:

   Rozšířený parametr	Výstup triggeru nebo akce
   Recenze	Výstup triggeru SharePoint s názvem Revize
   Skóre	Výstup vlastní akce konektoru s názvem skóre. Když vyberete výstup triggeru, který se má použít v tomto poli, návrhář automaticky přidá akci For each, protože akce vlastního konektoru může přijímat více dokumentů. Ačkoli vlastní akce připojení odesílá pouze jeden dokument po druhém, návrhář odpovídá možnostem konektoru.

   Až skončíte, akce Aktualizovat položku bude vypadat jako v následujícím příkladu:

   

7. Až budete hotovi, pracovní postup uložte. Na panelu nástrojů návrháře vyberte Uložit.

Otestování pracovního postupu

Pokud chcete pracovní postup otestovat, přidejte revize do seznamu SharePoint Online a zkontrolujte, jak pracovní postup reaguje.

1. Na panelu nástrojů návrháře vyberte Spustit>Spustit.

2. V seznamu SharePoint Online zvolte Rychlá úprava.

3. Přidejte do seznamu dvě recenze, jednu negativní a jednu pozitivní, na základě následujících hodnot a poté zvolte Hotovo.

   Parametr	Navrhovaná hodnota
   Název (pozitivní)	Můj oblíbený film
   Recenze (pozitivní)	Nový film jsem si po náročném dni užil.
   Titul (negativní)	Nějaký jiný film
   Recenze (negativní)	Nejhorší film, který jsem viděl za desetiletí.

4. Zpět na portálu Azure Portal v nabídce aplikace logiky zvolte Přehled, abyste se mohli podívat na historii spuštění pracovního toku. Na stránce Přehled vyberte Historie spouštění.

   Na kartě Historie spuštění se zobrazují dvě spuštění pracovního postupu, jedno pro každou revizi, kterou jste přidali do seznamu.

5. Pokud chcete po dokončení tohoto pracovního postupu ušetřit na spotřebě prostředků, na panelu nástrojů stránky Přehled zvolte Deaktivovat.

6. Po návratu na stránku seznamu SharePoint Online aktualizujte prohlížeč a podívejte se na skóre, které pracovní tok přidal.

   

Blahopřejeme! I když se v tomto příkladu jedná o základní pracovní postup, vlastní konektor přidává výkonné funkce s možností volat služby Cognitive Services.

Související obsah

Vlastní konektor můžete také sdílet v rámci vaší organizace nebo pro něj získat certifikaci, aby ho mohli využívat i lidé mimo vaši organizaci:

• Sdílejte svůj konektor
• Certifikujte svůj konektor

Poskytnutí názorů

Velmi si vážíme vašich názorů na problémy s naší platformou konektorů nebo nových nápadů na funkce. Chcete-li poskytnout zpětnou vazbu, přejděte do části Odeslat problémy nebo získat pomoc s konektory a vyberte typ zpětné vazby.