XML átalakítása munkafolyamatokban a Azure Logic Apps

Vállalati integrációs vállalatok közötti (B2B) forgatókönyvekben előfordulhat, hogy az XML-t formátumok között kell konvertálnia. A logikai alkalmazás munkafolyamata az XML-átalakítás művelet és egy előre definiált leképezés használatával átalakíthatja az XML-t. Tegyük fel például, hogy rendszeresen B2B megrendeléseket vagy számlákat kap egy olyan ügyféltől, aki a YearMonthDay dátumformátumot használja (YYYYMMDD). A szervezet azonban a MonthDayYear dátumformátumot (MMDDYYYY) használja. Létrehozhat és használhat olyan térképet, amely a YearMonthDay formátumot MonthDayYear formátumra alakítja át, mielőtt a rendelési vagy számlaadatokat az ügyféltevékenység-adatbázisban tárolná.

Ha most ismerkedik a logikai alkalmazásokkal, tekintse át a mi az Azure Logic Apps? A B2B vállalati integrációval kapcsolatos további információkért tekintse át a B2B vállalati integrációs munkafolyamatait a Azure Logic Apps és az Enterprise Integration Pack csomaggal.

Előfeltételek

• Azure-fiók és -előfizetés. Ha még nem rendelkezik előfizetéssel, regisztráljon egy ingyenes Azure-fiókot.

• Egy logikai alkalmazás munkafolyamata, amely már egy eseményindítóval kezdődik, így szükség esetén hozzáadhatja az XML-átalakítás műveletet a munkafolyamathoz.

• Integrációsfiók-erőforrás, amelyben összetevőket definiálhat és tárolhat, például kereskedelmi partnereket, szerződéseket, tanúsítványokat stb. a vállalati integrációs és B2B-munkafolyamatokban való használatra. Ennek az erőforrásnak meg kell felelnie a következő követelményeknek:

  • Ugyanazzal az Azure-előfizetéssel van társítva, mint a logikaialkalmazás-erőforrás.

  • A logikai alkalmazás erőforrásával megegyező helyen vagy Azure-régióban található, ahol az XML-átalakítás műveletet tervezi használni.

  • Ha a Logic App (Használat) erőforrástípust használja, az integrációs fiókhoz a következő elemek szükségesek:

    • Az XML-tartalom átalakításához használandó térkép .

    • A logikai alkalmazás erőforrására mutató hivatkozás.

  • Ha a Logic App (Standard) erőforrástípust használja, nem tárol térképeket az integrációs fiókjában. Ehelyett közvetlenül hozzáadhat térképeket a logikai alkalmazás erőforrásához a Azure Portal vagy a Visual Studio Code használatával. Jelenleg csak az XSLT 1.0 támogatott. Ezeket a térképeket ezután több munkafolyamatban is használhatja ugyanazon a logikaialkalmazás-erőforráson belül.

    Továbbra is szüksége van egy integrációs fiókra más összetevők, például partnerek, szerződések és tanúsítványok tárolásához, valamint az AS2, X12 és EDIFACT műveletek használatához. A logikai alkalmazás erőforrását azonban nem kell az integrációs fiókhoz kapcsolnia, így a csatolási képesség nem létezik. Az integrációs fióknak továbbra is meg kell felelnie más követelményeknek, például ugyanazt az Azure-előfizetést kell használnia, és ugyanazon a helyen kell lennie, mint a logikai alkalmazás erőforrásának.

    Megjegyzés

    Jelenleg csak a logic app (consumption) erőforrástípus támogatja a RosettaNet-műveleteket . A Logikai alkalmazás (Standard) erőforrástípus nem tartalmazza a RosettaNet-műveleteket .

XML-átalakítási művelet hozzáadása

1. A Azure Portal nyissa meg a logikai alkalmazást és a munkafolyamatot Tervező nézetben.

2. Ha olyan üres logikai alkalmazással rendelkezik, amely nem rendelkezik eseményindítóval, adja hozzá a kívánt eseményindítót. Ez a példa a Kérelem eseményindítót használja. Ha nem, folytassa a következő lépéssel.

   A Kérés eseményindító hozzáadásához írja be HTTP requesta tervező keresőmezőbe, és válassza ki a Http-kérés fogadásakor nevű Kérés eseményindítót.

3. A munkafolyamat azon lépése alatt, amelyhez hozzá szeretné adni az XML-átalakítás műveletet, válasszon az alábbi lépések közül:

   Használatalapú vagy ISE-csomagalapú logikai alkalmazás esetén válasszon egy lépést:

   • Ha a munkafolyamat végén szeretné hozzáadni az XML-átalakítás műveletet, válassza az Új lépést.

   • Az XML-átalakítás művelet meglévő lépések közötti hozzáadásához vigye az egérmutatót a lépéseket összekötő nyílra, hogy megjelenjen a pluszjel (+). Jelölje ki a pluszjelet, majd válassza a Művelet hozzáadása lehetőséget.

   Standard csomagalapú logikai alkalmazás esetén válasszon egy lépést:

   • Ha a munkafolyamat végén szeretné hozzáadni az XML-átalakítás műveletet, válassza a pluszjelet (+), majd a Művelet hozzáadása lehetőséget.

   • Az XML-átalakítás művelet meglévő lépések közötti hozzáadásához jelölje ki a lépések között megjelenő pluszjelet (+), majd válassza a Művelet hozzáadása lehetőséget.

4. A Válasszon műveletet területen válassza a Beépített lehetőséget. A keresőmezőbe írja be a transform xml kifejezést. A műveletek listájában válassza az XML átalakítása lehetőséget.

5. Az átalakítási XML-tartalom megadásához használhatja a HTTP-kérelemben kapott XML-adatokat. Kattintson a Tartalom mezőbe, hogy megjelenjen a dinamikus tartalomlista.

   A dinamikus tartalomlista olyan tulajdonságtokeneket jelenít meg, amelyek a munkafolyamat előző lépéseinek kimeneteit képviselik. Ha a listában nem látható a várt tulajdonság, ellenőrizze az eseményindító vagy a művelet fejlécét a listában, és hogy választhatja-e a Továbbiak elemet.

   Használatalapú vagy ISE-csomagalapú logikai alkalmazás esetén a tervező az alábbi példához hasonlóan néz ki:

   

   Standard csomagalapú logikai alkalmazások esetén a tervező az alábbi példához hasonlóan néz ki:

   

6. A dinamikus tartalomlistában válassza ki az ellenőrizni kívánt tartalom tulajdonságjogkivonatát.

   Ez a példa kiválasztja a body tokent az eseményindítóból.

   Megjegyzés

   Győződjön meg arról, hogy a kijelölt tartalom XML. Ha a tartalom nem XML vagy base64 kódolású, meg kell adnia egy kifejezést, amely feldolgozza a tartalmat. Használhat például kifejezésfüggvényeket, például base64ToBinary() a tartalom dekódolására vagy xml() a tartalom XML-ként való feldolgozására.

7. Az átalakításhoz használni kívánt térkép megadásához nyissa meg a Térkép listát, és válassza ki a korábban hozzáadott térképet.

8. Amikor elkészült, mentse a logikai alkalmazás munkafolyamatát.

   Ezzel befejezte az XML-átalakítás művelet beállítását. Egy valós alkalmazásban érdemes lehet az átalakított adatokat egy üzletági (LOB) alkalmazásban, például a SalesForce-ban tárolni. Ha el szeretné küldeni az átalakított kimenetet a Salesforce-nak, adjon hozzá egy Salesforce-műveletet.

9. Az átalakítási művelet teszteléséhez aktiválja és futtassa a munkafolyamatot. A Kérés eseményindítóhoz például küldjön egy kérést az eseményindító végponti URL-címére.

   Az XML-átalakítás művelet a munkafolyamat aktiválása és az XML-tartalom átalakítási céljából való rendelkezésre állása után fut.

Speciális képességek

Referenciaszerelvény vagy egyéni kód térképekből

A Logic App - munkafolyamatokban az XML-átalakítás művelet támogatja a külső szerelvényre hivatkozó leképezéseket. További információ: XSLT-térképek hozzáadása munkafolyamatokhoz Azure Logic Apps.

Bájtsorrendjel

Alapértelmezés szerint az átalakítás válasza egy bájtsorrendjellel (BOM) kezdődik. Ezt a funkciót csak akkor érheti el, ha a kódnézet-szerkesztőben dolgozik. A funkció letiltásához állítsa a tulajdonságot a transformOptions következő értékre disableByteOrderMark:

"Transform_XML": {
    "inputs": {
        "content": "@{triggerBody()}",
        "integrationAccount": {
            "map": {
                "name": "TestMap"
            }
        },
        "transformOptions": "disableByteOrderMark"
    },
    "runAfter": {},
    "type": "Xslt"
}

Következő lépések

• XSLT-megfeleltetések hozzáadása XML-átalakításhoz a Azure Logic Apps
• XML ellenőrzése munkafolyamatokhoz a Azure Logic Apps