Egybesimított fájlok kódolása és dekódolás az Azure Logic Appsben

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

Mielőtt xml-tartalmat küld egy üzleti partnernek üzleti (B2B) forgatókönyvben, érdemes lehet először ezt a tartalmat kódolni. Ha kódolt XML-tartalmat kap, először ezt a tartalmat kell dekódolnia. Ha logikaialkalmazás-munkafolyamatot hoz létre az Azure Logic Appsben, az egybesimított fájlok kódolásához és dekódoláshoz használhatja a flat file beépített összekötőműveleteket, valamint egy lapos fájlsémát a kódoláshoz és dekódoláshoz. A több-bérlős Használat logikai alkalmazás munkafolyamataiban és az egybérlős Standard logikai alkalmazás munkafolyamataiban használhatja a lapos fájlműveleteket .

Bár nem érhetők el egybesimított fájl eseményindítók, bármilyen eseményindítóval vagy műveletsel betöltheti a forrás XML-tartalmat a munkafolyamatba. Használhat például egy beépített összekötő-eseményindítót, az Azure Logic Appshez elérhető felügyelt vagy Azure által üzemeltetett összekötő-eseményindítót, vagy akár egy másik alkalmazást is.

Ez a cikk bemutatja, hogyan adhatja hozzá a flat file kódolási és dekódolási műveleteket a munkafolyamathoz.

• Adjon hozzá egy lapos fájlkódolási vagy dekódolási műveletet a munkafolyamathoz.
• Jelölje ki a használni kívánt sémát.

További információkért tekintse át a következő dokumentációt:

• Használat és standard logikai alkalmazások
• Integrációs fiók beépített összekötői
• Az Azure Logic Apps beépített összekötőinek áttekintése
• Felügyelt vagy Azure által üzemeltetett összekötők az Azure Logic Appsben

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.

• Az üres vagy meglévő logikai alkalmazás munkafolyamata, ahol a Flat File műveletet szeretné használni.

  Ha üres munkafolyamata van, használjon bármilyen eseményindítót, amelyet el szeretne indítani a munkafolyamatban. Ez a példa a Kérelem eseményindítót használja.

• A logikai alkalmazás erőforrása és munkafolyamata. Az egybesimított fájlműveletek nem rendelkeznek eseményindítókkal, ezért a munkafolyamatnak minimálisan tartalmaznia kell egy eseményindítót. További információkért tekintse meg a következő dokumentációt:

  • Példa fogyasztási logikai alkalmazás munkafolyamatának létrehozása több-bérlős Azure Logic Appsben

  • Példa Standard logikai alkalmazás munkafolyamatának létrehozása egybérlős Azure Logic Appsben

• Egy egyszerű fájlséma az XML-tartalom kódolásához és dekódoláshoz. További információ: Séma hozzáadása munkafolyamatokhoz az Azure Logic Appsben.

• 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, a logikai alkalmazás erőforrásának szüksége van egy , az integrációs fiókra mutató hivatkozásra.

  • Ha standard logikaialkalmazás-munkafolyamaton dolgozik, csatolhatja a logikai alkalmazás erőforrását az integrációs fiókhoz, 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.

• Telepítsen vagy használjon olyan eszközt, amely HTTP-kéréseket küldhet a megoldás teszteléséhez, például:

  • Visual Studio Code a Visual Studio Marketplace bővítményével
  • PowerShell Invoke-RestMethod
  • Microsoft Edge – Hálózati konzol eszköz
  • Bruno
  • csavarodik

  Figyelemfelhívás

  Olyan helyzetekben, ahol bizalmas adatokkal rendelkezik, például hitelesítő adatokkal, titkos kódokkal, hozzáférési jogkivonatokkal, API-kulcsokkal és más hasonló információkkal, mindenképpen használjon olyan eszközt, amely a szükséges biztonsági funkciókkal védi az adatokat, offline vagy helyileg működik, nem szinkronizálja az adatokat a felhőbe, és nem követeli meg, hogy online fiókba jelentkezzen be. Így csökkentheti a bizalmas adatok nyilvános közzétételével járó kockázatokat.

Korlátozások

• A dekódolni kívánt XML-tartalmat UTF-8 formátumban kell kódolni.

• Az egybesimított fájlsémában győződjön meg arról, hogy a tartalmazott XML-csoportok nem rendelkeznek 1-nél nagyobb értékre beállított tulajdonság túlzott számávalmax count. Kerülje az 1-nél nagyobb tulajdonságértékkel rendelkező max count XML-csoport beágyazását egy másik, 1-nél nagyobb tulajdonsággal rendelkező XML-csoportba max count .

• Amikor az Azure Logic Apps elemzi a sima fájlsémát, és amikor a séma lehetővé teszi a következő töredék kiválasztását, az Azure Logic Apps létrehoz egy szimbólumot és egy előrejelzést a töredékhez. Ha a séma túl sok ilyen szerkezetet engedélyez, például több mint 100 000-et, a sémabővítés túlzottan nagy lesz, ami túl sok erőforrást és időt használ fel.

Séma feltöltése

A séma létrehozása után most a következő forgatókönyv alapján kell feltöltenie a sémát:

• Ha használatalapú logikai alkalmazás munkafolyamatán dolgozik, adja hozzá a sémát az integrációs fiókhoz.

• Ha standard logikaialkalmazás-munkafolyamaton dolgozik, hozzáadhatja a sémát az integrációs fiókhoz, vagy hozzáadhatja a sémát a logikai alkalmazás erőforrásához.

Egybesimított fájlkódolási művelet hozzáadása

Fogyasztás

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

2. Ha a munkafolyamat nem rendelkezik eseményindítóval vagy a munkafolyamathoz szükséges egyéb műveletekkel, először vegye fel ezeket a műveleteket. A lapos fájlműveletek nem rendelkeznek triggerekkel.

   Ez a példa a HTTP-kérés fogadásakor elnevezett Kérelem eseményindítóval folytatódik.

3. A munkafolyamat-tervező azon lépése alatt, ahol fel szeretné venni az egybesimított fájl műveletet, válassza az Új lépést.

4. A Művelet kiválasztása keresőmezőben válassza a Beépített lehetőséget. A keresőmezőbe írja be az egybesimított fájlt.

5. A műveletek listájában válassza ki a Lapos fájlkódolás nevű műveletet.

   

6. A művelet Content tulajdonságában adja meg az eseményindító vagy egy korábbi kódolni kívánt művelet kimenetét az alábbi lépések végrehajtásával:

   1. Kattintson a Tartalom mezőbe, hogy megjelenjen a dinamikus tartalomlista.

   2. A dinamikus tartalomlistában válassza ki a kódolni kívánt egybesimított fájltartalmat.

      Ebben a példában a dinamikus tartalomlistában a HTTP-kérés fogadásakor válassza ki a Törzs jogkivonatot, amely az eseményindító törzstartalom-kimenetét jelöli.

   

   Feljegyzés

   Ha a Törzs tulajdonság nem jelenik meg a dinamikus tartalomlistában, válassza a Továbbiak lehetőséget a HTTP-kérés fogadása szakaszcímke mellett. Közvetlenül is megadhatja a kódolni kívánt tartalmat a Tartalom mezőben.

7. A Sémanév listában válassza ki a sémát.

   

   Feljegyzés

   Ha a sémalista üres, akkor vagy a logikai alkalmazás erőforrása nem kapcsolódik az integrációs fiókhoz, vagy az integrációs fiók nem tartalmaz sémafájlokat.

   Ha végzett, a művelet a következőhöz hasonlóan néz ki:

   

8. Ha további választható paramétereket szeretne hozzáadni a művelethez, jelölje ki ezeket a paramétereket az Új paraméter hozzáadása listából.

   Paraméter	Érték	Leírás
   Az üres csomópont létrehozásának módja	ForcedDisabled vagy HonorSchemaNodeProperty vagy ForcedEnabled	Az üres csomópontok létrehozására használható mód lapos fájlkódolással. A BizTalk esetében az egybesimított fájlséma rendelkezik egy olyan tulajdonságtal, amely az üres csomópontok létrehozását szabályozza. Követheti a lapos fájlséma üres csomópontlétrehozási tulajdonságának viselkedését, vagy ezzel a beállítással létrehozhat vagy kihagyhat üres csomópontokat az Azure Logic Appsben. További információt az üres elemek címkéi című témakörben talál.
   XML-normalizálás	Igen vagy Nem	Az XML-normalizálás engedélyezésére vagy letiltására vonatkozó beállítás egybesimított fájlkódolásban. További információ: XmlTextReader.Normalization.

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

Standard

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

2. Ha a munkafolyamat nem rendelkezik eseményindítóval vagy a munkafolyamathoz szükséges egyéb műveletekkel, először vegye fel ezeket a műveleteket. A lapos fájlműveletek nem rendelkeznek triggerekkel.

   Ez a példa a HTTP-kérés fogadásakor elnevezett Kérelem eseményindítóval folytatódik.

3. A tervezőn a lépés alatt, ahol fel szeretné venni az egybesimított fájl műveletet, válassza a pluszjelet (+), majd válassza a Művelet hozzáadása lehetőséget.

4. A megjelenő Művelet hozzáadása panel keresőmezője alatt válassza a Beépített lehetőséget.

5. A keresőmezőbe írja be az egybesimított fájlt. A műveletek listájában válassza ki a Lapos fájlkódolás nevű műveletet.

   

6. A művelet Content tulajdonságában adja meg az eseményindító vagy egy korábbi kódolni kívánt művelet kimenetét az alábbi lépések végrehajtásával:

   1. Kattintson a Tartalom mezőbe, hogy megjelenjen a dinamikus tartalomlista.

   2. A dinamikus tartalomlistában válassza ki a kódolni kívánt egybesimított fájltartalmat.

      Ebben a példában a dinamikus tartalomlistában a HTTP-kérés fogadásakor válassza ki a Törzs jogkivonatot, amely az eseményindító törzstartalom-kimenetét jelöli.

   

7. A Forráslistában válassza a LogicApp vagy az IntegrationAccount lehetőséget sémaforrásként.

   Ez a példa az IntegrationAccount elem kiválasztásával folytatódik.

   

8. A Névlistában válassza ki azt a sémát, amelyet korábban feltöltött a logikai alkalmazás erőforrásába kódoláshoz, például:

   

   Feljegyzés

   Ha a sémalista üres, vagy a logikai alkalmazás erőforrása nincs csatolva az integrációs fiókhoz, az integrációs fiók nem tartalmaz sémafájlokat, vagy a logikai alkalmazás erőforrása nem tartalmaz sémafájlokat.

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

Egybesimított fájldekódolási művelet hozzáadása

Fogyasztás

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

2. Ha a munkafolyamat nem rendelkezik eseményindítóval vagy a munkafolyamathoz szükséges egyéb műveletekkel, először vegye fel ezeket a műveleteket. A lapos fájlműveletek nem rendelkeznek triggerekkel.

   Ez a példa a HTTP-kérés fogadásakor elnevezett Kérelem eseményindítóval folytatódik.

3. A munkafolyamat-tervező azon lépése alatt, ahol fel szeretné venni az egybesimított fájl műveletet, válassza az Új lépést.

4. A Művelet kiválasztása keresőmezőben válassza a Beépített lehetőséget. A keresőmezőbe írja be az egybesimított fájlt.

5. A műveletek listájában válassza ki a Flat File Decoding (Egyszerű fájldekódolás) nevű műveletet.

   

6. A művelet Content tulajdonságában adja meg az eseményindító vagy egy korábbi művelet kimenetét, amelyet az alábbi lépések végrehajtásával szeretne dekódolni:

   1. Kattintson a Tartalom mezőbe, hogy megjelenjen a dinamikus tartalomlista.

   2. A dinamikus tartalomlistában válassza ki a kódolni kívánt egybesimított fájltartalmat.

      Ebben a példában a dinamikus tartalomlistában a HTTP-kérés fogadásakor válassza ki a Törzs jogkivonatot, amely az eseményindító törzstartalom-kimenetét jelöli.

   

   Feljegyzés

   Ha a Törzs tulajdonság nem jelenik meg a dinamikus tartalomlistában, válassza a Továbbiak lehetőséget a HTTP-kérés fogadása szakaszcímke mellett. Közvetlenül is megadhatja a kódolni kívánt tartalmat a Tartalom mezőben.

7. A Sémanév listában válassza ki a sémát.

   

   Feljegyzés

   Ha a sémalista üres, akkor vagy a logikai alkalmazás erőforrása nem kapcsolódik az integrációs fiókhoz, vagy az integrációs fiók nem tartalmaz sémafájlokat.

   Ha végzett, a művelet a következőhöz hasonlóan néz ki:

   

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

Standard

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

2. Ha a munkafolyamat nem rendelkezik eseményindítóval vagy a munkafolyamathoz szükséges egyéb műveletekkel, először vegye fel ezeket a műveleteket. A lapos fájlműveletek nem rendelkeznek triggerekkel.

   Ez a példa a HTTP-kérés fogadásakor elnevezett Kérelem eseményindítóval folytatódik.

3. A tervezőn a lépés alatt, ahol fel szeretné venni az egybesimított fájl műveletet, válassza a pluszjelet (+), majd válassza a Művelet hozzáadása lehetőséget.

4. A megjelenő Művelet hozzáadása panel keresőmezője alatt válassza a Beépített lehetőséget.

5. A keresőmezőbe írja be az egybesimított fájlt. A műveletek listájában válassza ki a Flat File Decoding (Egyszerű fájldekódolás) nevű műveletet.

   

6. A művelet Content tulajdonságában adja meg az eseményindító vagy egy korábbi művelet kimenetét, amelyet az alábbi lépések végrehajtásával szeretne dekódolni:

   1. Kattintson a Tartalom mezőbe, hogy megjelenjen a dinamikus tartalomlista.

   2. A dinamikus tartalomlistában válassza ki a kódolni kívánt egybesimított fájltartalmat.

      Ebben a példában a dinamikus tartalomlistában a HTTP-kérés fogadásakor válassza ki a Törzs jogkivonatot, amely az eseményindító törzstartalom-kimenetét jelöli.

   

7. A Forráslistában válassza a LogicApp vagy az IntegrationAccount lehetőséget sémaforrásként.

   Ez a példa az IntegrationAccount elem kiválasztásával folytatódik.

   

8. A Névlistában válassza ki a logikai alkalmazás erőforrásába korábban feltöltött sémát a dekódoláshoz, például:

   

   Feljegyzés

   Ha a sémalista üres, vagy a logikai alkalmazás erőforrása nincs csatolva az integrációs fiókhoz, az integrációs fiók nem tartalmaz sémafájlokat, vagy a logikai alkalmazás erőforrása nem tartalmaz sémafájlokat.

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

Ezzel befejezte a sima fájldekódolási művelet beállítását. Egy valós alkalmazásban érdemes lehet a dekódolt adatokat egy üzletági (LOB) alkalmazásban, például a Salesforce-ban tárolni. Vagy elküldheti a dekódolt adatokat egy kereskedelmi partnernek. Ha a dekódolási művelet kimenetét a Salesforce-nak vagy a kereskedelmi partnerének szeretné elküldeni, használja az Azure Logic Appsben elérhető többi összekötőt:

• Felügyelt összekötők az Azure Logic Appshez
• Beépített összekötők az Azure Logic Appshez

A munkafolyamat tesztelése

A munkafolyamat aktiválásához kövesse az alábbi lépéseket:

1. A Kérelem eseményindítóban keresse meg a HTTP POST URL-tulajdonságot, és másolja ki az URL-címet.

2. Nyissa meg a HTTP-kérési eszközt, és annak utasításait használva küldjön HTTP-kérést a másolt URL-címre, beleértve azt a módszert is, amelyet a kérésindító elvár.

   Ez a példa az POST URL-címmel rendelkező metódust használja.

3. Adja meg a kódolni vagy dekódolni kívánt XML-tartalmat a kérelem törzsében.

4. A munkafolyamat futtatása után nyissa meg a munkafolyamat futtatási előzményeit, és vizsgálja meg a flat file művelet bemeneteit és kimeneteit.

Következő lépések

• További információ a nagyvállalati integrációs csomagról