Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Aplica-se a: Azure Logic Apps (Consumo e Standard)
Para enviar e receber mensagens RosettaNet em fluxos de trabalho que cria usando o Azure Logic Apps, utilize o conector RosettaNet . Este conector fornece ações que suportam e gerem a comunicação que segue os padrões RosettaNet. Esses padrões são comumente usados para processos da cadeia de suprimentos e são difundidos nos setores de semicondutores, eletrônicos e logística. RosettaNet é baseado em XML e define diretrizes de mensagens, interfaces para processos de negócios e estruturas de implementação para comunicação entre empresas.
O conector RosettaNet oferece as seguintes capacidades:
- Receber e decodificar mensagens do RosettaNet.
- Enviar e codificar mensagens RosettaNet.
- Aguarde a resposta e geração de Notificação de Falha.
Este guia fornece uma breve visão geral sobre o RosettaNet e mostra como adicionar as ações de codificação e decodificação do RosettaNet a um fluxo de trabalho existente de uma aplicação lógica. O conector RosettaNet não fornece nenhum trigger, por isso podes usar qualquer trigger para iniciar o teu fluxo de trabalho. Os exemplos neste guia usam o gatilho de pedido Request trigger.
Compreender os conceitos da RosettaNet
A RosettaNet é uma organização que estabeleceu processos padrão para partilha de informação empresarial. Esta organização cria e mantém Processos de Interface de Parceiros (PIPs), que fornecem definições comuns de processos de negócio para todas as trocas de mensagens da RosettaNet. Para mais informações, visite o site da RosettaNet.
O conector RosettaNet baseia-se na versão 2.0.01 do RosettaNet Implementation Framework (RNIF) e suporta todos os PIPs definidos por esta versão. O RNIF é um framework de aplicações de rede aberta que facilita aos parceiros de negócio a execução colaborativa dos PIPs RosettaNet. Essa estrutura define a estrutura da mensagem, a necessidade de reconhecimentos, a codificação MIME (Multipurpose Internet Mail Extensions) e a assinatura digital. A comunicação entre parceiros pode ser síncrona ou assíncrona.
A tabela seguinte descreve conceitos e termos do RosettaNet:
| Concept | Descrição |
|---|---|
| PIP | Um PIP fornece definições comuns de processos de negócio para todas as trocas de mensagens RosettaNet. Os PIPs são categorizados por uma função empresarial de alto nível, ou cluster, e uma subfunção, ou segmento. Por exemplo, "3A4" é o PIP para Ordem de Compra, enquanto "3" é a função de Gerenciamento de Pedidos, e "3A" é a subfunção Cotação e Entrada de Ordem. Cada especificação PIP fornece um arquivo de definição de tipo de documento (DTD) e um documento de diretriz de mensagem. O arquivo DTD define a estrutura da mensagem de conteúdo de serviço. O documento de diretrizes de mensagem é um ficheiro HTML legível por humanos que especifica restrições ao nível dos elementos. Em conjunto, os ficheiros PIP e DTD fornecem uma definição completa do processo de negócio. Para mais informações, visite o site da RosettaNet. |
| Ação | As mensagens de ação fazem parte de um PIP e são mensagens comerciais que os parceiros trocam entre si. |
| Sinal | As mensagens de sinal fazem parte de um PIP e são confirmações enviadas em resposta a mensagens de ação. |
| Ação única e ação dupla | Para um PIP com uma única ação, a única resposta é uma mensagem de sinal de confirmação. Para um PIP de dupla ação, o iniciador recebe uma mensagem de resposta e responde com uma confirmação, juntamente com o fluxo de mensagens de ação única. |
Referência técnica do conector
O conector RosettaNet tem diferentes versões, consoante o tipo de aplicação lógica e o ambiente anfitrião.
| Aplicação lógica | Environment | Versão do conector |
|---|---|---|
| Consumo | Aplicativos Lógicos do Azure Multilocatários | Conector gerido RosettaNet, que aparece na galeria de conectores em Partilhado. O conector RosettaNet fornece apenas ações. Você pode usar qualquer gatilho que funcione para o seu cenário. Para mais informações, consulte: - Operações da RosettaNet - Limites do protocolo B2B para tamanhos de mensagens |
| Standard | Aplicações Lógicas do Azure de locatário único, Ambiente de Serviço de Aplicações v3 (planos Windows apenas) e implantação híbrida | Conector incorporado do RosettaNet, que aparece na galeria de conectores em Incorporado. O conector RosettaNet fornece apenas ações. Você pode usar qualquer gatilho que funcione para o seu cenário. O conector incorporado pode aceder diretamente a redes virtuais Azure. Você não precisa de um gateway de dados local. Para mais informações, consulte: - Operações da RosettaNet - Limites do protocolo B2B para tamanhos de mensagens |
Operações RosettaNet
O conector RosettaNet não tem gatilhos. A tabela a seguir descreve as ações que o conector RosettaNet fornece para estabelecer segurança e confiabilidade ao transmitir mensagens:
Pré-requisitos
Uma conta e subscrição do Azure. Crie uma conta Azure gratuita.
O recurso e fluxo de trabalho da aplicação lógica onde quer usar as operações do RosettaNet.
O fluxo de trabalho exige qualquer gatilho que funcione melhor para o teu cenário e quaisquer outras ações que queiras executar antes de adicionares uma ação do RosettaNet.
Para obter mais informações, consulte:
Um recurso de conta de integração para definir e armazenar artefatos para uso em integração empresarial e fluxos de trabalho B2B.
Sua conta de integração e o recurso do aplicativo lógico devem existir na mesma assinatura do Azure e na mesma região do Azure.
Define pelo menos dois parceiros comerciais que participam na operação RosettaNet utilizada no seu fluxo de trabalho. Ambas as definições de parceiros devem usar o mesmo qualificador de identidade empresarial , que é DUNS.
Importante
Certifica-te de que escolhes DUNS, que podes encontrar perto do final da lista de Qualificadores, e não 1 - D-U-N-S (Dun & Bradstreet).
Contém uma configuração de processo PIP que armazena todas as características da configuração PIP. Utiliza-se esta configuração quando cria um acordo entre parceiros. Se não tiver uma configuração de processo, adicione uma configuração PIP de processo.
Define um acordo RosettaNet entre os parceiros comerciais que participam na operação RosettaNet. Um acordo requer um parceiro anfitrião e um parceiro convidado. O conteúdo das mensagens entre parceiros deve corresponder ao tipo de acordo. Ver Criar um acordo RosettaNet.
Antes de começar a trabalhar com as operações da RosettaNet, deve ligar a sua aplicação Consumption Logic ou a sua aplicação Standard Logic à conta de integração.
Certificados opcionais para encriptar, desencriptar ou assinar as mensagens que carrega para a conta de integração. Os certificados são necessários somente se você usar assinatura ou criptografia.
Adicionar uma configuração de processo PIP
Se a sua conta de integração não tiver uma configuração de processo PIP, siga estes passos para adicionar uma configuração:
No portal Azure, vai ao recurso da tua conta de integração.
Na barra lateral de recursos, em Definições, selecione RosettaNet PIP. Na barra de ferramentas da página PIP do RosettaNet , selecione Adicionar.
No painel Adicionar Processo de Interface de Parceiros , introduza a seguinte informação PIP:
Parâmetro Necessário Descrição Nome Sim O nome PIP. Código PIP Sim O código PIP de três caracteres. Para obter mais informações, consulte PIPs RosettaNet. Versão PIP Sim A versão PIP, que depende do código PIP selecionado. Para mais informações, visite o site da RosettaNet.
O exemplo seguinte mostra informação de exemplo para uma configuração de processo PIP:
Quando terminar, selecione OK para criar a configuração PIP.
Para visualizar ou editar a configuração do processo, selecione o PIP. Na barra de ferramentas da página PIP do RosettaNet , selecione Editar como JSON.
Todas as definições de configuração do processo vêm das especificações do PIP. Por defeito, o Azure Logic Apps preenche a maioria das definições com valores predefinidos baseados nos valores mais usados.
Confirme que os valores das definições correspondem aos valores da especificação PIP apropriada e satisfazem as necessidades do seu negócio. Se necessário, atualize os valores no editor JSON e guarde as alterações.
Quando tiver terminado, selecione OK.
Crie um acordo RosettaNet
Se a sua conta de integração não tiver o acordo RosettaNet, siga estes passos para criar o acordo:
No portal Azure, vai ao recurso da tua conta de integração.
Na barra lateral de recursos, em Definições, selecione Acordos. Na barra de ferramentas da página de Acordos , selecione Adicionar.
No painel de Adicionar , introduza a seguinte informação do acordo:
Parâmetro Necessário Descrição Nome Sim O nome do contrato. Tipo de acordo Sim O tipo de protocolo para o acordo. Selecione RosettaNet. Parceiro anfitrião Sim O nome do parceiro anfitrião, que representa a sua organização. Um acordo requer um anfitrião e um parceiro convidado. Identidade do anfitrião Sim O identificador do parceiro anfitrião. Parceiro convidado Sim O nome do parceiro convidado, que faz negócios com o parceiro anfitrião. Um acordo requer um anfitrião e um parceiro convidado. Identidade do hóspede Sim O identificador de parceiro convidado. Configurações de recebimento Varia Propriedades que se aplicam a todas as mensagens recebidas pelo parceiro anfitrião do parceiro convidado. Configurações de envio Varia Propriedades que se aplicam a todas as mensagens enviadas pelo parceiro anfitrião ao parceiro convidado. Referências PIP RosettaNet Sim As referências PIP para o acordo. Todas as mensagens RosettaNet requerem configurações PIP. O exemplo seguinte mostra informações de exemplo para um acordo RosettaNet:
Para especificar como o parceiro anfitrião recebe mensagens do parceiro convidado, no painel de Adicionar , selecione Definições de Receção.
O painel de Definições de Receção mostra as seguintes definições:
Configuração Necessário Descrição A mensagem deve ser assinada Não Assine as mensagens recebidas com o certificado selecionado. Certificado Sim, se a assinatura estiver ativada O certificado a usar para assinar. Habilitar a criptografia de mensagens Não Encripte as mensagens recebidas com o certificado selecionado. Certificado Sim, se a encriptação estiver ativada O certificado a usar para encriptação. Para permitir assinatura, encriptação ou ambos para mensagens recebidas, em Mensagem, selecione Mensagem deve ser assinada, Mensagem deve ser encriptada, ou ambas.
Em cada configuração selecionada, na lista de Certificados , selecione o certificado da sua conta de integração para usar para assinar, encriptar ou ambos.
O exemplo seguinte mostra as definições de assinatura e encriptação no painel de Definições de Receção :
Quando tiver terminado, selecione OK.
Para especificar como o parceiro anfitrião envia mensagens ao parceiro convidado, no painel de Adicionar , selecione Enviar Definições.
O painel de Definições de Envio mostra as seguintes definições:
Configuração Necessário Descrição Ativar assinatura de mensagens Não Assine as mensagens de saída com o algoritmo de assinatura selecionado e o certificado. Algoritmo de assinatura Sim, se a assinatura estiver ativada O algoritmo de assinatura a utilizar, baseado no certificado selecionado. Certificado Sim, se a assinatura estiver ativada O certificado a usar para assinar. Habilitar a criptografia de mensagens Não Encripte as mensagens de saída com o algoritmo e certificado de encriptação selecionados. Algoritmo de encriptação Sim, se a encriptação estiver ativada O algoritmo de encriptação a utilizar, baseado no certificado selecionado. Certificado Sim, se a encriptação estiver ativada O certificado a usar para encriptação. Para ativar assinatura, encriptação ou ambos para mensagens de saída, em Mensagens, selecione Ativar assinatura de mensagens, Ativar encriptação de mensagens, ou ambos.
Em cada configuração selecionada, da lista de algoritmos, selecione o algoritmo a utilizar. Na lista de Certificados , selecione o certificado da sua conta de integração para usar na assinatura, encriptação, ou ambos.
Na secção Endpoints, especifique os URLs necessários para enviar mensagens de ação e confirmações:
Parâmetro Necessário Descrição URL da ação Sim A URL a ser usada para enviar mensagens de ação. Esta URL é necessária tanto para mensagens síncronas como assíncronas. URL de confirmação Sim O URL a ser usado para enviar mensagens de confirmação. Este URL é necessário para mensagens assíncronas. O exemplo seguinte mostra as definições de assinatura, encriptação e URL do endpoint no painel de Definições de Envio com alguns valores de exemplo:
Quando tiver terminado, selecione OK.
Para especificar as referências PIP RosettaNet para o acordo, no painel Adicionar , selecione referências PIP RosettaNet.
A página de referências PIP do RosettaNet mostra a configuração do processo PIP que criou e adicionou anteriormente.
Na coluna Nome PIP , abra a lista e selecione o PIP.
A sua seleção preenche as propriedades restantes, que são baseadas no PIP da sua conta de integração.
Se necessário, você pode alterar a função PIP.
Continue para a secção seguinte para receber mensagens do RosettaNet.
Receber e decodificar mensagens RosettaNet
No portal do Azure, abra seu recurso de aplicativo lógico. Abra seu fluxo de trabalho no designer.
O fluxo de trabalho já deve ter um gatilho e quaisquer outras ações que queiras executar antes de adicionares a ação RosettaNet.
Siga estes passos gerais para adicionar a ação de decodificação do RosettaNet ao seu fluxo de trabalho.
No painel de informações da ação, forneça os seguintes valores:
Parâmetro Necessário Descrição Mensagem Sim A mensagem do RosettaNet para decodificar. Cabeçalhos Sim Os cabeçalhos HTTP que fornecem os valores para a versão e o tipo de resposta como pares chave-valor. A versão é RNIF. O tipo de resposta descreve o tipo de comunicação do parceiro e pode ser síncrona ou assíncrona.Função Sim O papel de parceiro anfitrião no PIP. 
A saída da ação de descodificação do RosettaNet inclui um valor de sinal de saída . Pode codificar e devolver esta saída ao parceiro convidado, ou pode realizar uma ação diferente nessa saída.
Enviar e codificar mensagens RosettaNet
No portal do Azure, abra seu recurso de aplicativo lógico. Abra seu fluxo de trabalho no designer.
O fluxo de trabalho já deve ter um gatilho e quaisquer outras ações que queiras executar antes de adicionares a ação RosettaNet.
Siga estes passos gerais para adicionar a ação de codificação RosettaNet ao seu fluxo de trabalho.
No painel de informações da ação, forneça os seguintes valores:
Parâmetro Necessário Descrição Identidade da instância do processo RosettaNet (PIP) Sim O identificador da instância para codificar a mensagem. Parceiro anfitrião Sim O nome do parceiro anfitrião. Parceiro convidado Sim O nome do parceiro convidado. Código PIP Sim O código PIP. Versão PIP Sim A versão PIP. Identidade da instância PIP Sim O identificador único para esta mensagem PIP. Tipo de mensagem Sim O tipo para a mensagem codificar. Função Sim O papel de parceiro anfitrião. 
Esta ação está agora configurada para codificar e enviar a mensagem RosettaNet ao parceiro convidado.
Para enviar a mensagem codificada do RosettaNet, siga estes passos gerais para adicionar a ação apropriada para o seu cenário. Forneça os valores que a ação precisa para enviar a mensagem.
Este exemplo utiliza a ação HTTP , que é renomeada para HTTP - Enviar mensagem codificada ao parceiro. Os valores são saídas da ação de codificação RosettaNet e são adicionados através da lista dinâmica de conteúdo.
Com base nos padrões RosettaNet, as transações comerciais só são concluídas depois de todas as etapas definidas pelo PIP estarem concluídas. Depois de o parceiro anfitrião enviar a mensagem codificada ao parceiro convidado, este espera pelo sinal e pelo reconhecimento.
No seu fluxo de trabalho, adicione a ação RosettaNet que espera por uma resposta. No painel de informações da ação, forneça os seguintes valores:
Parâmetro Necessário Descrição Corpo Sim A mensagem original codificada. Identidade da instância PIP Sim O ID da instância para a mensagem codificada. Contagem de repetições Sim O número de tentativas para codificar e enviar a mensagem. Função Sim O papel de parceiro anfitrião. A duração de espera e a contagem de tentativas da ação RosettaNet baseiam-se na configuração do PIP.
Se a ação RosettaNet não receber resposta, a ação gera uma Notificação de Falha.
Para lidar com tentativas de repetição, coloque sempre as ações do RosettaNet para enviar a mensagem codificada e aguardar uma resposta dentro de um ciclo Until, por exemplo:
