Sdílet prostřednictvím


Výměna zpráv RosettaNet v pracovních postupech B2B pomocí Azure Logic Apps

Platí pro: Azure Logic Apps (Consumption + Standard)

Pokud chcete odesílat a přijímat zprávy RosettaNet v pracovních postupech, které vytvoříte pomocí Azure Logic Apps, použijte konektor RosettaNet . Tento konektor poskytuje akce, které podporují a spravují komunikaci, která dodržuje standardy RosettaNet. Tyto standardy se běžně používají pro procesy dodavatelského řetězce a jsou rozšířeny v polovodičích, elektronikách a logistickém průmyslu. RosettaNet je založen na JAZYCE XML a definuje pokyny pro zprávy, rozhraní pro obchodní procesy a implementační architektury pro komunikaci mezi společnostmi.

Konektor RosettaNet poskytuje následující možnosti:

  • Příjem a dekódování zpráv RosettaNet
  • Odesílání a kódování zpráv RosettaNet
  • Počkejte na odpověď a generování oznámení o selhání.

Tato příručka poskytuje krátký přehled o rosettanetu a ukazuje, jak přidat akce kódování a dekódování pro RosettaNet do existujícího pracovního postupu aplikace logiky. Konektor RosettaNet neposkytuje žádné aktivační události, takže ke spuštění pracovního postupu můžete použít libovolnou aktivační událost. Příklady v této příručce používají spouštěč požadavku.

Vysvětlení konceptů RosettaNetu

RosettaNet je organizace, která vytvořila standardní procesy pro sdílení obchodních informací. Tato organizace vytváří a udržuje procesy partnerského rozhraní (PIP), které poskytují společné definice obchodních procesů pro všechny výměny zpráv RosettaNet. Další informace najdete na webu RosettaNet.

Konektor RosettaNet je založený na rozhraní RNIF (RosettaNet Implementation Framework) verze 2.0.01 a podporuje všechny PIP definované touto verzí. RNIF je otevřená síťová aplikační architektura, která umožňuje obchodním partnerům spolupracovat na provozování RosettaNet PIPs. Tato architektura definuje strukturu zpráv, potřebu potvrzení, kódování MIME (Multipurpose Internet Mail Extensions) a digitální podpis. Komunikace mezi partnery může být synchronní nebo asynchronní.

Následující tabulka popisuje koncepty a termíny RosettaNet:

Koncepce Popis
JÁDRO Pip poskytuje běžné definice obchodních procesů pro všechny výměny zpráv RosettaNet. PIP jsou kategorizovány podle obchodní funkce vysoké úrovně nebo clusteru a dílčí funkce nebo segmentu. Například "3A4" je PIP pro nákupní objednávku, zatímco "3" je funkce Správa objednávek a "3A" je subfunkce Nabídky a Položka objednávky.

Každá specifikace PIP poskytuje soubor definice typu dokumentu (DTD) a dokument s pokyny ke zprávě. Soubor DTD definuje strukturu zpráv obsahu služby. Dokument s pokyny ke zprávě je soubor HTML čitelný pro člověka, který určuje omezení na úrovni elementů. Společně soubory PIP a DTD poskytují úplnou definici obchodního procesu.

Další informace najdete na webu RosettaNet.
Akce Akční zprávy jsou součástí PIP a jedná se o obchodní sdělení, která si vzájemně vyměňují partneři.
Signál Signální zprávy jsou součástí pipu a jsou potvrzení odeslaná v reakci na zprávy akcí.
Jedna akce a dvojitá akce U pipu s jedinou akcí je jedinou odpovědí zpráva o potvrzení. V případě dvojitého akčního PIPu obdrží iniciátor zprávu s odpovědí a odpoví potvrzením, přičemž je součástí i tok zprávy s jednou akcí.

Technické reference ke konektoru

Konektor RosettaNet má různé verze založené na typu aplikace logiky a hostitelském prostředí.

Aplikace logiky Prostředí Verze konektoru
Využití Azure Logic Apps s více tenanty Spravovaný konektor RosettaNet, který se zobrazí v galerii konektorů v části Sdílené. Konektor RosettaNet poskytuje pouze akce. Můžete použít libovolný trigger, který funguje pro váš scénář. Další informace najdete tady:

- Operace RosettaNet
- Omezení protokolu B2B pro velikosti zpráv
Standard Azure Logic Apps s jedním tenantem, App Service Environment v3 (jenom plány Windows) a hybridní nasazení Integrovaný konektor RosettaNet, který se zobrazí v galerii konektorů v kategorii Integrované. Konektor RosettaNet poskytuje pouze akce. Můžete použít libovolný trigger, který funguje pro váš scénář.

Integrovaný konektor má přímý přístup k virtuálním sítím Azure. Nepotřebujete místní bránu dat.

Další informace najdete tady:

- Operace RosettaNet
- Omezení protokolu B2B pro velikosti zpráv

Operace RosettaNet

Konektor RosettaNet nemá žádné aktivační události. Následující tabulka popisuje akce, které konektor RosettaNet poskytuje k vytvoření zabezpečení a spolehlivosti při přenosu zpráv:

Akce Popis
Kódování RosettaNet Odešlete zprávy RosettaNet pomocí kódování, které se řídí standardy RosettaNet.
Dekódování RosettaNet Příjem zpráv RosettaNet pomocí dekódování, které se řídí standardy RosettaNet.
RosettaNet wait for response Požádejte hostitele, aby čekal na odpověď RosettaNet nebo signálovou zprávu od příjemce.

Požadavky

Přidejte konfiguraci procesu PIP

Pokud váš účet integrace nemá konfiguraci procesu PIP, přidejte konfiguraci pomocí následujícího postupu:

  1. Na portálu Azure přejděte ke zdroji vašeho integračního účtu.

  2. Na bočním panelu prostředku v části Nastavení vyberte RosettaNet PIP. Na panelu nástrojů stránky RosettaNet PIP vyberte Přidat.

  3. V podokně Přidat proces partnerského rozhraní zadejte následující informace PIP:

    Parameter Požadováno Popis
    Jméno Ano Název PIP.
    Kód PIP Ano Tříznakový kód PIP. Další informace naleznete v tématu RosettaNet PIPs.
    Verze PIP Ano Verze PIP, která závisí na vybraném kódu PIP.

    Další informace najdete na webu RosettaNet.

    Následující příklad ukazuje ukázkové informace o konfiguraci procesu PIP:

    Snímek obrazovky z Azure Portal, prostředku integračního účtu a stránky RosettaNet PIP s vybranou možností Přidat. Podokno Přidání procesu partnerského rozhraní obsahuje pole pro název, kód a verzi.

  4. Až budete hotovi, vyberte OK a vytvořte konfiguraci PIP.

  5. Pokud chcete zobrazit nebo upravit konfiguraci procesu, vyberte pip. Na panelu nástrojů stránky RosettaNet PIP vyberte Upravit jako JSON.

    Snímek obrazovky ukazuje stránku RosettaNet PIP s vybraným PIP a možností Upravit jako JSON. Editor JSON zobrazuje zakódovaná nastavení PIP.

    Všechna nastavení konfigurace procesů pocházejí ze specifikací PIP. Azure Logic Apps ve výchozím nastavení naplní většinu nastavení výchozími hodnotami na základě nejčastěji používaných hodnot.

  6. Ověřte, že hodnoty nastavení odpovídají hodnotám v příslušné specifikaci PIP a splňují vaše obchodní potřeby. V případě potřeby aktualizujte hodnoty v editoru JSON a uložte změny.

  7. Jakmile budete hotovi, vyberte tlačítko OK.

Vytvoření smlouvy RosettaNet

Pokud váš účet integrace nemá smlouvu RosettaNet, vytvořte smlouvu podle těchto kroků:

  1. Na webu Azure Portal přejděte na prostředek svého integračního účtu.

  2. Na bočním panelu prostředku v části Nastavení vyberte Smlouvy. Na panelu nástrojů stránky Smlouvy vyberte Přidat.

  3. V podokně Přidat zadejte následující informace o smlouvě:

    Parameter Požadováno Popis
    Jméno Ano Název smlouvy.
    Typ smlouvy Ano Typ protokolu pro smlouvu. Vyberte RosettaNet.
    Partner hostitele Ano Název hostitelského partnera, který představuje vaši organizaci. Smlouva vyžaduje hostitele i partnera typu host.
    Identita hostitele Ano Identifikátor partnera hostitele.
    Partner typu host Ano Název partnera typu host, který spolupracuje s hostitelským partnerem. Smlouva vyžaduje hostitele i partnera typu host.
    Identita hosta Ano Identifikátor partnera typu host.
    Nastavení příjmu Je to různé. Vlastnosti, které platí pro všechny zprávy přijaté partnerem hostitele od partnera typu host.
    Odeslat nastavení Je to různé. Vlastnosti, které platí pro všechny zprávy odeslané partnerem hostitele pro partnera typu host.
    Odkazy na rosettanet PIP Ano Odkazy PIP na smlouvu. Všechny zprávy RosettaNet vyžadují konfigurace PIP.

    Následující příklad ukazuje ukázkové informace pro smlouvu RosettaNet:

    Snímek obrazovky znázorňující stránku Smlouva s vybranou možností Přidat a informacemi o smlouvě

  4. Chcete-li určit, jakým způsobem hostitelský partner přijímá zprávy od hostujícího partnera, vyberte v podokně Přidat možnost Přijímací nastavení.

    V podokně Nastavení příjmu se zobrazí následující nastavení:

    Setting Požadováno Popis
    Zpráva by měla být podepsaná. No Podepište příchozí zprávy vybraným certifikátem.
    Certifikát Ano, pokud je povolené podepisování Certifikát, který se má použít k podepisování.
    Povolení šifrování zpráv No Zašifrujte příchozí zprávy pomocí vybraného certifikátu.
    Certifikát Ano, pokud je povolené šifrování Certifikát, který se má použít k šifrování.
    1. Chcete-li povolit podepisování, šifrování nebo obojí pro příchozí zprávy, v části Zpráva, vyberte Možnost Zpráva by měla být podepsána, zpráva by měla být zašifrována nebo obojí.

    2. V každém vybraném nastavení vyberte ze seznamu certifikátůcertifikát z vašeho účtu integrace, který chcete použít k podepisování, šifrování nebo obojímu.

    Následující příklad ukazuje nastavení podepisování a šifrování v podokně Nastavení příjmu :

    Aplikace následně ukáže snímek obrazovky s podoknem Nastavení příjmu, který obsahuje možnosti pro podepisování a šifrování zpráv a zadávání certifikátů.

  5. Jakmile budete hotovi, vyberte tlačítko OK.

  6. Pokud chcete určit, jak hostující partner posílá zprávy partnerskému hostu, vyberte v podokně PřidatNastavení odesílání.

    V podokně Odeslat nastavení se zobrazí následující nastavení:

    Setting Požadováno Popis
    Povolení podepisování zpráv No Podepište odchozí zprávy pomocí vybraného podpisového algoritmu a certifikátu.
    Podpisový algoritmus Ano, pokud je povolené podepisování Podpisový algoritmus, který se má použít na základě vybraného certifikátu.
    Certifikát Ano, pokud je povolené podepisování Certifikát, který se má použít k podepisování.
    Povolení šifrování zpráv No Zašifrujte odchozí zprávy pomocí vybraného šifrovacího algoritmu a certifikátu.
    Šifrovací algoritmus Ano, pokud je povolené šifrování Šifrovací algoritmus, který se má použít, na základě vybraného certifikátu.
    Certifikát Ano, pokud je povolené šifrování Certifikát, který se má použít k šifrování.
    1. Pokud chcete povolit podepisování, šifrování nebo obojí pro odchozí zprávy, v části Zprávy vyberte Povolit podepisování zpráv, Povolit šifrování zpráv nebo obojí.

    2. V každém vybraném nastavení v seznamu algoritmů vyberte algoritmus, který chcete použít. V seznamu certifikátů vyberte certifikát z vašeho účtu integrace, který chcete použít k podepisování, šifrování nebo obojímu.

    3. V části Koncové body zadejte požadované adresy URL pro odesílání zpráv akcí a potvrzení:

      Parameter Požadováno Popis
      Adresa URL akce Ano Adresa URL, která se má použít k odesílání zpráv akcí. Tato adresa URL se vyžaduje pro synchronní i asynchronní zprávy.
      Adresa URL potvrzení Ano Adresa URL, která se má použít k odesílání zpráv potvrzení. Tato adresa URL se vyžaduje pro asynchronní zprávy.

      Následující příklad ukazuje nastavení podepisování, šifrování a adresy URL koncového bodu v podokně Odeslat nastavení s některými ukázkovými hodnotami:

      Snímek obrazovky s podoknem Odeslat nastavení s možnostmi podepisování a šifrování zpráv a zadávání algoritmů, certifikátů a adres URL koncových bodů

  7. Jakmile budete hotovi, vyberte tlačítko OK.

  8. Chcete-li zadat odkazy RosettaNet PIP pro smlouvu, v podokně Přidat vyberte odkazy RosettaNet PIP.

    Na stránce odkazů RosettaNet PIP se zobrazuje konfigurace procesu PIP, kterou jste vytvořili a přidali dříve.

    1. Ve sloupci Název PIP otevřete seznam a vyberte PIP.

      Snímek obrazovky s tabulkou informací PIP, která obsahuje jeden řádek, který obsahuje výchozí hodnoty s výjimkou názvu MyPIPConfig, který je vybraný

      Výběr naplní zbývající vlastnosti, které jsou založené na PIP ve vašem integračním účtu.

      Snímek obrazovky zobrazuje tabulku s informacemi PIP s řádkem pip s názvem MyPIPConfig zobrazující informace.

    2. V případě potřeby můžete změnit roli PIP.

  9. Pokračujte k další části pro příjem zpráv RosettaNet.

Příjem a dekódování zpráv RosettaNet

  1. V portálu Azure otevřete prostředek logické aplikace. Otevřete pracovní postup v návrháři.

    Pracovní postup by již měl mít trigger a všechny další akce, které chcete spustit před přidáním akce RosettaNet.

  2. Postupujte podle těchto obecných kroků a přidejte do pracovního postupu akci dekódování RosettaNetu.

  3. V podokně informací o akci zadejte následující hodnoty:

    Parameter Požadováno Popis
    Zpráva Ano Zpráva RosettaNet pro dekódování.
    Záhlaví Ano Hlavičky HTTP, které poskytují hodnoty pro verzi a typ odpovědi jako páry klíč-hodnota. Verze je RNIF. Typ odpovědi popisuje typ komunikace partnera a může být synchronní nebo asynchronní.
    Role Ano Role partnera hostitele v nástroji PIP.

    Snímek obrazovky zobrazuje akci dekódování RosettaNet s poli pro zprávu k dekódování, záhlaví a roli.

Výstup akce dekódování RosettaNet obsahuje hodnotu odchozího signálu . Tento výstup můžete zakódovat a vracet partnerovi typu host nebo můžete s tímto výstupem provést jinou akci.

Odesílání a kódování zpráv RosettaNet

  1. V portálu Azure otevřete prostředek logické aplikace. Otevřete pracovní postup v návrháři.

    Pracovní postup by již měl mít trigger a všechny další akce, které chcete spustit před přidáním akce RosettaNet.

  2. Pomocí těchto obecných kroků přidejte akci kódování RosettaNet do pracovního postupu.

  3. V podokně informací o akci zadejte následující hodnoty:

    Parameter Požadováno Popis
    Identita instance procesu RosettaNet (PIP) Ano ID instance pro zprávu, která se má kódovat.
    Partner hostitele Ano Název partnera hostitele.
    Partner typu host Ano Název partnera typu host.
    Kód PIP Ano Kód PIP.
    Verze PIP Ano Verze PIP.
    Identita instance PIP Ano Jedinečný identifikátor této zprávy PIP.
    Typ zprávy Ano Typ zprávy, který má být kódován.
    Role Ano Úloha hostitelského partnera

    Snímek obrazovky znázorňující akci kódování RosettaNet s poli pro zprávu, partnery, informace PIP, typ zprávy a roli

    Tato akce je teď nastavená pro kódování a odeslání zprávy RosettaNet partnerovi typu host.

  4. Pokud chcete odeslat zakódovanou zprávu RosettaNet, postupujte podle těchto obecných kroků a přidejte příslušnou akci pro váš scénář. Zadejte hodnoty, které akce potřebuje k odeslání zprávy.

    V tomto příkladu se používá akce HTTP , která se přejmenuje na HTTP – Odeslat zakódovanou zprávu partnerovi. Hodnoty jsou výstupy z akce kódování RosettaNet a jsou přidány prostřednictvím seznamu dynamického obsahu.

    Snímek obrazovky ukazuje přejmenovanou akci HTTP s ukázkovými identifikátory URI, záhlavím a body.

    Na základě standardů RosettaNet jsou obchodní transakce dokončeny až po dokončení všech kroků definovaných nástrojem PIP. Jakmile partner hostitele odešle zakódovanou zprávu partnerovi hosta, hostitel počká na signál a potvrzení.

  5. Do pracovního postupu přidejte akci RosettaNet , která čeká na odpověď. V podokně informací o akci zadejte následující hodnoty:

    Parameter Požadováno Popis
    Tělo Ano Původní zakódovaná zpráva.
    Identita instance PIP Ano ID instance pro zakódovanou zprávu.
    Počet opakování Ano Počet opakování pro kódování a odeslání zprávy.
    Role Ano Role hostitelského partnera.

    Doba čekání a počet opakování akce RosettaNet vychází z konfigurace PIP.

    Snímek obrazovky znázorňující akci RosettaNet čekání na odpověď s políčky pro tělo, identitu instance PIP, počet opakování a hodnoty rolí

    Pokud akce RosettaNet neobdrží odpověď, akce vygeneruje oznámení o selhání.

  6. Pokud chcete zpracovat pokusy o opakování, vždy umístěte akce RosettaNet k odeslání zakódované zprávy a počkejte na odpověď uvnitř smyčky Until , například:

    Snímek obrazovky návrháře se smyčkou Until obsahuje akce pro kódování a odesílání zpráv a čekání na odezvy.