Oktatóanyag: Automatizált munkafolyamat létrehozása, amely az Azure Functions és az Azure Storage használatával dolgozza fel az e-maileket az Azure Logic Appsben

A következőkre vonatkozik: Azure Logic Apps (Fogyasztás)

Ez az oktatóanyag bemutatja, hogyan hozhat létre egy példa-munkafolyamatot, amely integrálja az Azure Functionst és az Azure Storage-t az Azure Logic Apps használatával. Ez a példa kifejezetten létrehoz egy Használat logikai alkalmazás munkafolyamatot, amely kezeli a bejövő e-maileket és a mellékleteket, elemzi az e-mail-tartalmat az Azure Functions használatával, menti a tartalmat az Azure Storage-ba, és e-mailt küld a tartalom áttekintéséhez.

Amikor végzett, a munkafolyamat a következő magas szintű példához hasonlóan néz ki:

Képernyőkép, amely a Fogyasztás munkafolyamat egy magas szintű példáját mutatja.

Tipp

További információért tegye fel az Azure Copilotnak az alábbi kérdéseket:

  • Mi az Azure Logic Apps?
  • Mi az Azure Functions?
  • Mi az Azure Storage?
  • Mi a fogyasztási logikai alkalmazás munkafolyamata?

Az Azure Copilot megkereséséhez az Azure Portal eszköztárán válassza a Copilot lehetőséget.

Létrehozhat egy hasonló munkafolyamatot egy Standard logikaialkalmazás-erőforrással, ahol néhány összekötőművelet, például az Azure Blob Storage beépített, szolgáltatóalapú műveletként is elérhető. A felhasználói élmény és az oktatóanyag lépései azonban kissé eltérnek a Használat verziótól.

Előfeltételek

Tároló beállítása a mellékletek mentésére

Az alábbi lépésekkel beállíthatja az Azure Storage-t , hogy blobokként tárolhassa a bejövő e-maileket és mellékleteket.

  1. Az Azure Portalon jelentkezzen be az Azure-fiók hitelesítő adataival.

  2. Ezeket a lépéseket követve hozzon létre egy tárfiókot , hacsak még nem rendelkezik ilyen fiókkal.

    Az Alapok lapon adja meg a következő információkat:

    Tulajdonság Kötelező Érték Leírás
    Előfizetés Igen < Azure-előfizetés-neve> Az Azure-előfizetés neve.

    Ez a példa használatalapú fizetést használ.
    Erőforráscsoport Igen < Azure-erőforráscsoport> A kapcsolódó erőforrások rendezéséhez és felügyeletéhez használt Azure-erőforráscsoport neve.

    Megjegyzés: Az erőforráscsoportok adott régiókon belül léteznek. Bár az ebben az oktatóanyagban bemutatott elemek nem feltétlenül érhetőek el minden régióban, igyekezzen ugyanazt a régiót használni, amikor csak lehetséges.

    Ez a példa a LA-Tutorial-RG függvényt használja.
    Tárfiók neve Igen < Azure-tárfiók neve> Az egyedi tárfiók nevének 3–24 karakterből kell lennie, és csak kisbetűket és számokat tartalmazhat.

    Ez a példa a attachmentstorageacct parancsot használja.
    Régió Igen < Azure-régió> A tárfiók Azure-adatrégiója.

    Ez a példa az USA nyugati régióját használja.
    Elsődleges szolgáltatás Nem < Azure-storage-service> A tárfiókban használni kívánt elsődleges tárolási típus. Tekintse meg az adatok Azure-ban való tárolásának áttekintési lehetőségeit.
    Teljesítmény Igen - Szabvány
    - Prémium
    Ez a beállítás adja meg a támogatott adattípusokat és az adathordozót az adatok tárolásához. Lásd: Tárfiókok áttekintése.

    Ez a példa a Standardot használja.
    Redundancia Igen - Helyileg redundáns tárolás
    - Georedundáns tárolás (GRS)
    Ez a beállítás lehetővé teszi az adatok több másolatának tárolását a tervezett és nem tervezett események elleni védelemként. További információ: Azure Storage-redundancia.

    Ez a példa georedundáns tárolást (GRS) használ.

    A tárfiók létrehozásához az Azure PowerShellt vagy az Azure CLI-t is használhatja.

  3. Ha elkészült, válassza a Véleményezés + létrehozás lehetőséget. Miután az Azure ellenőrzi a tárfiók-erőforrással kapcsolatos információkat, válassza a Létrehozás lehetőséget.

  4. Miután az Azure üzembe helyezi a tárfiókot, válassza az Ugrás az erőforrásra lehetőséget. Vagy keresse meg és válassza ki a tárfiókot az Azure keresőmezőjének használatával.

  5. Az alábbi lépések végrehajtásával szerezze be a tárfiók hozzáférési kulcsát:

    1. A Tárfiók menü Biztonság + hálózatkezelés területén válassza az Access-kulcsokat.

    2. Másolja ki a tárfiók nevét és kulcsát1. Mentse ezeket az értékeket biztonságos helyre később.

    A tárfiók hozzáférési kulcsát az Azure PowerShell vagy az Azure CLI használatával is lekérheti.

  6. Hozzon létre egy Blob Storage-tárolót az e-mail-mellékletek számára.

    1. A Tárfiók menüben, az Adattárolás alatt válassza a Tárolók lehetőséget.

    2. A Tárolók lap eszköztárán válassza a Tároló lehetőséget.

    3. Az Új tároló panelen adja meg a következő információkat:

      Tulajdonság Érték Leírás
      Név Mellékletek A tároló neve.
      Névtelen hozzáférési szint Tároló (tárolók és blobok névtelen olvasási hozzáférése)
    4. Válassza a Létrehozás lehetőséget.

    A befejezés után a tárolók listájában megjelenik az új tároló.

Tároló létrehozásához használhatja az Azure PowerShellt vagy az Azure CLI-t is.

Ezután csatlakoztassa a Storage Explorert a tárfiókhoz.

A Storage Explorer beállítása

Az alábbi lépések csatlakoztatják a Storage Explorert a tárfiókhoz, így meggyőződhet arról, hogy a munkafolyamat megfelelően menti a mellékleteket blobként a tárolóban.

  1. Indítsa el Microsoft Azure Storage Explorert. Jelentkezzen be Azure-fiókjával.

    Megjegyzés

    Ha nem jelenik meg kérdés, a Storage Explorer tevékenységsávján válassza a Fiókkezelés (profil ikon) lehetőséget.

  2. Az Azure Environment kiválasztása ablakban válassza ki az Azure-környezetet, majd válassza a Tovább lehetőséget.

    Ez a példa a globális, több-bérlős Azure kiválasztásával folytatódik.

  3. A megjelenő böngészőablakban jelentkezzen be az Azure-fiókjával.

  4. Térjen vissza a Storage Explorerbe és a Fiókkezelés ablakba. Ellenőrizze, hogy a megfelelő Microsoft Entra-bérlő és -előfizetés van-e kiválasztva.

  5. A Storage Explorer tevékenységsávján válassza a Csatlakozás megnyitása párbeszédpanelt.

  6. Az Erőforrás kiválasztása ablakban válassza a Tárfiók vagy szolgáltatás lehetőséget.

  7. A Kapcsolati módszer kiválasztása ablakban válassza a Fióknév és kulcs>, majd kattintson a Tovább gombra.

  8. A Csatlakozás az Azure Storage-hoz ablakban adja meg a következő információkat:

    Tulajdonság Érték
    Megjelenített név A kapcsolat barátságos neve
    Fióknév A tárfiók neve
    Fiókkulcs A korábban mentett hozzáférési kulcs
  9. Storage-tartomány esetén győződjön meg arról, hogy az Azure (core.windows.net) ki van jelölve, és válassza a Tovább lehetőséget.

  10. Az Összegzés ablakban erősítse meg a kapcsolat adatait, és válassza a Csatlakozás lehetőséget.

    A Storage Explorer létrehozza a kapcsolatot. A tárfiók megjelenik az Explorer ablakban az Engedélyezett & Csatolt Tárfiókok alatt.

  11. A Blob Storage tároló megtalálásához a Tárfiókok területen bontsa ki a tárfiókot, amely ebben a példában a attachmentstorageacct. A Blob-tárolók között, ahol a mellékletek tárolóját találja, például:

    Képernyőkép a Storage Explorerről – Tároló keresése.

Ezután hozzon létre egy Azure-függvényalkalmazást és egy függvényt, amely eltávolítja a HTML-t a tartalomból.

Függvényalkalmazás létrehozása

Az alábbi lépések létrehoznak egy Azure-függvényt, amelyet a munkafolyamat meghív, hogy eltávolítsa a HTML-t a bejövő e-mailekből.

  1. Mielőtt létre tud hozni egy függvényt, hozzon létre egy függvényalkalmazást a Használati terv kiválasztásával, és kövesse az alábbi lépéseket:

    1. Az Alapok lapon adja meg a következő információkat:

      Tulajdonság Kötelező Érték Leírás
      Előfizetés Igen < Azure-előfizetés-neve> Ugyanaz az Azure-előfizetés, amelyet korábban a tárfiókjához használt.
      Erőforráscsoport Igen < Azure-erőforráscsoport-neve> Ugyanaz az Azure-erőforráscsoport, amelyet korábban a tárfiókjához használt.

      Ebben a példában válassza az LA-Tutorial-RG lehetőséget.
      Függvényalkalmazás neve Igen < function-app-name> A függvényalkalmazás nevének egyedinek kell lennie az Azure-régiókban, és csak betűket (kis- és nagybetűket), számokat (0-9) és kötőjeleket (-) tartalmazhat.

      Ez a példa már használja a CleanTextFunctionApp alkalmazást, ezért adjon meg egy másik nevet, például MyCleanTextFunctionApp-your-name<>
      Futtatókörnyezeti verem Igen < programozási nyelv> Az előnyben részesített függvény programozási nyelvének futtatókörnyezete. C# és F# függvények esetén válassza a .NET lehetőséget.

      Ez a példa .NET-et használ.

      A portálon belüli szerkesztés csak a következő nyelveken érhető el:

      -Javascript
      -Powershell
      - TypeScript
      - C#-szkript

      Minden C#-osztálykódtárat, Java- és Python-függvényt helyileg kell fejlesztenie .
      Verzió Igen < verziószám> Válassza ki a telepített futtatókörnyezet verzióját.
      Régió Igen < Azure-régió> Ugyanaz a régió, amelyet korábban használt.

      Ez a példa az USA nyugati régióját használja.
      Operációs rendszer Igen < operációs rendszer> Az operációs rendszert előre kiválasztjuk Önnek a futtatási verem alapján, de választhat olyan operációs rendszert is, amely támogatja kedvenc függvényprogramozási nyelvét. A portálon belüli szerkesztés csak Windows rendszeren támogatott.

      Ez a példa a Windowst jelöli ki.
    2. Válassza a Tovább: Tárolás lehetőséget. A Tárolás lapon adja meg a következő információkat:

      Tulajdonság Kötelező Érték Leírás
      Tárhely-fiók Igen < Azure-tárfiók neve> Hozzon létre egy tárfiókot a függvényalkalmazáshoz. A tárfiókok nevének 3 és 24 karakter közötti hosszúságúnak kell lennie, és csak kisbetűket és számokat tartalmazhat.

      Ez a példa a cleantextfunctionstorageacctot használja.

      Megjegyzés: Ez a tárfiók tartalmazza a függvényalkalmazásokat, és eltér az e-mail mellékletekhez korábban létrehozott tárfióktól. Használhat egy meglévő fiókot is, amelynek meg kell felelnie a tárfiók követelményeinek.
    3. Ha végzett, válassza a Véleményezés + létrehozás lehetőséget. Miután az Azure érvényesítette a megadott adatokat, válassza a Létrehozás lehetőséget.

    4. Miután az Azure üzembe helyezi a függvényalkalmazás-erőforrást, válassza az Ugrás az erőforrásra lehetőséget.

Függvény létrehozása a HTML eltávolításához

Az alábbi lépések létrehoznak egy Azure-függvényt c# nyelven, amely a mintakódrészlet használatával eltávolítja a HTML-t az egyes bejövő e-mailekből. Ez a függvény tisztábbá és könnyebben feldolgozhatóvá teszi az e-mail-tartalmat. Ezt a függvényt a munkafolyamatból hívhatja meg.

  1. Az Azure Portalon nyissa meg a függvényalkalmazást, ha még nem nyitotta meg.

  2. Ha később szeretné futtatni a függvényt az Azure Portalon, állítsa be a függvényalkalmazást, hogy explicit módon fogadja el a portálról érkező kéréseket. A függvényalkalmazás menüjében, az API alatt válassza a CORS lehetőséget. Az Engedélyezett források alatt adja meg https://portal.azure.com, majd válassza a Mentés lehetőséget.

  3. A függvényalkalmazás menüjében válassza az Áttekintés lehetőséget. A Függvények lapon válassza a Létrehozás lehetőséget.

    Megjegyzés

    Ha nem látja a Létrehozás gombot, helyileg kell létrehoznia a függvényt.

  4. Az alábbi általános lépéseket követve hozza létre a függvényt c# nyelven a HTTP-eseményindító sablonnal, és adja meg a következő információkat a függvényhez:

    Paraméter Érték
    Függvény neve RemoveHTMLFunction
    Engedélyszint Függvény
  5. A Kód + Teszt lapon adja meg a következő C# mintakódot, amely eltávolítja a HTML-t, és visszaadja az eredményeket a hívónak.

    #r "Newtonsoft.Json"
    
    using System.Net;
    using Microsoft.AspNetCore.Mvc;
    using Microsoft.Extensions.Primitives;
    using Newtonsoft.Json;
    using System.Text.RegularExpressions;
    
    public static async Task<IActionResult> Run(HttpRequest req, ILogger log)
    {
       log.LogInformation("HttpWebhook triggered");
    
       // Parse query parameter
       string emailBodyContent = await new StreamReader(req.Body).ReadToEndAsync();
    
       // Replace HTML with other characters
       string updatedBody = Regex.Replace(emailBodyContent, "<.*?>", string.Empty);
       updatedBody = updatedBody.Replace("\\r\\n", " ");
       updatedBody = updatedBody.Replace(@"&nbsp;", " ");
    
       // Return cleaned text
       return (ActionResult)new OkObjectResult(new {updatedBody});
    }
    
  6. Amikor végzett, a Code + Test eszköztáron válassza a Mentés, majd a Tesztelés/Futtatás lehetőséget.

  7. A Tesztelés/Futtatás panel Bevitel lapJának Törzs mezőjében adja meg a következő mintabemenetet, és válassza a Futtatás lehetőséget:

    {"name": "<p><p>Testing my function</br></p></p>"}

    A függvény kimenete a következő eredményhez hasonlóan néz ki:

    {"updatedBody": "{\"name\": \"Testing my function\"}"}

Miután megerősítette, hogy a függvény működik, hozza létre a logikai alkalmazás erőforrását és munkafolyamatát. Bár ez az oktatóanyag bemutatja, hogyan hozhat létre olyan függvényt, amely eltávolítja a HTML-t az e-mailekből, az Azure Logic Apps html-szöveg összekötőt is biztosít.

Használati logikai alkalmazás erőforrásának létrehozása

  1. Az Azure Portal keresőmezőjében adja meg a logikai alkalmazást, és válassza a Logikai alkalmazások lehetőséget.

  2. A Logic Apps lap eszköztárán válassza a Hozzáadás lehetőséget.

    Megjelenik a Logikai alkalmazás létrehozása lap, és a következő lehetőségeket jeleníti meg:

    Terv Leírás
    Használat Létrehoz egy olyan logikaialkalmazás-erőforrást, amely csak egy olyan munkafolyamatot támogat, amely több-bérlős Azure Logic Appsben fut, és a számlázáshoz a Használat modellt használja.
    Szabvány Több munkafolyamatot támogató logikaialkalmazás-erőforrást hoz létre. A következő lehetőségek közül választhat:

    - Munkafolyamat-szolgáltatási csomag: A munkafolyamatok egybérlős Azure Logic Appsben futnak, és a standard modellt használják a számlázáshoz.

    - App Service Environment V3: A munkafolyamatok egybérlős Azure Logic Apps-ben futnak, és a számlázáshoz Szolgáltatáskörnyezet-csomagot használnak.

    - Hibrid: A munkafolyamatok helyszíni és több felhőben futnak a Kubernetes eseményvezérelt automatikus skálázás (KEDA) használatával. További információ: Standard munkafolyamatok létrehozása hibrid üzembe helyezéshez.
  3. A Logikai alkalmazás létrehozása lapon válassza a Fogyasztás (Több-bérlő) lehetőséget.

  4. Az Alapok lapon adja meg a következő információkat a logikai alkalmazás erőforrásáról:

    Paraméter Kötelező Érték Leírás
    Előfizetés Igen < Azure-előfizetés-neve> Ugyanaz az Azure-előfizetés, amelyet korábban használt.
    Erőforráscsoport Igen LA-Tutorial-RG Ugyanaz az Azure-erőforráscsoport, amelyet korábban használt.
    Logikai alkalmazás neve Igen < logic-app-name> A logikai alkalmazás erőforrásának neve, amelynek régiókon belül egyedinek kell lennie, és csak betűket, számokat, kötőjeleket (-), aláhúzásjeleket (_), zárójeleket (()) és pontokat (.) tartalmazhat.

    Ez a példa létrehoz egy LA-ProcessAttachment nevű logikaialkalmazás-erőforrást. A Fogyasztás logikai alkalmazás és a munkafolyamat neve mindig ugyanaz.
    Régió Igen USA nyugati régiója Ugyanaz a régió, amelyet korábban használt.
    Naplóelemzés engedélyezése Igen Nem Ezt a beállítást csak akkor módosítsa, ha engedélyezni szeretné a diagnosztikai naplózást. Ebben az oktatóanyagban tartsa meg az alapértelmezett kijelölést.

    Megjegyzés: Ez a beállítás csak a fogyasztási logikai alkalmazások esetében érhető el.

    Megjegyzés

    A rendelkezésre állási zónák automatikusan engedélyezve vannak az új és meglévő fogyasztás logikai alkalmazásmunkafolyamatokhoz azokban az Azure régiókban, amelyek támogatják a rendelkezésre állási zónákat. További információ: Megbízhatóság az Azure Functionsben és a logikai alkalmazások védelme régióhibáktól zónaredundanciával és rendelkezésre állási zónákkal.

  5. Ha elkészült, válassza a Véleményezés + létrehozás lehetőséget. Miután az Azure érvényesítette a logikai alkalmazás erőforrásával kapcsolatos információkat, válassza a Létrehozás lehetőséget.

  6. Miután az Azure üzembe helyezi a logikai alkalmazás erőforrását, válassza az Ugrás az erőforráshoz lehetőséget. Vagy keresse meg és válassza ki a logikai alkalmazás erőforrását az Azure keresőmező használatával.

Eseményindító hozzáadása a bejövő e-mailek figyeléséhez

Az alábbi lépések egy eseményindítót adnak hozzá, amely a mellékletekkel rendelkező bejövő e-mailekre vár.

  1. A logikai alkalmazás menü Fejlesztési eszközök csoportjában válassza a Logikai alkalmazás tervezője lehetőséget.

  2. A munkafolyamat-tervezőben kövesse az alábbi általános lépéseket az Új e-mail érkezésekor nevű Office 365 Outlook-eseményindító hozzáadásához.

    Az Office 365 Outlook-összekötőhöz microsoftos munkahelyi vagy iskolai fiókkal kell bejelentkeznie. Ha személyes Microsoft-fiókot használ, használja a Outlook.com összekötőt.

  3. Jelentkezzen be az e-mail-fiókjába, amely kapcsolatot hoz létre a munkafolyamat és az e-mail-fiók között.

  4. Ha nem jelennek meg, adja hozzá a következő paramétereket az eseményindító információs mezőjében a Speciális paraméterek listából, és adja meg a következő adatokat:

    Paraméter Érték Leírás
    Fontosság Bármely Megadja a kívánt e-mail fontossági szintjét.
    Csak mellékletekkel Igen Csak a melléklettel rendelkező e-maileket kapja meg.

    Megjegyzés: Az eseményindító nem törli az e-maileket a fiókból, csak ellenőrzi az új üzeneteket, és feldolgozza azokat, amelyek megfelelnek a tárgyszűrőnek.
    Mellékletek csatolása Igen A mellékletek puszta ellenőrzése helyett használd őket bemenetként a munkafolyamatodhoz.
    Mappa Beérkezett üzenetek Az ellenőrizni kívánt e-mail mappa.
    Tárgyszűrő Üzleti elemző 2 # 423501 Megadja az e-mail tárgyában keresendő szöveget.

    Ha végzett, az eseményindító az alábbi példához hasonlóan néz ki:

    A képernyőkép a Fogyasztási munkafolyamatot és az Office 365 Outlook kiváltót mutatja.

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

    A munkafolyamat most már élő, de nem tesz mást, mint az e-mailek ellenőrzése. Ezután adjon hozzá egy feltételt, amely feltételeket határoz meg a munkafolyamat későbbi műveleteinek folytatásához.

Mellékletek ellenőrzésére szolgáló feltétel hozzáadása

Az alábbi lépések olyan feltételt adnak hozzá, amely csak a mellékletekkel rendelkező e-maileket választja ki.

  1. A munkafolyamat-tervezőben kövesse az alábbi általános lépéseket a Feltétel nevű vezérlőművelet hozzáadásához.

  2. A Feltétel művelet adatai panelen nevezze át a műveletet az If email has attachments and key subject phrase (Ha az e-mail mellékletekkel és a kulcs tárgyával) kifejezéssel.

  3. Hozzon létre egy feltételt, amely ellenőrzi a mellékletekkel rendelkező e-maileket.

    1. A Paraméterek lapon, az AND lista első sorában válasszon a bal oldali mezőbe, majd válassza ki a dinamikus tartalmak listáját (villám ikon). Ebben a listában az eseményindító részben válassza a Van melléklet lehetőséget.

      Tipp

      Ha nem látja a Melléklettel kimenetet, válassza a Továbbiak megtekintése lehetőséget.

      Képernyőkép a feltételműveletről: a kurzor a második sor bal szélső mezőjében van, a dinamikus tartalomlista meg van nyitva, és a "Melléklet" opció van kiválasztva.

    2. A középső mezőben tartsa meg az is equal to nevű operátort.

    3. A jobb oldali mezőben adja meg a true értéket, amely az indító Has Attachment kimeneti értékével kerül összehasonlításra. Ha a két érték egyezik, az e-mail legalább egy melléklettel rendelkezik, a feltétel teljesül, és a munkafolyamat folytatódik.

      Képernyőkép a teljes állapotról.

    A mögöttes munkafolyamat-definícióban, amelyet a Tervező eszköztár Kód nézetének kiválasztásával tekinthet meg, a feltétel az alábbi példához hasonlóan néz ki:

    "Condition": {
       "actions": { <actions-to-run-when-condition-passes> },
       "expression": {
          "and": [ {
             "equals": [
                "@triggerBody()?['HasAttachment']",
                  "true"
             ]
          } ]
       },
       "runAfter": {},
       "type": "If"
    }
    
  4. Mentse a munkafolyamatot.

