Share via


Standard logikaialkalmazás-munkafolyamat létrehozása egybérlős Azure Logic Appsben a Visual Studio Code használatával

A következőkre vonatkozik: Azure Logic Apps (Standard)

Ez az útmutató bemutatja, hogyan hozhat létre egy példaintegrációs munkafolyamatot, amely egybérlős Azure Logic Appsben fut a Visual Studio Code és az Azure Logic Apps (Standard) bővítmény használatával. A munkafolyamat létrehozása előtt létre fog hozni egy standard logikai alkalmazáserőforrást, amely a következő képességeket biztosítja:

  • A logikai alkalmazás több állapotalapú és állapot nélküli munkafolyamatot is tartalmazhat.

  • Az ugyanabban a logikai alkalmazásban és bérlőben lévő munkafolyamatok ugyanabban a folyamatban futnak, mint az Azure Logic Apps-futtatókörnyezet, így ugyanazokat az erőforrásokat használják, és jobb teljesítményt nyújtanak.

  • A Visual Studio Code fejlesztői környezetével helyileg hozhat létre, futtathat és tesztelhet munkafolyamatokat.

    Ha elkészült, üzembe helyezheti a logikai alkalmazást az Azure-ban, ahol a munkafolyamat az egybérlős Azure Logic Apps-környezetben vagy az App Service Environment v3-ban futtatható (csak Windows-alapú App Service-csomagokban). A munkafolyamatot bárhol üzembe helyezheti és futtathatja, amelyet a Kubernetes futtathat, beleértve az Azure-t, az Azure Kubernetes Service-t, a helyszínen vagy akár más felhőszolgáltatókat is az Azure Logic Apps tárolóalapú futtatókörnyezete miatt.

    Feljegyzés

    A logikai alkalmazás Kubernetes-fürtön való üzembe helyezése jelenleg nyilvános előzetes verzióban érhető el.

    Az egybérlős Azure Logic Apps szolgáltatással kapcsolatos további információkért tekintse át az egybérlős és a több-bérlős és integrációs szolgáltatási környezetet.

Bár a példa-munkafolyamat felhőalapú, és csak két lépésből áll, több száz műveletből hozhat létre munkafolyamatokat, amelyek számos alkalmazást, adatot, szolgáltatást és rendszert csatlakoztathatnak a felhőben, a helyszínen és a hibrid környezetekben. A példa munkafolyamat a beépített Kérelem eseményindítóval kezdődik, és egy Office 365 Outlook-művelettel követi. Az eseményindító létrehoz egy hívható végpontot a munkafolyamathoz, és vár egy bejövő HTTPS-kérésre bármely hívótól. Amikor az eseményindító kérést kap, és aktiválódik, a következő művelet úgy fut, hogy e-mailt küld a megadott e-mail-címre az eseményindító kiválasztott kimeneteivel együtt.

Tipp.

Ha nem rendelkezik Office 365-fiókkal, bármely más elérhető műveletet használhat, amely üzeneteket küldhet az e-mail-fiókjából, például Outlook.com.

Ha inkább az Azure Portal használatával szeretné létrehozni ezt a példa-munkafolyamatot, kövesse az integrációs munkafolyamatok létrehozása az egyetlen bérlős Azure Logic Apps és az Azure Portal használatával című szakasz lépéseit. Mindkét lehetőség lehetővé teszi a logikai alkalmazás munkafolyamatainak fejlesztését, futtatását és üzembe helyezését azonos típusú környezetekben. A Visual Studio Code használatával azonban helyileg fejleszthet, tesztelhet és futtathat munkafolyamatokat a fejlesztői környezetben.

Képernyőkép a Visual Studio Code-ról, a logikai alkalmazás projektről és a munkafolyamatról.

A folyamat előrehaladtával a következő magas szintű feladatokat fogja elvégezni:

  • Hozzon létre egy projektet a logikai alkalmazáshoz és egy üres állapotalapú munkafolyamatot.
  • Adjon hozzá egy eseményindítót és egy műveletet.
  • Futtatási előzmények helyi futtatása, tesztelése, hibakeresése és áttekintése.
  • Keresse meg a tartománynév részleteit a tűzfalhoz való hozzáféréshez.
  • Üzembe helyezés az Azure-ban, amely magában foglalja az alkalmazás Elemzések opcionális engedélyezését is.
  • Az üzembe helyezett logikai alkalmazás kezelése a Visual Studio Code-ban és az Azure Portalon.
  • Állapot nélküli munkafolyamatok futtatási előzményeinek engedélyezése.
  • Az alkalmazás Elemzések engedélyezése vagy megnyitása az üzembe helyezés után.

Előfeltételek

Hozzáférés és kapcsolat

  • Ha standard logikai alkalmazásprojekteket tervez helyileg létrehozni, és munkafolyamatokat csak az Azure Logic Apps-futtatókörnyezetben natív módon futó beépített összekötőkkel kíván futtatni, akkor nincs szükség a következő követelményekre. Győződjön meg azonban arról, hogy rendelkezik a következő kapcsolati és Azure-fiók hitelesítő adatokkal a projekt Visual Studio Code-ból az Azure-ba való közzétételéhez vagy üzembe helyezéséhez, használja a globális Azure-ban futó felügyelt összekötőket , vagy hozzáférjen az Azure-ban már üzembe helyezett standard logikai alkalmazás erőforrásaihoz és munkafolyamataihoz:

    • Az internethez való hozzáféréssel letöltheti a követelményeket, csatlakozhat a Visual Studio Code-ból az Azure-fiókjához, és közzéteheti a Visual Studio Code-ból az Azure-ba.

    • Azure-fiók és -előfizetés. Ha még nincs előfizetése, regisztráljon egy ingyenes Azure-fiókra.

  • A cikkben szereplő példamunkafolyamat létrehozásához olyan Office 365 Outlook-e-mail fiókra van szüksége, amely Microsoft munkahelyi vagy iskolai fiókot használ a bejelentkezéshez.

    Ha másik e-mail-összekötőt választ, például Outlook.com, akkor is követheti a példát, és az általános általános lépések ugyanazok. A beállítások azonban bizonyos szempontból eltérhetnek. Ha például a Outlook.com összekötőt használja, a személyes Microsoft-fiókjával jelentkezzen be.

Eszközök

  1. Töltse le és telepítse az ingyenes Visual Studio Code-ot.

  2. Töltse le és telepítse a Visual Studio Code-hoz készült Azure-fiókbővítményt, hogy egyetlen közös felhasználói élményben legyen része az Azure-bejelentkezéshez és az előfizetések szűréséhez a Visual Studio Code összes Azure-bővítményében. Ez az útmutató az ezt a felületet használó lépéseket tartalmazza.

  3. Töltse le és telepítse az adott operációs rendszer következő Visual Studio Code-függőségeit bármelyik módszerrel:

    Az összes függőség automatikus telepítése (előzetes verzió)

    Fontos

    Ez a funkció előzetes verzióban érhető el, és a Microsoft Azure előzetes verziójának kiegészítő használati feltételei vonatkoznak.

    A Visual Studio Code Azure Logic Apps (Standard) bővítménye a 2.81.5-ös verziótól kezdve tartalmaz egy függőség-telepítőt, amely automatikusan telepíti az összes szükséges függőséget egy új bináris mappába, és a meglévő függőségeket változatlanul hagyja. További információ: Ismerkedés a Visual Studio Code Azure Logic Apps (Standard) bővítményével.

    Ez a bővítmény a következő függőségeket tartalmazza:

    Dependency Leírás
    C# a Visual Studio Code-hoz Engedélyezi az F5-funkciók számára a munkafolyamat futtatását.
    Azurite for Visual Studio Code Helyi adattárat és emulátort biztosít a Visual Studio Code-hoz, így dolgozhat a logikai alkalmazás projektjén, és futtathatja a munkafolyamatokat a helyi fejlesztési környezetben. Ha nem szeretné, hogy az Azurite automatikusan elinduljon, letilthatja ezt a beállítást:

    1. A Fájl menüben válassza a Beállítások> Gépház lehetőséget.

    2. A Felhasználó lapon válassza a Bővítmények>Azure Logic Apps (Standard) lehetőséget.

    3. Keresse meg az Azure Logic Apps Standard: Auto Start Azurite beállítást, és törölje a jelet a kijelölt jelölőnégyzetből.
    .NET SDK 6.x.x Tartalmazza a .NET Runtime 6.x.x verziót, amely az Azure Logic Apps (Standard) futtatókörnyezet előfeltétele.
    Azure Functions Core Tools – 4.x verzió Telepíti a verziót az operációs rendszer (Windows, macOS vagy Linux) alapján.

    Ezek az eszközök tartalmazzák ugyanannak a futtatókörnyezetnek a verzióját, amely az Azure Functions-futtatókörnyezetet működteti, amelyet az Azure Logic Apps (Standard) bővítmény használ a Visual Studio Code-ban.
    Node.js 16.x.x verziót, kivéve, ha egy újabb verzió már telepítve van A JavaScriptet futtató beágyazott kódművelet engedélyezéséhez szükséges.

    A telepítő nem hajtja végre a következő feladatokat:

    • Ellenőrizze, hogy a szükséges függőségek már léteznek-e.
    • Csak a hiányzó függőségeket telepítse.
    • A meglévő függőségek régebbi verzióinak frissítése.
    1. Töltse le és telepítse a Visual Studio Code Azure Logic Apps (Standard) bővítményét a 2.81.5-ös verziótól kezdve.

    2. A Visual Studio Code tevékenységsávján válassza a Bővítmények lehetőséget. (Billentyűzet: Nyomja le a Ctrl+Shift+X billentyűkombinációt)

    3. A Bővítmények panelen nyissa meg a három pont (...) menüt, és válassza a Telepítés a VSIX-ből lehetőséget.

    4. Keresse meg és válassza ki a letöltött VSIX-fájlt.

      A telepítés befejezése után a bővítmény automatikusan aktiválja és futtatja a függőségi bináris fájlok ellenőrzése és telepítése parancsot. A folyamatnaplók megtekintéséhez nyissa meg a Kimenet ablakot.

    5. Amikor megjelenik a következő üzenet, válassza az Igen (Ajánlott) lehetőséget a szükséges függőségek automatikus telepítésének megerősítéséhez:

      Képernyőkép a függőségek automatikus telepítésére vonatkozó kérésről.

    6. Szükség esetén töltse be újra a Visual Studio Code-ot.

    7. Győződjön meg arról, hogy a függőségek helyesen jelennek meg a következő mappában:

      C:\Users\<your-user-name>\.azurelogicapps\dependencies\<dependency-name>

    8. Erősítse meg a következő bővítménybeállításokat a Visual Studio Code-ban:

      1. A Fájl menüben válassza a Beállítások> Gépház lehetőséget.

      2. A Felhasználó lapon válassza a Bővítmények>Azure Logic Apps (Standard) lehetőséget.

      3. Tekintse át a következő beállításokat:

        Bővítmény beállítása Érték
        Függőségek elérési útja C:\Users\<your-user-name>\.azurelogicapps\dependencies
        Függőség időtúllépése 60 másodperc
        Dotnet bináris elérési útja C:\Users\<your-user-name>\.azurelogicapps\dependencies\DotNetSDK\dotnet.exe
        Func Core Tools – Bináris elérési út C:\Users\<your-user-name>\.azurelogicapps\dependencies\FuncCoreTools\func
        Node JS bináris elérési útja C:\Users\<your-user-name>\.azurelogicapps\dependencies\NodeJs\node
        Az azurite automatikus indítása Engedélyezve
        Tervezés automatikus kezdési ideje Engedélyezve
    9. Ha rendelkezik olyan logikai alkalmazásprojekttel, amely egyénileg definiált feladatokat tárol a .vscode/tasks.json fájlban, a projekt megnyitása előtt győződjön meg arról, hogy a tasks.json fájlt máshová menti.

      A projekt megnyitásakor a rendszer kérni fogja, hogy frissítse tasks.json fájlt a szükséges függőségek használatára. Ha a folytatás mellett dönt, a bővítmény felülírja a tasks.json fájlt.

    10. A logikai alkalmazásprojekt megnyitásakor a következő értesítések jelennek meg:

      Értesítés Művelet
      Mindig elindítja a háttérben futó tervezési időt? A munkafolyamat-tervező gyorsabb megnyitásához válassza az Igen (Ajánlott) lehetőséget.
      Konfigurálja az Azurite-t, hogy automatikusan elinduljon a projektindításkor? Ha azt szeretné, hogy az Azurite Storage automatikusan elinduljon a projekt megnyitásakor, válassza az AutoStart engedélyezése lehetőséget. A Visual Studio Code tetején, a megjelenő parancsablakban nyomja le az Enter billentyűt az alapértelmezett elérési út elfogadásához:

      C\Users\<your-user-name>\.azurelogicapps\.azurite

    Az előzetes verzió ismert problémái

    • Ha úgy döntött, hogy automatikusan telepíti az összes függőséget egy olyan számítógépre, amely nem rendelkezik a .NET Core SDK egyik verziójával sem, a következő üzenet jelenik meg:

      "A .NET Core SDK nem található: Hiba a dotnet futtatásakor – információ: Hiba: A parancs meghiúsult: dotnet --info 'dotnet nem ismerhető fel belső vagy külső parancsként, működőképes programként vagy kötegelt fájlként. A "dotnet" nem ismerhető fel belső vagy külső parancsként, kezelhető programként vagy kötegelt fájlként. . A .NET Core hibakeresése nem lesz engedélyezve. Győződjön meg arról, hogy a .NET Core SDK telepítve van, és az elérési úton van."

      Ez az üzenet azért jelenik meg, mert a .NET Core-keretrendszer továbbra is telepítve van a bővítmény aktiválásakor. Nyugodtan letilthatja ezt az üzenetet.

      Ha problémát tapasztal egy meglévő logikaialkalmazás-projekt megnyitásával vagy a hibakeresési feladat (tasks.json) elindításával a func-gazdagép indításához, és megjelenik ez az üzenet, kövesse az alábbi lépéseket a probléma megoldásához:

      1. Adja hozzá a dotnet bináris elérési útját a környezeti PATH változóhoz.

        1. A Windows tálcán a keresőmezőbe írja be a környezeti változókat, és válassza a Rendszer környezeti változóinak szerkesztése lehetőséget.

        2. A Rendszer tulajdonságai párbeszédpanel Speciális lapján válassza a Környezeti változók lehetőséget.

        3. A Környezeti változók mezőben, a felhasználói név> listához tartozó <felhasználói változók közül válassza a PATH elemet, majd válassza a Szerkesztés lehetőséget.

        4. Ha a következő érték nem jelenik meg a listában, az Új elemet választva adja hozzá a következő értéket:

          C:\Users\<your-user-name>\.azurelogicapps\dependencies\DotNetSDK

        5. Amikor elkészült, válassza az OK lehetőséget.

      2. Zárja be az összes Visual Studio Code-ablakot, és nyissa meg újra a projektet.

    • Ha problémákat tapasztal a bináris függőségek telepítésével és hitelesítésével, például:

      • Linux-engedélyekkel kapcsolatos problémák
      • A következő hibaüzenet jelenik meg: <A fájl vagy elérési út> nem létezik
      • Az érvényesítés elakad a függőség neve miatt>.<

      Az alábbi lépéseket követve futtassa újra a Bináris függőségek ellenőrzése és telepítése parancsot:

      1. A Nézet menüben válassza a Parancskatalógus lehetőséget.

      2. Amikor megjelenik a parancsablak, adja meg és futtassa a Bináris függőségek ellenőrzése és telepítése parancsot.

    • Ha nincs telepítve a .NET Core 7-es vagy újabb verziója, és megnyit egy Azure Functions-projektet tartalmazó Azure Logic Apps-munkaterületet, a következő üzenetet kapja:

      Hiba történt a(z) [function-name]. csproj projekt betöltésekor. Részletekért tekintse meg a naplót.

      Ez a hiányzó összetevő nincs hatással az Azure Functions-projektre, így nyugodtan figyelmen kívül hagyhatja ezt az üzenetet.

    Az egyes függőségek telepítése külön

    Dependency Leírás
    .NET SDK 6.x.x Tartalmazza a .NET Runtime 6.x.x verziót, amely az Azure Logic Apps (Standard) futtatókörnyezet előfeltétele.
    Azure Functions Core Tools – 4.x verzió - Windows: Használja a Microsoft Installer (MSI) verzióját, amely a func-cli-X.X.XXXX-x*.msikövetkező: .
    - macOS
    - Linux

    Ezek az eszközök tartalmazzák ugyanannak a futtatókörnyezetnek a verzióját, amely az Azure Functions-futtatókörnyezetet működteti, amelyet az Azure Logic Apps (Standard) bővítmény használ a Visual Studio Code-ban.

    Ha a fenti verzióknál korábbi telepítéssel rendelkezik, először távolítsa el azt a verziót, vagy győződjön meg arról, hogy a PATH környezeti változó a letöltött és telepített verzióra mutat.
    Node.js 16.x.x verziót, kivéve, ha egy újabb verzió már telepítve van A JavaScriptet futtató beágyazott kódművelet engedélyezéséhez szükséges.

    Megjegyzés: Windows esetén töltse le az MSI-verziót. Ha ehelyett a ZIP-verziót használja, manuálisan kell elérhetővé tennie Node.js egy PATH környezeti változó használatával az operációs rendszerhez.
  4. Ha már telepítette az Azure Logic Apps (Standard) bővítmény azon verzióját, amely automatikusan telepíti az összes függőséget (előzetes verzió), hagyja ki ezt a lépést. Ellenkező esetben töltse le és telepítse a Visual Studio Code-hoz készült Azure Logic Apps (Standard) bővítményt.

    1. A Visual Studio Code bal oldali eszköztárán válassza a Bővítmények lehetőséget.

    2. A bővítmények keresőmezőjében adja meg az Azure Logic Apps Standardot. A találatok listájában válassza az Azure Logic Apps (Standard)>Install lehetőséget.

      A telepítés befejezése után a bővítmény megjelenik a Bővítmények: Telepített listában.

      Képernyőkép a Visual Studio Code-ról, amelyen telepítve van az Azure Logic Apps (Standard) bővítmény.

      Tipp.

      Ha a bővítmény nem jelenik meg a telepített listában, indítsa újra a Visual Studio Code-ot.

    Jelenleg a Consumption (több-bérlős) és a Standard (egybérlős) bővítmények is telepíthetők egyszerre. A fejlesztési élmények bizonyos szempontból eltérnek egymástól, de az Azure-előfizetés a Standard és a Consumption logikai alkalmazástípusokat is tartalmazhat. A Visual Studio Code-ban az Azure-ablakban megjelenik az Azure-előfizetés összes Azure-ban üzembe helyezett és üzemeltetett logikai alkalmazása, de az alábbi módokon rendszerezi az alkalmazásokat:

    • Logic Apps (Consumption) szakasz: Az előfizetés összes használatalapú logikai alkalmazása.

    • Erőforrások szakasz: Az előfizetés összes standard logikai alkalmazása. Korábban ezek a logikai alkalmazások a Logic Apps (Standard) szakaszban jelentek meg, amely most átkerült az Erőforrások szakaszba.

  5. Ha webhookalapú eseményindítókat és műveleteket, például a beépített HTTP Webhook-eseményindítót szeretne helyileg futtatni a Visual Studio Code-ban, be kell állítania a visszahívási URL-cím továbbítását.

  6. A cikkben szereplő példa-munkafolyamat teszteléséhez olyan eszközre van szüksége, amely hívásokat tud küldeni a Kérés eseményindító által létrehozott végpontra. Ha nem rendelkezik ilyen eszközzel, letöltheti, telepítheti és használhatja a Postman alkalmazást.

  7. Ha olyan beállításokkal hozza létre a logikai alkalmazás erőforrásait, amelyek támogatják az Alkalmazás Elemzések használatát, opcionálisan engedélyezheti a diagnosztikai naplózást és a nyomkövetést a logikai alkalmazás erőforrásához. Ezt a logikai alkalmazás létrehozásakor vagy az üzembe helyezés után is megteheti. Rendelkeznie kell egy Alkalmazás Elemzések-példánysal, de ezt az erőforrást előre, a logikai alkalmazás létrehozásakor vagy az üzembe helyezés után is létrehozhatja.

A Visual Studio Code telepítése

  1. Annak érdekében, hogy az összes bővítmény megfelelően legyen telepítve, töltse be vagy indítsa újra a Visual Studio Code-ot.

  2. Győződjön meg arról, hogy a Visual Studio Code automatikusan megkeresi és telepíti a bővítményfrissítéseket, hogy az összes bővítmény megkapja a legújabb frissítéseket. Ellenkező esetben manuálisan kell eltávolítania az elavult verziót, és telepítenie kell a legújabb verziót.

    1. A Fájl menüben válassza a Beállítások> Gépház lehetőséget.

    2. A Felhasználó lapon válassza a Szolgáltatások>bővítmények lehetőséget.

    3. Győződjön meg arról, hogy az automatikus ellenőrzés Frissítések be van jelölve, és hogy az automatikus frissítés minden bővítményre van állítva.

  3. Győződjön meg arról, hogy az Azure Logic Apps Standard: Project Runtime beállítása az Azure Logic Apps (Standard) bővítményhez ~4-es verzióra van állítva:

    Feljegyzés

    Ez a verzió szükséges a beágyazott kódműveletek használatához.

    1. A Fájl menüben válassza a Beállítások> Gépház lehetőséget.

    2. A Felhasználó lapon nyissa meg az >Azure Logic Apps (Standard) bővítményeket>.

      Itt található például az Azure Logic Apps Standard: Project Runtime beállítás, vagy a keresőmezővel további beállításokat kereshet:

      Képernyőkép az Azure Logic Apps (Standard) bővítmény Visual Studio Code-beállításairól.

Csatlakozás az Azure-fiókhoz

  1. A Visual Studio Code tevékenységsávján válassza az Azure ikont.

    Képernyőkép a Visual Studio Code tevékenységsávról és a kijelölt Azure-ikonról.

  2. Az Azure-ablakban az Erőforrások területen válassza a Bejelentkezés az Azure-ba lehetőséget. Amikor megjelenik a Visual Studio Code hitelesítési oldala, jelentkezzen be az Azure-fiókjával.

    Képernyőkép az Azure-ablakról és az Azure-bejelentkezéshez kijelölt hivatkozásról.

    A bejelentkezés után az Azure-ablakban megjelennek az Azure-fiókhoz társított Azure-előfizetések. Ha a várt előfizetések nem jelennek meg, vagy azt szeretné, hogy a panel csak bizonyos előfizetéseket jelenítsen meg, kövesse az alábbi lépéseket:

    1. Az előfizetések listájában vigye az egérmutatót az első előfizetés mellett, amíg meg nem jelenik az Előfizetések kiválasztása gomb (szűrőikon). Válassza ki a szűrő ikont.

      Képernyőkép az Azure-ablakról előfizetésekkel és a kiválasztott szűrőikonnal.

      Vagy a Visual Studio Code állapotsávjában válassza ki az Azure-fiókját.

    2. Amikor megjelenik egy másik előfizetési lista, jelölje ki a kívánt előfizetéseket, majd győződjön meg arról, hogy az OK gombot választja.

Helyi projekt létrehozása

A logikai alkalmazás létrehozása előtt hozzon létre egy helyi projektet, amely lehetővé teszi a logikai alkalmazás kezelését, futtatását és üzembe helyezését a Visual Studio Code-ból. A mögöttes projekt hasonló egy Azure Functions-projekthez, más néven függvényalkalmazás-projekthez. Ezek a projekttípusok azonban elkülönülnek egymástól, így a logikai alkalmazások és a függvényalkalmazások nem létezhetnek ugyanabban a projektben.

  1. A számítógépen hozzon létre egy üres helyi mappát ahhoz a projekthez, amelyet később a Visual Studio Code-ban fog létrehozni.

  2. A Visual Studio Code-ban zárja be az összes megnyitott mappát.

  3. Az Azure-ablakban, a Munkaterület szakasz eszköztárán, az Azure Logic Apps menüben válassza az Új projekt létrehozása lehetőséget.

    Képernyőkép az Azure-ablak, a Munkaterület eszköztár és az Azure Logic Apps menüjéről, amelyen az Új projekt létrehozása lehetőség van kiválasztva.

  4. Ha a Windows Defender tűzfal arra kéri, hogy adjon hálózati hozzáférést Code.exea Visual Studio Code-hoz, és az Azure Functions Core Toolshoz func.exe, válassza ki a magánhálózatokat, például az otthoni vagy munkahelyi hálózatom>hozzáférésének engedélyezése lehetőséget.

  5. Keresse meg azt a helyet, ahol létrehozta a projektmappát, jelölje ki a mappát, és folytassa a műveletet.

    Képernyőkép a Mappa kijelölése mezőről és az új projektmappáról, amelyen a Kijelölés gomb van kijelölve.

  6. A megjelenő sablonok listájában válassza az Állapotalapú munkafolyamat vagy az Állapot nélküli munkafolyamat lehetőséget. Ez a példa az Állapotalapú munkafolyamat lehetőséget választja.

    Képernyőkép a munkafolyamat-sablonok listájáról, amelyen a Stateful Workflow van kiválasztva.

  7. Adjon nevet a munkafolyamatnak, és nyomja le az Enter billentyűt. Ez a példa a Stateful-Workflow nevet használja.

    Képernyőkép: Új állapotalapú munkafolyamat létrehozása (3/4) mező és munkafolyamat neve, Stateful-Workflow.

    Feljegyzés

    Előfordulhat, hogy egy azureLogicAppsStandard.createNewProject nevű hibaüzenet jelenik meg, amely nem tud írni a Munkaterület Gépház, mert az azureFunctions.suppressProject nem regisztrált konfiguráció. Ha igen, próbálja meg telepíteni a Visual Studio Code Azure Functions-bővítményét közvetlenül a Visual Studio Marketplace-ről vagy a Visual Studio Code-ból.

  8. Ha a Visual Studio Code arra kéri, hogy nyissa meg a projektet az aktuális Visual Studio Code-ban vagy egy új Visual Studio Code-ablakban, válassza a Megnyitás az aktuális ablakban lehetőséget. Ellenkező esetben válassza a Megnyitás új ablakban lehetőséget.

    A Visual Studio Code befejezi a projekt létrehozását.

  9. A Visual Studio tevékenységsávján nyissa meg az Explorer panelt, ha még nem nyitotta meg.

    Az Explorer panelen látható a projekt, amely mostantól automatikusan létrehozott projektfájlokat tartalmaz. A projektnek például van egy mappája, amely a munkafolyamat nevét jeleníti meg. Ebben a mappában a workflow.json fájl tartalmazza a munkafolyamat mögöttes JSON-definícióját.

    Képernyőkép: Explorer panel projektmappával, munkafolyamat-mappával és workflow.json fájllal.

    A Visual Studio Code-ban a logikai alkalmazás projektje a következő típusok egyikével rendelkezik:

    • Bővítménycsomag-alapú (Node.js), amely az alapértelmezett típus
    • NuGet-csomagalapú (.NET), amelyet az alapértelmezett típusból konvertálhat

    Ezek alapján a projekt némileg eltérő mappákat és fájlokat tartalmaz. A NuGet-alapú projektek egy .bin mappát tartalmaznak, amely csomagokat és más kódtárfájlokat tartalmaz. A csomagalapú projektek nem tartalmazzák a .bin mappát és más fájlokat. Bizonyos esetekben egy NuGet-alapú projekt futtatására van szükség az alkalmazás számára, például ha egyéni beépített műveleteket szeretne fejleszteni és futtatni. A projekt NuGet-alapúvá alakításáról további információt a beépített összekötők készítésének engedélyezése című témakörben talál.

    Az alapértelmezett csomagalapú projekt esetében a projekt egy olyan mappával és fájlstruktúrával rendelkezik, amely az alábbi példához hasonló:

    MyBundleBasedLogicAppProjectName
    | .vscode
    | Artifacts
      || Maps 
         ||| MapName1
         ||| ...
      || Schemas
         ||| SchemaName1
         ||| ...
    | WorkflowName1
      || workflow.json
      || ...
    | WorkflowName2
      || workflow.json
      || ...
    | workflow-designtime
    | .funcignore
    | connections.json
    | host.json
    | local.settings.json
    

    A projekt gyökérszintjén a következő fájlokat és mappákat találja más elemekkel:

    Név Mappa vagy fájl Leírás
    .vscode Mappa Visual Studio Code-tal kapcsolatos beállításfájlokat tartalmaz, például extensions.json, launch.json, settings.json és tasks.json fájlokat.
    Leletek Mappa Üzleti (B2B) forgatókönyveket támogató munkafolyamatokban definiált és használt integrációs fiókösszetevőket tartalmaz. A példastruktúra például megfeleltetéseket és sémákat tartalmaz az XML-átalakítási és érvényesítési műveletekhez.
    <WorkflowName> Mappa A WorkflowName mappa minden munkafolyamathoz <tartalmaz egy workflow.json fájlt, amely tartalmazza a munkafolyamat mögöttes JSON-definícióját.>
    munkafolyamat-designtime Mappa Fejlesztési környezethez kapcsolódó beállításfájlokat tartalmaz.
    .funcignore Fájl A telepített Azure Functions Core-eszközökkel kapcsolatos információkat tartalmaz.
    connections.json Fájl A munkafolyamatok által használt felügyelt kapcsolatok és Azure-függvények metaadatait, végpontjait és kulcsait tartalmazza.

    Fontos: Ha különböző kapcsolatokat és függvényeket szeretne használni az egyes környezetekhez, győződjön meg arról, hogy paraméterezi ezt a connections.json fájlt, és frissíti a végpontokat.
    host.json Fájl Futásidejű konfigurációs beállításokat és értékeket tartalmaz, például az egybérlős Azure Logic Apps-platform, a logikai alkalmazások, a munkafolyamatok, az eseményindítók és a műveletek alapértelmezett korlátait. A logikaialkalmazás-projekt gyökérszintjén a host.json metaadatfájl tartalmazza azokat a konfigurációs beállításokat és alapértelmezett értékeket, amelyeket az ugyanazon logikai alkalmazás összes munkafolyamata használ a helyi vagy az Azure-beli futtatás során.

    Megjegyzés: A logikai alkalmazás létrehozásakor a Visual Studio Code létrehoz egy backup host.snapshot.*.json fájlt a tárolóban. Ha törli a logikai alkalmazást, a biztonsági mentési fájl nem törlődik. Ha egy másik logikai alkalmazást hoz létre ugyanazzal a névvel, egy másik pillanatképfájl jön létre. Ugyanahhoz a logikai alkalmazáshoz legfeljebb 10 pillanatképet készíthet. Ha túllépi ezt a korlátot, a következő hibaüzenet jelenik meg:

    Microsoft.Azure.WebJobs.Script.WebHost: Repository has more than 10 non-decryptable secrets backups (host))

    A hiba megoldásához törölje a további pillanatképfájlokat a tárolóból.
    local.settings.json Fájl Alkalmazásbeállításokat, kapcsolati sztring és egyéb beállításokat tartalmaz, amelyeket a munkafolyamatok a helyi futtatás során használnak. Más szóval ezek a beállítások és értékek csak akkor érvényesek, ha a projekteket a helyi fejlesztési környezetben futtatja. Az Azure-ba való üzembe helyezés során a rendszer figyelmen kívül hagyja a fájlt és a beállításokat, és nem tartalmazza az üzembe helyezést.

    Ez a fájl a beállításokat és értékeket helyi környezeti változókként tárolja, amelyeket a helyi fejlesztési eszközök használnak értékekkéntappSettings. Ezeket a környezeti változókat futásidőben és üzembe helyezéskor is meghívhatja és hivatkozhatja az alkalmazásbeállítások és paraméterek használatával.

    Fontos: A local.settings.json fájl tartalmazhat titkos kulcsokat, ezért győződjön meg arról, hogy ezt a fájlt is kizárja a projekt forrásvezérlőjéből.

A projekt átalakítása NuGet-csomagalapúvá (.NET)

Alapértelmezés szerint a Visual Studio Code létrehoz egy logikai alkalmazásprojektet, amely bővítménycsomag-alapú (Node.js), nem NuGet-csomagalapú (.NET). Ha például nuGet-csomagalapú (.NET) logikai alkalmazásprojektre van szüksége a beépített összekötők létrehozásához, a projektet nuGet-csomagalapúra (Node.js) kell konvertálnia.

Fontos

Ez a művelet egy egyirányú művelet, amelyet nem lehet visszavonni.

  1. Az Explorer panelen, a projekt gyökerénél vigye az egérmutatót az összes többi fájl és mappa alatti üres területre, nyissa meg a helyi menüt, és válassza a Konvertálás NuGet-alapú logikai alkalmazásprojektté elemet.

    Képernyőkép az Explorer panelről, amelyen a projekt helyi menüje a projektablak üres területéről nyílik meg.

  2. Amikor megjelenik a kérdés, erősítse meg a projektátalakítást.

Beépített összekötők készítésének engedélyezése

Az egybérlős Azure Logic Apps bővíthetőségi keretrendszer használatával létrehozhat saját beépített összekötőket minden szükséges szolgáltatáshoz. Az olyan beépített összekötőkhöz hasonlóan, mint az Azure Service Bus és az SQL Server, ezek az összekötők nagyobb átviteli sebességet, alacsony késést, helyi kapcsolatot biztosítanak, és natív módon futnak az egybérlős Azure Logic Apps-futtatókörnyezetével megegyező módon.

A szerzői képesség jelenleg csak a Visual Studio Code-ban érhető el, de alapértelmezés szerint nincs engedélyezve. Az összekötők létrehozásához kövesse az alábbi lépéseket:

  1. Ha még nem tette meg, konvertálja a projektet a bővítménycsomag-alapú (Node.js)-ból NuGet-csomagalapúra (.NET)..

  2. Tekintse át és kövesse a cikk lépéseit: Azure Logic Apps Running Anywhere – Beépített összekötő-bővíthetőség.

Egyéni összetevők hozzáadása a projekthez

A logikaialkalmazás-munkafolyamatokban egyes összekötők függőségekkel rendelkeznek az összetevők, például térképek, sémák vagy szerelvények alapján. A Visual Studio Code-ban ezeket az összetevőket feltöltheti a logikai alkalmazás projektjéhez, hasonlóan ahhoz, ahogyan ezeket az összetevőket feltöltheti az Azure Portalon az Összetevők alatti logikai alkalmazás erőforrás menüjében, például:

Képernyőkép az Azure Portal és a Standard logikai alkalmazás erőforrásmenüjről, kiemelt Artifacts szakaszsal.

Térképek hozzáadása a projekthez

Ha térképeket szeretne hozzáadni a projekthez, a projekthierarchiában bontsa> ki az Összetevők Térképek elemet, amely az a mappa, ahová elhelyezheti a térképeket.

Képernyőkép a Visual Studio Code projekthierarchiáról az Összetevők és Térképek kibontott mappákkal.

Sémák hozzáadása a projekthez

Ha sémákat szeretne hozzáadni a projekthez, bontsa ki az Artifacts-sémákat> a projekthierarchiában, amely az a mappa, ahová a sémákat elhelyezheti.

Képernyőkép a Visual Studio Code projekthierarchiájának kibontott Összetevők és Sémák mappáiról.

Szerelvények hozzáadása a projekthez

A standard logikai alkalmazások bizonyos szerelvényeket használhatnak vagy hivatkozhatnak referenciára, amelyeket feltölthet a projektbe a Visual Studio Code-ban. Ezeket azonban hozzá kell adnia a projekt adott mappáihoz. Az alábbi táblázat további információkat tartalmaz az egyes szerelvénytípusokról, és arról, hogy pontosan hol helyezheti el őket a projektben.

Szerelvény típusa Leírás
Ügyfél-/SDK-szerelvény (.NET-keretrendszer) Ez a szerelvénytípus az ügyfél és az egyéni SDK tárolását és üzembe helyezését biztosítja a .NET-keretrendszer. Az SAP beépített összekötője például ezeket a szerelvényeket használja az SAP NCo nem terjeszthető DLL-fájljainak betöltéséhez.

Győződjön meg arról, hogy ezeket a szerelvényeket hozzáadja a következő mappához: \lib\builtinOperationSdks\net472
Ügyfél/SDK-szerelvény (Java) Ez a szerelvénytípus a Java-hoz készült egyéni SDK tárolását és üzembe helyezését biztosítja. A JDBC beépített összekötője például ezeket a JAR-fájlokat használja az egyéni relációs adatbázisok (RDB-k) JDBC-illesztőinek megkereséséhez.

Mindenképpen vegye fel ezeket a szerelvényeket a következő mappába: \lib\builtinOperationSdks\JAR
Egyéni szerelvény (.NET-keretrendszer) Ez a szerelvénytípus egyéni DLL-ek tárolását és üzembe helyezését biztosítja. Az XML-átalakítás művelet például ezeket a szerelvényeket használja az XML-átalakítás során szükséges egyéni átalakítási függvényekhez.

Mindenképpen vegye fel ezeket a szerelvényeket a következő mappába: \lib\custom\net472

Az alábbi képen látható, hogy hová helyezheti az egyes szerelvénytípusokat a projektben:

Képernyőkép a Visual Studio Code-ról, a logikai alkalmazás projektről és a szerelvények feltöltésének helyéről.

További információ a szerelvények azure portalon történő logikai alkalmazás-erőforrásba való feltöltéséről: Hivatkozott szerelvények hozzáadása.

NuGet-alapú projektek migrálása "lib\*" szerelvények használatára

Fontos

Ez a feladat csak NuGet-alapú logikai alkalmazásprojektekhez szükséges.

Ha a logikai alkalmazásprojektet akkor hozta létre, amikor a szerelvények támogatása nem volt elérhető a standard logikai alkalmazás munkafolyamataihoz, a következő sorokat hozzáadhatja a <project-name.csproj> fájlhoz, hogy szerelvényeket használó projekteket használjon:

  <ItemGroup>
    <LibDirectory Include="$(MSBuildProjectDirectory)\lib\**\*"/>
  </ItemGroup>
  <Target Name="CopyDynamicLibraries" AfterTargets="_GenerateFunctionsExtensionsMetadataPostPublish">
    <Copy SourceFiles="@(LibDirectory)" DestinationFiles="@(LibDirectory->'$(MSBuildProjectDirectory)\$(PublishUrl)\lib\%(RecursiveDir)%(Filename)%(Extension)')"/>
  </Target>

Fontos

Linuxon vagy MacOS-en futó projektek esetén mindenképpen frissítse a címtárelválasztót. Tekintse át például az alábbi képet, amely a project-name.csproj> fájlhoz <hozzáadott előző kódot mutatja.

Képernyőkép az áttelepített szerelvényekről és a CSPROJ-fájlban hozzáadott kódról.

A munkafolyamat-definíciós fájl megnyitása a tervezőben

  1. Bontsa ki a munkafolyamat projektmappáját, amely ebben a példában Stateful-Workflow néven szerepel, és nyissa meg a workflow.json fájlt.

  2. Nyissa meg a workflow.json fájl helyi menüjét, és válassza a Megnyitás Tervező lehetőséget.

    Képernyőkép: Explorer panel, workflow.json fájl helyi menüje, és a Megnyitás Tervező kijelölve.

  3. Miután megnyílik az Összekötők engedélyezése az Azure-beli listában, válassza az Azure-ból származó összekötők használata lehetőséget, amely az Azure-ban üzemeltetett és futtatott összes felügyelt vagy "megosztott" összekötőre vonatkozik, szemben a beépített, natív vagy "alkalmazáson belüli" összekötőkkel, amelyek közvetlenül az Azure Logic Apps-futtatókörnyezettel futnak.

    Képernyőkép az Explorer panelről, az Összekötők engedélyezése az Azure-ban nevű lista megnyitásáról, valamint az Azure-ból származó összekötők használatának kiválasztásáról.

    Feljegyzés

    Az állapot nélküli munkafolyamatok jelenleg csak a felügyelt összekötők műveleteittámogatják, az eseményindítókat nem. Bár lehetősége van arra, hogy az Azure-ban engedélyezze az összekötőket az állapot nélküli munkafolyamathoz, a tervező nem jelenít meg olyan felügyelt összekötő-eseményindítókat, amelyeket kiválaszthat.

  4. Miután megnyílik az Előfizetés kiválasztása lista, válassza ki a logikai alkalmazásprojekthez használni kívánt Azure-előfizetést.

    Képernyőkép az Explorer ablaktábla Select subscription és a selected subscription (Előfizetés kiválasztása) nevű listájáról.

  5. Miután megnyílik az erőforráscsoportok listája, válassza az Új erőforráscsoport létrehozása lehetőséget.

    Képernyőkép az Explorer panelről az erőforráscsoportok listájával és az új erőforráscsoport létrehozásához kijelölt beállítással.

  6. Adjon nevet az erőforráscsoportnak, és nyomja le az Enter billentyűt. Ez a példa a Fabrikam-Workflows-RG függvényt használja.

    Képernyőkép az Explorer ablaktábla és az erőforráscsoport neve mezőről.

  7. A helyek listájában válassza ki azt az Azure-régiót, amelyet az erőforráscsoport és az erőforrások létrehozásakor használni szeretne. Ez a példa az USA nyugati középső régióját használja.

    Képernyőkép az Explorer panelről, amelyen a helyek listája és az

    A lépés végrehajtása után a Visual Studio Code megnyitja a munkafolyamat-tervezőt.

    Feljegyzés

    Amikor a Visual Studio Code elindítja a munkafolyamat tervezési ideje API-t, előfordulhat, hogy az indítás néhány másodpercig is eltarthat. Figyelmen kívül hagyhatja ezt az üzenetet, vagy kiválaszthatja az OK gombot.

    Ha a tervező nem nyílik meg, tekintse át a hibaelhárítási szakaszt, Tervező nem nyílik meg.

    A tervező megjelenése után megjelenik az Eseményindító hozzáadása üzenet a tervezőben.

  8. A tervezőben válassza az Eseményindító hozzáadása lehetőséget, amely megnyitja az Eseményindító hozzáadása panelt, és egy katalógust, amely megjeleníti az összes olyan összekötőt, amelynél az eseményindítók kiválaszthatóak.

    Képernyőkép a munkafolyamat-tervezőről, az Eseményindító hozzáadása nevű kijelölt kérdésről, valamint az eseményindítókkal rendelkező összekötők katalógusát.

  9. Ezután adjon hozzá egy eseményindítót és műveleteket a munkafolyamathoz.

Eseményindító és műveletek hozzáadása

Miután megnyitott egy üres munkafolyamatot a tervezőben, megjelenik az Eseményindító hozzáadása üzenet a tervezőben. Most már létrehozhatja a munkafolyamatot egy eseményindító és egy művelet hozzáadásával.

Fontos

Ha webhookalapú eseményindítót vagy műveleteket (például a beépített HTTP Webhook-eseményindítót vagy műveletet) használó munkafolyamatot szeretne helyileg futtatni, engedélyeznie kell ezt a képességet a webhook visszahívási URL-címének továbbításával.

A példában szereplő munkafolyamat a következő eseményindítót és műveleteket használja:

  • A Kérelem beépített összekötő eseményindítója http-kérés fogadásakor, amely bejövő hívásokat vagy kéréseket fogadhat, és létrehoz egy végpontot, amelyet más szolgáltatások vagy logikaialkalmazás-munkafolyamatok meghívhatnak.

  • Az Office 365 Outlook által felügyelt összekötő e-mail küldése nevű művelete. Az útmutató követéséhez Office 365 Outlook e-mail-fiókra van szüksége. Ha egy másik összekötő által támogatott e-mail-fiókja van, használhatja ezt az összekötőt, de az összekötő felhasználói élménye eltér a példában ismertetett lépésektől.

  • A Válasz nevű beépített összekötőművelet, amellyel választ küldhet, és adatokat küldhet vissza a hívónak.

A Kérelem eseményindító hozzáadása

  1. A munkafolyamat-tervezőBen az Eseményindító hozzáadása panelen nyissa meg a Futtatókörnyezet listát, és válassza az Alkalmazáson belül lehetőséget, hogy csak az elérhető beépített összekötő-eseményindítókat tekinthesse meg.

  2. Keresse meg a "Http-kérés fogadásakor" nevű kérelemindítót a keresőmező használatával, és adja hozzá az eseményindítót a munkafolyamathoz. További információ: Munkafolyamat létrehozása eseményindítóval és műveletekkel.

    Képernyőkép a munkafolyamat-tervezőről, az Eseményindító hozzáadása panelről és a HTTP-kérés fogadásakor kiválasztott eseményindítóról.

    Amikor az eseményindító megjelenik a tervezőn, megnyílik az eseményindító információs panelje, és megjeleníti az eseményindító paramétereit, beállításait és egyéb kapcsolódó feladatait.

    Képernyőkép a HTTP-kérelem fogadásakor elnevezett eseményindító információs paneljéről.

    Tipp.

    Ha az információs ablaktábla nem jelenik meg, győződjön meg arról, hogy az eseményindító ki van jelölve a tervezőben.

  3. Mentse a munkafolyamatot. A tervező eszköztárán válassza a Mentés lehetőséget.

Ha törölnie kell egy elemet a tervezőből, az alábbi lépéseket követve törölheti az elemeket a tervezőből.

Az Office 365 Outlook-művelet hozzáadása

  1. A tervezőn a Kérelem eseményindító alatt válassza a pluszjelet (+) >Művelet hozzáadása lehetőséget.

  2. A megnyíló Művelet hozzáadása panelEn a Futtatókörnyezet listában válassza a Megosztott lehetőséget, hogy csak az elérhető felügyelt összekötőműveleteket tekinthesse meg.

  3. Keresse meg az Office 365 Outlook által felügyelt összekötő e-mail küldése (V2) nevű műveletét a keresőmező használatával, és adja hozzá a műveletet a munkafolyamathoz. További információ: Munkafolyamat létrehozása eseményindítóval és műveletekkel.

    Képernyőkép a munkafolyamat-tervezőről és a Művelet hozzáadása panelről az Office 365 E-mail küldése nevű kijelölt Outlook-művelettel.

  4. Amikor megnyílik a művelet hitelesítési panelje, válassza a Bejelentkezés lehetőséget az e-mail-fiókhoz való kapcsolat létrehozásához.

    Képernyőkép az e-mail küldése (V2) nevű műveletről a kijelölt bejelentkezési gombbal.

  5. Kövesse a következő utasításokat a fiók kiválasztásához, a hozzáférés engedélyezéséhez és a Visual Studio Code-hoz való visszatérés engedélyezéséhez.

    Feljegyzés

    Ha túl sok idő telik el a kérések végrehajtása előtt, a hitelesítési folyamat időtúllépést és meghiúsult. Ebben az esetben térjen vissza a tervezőhöz, és próbálkozzon újra a bejelentkezéssel a kapcsolat létrehozásához.

    1. Amikor megjelenik a Microsoft parancssora, válassza ki az Office 365 Outlook felhasználói fiókját, majd válassza a Hozzáférés engedélyezése lehetőséget.

    2. Amikor az Azure Logic Apps egy Visual Studio Code-hivatkozás megnyitását kéri, válassza a Megnyitás lehetőséget.

      Képernyőkép a Visual Studio Code hivatkozásának megnyitására vonatkozó kérésről.

    3. Amikor a Visual Studio Code kéri a Microsoft Azure Tools megnyitását, válassza a Megnyitás lehetőséget.

      Képernyőkép a Microsoft Azure-eszközök megnyitására vonatkozó kérésről.

    Tipp.

    Az ilyen jövőbeli kérések kihagyásához válassza a következő beállításokat, amikor megjelennek a kapcsolódó kérések:

    • Engedély a Visual Studio Code hivatkozásának megnyitásához: Válassza az Always (Mindig) lehetőséget , hogy logic-apis-westcentralus.consent.azure-apim.net ilyen típusú hivatkozásokat nyisson meg a társított alkalmazásban. Ez a tartomány a logikai alkalmazás erőforrásához kiválasztott Azure-régió alapján változik.

    • Engedély a Microsoft Azure Tools megnyitásához: Válassza a Ne kérje újra ezt a bővítményt.

    Miután a Visual Studio Code létrehozta a kapcsolatot, egyes összekötők azt az üzenetet jelenítik meg, hogy a kapcsolat csak {n} napig érvényes. Ez az időkorlát csak arra az időtartamra vonatkozik, amíg a logikai alkalmazás munkafolyamatát a Visual Studio Code-ban szerkesszen. Az üzembe helyezés után ez a korlát már nem érvényes, mert a munkafolyamat futásidőben hitelesíthető az automatikusan engedélyezett, rendszer által hozzárendelt felügyelt identitással. Ez a felügyelt identitás eltér a kapcsolat létrehozásakor használt hitelesítési hitelesítő adatoktól vagy kapcsolati sztring. Ha letiltja ezt a rendszer által hozzárendelt felügyelt identitást, a kapcsolatok futásidőben nem működnek.

  6. Ha a tervezőn nem jelenik meg az e-mail küldése művelet, jelölje ki a műveletet.

  7. A műveletinformációs panel Paraméterek lapján adja meg a művelethez szükséges információkat, például:

    Képernyőkép az E-mail küldése nevű Office 365 Outlook-művelet adatairól.

    Tulajdonság Kötelező Érték Leírás
    Ide: Igen <your-email-address> Az e-mail címzettje, amely lehet az Ön e-mail-címe tesztelési célokra. Ez a példa a fiktív e-mailt használja. sophia.owen@fabrikam.com
    Tárgy Igen E-mail a példa-munkafolyamatból Az e-mail tárgya
    Törzs Igen Üdvözöljük a példa-munkafolyamatból! Az e-mail törzsének tartalma

    Feljegyzés

    Ha módosításokat végez a Tesztelés lapon, győződjön meg arról, hogy a Mentés lehetőséget választva véglegesíti ezeket a módosításokat, mielőtt a fülekre vált, vagy a fókuszt a tervezőre módosítja. Ellenkező esetben a Visual Studio Code nem tartja meg a módosításokat.

  8. Mentse a munkafolyamatot. A tervezőn válassza a Mentés lehetőséget.

Helyileg futó webhookok engedélyezése

Ha webhookalapú eseményindítót vagy műveletet (például HTTP Webhookot) használ egy Azure-ban futó logikaialkalmazás-munkafolyamattal, az Azure Logic Apps-futtatókörnyezet előfizet a szolgáltatásvégpontra egy visszahívási URL-cím létrehozásával és regisztrálásával a végponttal. Az eseményindító vagy művelet ezután megvárja, amíg a szolgáltatásvégpont meghívja az URL-címet. Amikor azonban a Visual Studio Code-ban dolgozik, a létrehozott visszahívási URL-cím a következővel http://localhost:7071/...kezdődik: . Ez az URL-cím a localhost-kiszolgálóhoz tartozik, amely privát, így a szolgáltatásvégpont nem tudja meghívni ezt az URL-címet.

Ha webhookalapú eseményindítókat és műveleteket szeretne helyileg futtatni a Visual Studio Code-ban, be kell állítania egy nyilvános URL-címet, amely elérhetővé teszi a localhost-kiszolgálót, és biztonságosan továbbítja a hívásokat a szolgáltatásvégpontról a webhook visszahívási URL-címére. Használhat egy továbbító szolgáltatást és eszközt, például az ngrokot, amely http-alagutat nyit meg a localhost-porton, vagy használhatja a saját egyenértékű eszközét.

Hívásátirányítás beállítása ngrok használatával

  1. Nyissa meg az ngrok webhelyét. Regisztráljon új fiókra, vagy jelentkezzen be a fiókjába, ha már rendelkezik ilyen fiókkal.

  2. Szerezze be a személyes hitelesítési jogkivonatot, amelyet az ngrok-ügyfélnek csatlakoznia kell, és hitelesítenie kell a fiókjához való hozzáférést.

    1. A hitelesítési jogkivonat oldalának megkereséséhez a fiók irányítópultjának menüjében bontsa ki a Hitelesítés elemet, és válassza az Authtoken lehetőséget.

    2. Az Authtoken mezőből másolja a jogkivonatot egy biztonságos helyre.

  3. Az ngrok letöltési oldaláról vagy a fiók irányítópultjáról töltse le a kívánt ngrok-verziót, és bontsa ki a .zip fájlt. További információ: 1. lépés: A telepítés megszüntetése.

  4. Nyissa meg a parancssori eszközt a számítógépen. Keresse meg azt a helyet, ahol a ngrok.exe fájl található.

  5. Csatlakozás az ngrok-ügyfelet az ngrok-fiókjába az alábbi parancs futtatásával. További információ: 2. lépés: a fiók Csatlakozás.

    ngrok authtoken <your_auth_token>

  6. Nyissa meg a HTTP-alagutat a localhost 7071-s portjához az alábbi parancs futtatásával. További információ: 3. lépés: Fellövés.

    ngrok http 7071

  7. A kimenetben keresse meg a következő sort:

    http://<domain>.ngrok.io -> http://localhost:7071

  8. Másolja és mentse az ilyen formátumú URL-címet: http://<domain>.ngrok.io

A továbbítási URL beállítása az alkalmazás beállításai között

  1. A Visual Studio Code tervezőjében adja hozzá a használni kívánt webhookalapú eseményindítót vagy műveletet.

    Ez a példa a HTTP + Webhook eseményindítóval folytatódik .

  2. Amikor megjelenik a gazdavégpont helyének kérése, adja meg a korábban létrehozott továbbítási (átirányítási) URL-címet.

    Feljegyzés

    A parancssor figyelmen kívül hagyásával figyelmeztetés jelenik meg, amely szerint meg kell adnia a továbbítási URL-címet, ezért válassza a Konfigurálás lehetőséget, és adja meg az URL-címet. A lépés befejezése után a következő webhook-eseményindítók és -műveletek nem jelennek meg.

    A kérés megjelenítéséhez nyissa meg a projekt gyökérszintjén a local.settings.json fájl helyi menüjét, és válassza a Webhook átirányítási végpontjának konfigurálása lehetőséget. Ekkor megjelenik a kérés, hogy meg tudja adni a továbbítási URL-címet.

    A Visual Studio Code hozzáadja a továbbítási URL-címet a projekt gyökérmappájában található local.settings.json fájlhoz. Values Az objektumban megjelenik a névvel ellátott Workflows.WebhookRedirectHostUri tulajdonság, amely a továbbítási URL-címre van állítva, például:

    {
       "IsEncrypted": false,
       "Values": {
          "AzureWebJobsStorage": "UseDevelopmentStorage=true",
          "FUNCTIONS_WORKER_RUNTIME": "node",
          "FUNCTIONS_V2_COMPATIBILITY_MODE": "true",
          <...>
          "Workflows.WebhookRedirectHostUri": "http://xxxXXXXxxxXXX.ngrok.io",
          <...>
       }
    }
    

Amikor először indít el egy helyi hibakeresési munkamenetet, vagy hibakeresés nélkül futtatja a munkafolyamatot, az Azure Logic Apps-futtatókörnyezet regisztrálja a munkafolyamatot a szolgáltatásvégponton, és feliratkozik erre a végpontra a webhookműveletek értesítéséhez. A munkafolyamat következő futtatásakor a futtatókörnyezet nem fog regisztrálni vagy újból regisztrálni, mert az előfizetés-regisztráció már létezik a helyi tárolóban.

Ha leállítja a hibakeresési munkamenetet egy olyan munkafolyamat-futtatáshoz, amely helyileg futtatott webhook-alapú eseményindítókat vagy műveleteket használ, a meglévő előfizetés-regisztrációk nem törlődnek. A regisztráció törléséhez manuálisan kell eltávolítania vagy törölnie az előfizetés-regisztrációkat.

Feljegyzés

A munkafolyamat futtatása után a terminálablak az alábbi példához hasonló hibákat jeleníthet meg:

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.'

Ebben az esetben nyissa meg a local.settings.json fájlt a projekt gyökérmappájában, és győződjön meg arról, hogy a tulajdonság értéke true:

"FUNCTIONS_V2_COMPATIBILITY_MODE": "true"

Hibakeresési töréspontok kezelése

Mielőtt futtatja és teszteli a logikai alkalmazás munkafolyamatát egy hibakeresési munkamenet elindításával, töréspontokat állíthat be az egyes munkafolyamatok workflow.json fájlban. Nincs szükség más beállításra.

A töréspontok jelenleg csak a műveletekhez támogatottak, az eseményindítókhoz nem. Minden műveletdefiníció a következő töréspont-helyekkel rendelkezik:

  • Állítsa be a kezdő töréspontot a művelet nevét megjelenítő sorban. Amikor ez a töréspont a hibakeresési munkamenet során eléri a találatokat, a kiértékelés előtt áttekintheti a művelet bemeneteit.

  • Állítsa be a záró töréspontot azon a vonalon, amely a művelet záró kapcsos zárójelét (}) jeleníti meg. Amikor ez a töréspont a hibakeresési munkamenet során eléri a találatokat, áttekintheti a művelet eredményeit, mielőtt a művelet befejeződik.

Töréspont hozzáadásához kövesse az alábbi lépéseket:

  1. Nyissa meg a workflow.json fájlt a hibakereséshez használni kívánt munkafolyamathoz.

  2. A töréspont beállításának sorában a bal oldali oszlopban válassza ki az oszlopon belül. A töréspont eltávolításához jelölje ki a töréspontot.

    A hibakeresési munkamenet indításakor a Futtatás nézet megjelenik a kódablak bal oldalán, a hibakeresési eszköztár pedig a tetején.

    Feljegyzés

    Ha a Futtatás nézet nem jelenik meg automatikusan, nyomja le a Ctrl+Shift+D billentyűkombinációt.

  3. Ha szeretné áttekinteni az elérhető információkat, amikor törésponttal ütközik, a Futtatás nézetben vizsgálja meg a Változók panelt.

  4. A munkafolyamat végrehajtásának folytatásához a hibakeresési eszköztáron válassza a Folytatás (lejátszás) gombot.

A munkafolyamat futtatása során bármikor hozzáadhat és eltávolíthat töréspontokat. Ha azonban a futtatás után frissíti a workflow.json fájlt, a töréspontok nem frissülnek automatikusan. A töréspontok frissítéséhez indítsa újra a logikai alkalmazást.

Általános információkért lásd : Töréspontok – Visual Studio Code.

Helyi futtatás, tesztelés és hibakeresés

A logikai alkalmazás munkafolyamatának teszteléséhez kövesse az alábbi lépéseket egy hibakeresési munkamenet elindításához, és keresse meg a Kérelem eseményindító által létrehozott végpont URL-címét. Szüksége van erre az URL-címre, hogy később elküldhesse a kérelmet az adott végpontnak.

  1. Az állapot nélküli munkafolyamatok egyszerűbb hibakereséséhez engedélyezheti a munkafolyamat futtatási előzményeit.

  2. Ha az Azurite emulátor már fut, folytassa a következő lépésben. Ellenkező esetben a munkafolyamat futtatása előtt mindenképpen indítsa el az emulátort:

    1. A Visual Studio Code Nézet menüjében válassza a Parancskatalógus lehetőséget.

    2. A parancskatalógus megjelenése után adja meg az Azurite: Start parancsot.

    Az Azurite-parancsokkal kapcsolatos további információkért tekintse meg a Visual Studio Code Azurite-bővítményének dokumentációját.

  3. A Visual Studio Code tevékenységsávján nyissa meg a Futtatás menüt, és válassza a Hibakeresés indítása (F5) lehetőséget.

    Megnyílik a terminálablak , hogy áttekinthesse a hibakeresési munkamenetet.

    Feljegyzés

    Ha a " Hiba a preLaunchTask "generateDebugSymbols" futtatása után jelenik meg, tekintse meg a hibaelhárítási szakaszt, amely szerint a hibakeresési munkamenet nem indul el.

  4. Most keresse meg a végpont visszahívási URL-címét a Kérés eseményindítóban.

    1. Nyissa meg újra az Explorer panelt, hogy megtekinthesse a projektet.

    2. A workflow.json fájl helyi menüjében válassza az Áttekintés lehetőséget.

      Képernyőkép az Explorer panelről, workflow.json fájl helyi menüjéről a kijelölt beállítással, áttekintéssel.

    3. Keresse meg a visszahívási URL-értéket , amely az alábbi URL-címhez hasonlóan jelenik meg a Példa Kérés eseményindítóhoz:

      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>

      Képernyőkép a munkafolyamat áttekintési oldalról visszahívási URL-címmel.

  5. Ha a visszahívási URL-címet a logikai alkalmazás munkafolyamatának aktiválásával szeretné tesztelni, nyissa meg a Postmant vagy a kérések létrehozásához és küldéséhez előnyben részesített eszközt.

    Ez a példa a Postman használatával folytatódik. További információ: Postman – Első lépések.

    1. A Postman eszköztáron válassza az Új lehetőséget.

      Képernyőkép a Postman és az Új gomb kiválasztásáról

    2. Az Új létrehozása panel Építőelemek csoportjában válassza a Kérés lehetőséget.

    3. A Kérelem mentése ablakban, a Kérés neve területen adja meg a kérés nevét, például a Munkafolyamat tesztelése eseményindítót.

    4. A Gyűjtemény vagy mappa kiválasztása csoportban válassza a Gyűjtemény létrehozása lehetőséget.

    5. A Minden gyűjtemény csoportban adja meg a gyűjtemény nevét a kérések rendezéséhez, nyomja le az Enter billentyűt, és válassza a Mentés gyűjteménynévre>< lehetőséget. Ez a példa a Logic Apps-kérelmeket használja gyűjteménynévként.

      A Postmanben megnyílik a kérelempanel, hogy elküldhesse a kérést a Kérés eseményindító visszahívási URL-címére.

      Képernyőkép a Postmanről a megnyitott kérelempanellel.

    6. Térjen vissza a Visual Studio Code-hoz. A munkafolyamat áttekintési oldaláról másolja ki a Visszahívási URL-cím tulajdonság értékét.

    7. Térjen vissza Postmanbe. A kérelem panelen a metóduslista mellett, amely jelenleg a GET alapértelmezett kérési metódusként jelenik meg, illessze be a címmezőbe korábban másolt visszahívási URL-címet, és válassza a Küldés lehetőséget.

      Képernyőkép a Postman és a visszahívási URL-címről a címmezőben a Küldés gombbal.

      A példa logikai alkalmazás munkafolyamata az alábbi példához hasonló e-mailt küld:

      Képernyőkép az Outlook e-mailjeiről a példában leírtak szerint.

  6. A Visual Studio Code-ban térjen vissza a munkafolyamat áttekintő oldalára.

    Ha állapotalapú munkafolyamatot hozott létre, az elküldött kérés után aktiválja a munkafolyamatot, az áttekintő oldal megjeleníti a munkafolyamat futtatási állapotát és előzményeit.

    Tipp.

    Ha a futtatási állapot nem jelenik meg, próbálja meg frissíteni az áttekintési oldalt a Frissítés gombra kattintva. Nem történik futtatás olyan eseményindító esetében, amely a nem teljesült feltételek vagy adatok keresése miatt ki van hagyva.

    Képernyőkép a munkafolyamat áttekintési oldaláról a futtatás állapotával és előzményeivel

    Az alábbi táblázat azokat a lehetséges végleges állapotokat mutatja be, amelyeket az egyes munkafolyamatok futtathatnak és megjeleníthetnek a Visual Studio Code-ban:

    Futtatási állapot Leírás
    Megszakadt A futtatás leállt vagy nem fejeződött be külső problémák, például rendszerkimaradás vagy lejárt Azure-előfizetés miatt.
    Törölt A futtatás aktiválódott és elindult, de lemondási kérelmet kapott.
    Sikertelen A futtatás során legalább egy művelet meghiúsult. A munkafolyamatban nem lettek beállítva további műveletek a hiba kezelésére.
    Fut A futtatás aktiválva lett, és folyamatban van, de ez az állapot a műveleti korlátok vagy az aktuális díjszabási csomag miatt szabályozott futtatások esetében is megjelenhet.

    Tipp: Ha beállítja a diagnosztikai naplózást, információkat kaphat az esetlegesen bekövetkező szabályozási eseményekről.

    Sikerült A futtatás sikeres volt. Ha valamelyik művelet sikertelen volt, a munkafolyamat egy későbbi művelete kezelte ezt a hibát.
    Időtúllépés A futtatás időtúllépést vett igénybe, mert az aktuális időtartam túllépte a futtatás időtartamának korlátját, amelyet a Futtatási előzmények megőrzési ideje a napokban beállítás szabályoz. A futtatás időtartamának kiszámítása a futtatás kezdési időpontjának és a futtatási időtartamnak az adott időpontban megadott korlátjával történik.

    Megjegyzés: Ha a futtatás időtartama is meghaladja az aktuális futási előzmények megőrzési korlátját, amelyet a Futtatási előzmények megőrzési ideje napokban beállítás is szabályoz, a futtatást egy napi törlési feladat törli a futtatási előzményekből. Függetlenül attól, hogy a futtatás túllépi vagy befejezi a megőrzési időtartamot, a rendszer mindig a futtatás kezdési időpontjának és az aktuális megőrzési korlátnak a használatával számítja ki. Ha tehát csökkenti a repülés közbeni futtatás időtartamkorlátját, a futtatás túllépi az időkorlátot. A futtatás vagy marad, vagy törlődik a futtatási előzményekből attól függően, hogy a futtatás időtartama túllépte-e a megőrzési korlátot.

    Várakozó A futtatás nem indult el vagy szünetel, például egy korábbi munkafolyamat-példány miatt, amely még mindig fut.
  7. Ha egy adott futtatás minden lépésének állapotát, valamint a lépés bemeneteit és kimeneteit szeretné áttekinteni, válassza a futtatás három pontjának (...) gombját, és válassza a Futtatás megjelenítése lehetőséget.

    Képernyőkép a munkafolyamat futtatási előzménysorról a kijelölt három ponttal és a Futtatás megjelenítése gombbal.

    A Visual Studio Code megnyitja a figyelési nézetet, és megjeleníti a futtatás egyes lépéseinek állapotát.

    Képernyőkép a munkafolyamat-futtatás minden lépéséről és állapotáról.

    Feljegyzés

    Ha egy futtatás sikertelen volt, és a figyelési nézetben egy lépés a 400-ra vonatkozó hibás kérelem hibát mutatja, a probléma egy hosszabb eseményindító-név vagy műveletnév miatt fordulhat elő, amely miatt a mögöttes egységes erőforrás-azonosító (URI) túllépi az alapértelmezett karakterkorlátot. További információ: "400 Hibás kérelem".

    Az alábbi táblázat azokat a lehetséges állapotokat mutatja be, amelyekkel az egyes munkafolyamat-műveletek rendelkezhetnek és megjeleníthetők a Visual Studio Code-ban:

    Művelet állapota Leírás
    Megszakadt A művelet leállt vagy nem fejeződött be külső problémák, például egy rendszerkimaradás vagy az Azure-előfizetés leállása miatt.
    Törölt A művelet futott, de egy lemondási kérelmet kapott.
    Sikertelen A művelet nem sikerült.
    Fut A művelet jelenleg fut.
    Kihagyva A művelet kimaradt, mert a közvetlenül megelőző művelet meghiúsult. Egy művelet olyan feltétellel rendelkezik runAfter , amely megköveteli, hogy az előző művelet sikeresen befejeződik, mielőtt az aktuális művelet lefutna.
    Sikerült A művelet sikeres volt.
    Újrapróbálkozással sikerült A művelet sikeres volt, de csak egy vagy több újrapróbálkozás után. Az újrapróbálkozási előzmények áttekintéséhez a futtatási előzmények részletei nézetben jelölje ki a műveletet, hogy megtekinthesse a bemeneteket és kimeneteket.
    Időtúllépés A művelet leállt a művelet beállításai által megadott időtúllépési korlát miatt.
    Várakozó Olyan webhook-műveletre vonatkozik, amely egy hívótól érkező bejövő kérésre vár.
  8. Az egyes lépések bemeneteinek és kimeneteinek áttekintéséhez válassza ki a vizsgálandó lépést. Az adott lépés nyers bemeneteinek és kimeneteinek további áttekintéséhez válassza a Nyers bemenetek megjelenítése vagy a Nyers kimenetek megjelenítése lehetőséget.

    Képernyőkép a munkafolyamat minden lépésének állapotáról, valamint az e-mail küldése nevű bővített művelet bemeneteiről és kimenetéről.

  9. A hibakeresési munkamenet leállításához a Futtatás menüben válassza a Hibakeresés leállítása (Shift + F5) lehetőséget.

Válasz visszaadása

Ha a Kérelem eseményindítóval kezdődő munkafolyamattal rendelkezik, a Válasz nevű beépített kérelemművelettel választ küldhet a hívónak, aki kérést küldött a munkafolyamatnak.

  1. A munkafolyamat-tervezőben az E-mail küldése művelet alatt válassza a pluszjelet (+) >Művelet hozzáadása lehetőséget.

    Megnyílik a Művelet hozzáadása panel, hogy kijelölhesse a következő műveletet.

  2. A Művelet hozzáadása panel Futtatókörnyezet listájában válassza az Alkalmazáson belül lehetőséget. Keresse meg és adja hozzá a Válasz műveletet.

    Miután a válaszművelet megjelenik a tervezőn, a művelet részleteinek panelje automatikusan megnyílik.

    Képernyőkép a munkafolyamat-tervezőről és a Válasz információ panelről.

  3. A Paraméterek lapon adja meg a meghívni kívánt függvény szükséges adatait.

    Ez a példa a Törzs paraméter értékét adja vissza, amely az e-mail küldése művelet kimenete.

    1. A Törzs paraméternél válassza ki a szerkesztési mezőben, majd válassza a villám ikont, amely megnyitja a dinamikus tartalomlistát. Ez a lista a munkafolyamat előző eseményindítójának és műveleteinek elérhető kimeneti értékeit jeleníti meg.

    2. A dinamikus tartalomlistában az E-mail küldése csoportban válassza a Törzs lehetőséget.

      Képernyőkép a megnyitott dinamikus tartalomlistáról, ahol az E-mail-fejléc küldése csoportban a Törzs kimeneti értéke van kiválasztva.

      Ha végzett, a Válasz művelet Törzs tulajdonsága mostantól az e-mail-művelet Törzs kimeneti értékére van állítva.

      Képernyőkép a munkafolyamat-tervezőről, a Válaszadatok panelről és az e-mail küldése művelet Törzs értékére beállított Törzs paraméterről.

  4. A tervezőn válassza a Mentés lehetőséget.

A logikai alkalmazás ismételt kipróbálás

Miután frissítette a logikai alkalmazást, futtathat egy másik tesztet úgy, hogy újrafuttatja a hibakeresőt a Visual Studióban, és elküld egy másik kérést a frissített logikai alkalmazás aktiválásához, hasonlóan a futtatás, tesztelés és hibakeresés helyi lépéseihez.

  1. A Visual Studio Code tevékenységsávján nyissa meg a Futtatás menüt, és válassza a Hibakeresés indítása (F5) lehetőséget.

  2. A Postmanben vagy a kérések létrehozására és küldésére szolgáló eszközben küldjön egy másik kérést a munkafolyamat aktiválásához.

  3. Ha állapotalapú munkafolyamatot hozott létre, a munkafolyamat áttekintési oldalán ellenőrizze a legutóbbi futtatás állapotát. A futtatás egyes lépéseinek állapotának, bemeneteinek és kimeneteinek megtekintéséhez válassza az adott futtatás három pontjának (...) gombját, és válassza a Futtatás megjelenítése lehetőséget.

    Itt látható például egy futtatás lépésenkénti állapota, miután a minta-munkafolyamat a Válasz művelettel frissült.

    Képernyőkép a frissített munkafolyamat minden lépésének állapotáról, valamint a bővített válaszművelet bemenetei és kimenetei.

  4. A hibakeresési munkamenet leállításához a Futtatás menüben válassza a Hibakeresés leállítása (Shift + F5) lehetőséget.

Tartománynevek keresése tűzfalhozzáféréshez

Mielőtt üzembe helyezené és futtatná a logikai alkalmazás munkafolyamatát az Azure Portalon, ha a környezet szigorú hálózati követelményekkel vagy a forgalmat korlátozó tűzfallal rendelkezik, engedélyeket kell beállítania a munkafolyamatban található trigger- vagy műveletkapcsolatokhoz.

A kapcsolatok teljes tartományneveinek (FQDN-jeinek) megkereséséhez kövesse az alábbi lépéseket:

  1. A logikai alkalmazásprojektben nyissa meg a connections.json fájlt, amely azután jön létre, hogy hozzáadta az első kapcsolatalapú eseményindítót vagy műveletet a munkafolyamathoz, és megtalálta az managedApiConnections objektumot.

  2. Minden létrehozott kapcsolathoz másolja és mentse a connectionRuntimeUrl tulajdonság értékét biztonságos helyre, hogy ezzel az információval be tudja állítani a tűzfalat.

    Ez a példa connections.json fájl két kapcsolatot, egy AS2-kapcsolatot és egy Office 365-kapcsolatot tartalmaz az alábbi connectionRuntimeUrl értékekkel:

    • AS2: "connectionRuntimeUrl": https://9d51d1ffc9f77572.00.common.logic-{Azure-region}.azure-apihub.net/apim/as2/11d3fec26c87435a80737460c85f42ba

    • Office 365: "connectionRuntimeUrl": https://9d51d1ffc9f77572.00.common.logic-{Azure-region}.azure-apihub.net/apim/office365/668073340efe481192096ac27e7d467f

    {
       "managedApiConnections": {
          "as2": {
             "api": {
                "id": "/subscriptions/{Azure-subscription-ID}/providers/Microsoft.Web/locations/{Azure-region}/managedApis/as2"
             },
             "connection": {
                "id": "/subscriptions/{Azure-subscription-ID}/resourceGroups/{Azure-resource-group}/providers/Microsoft.Web/connections/{connection-resource-name}"
             },
             "connectionRuntimeUrl": https://9d51d1ffc9f77572.00.common.logic-{Azure-region}.azure-apihub.net/apim/as2/11d3fec26c87435a80737460c85f42ba,
             "authentication": {
                "type":"ManagedServiceIdentity"
             }
          },
          "office365": {
             "api": {
                "id": "/subscriptions/{Azure-subscription-ID}/providers/Microsoft.Web/locations/{Azure-region}/managedApis/office365"
             },
             "connection": {
                "id": "/subscriptions/{Azure-subscription-ID}/resourceGroups/{Azure-resource-group}/providers/Microsoft.Web/connections/{connection-resource-name}"
             },
             "connectionRuntimeUrl": https://9d51d1ffc9f77572.00.common.logic-{Azure-region}.azure-apihub.net/apim/office365/668073340efe481192096ac27e7d467f,
             "authentication": {
                "type":"ManagedServiceIdentity"
             }
          }
       }
    }
    

Üzembe helyezés az Azure-ban

A Visual Studio Code-ban közvetlenül közzéteheti a projektet az Azure-ban a Standard logikai alkalmazás erőforrás üzembe helyezéséhez. A logikai alkalmazást közzéteheti új erőforrásként, amely automatikusan létrehozza a szükséges erőforrásokat, például egy Azure Storage-fiókot, a függvényalkalmazás követelményeihez hasonlóan. Vagy közzéteheti a logikai alkalmazást egy korábban üzembe helyezett Standard logikaialkalmazás-erőforrásban, amely felülírja a logikai alkalmazást.

A Standard logikai alkalmazás erőforrás üzembe helyezéséhez üzemeltetési csomagra és tarifacsomagra van szükség, amelyet az üzembe helyezés során választ ki. További információkért tekintse át az üzemeltetési csomagokat és a tarifacsomagokat.

Közzététel egy új Standard logikai alkalmazás erőforrásában

  1. A Visual Studio Code tevékenységsávján válassza az Azure ikont az Azure-ablak megnyitásához.

  2. Az Azure-ablakban, a Munkaterület szakasz eszköztárán, az Azure Logic Apps menüben válassza az Üzembe helyezés a Logic Appban lehetőséget.

    Képernyőkép az Azure-ablakról a Munkaterület eszköztárral és az Azure Logic Apps helyi menüjével, amelyen a Üzembe helyezés a Logic Appban lehetőség van kiválasztva.

  3. Ha a rendszer kéri, válassza ki a logikai alkalmazás üzembe helyezéséhez használni kívánt Azure-előfizetést.

  4. A Visual Studio Code által megnyíló listából válasszon az alábbi lehetőségek közül:

    • Új Logic App (Standard) létrehozása az Azure-ban (gyors)
    • Új Logic App (Standard) létrehozása az Azure Advancedben
    • Korábban üzembe helyezett Logikai alkalmazás (Standard) erőforrás, ha van ilyen

    Ez a példa folytatódik az Új logikai alkalmazás (Standard) létrehozása az Azure Advancedben.

    Képernyőkép az üzembe helyezési beállítások listájáról és a kiválasztott beállításról, az Új logikai alkalmazás létrehozása (Standard) az Azure Advancedben.

  5. Az új Standard logikaialkalmazás-erőforrás létrehozásához kövesse az alábbi lépéseket:

    1. Adjon meg egy globálisan egyedi nevet az új logikai alkalmazásnak, amely a Logic App (Standard) erőforráshoz használandó név. Ez a példa a Fabrikam-Workflows-App alkalmazást használja.

      Képernyőkép az új létrehozandó logikai alkalmazás nevének megadására szolgáló üzenetről.

    2. Válasszon egy üzemeltetési csomagot az új logikai alkalmazáshoz. Hozzon létre egy nevet a csomagnak, vagy válasszon ki egy meglévő csomagot (csak Windows-alapú App Service-csomagokat). Ez a példa az Új App Service-csomag létrehozása lehetőséget választja.

      Képernyőkép a

    3. Adja meg az üzemeltetési csomag nevét, majd válasszon egy tarifacsomagot a kiválasztott csomaghoz.

      További információkért tekintse át az üzemeltetési csomagokat és a tarifacsomagokat.

    4. Az optimális teljesítmény érdekében válassza ki ugyanazt az erőforráscsoportot, mint a projekt az üzembe helyezéshez.

      Feljegyzés

      Bár létrehozhat vagy használhat egy másik erőforráscsoportot, ez hatással lehet a teljesítményre. Ha egy másik erőforráscsoportot hoz létre vagy választ, de a megerősítést kérő üzenet megjelenése után lemondja, az üzembe helyezést is megszakítja.

    5. Állapotalapú munkafolyamatok esetén válassza az Új tárfiók vagy egy meglévő tárfiók létrehozása lehetőséget.

      Képernyőkép a

    6. Ha a logikai alkalmazás létrehozási és üzembehelyezési beállításai támogatják az Alkalmazás Elemzések használatát, opcionálisan engedélyezheti a diagnosztikai naplózást és a nyomkövetést a logikai alkalmazáshoz. Ezt megteheti a logikai alkalmazás Visual Studio Code-ból való üzembe helyezésekor vagy az üzembe helyezés után. Rendelkeznie kell egy application Elemzések-példánysal, de ezt az erőforrást előre, a logikai alkalmazás üzembe helyezésekor vagy az üzembe helyezés után is létrehozhatja.

      A naplózás és a nyomkövetés engedélyezéséhez kövesse az alábbi lépéseket:

      1. Válasszon egy meglévő alkalmazás-Elemzések erőforrást, vagy hozzon létre új alkalmazás-Elemzések erőforrást.

      2. Az Azure Portalon nyissa meg az alkalmazás Elemzések erőforrást.

      3. Az erőforrás menüjében válassza az Áttekintés lehetőséget. Keresse meg és másolja ki a Instrumentation Key értékét.

      4. A Visual Studio Code-ban, a projekt gyökérmappájában nyissa meg a local.settings.json fájlt.

      5. Az objektumban Values adja hozzá a APPINSIGHTS_INSTRUMENTATIONKEY tulajdonságot, és állítsa be az értéket a rendszerállapotkulcsba, például:

        {
           "IsEncrypted": false,
           "Values": {
              "AzureWebJobsStorage": "UseDevelopmentStorage=true",
              "FUNCTIONS_WORKER_RUNTIME": "node",
              "APPINSIGHTS_INSTRUMENTATIONKEY": <instrumentation-key>
           }
        }
        

        Tipp.

        Ellenőrizheti, hogy az eseményindító és a műveletnevek helyesen jelennek-e meg az Alkalmazás Elemzések-példányban.

        1. Az Azure Portalon nyissa meg az alkalmazás Elemzések erőforrást.

        2. Az erőforrásmenü Vizsgálat területén válassza az Alkalmazástérkép lehetőséget.

        3. Tekintse át a térképen megjelenő műveletneveket.

        Előfordulhat, hogy a beépített eseményindítók bejövő kérelmei duplikáltként jelennek meg az alkalmazástérképen. A formátum használata helyett ezek az WorkflowName.ActionName ismétlődések a munkafolyamat nevét használják műveletnévként, és az Azure Functions-gazdagépről származnak.

      6. Ezután igény szerint módosíthatja a logikai alkalmazás által gyűjtött és az alkalmazásnak Elemzések példánynak küldött nyomkövetési adatok súlyossági szintjét.

        Minden alkalommal, amikor munkafolyamattal kapcsolatos esemény történik, például amikor egy munkafolyamat aktiválódik, vagy amikor egy művelet fut, a futtatókörnyezet különböző nyomkövetéseket bocsát ki. Ezek a nyomkövetések lefedik a munkafolyamat élettartamát, és magukban foglalják, de nem korlátozódnak a következő eseménytípusokra:

        • Szolgáltatástevékenység, például indítás, leállítás és hibák.
        • Feladatok és diszpécser tevékenység.
        • Munkafolyamat-tevékenység, például eseményindító, művelet és futtatás.
        • A storage-kérelmek tevékenységei, például sikeresek vagy sikertelenek.
        • HTTP-kérési tevékenység, például bejövő, kimenő, sikeres és sikertelen.
        • Bármilyen fejlesztési nyomkövetés, például hibakeresési üzenetek.

        Minden eseménytípus egy súlyossági szinthez van rendelve. A szint például Trace a legrészletesebb üzeneteket rögzíti, míg a szint rögzíti a Information munkafolyamat általános tevékenységeit, például amikor a logikai alkalmazás, a munkafolyamat, az eseményindító és a műveletek elindulnak és leállnak. Ez a táblázat a súlyossági szinteket és azok nyomkövetési típusait ismerteti:

        Súlyossági szint Nyomkövetés típusa
        Kritikus A logikai alkalmazásban helyreállíthatatlan hibát leíró naplók.
        Hibakeresés A fejlesztés során vizsgálatra használható naplók, például bejövő és kimenő HTTP-hívások.
        Hiba Naplók, amelyek a munkafolyamat-végrehajtás hibáját jelzik, de a logikai alkalmazás általános hibáját nem.
        Tájékoztatás A logikai alkalmazásban vagy munkafolyamatban az általános tevékenységet nyomon követő naplók, például:

        – Amikor egy eseményindító, művelet vagy futtatás elindul és véget ér.
        – Amikor a logikai alkalmazás elindul vagy véget ér.

        Trace A legrészletesebb üzeneteket tartalmazó naplók, például a tárolási kérelmek vagy a kézbesítői tevékenység, valamint a munkafolyamat-végrehajtási tevékenységhez kapcsolódó összes üzenet.
        Figyelmeztetés Naplók, amelyek a logikai alkalmazásban abnormális állapotot emelnek ki, de nem akadályozzák annak futtatását.

        A súlyossági szint beállításához a projekt gyökérszintjén nyissa meg a host.json fájlt, és keresse meg az logging objektumot. Ez az objektum szabályozza a logikai alkalmazás összes munkafolyamatának naplószűrését, és követi a ASP.NET Core-elrendezést a naplótípusok szűréséhez.

        {
           "version": "2.0",
           "logging": {
              "applicationInsights": {
                 "samplingExcludedTypes": "Request",
                 "samplingSettings": {
                    "isEnabled": true
                 }
              }
           }
        }
        

        Ha az logging objektum nem tartalmaz olyan objektumot logLevel , amely tartalmazza a tulajdonságot, vegye fel ezeket az Host.Triggers.Workflow elemeket. Állítsa a tulajdonságot a kívánt nyomkövetési típus súlyossági szintjére, például:

        {
           "version": "2.0",
           "logging": {
              "applicationInsights": {
                 "samplingExcludedTypes": "Request",
                 "samplingSettings": {
                    "isEnabled": true
                 }
              },
              "logLevel": {
                 "Host.Triggers.Workflow": "Information"
              }
           }
        }
        

    Ha végzett az üzembe helyezési lépésekkel, a Visual Studio Code elkezdi létrehozni és üzembe helyezni a logikai alkalmazás közzétételéhez szükséges erőforrásokat.

  6. Az üzembehelyezési folyamat áttekintéséhez és figyeléséhez válassza a Nézet menü Kimenet elemét. A Kimeneti ablak eszköztár listájában válassza az Azure Logic Apps lehetőséget.

    Képernyőkép a Kimenet ablakról, amelyen az Azure Logic Apps van kiválasztva az eszköztár listában, valamint az üzembe helyezés előrehaladása és állapota.

    Amikor a Visual Studio Code befejezi a logikai alkalmazás Üzembe helyezését az Azure-ban, a következő üzenet jelenik meg:

    Képernyőkép egy üzenetről, amely szerint az Azure-ba történő üzembe helyezés sikeresen befejeződött.

    Gratulálunk, a logikai alkalmazás mostantól az Azure-ban él, és alapértelmezés szerint engedélyezve van.

A következő lépésben megtanulhatja, hogyan végezheti el ezeket a feladatokat:

Üres munkafolyamat hozzáadása a projekthez

A logikai alkalmazásprojektben több munkafolyamat is lehet. Ha üres munkafolyamatot szeretne hozzáadni a projekthez, kövesse az alábbi lépéseket:

  1. A Visual Studio Code tevékenységsávján válassza az Azure ikont.

  2. Az Azure-ablakban, a Munkaterület szakasz eszköztárán, az Azure Logic Apps menüben válassza a Munkafolyamat létrehozása lehetőséget.

  3. Válassza ki a hozzáadni kívánt munkafolyamattípust: Állapotalapú vagy Állapot nélküli

  4. Adjon nevet a munkafolyamatnak.

Ha elkészült, egy új munkafolyamat-mappa jelenik meg a projektben, valamint egy workflow.json fájlt a munkafolyamat-definícióhoz.

Üzembe helyezett logikai alkalmazások kezelése a Visual Studio Code-ban

A Visual Studio Code-ban megtekintheti az Összes üzembe helyezett logikai alkalmazást az Azure-előfizetésében, függetlenül attól, hogy azok Használat vagy Standard logikai alkalmazás-erőforrások, és kiválaszthatja azokat a feladatokat, amelyek segítenek ezeknek a logikai alkalmazásoknak a kezelésében. Mindkét erőforrástípus eléréséhez azonban az Azure Logic Apps (Használat) és a Visual Studio Code Azure Logic Apps (Standard) bővítményére is szükség van.

  1. A Visual Studio Code tevékenységsávján válassza az Azure ikont. Az Erőforrások területen bontsa ki az előfizetést, majd bontsa ki a Logic Appot, amely megjeleníti az Azure-ban az adott előfizetéshez telepített összes logikai alkalmazást.

  2. Nyissa meg a kezelni kívánt logikai alkalmazást. A logikai alkalmazás helyi menüjében válassza ki a végrehajtani kívánt feladatot.

    Kiválaszthatja például az üzembe helyezett logikai alkalmazás leállítását, indítását, újraindítását vagy törlését. A munkafolyamatokat az Azure Portalon tilthatja le vagy engedélyezheti.

    Feljegyzés

    A logikai alkalmazás leállítása és a logikai alkalmazások törlése különböző módokon befolyásolja a munkafolyamat-példányokat. További információkért tekintse át a logikai alkalmazások leállításával kapcsolatos szempontokat, valamint a logikai alkalmazások törlésével kapcsolatos szempontokat.

    Képernyőkép a Visual Studio Code és az Erőforrások szakaszról és az üzembe helyezett logikai alkalmazás erőforrásról.

  3. A logikai alkalmazás összes munkafolyamatának megtekintéséhez bontsa ki a logikai alkalmazást, majd bontsa ki a Munkafolyamatok csomópontot.

  4. Egy adott munkafolyamat megtekintéséhez nyissa meg a munkafolyamat helyi menüjét, és válassza a Megnyitás Tervező lehetőséget, amely írásvédett módban nyitja meg a munkafolyamatot.

    A munkafolyamat szerkesztéséhez az alábbi lehetőségek közül választhat:

    • A Visual Studio Code-ban nyissa meg a projekt workflow.json fájlját a munkafolyamat-tervezőben, végezze el a szerkesztéseket, és helyezze üzembe újra a logikai alkalmazást az Azure-ban.

    • Nyissa meg a logikai alkalmazást az Azure Portalon. Ezután megnyithatja, szerkesztheti és mentheti a munkafolyamatot.

  5. Az üzembe helyezett logikai alkalmazás Azure Portalon való megnyitásához nyissa meg a logikai alkalmazás helyi menüjét, és válassza a Megnyitás a portálon lehetőséget.

    Az Azure Portal megnyílik a böngészőben, automatikusan bejelentkezik a portálra, ha bejelentkezik a Visual Studio Code-ba, és megjeleníti a logikai alkalmazást.

    Képernyőkép a Visual Studio Code-ban található logikai alkalmazás Azure Portal-oldalról.

    Külön is bejelentkezhet az Azure Portalra, a portál keresőmezőjében megkeresheti a logikai alkalmazást, majd kiválaszthatja a logikai alkalmazást a találatok listájából.

    Képernyőkép az Azure Portalról és a keresési sávról az üzembe helyezett logikai alkalmazás keresési eredményeivel, amely kiválasztva jelenik meg.

A logikai alkalmazások leállításának szempontjai

A logikai alkalmazások leállítása a munkafolyamat-példányokat a következő módokon érinti:

  • Az Azure Logic Apps azonnal megszakítja az összes folyamatban lévő és függőben lévő futtatást.

  • Az Azure Logic Apps nem hoz létre vagy futtat új munkafolyamat-példányokat.

  • Az eseményindítók nem aktiválódnak a következő alkalommal, amikor teljesülnek a feltételeik. A triggerállapotok azonban megjegyzik azokat a pontokat, ahol a logikai alkalmazás leállt. Így ha újraindítja a logikai alkalmazást, az eseményindítók az utolsó futtatás óta minden feldolgozatlan elemnél aktiválódik.

    Ha meg szeretné akadályozni, hogy egy eseményindító az utolsó futtatás óta ne aktiváljon feldolgozatlan elemeket, törölje az eseményindító állapotát a logikai alkalmazás újraindítása előtt:

    1. A Visual Studio Code tevékenységsávján válassza az Azure ikont az Azure-ablak megnyitásához.

    2. Az Erőforrások szakaszban bontsa ki az előfizetést, amely megjeleníti az előfizetéshez telepített összes üzembe helyezett logikai alkalmazást.

    3. Bontsa ki a logikai alkalmazást, majd bontsa ki a Munkafolyamatok nevű csomópontot.

    4. Nyisson meg egy munkafolyamatot, és szerkessze a munkafolyamat eseményindítójának bármely részét.

    5. Mentse a módosításokat. Ez a lépés alaphelyzetbe állítja az eseményindító aktuális állapotát.

    6. Ismételje meg az egyes munkafolyamatokat.

    7. Ha elkészült, indítsa újra a logikai alkalmazást.

A logikai alkalmazások törlésével kapcsolatos szempontok

A logikai alkalmazások törlése a munkafolyamat-példányokat a következő módokon érinti:

  • Az Azure Logic Apps azonnal megszakítja a folyamatban lévő és függőben lévő futtatásokat, de nem futtat tisztítási feladatokat az alkalmazás által használt tárolón.

  • Az Azure Logic Apps nem hoz létre vagy futtat új munkafolyamat-példányokat.

  • Ha töröl egy munkafolyamatot, majd újból létrehozza ugyanazt a munkafolyamatot, az újra létrehozott munkafolyamat nem rendelkezik ugyanazokkal a metaadatokkal, mint a törölt munkafolyamat. A metaadatok frissítéséhez újra meg kell mentenie a törölt munkafolyamatnak nevezett munkafolyamatot. Így a hívó megkapja a megfelelő információkat az újra létrehozott munkafolyamathoz. Ellenkező esetben az újra létrehozott munkafolyamat hívásai hibával meghiúsulnak Unauthorized . Ez a viselkedés azokra a munkafolyamatokra is vonatkozik, amelyek összetevőket használnak az Azure-függvényeket hívó integrációs fiókokban és munkafolyamatokban.

Üzembe helyezett logikai alkalmazások kezelése a portálon

Miután üzembe helyezett egy logikai alkalmazást az Azure Portalon a Visual Studio Code-ból, megtekintheti az Azure-előfizetésében lévő összes üzembe helyezett logikai alkalmazást, függetlenül attól, hogy azok használatalapú vagy standard logikai alkalmazás-erőforrások. Jelenleg minden erőforrástípus külön kategóriákként van rendszerezve és felügyelve az Azure-ban. A Standard logikai alkalmazások megkereséséhez kövesse az alábbi lépéseket:

  1. Az Azure Portal keresőmezőjében adja meg a logikai alkalmazásokat. Amikor megjelenik az eredménylista, a Szolgáltatások területen válassza a Logikai alkalmazások lehetőséget.

    Képernyőkép az Azure Portal keresőmezőről, amelyen a logikai alkalmazások keresési szövegként láthatók.

  2. A Logic Apps panelen válassza ki a Visual Studio Code-ból üzembe helyezett logikai alkalmazást.

    Képernyőkép az Azure Portalról és az Azure-ban üzembe helyezett Standard logikai alkalmazáserőforrásokról.

    Az Azure Portal megnyitja a kiválasztott logikai alkalmazás egyéni erőforráslapját.

    Képernyőkép az Azure Portalról és a logikai alkalmazás erőforráslapjáról.

  3. A logikai alkalmazás munkafolyamatainak megtekintéséhez válassza a logikai alkalmazás menüjében a Munkafolyamatok lehetőséget.

    A Munkafolyamatok panel az aktuális logikai alkalmazás összes munkafolyamatát megjeleníti. Ez a példa a Visual Studio Code-ban létrehozott munkafolyamatot mutatja be.

    Képernyőkép a logikai alkalmazás erőforráslapjáról a megnyitott Munkafolyamatok panellel és munkafolyamatokkal.

  4. Munkafolyamat megtekintéséhez válassza ki a munkafolyamatot a Munkafolyamatok panelen.

    Megnyílik a munkafolyamat panel, és további információkat és feladatokat jelenít meg a munkafolyamaton.

    A munkafolyamat lépéseinek megtekintéséhez például válassza a Tervező.

    Képernyőkép a kijelölt munkafolyamat Áttekintés paneljéről, a munkafolyamat menüben pedig a kijelölt

    A munkafolyamat-tervező megnyitja és megjeleníti a Visual Studio Code-ban létrehozott munkafolyamatot. Most már módosíthatja ezt a munkafolyamatot az Azure Portalon.

    Képernyőkép a Visual Studio Code-ból üzembe helyezett munkafolyamat-tervezőről és munkafolyamatról.

Másik munkafolyamat hozzáadása a portálon

Az Azure Portalon üres munkafolyamatokat adhat hozzá a Visual Studio Code-ból üzembe helyezett standard logikai alkalmazás-erőforráshoz, és létrehozhatja ezeket a munkafolyamatokat az Azure Portalon.

  1. Az Azure Portalon válassza ki az üzembe helyezett Standard logikai alkalmazás erőforrását.

  2. A logikai alkalmazás erőforrásmenüjében válassza a Munkafolyamatok lehetőséget. A Munkafolyamatok panelen válassza a Hozzáadás lehetőséget.

    Képernyőkép a kijelölt logikai alkalmazás Munkafolyamatok paneljéről és eszköztárról, amelyen a Hozzáadás parancs van kijelölve.

  3. Az Új munkafolyamat panelen adja meg a munkafolyamat nevét. Válassza az Állapotalapú vagy az Állapot nélküli>létrehozás lehetőséget.

    Miután az Azure üzembe helyezi az új munkafolyamatot, amely a Munkafolyamatok panelen jelenik meg, jelölje ki a munkafolyamatot, hogy kezelni tudja és végrehajthassa az egyéb feladatokat, például megnyithatja a tervezőt vagy a kódnézetet.

    Képernyőkép a kiválasztott munkafolyamatról felügyeleti és felülvizsgálati lehetőségekkel.

    Ha például megnyitja a tervezőt egy új munkafolyamathoz, üres vászon jelenik meg. Ezt a munkafolyamatot most már az Azure Portalon is létrehozhatja.

    Képernyőkép a munkafolyamat-tervezőről és az üres munkafolyamatról.

Futtatási előzmények engedélyezése állapot nélküli munkafolyamatokhoz

Az állapot nélküli munkafolyamatok egyszerűbb hibakereséséhez engedélyezheti a munkafolyamat futtatási előzményeit, majd letilthatja a futtatási előzményeket, amikor elkészült. Kövesse az alábbi lépéseket a Visual Studio Code-hoz, vagy ha az Azure Portalon dolgozik, olvassa el az Egy-bérlős munkafolyamatok létrehozása az Azure Portalon című témakört.

  1. A Visual Studio Code-projekt gyökérmappájának szintjén nyissa meg a local.settings.json fájlt.

  2. Adja hozzá a Workflows.{yourWorkflowName}.operationOptions tulajdonságot, és állítsa az értéket például a következőre WithStatelessRunHistory:

    Windows

    {
       "IsEncrypted": false,
       "Values": {
          "AzureWebJobsStorage": "UseDevelopmentStorage=true",
          "FUNCTIONS_WORKER_RUNTIME": "node",
          "Workflows.{yourWorkflowName}.OperationOptions": "WithStatelessRunHistory"
       }
    }
    

    macOS vagy Linux

    {
       "IsEncrypted": false,
       "Values": {
          "AzureWebJobsStorage": "DefaultEndpointsProtocol=https;AccountName=fabrikamstorageacct; \
              AccountKey=<access-key>;EndpointSuffix=core.windows.net",
          "FUNCTIONS_WORKER_RUNTIME": "node",
          "Workflows.{yourWorkflowName}.OperationOptions": "WithStatelessRunHistory"
       }
    }
    
  3. A munkafolyamat-designtime nevű projektmappában nyissa meg a local.settings.json fájlt, és végezze el ugyanezt a módosítást.

  4. Ha le szeretné tiltani a futtatási előzményeket, amikor elkészült, állítsa be a Workflows.{yourWorkflowName}.OperationOptionstulajdonságot None, vagy törölje a tulajdonságot és annak értékét.

Monitorozási nézet engedélyezése az Azure Portalon

Miután üzembe helyez egy Logikai alkalmazás (Standard) erőforrást a Visual Studio Code-ból az Azure-ba, az Azure Portal és a munkafolyamat monitorozási felületének használatával áttekintheti az adott erőforrás munkafolyamatának rendelkezésre álló futtatási előzményeit és részleteit. Először azonban engedélyeznie kell a Monitor nézet funkciót ezen a logikaialkalmazás-erőforráson.

  1. Az Azure Portalon nyissa meg a Standard logikai alkalmazás erőforrását.

  2. A logikai alkalmazás erőforrásmenüjében, az API alatt válassza a CORS lehetőséget.

  3. A CORS panel Engedélyezett források csoportjában adja hozzá a helyettesítő karaktert (*).

  4. Ha elkészült, a CORS eszköztáron válassza a Mentés lehetőséget.

    Képernyőkép az Azure Portalról az üzembe helyezett Standard logikai alkalmazás erőforrásával. Az erőforrás menüjében a CORS ki van jelölve egy új bejegyzéssel, amely az Engedélyezett források * karakterre van állítva.

Alkalmazás Elemzések engedélyezése vagy megnyitása az üzembe helyezés után

A munkafolyamat végrehajtása során a logikai alkalmazás telemetriát bocsát ki más eseményekkel együtt. Ezzel a telemetriával jobban áttekintheti, hogy a munkafolyamat milyen jól fut, és hogyan működik a Logic Apps futtatókörnyezete különböző módokon. A munkafolyamatot az Application Elemzések használatával figyelheti, amely közel valós idejű telemetriát (élő metrikákat) biztosít. Ez a funkció segít könnyebben kivizsgálni a hibákat és a teljesítményproblémákat, ha ezeket az adatokat használja a problémák diagnosztizálásához, riasztások beállításához és diagramok készítéséhez.

Ha a logikai alkalmazás létrehozási és üzembehelyezési beállításai támogatják az Alkalmazás Elemzések használatát, opcionálisan engedélyezheti a diagnosztikai naplózást és a nyomkövetést a logikai alkalmazáshoz. Ezt megteheti a logikai alkalmazás Visual Studio Code-ból való üzembe helyezésekor vagy az üzembe helyezés után. Rendelkeznie kell egy application Elemzések-példánysal, de ezt az erőforrást előre, a logikai alkalmazás üzembe helyezésekor vagy az üzembe helyezés után is létrehozhatja.

Az alkalmazás Elemzések üzembe helyezett logikai alkalmazásokon való engedélyezéséhez vagy az alkalmazás Elemzések adatainak áttekintéséhez, ha már engedélyezve van, kövesse az alábbi lépéseket:

  1. Az Azure Portalon keresse meg az üzembe helyezett logikai alkalmazást.

  2. A logikai alkalmazás menüjének Gépház területén válassza az Alkalmazás Elemzések lehetőséget.

  3. Ha az alkalmazás Elemzések nincs engedélyezve, az Alkalmazás Elemzések panelen válassza az Alkalmazás Elemzések bekapcsolása lehetőséget. Miután a panel frissült, alul válassza az Alkalmaz lehetőséget.

    Ha az Alkalmazás Elemzések engedélyezve van, az Alkalmazás Elemzések panelen válassza az Alkalmazás megtekintése Elemzések adatok megtekintése lehetőséget.

Az alkalmazás Elemzések megnyitása után áttekintheti a logikai alkalmazás különböző metrikáit. További információkért tekintse át az alábbi témaköröket:

Elemek törlése a tervezőből

Ha törölni szeretne egy elemet a munkafolyamatból a tervezőből, kövesse az alábbi lépéseket:

  • Jelölje ki az elemet, nyissa meg az elem helyi menüjét (Shift+F10), és válassza a Törlés lehetőséget. A megerősítéshez válassza az OK lehetőséget.

  • Jelölje ki az elemet, és nyomja le a delete billentyűt. A megerősítéshez válassza az OK lehetőséget.

  • Jelölje ki az elemet, hogy megnyíljön az adott elem részletes panelje. A panel jobb felső sarkában nyissa meg a három pontot (...) tartalmazó menüt, és válassza a Törlés lehetőséget. A megerősítéshez válassza az OK lehetőséget.

    Képernyőkép a tervező kijelölt eleméről a megnyitott információs panellel, valamint a kijelölt három ponttal és a

    Tipp.

    Ha a három pont menü nem látható, bontsa ki a Visual Studio Code ablakát elég szélesre, hogy a részletek panelen a jobb felső sarokban látható három pont (...) gomb látható legyen.

Hibák és problémák elhárítása

Tervező nem nyílik meg

Amikor megpróbálja megnyitni a tervezőt, a következő hibaüzenet jelenik meg: "A munkafolyamat tervezési ideje nem indítható el". Ha korábban megpróbálta megnyitni a tervezőt, majd megszüntette vagy törölte a projektet, előfordulhat, hogy a bővítménycsomag nem tölthető le megfelelően. Annak ellenőrzéséhez, hogy ez okozza-e a problémát, kövesse az alábbi lépéseket:

  1. A Visual Studio Code-ban nyissa meg a Kimeneti ablakot. A Nézet menüben válassza a Kimenet lehetőséget.

  2. A Kimenet ablak címsorának listájában válassza az Azure Logic Apps (Standard) lehetőséget, hogy áttekinthesse a bővítmény kimenetét, például:

    Képernyőkép a Kimenet ablakról, amelyen az

  3. Tekintse át a kimenetet, és ellenőrizze, hogy megjelenik-e ez a hibaüzenet:

    A host error has occurred during startup operation '{operationID}'.
    System.Private.CoreLib: The file 'C:\Users\{userName}\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.
    

A hiba megoldásához törölje a ExtensionBundles mappát ezen a helyen ...\Users{your-username}\AppData\Local\Temp\Functions\ExtensionBundles, majd próbálja meg újra megnyitni a workflow.json fájlt a tervezőben.

Új eseményindítók és műveletek hiányoznak a tervezőválasztóból a korábban létrehozott munkafolyamatokhoz

Az egybérlős Azure Logic Apps támogatja az Azure-függvényműveletek, a folyékony műveletek és az XML-műveletek, például az XML-ellenőrzés és az XML átalakítása beépített műveleteit. A korábban létrehozott logikai alkalmazások esetében azonban előfordulhat, hogy ezek a műveletek nem jelennek meg a tervezőválasztóban annak kiválasztásához, hogy a Visual Studio Code a bővítménycsomag elavult verzióját használja-e. Microsoft.Azure.Functions.ExtensionBundle.Workflows

Az Azure Function Operations-összekötő és -műveletek nem jelennek meg a tervezőválasztóban, kivéve, ha engedélyezte vagy kiválasztotta az Azure-ból származó összekötők használatát a logikai alkalmazás létrehozásakor. Ha nem engedélyezte az Azure-ban üzembe helyezett összekötőket az alkalmazás létrehozásakor, a Visual Studio Code-ban engedélyezheti őket a projektből. Nyissa meg a workflow.json helyi menüt, és válassza a Csatlakozás orok használata az Azure-ból lehetőséget.

Az elavult csomag kijavításához kövesse az alábbi lépéseket az elavult csomag törléséhez, amely miatt a Visual Studio Code automatikusan frissíti a bővítménycsomagot a legújabb verzióra.

Feljegyzés

Ez a megoldás csak azOkra a logikai alkalmazásokra vonatkozik, amelyeket a Visual Studio Code-tal az Azure Logic Apps (Standard) bővítménnyel hoz létre és helyez üzembe, nem pedig az Azure Portalon létrehozott logikai alkalmazásokra. Lásd: A támogatott eseményindítók és műveletek hiányoznak a tervezőből az Azure Portalon.

  1. Mentsen minden olyan munkát, amelyet nem szeretne elveszíteni, és zárja be a Visual Studiót.

  2. A számítógépen keresse meg a következő mappát, amely a meglévő csomag verziószámozott mappáit tartalmazza:

    ...\Users\{your-username}\.azure-functions-core-tools\Functions\ExtensionBundles\Microsoft.Azure.Functions.ExtensionBundle.Workflows

  3. Törölje a korábbi csomag verziómappájának tartalmát, például ha rendelkezik az 1.1.3-es verzióhoz tartozó mappával, törölje a mappát.

  4. Most keresse meg a következő mappát, amely verziószámozott mappákat tartalmaz a szükséges NuGet-csomaghoz:

    ...\Users\{your-username}\.nuget\packages\microsoft.azure.workflows.webjobs.extension

  5. Törölje a korábbi csomag verziómappájának tartalmát.

  6. Nyissa meg újra a Visual Studio Code-ot, a projektet és a workflow.json fájlt a tervezőben.

A hiányzó eseményindítók és műveletek most már megjelennek a tervezőben.

A "400 hibás kérelem" egy eseményindítón vagy műveleten jelenik meg

Ha egy futtatás sikertelen, és figyelési nézetben vizsgálja meg a futtatást, ez a hiba egy hosszabb nevű eseményindítón vagy műveleten jelenhet meg, ami miatt az alapul szolgáló egységes erőforrás-azonosító (URI) túllépi az alapértelmezett karakterkorlátot.

A probléma megoldásához és a hosszabb URI beállításához szerkessze a számítógépen található UrlSegmentMaxCount beállításkulcsokat UrlSegmentMaxLength az alábbi lépések végrehajtásával. A kulcs alapértelmezett értékeit ebben a témakörben ismertetjük, Http.sys a Windows beállításjegyzék-beállításait.

Fontos

Mielőtt hozzákezd, győződjön meg arról, hogy menti a munkáját. Ennek a megoldásnak a elvégzése után újra kell indítania a számítógépet, hogy a módosítások érvénybe léphessenek.

  1. Nyissa meg a számítógépen a Futtatás ablakot, és futtassa a regedit parancsot, amely megnyitja a beállításszerkesztőt.

  2. A Felhasználói fiókok felügyelete mezőben válassza az Igen lehetőséget a számítógép módosításainak engedélyezéséhez.

  3. A bal oldali panel Számítógép területén bontsa ki a csomópontokat az elérési út mentén, HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\HTTP\Parameters, majd válassza a Paraméterek lehetőséget.

  4. A jobb oldali panelen keresse meg a beállításkulcsokat és UrlSegmentMaxLength a UrlSegmentMaxCount beállításkulcsokat.

  5. Növelje ezeket a kulcsértékeket úgy, hogy az URI-k el tudják fogadni a használni kívánt neveket. Ha ezek a kulcsok nem léteznek, vegye fel őket a Paraméterek mappába az alábbi lépések végrehajtásával:

    1. A Paraméterek helyi menüben válassza az Új>DWORD (32 bites) érték lehetőséget.

    2. A megjelenő szerkesztési mezőben adja meg UrlSegmentMaxCount az új kulcsnevet.

    3. Nyissa meg az új kulcs helyi menüjét, és válassza a Módosítás lehetőséget.

    4. A megjelenő Sztring szerkesztése mezőbe írja be a kívánt értékadatkulcs értékét hexadecimális vagy decimális formátumban. A hexadecimális érték például 400 decimális értéknek 1024 felel meg.

    5. A kulcsérték hozzáadásához UrlSegmentMaxLength ismételje meg ezeket a lépéseket.

    A kulcsértékek növelése vagy hozzáadása után a beállításszerkesztő a következő példához hasonlóan néz ki:

    Képernyőkép a beállításszerkesztőről.

  6. Ha elkészült, indítsa újra a számítógépet, hogy a módosítások érvénybe léphessenek.

A hibakeresési munkamenet nem indul el

Amikor megpróbál elindítani egy hibakeresési munkamenetet, a következő hibaüzenet jelenik meg: "Hiba a preLaunchTask 'generateDebugSymbols' futtatása után létezik". A probléma megoldásához szerkessze a projekt tasks.json fájlját a szimbólumok létrehozásának kihagyásához.

  1. A projektben bontsa ki a .vscode nevű mappát, és nyissa meg a tasks.json fájlt.

  2. A következő feladatban törölje a sort, "dependsOn: "generateDebugSymbols"valamint az előző sort lezáró vesszőt, például:

    Előtte:

     {
       "type": "func",
       "command": "host start",
       "problemMatcher": "$func-watch",
       "isBackground": true,
       "dependsOn": "generateDebugSymbols"
     }
    

    Utána:

     {
       "type": "func",
       "command": "host start",
       "problemMatcher": "$func-watch",
       "isBackground": true
     }
    

Következő lépések

Szeretnénk hallani öntől az Azure Logic Apps (Standard) bővítménysel kapcsolatos tapasztalatait!