Sdílet prostřednictvím


Rychlý start: Vytváření pracovních postupů Consumption ve víceklientských azure Logic Apps pomocí editoru Visual Studio Code

Platí pro: Azure Logic Apps (Consumption)

Jako vývojář integrace často potřebujete automatizovat obchodní procesy napříč aplikacemi SaaS, podnikovými systémy a zdroji dat bez správy infrastruktury. Také potřebujete kódově-orientovaný způsob, jak vytvářet pracovní postupy, abyste mohli spravovat verze definic, provádět aktualizace a efektivně kontrolovat změny.

V tomto rychlém startu se dozvíte, jak vytvářet a spravovat pracovní postupy Consumption ve víceklientských azure Logic Apps pomocí místních nástrojů založených na kódu v editoru Visual Studio Code. Spotřebitelské pracovní postupy poskytují bezserverový integrační model pro řízené událostmi a plánované pracovní postupy, takže můžete připojit služby a automatizovat procesy a platit pouze za akce, které běží.

V editoru Visual Studio Code můžete upravovat definice pracovních postupů v JavaScript Object Notation (JSON) pomocí editoru kódu, v případě potřeby používat vizuální návrhář a spravovat nasazené pracovní postupy v Azure. Můžete také pracovat na pracovních postupech a účtech integrace z libovolné vývojové platformy, na které běží Visual Studio Code, jako je Linux, Windows a macOS.

Následující snímek obrazovky ukazuje, jak může vypadat příklad definice pracovního postupu Consumption:

Snímek obrazovky znázorňující ukázkovou definici pracovního postupu aplikace logiky Consumption v editoru Visual Studio Code

Další informace najdete tady:

Požadavky

Přístup k Azure z editoru Visual Studio Code

  1. V editoru Visual Studio Code se přihlaste ke svému účtu Azure.

    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 přihlásit pomocí kódu, postupujte takto:

    1. Vyberte Použít kód zařízení a pak vyberte Kopírovat a Otevřít.

    2. Výběrem možnosti Otevřít odkaz otevřete nové okno prohlížeče a pokračujte na ověřovací web.

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

  2. Na panelu Aktivit vyberte ikonu Azure.

    Snímek obrazovky znázorňující Visual Studio Code, panel aktivit a vybranou ikonu Azure

    V panelu Azure se v oddílech Logic Apps (Consumption) a Integration Accounts nyní zobrazují předplatná Azure, která jsou přidružena k vašemu účtu. Pokud 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. V části Logic Apps (Consumption) vyberte Vybrat předplatná.

      Snímek obrazovky znázorňující podokno Azure, sekci Consumption pro Logic Apps a výběr předplatných, který slouží k filtrování předplatných Azure.

    2. V seznamu předplatných vyberte předplatná, která chcete použít.

  3. V části Logic Apps (Consumption) rozbalte své předplatné, abyste zobrazili všechny nasazené aplikace logiky v tomto předplatném.

    Snímek obrazovky znázorňující rozbalené předplatné Azure s přidruženými aplikacemi logiky

Vytvoření aplikace logiky

  1. V editoru Visual Studio Code v části Logic Apps (Consumption) v místní nabídce předplatného vyberte Vytvořit logic app.

    Snímek obrazovky, který zobrazuje zástupce místní nabídky předplatného a možnost Vytvořit Logic App.

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

  2. V seznamu skupin prostředků vyberte buď Vytvořit novou skupinu prostředků , nebo existující skupinu prostředků.

    V tomto příkladu vyberte Vytvořit novou skupinu prostředků, například:

    Snímek obrazovky znázorňující seznam skupin prostředků s vybranou možností Vytvořit novou skupinu prostředků

  3. Zadejte název skupiny prostředků Azure.

    Snímek obrazovky znázorňující zadaný název nové skupiny prostředků Azure

  4. Vyberte oblast Azure, kam chcete uložit metadata aplikace logiky.

    Snímek obrazovky znázorňující vybranou oblast Azure

  5. Zadejte název aplikace logiky.

    Snímek obrazovky znázorňující název zadaný pro aplikaci logiky

    V okně Azure se v rámci předplatného Azure zobrazí nová aplikace logiky a prázdný pracovní postup. Visual Studio Code také otevře soubor JSON (.logicapp.json), který obsahuje definici kostru pracovního postupu, například:

    Snímek obrazovky znázorňující architekturu pro prázdnou definici pracovního postupu aplikace logiky v souboru JSON

    Teď můžete v tomto souboru JSON začít ručně vytvářet definici pracovního postupu. Technický přehled o struktuře a syntaxi definice pracovního postupu najdete v tématu Schéma jazyka definice pracovního postupu pro Azure Logic Apps.

    Následující ukázková definice pracovního postupu aplikace logiky začíná triggerem RSS a akcí Office 365 Outlook. Prvky JSON se obvykle v každé části zobrazují abecedně. Tato ukázka však ukazuje tyto prvky zhruba v pořadí, v jakém se operace pracovního postupu zobrazují v návrháři.

    {
       "$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": {}
    }
    

    Důležité

    Pokud chcete tuto ukázkovou definici pracovního postupu znovu použít, potřebujete například @fabrikam.compracovní nebo školní úč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ý Azure Logic Apps podporuje.

    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 se specifickými službami schválenými Googlem nebo vytvořit klientskou aplikaci Google, která se použije k ověřování pomocí vašeho 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.

  6. Po dokončení uložte definici pracovního postupu. (Soubor>Uložte nebo stiskněte Ctrl+S.

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

    Tento krok publikuje definici pracovního postupu aplikace logiky z editoru Visual Studio Code na webu Azure Portal, což zprovozní pracovní postup v Azure.

    Snímek obrazovky znázorňující dialogové okno se zvýrazněným tlačítkem Nahrát pro nahrání aplikace logiky na web Azure Portal

Zobrazit pracovní postup v návrháři

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

V okně Azure v části Logic Apps (Consumption) v místní nabídce aplikace logiky vyberte Otevřít v Návrháři.

Návrhář jen pro čtení se otevře na samostatné záložce a zobrazí workflow logické aplikace, například:

Snímek obrazovky znázorňující pracovní postup aplikace logiky v návrhovém zobrazení

Zobrazení pracovního postupu na webu Azure Portal

Pokud chcete zkontrolovat definici pracovního postupu aplikace logiky na webu Azure Portal, postupujte takto:

  1. Na webu Azure Portal se přihlaste pomocí stejného účtu Azure a předplatného přidruženého 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.

    Snímek obrazovky znázorňující web Azure Portal, vyhledávací pole a název zadaný pro aplikaci logiky se zvýrazněným výsledkem

  3. Na bočním panelu aplikace logiky v části Vývojové nástroje otevřete pracovní postup v návrháři nebo zobrazení kódu.

Úprava nasazené aplikace logiky

V editoru Visual Studio Code můžete otevřít a upravit definici pracovního postupu pro již nasazený prostředek aplikace logiky v Azure.

Důležité

Před úpravou aktivně spuštěného pracovního postupu aplikace logiky v produkčním prostředí minimalizujte přerušení a vyhněte se riziku porušení pracovního postupu tím, že nejprve zakážete prostředek aplikace logiky.

  1. V editoru Visual Studio Code na panelu aktivit vyberte ikonu Azure.

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

  3. V místní nabídce aplikace logiky vyberte Otevřít v editoru. Nebo vedle názvu aplikace logiky vyberte ikonu pro úpravy.

    Snímek obrazovky znázorňující okno Azure, místní nabídku aplikace logiky a vybranou možnost Otevřít v editoru

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

    Snímek obrazovky znázorňující Visual Studio Code a otevřený definiční soubor pracovního postupu aplikace logiky

  4. Proveďte změny v definičním souboru pracovního postupu.

  5. Až budete hotovi, uložte změny (Uložení> nebo stiskněte Ctrl+S).

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

    Tento krok publikuje aktualizace prostředku aplikace logiky na webu Azure Portal.

    Snímek obrazovky znázorňující dialogové okno Visual Studio Code se zvýrazněným tlačítkem Nahrát pro nahrání změn Logic App na Azure Portal.

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

V editoru Visual Studio Code můžete otevřít a zkontrolovat starší verze pracovního postupu 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ěný pracovní postup aplikace logiky v produkčním prostředí, minimalizujte přerušení a vyhněte se riziku porušení aplikace logiky tím, že nejprve zakážete prostředek aplikace logiky.

  1. V okně Azure v části Logic Apps (Consumption) rozbalte předplatné Azure a zobrazte přidružené aplikace logiky.

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

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

    Snímek obrazovky znázorňující Visual Studio Code a starší verze aplikace logiky

  3. Pokud chcete zobrazit starší verzi, zvolte jeden z následujících kroků:

    • Pokud chcete zobrazit definici JSON, v části Verze vyberte číslo verze pro tuto definici. Nebo v místní nabídce verze 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 návrháři jen pro čtení, v místní nabídce verze 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 v místní nabídce starší verze vyberte Zvýšit úroveň.

      Snímek obrazovky, který ukazuje Visual Studio Code a jak povýšit předchozí verzi logické aplikace na aktuální verzi.

    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 publikovaný pracovní postup aplikace logiky a uložíte změny, přepíšete už nasazenou aplikaci logiky. Pokud se chcete vyhnout přerušení pracovního postupu aplikace logiky v produkčním prostředí a minimalizovat přerušení, nejprve zakažte prostředek aplikace logiky. Po potvrzení, že pracovní postup stále funguje podle očekávání, můžete znovu aktivovat prostředek aplikace logiky.

Zakázání nebo povolení prostředku aplikace logiky ovlivňuje instance pracovních postupů následujícími způsoby:

  • Azure Logic Apps pokračuje v probíhajících a čekajících spuštěních pracovního postupu, 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 se pracovní postup zastavil. Takže pokud znovu aktivujete logickou aplikaci, spouštěč se aktivuje pro všechny položky, které ještě nebyly zpracovány od posledního spuštění.

    Pokud chcete zastavit aktivaci triggeru u těchto nezpracovaných položek, před opětovnou aktivací prostředku aplikace logiky vymažte stav triggeru:

    1. V pracovním postupu upravte libovolnou část triggeru.
    2. Uložte provedené změny. Tento krok resetuje aktuální stav triggeru.
    3. Znovu aktivujte prostředek Logic App.
  • Pokud je zdroj aplikace logiky zakázaný, můžete stále znovu odeslat pracovní postup.

Pokud chcete v editoru Visual Studio Code zakázat nebo povolit prostředek aplikace logiky, postupujte takto:

  1. V editoru Visual Studio Code otevřete okno Azure.

  2. V části Logic Apps (Consumption) rozbalte své předplatné Azure a zobrazte přidružené aplikace logiky.

  3. Pokud chcete prostředek aplikace logiky zakázat, v místní nabídce aplikace logiky vyberte Zakázat.

    Snímek obrazovky znázorňující, jak zakázat prostředek Logic App ve Visual Studio Code

  4. Až budete připraveni znovu aktivovat prostředek aplikace logiky, v místní nabídce aplikace logiky vyberte Povolit.

    Snímek obrazovky znázorňující Visual Studio Code a jak povolit prostředek logické aplikace

Odstraňte aplikace logiky

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

  • Azure Logic Apps se pokusí zrušit probíhající a čekající běhy pracovního postupu.

    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 může služba vyzvednout některé úlohy k provedení, zatímco probíhá proces ruš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, bude znovu vytvořený pracovní postup používat různá metadata. Potřebujete znovu vytvořit libovolný pracovní postup, který se nazývá odstraněný pracovní postup. Při opětovném ukládání volající 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.

Pokud chcete odstranit prostředek aplikace logiky z editoru Visual Studio Code, postupujte takto:

  1. V editoru Visual Studio Code otevřete okno Azure.

  2. V části Logic Apps (Consumption) rozbalte předplatné Azure a zobrazte přidružené prostředky aplikace logiky. Vyhledejte prostředek aplikace logiky, který chcete odstranit.

  3. V kontextové nabídce logického aplikace vyberte Odstranit.

    Snímek obrazovky ukazující Visual Studio Code a způsob odstranění prostředku logické aplikace.