Compartilhar via


Trocar mensagens do RosettaNet para integração B2B usando fluxos de trabalho nos Aplicativos Lógicos do Azure

Aplica-se a: Aplicativos Lógicos do Azure (Consumo)

Para enviar e receber mensagens do RosettaNet em fluxos de trabalho que você cria usando os Aplicativos Lógicos do Azure, você pode usar o conector do RosettaNet, que fornece ações que gerenciam e dão suporte à comunicação que segue os padrões RosettaNet. RosettaNet é um consórcio sem fins lucrativos que estabeleceu processos padrão para o compartilhamento de informações de negócios. 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 consórcio RosettaNet cria e mantém os PIPs (processos de interface de parceiro), que fornecem definições do processo empresarial comuns para todas as trocas de mensagens do RosettaNet. 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. Para obter mais informações, visite o site do RosettaNet.

O conector é baseado no RNIF (RosettaNet Implementation Framework) versão 2.0.01 e dá suporte a todos os PIPs definidos por essa versão. O RNIF é uma estrutura de aplicativo de rede aberta que permite que os parceiros de negócios executem PIPs RosettaNet de forma colaborativa. Essa estrutura define a estrutura da mensagem, a necessidade de confirmações, a codificação MIME e a assinatura digital. A comunicação com o parceiro pode ser síncrona ou assíncrona. O conector fornece as seguintes capacidades:

  • Receber ou decodificar mensagens do RosettaNet.
  • Enviar ou codificar mensagens do RosettaNet.
  • Aguardar a resposta e a geração de notificação de falha.

Este guia de instruções mostra como enviar e receber mensagens do RosettaNet em fluxos de trabalho usando os Aplicativos Lógicos do Azure e o conector do RosettaNet concluindo as seguintes tarefas:

  • Adicione uma configuração de processo PIP, se ainda não tiver uma.
  • Criar um contrato do RosettaNet.
  • Adicione uma ação que receba ou decodifique mensagens do RosettaNet.
  • Adicione uma ação que envie ou codifique mensagens do RosettaNet.

Conceitos do RosettaNet

Os seguintes conceitos e termos são exclusivos da especificação do RosettaNet e é importante conhecê-los quando você cria fluxos de trabalho de integração baseados no RosettaNet:

  • PIP

    A organização do RosettaNet cria e mantém os PIPs que fornecem definições do processo empresarial comuns para todas as trocas de mensagens do RosettaNet. 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 orientações para mensagens, que é um arquivo HTML legível por humanos que especifica restrições no nível do elemento. Juntos, esses arquivos fornecem uma definição completa do processo de negócios.

    Os PIPs são categorizados por uma função comercial 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 e Entrada de Pedido. Para obter mais informações, visite o site do RosettaNet.

  • Ação

    Parte de um PIP, as mensagens de ação são mensagens comerciais trocadas entre parceiros.

  • Sinal

    Parte de um PIP, as mensagens de sinal são confirmações enviadas em resposta a mensagens de ação.

  • Ação única e ação dupla

    Para um PIP de ação única, 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, além do fluxo de mensagem de ação única.

Referência técnica do conector

O conector do RosettaNet está disponível apenas para fluxos de trabalho do aplicativo lógico de Consumo.

Aplicativo lógico Ambiente Versão do conector
Consumo Aplicativos Lógicos Multilocatários do Azure Conector gerenciado, que aparece no designer sob o rótulo Standard. O conector do RosettaNet fornece apenas ações, mas você pode usar qualquer gatilho que funcione para seu cenário. Para saber mais, consulte a seguinte documentação:

- Operações do conector do RosettaNet
- Limites de protocolo B2B para tamanhos de mensagem
- Conectores gerenciados em Aplicativos Lógicos do Azure

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:

Ação Descrição
Ação Decodificar RosettaNet Envie mensagens do RosettaNet usando codificação que segue os padrões RosettaNet.
Ação Decodificação do RosettaNet Receba mensagens do RosettaNet usando decodificação que segue os padrões RosettaNet.
Ação RosettaNet aguarda resposta Faça com que o host aguarde uma resposta do RosettaNet ou mensagem de sinal do receptor.

Pré-requisitos

  • Uma conta e uma assinatura do Azure. Caso não tenha uma assinatura, crie uma conta gratuita.

  • O recurso de aplicativo lógico e o fluxo de trabalho de Consumo em que você deseja usar as operações do RosettaNet.

  • Uma conta de integração para armazenar seu contrato e outros artefatos B2B (business-to-business).

    Importante

    Para trabalhar em conjunto, a conta de integração e o recurso de aplicativo lógico devem existir na mesma assinatura e região do Azure. Para usar artefatos de conta de integração em seu fluxo de trabalho, vincule o recurso de aplicativo lógico à sua conta de integração.

  • Pelo menos dois parceiros definidos em sua conta de integração e use o qualificador DUNS em Identidades de Negócios no portal do Microsoft Azure.

    Observação

    Certifique-se de selecionar DUNS como qualificador, que pode ser encontrado na parte inferior da lista Qualificador, e não 1 - D-U-N-S (Dun & Bradstreet).

  • 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 configuração do processo PIP

Para enviar ou receber mensagens do RosettaNet, sua conta de integração requer uma configuração de processo PIP, caso ainda não tenha uma. A configuração do processo armazena todas as características de configuração do PIP. Você poderá fazer referência a essa configuração ao criar um contrato com um parceiro.

  1. No portal do Azure, vá para sua conta de integração.

  2. No menu de navegação da conta de integração, em Configurações, selecione PIP do RosettaNet.

    Captura de tela do portal do Azure e da página da conta de integração. No menu de navegação, PIP do RosettaNet está selecionado.

  3. Na página PIP do RosettaNet, selecione Adicionar. No painel Adicionar Processo de Interface do Parceiro, insira os detalhes do PIP.

    Captura de tela da página PIP do RosettaNet, com Adicionar selecionado. O painel Adicionar Processo de Interface de Parceiro contém caixas para o nome, o código e a versão.

    Propriedade Obrigatório Descrição
    Nome Sim Nome do PIP.
    Código do PIP Sim Código de três dígitos do PIP. Para obter mais informações, confira PIPs do RosettaNet.
    Versão do PIP Sim Número de versão do PIP, que depende do código do PIP selecionado.

    Para obter mais informações sobre essas propriedades do PIP, visite o site do RosettaNet.

  4. Quando terminar, selecione OK para criar a configuração do PIP.

  5. Para exibir ou editar a configuração do processo, selecione o PIP e selecione Editar como JSON.

    Todas as definições de configuração do processo são provenientes das especificações do PIP. Os Aplicativos Lógicos do Azure preenchem a maior parte das configurações com os valores padrão, que são os valores mais usados para essas propriedades.

    Captura de tela da página RosettaNet PIP, com Editar como JSON e um PIP selecionado. Em Editar como JSON, as propriedades PIP codificadas ficam visíveis.

  6. Confirme se as configurações correspondem aos valores na especificação do PIP adequada e se atendem às suas necessidades comerciais. Se necessário, atualize os valores no JSON e salve as alterações.

Criar contrato do RosettaNet

  1. No portal do Azure, vá para sua conta de integração.

  2. No menu de navegação da conta de integração, em Configurações, selecione Contratos.

    A captura de tela mostra o portal do Azure com a página da conta de integração aberta. No menu de navegação, a opção Contratos está selecionada.

  3. Na página Contratos, selecione Adicionar. Em Adicionar, insira os detalhes do contrato.

    A captura de tela mostra a página Contratos com a opção Adicionar selecionada. No painel denominado Adicionar, as caixas aparecem para o nome e o tipo do contrato e para obter informações do parceiro.

    Propriedade Obrigatório Descrição
    Nome Sim Nome do contrato.
    Tipo de contrato Sim Tipo do contrato. Selecione RosettaNet.
    Parceiro de Host Sim Organização que configura o contrato. Um contrato precisa dos parceiros host e convidado.
    Identidade do Host Sim Um identificador para o parceiro host.
    Parceiro Convidado Sim Organização que está fazendo negócios com o parceiro host. Um contrato precisa dos parceiros host e convidado.
    Identidade do Convidado Sim Um identificador para o parceiro convidado.
    Configurações de Recebimento Varia Propriedades que se aplicam a todas as mensagens recebidas pelo parceiro de host.
    Configurações de Envio Varia Propriedades que se aplicam a todas as mensagens enviadas pelo parceiro de host.
    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.
  4. Para configurar seu contrato para receber mensagens de entrada do parceiro convidado, selecione Configurações de Recebimento.

    1. Para habilitar a assinatura ou criptografia em mensagens de entrada, em Mensagem, selecione A mensagem deve ser assinada ou A mensagem deve ser criptografada, respectivamente.

      Propriedade Obrigatório Descrição
      Mensagem deve ser assinada Não Opção para assinar 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 Opção para criptografar mensagens de entrada com o certificado selecionado
      Certificado Sim, a criptografia está habilitada O certificado a ser usado para criptografia
    2. Em cada seleção, escolha o certificado, na sua conta de integração, que você deseja para usar na assinatura ou criptografia.

    Captura de tela da página Configurações de Recebimento, com opções para assinar e criptografar mensagens e inserir certificados.

  5. Para configurar seu contrato para enviar mensagens ao parceiro convidado, selecione Configurações de Envio.

    1. Para habilitar a assinatura ou criptografia em mensagens de saída, em Mensagens, selecione Habilitar assinatura de mensagem ou Habilitar criptografia de mensagem, respectivamente. Em cada seleção, escolha o algoritmo e o certificado, na sua conta de integração, que você deseja para usar na assinatura ou criptografia.

      Propriedade Obrigatório Descrição
      Habilitar a assinatura de mensagens Não Opção para assinar 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 Opção para 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
    2. Em Pontos de extremidade, especifique as URLs necessárias a serem usadas para enviar mensagens de ação e confirmações.

      Propriedade Obrigatório Descrição
      URL de Ação Sim A URL a ser usada para enviar mensagens de ação. A URL é um campo obrigatório para mensagens síncronas e assíncronas.
      URL de Confirmação Sim A URL a ser usada para enviar mensagens de confirmação. A URL é um campo obrigatório para mensagens assíncronas.

    A captura de tela mostra a página Enviar Configurações, com opções para assinatura e criptografia de mensagens e para inserir algoritmos, certificados e pontos de extremidade.

  6. Para configurar seu contrato com as referências do PIP do RosettaNet para parceiros, selecione Referências do PIP do RosettaNet. Em Nome do PIP, selecione o nome do PIP que você criou anteriormente.

    Captura de tela que mostra uma tabela de informações de PIP que tem uma linha. Essa linha contém valores padrão, exceto o nome MyPIPConfig, que está selecionado.

    Sua seleção preenche as propriedades restantes, que se baseiam no PIP que você configurou na conta de integração. Se necessário, você poderá alterar a Função do PIP.

    A captura de tela mostra uma tabela com informações do PIP. A linha do PIP chamado MyPIPConfig mostra informações precisas.

Depois de concluir essas etapas, você estará pronto para enviar ou receber mensagens do RosettaNet.

Receber ou decodificar mensagens do RosettaNet

  1. No portal do Azure, abra o fluxo de trabalho do aplicativo lógico de Consumo no designer.

    Seu fluxo de trabalho já deve ter um gatilho e outras ações que você deseja executar antes de adicionar a ação do RosettaNet. Este exemplo continua com o Gatilho de solicitação.

  2. No gatilho ou ação, selecione Nova etapa.

    Captura de tela do designer. Em Gatilho de solicitação, Nova etapa é selecionada.

  3. Na caixa de pesquisa Escolha uma operação, selecione Tudo. Na caixa de pesquisa, digite rosettanet. Na lista de ações, selecione a ação chamada Decodificação do RosettaNet.

    Captura de tela do designer. A caixa de pesquisa Escolher uma operação contém rosettanet e a ação Decodificação do RosettaNet está selecionada.

  4. Insira as informações para as propriedades da ação:

    Captura de tela da ação Decodificação do RosettaNet em que as caixas estão disponíveis para a mensagem, os cabeçalhos e a função.

    Propriedade Obrigatório Descrição
    Message Sim A mensagem do RosettaNet a ser decodificada
    Cabeçalhos Sim Os cabeçalhos HTTP que fornecem os valores para a versão, que é a versão RNIF, e o tipo de resposta, que indica o tipo de comunicação entre os parceiros e pode ser síncrono ou assíncrono
    Função Sim A função do parceiro de host no PIP

    A saída da ação Decodificação do RosettaNet inclui o sinal de saída. Você pode codificar essa saída e devolvê-la ao parceiro ou executar qualquer outra ação nessa saída.

Enviar ou codificar mensagens do RosettaNet

  1. No portal do Azure, abra o fluxo de trabalho do aplicativo lógico de Consumo no designer.

    Seu fluxo de trabalho já deve ter um gatilho e outras ações que você deseja executar antes de adicionar a ação do RosettaNet. Este exemplo continua com o Gatilho de solicitação.

  2. No gatilho ou ação, selecione Nova etapa.

    Captura de tela do designer. Em Gatilho de solicitação, Nova etapa é selecionada.

  3. Na caixa de pesquisa Escolha uma operação, selecione Tudo. Na caixa de pesquisa, digite rosettanet. Na lista de ações, selecione a ação chamada Codificação do RosettaNet.

    Captura de tela do designer. A caixa de pesquisa Escolher uma operação contém rosettanet e a ação Codificação do RosettaNet está selecionada.

  4. Insira as informações para as propriedades da ação:

    Captura de tela da ação Codificação do RosettaNet em que as caixas aparecem para a mensagem, os parceiros, as informações de PIP, o tipo de mensagem e a função.

    Propriedade Obrigatório Descrição
    Message Sim A mensagem do RosettaNet a ser codificada
    Parceiro de host Sim O nome do parceiro de host
    Parceiro convidado Sim O nome do parceiro convidado
    Código do PIP Sim O código do PIP
    Versão do PIP Sim A versão do PIP
    Identidade da instância do PIP Sim O identificador exclusivo para esta mensagem do PIP
    Tipo de mensagem Sim O tipo da mensagem a ser codificada
    Função Sim A função do parceiro de host

    A mensagem codificada agora está pronta para ser enviada ao parceiro.

  5. Para enviar a mensagem codificada, o seguinte exemplo usa a ação HTTP, que é renomeada como HTTP – Enviar mensagem codificada para o parceiro.

    Captura de tela do designer com uma ação HTTP renomeada como HTTP – Enviar mensagem codificada para o parceiro e os valores de URI, cabeçalho e corpo são inseridos.

    Segundo os padrões RosettaNet, as transações comerciais são consideradas completas somente quando todas as etapas definidas pelo PIP são concluídas.

  6. Depois que o host envia a mensagem codificada para um parceiro, o host aguarda o sinal e a confirmação. Para realizar essa tarefa, adicione a ação chamada RosettaNet aguarda resposta.

    Captura de tela de uma ação de espera do RosettaNet para resposta em que as caixas estão disponíveis para o corpo, a identidade da instância do PIP, a contagem de repetições e a função.

    A duração a ser usada para aguardar e o número de novas tentativas baseiam-se na configuração do PIP em sua conta de integração. Se a resposta não for recebida, uma notificação de falha será gerada. Para lidar com novas tentativas, sempre coloque as ações Codificar e Aguardar resposta em um loop Até.

    Captura de tela do designer. Um loop Until contém ações para codificação e envio de mensagens e para aguardar respostas.

Modelos do RosettaNet

Para acelerar o desenvolvimento e recomendar padrões de integração, você poderá usar modelos de aplicativo lógico de Consumo para decodificar e codificar mensagens do RosettaNet. Ao criar um fluxo de trabalho do aplicativo lógico de Consumo, você pode selecionar na galeria de modelos no designer. Você também pode encontrar esses modelos no repositório GitHub para Aplicativos Lógicos do Azure.

Captura de tela do designer. A categoria Enterprise Integration e os modelos para decodificar e codificar mensagens do RosettaNet são selecionados.

Próximas etapas