Rövid útmutató: Logikai alkalmazás munkafolyamat-definícióinak létrehozása és kezelése több-bérlős Azure Logic Apps és Visual Studio Code használatával

A következőkre vonatkozik: Azure Logic Apps (Használat)

Ez a rövid útmutató bemutatja, hogyan hozhat létre és kezelhet olyan logikai alkalmazás-munkafolyamatokat, amelyek segítségével automatizálhatja az alkalmazásokat, adatokat, rendszereket és szolgáltatásokat a szervezetek és vállalatok között többtényezős Azure Logic Apps és Visual Studio Code használatával integráló feladatokat és folyamatokat. Létrehozhatja és szerkesztheti a mögöttes munkafolyamat-definíciókat, amelyek JavaScript Object Notationt (JSON) használnak a logikai alkalmazásokhoz egy kódalapú felületen keresztül. Az Azure-ban már üzembe helyezett meglévő logikai alkalmazásokon is dolgozhat. A több-bérlős és az egybérlős modellel kapcsolatos további információkért tekintse át az egybérlős és a több-bérlős és az integrációs szolgáltatási környezetet.

Bár ugyanezeket a feladatokat az Azure Portalon és a Visual Studióban is elvégezheti, gyorsabban kezdhet a Visual Studio Code-ban, ha már ismeri a logikai alkalmazások definícióit, és közvetlenül a kódban szeretne dolgozni. Letilthatja, engedélyezheti, törölheti és frissítheti például a már létrehozott logikai alkalmazásokat. Emellett a Visual Studio Code-ot futtató bármely fejlesztési platformon használhat logikai alkalmazásokat és integrációs fiókokat, például Linuxot, Windowst és Macet.

Ebben a cikkben ugyanazt a logikai alkalmazást hozhatja létre ebből a rövid útmutatóból, amely az alapfogalmakra összpontosít. Megtudhatja azt is , hogyan hozhatja létre a példaalkalmazást a Visual Studióban, és megtudhatja, hogyan hozhat létre és kezelhet alkalmazásokat az Azure CLI-vel. A Visual Studio Code-ban a logikai alkalmazás a következő példához hasonlóan néz ki:

Előfeltételek

Mielőtt nekikezdene, győződjön meg arról, hogy rendelkezik a következőkkel:

• Ha nem rendelkezik Azure-fiókkal és -előfizetéssel, regisztráljon egy ingyenes Azure-fiókra.

• A logikai alkalmazás munkafolyamat-definícióinak és szerkezetének alapszintű ismerete a JSON-ban leírtak szerint

  Ha még nem ismerkedik az Azure Logic Appsszel, próbálja ki ezt a rövid útmutatót, amely létrehozza az első logikai alkalmazás munkafolyamatát az Azure Portalon, és az alapvető fogalmakra összpontosít.

• A webes hozzáférés az Azure-ba és az Azure-előfizetésbe való bejelentkezéshez

• Ha még nincsenek telepítve, töltse le és telepítse az alábbi eszközöket:

  • A Visual Studio Code 1.25.1-es vagy újabb verziója, amely ingyenes

  • Visual Studio Code-bővítmény az Azure Logic Appshez

    Ezt a bővítményt letöltheti és telepítheti a Visual Studio Marketplace-ről vagy közvetlenül a Visual Studio Code-ból. A telepítés után győződjön meg arról, hogy újra betölti a Visual Studio Code-ot.

    

    Ha ellenőrizni szeretné, hogy a bővítmény megfelelően lett-e telepítve, válassza a Visual Studio Code eszköztárán megjelenő Azure-ikont.

    

    További információ: Extension Marketplace. A bővítmény nyílt forráskódú verziójához való hozzájáruláshoz látogasson el a Visual Studio Code-hoz készült Azure Logic Apps-bővítményhez a GitHubon.

• Ha a logikai alkalmazásnak olyan tűzfalon keresztül kell kommunikálnia, amely meghatározott IP-címekre korlátozza a forgalmat, a tűzfalnak engedélyeznie kell a hozzáférést mind az Azure Logic Apps által használt bejövő, mind a kimenő IP-címekhez, vagy a futtatókörnyezethez abban az Azure-régióban, ahol a logikai alkalmazás létezik. Ha a logikai alkalmazás felügyelt összekötőket is használ, például az Office 365 Outlook-összekötőt vagy az SQL-összekötőt, vagy egyéni összekötőket használ, a tűzfalnak engedélyeznie kell a hozzáférést a logikai alkalmazás Azure-régiójában lévő összes felügyelt összekötő kimenő IP-címéhez.

Az Azure elérése a Visual Studio Code-ból

1. Nyissa meg a Visual Studio Code-ot. A Visual Studio Code eszköztárán válassza az Azure ikont.

   

2. Az Azure-ablakban, a Logic Apps alatt válassza a Bejelentkezés az Azure-ba lehetőséget. Amikor a Microsoft bejelentkezési oldal rákérdez, jelentkezzen be az Azure-fiókjával.

   

   1. Ha a bejelentkezés a szokásosnál tovább tart, a Visual Studio Code egy eszközkód megadásával kéri, hogy jelentkezzen be egy Microsoft-hitelesítési webhelyen keresztül. Ha inkább a kóddal szeretne bejelentkezni, válassza az Eszközkód használata lehetőséget.

      

   2. A kód másolásához válassza a Másolás > Megnyitás lehetőséget.

      

   3. Új böngészőablak megnyitásához és a hitelesítési webhely megnyitásához válassza a Hivatkozás megnyitása lehetőséget.

      

   4. A fióklapra való bejelentkezéskor adja meg a hitelesítési kódot, és válassza a Tovább gombot.

      

3. Válassza ki az Azure-fiókját. A bejelentkezés után bezárhatja a böngészőt, és visszatérhet a Visual Studio Code-hoz.

   Az Azure-ablaktáblán a Logic Apps és az Integrációs fiókok szakasz mostantól megjeleníti a fiókjához társított Azure-előfizetéseket. Ha azonban nem látja a várt előfizetéseket, vagy ha a szakaszok túl sok előfizetést mutatnak, kövesse az alábbi lépéseket:

   1. Vigye az egérmutatót a Logic Apps címkéje fölé. Amikor megjelenik az eszköztár, válassza az Előfizetések kiválasztása (szűrőikon) lehetőséget.

      

   2. A megjelenő listában válassza ki a megjeleníteni kívánt előfizetéseket.

4. A Logic Apps alatt válassza ki a kívánt előfizetést. Az előfizetési csomópont kibontja és megjeleníti az előfizetésben található logikai alkalmazásokat.

   

   Tipp.

   Az Integrációs fiókok területen az előfizetés kiválasztásakor megjelennek az adott előfizetésben található integrációs fiókok.

Új logikai alkalmazás létrehozása

1. Ha még nem jelentkezett be az Azure-fiókjába és az előfizetésbe a Visual Studio Code-on belül, a bejelentkezéshez kövesse az előző lépéseket.

2. A Visual Studio Code-ban a Logic Apps alatt nyissa meg az előfizetés helyi menüjét, és válassza a Logikai alkalmazás létrehozása lehetőséget.

   

   Megjelenik egy lista, amely megjeleníti az előfizetésben lévő Azure-erőforráscsoportokat.

3. Az erőforráscsoportok listájában válassza az Új erőforráscsoport létrehozása vagy egy meglévő erőforráscsoport létrehozása lehetőséget. Ebben a példában hozzon létre egy új erőforráscsoportot.

   

4. Adjon nevet az Azure-erőforráscsoportnak, és nyomja le az ENTER billentyűt.

   

5. Válassza ki azt az Azure-régiót, ahol menteni szeretné a logikai alkalmazás metaadatait.

   

6. Adjon nevet a logikai alkalmazásnak, és nyomja le az Enter billentyűt.

   

   Az Azure-ablakban az Azure-előfizetés alatt megjelenik az új és üres logikai alkalmazás. A Visual Studio Code egy JSON-fájlt (.logicapp.json) is megnyit, amely tartalmaz egy csontváz-munkafolyamat-definíciót a logikai alkalmazáshoz. Most már manuálisan is létrehozhatja a logikai alkalmazás munkafolyamat-definícióját ebben a JSON-fájlban. A munkafolyamat-definíciók struktúrájáról és szintaxisáról az Azure Logic Apps Munkafolyamat-definíciós nyelvi sémája című témakörben olvashat.

   

   Itt látható például egy minta logikai alkalmazás munkafolyamat-definíciója, amely RSS-eseményindítóval és Office 365 Outlook-művelettel kezdődik. A JSON-elemek általában betűrendben jelennek meg az egyes szakaszokban. Ez a minta azonban nagyjából abban a sorrendben jeleníti meg ezeket az elemeket, ahogyan a logikai alkalmazás lépései megjelennek a tervezőben.

   Fontos

   Ha újra fel szeretné használni ezt a logikai alkalmazásdefiníciót, szüksége van például egy szervezeti fiókra. @fabrikam.com Győződjön meg arról, hogy a fiktív e-mail-címet a saját e-mail-címére cseréli. Ha másik e-mail-összekötőt szeretne használni, például Outlook.com vagy Gmailt, cserélje le a műveletet egy, az Send_an_email_action Azure Logic Apps által támogatott e-mail-összekötőből elérhető hasonló műveletre.

   Ha a Gmail-összekötőt szeretné használni, csak a G-Suite üzleti fiókok használhatják ezt az összekötőt korlátozás nélkül a logikai alkalmazásokban. Ha gmailes felhasználói fiókkal rendelkezik, ezt az összekötőt csak meghatározott Google által jóváhagyott szolgáltatásokkal használhatja , vagy létrehozhat egy Google-ügyfélalkalmazást a Gmail-összekötővel való hitelesítéshez. További információ: Adatbiztonsági és adatvédelmi szabályzatok a Google-összekötőkhöz az Azure Logic Appsben.

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

7. Ha elkészült, mentse a logikai alkalmazás munkafolyamat-definícióját. (Fájl menü > Mentés, vagy nyomja le a Ctrl+S billentyűkombinációt)

8. Amikor a rendszer kéri, hogy töltse fel a logikai alkalmazást az Azure-előfizetésbe, válassza a Feltöltés lehetőséget.

   Ez a lépés közzéteszi a logikai alkalmazást az Azure Portalon, amely élővé és futtathatóvá teszi a logikát az Azure-ban.

   

Logikai alkalmazás megtekintése tervezőben

A Visual Studio Code-ban a logikai alkalmazást írásvédett tervező nézetben nyithatja meg. Bár a tervezőben nem szerkesztheti a logikai alkalmazást, vizuálisan ellenőrizheti a logikai alkalmazás munkafolyamatát a tervező nézet használatával.

Az Azure-ablakban, a Logic Apps alatt nyissa meg a logikai alkalmazás helyi menüjét, és válassza a Megnyitás Tervező lehetőséget.

Az írásvédett tervező egy külön ablakban nyílik meg, és megjeleníti a logikai alkalmazás munkafolyamatát, például:

Megtekintés az Azure Portalon

A logikai alkalmazás Azure Portalon való áttekintéséhez kövesse az alábbi lépéseket:

1. Jelentkezzen be az Azure Portalra ugyanazzal az Azure-fiókkal és előfizetéssel, amely a logikai alkalmazáshoz van társítva.

2. Az Azure Portal keresőmezőjébe írja be a logikai alkalmazások nevét. Az eredmények listájában válassza ki a logikai alkalmazást.

   

Üzembe helyezett logikai alkalmazás szerkesztése

A Visual Studio Code-ban megnyithatja és szerkesztheti egy már üzembe helyezett logikai alkalmazás munkafolyamat-definícióját az Azure-ban.

Fontos

Mielőtt éles környezetben aktívan futó logikai alkalmazást szerkesztené, kerülje a logikai alkalmazás feltörésének kockázatát, és a logikai alkalmazás első letiltásával minimalizálja a fennakadást.

1. Ha még nem jelentkezett be az Azure-fiókjába és az előfizetésbe a Visual Studio Code-on belül, a bejelentkezéshez kövesse az előző lépéseket.

2. Az Azure-ablakban, a Logic Apps alatt bontsa ki az Azure-előfizetést, és válassza ki a kívánt logikai alkalmazást.

3. Nyissa meg a logikai alkalmazás menüjét, és válassza a Megnyitás a Szerkesztőben lehetőséget. Vagy a logikai alkalmazás neve mellett válassza a szerkesztés ikont.

   

   A Visual Studio Code megnyitja a .logicapp.json fájlt a helyi ideiglenes mappában, hogy megtekinthesse a logikai alkalmazás munkafolyamat-definícióját.

   

4. Végezze el a módosításokat a logikai alkalmazás munkafolyamat-definíciójában.

5. Miután végzett, mentse a módosításokat. (Fájl menü > Mentés, vagy nyomja le a Ctrl+S billentyűkombinációt)

6. Amikor a rendszer felkéri a módosítások feltöltésére és a meglévő logikai alkalmazás felülírására az Azure Portalon, válassza a Feltöltés lehetőséget.

   Ez a lépés közzéteszi a frissítéseket a logikai alkalmazásban az Azure Portalon.

   

Más verziók megtekintése vagy előléptetése

A Visual Studio Code-ban megnyithatja és áttekintheti a logikai alkalmazás korábbi verzióit. Előléptethet egy korábbi verziót is az aktuális verzióra.

Fontos

Mielőtt éles környezetben módosít egy aktívan futó logikai alkalmazást, kerülje a logikai alkalmazás feltörésének kockázatát, és a logikai alkalmazás első letiltásával minimalizálja a fennakadást.

1. Az Azure-ablakban, a Logic Apps alatt bontsa ki az Azure-előfizetést, hogy az előfizetésben lévő összes logikai alkalmazást megtekinthesse.

2. Az előfizetés alatt bontsa ki a logikai alkalmazást, és bontsa ki a Verziók elemet.

   A Verziók lista megjeleníti a logikai alkalmazás korábbi verzióit, ha vannak ilyenek.

   

3. Egy korábbi verzió megtekintéséhez válassza a következő lépéseket:

   • A JSON-definíció megtekintéséhez a Verziók területen válassza ki a definíció verziószámát. Vagy nyissa meg a verzió helyi menüjét, és válassza a Megnyitás a Szerkesztőben lehetőséget.

     Megnyílik egy új fájl a helyi számítógépen, és megjeleníti az adott verzió JSON-definícióját.

   • Ha csak olvasható tervező nézetben szeretné megtekinteni a verziót, nyissa meg a verzió helyi menüjét, és válassza a Megnyitás Tervező lehetőséget.

4. Ha egy korábbi verziót az aktuális verzióra szeretne előléptetni, kövesse az alábbi lépéseket:

   1. A Verziók területen nyissa meg a korábbi verzió helyi menüjét, és válassza az Előléptetés lehetőséget.

      

   2. Ha folytatni szeretné a folytatást, miután a Visual Studio Code megerősítést kér, válassza az Igen lehetőséget.

      

      A Visual Studio Code előlépteti a kijelölt verziót az aktuális verzióhoz, és új számot rendel hozzá az előléptetett verzióhoz. A korábban aktuális verzió megjelenik az előléptetett verzió alatt.

Logikai alkalmazások letiltása vagy engedélyezése

A Visual Studio Code-ban, ha szerkeszt egy közzétett logikai alkalmazást, és menti a módosításokat, felülírja a már üzembe helyezett alkalmazást. A logikai alkalmazás éles környezetben való feltörésének elkerülése és a megszakítás minimalizálása érdekében először tiltsa le a logikai alkalmazást. Ezután újraaktiválhatja a logikai alkalmazást, miután meggyőződött arról, hogy a logikai alkalmazás továbbra is működik.

• Az Azure Logic Apps mindaddig folytatja a folyamatban lévő és függőben lévő futtatásokat, amíg be nem fejeződnek. A kötet vagy a hátralék alapján ez a folyamat eltarthat egy ideig.

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

• Az eseményindító nem aktiválódik a következő alkalommal, amikor a feltételek teljesülnek.

• Az eseményindító állapota megjegyzi a logikai alkalmazás leállításának pontját. Így ha újraaktiválja a logikai alkalmazást, az eseményindító az utolsó futtatás óta aktiválódik az összes feldolgozatlan elemnél.

  Ha meg szeretné akadályozni, hogy az 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 újraaktiválása előtt:

  1. A logikai alkalmazásban szerkessze a munkafolyamat eseményindítójának bármely részét.
  2. Mentse a módosításokat. Ez a lépés alaphelyzetbe állítja az eseményindító aktuális állapotát.
  3. Aktiválja újra a logikai alkalmazást.

• Ha egy munkafolyamat le van tiltva, továbbra is újraküldheti a futtatásokat.

1. Ha még nem jelentkezett be az Azure-fiókjába és az előfizetésbe a Visual Studio Code-on belül, a bejelentkezéshez kövesse az előző lépéseket.

2. Az Azure-ablakban, a Logic Apps alatt bontsa ki az Azure-előfizetést, hogy az előfizetésben lévő összes logikai alkalmazást megtekinthesse.

   1. A kívánt logikai alkalmazás letiltásához nyissa meg a logikai alkalmazás menüjét, és válassza a Letiltás lehetőséget.

      

   2. Ha készen áll a logikai alkalmazás újraaktiválására, nyissa meg a logikai alkalmazás menüjét, és válassza az Engedélyezés lehetőséget.

      

Logikai alkalmazások törlése

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

• Az Azure Logic Apps mindent megtesz annak érdekében, hogy megszakítsa a folyamatban lévő és függőben lévő futtatásokat.

  A legtöbb futtatás még nagy mennyiségű vagy hátralék esetén is megszakad, mielőtt befejeződnének vagy elindulnának. A lemondási folyamat azonban időt vehet igénybe. Eközben előfordulhat, hogy egyes futtatások végrehajtásra kerülnek, amíg a szolgáltatás a lemondási folyamaton keresztül működik.

• 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 törölt munkafolyamatnak nevezett munkafolyamatokat újra kell mentenie. Í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.

1. Ha még nem jelentkezett be az Azure-fiókjába és az előfizetésbe a Visual Studio Code-on belül, a bejelentkezéshez kövesse az előző lépéseket.

2. Az Azure-ablakban, a Logic Apps alatt bontsa ki az Azure-előfizetést, hogy az előfizetésben lévő összes logikai alkalmazást megtekinthesse.

3. Keresse meg a törölni kívánt logikai alkalmazást, nyissa meg a logikai alkalmazás menüjét, és válassza a Törlés lehetőséget.

   

Következő lépések

Egybérlős logikai alkalmazás munkafolyamatainak létrehozása a Visual Studio Code-ban