A feltétel tesztelése

  1. A tervező eszköztáron válassza Futtatás>Futtatás.

    Ez a lépés manuálisan indítja el és futtatja a munkafolyamatot, de semmi sem történik, amíg nem küld teszt e-mailt a Beérkezett üzenetek mappába.

  2. Küldjön magának egy e-mailt, amely megfelel az alábbi feltételeknek:

    • Az e-mail tárgya tartalmazza az eseményindító Tárgyszűrőjében megadott szöveget: Business Analyst 2 #423501

    • Az e-mail rendelkezik egy melléklettel. Most csak hozzon létre egy üres szövegfájlt, és csatolja a fájlt az e-mailhez.

    Amikor megérkezik az e-mail, a munkafolyamat ellenőrzi a mellékleteket és a megadott tárgyszöveget. Ha a feltétel teljesül, a trigger aktiválódik, és az Azure Logic Apps létrehoz egy példányt és futtat egy munkafolyamatot.

  3. Annak ellenőrzéséhez, hogy az eseményindító aktiválódott-e, és a munkafolyamat sikeresen lefutott-e, a logikai alkalmazás menüjében válassza az Áttekintés lehetőséget.

    • A munkafolyamatok sikeres futtatásának megtekintéséhez válassza a Futtatási előzmények lehetőséget.

    • A sikeresen aktivált eseményindítók megtekintéséhez válassza az Eseményindító előzményei lehetőséget.

    Ha az eseményindító nem aktiválódott, vagy a munkafolyamat nem futott a sikeres eseményindító ellenére, tekintse meg a logikai alkalmazás munkafolyamatának hibaelhárítását.

Ezután adja meg a True ághoz végrehajtandó műveleteket. Az e-mailek és esetleges mellékleteik mentéséhez törölni kell az e-mail törzsének HTML-formázását, majd blobokat létrehozni a Storage-tárolóban az e-mail és a mellékletek számára.

Megjegyzés

A munkafolyamat üresen hagyhatja a Hamis ágat, és nem hajthat végre semmilyen műveletet, ha egy e-mail nem rendelkezik mellékletekkel. Az oktatóanyag befejezése után bónusz feladatként tetszőleges megfelelő műveletet hozzáadhat, amelyet végrehajtani kíván a False ághoz.

A RemoveHTMLFunction meghívása

Az alábbi lépések hozzáadják a korábban létrehozott Azure-függvényt, amely bemenetként elfogadja az e-mail-eseményindító e-mail törzsének tartalmát.

  1. A logikai alkalmazás menü Fejlesztési eszközök csoportjában válassza a Logikai alkalmazás tervezője lehetőséget. Az Igaz ágban válassza a Művelet hozzáadása lehetőséget.

  2. Az alábbi általános lépéseket követve adja hozzá az Azure-függvény kiválasztása nevű Azure Functions-műveletet.

  3. Válassza ki a korábban létrehozott függvényalkalmazást, amely ebben a példában a CleanTextFunctionApp .

  4. Válassza ki a RemoveHTMLFunction nevű függvényt a jelen példában, majd válassza a Művelet hozzáadása lehetőséget.

  5. Az Azure Functions műveletinformációs paneljén nevezze át a műveletet a Call RemoveHTMLFunction használatával.

  6. Most adja meg a függvény által feldolgozandó bemenetet.

    1. A Kérelem törzse mezőben adja meg a következő szöveget egy záró szóközzel:

      { "emailBody":

      Miközben a következő lépésekben ezzel a bemenettel dolgozik, érvénytelen JSON-ra figyelmeztető hibaüzenet jelenik egészen addig, amíg a bemenet helyes JSON-formázást nem kap. A függvény előző tesztelésekor a megadott bemenet a JavaScript Object Notation (JSON) formátumot használta. Ezért a kérelem törzsének is ezt a formátumot kell követnie.

    2. Válassza ki a Kérelem törzse mezőben, majd válassza ki a dinamikus tartalomlistát (villám ikon), hogy a korábbi műveletek kimeneteit is kiválaszthassa.

    3. A dinamikus tartalomlistában az amikor új e-mail érkezik, válassza ki a törzs kimenetét. Miután ez az érték kijelzett a Kérelem törzse mezőben, ne felejtse el hozzáadni a záró zárójelet (}).

      Képernyőkép az Azure-függvényinformációs mezőről, amelyen a dinamikus tartalomlista és a Törzs van kiválasztva.

    Amikor befejezi, az Azure-függvény az alábbi példához hasonlóan néz ki.

    Képernyőkép egy kész Azure-függvényről a kérés törzstartalmával, amelyet a függvénynek kell átadni.

  7. Mentse a munkafolyamatot.

Ezután adjon hozzá egy műveletet, amely létrehoz egy blobot az e-mail törzsének tárolásához.

Művelet hozzáadása blob létrehozásához az e-mail törzséhez

