Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
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:
Požadavky
Účet a předplatné Azure. Získejte bezplatný účet Azure.
Prostředek aplikace logiky a pracovní postup, ve kterém chcete použít operace RosettaNet.
Pracovní postup vyžaduje všechny triggery, které jsou pro váš scénář nejvhodnější, a všechny další akce, které chcete spustit, než přidáte akci RosettaNet.
Další informace najdete tady:
Prostředek účtu integrace pro definování a ukládání artefaktů pro použití v pracovních postupech podnikové integrace a B2B.
Váš účet integrace i prostředek aplikace logiky musí existovat ve stejném předplatném Azure i v oblasti Azure.
Definuje alespoň dva obchodní partnery , kteří se účastní operace RosettaNet použité ve vašem pracovním postupu. Obě definice partnera musí používat stejný kvalifikátor obchodní identity , což je DUNS.
Důležité
Ujistěte se, že jste vybrali DUNS, který najdete v dolní části seznamu kvalifikátoru , a ne 1 - D-U-N-S (Dun & Bradstreet).
Obsahuje konfiguraci procesu PIP , která ukládá všechny vlastnosti konfigurace PIP. Tuto konfiguraci použijete při vytváření smlouvy mezi partnery. Pokud nemáte konfiguraci procesu, přidejte konfiguraci procesu PIP.
Definuje dohodu RosettaNet mezi obchodními partnery, kteří se účastní operace RosettaNet. Smlouva vyžaduje hostitelského partnera a hostujícího partnera. Obsah zpráv mezi partnery musí odpovídat typu smlouvy. Viz Vytvoření smlouvy RosettaNet.
Než začnete pracovat s operacemi RosettaNet, musíte propojit aplikaci Logiky typu Consumption nebo propojit aplikaci Logiky typu Standard s integračním účtem.
Volitelné certifikáty pro šifrování, dešifrování nebo podepisování zpráv, které nahrajete do účtu integrace. Certifikáty se vyžadují jenom v případě, že používáte podepisování nebo šifrování.
Přidejte konfiguraci procesu PIP
Pokud váš účet integrace nemá konfiguraci procesu PIP, přidejte konfiguraci pomocí následujícího postupu:
Na portálu Azure přejděte ke zdroji vašeho integračního účtu.
Na bočním panelu prostředku v části Nastavení vyberte RosettaNet PIP. Na panelu nástrojů stránky RosettaNet PIP vyberte Přidat.
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:
Až budete hotovi, vyberte OK a vytvořte konfiguraci PIP.
Pokud chcete zobrazit nebo upravit konfiguraci procesu, vyberte pip. Na panelu nástrojů stránky RosettaNet PIP vyberte Upravit jako JSON.
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.
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.
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ů:
Na webu Azure Portal přejděte na prostředek svého integračního účtu.
Na bočním panelu prostředku v části Nastavení vyberte Smlouvy. Na panelu nástrojů stránky Smlouvy vyberte Přidat.
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:
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í. 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í.
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ů.
Jakmile budete hotovi, vyberte tlačítko OK.
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í. 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í.
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.
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:
Jakmile budete hotovi, vyberte tlačítko OK.
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.
Ve sloupci Název PIP otevřete seznam a vyberte PIP.
Výběr naplní zbývající vlastnosti, které jsou založené na PIP ve vašem integračním účtu.
V případě potřeby můžete změnit roli PIP.
Pokračujte k další části pro příjem zpráv RosettaNet.
Příjem a dekódování zpráv RosettaNet
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.
Postupujte podle těchto obecných kroků a přidejte do pracovního postupu akci dekódování RosettaNetu.
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.
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
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.
Pomocí těchto obecných kroků přidejte akci kódování RosettaNet do pracovního postupu.
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 Tato akce je teď nastavená pro kódování a odeslání zprávy RosettaNet partnerovi typu host.
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.
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í.
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.
Pokud akce RosettaNet neobdrží odpověď, akce vygeneruje oznámení o selhání.
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: