Rychlý start: Vytváření a správa definic pracovních postupů aplikací logiky pomocí víceklientských aplikací Azure Logic Apps a editoru Visual Studio Code

Platí pro: Azure Logic Apps (Consumption)

V tomto rychlém startu se dozvíte, jak vytvářet a spravovat pracovní postupy aplikací logiky, které pomáhají automatizovat úlohy a procesy, které integrují aplikace, data, systémy a služby napříč organizacemi a podniky pomocí víceklientských aplikací Azure Logic Apps a editoru Visual Studio Code. Pomocí prostředí založeného na kódu můžete vytvářet a upravovat základní definice pracovních postupů, které používají javascriptový objektový zápis (JSON) pro aplikace logiky. Můžete také pracovat na existujících aplikacích logiky, které jsou už nasazené do Azure. Další informace o modelu jednoklienta versus víceklientského modelu najdete v části Single-tenant versus multitenant v Azure Logic Apps.

I když můžete tyto stejné úlohy provádět na webu Azure Portal, můžete začít rychleji v editoru Visual Studio Code, když už znáte definice aplikací logiky a chcete pracovat přímo v kódu. Můžete například zakázat, povolit, odstranit a aktualizovat již vytvořené aplikace logiky. Můžete také pracovat na aplikacích logiky a účtech integrace z libovolné vývojové platformy, na které běží Visual Studio Code, jako je Linux, Windows a Mac.

V tomto článku můžete vytvořit stejnou aplikaci logiky z tohoto rychlého startu, která se zaměřuje na základní koncepty. Můžete se také naučit vytvářet a spravovat aplikace prostřednictvím Azure CLI. V editoru Visual Studio Code vypadá aplikace logiky jako v následujícím příkladu:

Požadavky

Než začnete, ujistěte se, že máte tyto položky:

• Pokud nemáte účet Azure a předplatné, zaregistrujte si bezplatný účet Azure.

• Základní znalosti o definicích pracovních postupů aplikace logiky a jejich struktuře, jak je popsáno v kódu JSON

  Pokud s Azure Logic Apps teprve začínáte, vyzkoušejte tento rychlý start, který na webu Azure Portal vytvoří první pracovní postup aplikace logiky a zaměřuje se na základní koncepty.

• Přístup k webu pro přihlášení k Azure a předplatnému Azure

• Pokud je ještě nemáte, stáhněte a nainstalujte tyto nástroje:

  • Visual Studio Code verze 1.25.1 nebo novější, což je zdarma

  • Rozšíření Visual Studio Code pro Azure Logic Apps

    Toto rozšíření si můžete stáhnout a nainstalovat z webu Visual Studio Marketplace nebo přímo v editoru Visual Studio Code. Po instalaci se ujistěte, že znovu spustíte program Visual Studio Code.

    

    Pokud chcete zkontrolovat, jestli je rozšíření správně nainstalované, vyberte ikonu Azure, která se zobrazí na panelu nástrojů Visual Studio Code.

    

    Další informace najdete na Extension Marketplace. Pokud chcete přispět k opensourcové verzi tohoto rozšíření, navštivte rozšíření Azure Logic Apps pro Visual Studio Code na GitHubu.

• Pokud vaše aplikace logiky potřebuje komunikovat přes bránu firewall, která omezuje provoz na konkrétní IP adresy, musí tato brána firewall povolit přístup pro příchozí i odchozí IP adresy používané službou Azure Logic Apps nebo modulem runtime v oblasti Azure, kde vaše aplikace logiky existuje. Pokud vaše aplikace logiky také používá spravované konektory, jako je konektor Office 365 Outlook nebo konektor SQL, nebo používá vlastní konektory, brána firewall také potřebuje povolit přístup pro všechny odchozí IP adresy spravovaných konektorů v oblasti Azure vaší aplikace logiky.

Přístup k Azure z editoru Visual Studio Code

1. Otevřete Visual Studio Code. Na panelu nástrojů Visual Studio Code vyberte ikonu Azure.

   

2. V okně Azure v části Logic Apps vyberte Přihlásit se k Azure. Když vás přihlašovací stránka Microsoftu vyzve, přihlaste se pomocí svého účtu Azure.

   

   1. Pokud přihlášení trvá déle než obvykle, Visual Studio Code vás vyzve k přihlášení prostřednictvím ověřovacího webu Microsoftu tím, že vám poskytne kód zařízení. Pokud se chcete místo toho přihlásit pomocí kódu, vyberte Použít kód zařízení.

      

   2. Pokud chcete kód zkopírovat, vyberte Kopírovat a otevřít.

      

   3. Pokud chcete otevřít nové okno prohlížeče a pokračovat na ověřovací web, vyberte Otevřít odkaz.

      

   4. Na stránce Přihlásit se ke svému účtu zadejte ověřovací kód a vyberte Další.

      

3. Vyberte svůj účet Azure. Po přihlášení můžete prohlížeč zavřít a vrátit se do editoru Visual Studio Code.

   V podokně Azure se v sekcích Logic Apps a Účty integrace teď zobrazují předplatná Azure přidružená k vašemu účtu. Pokud ale nevidíte předplatná, která očekáváte, nebo pokud se v oddílech zobrazuje příliš mnoho předplatných, postupujte takto:

   1. Přesuňte ukazatel myši nad popisek Logic Apps. Po zobrazení panelu nástrojů vyberte Vybrat předplatná (ikona filtru).

      

   2. V zobrazeném seznamu vyberte předplatná, která chcete zobrazit.

4. V části Logic Apps vyberte požadované předplatné. Uzel předplatného se rozšíří a zobrazí všechny logické aplikace, které v tomto předplatném existují.

   

   Tip

   V části Účty integrace se výběrem předplatného zobrazí všechny účty integrace, které v tomto předplatném existují.

Vytvoření nové aplikace logiky

1. Pokud jste se ještě nepřihlásili ke svému účtu Azure a předplatnému z editoru Visual Studio Code, přihlaste se teď podle předchozích kroků.

2. V editoru Visual Studio Code v části Logic Apps otevřete místní nabídku svého předplatného a vyberte Vytvořit Logickou aplikaci.

   

   Zobrazí se seznam se všemi skupinami prostředků Azure ve vašem předplatném.

3. V seznamu skupin prostředků vyberte buď Vytvořit novou skupinu prostředků, nebo existující skupinu prostředků. V tomto příkladu vytvořte novou skupinu prostředků.

   

4. Zadejte název skupiny prostředků Azure a stiskněte ENTER.

   

5. Vyberte oblast Azure, do které chcete uložit metadata aplikace logiky.

   

6. Zadejte název aplikace logiky a stiskněte Enter.

   

   V okně Azure se v rámci vašeho předplatného Azure zobrazí nová a prázdná logická aplikace. Visual Studio Code také otevře soubor JSON (.logicapp.json), který obsahuje definici kostry pracovního postupu pro vaši aplikaci logiky. Teď můžete v tomto souboru JSON začít ručně vytvářet definici pracovního postupu aplikace logiky. Technické referenční informace o struktuře a syntaxi definice pracovního postupu najdete ve schématu jazyka definice pracovního postupu pro Azure Logic Apps.

   

   Tady je například ukázková definice pracovního postupu aplikace logiky, která začíná triggerem RSS a akcí Office 365 Outlook. Prvky JSON se obvykle v každé části zobrazují abecedně. Tato ukázka ale ukazuje tyto prvky zhruba v pořadí, v jakém se kroky aplikace logiky zobrazují v návrháři.

   Důležité

   Pokud chcete tuto ukázkovou definici aplikace logiky znovu použít, potřebujete například @fabrikam.comúčet organizace . Ujistěte se, že fiktivní e-mailovou adresu nahradíte vlastní e-mailovou adresou. Pokud chcete použít jiný e-mailový konektor, například Outlook.com nebo Gmail, nahraďte Send_an_email_action akci podobnou akcí dostupnou z e-mailového konektoru, který podporuje Azure Logic Apps.

   Pokud chcete používat konektor Gmail, můžou tento konektor používat jenom obchodní účty G-Suite bez omezení v aplikacích logiky. Pokud máte uživatelský účet Gmail, můžete tento konektor použít pouze s konkrétními službami schválenými Googlem nebo můžete vytvořit klientskou aplikaci Google, která se použije k ověřování pomocí konektoru Gmail. Další informace najdete v tématu Zabezpečení dat a zásady ochrany osobních údajů pro konektory Google v Azure Logic Apps.

   {
      "$schema": "https://schema.management.azure.com/providers/Microsoft.Logic/schemas/2016-06-01/workflowdefinition.json#",
      "contentVersion": "1.0.0.0",
      "parameters": {
         "$connections": {
            "defaultValue": {},
            "type": "Object"
         }
      },
      "triggers": {
         "When_a_feed_item_is_published": {
            "recurrence": {
               "frequency": "Minute",
               "interval": 30
            },
            "splitOn": "@triggerBody()?['value']",
            "type": "ApiConnection",
            "inputs": {
               "host": {
                  "connection": {
                     "name": "@parameters('$connections')['rss']['connectionId']"
                  }
               },
               "method": "get",
               "path": "/OnNewFeed",
               "queries": {
                  "feedUrl": "@{encodeURIComponent('https://feeds.content.dowjones.io/public/rss/RSSMarketsMain')}",
                  "sinceProperty": "PublishDate"
               }
            }
         }
      },
      "actions": {
         "Send_an_email_(V2)": {
            "runAfter": {},
            "type": "ApiConnection",
            "inputs": {
               "body": {
                  "Body": "<p>Title: @{triggerBody()?['title']}<br>\n<br>\nDate published: @{triggerBody()?['updatedOn']}<br>\n<br>\nLink: @{triggerBody()?['primaryLink']}</p>",
                  "Subject": "RSS item: @{triggerBody()?['title']}",
                  "To": "sophia-owen@fabrikam.com"
               },
               "host": {
                  "connection": {
                     "name": "@parameters('$connections')['office365']['connectionId']"
                  }
               },
               "method": "post",
               "path": "/v2/Mail"
            }
         }
      },
      "outputs": {}
   }
   

7. Až budete hotovi, uložte definici pracovního postupu aplikace logiky. (Nabídka Soubor > uložit, nebo stisknout Ctrl+S)

8. Po zobrazení výzvy k nahrání aplikace logiky do předplatného Azure vyberte Nahrát.

   Tento krok publikuje aplikaci logiky na webu Azure Portal, která logiku zprovozní a spustí v Azure.

   

Zobrazení aplikace logiky v návrháři

V editoru Visual Studio Code můžete aplikaci logiky otevřít v návrhovém zobrazení jen pro čtení. I když aplikaci logiky v návrháři nemůžete upravit, můžete vizuálně zkontrolovat pracovní postup aplikace logiky pomocí zobrazení návrháře.

V okně Azure v části Logic Apps otevřete místní nabídku aplikace logiky a vyberte Otevřít v Návrháři.

Návrhář jen pro čtení se otevře v samostatném okně a zobrazí pracovní postup vaší aplikace logiky, například:

Zobrazit na webu Azure Portal

Pokud chcete zkontrolovat aplikaci logiky na webu Azure Portal, postupujte takto:

1. Přihlaste se k webu Azure Portal pomocí stejného účtu Azure a předplatného, které je přidružené k vaší aplikaci logiky.

2. Do vyhledávacího pole webu Azure Portal zadejte název aplikace logiky. V seznamu výsledků vyberte aplikaci logiky.

   

Úprava nasazené aplikace logiky

V editoru Visual Studio Code můžete otevřít a upravit definici pracovního postupu pro již nasazenou aplikaci logiky v Azure.

Důležité

Než upravíte aktivně spuštěnou aplikaci logiky v produkčním prostředí, vyhněte se riziku porušení této aplikace logiky a minimalizujte přerušení tím , že nejprve zakážete aplikaci logiky.

1. Pokud jste se ještě nepřihlásili ke svému účtu Azure a předplatnému z editoru Visual Studio Code, přihlaste se teď podle předchozích kroků.

2. V okně Azure v části Logic Apps rozbalte své předplatné Azure a vyberte požadovanou aplikaci logiky.

3. Otevřete nabídku aplikace logiky a vyberte Otevřít v editoru. Nebo vedle názvu aplikace logiky vyberte ikonu pro úpravy.

   

   Visual Studio Code otevře soubor .logicapp.json v místní dočasné složce, abyste mohli zobrazit definici pracovního postupu aplikace logiky.

   

4. Proveďte změny v definici pracovního postupu aplikace logiky.

5. Jakmile budete hotovi, uložte změny. (Nabídka Soubor > uložit, nebo stisknout Ctrl+S)

6. Po zobrazení výzvy k nahrání změn a přepsání existující aplikace logiky na webu Azure Portal vyberte Nahrát.

   Tento krok publikuje aktualizace aplikace logiky na webu Azure Portal.

   

Zobrazení nebo zvýšení úrovně jiných verzí

V editoru Visual Studio Code můžete otevřít a zkontrolovat starší verze aplikace logiky. Můžete také povýšit dřívější verzi na aktuální verzi.

Důležité

Než změníte aktivně spuštěnou aplikaci logiky v produkčním prostředí, vyhněte se riziku narušení aplikace logiky a minimalizujte přerušení tím , že nejprve zakážete aplikaci logiky.

1. V okně Azure v části Logic Apps rozbalte své předplatné Azure, abyste mohli zobrazit všechny aplikace logiky v daném předplatném.

2. V rámci předplatného rozbalte aplikaci logiky a rozbalte položku Verze.

   V seznamu Verze se zobrazí dřívější verze vaší aplikace logiky, pokud existují.

   

3. Pokud chcete zobrazit starší verzi, vyberte jeden z těchto kroků:

   • Pokud chcete zobrazit definici JSON, v části Verze vyberte číslo verze pro tuto definici. Nebo otevřete kontextovou nabídku této verze a vyberte Otevřít v editoru.

     V místním počítači se otevře nový soubor a zobrazí se definice JSON této verze.

   • Pokud chcete zobrazit verzi v zobrazení návrháře jen pro čtení, otevřete místní nabídku dané verze a vyberte Otevřít v návrháři.

4. Pokud chcete zvýšit úroveň starší verze na aktuální verzi, postupujte takto:

   1. V části Verze otevřete místní nabídku starší verze a vyberte Zvýšit úroveň.

      

   2. Pokud chcete pokračovat po zobrazení výzvy k potvrzení editoru Visual Studio Code, vyberte Ano.

      

      Visual Studio Code propaguje vybranou verzi na aktuální verzi a přiřadí nové číslo k upřednostněné verzi. Předchozí aktuální verze se teď zobrazí pod upřednostněnou verzí.

Zakázání nebo povolení aplikací logiky

Pokud v editoru Visual Studio Code upravíte publikovanou aplikaci logiky a uložíte změny, přepíšete už nasazenou aplikaci. Pokud se chcete vyhnout přerušení aplikace logiky v produkčním prostředí a minimalizovat přerušení, zakažte nejdřív aplikaci logiky. Aplikaci logiky pak můžete znovu aktivovat, až potvrdíte, že vaše aplikace logiky stále funguje.

• Azure Logic Apps pokračuje ve všech probíhajících a čekajících spuštěních, dokud se nedokončí. Na základě objemu nebo nevyřízených položek může dokončení tohoto procesu nějakou dobu trvat.

• Azure Logic Apps nevytvoří ani nespouští nové instance pracovních postupů.

• Trigger se při příštím splnění podmínek neaktivuje.

• Stav triggeru si pamatuje bod, kdy byla aplikace logiky zastavena. Takže pokud znovu aktivujete logickou aplikaci, spouštěč se aktivuje pro všechny nezpracované položky od posledního spuštění.

  Pokud chcete zastavit aktivaci triggeru u nezpracovaných položek od posledního spuštění, před opětovnou aktivací aplikace logiky vymažte stav triggeru:

  1. V aplikaci logiky upravte libovolnou část triggeru pracovního postupu.
  2. Uložte provedené změny. Tento krok resetuje aktuální stav triggeru.
  3. Znovu aktivujte aplikaci logiky.

• Pokud je pracovní postup zakázán, můžete stejně znovu odeslat spuštění.

1. Pokud jste se ještě nepřihlásili ke svému účtu Azure a předplatnému z editoru Visual Studio Code, přihlaste se teď podle předchozích kroků.

2. V okně Azure v části Logic Apps rozbalte své předplatné Azure, abyste mohli zobrazit všechny aplikace logiky v daném předplatném.

   1. Pokud chcete požadovanou aplikaci logiky zakázat, otevřete nabídku aplikace logiky a vyberte Zakázat.

      

   2. Až budete připraveni aplikaci logiky znovu aktivovat, otevřete nabídku aplikace logiky a vyberte Povolit.

      

Odstraňte aplikace logiky

Odstranění aplikace logiky ovlivňuje instance pracovního postupu následujícími způsoby:

• Azure Logic Apps vynakládá maximální úsilí na zrušení probíhajících a čekajících spuštění.

  I při velkém objemu nebo záloze se většina běhů zruší před dokončením nebo než začnou. Dokončení procesu zrušení ale může chvíli trvat. Mezitím mohou být některá spuštění vybrána k provedení, zatímco služba prochází procesem zrušení.

• Azure Logic Apps nevytvoří ani nespouští nové instance pracovních postupů.

• Pokud pracovní postup odstraníte a pak znovu vytvoříte stejný pracovní postup, znovu vytvořený pracovní postup nebude mít stejná metadata jako odstraněný pracovní postup. Musíte znovu vytvořit libovolný pracovní postup, který se nazývá odstraněný pracovní postup. Volající tak získá správné informace pro znovu vytvořený pracovní postup. V opačném případě volání obnoveného pracovního postupu selže s chybou Unauthorized. Toto chování platí také pro pracovní postupy, které používají artefakty v účtech integrace, a pracovní postupy, které volají funkce Azure.

1. Pokud jste se ještě nepřihlásili ke svému účtu Azure a předplatnému z editoru Visual Studio Code, přihlaste se teď podle předchozích kroků.

2. V okně Azure v části Logic Apps rozbalte své předplatné Azure, abyste mohli zobrazit všechny aplikace logiky v daném předplatném.

3. Najděte aplikaci logiky, kterou chcete odstranit, otevřete nabídku aplikace logiky a vyberte Odstranit.

   

Další kroky

Vytváření pracovních postupů aplikací logiky založených na jednom tenantovi v editoru Visual Studio Code