Sémák hozzáadása munkafolyamatokhoz az Azure Logic Apps használatával

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

Az olyan munkafolyamat-műveletek, mint az egybesimított fájl vagy az XML-ellenőrzés , sémát igényelnek a feladataik elvégzéséhez. Az XML-érvényesítési művelethez például egy XML-séma szükséges annak ellenőrzéséhez, hogy a dokumentumok érvényes XML-et használnak-e, és hogy a várt adatok az előre definiált formátumban vannak-e. Ez a séma egy XML-dokumentum, amely XML-sémadefiníciós (XSD) nyelvet használ, és .xsd fájlnévkiterjesztéssel rendelkezik. Az egybesimított fájlműveletek sémával kódolják és dekódolják az XML-tartalmakat.

Ez a cikk bemutatja, hogyan adhat hozzá sémát az integrációs fiókhoz. Ha standard logikai alkalmazás munkafolyamatával dolgozik, közvetlenül is hozzáadhat sémát a logikai alkalmazás erőforrásához.

Előfeltételek

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

• A hozzáadni kívánt sémafájl. Sémák létrehozásához használhatja a Visual Studio 2019-et és a Microsoft Azure Logic Apps Enterprise Integration Tools bővítményt.

  Feljegyzés

  Ne telepítse a bővítményt a BizTalk Server bővítmény mellett. Mindkét bővítmény váratlan viselkedést okozhat. Győződjön meg arról, hogy csak egy ilyen bővítmény van telepítve.

  Nagy felbontású monitorokon megjelenítési problémát tapasztalhat a Visual Studióban a térképtervezővel . A megjelenítési probléma megoldásához indítsa újra a Visual Studiót DPI-unaware módban, vagy adja hozzá a DPIUNAWARE beállításjegyzék-értékét.

• Attól függően, hogy használatalapú vagy standard logikaialkalmazás-munkafolyamaton dolgozik-e, szüksége lesz egy integrációs fiók erőforrására. Erre az erőforrásra általában akkor van szükség, ha nagyvállalati integrációs és B2B-munkafolyamatokban használható összetevőket szeretne definiálni és tárolni.

  Fontos

  Az együttműködéshez az integrációs fióknak és a logikai alkalmazás erőforrásának ugyanabban az Azure-előfizetésben és Azure-régióban kell lennie.

  • Ha használatalapú logikai alkalmazás munkafolyamatán dolgozik, szüksége lesz egy integrációs fiókra, amely a logikai alkalmazás erőforrásához van csatolva.

  • Ha standard logikaialkalmazás-munkafolyamaton dolgozik, összekapcsolhatja az integrációs fiókot a logikai alkalmazás erőforrásával, közvetlenül feltöltheti a sémákat a logikai alkalmazás erőforrásához vagy mindkettőhöz az alábbi forgatókönyvek alapján:

    • Ha már rendelkezik integrációs fiókkal a szükséges vagy használni kívánt összetevőkkel, összekapcsolhatja az integrációs fiókot több Standard logikai alkalmazás-erőforrással, ahol használni szeretné az összetevőket. Így nem kell sémákat feltöltenie az egyes logikai alkalmazásokba. További információ: A logikai alkalmazás erőforrásának csatolása az integrációs fiókhoz.

    • A beépített flat file összekötővel kiválaszthat egy sémát, amelyet korábban feltöltött a logikaialkalmazás-erőforrásba vagy egy csatolt integrációs fiókba, de mindkettőt nem. Ezt az összetevőt ezután használhatja az összes gyermek munkafolyamatban ugyanabban a logikai alkalmazás-erőforrásban.

    Így ha nincs vagy szüksége van integrációs fiókra, használhatja a feltöltési lehetőséget. Ellenkező esetben használhatja a csatolási lehetőséget. Bármelyik módon is használhatja ezeket az összetevőket az összes gyermek munkafolyamatban ugyanazon a logikai alkalmazás-erőforráson belül.

Korlátozások

• Az integrációs fiókonkénti eszközök, például sémák számának korlátai vannak. További információkért tekintse át az Azure Logic Apps korlátait és konfigurációs adatait.

• Attól függően, hogy használatalapú vagy standard logikaialkalmazás-munkafolyamaton dolgozik-e, a sémafájl méretkorlátjai érvényesek lehetnek.

  • Ha standard munkafolyamatokkal dolgozik, a sémafájlméretekre nem vonatkoznak korlátozások.

  • Ha használatalapú munkafolyamatokkal dolgozik, a következő korlátozások érvényesek:

    • Ha a séma 2 MB vagy kisebb, a sémát közvetlenül az Azure Portalról veheti fel az integrációs fiókba.

    • Ha a séma 2 MB-nál nagyobb, de nem nagyobb a sémák méretkorlátjánál, szüksége lesz egy Azure Storage-fiókra és egy blobtárolóra, ahol feltöltheti a sémát. Ezután a séma integrációs fiókhoz való hozzáadásához az integrációs fiókból hivatkozhat a tárfiókra. Ehhez a feladathoz a következő táblázat ismerteti a szükséges elemeket:

      Elem	Leírás
      Azure Storage-fiók	Ebben a fiókban hozzon létre egy Azure Blob-tárolót a sémához. Megtudhatja , hogyan hozhat létre tárfiókot.
      Blobtároló	Ebben a tárolóban feltöltheti a sémát. A séma integrációs fiókhoz való hozzáadásakor később szüksége lesz a tároló URI-jára is. Megtudhatja, hogyan hozhat létre blobtárolót.
      Azure Storage Explorer	Ez az eszköz megkönnyíti a tárfiókok és blobtárolók kezelését. A Storage Explorer használatához válasszon egy lépést: – Az Azure Portalon válassza ki a tárfiókot. A tárfiók menüjében válassza a Storage Explorer lehetőséget. – Az asztali verzióhoz töltse le és telepítse az Azure Storage Explorert. Ezután csatlakoztassa a Storage Explorert a tárfiókhoz a Storage Explorer használatának első lépéseit követve. További információkért lásd a következőt: Gyors útmutató: Blob létrehozása objektumtárolóban az Azure Storage Explorerrel.

      Nagyobb sémák hozzáadásához használhatja az Azure Logic Apps REST API - Sémákat is. Standard munkafolyamatok esetén az Azure Logic Apps REST API jelenleg nem érhető el.

• Amikor integrációs fiókot használ a munkafolyamattal, általában hozzáadja a sémát ehhez a fiókhoz. Ha azonban olyan sémára hivatkozik vagy importál, amely nem szerepel az integrációs fiókjában, az elem xsd:redefinehasználatakor a következő hibaüzenet jelenhet meg:

  An error occurred while processing the XML schemas: ''SchemaLocation' must successfully resolve if <redefine> contains any child other than <annotation>.'.

  A hiba megoldásához használja az xsd:import vagy xsd:include elemet a xsd:redefine helyett, vagy használjon egy URI-t.

Sémák hozzáadásának szempontjai

• Ha használatalapú munkafolyamattal dolgozik, hozzá kell adnia a sémát egy csatolt integrációs fiókhoz.

• Ha standard munkafolyamattal dolgozik, a következő lehetőségek közül választhat:

  • Adja hozzá a sémát egy csatolt integrációs fiókhoz. A séma- és integrációs fiókot több standard logikai alkalmazás erőforrás között és azok alárendelt munkafolyamatain is megoszthatja.

  • Adja hozzá közvetlenül a sémát a logikai alkalmazás erőforrásához. Ezt a sémát azonban csak ugyanabban a logikaialkalmazás-erőforrásban oszthatja meg a gyermek munkafolyamatok között.

Séma hozzáadása integrációs fiókhoz

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

2. A fő Azure-keresőmezőbe írja be az integrációs fiókokat, és válassza az Integrációs fiókok lehetőséget.

3. Válassza ki azt az integrációs fiókot, amelyhez hozzá szeretné adni a sémát.

4. Az integrációs fiók erőforrásmenüjének Beállítások területén válassza a Sémák lehetőséget.

5. A Sémák panel eszköztárán válassza a Hozzáadás lehetőséget.

Sémák hozzáadása a logikai alkalmazáshoz

Használat

A használati munkafolyamatok esetében a séma fájlmérete alapján kövesse a legfeljebb 2 MB vagy 2 MB-nál nagyobb, legfeljebb 8 MB méretű séma feltöltésének lépéseit.

Legfeljebb 2 MB-os sémák hozzáadása

1. A Séma hozzáadása panelen adja meg a séma nevét. Tartsa kijelölve a Kis méretű fájlt. A Séma mező mellett válassza a mappaikont. Keresse meg és válassza ki a feltölteni kívánt sémát.

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

   Miután a séma feltöltése befejeződött, a séma megjelenik a Séma listában.

2 MB-nál nagyobb sémák hozzáadása

Nagyobb sémák hozzáadásához a Consumption munkafolyamatokhoz használhatja az Azure Logic Apps REST API - Schemas-t, vagy feltöltheti a sémákat egy Azure-blobtárolóba az Azure Storage-fiókjában. A sémák hozzáadásának lépései attól függően különböznek, hogy a blobtároló rendelkezik-e nyilvános olvasási hozzáféréssel. Először ellenőrizze, hogy a blobtároló rendelkezik-e nyilvános olvasási hozzáféréssel a következő lépések végrehajtásával: A blobtároló nyilvános hozzáférési szintjének beállítása

Tároló hozzáférési szintjének ellenőrzése

1. Nyissa meg az Azure Storage Explorer lehetőséget. Az Explorer ablakban bontsa ki az Azure-előfizetést, ha még nem bontotta ki.

2. Nyissa meg a Tárfiókok> {your-storage-account} >Blobtárolók. Válassza ki a blobtárolót.

3. A blobtároló helyi menüjében válassza a Nyilvános hozzáférési szint beállítása lehetőséget.

   • Ha a blobtároló legalább nyilvános hozzáféréssel rendelkezik, válassza a Mégse lehetőséget, és kövesse ezeket a lépéseket később ezen az oldalon: Feltöltés nyilvános hozzáféréssel rendelkező tárolókba

     

   • Ha a blobtároló nem rendelkezik nyilvános hozzáféréssel, válassza a Mégse lehetőséget, és kövesse az alábbi lépéseket a lap későbbi részében: Feltöltés nyilvános hozzáférés nélküli tárolókba

     

Feltöltés nyilvános hozzáférésű tárolókba

1. Töltse fel a sémát a tárfiókba. A jobb oldali ablakban válassza a Feltöltés lehetőséget.

2. A feltöltés befejezése után válassza ki a feltöltött sémát. Az eszköztáron válassza az URL-cím másolása lehetőséget a séma URL-címének másolásához.

3. Térjen vissza az Azure Portalra, ahol meg van nyitva a Séma hozzáadása panel. Írja be az összeállítás nevét. Válassza a Nagyméretű fájl (2 MB-nál nagyobb) lehetőséget.

   Ekkor megjelenik a Tartalom URI mező a Séma mező helyett.

4. A Tartalom URI mezőbe illessze be a séma URL-címét. Fejezze be a séma hozzáadását.

Miután a séma feltöltése befejeződött, a séma megjelenik a Séma listában. Az integrációs fiók Áttekintés lapján, az Összetevők területen megjelenik a feltöltött séma.

Feltöltés nyilvános hozzáférés nélküli tárolókba

1. Töltse fel a sémát a tárfiókba. A jobb oldali ablakban válassza a Feltöltés lehetőséget.

2. A feltöltés befejezése után hozzon létre egy közös hozzáférésű jogosultságkódot (SAS) a sémához. A séma helyi menüjében válassza a Megosztott hozzáférési aláírás lekérése lehetőséget.

3. A Megosztott hozzáférésű jogosultságkód panelen válassza a Tárolószintű megosztott hozzáférésű jogosultságkód URI létrehozása lehetőséget, majd kattintson a > gombra. Miután létrejött az SAS URL-cím, az URL-mező mellett válassza a Másolás lehetőséget.

4. Térjen vissza az Azure Portalra, ahol meg van nyitva a Séma hozzáadása panel. Válassza a Nagy fájl lehetőséget.

   Ekkor megjelenik a Tartalom URI mező a Séma mező helyett.

5. A Tartalom URI mezőbe illessze be a korábban létrehozott SAS URI-t. Fejezze be a séma hozzáadását.

Miután a séma feltöltése befejeződött, a séma megjelenik a Séma listában. Az integrációs fiók Áttekintés lapján, az Összetevők területen megjelenik a feltöltött séma.

Standard

Standard logikaialkalmazás-erőforrás esetén az alábbi lépések csak akkor érvényesek, ha közvetlenül hozzá szeretne adni egy sémát az erőforráshoz. Ellenkező esetben adja hozzá a sémát az integrációs fiókhoz.

Azure Portal

1. A logikai alkalmazás erőforrásmenüjének Beállítások területén válassza a Sémák lehetőséget.

2. A Sémák panel eszköztárán válassza a Hozzáadás lehetőséget.

3. A Séma hozzáadása panelen adjon meg egy egyedi nevet a sémának.

4. A Séma mező mellett válassza a mappaikont. Válassza ki a feltölteni kívánt sémát.

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

   Miután a sémafájl feltöltése befejeződött, a séma megjelenik a Séma listában. Az integrációs fiók Áttekintés lapján, az Összetevők területen a feltöltött séma is megjelenik.

Visual Studio Code

1. Nyissa meg a számítógépen a projekt helyi mappáját, és bontsa ki a következő mappákat: Artifacts Schemas>.

2. A Séma mappában adja hozzá a sémafájlt (.xsd).

3. Térjen vissza a Visual Studio Code-hoz.

   A sémafájl ekkor megjelenik a projektben, például:

   

Séma szerkesztése

Meglévő séma frissítéséhez fel kell töltenie egy új sémafájlt, amely tartalmazza a kívánt módosításokat. Először azonban letöltheti a meglévő sémát szerkesztésre.

Használat

1. Az Azure Portalon nyissa meg az integrációs fiókot, ha még nem nyitotta meg.

2. Az integrációs fiók menüjében, a Beállítások területen válassza a Sémák lehetőséget.

3. A Séma panel megnyitása után válassza ki a sémát. A séma első letöltéséhez és szerkesztéséhez a Séma panel eszköztárán válassza a Letöltés lehetőséget, és mentse a sémát.

4. Ha készen áll a frissített séma feltöltésére, a Séma panelen válassza ki a frissíteni kívánt sémát. A Sémák panel eszköztárán válassza a Frissítés lehetőséget.

5. Keresse meg és válassza ki a feltölteni kívánt frissített sémát.

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

   Miután a sémafájl feltöltése befejeződött, a frissített séma megjelenik a Séma listában.

Standard

Az alábbi lépések csak akkor érvényesek, ha a logikai alkalmazás erőforrásához hozzáadott sémát frissíti. Ellenkező esetben kövesse a séma integrációs fiókban való frissítésének használati lépéseit.

1. Az Azure Portalon nyissa meg a logikai alkalmazás erőforrását, ha még nem nyitotta meg.

2. A logikai alkalmazás erőforrásmenüjének Beállítások területén válassza a Sémák lehetőséget.

3. A Séma panel megnyitása után válassza ki a sémát. A séma első letöltéséhez és szerkesztéséhez a Séma panel eszköztárán válassza a Letöltés lehetőséget, és mentse a sémát.

4. A Sémák panel eszköztárán válassza a Hozzáadás lehetőséget.

5. A Séma hozzáadása panelen adjon meg egy egyedi nevet a sémának.

6. A Séma mező mellett válassza a mappaikont. Válassza ki a feltölteni kívánt sémát.

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

   Miután a sémafájl feltöltése befejeződött, a frissített séma megjelenik a Séma listában.

Séma törlése

Használat

1. Az Azure Portalon nyissa meg az integrációs fiókot, ha még nem nyitotta meg.

2. Az integrációs fiók erőforrásmenüjének Beállítások területén válassza a Sémák lehetőséget.

3. A Séma panel megnyitása után jelölje ki a sémát, majd válassza a Törlés lehetőséget.

4. A séma törlésének megerősítéséhez válassza az Igen lehetőséget.

Standard

Az alábbi lépések csak akkor érvényesek, ha töröl egy sémát, amelyet hozzáadott a logikai alkalmazás erőforrásához. Egyébként kövesse a séma integrációs fiókból való törléséhez szükséges műveleti lépéseket.

1. Az Azure Portalon nyissa meg a logikai alkalmazás erőforrását, ha még nem nyitotta meg.

2. A logikai alkalmazás erőforrásmenüjének Beállítások területén válassza a Sémák lehetőséget.

3. A Séma panel megnyitása után jelölje ki a sémát, majd válassza a Törlés lehetőséget.

4. A séma törlésének megerősítéséhez válassza az Igen lehetőséget.

Következő lépések

• XML ellenőrzése munkafolyamatokhoz az Azure Logic Appsben
• XML átalakítása munkafolyamatokhoz az Azure Logic Appsben