Az alábbi lépések létrehoznak egy blobot, amely a tárolóban tárolja az e-mail törzsét.

  1. A tervezőben a feltétel Igaz blokkjában, az Azure-függvény alatt válassza a Művelet hozzáadása lehetőséget.

  2. Kövesse az alábbi általános lépéseket a Blob létrehozása nevű Azure Blob Storage-művelet hozzáadásához.

  3. Adja meg a tárfiók kapcsolati adatait, például:

    Paraméter Kötelező Érték Leírás
    Kapcsolat neve Igen < kapcsolat neve> A kapcsolat leíró neve.

    Ez a példa a AttachmentStorageConnection parancsot használja.
    Hitelesítés típusa Igen < hitelesítés típusa> A kapcsolathoz használandó hitelesítési típus.

    Ez a példa Access Key-t használ.
    Azure Storage-fiók neve vagy blob végpont Igen < tárfiók-név> A korábban létrehozott tárfiók neve.

    Ez a példa a attachmentstorageacct parancsot használja.
    Azure Storage-fiók hozzáférési kulcsa Igen < tárhely-fiók-hozzáférési-kulcs> A korábban létrehozott tárfiók hozzáférési kulcsa.
  4. Amikor végzett, válassza az Új létrehozása lehetőséget.

  5. Blob létrehozása művelet információs panelen nevezze át a műveletet Blob létrehozása az e-mail törzse számára.

  6. Adja meg a következő műveletinformációkat:

    Tipp

    Ha nem talál megadott kimenetet a dinamikus tartalomlistában, válassza a Művelet neve melletti Továbbiak elemet.

    Paraméter Kötelező Érték Leírás
    Tárolófiók neve vagy blobvégpont Igen Kapcsolatbeállítások használata(<tárfiók-neve-vagy-blob-végpontja>) Válassza ki a tárfiók nevét tartalmazó lehetőséget.

    Ez a példa a következőt használja: https://attachmentstorageacct.blob.core.windows.net.
    Mappa útvonala Igen < elérési út és tároló neve> A korábban létrehozott tároló elérési útja és neve.

    Ebben a példában válassza a mappa ikont, majd a mellékleteket.
    Blob neve Igen < feladó neve> Ebben a példában a feladó nevét használja blobnévként.

    1. Jelölje ki a Blob neve mezőben, majd válassza a dinamikus tartalomlista lehetőséget (villám ikon).

    2. Az Új e-mail érkezésekor szakaszban válassza a Feladó lehetőséget.
    Blob tartalom Igen < tisztított e-mail-törzs> Ebben a példában blobtartalomként használjon HTML-mentes e-mail-törzset.

    1. Jelölje ki a Blob tartalom mezőn belül, majd válassza a dinamikus tartalom lista opciót (villám ikon).

    2. A Call RemoveHTMLFunction szakaszban válassza a Törzs.

    Az alábbi képernyőképen az e-mail törzséhez tartozó blob létrehozása művelethez kiválasztandó kimenetek láthatók:

    Képernyőkép a tárolóról, a feladóról és a HTML-mentes e-mail törzsről a Blob létrehozása műveletben.

    Amikor végzett, a művelet a következő példához hasonlóan néz ki:

    Képernyőkép a blob létrehozása művelet befejezéséhez szükséges e-mail törzsadatokról.

  7. Mentse a munkafolyamatot.

Mellékletkezelés tesztelése

  1. A tervező eszköztáron válassza Futtatás>Futtatás.

    Ez a lépés manuálisan indítja el és futtatja a munkafolyamatot, de semmi sem történik, amíg nem küld teszt e-mailt a Beérkezett üzenetek mappába.

  2. Küldjön magának egy e-mailt, amely megfelel az alábbi feltételeknek:

    • Az e-mail tárgya tartalmazza az eseményindító Tárgyszűrő paraméterében megadott szöveget: Business Analyst 2 #423501

    • Az e-mail egy vagy több melléklettel rendelkezik. Egyelőre csak hozzon létre egy üres szöveges fájlt, és csatolja azt az e-mailhez.

    • Az e-mail tartalmaz néhány teszttartalmat a törzsben, például: A logikai alkalmazás munkafolyamatának tesztelése

    Ha a munkafolyamat egy sikeres eseményindító ellenére nem aktiválódik vagy fut, tekintse meg a logikai alkalmazás munkafolyamatának hibaelhárítását.

  3. Ellenőrizze, hogy a munkafolyamat a megfelelő tárolóba mentette-e az e-mailt.

    1. A Storage Explorerben bontsa ki az Emulátor és csatolt>tárfiókokat>attachmentstorageacct (Kulcs)>Blob tárolók>csatolmányok.

    2. Ellenőrizze az e-mail mellékleteinek tárolóját.

      Jelenleg csak az e-mail jelenik meg a tárolóban, mert a munkafolyamat még nem dolgozza fel a mellékleteket.

      Képernyőkép a Storage Explorerről, amely csak a mentett e-maileket jeleníti meg.

    3. Ha végzett, törölje az e-mailt a Storage Explorerben.

  4. Ha szeretné tesztelni a Hamis ágat, amely jelenleg nem tesz semmit, küldhet egy olyan e-mailt, amely nem felel meg a feltételeknek.

Ezután adjon hozzá egy Mindegyikre ciklust az egyes e-mail-mellékletek feldolgozásához.

Hurok hozzáadása mellékletek feldolgozásához

Az alábbi lépések egy hurkot adnak hozzá az e-mail mellékleteinek feldolgozásához.

  1. Térjen vissza a munkafolyamat-tervezőhöz. Az e-mail törzséhez készítendő blokknál az opciók között válassza a Művelet hozzáadása lehetőséget.

  2. Kövesse az alábbi általános lépéseket a Vezérlés művelet hozzáadásához, amelynek neve Mindegyik.

  3. Az For each műveletinformációk panelen nevezze át a műveletet a következőre: For each email attachment.

  4. Most válassza ki a hurkok által feldolgozandó tartalmat.

    1. Az egyes e-mail-mellékletek ciklusában válassza az Előző lépések kimenetének kiválasztása mezőt, majd válassza a dinamikus tartalomlista lehetőséget (villám ikon).

    2. Az Új e-mail érkezésekor szakaszban válassza a Mellékletek lehetőséget.

      A Mellékletek kimenete tartalmaz egy tömböt, amely tartalmazza az e-mail összes mellékletét. A For each ciklus ismétli a műveleteket minden egyes tömbelemre.

      Tipp

      Ha nem látja a Mellékletek elemet, válassza a Továbbiak megtekintése lehetőséget.

      Képernyőkép a dinamikus tartalomlistáról, amely a kiválasztott kimenetet Mellékletek néven jeleníti meg.

  5. Mentse a munkafolyamatot.

Ezután adjon hozzá egy műveletet, amely az egyes mellékleteket blobként menti a mellékletek tárolójában.

Adj hozzá egy műveletet minden egyes melléklethez egy blob létrehozásához

Az alábbi lépések egy műveletet adnak hozzá egy blob létrehozásához minden melléklethez.

  1. A tervezőben a Minden egyes e-mail melléklet hurokban válassza a Művelet hozzáadása lehetőséget.

  2. Kövesse az alábbi általános lépéseket a Blob létrehozása nevű Azure Blob Storage-művelet hozzáadásához.

  3. A Blob létrehozása műveletinformációk panelen nevezze át a műveletet a Blob létrehozása e-mail mellékletként elem használatával.

  4. Adja meg a következő műveletinformációkat:

    Tipp

    Ha nem talál megadott kimenetet a dinamikus tartalomlistában, válassza a Művelet neve melletti Továbbiak elemet.

    Paraméter Kötelező Érték Leírás
    Tárolófiók neve vagy blobvégpont Igen Kapcsolatbeállítások használata(<tárfiók-neve-vagy-blob-végpontja>) Válassza ki a tárfiók nevét tartalmazó lehetőséget.

    Ez a példa a következőt használja: https://attachmentstorageacct.blob.core.windows.net.
    Mappa útvonala Igen < elérési út és tároló neve> A korábban létrehozott tároló elérési útja és neve.

    Ebben a példában válassza a mappa ikont, majd a mellékleteket.
    Blob neve Igen < attachment-name> Ebben a példában a melléklet nevét használja blobnévként.

    1. Jelölje ki a Blob neve mezőben, majd válassza a dinamikus tartalomlista lehetőséget (villám ikon).

    2. Az Új e-mail érkezésekor szakaszban válassza a Név lehetőséget.
    Blob tartalom Igen < e-mail-tartalom> Ebben a példában az e-mail-tartalmat használja blobtartalomként.

    1. Jelölje ki a Blob tartalom mezőn belül, majd válassza a dinamikus tartalom lista opciót (villám ikon).

    2. Az Új e-mail érkezésekor szakaszban válassza a Tartalom lehetőséget.

    Megjegyzés

    Ha olyan kimenetet választ ki, amely tömböt tartalmaz, mint például a Tartalom kimenet, amely egy mellékleteket tartalmazó tömb, a tervező automatikusan hozzáad egy Minden elem ciklust az arra a kimenetre hivatkozó művelet köré. Így a munkafolyamat minden tömbelemen végrehajthatja ezt a műveletet. A hurok eltávolításához helyezze át a kimenetre hivatkozó műveletet a cikluson kívülre, és törölje a hurkot.

    Az alábbi képernyőképen a Blob létrehozása e-mail melléklethez művelethez kiválasztandó kimenetek láthatók:

    Képernyőkép a tároló és a melléklet adatairól a Blob létrehozása műveletben.

    Amikor végzett, a művelet a következő példához hasonlóan néz ki:

    Képernyőkép a blob létrehozása művelet befejezésének mellékletadatairól.

  5. Mentse a munkafolyamatot.

Mellékletkezelés újratesztelése

  1. A tervező eszköztáron válassza Futtatás>Futtatás.

    Ez a lépés manuálisan indítja el és futtatja a munkafolyamatot, de semmi sem történik, amíg nem küld teszt e-mailt a Beérkezett üzenetek mappába.

  2. Küldjön magának egy e-mailt, amely megfelel az alábbi feltételeknek:

    • Az e-mail tárgya tartalmazza az eseményindító Tárgyszűrő paraméterében megadott szöveget: Business Analyst 2 #423501

    • Az e-mail két vagy több melléklettel rendelkezik. Most csak hozzon létre két üres szövegfájlt, és csatolja a fájlokat az e-mailhez.

    Ha a munkafolyamat egy sikeres eseményindító ellenére nem aktiválódik vagy fut, tekintse meg a logikai alkalmazás munkafolyamatának hibaelhárítását.

  3. Ellenőrizze, hogy a munkafolyamat a megfelelő tárolóba mentette-e az e-maileket és a mellékleteket.

    1. A Storage Explorerben bontsa ki az Emulátor és csatolt>tárfiókokat>attachmentstorageacct (Kulcs)>Blob tárolók>csatolmányok.

    2. Ellenőrizze az attachments tárolóban az e-mailt és a mellékleteket egyaránt.

      Képernyőkép a Storage Explorerről, valamint a mentett e-mailekről és mellékletekről.

    3. Ha végzett, törölje az e-maileket és a mellékleteket a Storage Explorerben.

Ezután vegyen fel egy műveletet a munkafolyamatba, amely e-mailt küld a mellékletek áttekintéséhez.

E-mail-küldési művelet hozzáadása

Az alábbi lépések egy műveletet adnak hozzá, hogy a munkafolyamat e-mailt küldjön a mellékletek áttekintéséhez.

  1. Térjen vissza a munkafolyamat-tervezőhöz. Az True ágban a For each email attachment hurokban válassza a Add an action lehetőséget.

  2. Kövesse az alábbi általános lépéseket az E-mail küldése nevű Office 365 Outlook-művelet hozzáadásához.

    Ez a példa az Office 365 Outlook-összekötővel folytatódik, amely csak egy Azure-beli munkahelyi vagy iskolai fiókkal működik. Személyes Microsoft-fiókok esetében válassza az Outlook.com-összekötőt.

  3. Ha hitelesítő adatokat kér, jelentkezzen be az e-mail-fiókjába, hogy az Azure Logic Apps kapcsolatot létesítsen az e-mail-fiókjával.

  4. Az E-mail küldése művelet információs panelen nevezze át a műveletet "E-mail küldése felülvizsgálatra"-ra/-re.

  5. Adja meg a következő műveletinformációkat, és válassza ki az e-mailben felvenni kívánt kimeneteket:

    Tipp

    Ha nem talál megadott kimenetet a dinamikus tartalomlistában, válassza a Művelet neve melletti Továbbiak elemet.

    Paraméter Kötelező Érték Leírás
    Címzett: Igen < címzett-e-mail-cím> Tesztelés céljából használja a saját e-mail-címét.
    Tárgy Igen < e-mail-tárgy> Az e-mail tárgya, amit bele kell foglalni.

    Ez a példa az ASAP - Pályázó áttekintése a pozícióra: és a tárgy kimenetét használja az eseményindítóból.

    1. A Tárgy mezőbe írja be a példaszöveget egy záró szóközzel.

    2. Jelölje ki a Tárgy mezőben, majd válassza a dinamikus tartalomlista lehetőséget (villám ikon).

    3. A listában az Új e-mail érkezésekor csoportban válassza a Tárgy lehetőséget.
    Test Igen < e-mail-törzs> A belefoglalandó e-mail törzse.

    A példa a következőket használja: Kérjük, tekintse át az új kérelmezőt:, a From nevű trigger kimenetét, az Útvonal kimenetet az E-mail törzs blobjának létrehozása műveletből, valamint a Törzs kimenetet a Call RemoveHTMLFunction műveletből.

    1. A Törzs mezőbe írja be a példaszöveget, Kérjük, tekintse át az új kérelmezőt:.

    2. Egy új sorban adja meg a példaszöveget, a kérelmező nevét:, és adja hozzá a Forrás kimenetet az eseményindítóból.

    3. Egy új sorban adja meg a példaszöveget, Alkalmazásfájl helye:, és adja hozzá a Elérési út kimenetet a blob létrehozása az e-mail törzséhez műveletből.

    4. Egy új sorban adja meg a példaszöveget, az alkalmazás e-mail-tartalmát: és adja hozzá a Törzskimenetet a Call RemoveHTMLFunction műveletből.

    Megjegyzés

    Ha olyan kimenetet választ ki, amely tömböt tartalmaz, mint például a Tartalom kimenet, amely egy mellékleteket tartalmazó tömb, a tervező automatikusan hozzáad egy Minden elem ciklust az arra a kimenetre hivatkozó művelet köré. Így a munkafolyamat minden tömbelemen végrehajthatja ezt a műveletet. A hurok eltávolításához helyezze át a kimenetre hivatkozó műveletet a cikluson kívülre, és törölje a hurkot.

    Az alábbi képernyőképen az e-mail küldése művelet befejeződött:

    Képernyőkép a küldendő minta e-mailről.

  6. Mentse a munkafolyamatot.

A kész munkafolyamat most az alábbi példához hasonlóan néz ki:

Képernyőkép a kész munkafolyamatról.

A munkafolyamat tesztelése

  1. Küldjön magának egy e-mailt, amely megfelel az alábbi feltételeknek:

    • Az e-mail tárgya tartalmazza az eseményindító Tárgyszűrő paraméterében megadott szöveget: Business Analyst 2 #423501

    • Az e-mail egy vagy több melléklettel rendelkezik. Megint felhasználhatja az üres szövegfájlokat az előző tesztből. Ha valószerűbb forgatókönyvet szeretne, csatoljon egy önéletrajzfájlt.

    • Az e-mail törzse tartalmazza a következő szöveget (másolható és beilleszthető):

      
      Name: Jamal Hartnett
      
      Street address: 12345 Anywhere Road
      
      City: Any Town
      
      State or Country: Any State
      
      Postal code: 00000
      
      Email address: jamhartnett@outlook.com
      
      Phone number: 000-000-0000
      
      Position: Business Analyst 2 #423501
      
      Technical skills: Dynamics CRM, MySQL, Microsoft SQL Server, JavaScript, Perl, Power BI, Tableau, Microsoft Office: Excel, Visio, Word, PowerPoint, SharePoint, and Outlook
      
      Professional skills: Data, process, workflow, statistics, risk analysis, modeling; technical writing, expert communicator and presenter, logical and analytical thinker, team builder, mediator, negotiator, self-starter, self-managing  
      
      Certifications: Six Sigma Green Belt, Lean Project Management
      
      Language skills: English, Mandarin, Spanish
      
      Education: Master of Business Administration
      
  2. Futtassa a munkafolyamatot. Ha sikeres, a munkafolyamat az alábbi példához hasonló e-mailt küld Önnek:

    Képernyőkép a logikai alkalmazás munkafolyamata által küldött példa e-mailről.

    Ha nem kap e-mailt, ellenőrizze a levélszemét mappát. Ellenkező esetben, ha nem biztos abban, hogy a munkafolyamat megfelelően futott, olvassa el a logikai alkalmazás munkafolyamatának hibaelhárítása című témakört.

Gratulálunk, létrehozott és futtatott egy munkafolyamatot, amely automatizálja a feladatokat a különböző Azure-szolgáltatásokban, és meghív néhány egyéni kódot!

Erőforrások megtisztítása

A munkafolyamat addig fut, amíg le nem tiltja vagy nem törli a logikai alkalmazás erőforrását. Ha már nincs szükség erre a mintára, törölje a logikai alkalmazást és a kapcsolódó erőforrásokat tartalmazó erőforráscsoportot.

  1. Az Azure Portal keresőmezőjében adja meg az erőforráscsoportokat, és válassza az Erőforráscsoportok lehetőséget.

  2. Az Erőforráscsoportok listában válassza ki az oktatóanyaghoz tartozó erőforráscsoportot.

  3. Az erőforráscsoport menüjében válassza az Áttekintés lehetőséget.

  4. Az Áttekintés lap eszköztárán válassza az Erőforráscsoport törlése lehetőséget.

  5. Amikor megjelenik a megerősítést kérő ablaktábla, adja meg az erőforráscsoport nevét, és válassza a Törlés lehetőséget.

Következő lépések

Ebben az oktatóanyagban létrehozott egy logikai alkalmazás munkafolyamatot, amely az Azure-szolgáltatások, például az Azure Storage és az Azure Functions integrálásával dolgozza fel és tárolja az e-mail-mellékleteket. Most többet is megtudhat a logikaialkalmazás-munkafolyamatok létrehozásához használható egyéb összekötőkről.