Poznámka
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Platí pro: Azure Logic Apps (Standard)
Tento průvodce ukazuje, jak místně vytvořit ukázkový pracovní postup standardní aplikace logiky, který můžete spustit v Azure Logic Apps s jedním tenantem při použití editoru Visual Studio Code s rozšířením Azure Logic Apps (Standard ).
V této příručce vytvoříte pracovní prostor a projekt standardní aplikace logiky, sestavíte pracovní postup a nasadíte projekt jako prostředek aplikace logiky Standard v Azure, kde se váš pracovní postup může spouštět v Azure Logic Apps s jedním tenantem nebo ve službě App Service Environment v3 (pouze plány služby App Service založené na Windows). Pracovní postup můžete také nasadit a spustit kdekoli, kde může Kubernetes běžet, jako je Azure, Azure Kubernetes Service, místní nebo dokonce i jiní poskytovatelé cloudu, a to kvůli kontejnerizovanému modulu runtime pro Azure Logic Apps (Standard).
Tady jsou jen některé výhody, které poskytují standardní aplikace logiky:
V místním vývojovém prostředí editoru Visual Studio Code můžete místně vytvářet, ladit, spouštět a testovat pracovní postupy. Azure Portal i Visual Studio Code poskytují možnost vytvářet, spouštět a nasazovat prostředky a pracovní postupy standardní aplikace logiky. Pomocí editoru Visual Studio Code však můžete tyto úlohy provádět místně.
Projekt standardní aplikace logiky může zahrnovat stavové i bezstavové pracovní postupy.
Pracovní postupy ve stejném prostředku Standardní Logic Apps a tenantu běží ve stejném procesu jako běhové prostředí Azure Logic Apps (Standard), takže sdílejí stejné prostředky a poskytují lepší výkon.
Příklad pracovního postupu v tomto průvodci začíná spuštěním požadavku, po kterém následuje akce Office 365 Outlook. Trigger požadavku vytvoří pro pracovní postup volatelný koncový bod a čeká na příchozí požadavek HTTPS od libovolného volajícího. Když trigger přijme požadavek a aktivuje se, spustí se další akce odesláním e-mailu určenému příjemci spolu s výstupy triggeru, které vyberete. Později můžete přidat akci Odpovědi, která vrátí odpověď a zpracovaná data volajícímu.
I když je příklad této příručky cloudový a má jenom několik kroků, můžete vytvářet pracovní postupy pomocí operací z 1 400 konektorů, které vám pomůžou integrovat širokou škálu služeb, systémů, aplikací a dat napříč cloudem, místními a hybridními prostředími.
Při procházení průvodce provedete následující základní úkoly:
- Vytvořte pracovní prostor aplikace logiky Standard a projekt s prázdným stavovým pracovním postupem.
- Přidejte do pracovního postupu aktivační událost a akce.
- Spusťte, laďte a testujte lokálně.
- Zkontrolujte historii spuštění pracovního postupu.
- Vyhledejte podrobnosti o názvu domény pro přístup k bráně firewall.
- Povolte historii spuštění pro bezstavové pracovní postupy.
- Nasazení do Azure, které zahrnuje volitelné povolení Application Insights.
- Po nasazení povolte nebo otevřete Application Insights.
- Spravujte nasazený prostředek aplikační logiky v editoru Visual Studio Code a v Azure Portal.
Požadavky
Požadavky na přístup a připojení
Pokud plánujete místně vytvářet a spouštět pracovní postupy pouze pomocí integrovaných operací, které běží nativně v modulu runtime Azure Logic Apps (Standard), nepotřebujete požadavky na přístup a připojení v této části. V následujících scénářích ale potřebujete splnit tyto požadavky:
- Nasaďte aplikaci logiky do Azure ze sady Visual Studio Code.
- Vytvořte pracovní postup, který používá operace spravovaného konektoru , které běží v globálním Azure.
- Přístup k existujícím prostředkům a pracovním postupům aplikace logiky úrovně Standard v Azure nebo jiných nasazených prostředcích Azure
Mezi tyto požadavky patří následující položky:
Účet a předplatné Azure. Pokud předplatné nemáte, zaregistrujte si bezplatný účet Azure.
Přístup k internetu, abyste si mohli stáhnout požadované rozšíření, připojit se z editoru Visual Studio Code ke svému účtu Azure, otestovat pracovní postupy, které zahrnují operace spravovaných konektorů, a nasadit do Azure ze sady Visual Studio Code.
Pokud chcete vytvořit stejný ukázkový pracovní postup v této příručce, potřebujete e-mailový účet Office 365 Outlook, který k přihlášení používá pracovní nebo školní účet Microsoft.
Pokud nemáte účet Office 365, můžete použít jakoukoli jinou dostupnou akci, která může posílat zprávy z vašeho e-mailového účtu, například Outlook.com. Pokud zvolíte jiný e-mailový konektor, například Outlook.com, můžete i nadále postupovat podle příkladu a obecný celkový postup je stejný. Vaše zkušenosti a možnosti se ale můžou lišit některými způsoby. Například s konektorem Outlook.com se přihlaste pomocí svého osobního účtu Microsoft.
Nářadí
Stáhněte a nainstalujte Visual Studio Code, což je zdarma.
Pomocí následujícího postupu stáhněte a nainstalujte rozšíření Azure Logic Apps (Standard) pro Visual Studio Code :
V editoru Visual Studio Code na panelu aktivit vyberte Rozšíření. (Klávesnice: Stiskněte Ctrl+Shift+X)
Do vyhledávacího pole rozšíření zadejte standard Azure Logic Apps. V seznamu výsledků vyberte Nainstalovat Azure Logic Apps (Standard).>
Rozšíření stáhne a nainstaluje všechny požadované závislosti a správné verze pro následující architektury:
- Azure Functions Core Tools (Nástroje jádra pro funkce Azure)
- .NET SDK
- Node.js
Po dokončení instalace se rozšíření zobrazí v seznamu Rozšíření: Nainstalované .
Znovu načtěte nebo restartujte Visual Studio Code, abyste měli jistotu, že se rozšíření a všechny závislosti správně nainstalují.
Informace o správné instalaci rozšíření a všech závislostí najdete v tématu Kontrola instalace rozšíření.
V současné době můžete mít nainstalovaná rozšíření Consumption (multitenant) i Standard (single-tenant). Vývojové prostředí se od sebe liší určitým způsobem, ale vaše předplatné Azure může zahrnovat typy prostředků aplikace logiky Standard i Consumption. V editoru Visual Studio Code se v podokně Azure zobrazují všechny aplikace logiky nasazené v Azure a hostované v předplatném Azure, ale aplikace se uspořádají následujícími způsoby:
- Oddíl Zdroje: Všechny standardní aplikace logiky ve vašem předplatném.
- Oddíl Logic Apps (Consumption): Všechny aplikace logiky Consumption ve vašem předplatném.
Pokud chcete místně spouštět triggery a akce založené na webhooku, například předdefinovaný trigger webhooku HTTP, musíte nastavit přesměrování adresy URL zpětného volání v editoru Visual Studio Code.
Pokud chcete povolit protokolování diagnostiky a trasování pomocí Application Insights pro vaši standardní aplikaci logiky, můžete tuto úlohu dokončit buď během nasazování aplikace logiky, nebo po nasazení. Potřebujete mít prostředek Application Insights, ale tento prostředek můžete vytvořit předem, během nasazení nebo po nasazení.
Nainstalujte nebo použijte nástroj, který může odesílat požadavky HTTP k otestování ukázkového pracovního postupu, například:
- Visual Studio Code s rozšířením z Webu Visual Studio Marketplace
- PowerShell Invoke-RestMethod
- Microsoft Edge – nástroj konzoly sítě
- Bruno
- kudrna
Upozornění
V situacích, kdy máte citlivá data, jako jsou přihlašovací údaje, tajné kódy, přístupové tokeny, klíče rozhraní API a další podobné informace, nezapomeňte použít nástroj, který chrání vaše data pomocí nezbytných funkcí zabezpečení. Nástroj by měl fungovat offline nebo místně a nevyžaduje přihlášení k online účtu nebo synchronizaci dat do cloudu. Při použití nástroje s těmito charakteristikami snížíte riziko zveřejnění citlivých dat veřejnosti.
Kontrola instalace rozšíření
Abyste měli jistotu, že jsou rozšíření a všechny závislosti správně nainstalované, znovu načtěte nebo restartujte Visual Studio Code.
Ověřte, že Visual Studio Code automaticky najde a nainstaluje aktualizace rozšíření, aby všechna vaše rozšíření získala nejnovější aktualizace. Jinak musíte ručně odinstalovat zastaralou verzi a nainstalovat nejnovější verzi.
V nabídce Soubor přejděte na Nastavení předvoleb>.
Na kartě Uživatel přejděte na Rozšíření funkcí>.
Ujistěte se, že je vybraná možnost Automatická kontrola aktualizací a že je automatická aktualizace nastavená na všechna rozšíření.
Ověřte, že je nastavení Azure Logic Apps Standard: Project Runtime nastavené na správnou verzi:
Na kartě Uživatel přejděte na > Rozšíření > Azure Logic Apps (Standard).
Ujistěte se, že je modul runtime projektu nastavený na verzi ~4, například:
Poznámka:
Tato verze se vyžaduje k použití akcí operací vloženého kódu.
Připojení k účtu Azure
Pokud ještě nejste připojení ke svému účtu Azure, připojte se takto:
V editoru Visual Studio Code na panelu aktivit vyberte ikonu Azure a otevřete podokno Azure .
V podokně Azure v části Prostředky vyberte Přihlásit se k Azure. Jakmile se zobrazí ověřovací stránka editoru Visual Studio Code, přihlaste se pomocí svého účtu Azure.
Po přihlášení se v podokně Azure zobrazí předplatná Azure přidružená k vašemu účtu Azure. Pokud se očekávaná předplatná nezobrazí nebo chcete, aby se v podokně zobrazovala jenom konkrétní předplatná, postupujte takto:
V seznamu předplatných přesuňte ukazatel vedle prvního předplatného, dokud se nezobrazí tlačítko Vybrat předplatná (ikona filtru). Vyberte ikonu filtru.
Nebo na stavovém řádku editoru Visual Studio Code vyberte svůj účet Azure.
Jakmile se zobrazí aktualizovaný seznam předplatných, vyberte požadovaná předplatná a ujistěte se, že jste vybrali OK.
Vytvoření místního pracovního prostoru
Projekt aplikace logiky vždy vyžaduje pracovní prostor. Než tedy budete moct vytvořit aplikaci logiky, musíte vytvořit pracovní prostor , ve kterém zůstane projekt aplikace logiky. Později použijete tento pracovní prostor a projekt ke správě, spuštění a nasazení aplikace logiky ze sady Visual Studio Code do prostředí nasazení. Základní projekt je podobný projektu Azure Functions, kterému se také říká projekt aplikace funkcí.
Na počítači vytvořte prázdnou místní složku, která se použije později pro pracovní prostor a projekt.
Tento příklad vytvoří složku s názvem fabrikam-workflows.
V editoru Visual Studio Code zavřete všechny otevřené složky.
V okně Azure na panelu nástrojů oddílu Pracovní prostor v nabídce Azure Logic Apps vyberte Vytvořit nový pracovní prostor aplikace logiky.
Pokud vás brána firewall v programu Windows Defender vyzve k udělení síťového přístupu pro Code.exe, což je Visual Studio Code, a pro func.exe, což je Azure Functions Core Tools, vyberte
V okně Vybrat složku přejděte do umístění, kam jste složku vytvořili, vyberte složku a zvolte Vybrat (nevybírejte ji dvakrát).
Na panelu nástrojů editoru Visual Studio Code se zobrazí výzva k pojmenování pracovního prostoru.
Do pole Zadejte název pracovního prostoru zadejte název pracovního prostoru, který chcete použít.
Tento příklad používá Fabrikam-Workflows.
Dále vytvořte projekt aplikace logiky.
Vytvoření projektu aplikace logiky
Po vytvoření požadovaného pracovního prostoru postupujte podle pokynů k vytvoření projektu.
Pro šablonu projektu vyberte Logic App. Zadejte název projektu, který chcete použít.
Tento příklad používá Fabrikam-Workflows.
Pro šablonu pracovního postupu vyberte stavový pracovní postup nebo bezstavový pracovní postup podle vašeho scénáře. Zadejte název pracovního postupu, který chcete použít.
Tento příklad vybere stavový pracovní postup, který ukládá historii pracovního postupu, vstupy a výstupy a jako název používá Stavový pracovní postup .
Bezstavové pracovní postupy neukládají tato data a aktuálně podporují jenom spravované konektorové akce, ale nikoli triggery. I když máte možnost povolit konektory v Azure pro bezstavový pracovní postup, návrhář nezobrazuje žádné triggery spravovaného konektoru, které můžete vybrat.
Poznámka:
Pokud se zobrazí chyba s názvem azureLogicAppsStandard.createNewProject s chybovou zprávou, Nejde zapisovat do nastavení pracovního prostoru, protože azureFunctions.suppressProject není registrovaná konfigurace, zkuste přeinstalovat rozšíření Azure Functions pro Visual Studio Code, a to buď přímo z Webu Visual Studio Marketplace nebo z editoru Visual Studio Code.
Teď zvolte, jestli chcete projekt otevřít v aktuálním okně editoru Visual Studio Code nebo v novém okně. Na základě vašich preferencí vyberte Otevřít v aktuálním okně nebo Otevřít v novém okně.
Otevře se podokno Průzkumník, ve kterém se zobrazí váš pracovní prostor, projekt a automaticky otevřený souborworkflow.json. Tento soubor existuje ve složce Stateful-Workflow a uloží podkladovou definici JSON pro pracovní postup, který vytvoříte v návrháři. Informace o struktuře projektu najdete v tématu Standardní struktura projektu aplikace logiky.
Zobrazí se také výzva k povolení "sdílených" konektorů hostovaných ve více tenantech Azure, například:
Pokud chcete povolit všechny spravované "sdílené" konektory, které běží ve víceklientských Azure, abyste je mohli zobrazit a použít ve svém pracovním postupu, vyberte Použít konektory z Azure.
Poznámka:
Pokud tuto možnost nevyberete a později se pokusíte přidat operaci spravovaného konektoru při sestavování pracovního postupu, nemůžete pokračovat, protože v podokně informací o operaci se zobrazuje rotující kruh, který se nezastaví.
U skupiny prostředků Azure vyberte Vytvořit novou skupinu prostředků. Zadejte název skupiny prostředků, který chcete použít.
V tomto příkladu se používá Fabrikam-Workflows-RG.
V případě předplatného vyberte předplatné Azure, které se má použít s projektem aplikace logiky.
Vyberte region Azure pro umístění, kam chcete vytvořit skupinu a prostředky.
V tomto příkladu se používá USA – středozápad.
Pokud váš projekt potřebuje jiné nastavení pro vývoj nebo potřebuje podporu artefaktů pro sestavení pracovního postupu, projděte si následující scénáře a související úlohy:
Scénář Úkol Místně spouštět triggery nebo akce založené na webhooku Nastavte přesměrování pro adresy URL zpětného volání webhooku. Nastavte bezstavovou historii spuštění pracovního postupu. Povolte historii spuštění pro bezstavové pracovní postupy. Přidejte artefakty a závislosti, jako jsou mapy, schémata a sestavení. Přidejte artefakty a závislosti. Práce s projektem založeným na NuGetu (.NET) Převeďte projekt sady založené na rozšíření (Node.js) na projekt založený na balíčku NuGet (.NET).
Poznámka: Chcete-li převést projekt založený na sadě rozšíření (Node.js), který jste vytvořili před tím, než existovala podpora sestavení, viz také Migrace projektů založených na balíčku NuGet pro použití sestavení ve složce lib.Vytvořte si vlastní integrované konektory. 1. Převeďte projekt založený na sadě rozšíření (Node.js) na projekt založený na balíčku NuGet (.NET).
2. Povolte vytváření předdefinovaných konektorů.
Teď otevřete návrháře pracovního postupu.
Otevření návrháře pracovního postupu
Po otevření projektu v podokně Průzkumník otevřete návrháře, abyste mohli vytvořit pracovní postup.
V místní nabídce workflow.json souboru vyberte Otevřít Designer.
Poznámka:
Po výběru této možnosti se může zobrazit zpráva, že spuštění může trvat několik sekund kvůli spuštění rozhraní API pro návrh pracovního postupu. Tuto zprávu můžete ignorovat nebo vybrat OK.
Visual Studio Code otevře návrháře pracovního postupu a zobrazí výzvu k přidání triggeru , například:
Poznámka:
Pokud se návrhář neotevře, přečtěte si část řešení potíží a Návrhář se neotevře.
Dále přidejte trigger a akce pro vytvoření pracovního postupu.
Přidání triggeru a akce
Pokud chcete vytvořit pracovní postup, spusťte pracovní postup triggerem a pak nejprve přidejte jednu akci. Tímto způsobem můžete svůj pracovní postup otestovat před přidáním další akce. Ukázkový pracovní postup používá následující aktivační událost a akce, které se souhrnně označují jako operace:
Konektor nebo skupina operací | Název operace | Typ operace | Popis |
---|---|---|---|
Prosba | Při přijetí požadavku HTTP | Trigger (integrovaný) | Vytvoří v pracovním postupu adresu URL koncového bodu pro příjem příchozích volání nebo požadavků z jiných služeb nebo pracovních postupů aplikace logiky. Další informace naleznete v tématu Příjem a reakce na příchozí volání HTTPs do pracovních postupů. |
Office 365 Outlook | Odeslat e-mail | Akce (spravovaná) | Odešlete e-mail pomocí účtu Office 365 Outlook. Pokud chcete postupovat podle kroků v této příručce, potřebujete e-mailový účet Office 365 Outlook. Další informace najdete v tématu Připojení k Office 365 Outlooku z Azure Logic Apps. Poznámka: Pokud máte e-mailový účet podporovaný jiným konektorem, můžete tento konektor použít, ale uživatelské prostředí tohoto konektoru se liší od kroků v tomto příkladu. |
Prosba | odpověď | Akce (integrovaná) | Odešlete odpověď a vrátíte data zpět volajícímu. Další informace najdete v tématu Přidání akce 'Odpověď'. |
Přidejte spouštěč požadavku
V návrháři pracovního postupu vyberte Přidat trigger, pokud ještě není vybraný.
Otevře se podokno Přidat aktivační událost a zobrazí galerii, kde můžete vybírat z dostupných konektorů a skupin operací, například:
V podokně Přidat spouštěčpostupujte podle těchto obecných kroků pro přidání spouštěče požadavku s názvem Při přijetí požadavku HTTP.
Následující příklad vybere předdefinované možnosti, aby se zobrazily jenom předdefinované triggery:
Když se trigger zobrazí v návrháři, otevře se podokno s informacemi o triggeru a zobrazí parametry, nastavení a další související úlohy triggeru.
Poznámka:
Pokud se podokno informací o spouštěči nezobrazí, ujistěte se, že je spouštěč vybrán v návrháři.
Uložte pracovní postup. Na panelu nástrojů návrháře vyberte Uložit.
Přidání akce Office 365 Outlooku
V návrháři, pod spouštěčem Žádosti, postupujte podle těchto obecných kroků, abyste přidali akci Office 365 Outlook s názvem Odeslat e-mail (V2).
Pokud se akce nezobrazí v počátečních výsledcích, vyberte možnost Zobrazit více vedle názvu konektoru, například:
Jakmile se zobrazí podokno ověřování akce, vyberte Přihlásit se a vytvořte připojení k vašemu e-mailovému účtu.
Postupujte podle následujících výzev k ověření přihlašovacích údajů, povolení přístupu a povolení návratu do editoru Visual Studio Code.
Poznámka:
Pokud před dokončením výzev uplyne příliš mnoho času, proces ověřování vyprší a selže. V tomto případě se vraťte do návrháře a zkuste se znovu přihlásit a vytvořte připojení.
Po zobrazení výzvy k ověření Microsoftu vyberte svůj uživatelský účet pro Office 365 Outlook. Na potvrzovací požadované stránce, která se otevře, vyberte Povolit přístup.
Když Se službou Azure Logic Apps zobrazí výzva k otevření odkazu editoru Visual Studio Code, vyberte Otevřít.
Když Visual Studio Code vyzve k otevření rozšíření Nástroje Microsoft Azure, vyberte Otevřít.
Jakmile Visual Studio Code vytvoří vaše připojení, některé konektory zobrazí zprávu, že připojení bude platné pouze po <dobu n> dnů. Tento časový limit se vztahuje pouze na dobu trvání vytváření pracovního postupu aplikace logiky v editoru Visual Studio Code. Po nasazení už tento limit neplatí, protože váš pracovní postup se může ověřit za běhu pomocí automaticky povolené spravované identity přiřazené systémem. Tato spravovaná identita se liší od přihlašovacích údajů ověřování nebo připojovací řetězec, které používáte při vytváření připojení. Pokud tuto spravovanou identitu přiřazenou systémem zakážete, připojení nebudou za běhu fungovat.
V podokně Odeslat e-mailové informace, které se otevře, na kartě Parametry zadejte požadované informace pro danou akci.
Poznámka:
Pokud se podokno informací o akcích neotevřelo automaticky, vyberte v návrháři akci Odeslat e-mail .
Vlastnictví Povinné Hodnota Popis do Ano < vaše_e-mailová_adresa> Příjemce e-mailu, který může být vaší e-mailovou adresou pro testovací účely. Tento příklad používá fiktivní e-mail, sophia.owen@fabrikam.com. Předmět Ano E-mail z ukázkového pracovního postupu Předmět e-mailu Tělo Ano Dobrý den z ukázkového pracovního postupu! Obsah textu e-mailu Například:
Uložte pracovní postup. V návrháři vyberte Uložit.
Struktura projektu standardní aplikace logiky
V editoru Visual Studio Code má váš projekt aplikace logiky některý z následujících typů:
- Sada rozšíření (Node.js), což je výchozí typ
- Balíček NuGet (.NET), který lze převést z výchozího typu
Na základě těchto typů může projekt obsahovat mírně odlišné složky nebo soubory. Projekt založený na balíčku NuGet má například složku .bin , která obsahuje balíčky a další soubory knihovny. Projekt založený na balíčku rozšíření neobsahuje tuto složku .bin.
Některé scénáře vyžadují spuštění projektu založeného na balíčku NuGet, například když chcete vyvíjet a spouštět vlastní integrované operace. Další informace o převodu projektu na použití NuGetu najdete v tématu Povolení vytváření integrovaných konektorů.
Výchozí projekt založený na sadě rozšíření má strukturu složek a souborů, která je podobná následujícímu příkladu:
MyWorkspaceName
| MyBundleBasedLogicAppProjectName
|| .vscode
|| Artifacts
||| Maps
|||| MapName1
|||| ...
||| Rules
||| Schemas
|||| SchemaName1
|||| ...
|| lib
||| builtinOperationSdks
|||| JAR
|||| net472
||| custom
|| WorkflowName1
||| workflow.json
||| ...
|| WorkflowName2
||| workflow.json
||| ...
|| workflow-designtime
||| host.json
||| local.settings.json
|| .funcignore
|| connections.json
|| host.json
|| local.settings.json
Na kořenové úrovni projektu najdete následující složky a soubory spolu s dalšími položkami:
Název | Složka nebo soubor | Popis |
---|---|---|
.vscode | Složka | Obsahuje soubory nastavení související se sadou Visual Studio Code, například soubory extensions.json, launch.json, settings.json a tasks.json . |
Artefakty | Složka | Obsahuje artefakty účtu integrace, které definujete a používáte v pracovních postupech, které podporují scénáře B2B (business-to-business). Ukázková struktura například obsahuje následující složky: - Mapy: Obsahuje mapy , které se mají použít pro operace transformace XML. - Schémata: Obsahuje schémata , která se mají použít pro operace ověřování XML. - Pravidla: Artefakty pro obchodní pravidla v projektech systémů založených na pravidlech. |
knihovna | Složka | Obsahuje podporovaná sestavení, která vaše aplikace logiky může používat nebo na která může odkazovat. Tato sestavení můžete nahrát do projektu v editoru Visual Studio Code, ale musíte je přidat do konkrétních složek v projektu. Tato složka například obsahuje následující složky: - builtinOperationSdks: Obsahuje složky JAR a net472 pro sestavení Java a .NET Framework v uvedeném pořadí. - custom: Obsahuje sestavení přizpůsobená pro .NET Framework. Další informace o podporovaných typech sestavení a umístění do projektu naleznete v tématu Přidání sestavení do projektu. |
< Název pracovního postupu> | Složka | Pro každý pracovní postup <obsahuje složka WorkflowName> soubor workflow.json, který obsahuje základní definici JSON daného pracovního postupu. |
workflow-designtime | Složka | Obsahuje soubory nastavení souvisejících s vývojovým prostředím. |
.funcignore | Soubor | Obsahuje informace související s nainstalovanými nástroji Azure Functions Core Tools. |
connections.json | Soubor | Obsahuje metadata, koncové body a klíče pro všechna spravovaná připojení a funkce Azure, které vaše pracovní postupy používají. Důležité: Pokud chcete pro každé prostředí používat různá připojení a funkce, ujistěte se, že parametrizujete tento soubor connections.json a aktualizujete koncové body. |
host.json | Soubor | Obsahuje nastavení a hodnoty konfigurace specifické pro modul runtime, například výchozí omezení pro platformu Azure Logic Apps s jedním tenantem, aplikace logiky, pracovní postupy, triggery a akce. Na kořenové úrovni projektu aplikace logiky obsahuje soubor metadat host.json konfigurační nastavení a výchozí hodnoty, které všechny pracovní postupy ve stejné aplikaci logiky používají při spuštění, ať už místně nebo v Azure. Referenční informace najdete v tématu Úprava nastavení aplikace a nastavení hostitele. Poznámka: Při vytváření aplikace logiky vytvoří Visual Studio Code soubor backup host.snapshot.*.json v kontejneru úložiště. Pokud odstraníte aplikaci logiky, tento záložní soubor se neodstraní. Pokud vytvoříte jinou aplikaci logiky se stejným názvem, vytvoří se jiný soubor snímku. Pro stejnou aplikaci logiky můžete mít maximálně 10 snímků. Pokud tento limit překročíte, zobrazí se následující chyba: Microsoft.Azure.WebJobs.Script.WebHost: Repository has more than 10 non-decryptable secrets backups (host)) Pokud chcete tuto chybu vyřešit, odstraňte extra snímkové soubory z kontejneru úložiště. |
local.settings.json | Soubor | Obsahuje nastavení aplikace, připojovací řetězec a další nastavení, která vaše pracovní postupy používají při místním spuštění. Tato nastavení a hodnoty platí jenom v případech, kdy projekty spouštíte v místním vývojovém prostředí. Během nasazování do Azure se soubor a nastavení ignorují a nejsou součástí vašeho nasazení. Tento soubor ukládá nastavení a hodnoty jako místní proměnné prostředí, které místní vývojové nástroje používají pro tyto hodnoty appSettings . Tyto proměnné prostředí můžete volat a odkazovat na ně za běhu i v době nasazení pomocí nastavení aplikace a parametrů. Důležité: Soubor local.settings.json může obsahovat tajné kódy, proto se ujistěte, že tento soubor také vyloučíte ze správy zdrojového kódu projektu. Tento soubor také obsahuje nastavení aplikace, které vaše logická aplikace potřebuje ke správnému fungování. Referenční informace najdete v tématu Úprava nastavení aplikace a nastavení hostitele. |
Další úlohy nastavení vývoje
Po vytvoření projektu můžete mít i další úlohy nastavení, které podporují konkrétní místní vývojové scénáře týkající se sestavování, spouštění a nasazování standardních aplikací logiky pomocí editoru Visual Studio Code. Následující části popisují úlohy pro tyto scénáře.
Povolení místně spuštěných webhooků
Operace webhooku je trigger pracovního postupu nebo akce, která před spuštěním operace čeká na událost. Konkrétně operace webhooku čeká na přijetí požadavku HTTPS ze služby volajícího nebo pracovního toku, než může operace pokračovat. Webhooky například zahrnují operace jako spouštěč požadavku a spouštěč HTTP + Webhook.
V Azure portálu modul runtime Azure Logic Apps automaticky připojí webhook ke službě nebo pracovnímu postupu volajícího. Modul runtime zaregistruje adresu URL zpětného volání pro webhook ve službě volajícího nebo pracovním postupu. Webhook pak čeká, až volající odešle požadavek pomocí adresy URL zpětného volání.
V editoru Visual Studio Code ale musíte dokončit některé úlohy nastavení pro operace webhooku, aby správně fungovaly. V tomto scénáři adresa URL zpětného volání používá váš server localhost (http://localhost:7071/...
), který je soukromý, takže volající nemůže přímo odeslat požadavek přes internet na tuto adresu URL.
V případě operací webhooku v místně spuštěných pracovních postupech je potřeba nastavit veřejnou adresu URL, která zpřístupňuje server localhost a bezpečně přesměruje volání volajícího na adresu URL zpětného volání. Můžete použít službu předávání a nástroj, jako je například ngrok, který otevře tunel HTTP na port místního hostitele, nebo můžete použít vlastní ekvivalentní nástroj.
Nastavení přesměrování hovorů pomocí nástroje ngrok
Přejděte na web ngrok. Zaregistrujte si nový účet nebo se přihlaste ke svému účtu, pokud ho už máte.
Získejte osobní ověřovací token, který klient ngrok potřebuje k připojení a ověření přístupu k vašemu účtu.
Stránku ověřovacího tokenu najdete tak, že v nabídce řídicího panelu účtu rozbalíte Položku Ověřování a vyberete Váš ověřovací token.
Z pole Váš ověřovací token zkopírujte do bezpečného umístění.
Na stránce pro stažení ngrok nebo na řídicím panelu účtu stáhněte požadovanou verzi nástroje ngrok a extrahujte .zip soubor.
Další informace najdete v kroku 1: Rozbalení instalace.
Na počítači otevřete nástroj příkazového řádku. Přejděte do umístění, kde máte soubor ngrok.exe .
Spuštěním následujícího příkazu připojte klienta ngrok ke svému účtu ngrok :
ngrok authtoken <your-authentication-token>
Další informace najdete v kroku 2: Připojení účtu.
Spuštěním následujícího příkazu otevřete tunel HTTP na port localhost 7071:
ngrok http 7071
Další informace najdete v kroku 3: Aktivace.
Ve výstupu najděte následující řádek:
http://<domain>.ngrok.io -> http://localhost:7071
Zkopírujte a uložte adresu URL, která má tento formát:
http://<domain>.ngrok.io
Nastavení adresy URL pro přeposílání v nastavení aplikace
V editoru Visual Studio Code v návrháři přidejte operaci webhooku, kterou chcete použít ve svém pracovním postupu.
Tento příklad pokračuje triggerem HTTP + Webhook .
Jakmile se zobrazí výzva k umístění koncového bodu hostitele, zadejte adresu URL přesměrování (přesměrování), kterou jste vytvořili dříve.
Poznámka:
Ignorování výzvy způsobí, že se zobrazí upozornění, že musíte zadat adresu URL pro přeposílání, takže vyberte Konfigurovat a zadejte adresu URL. Po dokončení tohoto kroku se výzva nezobrazí pro následné operace webhooku, které můžete přidat.
Pokud chcete zobrazit výzvu, otevřete na kořenové úrovni projektu místní nabídku local.settings.json souboru a vyberte Konfigurovat koncový bod přesměrování webhooku. Zobrazí se výzva, abyste mohli zadat adresu URL pro přeposílání.
Visual Studio Code přidá adresu URL pro předávání do souboru local.settings.json v kořenové složce projektu. V objektu
Values
se teď zobrazí vlastnost s názvemWorkflows.WebhookRedirectHostUri
a je nastavená na adresu URL pro předávání, například:{ "IsEncrypted": false, "Values": { "AzureWebJobsStorage": "UseDevelopmentStorage=true", "FUNCTIONS_WORKER_RUNTIME": "dotnet", "FUNCTIONS_V2_COMPATIBILITY_MODE": "true", <...> "Workflows.WebhookRedirectHostUri": "http://xxxXXXXxxxXXX.ngrok.io", <...> } }
Další informace o těchto nastaveních aplikace najdete v tématu Úprava nastavení aplikace a nastavení hostitele pro standardní aplikace logiky.
Při prvním spuštění místní ladicí relace nebo spuštění pracovního postupu bez ladění zaregistruje modul runtime Azure Logic Apps pracovní postup u volajícího a přihlásí se k odběru koncového bodu volajícího, který poskytuje oznámení pro operace webhook. Při příštím spuštění pracovního postupu se modul runtime neregistruje ani znovu neodpisuje, protože registrace předplatného už v místním úložišti existuje.
Když zastavíte ladicí relaci pro pracovní postup, který používá místně spuštěné operace webhooku, stávající registrace předplatného se neodstraní. Pokud chcete zrušit registraci, musíte registraci předplatného odebrat nebo odstranit ručně.
Poznámka:
Po spuštění pracovního postupu se v okně terminálu můžou zobrazit chyby jako v tomto příkladu:
message='Http request failed with unhandled exception of type 'InvalidOperationException' and message: 'System.InvalidOperationException: Synchronous operations are disallowed. Call ReadAsync or set AllowSynchronousIO to true instead.'
V tomto případě otevřete soubor local.settings.json v kořenové složce projektu a ujistěte se, že je vlastnost nastavená na true
:
"FUNCTIONS_V2_COMPATIBILITY_MODE": "true"
Povolení historie spuštění pro bezstavové pracovní postupy
Pokud chcete ladit bezstavový pracovní postup snadněji, můžete pro tento pracovní postup povolit historii spuštění a po dokončení zakázat historii spuštění. Postupujte podle těchto kroků pro Visual Studio Code nebo pokud pracujete na webu Azure Portal, přečtěte si téma Vytvoření pracovních postupů založených na jednom tenantovi na webu Azure Portal.
V projektu editoru Visual Studio Code otevřete na úrovni kořenové složky soubor local.settings.json .
Workflows.<workflow-name>.operationOptions
Přidejte vlastnost a nastavte hodnotu naWithStatelessRunHistory
, například:Windows
{ "IsEncrypted": false, "Values": { "AzureWebJobsStorage": "UseDevelopmentStorage=true", "FUNCTIONS_WORKER_RUNTIME": "dotnet", "Workflows.<workflow-name>.OperationOptions": "WithStatelessRunHistory" } }
macOS nebo Linux
{ "IsEncrypted": false, "Values": { "AzureWebJobsStorage": "DefaultEndpointsProtocol=https;AccountName=fabrikamstorageacct; \ AccountKey=<access-key>;EndpointSuffix=core.windows.net", "FUNCTIONS_WORKER_RUNTIME": "dotnet", "Workflows.<workflow-name>.OperationOptions": "WithStatelessRunHistory" } }
Ve složce projektu s názvem workflow-designtime otevřete soubor local.settings.json a proveďte stejnou změnu.
Pokud chcete po dokončení zakázat historii spuštění, nastavte
Workflows.<workflow-name>.OperationOptions
vlastnost naNone
hodnotu nebo odstraňte vlastnost a její hodnotu.
Přidání artefaktů a závislostí do projektu
V konkrétních scénářích může pracovní postup zahrnovat operace, které vyžadují závislosti, jako jsou sestavení nebo artefakty, jako jsou mapy, schémata nebo pravidla. V editoru Visual Studio Code můžete tyto položky přidat do odpovídajících složek v projektu, například:
Položka | Typ souboru | Popis |
---|---|---|
Mapy | .xslt | Další informace najdete v tématu Přidání map pro transformace v pracovních postupech. |
Schémata | .xsd | Další informace naleznete v tématu Přidání schémat pro ověření. |
Pravidla | .xml | Další informace najdete v tématu Vytvoření projektu stroje pravidel Azure Logic Apps. |
Shromáždění |
-
.dll (.NET Framework nebo .NET 8) - .jar (Java) |
Prostředek standardní logické aplikace může využívat nebo odkazovat na specifické druhy sestavení, které můžete nahrát do projektu ve Visual Studio Code. Musíte je ale přidat do konkrétních složek projektu. Další informace naleznete v tématu Přidání odkazovaných sestavení. Poznámka: Pokud máte projekt aplikace logiky založené na balíčku NuGet (.NET) před zpřístupněním podpory sestavení, přečtěte si téma Migrace projektů založených na balíčku NuGet pro použití sestavení ve složce lib. |
Převod projektu na balíček NuGet (.NET)
Visual Studio Code ve výchozím nastavení vytvoří projekt aplikace logiky jako projekt založený na sadě rozšíření (Node.js). Pokud potřebujete projekt založený na balíčku NuGet (.NET), například k vytvoření vlastních integrovaných konektorů, musíte výchozí projekt převést na projekt založený na balíčku NuGet (.NET).
Důležité
Tato akce je jednosměrná operace, kterou nelze vrátit zpět.
V podokně Průzkumník přesuňte ukazatel myši na libovolnou prázdnou oblast pod složkami a soubory vašeho projektu, otevřete kontextovou nabídku a vyberte Převést na projekt aplikační logiky založený na NuGetu.
Po zobrazení výzvy potvrďte převod projektu.
Migrace projektů založených na balíčcích NuGet pro použití sestavení ve složce lib
Důležité
Tato úloha se vyžaduje pouze pro projekty aplikace logiky založené na balíčku NuGet (.NET), které byly vytvořeny před zpřístupněním podpory sestavení.
Pokud jste projekt aplikace logiky vytvořili v případě, že podpora sestavení nebyla k dispozici pro pracovní postupy standardní aplikace logiky, můžete do <souboru project-name.csproj> přidat následující řádky pro práci s projekty, které používají sestavení:
<ItemGroup>
<LibDirectory Include="$(MSBuildProjectDirectory)\lib\**\*"/>
</ItemGroup>
<Target Name="CopyDynamicLibraries" AfterTargets="_GenerateFunctionsExtensionsMetadataPostPublish">
<Copy SourceFiles="@(LibDirectory)" DestinationFiles="@(LibDirectory->'$(MSBuildProjectDirectory)\$(PublishUrl)\lib\%(RecursiveDir)%(Filename)%(Extension)')"/>
</Target>
Důležité
V případě projektu, který běží na Linuxu nebo macOS, nezapomeňte aktualizovat oddělovač adresářů. Podívejte se například na následující obrázek, který ukazuje předchozí kód přidaný do < souboru project-name.csproj>:
Povolení vytváření integrovaných konektorů
K vytvoření vlastních integrovaných konektorů pro libovolnou službu, kterou potřebujete, můžete použít architekturu rozšiřitelnosti Azure Logic Apps s jedním tenantem. Podobně jako integrované konektory, jako je Azure Service Bus a SQL Server, poskytují tyto konektory vyšší propustnost, nízkou latenci, místní připojení a spouští se nativně ve stejném procesu jako modul runtime Azure Logic Apps s jedním tenantem.
Funkce vytváření je aktuálně dostupná jenom v editoru Visual Studio Code, ale ve výchozím nastavení není povolená. Pokud chcete vytvořit tyto konektory, postupujte takto:
Pokud jste to ještě neudělali, převeďte projekt založený na sadě rozšíření (Node.js) na projekt založený na balíčku NuGet (.NET).
Projděte si a postupujte podle kroků v článku o rozšiřitelnosti integrovaného konektoru pro Azure Logic Apps spuštěné kdekoli.
Místní spouštění, ladění a testování pracovních postupů
Následující části ukazují, jak můžete nastavit body přerušení a zahájit ladicí relaci, abyste mohli svůj pracovní postup spustit a otestovat lokálně.
Nastavení zarážek pro ladění
Než spustíte a otestujete pracovní postup aplikace logiky spuštěním ladicí relace, můžete nastavit zarážky v souboru workflow.json pro každý pracovní postup. Není vyžadováno žádné jiné nastavení.
Body jsou v současné době podporovány jenom pro akce, ne spouštěče. Každá definice akce má tato umístění zarážek:
Nastavte počáteční zarážku na řádku, který zobrazuje název akce. Když se tato zarážka dostane během ladicí relace, můžete před vyhodnocením zkontrolovat vstupy akce.
Nastavte koncovou zarážku na řádku, která zobrazuje pravou složenou složenou závorku akce (}). Když se tato zarážka dostane během ladicí relace, můžete před dokončením akce zkontrolovat výsledky akce.
Pokud chcete přidat zarážku, postupujte takto:
Otevřete soubor workflow.json pracovního postupu, který chcete ladit.
Na řádku, na kterém chcete nastavit zarážku, vyberte v levém sloupci uvnitř daného sloupce. Pokud chcete zarážku odebrat, vyberte tuto zarážku.
Když spustíte ladicí relaci, zobrazí se zobrazení Spustit na levé straně okna kódu, zatímco panel nástrojů Ladění se zobrazí v horní části.
Poznámka:
Pokud se zobrazení Spustit nezobrazí automaticky, stiskněte kombinaci kláves Ctrl+Shift+D.
Pokud chcete zkontrolovat dostupné informace při dosažení zarážky, prozkoumejte v zobrazení Spustit podokno Proměnné .
Pokud chcete pokračovat v provádění pracovního postupu, vyberte na panelu nástrojů Ladění tlačítko Pokračovat (tlačítko Přehrát).
Během spuštění pracovního postupu můžete kdykoli přidat a odebrat zarážky. Pokud ale po spuštění spuštění aktualizujete soubor workflow.json , zarážky se automaticky neaktualizují. Pokud chcete aktualizovat zarážky, restartujte aplikaci logiky.
Obecné informace naleznete v tématu Zarážky – Visual Studio Code.
Ladění a testování pracovního postupu
Pokud chcete otestovat pracovní postup, postupujte podle těchto kroků, spusťte ladicí sezení a najděte adresu URL koncového bodu, který byl vytvořen triggerem Request. Tuto adresu URL budete potřebovat, abyste později mohli odeslat požadavek na tento koncový bod.
Pokud máte bezstavový pracovní postup, povolte pro tento pracovní postup historii spuštění , abyste usnadnili ladění.
V nabídce Spustit vyberte Spustit ladění (F5).
Otevře se okno Terminálu , abyste mohli zkontrolovat ladicí relaci.
Poznámka:
Pokud se zobrazí chyba "Chyba existuje po spuštění preLaunchTask generateDebugSymbols", přečtěte si část řešení potíží, relace ladění se nespustí.
Teď vyhledejte adresu URL zpětného volání pro koncový bod vytvořený triggerem požadavku .
Znovu otevřete podokno Průzkumníka, abyste zobrazili svůj projekt.
V místní nabídce workflow.json souboru vyberte Přehled.
Zkopírujte a uložte adresu URL zpětného volání, která vypadá podobně jako následující adresa URL pro trigger Při přijetí požadavku HTTP v tomto příkladu:
http://localhost:7071/api/<workflow-name>/triggers/manual/invoke?api-version=2020-05-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=<shared-access-signature>
Pokud chcete otestovat adresu URL zpětného volání a aktivovat pracovní postup, odešlete na adresu URL požadavek HTTP, včetně metody, kterou trigger očekává, pomocí nástroje pro požadavek HTTP a jeho pokynů.
Tento příklad používá metodu GET s zkopírovanou adresou URL, která vypadá jako v následující ukázce:
GET http://localhost:7071/api/Stateful-Workflow/triggers/manual/invoke?api-version=2020-05-01&sp=%2Ftriggers%2Fmanual%2Frun&sv=1.0&sig=<shared-access-signature>
Když se trigger aktivuje, spustí se ukázkový pracovní postup a odešle e-mail podobný tomuto příkladu:
V editoru Visual Studio Code se vraťte na stránku s přehledem pracovního postupu. V části Historie spuštění zkontrolujte stav spuštění pracovního postupu.
Návod
Pokud se stav spuštění nezobrazí, zkuste aktualizovat stránku přehledu výběrem možnosti Aktualizovat. Spuštění neproběhne u triggeru, který se přeskočí kvůli nesplněným kritériím nebo nenalezení žádných dat.
V následující tabulce jsou uvedeny možné konečné stavy, které může mít každý spuštění pracovního postupu a zobrazit v editoru Visual Studio Code:
Stav spuštění Popis přerušené Spuštění se zastavilo nebo nedokončilo kvůli externím problémům, jako je například výpadek systému nebo ukončené předplatné Azure. zrušeno Spuštění se aktivovalo a spustilo, ale obdrželo se žádost o zrušení. Neúspěch Nejméně jedna akce ve spuštění selhala. Nebyly nastaveny žádné další akce v pracovním postupu pro zpracování selhání. Běží Spuštění se aktivovalo a probíhá, ale tento stav se může zobrazit také pro spuštění, které je omezené kvůli limitům akcí nebo aktuálnímu cenovému plánu.
Tip: Pokud nastavíte protokolování diagnostiky, můžete získat informace o všech událostech omezování, ke kterým dochází.Uspěl Spuštění proběhlo úspěšně. Pokud nějaká akce selhala, následující akce v pracovním postupu toto selhání zvládla. Vypršel čas Časový limit běhu vypršel, protože aktuální doba trvání překročila limit doby trvání spuštění, který je řízen nastavením s názvem Uchování historie spuštění ve dnech. Doba trvání běhu se počítá pomocí času spuštění a doby trvání spuštění v daném čase spuštění. Poznámka: Pokud doba trvání spuštění také překračuje aktuální limit uchovávání historie spuštění, který je také řízen uchováváním historie spuštění v nastavení dnů, je spuštění vymazáno z historie spuštění pomocí každodenní úlohy čištění. Ať už časový limit časového limitu běhu nebo dokončení, se doba uchovávání vždy počítá pomocí času spuštění a aktuálního limitu uchovávání. Pokud tedy limit doby trvání běhu v letu zkrátíte, vyprší časový limit běhu. Spuštění však zůstane nebo se vymaže z historie spuštění na základě toho, jestli doba trvání spuštění překročila limit uchovávání.
Čekání Spuštění se nespustí nebo se pozastaví, například kvůli dřívější instanci pracovního postupu, která je stále spuštěná. Pokud chcete zobrazit stav, vstupy a výstupy jednotlivých kroků pro konkrétní spuštění pracovního postupu, zvolte jeden z těchto kroků:
Ve sloupci Identifikátor vyberte ID spuštění pracovního postupu.
Vedle sloupce Doba trvání otevřete nabídku se třemi tečkami (...) pro spuštění pracovního postupu a vyberte Zobrazit spuštění, například:
Visual Studio Code otevře zobrazení podrobností o spuštění a zobrazí stav každého kroku spuštění pracovního postupu.
Poznámka:
Pokud spuštění selhalo a v zobrazení podrobností o spuštění se zobrazí chyba 400 Chybný požadavek , může tento problém vést k delšímu názvu triggeru nebo názvu akce, který způsobí, že základní identifikátor URI (Uniform Resource Identifier) překročí výchozí limit znaků. Další informace najdete v tématu 400 Chybný požadavek.
Následující tabulka uvádí možné stavy, které můžou mít jednotlivé akce pracovního postupu a zobrazit v editoru Visual Studio Code:
Stav akce Popis přerušené Akce se zastavila nebo nedokončila kvůli externím problémům, například kvůli výpadku systému nebo výpadku předplatného Azure. zrušeno Akce byla spuštěna, ale přijala žádost o zrušení. Neúspěch Akce se nezdařila. Běží Akce je aktuálně spuštěná. Přeskočeno Akce byla přeskočena, protože bezprostředně před akcí se nezdařila. Akce má podmínku runAfter
, která vyžaduje, aby předchozí akce byla úspěšně dokončena před spuštěním aktuální akce.Uspěl Akce byla úspěšná. Úspěšné s opakováním Akce byla úspěšná, ale pouze po jednom nebo několika opakováních. Pokud chcete zkontrolovat historii opakování, vyberte v zobrazení podrobností historie spuštění tuto akci, abyste mohli zobrazit vstupy a výstupy. Vypršel čas Akce se zastavila kvůli limitu časového limitu určeného nastavením dané akce. Čekání Platí pro akci webhooku, která čeká na příchozí požadavek od volajícího. Pokud chcete zobrazit vstupy a výstupy pro každý krok, vyberte požadovaný krok, například:
Pokud chcete zobrazit nezpracované vstupy a výstupy, vyberte Zobrazit nezpracované vstupy nebo Zobrazit nezpracované výstupy.
Pokud chcete zastavit ladicí relaci, vyberte v nabídce Spustit možnost Zastavit ladění (Shift + F5).
Vrácení odpovědi
Pokud máte pracovní postup, který začíná triggerem Při přijetí požadavku HTTP, může váš pracovní postup vrátit odpověď volajícímu, který odeslal počáteční požadavek pomocí akce Požadavek s názvem Odpověď.
V návrháři pracovního postupu v rámci akce Odeslat e-mailpostupujte podle těchto obecných kroků a přidejte akci Požadavek s názvem Odpověď.
V informačním podokně akce Odpovědi na kartě Parametry zadejte požadované informace pro odpověď volajícímu.
Tento příklad vrátí hodnotu parametru Body , což je výstup z akce Odeslat e-mail .
U parametru Text vyberte uvnitř pole pro úpravy a vyberte ikonu blesku, která otevře seznam dynamického obsahu. Tento seznam zobrazuje dostupné výstupní hodnoty z předchozího triggeru a akcí v pracovním postupu.
V seznamu dynamického obsahu v části Odeslat e-mail vyberte Text.
Až budete hotovi, je vlastnost Tělo akce Odpovědi nyní nastavena na hodnotu výstupu Těla akce Odeslat e-mail, například:
Uložte pracovní postup.
Opětovné otestování pracovního postupu
Pokud chcete otestovat aktualizace, můžete znovu spustit ladicí program a odeslat další požadavek, který aktivuje váš pracovní postup, podobně jako v krocích v místně spuštěných, ladicích a testovacích pracovních postupech.
Na panelu nástrojů Visual Studio Code v nabídce Spustit a vyberte Spustit ladění (F5).
V nástroji pro vytváření a odesílání požadavků odešlete další požadavek, který aktivuje váš pracovní postup.
Na stránce přehledu pracovního postupu v části Historie spuštění zkontrolujte stav posledního spuštění a otevřete zobrazení podrobností o spuštění.
Například zde je krok za krokem stav pro spuštění poté, co byl ukázkový pracovní postup aktualizován akcí Odpověď.
Pokud chcete zastavit ladicí relaci, vyberte v nabídce Spustit možnost Zastavit ladění (Shift + F5).
Příprava na nasazení
Než nasadíte aplikaci logiky Standard na web Azure Portal, projděte si tuto část o všech přípravách, které možná budete muset provést.
Nastavit přístup k bráně firewall
Pokud vaše prostředí má přísné požadavky na síť nebo brány firewall, které omezují provoz, musíte nastavit oprávnění pro všechna připojení vytvořená spravovanými, hostovanými a sdílenými konektory Azure a použitá ve vašem pracovním postupu.
Pokud chcete najít plně kvalifikované názvy domén (FQDN) pro tato připojení, postupujte takto:
V projektu aplikace logiky otevřete soubor local.settings.json .
Pro každé vytvořené připojení vyhledejte vlastnost s názvem
<connection-name>-ConnectionRuntimeUrl
, která používá následující syntaxi:"<connection-name>-ConnectionRuntimeUrl": <connection-runtime-URL>
Předpokládejme například, že máte ukázkový souborlocal.settings.json , který obsahuje tato připojení: připojení Office 365 a připojení AS2. Tato připojení používají následující ukázkové hodnoty pro příslušné vlastnosti
<connection-name>-ConnectionRuntimeUrl
:Office 365:
"office365-ConnectionRuntimeUrl": https://A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u.00.common.logic-<Azure-region>.azure-apihub.net/apim/office365/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1"
AS2:
"as2-ConnectionRuntimeUrl": https://A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u.00.common.logic-<Azure-region>.azure-apihub.net/apim/as2/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2
Ukázkový soubor local.settings.json vypadá podobně jako následující verze:
{ "IsEncrypted": false, "Values": { "AzureWebJobsStorage": "UseDevelopmentStorage=true", "FUNCTIONS_WORKER_RUNTIME": "node", "APP_KIND": "workflowapp", "ProjectDirectoryPath": "c:\\Users\\<local-username>\\Desktop\\Visual Studio Code projects\\Azure Logic Apps\fabrikam-workflows\\Fabrikam-Workflows\\Fabrikam-Workflows", "WORKFLOWS_TENANT_ID": "<Microsoft-Entra-tenant-ID>", "WORKFLOWS_SUBSCRIPTION_ID": "<Azure-subscription-ID>", "WORKFLOWS_RESOURCE_GROUP_NAME": "Fabrikam-Workflows-RG", "WORKFLOWS_LOCATION_NAME": "westcentralus", "WORKFLOWS_MANAGEMENT_BASE_URI": "https://management.azure.com/", "as2-connectionKey": "<connection-key>", "as2-ConnectionRuntimeUrl": "https://A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u.00.common.logic-<Azure-region>.azure-apihub.net/apim/as2/b1b1b1b1-cccc-dddd-eeee-f2f2f2f2f2f2", "office365-connectionKey": "<connection-key>", "office365-ConnectionRuntimeUrl": "https://A1bC2dE3fH4iJ5kL6mN7oP8qR9sT0u.00.common.logic-<Azure-region>.azure-apihub.net/apim/office365/a0a0a0a0-bbbb-cccc-dddd-e1e1e1e1e1e1", } }
Zkopírujte a uložte tyto runtime adresy URL připojení na bezpečné místo, abyste mohli nastavit bránu firewall pomocí těchto informací.
Až budete připraveni, nastavte bránu firewall pomocí uložených adres URL. Další informace najdete v následující dokumentaci:
Nasazení do Azure
Pokud chcete nasadit aplikaci logiky Standard z editoru Visual Studio Code, můžete projekt publikovat přímo do Azure. Aplikaci logiky můžete publikovat jako nový prostředek, který automaticky vytvoří všechny požadované prostředky, jako je účet úložiště Azure, podobně jako požadavky aplikace funkcí. Nebo můžete aplikaci logiky publikovat do dříve nasazeného prostředku aplikace logiky Standard, který přepíše nasazenou verzi.
Nasazení pro prostředek aplikace logiky Standard vyžaduje plán hostování a cenovou úroveň, kterou vyberete během nasazení. Další informace najdete v tématu Plány hostování a cenové úrovně.
Publikování do nového prostředku aplikace logiky Standard
V podokně Průzkumníka umístěte ukazatel myši na libovolnou prázdnou oblast pod složkami a soubory vašeho projektu, otevřete místní nabídku a vyberte Nasadit do logické aplikace.
I když k nasazení nemusíte mít otevřené žádné soubory, ujistěte se, že jste uložili všechno, co plánujete nasadit.
Budete vyzváni k výběru z následujících možností pro cílový prostředek standardní logické aplikace. Můžete vytvořit novou standardní aplikaci logiky nebo vybrat existující nasazenou standardní aplikaci logiky v Azure:
- Vytvoření nové aplikace logiky (Standard) v Azure (rychlé)
- Vytvoření nové aplikace logiky (Standard) v Azure Advanced
- Vyberte z dříve nasazených prostředků aplikace logiky Standard, pokud existují.
U možností nasazení vyberte, jestli chcete vytvořit nebo použít existující prostředek cílové aplikace logiky.
Tento příklad pokračuje vytvořením nové aplikace logiky (Standard) v Azure Advanced.
Pomocí následujícího postupu vytvořte nový prostředek cílové aplikace logiky:
Zadejte globálně jedinečný název cílové aplikace logiky.
V tomto příkladu se používá Fabrikam-Workflows-App.
Jako umístění, kam se má nasadit, vyberte oblast Azure.
V tomto příkladu se používá USA – středozápad.
Pro plán hostování vyberte z následujících možností:
Plán hostování Popis Standardní pracovní postup Nasaďte jako nový prostředek aplikace logiky Standard hostovaný v Azure Logic Apps s jedním tenantem. Hybridní model Nasazení jako standardní logická aplikace hostovaná ve vlastní infrastruktuře.
Poznámka: Před výběrem této možnosti se ujistěte, že jste nastavili potřebnou infrastrukturu. Další informace najdete v tématu Nastavení vlastní infrastruktury pro aplikace logiky standardu pomocí hybridního nasazení.Pro plán služby Windows App Service zvolte jednu z následujících možností:
- Vytvořit nový plán služby App Service
- Vyberte z existujících plánů služby App Service ve vybrané oblasti Azure (pouze plány založené na Windows), pokud existují.
Tento příklad vybere Vytvořit nový plán služby App Service.
Pro nový plán zadejte globálně jedinečný název a vyberte cenovou úroveň.
Tento příklad používá Fabrikam-Workflows-App-Service-Plan, vybere úroveň WS1 Workflow Standard.
Další informace najdete v tématu Plány hostování a cenové úrovně.
Pro cílovou skupinu prostředků Azure vyberte pro zajištění optimálního výkonu stejnou skupinu prostředků jako váš projekt.
Tento příklad používá stejnou dříve vytvořenou skupinu s názvem Fabrikam-Workflows-RG.
Poznámka:
I když můžete vytvořit nebo použít jinou skupinu prostředků, může to mít vliv na výkon. Pokud vytvoříte nebo zvolíte jinou skupinu prostředků, ale zrušíte ji i po zobrazení výzvy k potvrzení, nasazení se zruší.
Pokud chcete účet úložiště Azure používat s pracovními postupy, které umožňují ukládání informací historie spuštění, zvolte z následujících možností:
- Vytvoření nového účtu úložiště
- V případě potřeby vyberte z existujících účtů úložiště Azure.
Tento příklad vybere Vytvořit nový účet úložiště.
Zadejte globálně jedinečný název účtu úložiště. Můžete použít jenom malá písmena a číslice.
V tomto příkladu se používá fabrikamstorageaccount<číslo>.
Možnost použít úložiště SQL v tomto příkladu vyberte Ne.
Pokud jste už nastavili databázi SQL tak, aby se používala pro úložiště pomocí následujícího nastavení úložiště databáze SQL pro pracovní postupy aplikace logiky Standard, můžete vybrat Ano.
Pro prostředek Application Insights, který umožňuje diagnostické protokolování a trasování pro vaši logickou aplikaci, zvolte z následujících možností:
- Vytvoření nového prostředku Application Insights
- Prozatím přeskočte. Application Insights můžete nastavit po nasazení.
- Vyberte existující prostředek Application Insights, pokud existuje.
Tento příklad vybere 'Přeskočit prozatím'.
Poznámka:
Pokud máte prostředek Application Insights, který chcete použít, můžete tento prostředek vybrat.
Pokud chcete v tuto chvíli vytvořit nový prostředek Application Insights, abyste mohli povolit protokolování a trasování diagnostiky, přečtěte si téma Povolení Application Insights během nasazování.
Další informace o Application Insights najdete v následující dokumentaci:
- Přehled Application Insights
- Vytvoření a konfigurace prostředků Application Insights
Jakmile vyberete Přeskočit prozatím nebo existující prostředek Application Insights, Visual Studio Code zobrazí potvrzovací zprávu pro zahájení nasazení. Zpráva také doporučuje, abyste pro dosažení nejlepšího výkonu vložili připojovací prostředky pro spravované operace do stejné skupiny prostředků jako váš Logic App a pracovní postupy Logic App. Ve službě Azure Logic Apps jsou připojení ke spravovaným operacím jednotlivými prostředky Azure.
Až budete připraveni k nasazení, v potvrzovací zprávě vyberte Nasadit.
Visual Studio Code začne vytvářet a nasazovat potřebné prostředky pro publikování aplikace logiky do Azure.
Pokud chcete zobrazit a monitorovat proces nasazení, vyberte v nabídce Zobrazitvýstup.
Na panelu nástrojů okna Výstup v seznamu oborů vyberte Azure Logic Apps (Standard).
Když Visual Studio Code dokončí nasazení aplikace logiky do Azure, zobrazí se zpráva, že vytvoření aplikace logiky bylo úspěšně dokončeno, například:
Váš prostředek a pracovní postup aplikace logiky jsou teď aktivní, povolené a spuštěné v Azure.
Povolení Application Insights během nasazování
Pokud chcete povolit protokolování diagnostiky a trasování pomocí Application Insights během nasazování pro vaši aplikaci logiky, postupujte takto:
Vyberte existující prostředek Application Insights nebo vytvořte nový prostředek Application Insights.
Na webu Azure Portal přejděte k prostředku Application Insights.
V nabídce prostředků vyberte Přehled. Vyhledejte a zkopírujte hodnotu instrumentačního klíče .
V editoru Visual Studio Code otevřete v kořenové složce projektu soubor local.settings.json .
V objektu
Values
APPINSIGHTS_INSTRUMENTATIONKEY
přidejte vlastnost a nastavte hodnotu na instrumentační klíč, například:{ "IsEncrypted": false, "Values": { "AzureWebJobsStorage": "UseDevelopmentStorage=true", "FUNCTIONS_WORKER_RUNTIME": "dotnet", "APPINSIGHTS_INSTRUMENTATIONKEY": <instrumentation-key> } }
Zkontrolujte, jestli se v instanci Application Insights správně zobrazí názvy triggerů a akcí pracovního postupu.
Na webu Azure Portal přejděte k prostředku Application Insights.
V nabídce prostředků v části Prozkoumat vyberte Mapování aplikace.
Zkontrolujte názvy operací, které se zobrazují v mapě.
Některé příchozí požadavky z předdefinovaných triggerů se můžou v mapě aplikace zobrazit jako duplicitní. Místo použití
WorkflowName.ActionName
formátu tyto duplikáty používají název pracovního postupu jako název operace a pocházejí z hostitele Azure Functions.
Volitelně můžete upravit úroveň závažnosti dat trasování, která vaše aplikace logiky shromažďuje a odesílá do instance Application Insights.
Pokaždé, když dojde k události související s pracovním postupem, například při aktivaci pracovního postupu nebo při spuštění akce, modul runtime generuje různé trasování. Tyto trasování pokrývají životnost pracovního postupu a zahrnují, ale nejsou omezené na následující typy událostí:
- Aktivita služby, jako je spuštění, zastavení a chyby.
- Úlohy a aktivita dispečera
- Aktivita pracovního postupu, například aktivační událost, akce a spuštění
- Aktivita žádosti o úložiště, jako je úspěch nebo selhání
- Aktivita požadavku HTTP, například příchozí, odchozí, úspěšná a neúspěšná.
- Jakékoli trasování vývoje, například ladicí zprávy.
Každý typ události je přiřazen k úrovni závažnosti. Úroveň
Trace
například zachycuje nejpodrobnější zprávy, zatímcoInformation
úroveň zaznamenává obecnou aktivitu v pracovním postupu, například když se spustí a zastaví aplikace logiky, pracovní postup, trigger a akce.Následující tabulka popisuje úrovně závažnosti a jejich typy stop:
Úroveň závažnosti Typ trasování Kritická Protokoly, které popisují neopravitelné selhání v pracovním postupu aplikace logiky. Ladění Protokoly, které můžete použít k prošetření během vývoje, například příchozí a odchozí volání HTTP. Chyba Protokoly, které označují selhání při provádění pracovního postupu, ale ne obecnou chybu v aplikaci logiky. Informace Protokoly, které sledují obecnou aktivitu v aplikaci logiky nebo pracovním postupu, například:
– Když se trigger, akce nebo spuštění spustí a skončí.
– Když se aplikace logiky spustí nebo skončí.Trasování Protokoly, které obsahují nejpodrobnější zprávy, například požadavky na úložiště nebo aktivitu dispečera a všechny zprávy, které souvisejí s aktivitou provádění pracovního postupu. Upozornění Protokoly, které v aplikaci logiky zvýrazňují neobvyklý stav, ale nezabrání jeho spuštění. Pokud chcete nastavit úroveň závažnosti, otevřete na kořenové úrovni projektu soubor host.json a vyhledejte
logging
objekt. Tento objekt řídí filtrování protokolů pro všechny pracovní postupy v aplikaci logiky a řídí se rozložením ASP.NET Core pro filtrování typu protokolu.{ "version": "2.0", "logging": { "applicationInsights": { "samplingExcludedTypes": "Request", "samplingSettings": { "isEnabled": true } } } }
logging
Pokud objekt neobsahujelogLevel
objekt, který obsahujeHost.Triggers.Workflow
vlastnost, přidejte tyto položky. Nastavte vlastnost na úroveň závažnosti požadovaného typu trasování, například:{ "version": "2.0", "logging": { "applicationInsights": { "samplingExcludedTypes": "Request", "samplingSettings": { "isEnabled": true } }, "logLevel": { "Host.Triggers.Workflow": "Information" } } }
Úlohy po nasazení
Následující části popisují úlohy, které se mají provést po dokončení nasazení aplikace logiky.
Potvrzení nasazení na webu Azure Portal
Po nasazení aplikace logiky z editoru Visual Studio Code na web Azure Portal ověřte, že se vaše aplikace logiky zobrazí na portálu. Prostředky Azure jsou uspořádané a seskupené na portálu podle jejich typu prostředku. Pokud chcete najít standardní aplikace logiky, postupujte takto:
Přihlaste se k webu Azure Portal pomocí svého účtu Azure.
Do vyhledávacího pole názvu Azure zadejte název aplikace logiky, který by se měl zobrazit jako výsledek v části Prostředky . Vyberte aplikaci logiky a otevřete prostředek.
V nabídce aplikace logiky v části Pracovní postupy vyberte Pracovní postupy.
Na stránce Pracovní postupy vyberte svůj pracovní postup.
V nabídce pracovního postupu v části Nástroje vyberte Návrhář. Ověřte, že se pracovní postup zobrazuje podle očekávání.
Teď můžete na webu Azure Portal provádět změny tohoto pracovního postupu.
Nezapomeňte povolit prostředí monitorování nasazené aplikace logiky , abyste mohli zobrazit historii spuštění pracovního postupu, vstupy, výstupy a další související informace.
Povolení monitorovacího prostředí pro nasazenou logickou aplikaci
Než budete moct zkontrolovat jakoukoli historii spuštění pracovního postupu, vstupy, výstupy a související informace pro nasazený prostředek standardní aplikace logiky s prostředím monitorování na webu Azure Portal, musíte toto prostředí nejprve povolit u prostředku aplikace logiky.
Na webu Azure Portal otevřete nasazený prostředek aplikace logiky Standard.
V nabídce prostředků, v části API, vyberte CORS.
V podokně CORS v části Povolené zdroje přidejte zástupný znak (*).
Až to budete hotovi, na panelu nástrojů CORS vyberte Uložit.
Povolení nebo otevření Application Insights po nasazení
Během provádění pracovního postupu pracovní postup aplikace logiky generuje telemetrii spolu s dalšími událostmi. Pomocí této telemetrie můžete získat lepší přehled o tom, jak dobře váš pracovní postup běží a jak funguje modul runtime Azure Logic Apps. Application Insights poskytuje možnost povolit protokolování diagnostiky, trasování a monitorování pro vaši aplikaci logiky pomocí telemetrie téměř v reálném čase (živé metriky). Tato funkce vám pomáhá snadněji vyšetřovat chyby a problémy s výkonem, když používáte telemetrická data ke zjišťování problémů, nastavování výstrah a vytváření grafů.
Pokud jste předtím nenastavili Application Insights, můžete tuto funkci povolit na webu Azure Portal po nasazení aplikace logiky z editoru Visual Studio Code. Potřebujete mít prostředek Application Insights v Azure, ale tento prostředek můžete předem vytvořit samostatně nebo když tuto funkci povolíte po nasazení.
Pokud jste dříve nastavili Application Insights během nasazování z editoru Visual Studio Code, stačí otevřít prostředek Application Insights z aplikace logiky na webu Azure Portal.
Povolte Application Insights pro nasazenou logickou aplikaci
Na webu Azure Portal vyhledejte a otevřete nasazenou aplikaci logiky.
V nabídce aplikace logiky v části Monitorování vyberte Application Insights.
Na stránce Application Insights vyberte Zapnout Application Insights.
Po aktualizaci stránky Application Insights vyberte v části Změnit prostředek následující možnosti:
Vytvoření nového prostředku
Azure vytváří prostředky pro Application Insights a pracovní prostor služby Log Analytics pomocí aktuálního předplatného a skupiny prostředků. Pokud chcete použít jiné předplatné a skupinu prostředků, přečtěte si téma Vytvoření nového prostředku Application Insights a pak se vraťte na tuto stránku.
Vlastnictví Popis Nový název prostředku Buď přijměte vygenerovaný název, nebo zadejte jiný název. Umístění Vyberte oblast Azure. Pracovní prostor služby Log Analytics Pokud existuje, vyberte existující pracovní prostor. Jinak se pro vás vytvoří výchozí pracovní prostor. Další informace najdete v přehledu pracovního prostoru služby Log Analytics. Vyberte existující prostředek:
Vyberte předplatné Azure pro prostředek Application Insights.
Vyberte prostředek Application Insights.
Až budete hotovi, v dolní části stránky vyberte Použít.
Otevřete Application Insights z logické aplikace
Na webu Azure Portal vyhledejte a otevřete nasazenou aplikaci logiky.
V nabídce aplikace logiky v části Monitorování vyberte Application Insights.
Na stránce Application Insights vyberte odkaz pro prostředek Application Insights.
Po otevření Application Insights můžete zkontrolovat různé metriky pro vaši aplikaci logiky. Další informace najdete v těchto článcích:
- Azure Logic Apps spuštěné kdekoli – Monitorování pomocí Application Insights – část 1
- Azure Logic Apps spuštěné kdekoli – Monitorování pomocí Application Insights – část 2
Řešení chyb a problémů
Návrhář se neotevře
Při pokusu o otevření návrháře se zobrazí tato chyba : Čas návrhu pracovního postupu nelze spustit. Pokud jste se dříve pokusili otevřít návrháře, ale projekt jste ukončili nebo odstranili, nemusí se sada rozšíření správně stáhnout. Pokud chcete zkontrolovat, jestli je příčinou tento důvod, postupujte takto:
V editoru Visual Studio Code otevřete okno Výstup. V nabídce Zobrazení vyberte Výstup.
V seznamu v záhlaví okna Výstup vyberte Azure Logic Apps (Standard), abyste mohli zkontrolovat výstup z rozšíření, například:
Zkontrolujte výstup a zkontrolujte, jestli se zobrazí tato chybová zpráva:
A host error has occurred during startup operation '<operation-ID>'. System.Private.CoreLib: The file 'C:\Users\<user-name>\AppData\Local\Temp\Functions\ ExtensionBundles\Microsoft.Azure.Functions.ExtensionBundle.Workflows\1.1.7\bin\ DurableTask.AzureStorage.dll' already exists. Value cannot be null. (Parameter 'provider') Application is shutting down... Initialization cancellation requested by runtime. Stopping host... Host shutdown completed.
Pokud chcete tuto chybu vyřešit, odstraňte složku ExtensionBundles v tomto umístění ...\Users\<uživatelské jméno>\AppData\Local\Temp\Functions\ExtensionBundles a zkuste znovu otevřít soubor workflow.json v návrháři.
Ve výběru návrháře pro dříve vytvořené pracovní postupy chybí nové triggery a akce.
Azure Logic Apps s jedním tenantem podporuje integrované akce pro operace funkcí Azure, operace Liquid a operace XML, jako je například ověřování XML a transformace XML. U dříve vytvořených aplikací logiky se však tyto akce nemusí zobrazit ve výběru návrháře, abyste vybrali, pokud Visual Studio Code používá zastaralou verzi sady Microsoft.Azure.Functions.ExtensionBundle.Workflows
rozšíření.
Kromě toho se v nástroji pro výběr návrháře nezobrazují akce a provozní konektory Azure Functions, pokud jste při vytváření aplikace logiky nepovolí nebo vybrali Možnost Použít konektory z Azure. Pokud jste nepovolili konektory nasazené v Azure při vytváření aplikace, můžete je povolit z projektu v editoru Visual Studio Code. Otevřete místní nabídku workflow.json a v Azure vyberte Použít konektory.
Pokud chcete opravit zastaralou sadu, pomocí těchto kroků odstraňte zastaralou sadu, díky které Visual Studio Code automaticky aktualizuje sadu rozšíření na nejnovější verzi.
Poznámka:
Toto řešení se vztahuje pouze na aplikace logiky, které vytvoříte a nasadíte pomocí editoru Visual Studio Code s rozšířením Azure Logic Apps (Standard), nikoli aplikací logiky, které vytvoříte pomocí webu Azure Portal. V návrháři na webu Azure Portal chybí podporované triggery a akce.
Uložte jakoukoli práci, kterou nechcete ztratit, a zavřete Visual Studio Code.
Na počítači přejděte do následující složky, která obsahuje složky s verzemi pro existující sadu:
...\Users\<user-name>\.azure-functions-core-tools\Functions\ExtensionBundles\Microsoft.Azure.Functions.ExtensionBundle.Workflows
Odstraňte složku verze pro starší sadu, například pokud máte složku pro verzi 1.1.3, odstraňte tuto složku.
Teď přejděte do následující složky, která obsahuje složky s verzemi pro požadovaný balíček NuGet:
...\Users\<user-name>\.nuget\packages\microsoft.azure.workflows.webjobs.extension
Odstraňte složku verze pro předchozí balíček.
Znovu otevřete Visual Studio Code, projekt a soubor workflow.json v návrháři.
Chybějící triggery a akce se teď zobrazují v návrháři.
V triggeru nebo akci se zobrazí "400 Chybný požadavek".
Pokud se spuštění nezdaří a zkontrolujete spuštění v zobrazení monitorování, může se tato chyba zobrazit u triggeru nebo akce s delším názvem, což způsobí, že základní identifikátor URI (Uniform Resource Identifier) překročí výchozí limit znaků.
Pokud chcete tento problém vyřešit a upravit delší URI, upravte klíče registru UrlSegmentMaxCount
a UrlSegmentMaxLength
na svém počítači podle následujících kroků. Výchozí hodnoty těchto klíčů jsou popsány v tomto článku Http.sys nastavení registru pro Windows.
Důležité
Než začnete, ujistěte se, že práci uložíte. Toto řešení vyžaduje restartování počítače po dokončení, aby se změny mohly projevit.
Na počítači otevřete okno Spustit a spusťte
regedit
příkaz, který otevře editor registru.V okně Řízení uživatelských účtů vyberte Ano, pokud chcete povolit změny v počítači.
V levém podokně v části Počítač rozbalte uzly podél cesty, HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\HTTP\Parameters a pak vyberte Parametry.
V pravém podokně vyhledejte
UrlSegmentMaxCount
klíče registru aUrlSegmentMaxLength
klíče registru.Zvyšte tyto hodnoty klíče dostatečně, aby identifikátory URI mohly obsahovat názvy, které chcete použít. Pokud tyto klíče neexistují, přidejte je do složky Parametry pomocí následujícího postupu:
V místní nabídce Parametry vyberte Nová>hodnota DWORD (32bitová verze).
Do pole pro úpravy, které se zobrazí, zadejte
UrlSegmentMaxCount
jako název nového klíče.Otevřete místní nabídku nové klávesy a vyberte Upravit.
Do pole Upravit řetězec, které se zobrazí, zadejte hodnotu datového klíče hodnoty, kterou chcete použít v šestnáctkovém nebo desítkovém formátu. Například
400
v šestnáctkové soustavě odpovídá1024
desítkové soustavě.Pokud chcete přidat
UrlSegmentMaxLength
hodnotu klíče, opakujte tyto kroky.
Po zvýšení nebo přidání těchto hodnot klíčů vypadá editor registru jako v tomto příkladu:
Až budete připraveni, restartujte počítač, aby se změny mohly projevit.
Ladicí relace se nespustí
Při pokusu o spuštění ladicí relace se zobrazí chyba "Chyba existuje po spuštění preLaunchTask generateDebugSymbols". Pokud chcete tento problém vyřešit, upravte soubor tasks.json v projektu a přeskočte generování symbolů.
V projektu rozbalte složku.vscode** a otevřete soubor tasks.json .
V následujícím úkolu odstraňte řádek spolu s čárkou,
"dependsOn: "generateDebugSymbols"
která končí předchozí řádek, například:Před:
{ "type": "func", "command": "host start", "problemMatcher": "$func-watch", "isBackground": true, "dependsOn": "generateDebugSymbols" }
Po:
{ "type": "func", "command": "host start", "problemMatcher": "$func-watch", "isBackground": true }