Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
Aplica-se a: Aplicativos Lógicos do Azure (Consumo + Standard)
Para enviar e receber mensagens RosettaNet em fluxos de trabalho criados usando os Aplicativos Lógicos do Azure, use o conector RosettaNet . Esse conector fornece ações que dão suporte e gerenciam a comunicação que segue os padrões RosettaNet. Esses padrões são geralmente usados para processos da cadeia de suprimentos e estão difundidos nos setores de semicondutores, eletrônicos e logística. O 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 fornece os seguintes recursos:
- Receber e decodificar mensagens RosettaNet.
- Enviar e codificar mensagens RosettaNet.
- Aguardar a resposta e a geração de notificação de falha.
Este guia fornece uma breve visão geral sobre RosettaNet e mostra como adicionar as ações de codificação e decodificação para RosettaNet a um fluxo de trabalho de aplicativo lógico existente. O conector RosettaNet não fornece gatilhos, portanto, você pode usar qualquer gatilho para iniciar o fluxo de trabalho. Os exemplos neste guia usam o Gatilho de solicitação.
Entender os conceitos do RosettaNet
RosettaNet é uma organização que estabeleceu processos padrão para compartilhar informações de negócios. Essa organização cria e mantém PIPs (Processos de Interface de Parceiro), que fornecem definições comuns de processo de negócios para todas as trocas de mensagens RosettaNet. Para obter mais informações, visite o site da RosettaNet.
O conector RosettaNet é baseado no RosettaNet Implementation Framework (RNIF) versão 2.0.01 e dá suporte a todos os PIPs definidos por esta versão. O RNIF é uma estrutura de aplicativo de rede aberta que facilita que parceiros de negócios executem colaborativamente os PIPs RosettaNet. Essa estrutura define a estrutura da mensagem, a necessidade de confirmações, a codificação MIME e a assinatura digital. A comunicação entre parceiros pode ser síncrona ou assíncrona.
A tabela a seguir descreve os conceitos e os termos do RosettaNet:
| Conceito | Descrição |
|---|---|
| PIP | Um PIP fornece definições comuns de processo de negócios para todas as trocas de mensagens RosettaNet. Os PIPs são categorizados por uma função de negócios de alto nível, ou cluster, e uma subfunção ou segmento. Por exemplo, "3A4" é o PIP de Ordem de Compra, enquanto "3" é a função Gerenciamento de Pedidos, e "3A" é a subfunção Cotação & Entrada de Pedido. Cada especificação PIP fornece um arquivo de DTD (definição de tipo de documento) e um documento de orientações para mensagens. O arquivo de DTD define a estrutura das mensagens de conteúdo do serviço. O documento de diretriz de mensagem é um arquivo HTML legível por humanos que especifica restrições no nível do elemento. Juntos, os arquivos PIP e DTD fornecem uma definição completa do processo de negócios. Para obter mais informações, visite o site da RosettaNet. |
| Action | 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 ação dupla, o iniciador recebe uma mensagem de resposta e responde com uma confirmação, junto com o fluxo de mensagem de ação única. |
Referência técnica do conector
O conector RosettaNet tem versões diferentes, com base no tipo de aplicativo lógico e no ambiente do host.
| Aplicativo lógico | Ambiente | Versão do conector |
|---|---|---|
| Consumo | Aplicativos Lógicos do Azure multilocatários | Conector gerenciado RosettaNet, que aparece na galeria de conectores em Compartilhado. O conector RosettaNet fornece apenas ações. Você pode usar qualquer gatilho que funcione para seu cenário. Para obter mais informações, consulte: - Operações rosettanet - Limites de protocolo B2B para tamanhos de mensagem |
| Standard | Aplicativos Lógicos do Azure de locatário único, Ambiente do Serviço de Aplicativo v3 (somente planos do Windows) e implantação híbrida | Conector interno RosettaNet, que aparece na galeria de conectores em Interno. O conector RosettaNet fornece apenas ações. Você pode usar qualquer gatilho que funcione para seu cenário. O conector incorporado pode acessar diretamente as redes virtuais do Azure. Você não precisa de um gateway de dados local. Para obter mais informações, consulte: - Operações rosettanet - Limites de protocolo B2B para tamanhos de mensagem |
Operações do RosettaNet
O conector do RosettaNet não tem gatilhos. A seguinte tabela descreve as ações fornecidas pelo conector do RosettaNet para estabelecer a segurança e a confiabilidade ao transmitir mensagens:
Pré-requisitos
Uma conta e uma assinatura do Azure. Obtenha uma conta gratuita do Azure.
O recurso de aplicativo lógico e o fluxo de trabalho em que você deseja usar as operações RosettaNet.
O fluxo de trabalho requer qualquer gatilho que funcione melhor para seu cenário e qualquer outra ação que você deseja executar antes de adicionar uma ação RosettaNet.
Para obter mais informações, consulte:
Um recurso de conta de integração para definir e armazenar artefatos para uso na Enterprise Integration e nos fluxos de trabalho B2B.
Sua conta de integração e o recurso de aplicativo lógico devem existir na mesma assinatura do Azure e na região do Azure.
Define pelo menos dois parceiros comerciais que participam da operação RosettaNet usada em seu fluxo de trabalho. Ambas as definições de parceiro devem usar o mesmo qualificador de identidade comercial , que é DUNS.
Importante
Certifique-se de selecionar DUNS, que você pode encontrar perto da parte inferior 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 de configuração do PIP. Você usa essa configuração ao criar um contrato entre parceiros. Se você não tiver uma configuração de processo, adicione uma configuração de processo PIP.
Define um acordo RosettaNet entre os parceiros comerciais que participam da operação RosettaNet. Um contrato requer um parceiro host e um parceiro convidado. O conteúdo nas mensagens entre parceiros deve corresponder ao tipo de contrato. Consulte Criar um contrato RosettaNet.
Antes de começar a trabalhar com operações RosettaNet, você deve vincular seu aplicativo lógico de Consumo ou Padrão à conta de integração.
Certificados opcionais para criptografar, descriptografar ou assinar as mensagens que você carrega na conta de integração. Os certificados serão necessários somente se você usar assinatura ou criptografia.
Adicionar uma configuração de processo PIP
Se sua conta de integração não tiver uma configuração de processo PIP, siga estas etapas para adicionar uma configuração:
No portal do Azure, acesse o recurso de conta de integração.
Na barra lateral do recurso, em Configurações, selecione RosettaNet PIP. Na barra de ferramentas da página PIP do RosettaNet , selecione Adicionar.
No painel Adicionar Processo de Interface do Parceiro , insira as seguintes informações de PIP:
Parâmetro Obrigató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, confira PIPs do RosettaNet. Versão do PIP Sim A versão PIP, que depende do código PIP selecionado. Para obter mais informações, visite o site da RosettaNet.
O exemplo a seguir mostra informações de exemplo para uma configuração de processo PIP:
Quando terminar, selecione OK para criar a configuração do PIP.
Para exibir ou editar a configuração do processo, selecione o PIP. Na barra de ferramentas da página RosettaNet PIP, selecione Editar como JSON.
A captura de tela mostra a página PIP da RosettaNet com um PIP selecionado e a opção Editar como JSON ativa. O editor JSON mostra as configurações do PIP codificadas.
Todas as definições de configuração do processo são provenientes das especificações do PIP. Por padrão, os Aplicativos Lógicos do Azure preenchem a maioria das configurações com valores padrão com base nos valores mais usados normalmente.
Confirme se os valores de configurações correspondem aos valores na especificação pip apropriada e atendem às suas necessidades comerciais. Se necessário, atualize os valores no editor JSON e salve as alterações.
Quando terminar, selecione OK.
Criar um contrato RosettaNet
Se sua conta de integração não tiver o contrato RosettaNet, siga estas etapas para criar o contrato:
No portal do Azure, acesse o recurso de conta de integração.
Na barra lateral do recurso, em Configurações, selecione Contratos. Na barra de ferramentas da página Contratos , selecione Adicionar.
No painel Adicionar , insira as seguintes informações de contrato:
Parâmetro Obrigatório Descrição Nome Sim O nome do contrato. Tipo de contrato Sim O tipo de protocolo do contrato. Selecione RosettaNet. Parceiro de host Sim O nome do parceiro host, que representa sua organização. Um contrato precisa dos parceiros host e convidado. Identidade do host Sim O identificador do parceiro de host. Parceiro convidado Sim O nome do parceiro convidado, que faz negócios com o parceiro host. Um contrato precisa dos parceiros host e convidado. Identidade do convidado Sim O identificador do parceiro convidado. Configurações de recebimento Varia Propriedades que se aplicam a todas as mensagens recebidas pelo parceiro host do parceiro convidado. Configurações de envio Varia Propriedades que se aplicam a todas as mensagens enviadas pelo parceiro host ao parceiro convidado. Referências do PIP do RosettaNet Sim As referências do PIP para o contrato. Todas as mensagens do RosettaNet exigem configurações de PIP. O exemplo a seguir mostra informações de exemplo para um contrato RosettaNet:
Para especificar como o parceiro host recebe mensagens do parceiro convidado, no painel Adicionar , selecione Configurações de Recebimento.
O painel Configurações de Recebimento mostra as seguintes configurações:
Configurações Obrigatório Descrição Mensagem deve ser assinada Não Assine as mensagens de entrada com o certificado selecionado. Certificado Sim, se a assinatura estiver habilitada O certificado a ser usado para assinatura. Habilitar a criptografia de mensagem Não Criptografar mensagens de entrada com o certificado selecionado. Certificado Sim, a criptografia está habilitada O certificado a ser usado para criptografia. Para habilitar a assinatura, a criptografia ou ambos para mensagens de entrada, em Mensagem, selecione Mensagem deve ser assinada, a mensagem deve ser criptografada ou ambas.
Em cada configuração selecionada, na lista Certificado , selecione o certificado da sua conta de integração a ser usado para assinatura, criptografia ou ambos.
O exemplo a seguir mostra as configurações de assinatura e criptografia no painel Configurações de Recebimento :
Quando terminar, selecione OK.
Para especificar como o parceiro host envia mensagens para o parceiro convidado, no painel Adicionar , selecione Enviar Configurações.
O painel Enviar Configurações mostra as seguintes configurações:
Configurações Obrigatório Descrição Habilitar a assinatura de mensagens Não Assine mensagens de saída com o algoritmo de assinatura e o certificado selecionados. Algoritmo de assinatura Sim, se a assinatura estiver habilitada O algoritmo de assinatura a ser usado, com base no certificado selecionado. Certificado Sim, se a assinatura estiver habilitada O certificado a ser usado para assinatura. Habilitar a criptografia de mensagem Não Criptografar mensagens de saída com o algoritmo de criptografia e o certificado selecionados. Algoritmo de criptografia Sim, a criptografia está habilitada O algoritmo de criptografia a ser usado, com base no certificado selecionado. Certificado Sim, a criptografia está habilitada O certificado a ser usado para criptografia. Para habilitar a assinatura, a criptografia ou ambos para mensagens de saída, em Mensagens, selecione Habilitar assinatura de mensagem, Habilitar criptografia de mensagem ou ambos.
Em cada configuração selecionada, na lista de algoritmos, selecione o algoritmo a ser usado. Na lista Certificado , selecione o certificado da sua conta de integração a ser usado para assinatura, criptografia ou ambos.
Na seção Endpoints, especifique as URLs necessárias para enviar mensagens de ação e confirmações:
Parâmetro Obrigatório Descrição URL da ação Sim A URL a ser usada para enviar mensagens de ação. Essa URL é necessária para mensagens síncronas e assíncronas. URL da confirmação Sim A URL a ser usada para enviar mensagens de confirmação. Essa URL é necessária para mensagens assíncronas. O exemplo a seguir mostra as configurações de URL de assinatura, criptografia e ponto de extremidade no painel Configurações de Envio com alguns valores de exemplo:
Quando terminar, selecione OK.
Para especificar as referências de PIP RosettaNet para o contrato, selecione referências de PIP RosettaNet no painel Adicionar.
A página Referências PIP de RosettaNet mostra a configuração do processo PIP que você criou e adicionou anteriormente.
Na coluna Nome PIP, abra a lista e selecione o PIP.
Sua seleção preenche as propriedades restantes, que se baseiam no PIP na conta de integração.
Se necessário, você poderá alterar a Função do PIP.
Continue para a próxima seção para receber mensagens RosettaNet.
Receber e decodificar mensagens RosettaNet
Abra o recurso de aplicativo lógico no portal do Azure. Abra o fluxo de trabalho no designer.
O fluxo de trabalho já deve ter um gatilho e outras ações que você deseja executar antes de adicionar a ação RosettaNet.
Siga estas etapas gerais para adicionar a ação de decodificação RosettaNet ao fluxo de trabalho.
No painel de informações de ação, forneça os seguintes valores:
Parâmetro Obrigatório Descrição Mensagem Sim A mensagem RosettaNet a ser decodificada. Cabeçalhos Sim Os cabeçalhos HTTP que fornecem, como pares chave-valor, os valores para a versão e o tipo de resposta. A versão é RNIF. O tipo de resposta descreve o tipo de comunicação do parceiro e pode ser síncrono ou assíncrono.Função Sim A função de parceiro host no PIP. 
A saída da ação de decodificação do RosettaNet inclui um valor de Sinal de saída. Você pode codificar e retornar essa saída para o parceiro convidado ou pode executar uma ação diferente nessa saída.
Enviar e codificar mensagens RosettaNet
Abra o recurso de aplicativo lógico no portal do Azure. Abra o fluxo de trabalho no designer.
O fluxo de trabalho já deve ter um gatilho e outras ações que você deseja executar antes de adicionar a ação RosettaNet.
Siga estas etapas gerais para adicionar a ação de codificação RosettaNet ao fluxo de trabalho.
No painel de informações de ação, forneça os seguintes valores:
Parâmetro Obrigatório Descrição Identidade da instância do processo RosettaNet (PIP) Sim A ID da instância da mensagem a ser codificada. Parceiro de host Sim O nome do parceiro hospedeiro. Parceiro convidado Sim O nome do parceiro convidado. Código PIP Sim O código PIP. Versão do PIP Sim A versão PIP. Identidade da instância do PIP Sim O identificador exclusivo dessa mensagem PIP. Tipo de mensagem Sim O tipo para a mensagem a ser codificada. Função Sim A função de parceiro do anfitrião. 
Esta ação agora está configurada para codificar e enviar a mensagem RosettaNet para o parceiro convidado.
Para enviar a mensagem RosettaNet codificada, siga estas etapas gerais para adicionar a ação apropriada ao seu cenário. Forneça os valores de que a ação precisa para enviar a mensagem.
Este exemplo usa a ação HTTP , que é renomeada como HTTP – Enviar mensagem codificada para o parceiro. Os valores são saídas da ação de codificação RosettaNet e são adicionados por meio da lista de conteúdo dinâmico.
Com base nos padrões RosettaNet, as transações comerciais são concluídas somente depois que todas as etapas definidas pelo PIP forem concluídas. Depois que o parceiro host envia a mensagem codificada para o parceiro convidado, o host aguarda o sinal e a confirmação.
Em seu fluxo de trabalho, adicione a ação RosettaNet que aguarda uma resposta. No painel de informações de ação, forneça os seguintes valores:
Parâmetro Obrigatório Descrição Corpo Sim A mensagem codificada original. Identidade da instância do PIP Sim A ID da instância da mensagem codificada. Contagem de repetições Sim O número de tentativas para codificar e enviar a mensagem. Função Sim A função de parceiro do anfitrião. A duração da espera e a contagem de repetição da ação RosettaNet são baseadas na configuração do PIP.
Se a ação RosettaNet não receber uma resposta, a ação gerará uma Notificação de Falha.
Para lidar com tentativas de repetição, sempre coloque as ações rosettanet para enviar a mensagem codificada e aguarde uma resposta dentro de um loop Until , por exemplo:
