Partilhar via


Mensagens RosettaNet do Exchange para integração B2B usando fluxos de trabalho em Aplicativos Lógicos do Azure

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

Para enviar e receber mensagens RosettaNet em fluxos de trabalho criados usando os Aplicativos Lógicos do Azure, você pode usar o conector 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 compartilhar informações comerciais. 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. O consórcio RosettaNet cria e mantém Processos de Interface de Parceiros (PIPs), que fornecem definições comuns de processos de negócios para todas as trocas de mensagens RosettaNet. 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 da RosettaNet.

O conector é baseado no RosettaNet Implementation Framework (RNIF) versão 2.0.01 e suporta todos os PIPs definidos por esta versão. O RNIF é uma estrutura de aplicação de rede aberta que permite aos parceiros de negócios executar colaborativamente os 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 com o parceiro pode ser síncrona ou assíncrona. O conector fornece os seguintes recursos:

  • Receba ou decodifice mensagens RosettaNet.
  • Envie ou codifique mensagens RosettaNet.
  • Aguarde a resposta e geração de Notificação de Falha.

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

  • Adicione uma configuração de processo PIP, se ainda não tiver uma.
  • Crie um contrato RosettaNet.
  • Adicione uma ação que receba ou decodifice mensagens RosettaNet.
  • Adicione uma ação que envie ou codifice mensagens RosettaNet.

Conceitos RosettaNet

Os seguintes conceitos e termos são exclusivos da especificação RosettaNet e são importantes saber quando você cria fluxos de trabalho de integração baseados em RosettaNet:

  • PIP

    A organização RosettaNet cria e mantém PIPs, que fornecem definições comuns de processos de negócios para todas as trocas de mensagens RosettaNet. 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 diretriz de mensagem, que é um arquivo HTML legível por humanos, 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 de negócios 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. Para obter mais informações, visite o site da RosettaNet.

  • Ação

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

  • Sinal

    Parte de um PIP, as mensagens de sinal são confirmações que são 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 mensagens de ação única.

Referência técnica do conector

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

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

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

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:

Ação Descrição
Ação de codificação RosettaNet Envie mensagens RosettaNet usando codificação que segue os padrões RosettaNet.
Ação RosettaNet Decode Receba mensagens RosettaNet usando decodificação que segue os padrões RosettaNet.
RosettaNet aguarda ação de resposta Peça ao anfitrião que aguarde uma resposta RosettaNet ou mensagem de sinal do recetor.

Pré-requisitos

  • Uma conta e subscrição do Azure. Se você não tiver uma assinatura, crie uma conta gratuita.

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

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

    Importante

    Para trabalhar em conjunto, 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. Para usar artefatos de conta de integração em seu fluxo de trabalho, certifique-se de vincular seu recurso de aplicativo lógico à sua conta de integração.

  • Pelo menos dois parceiros definidos em sua conta de integração e usam o qualificador DUNS em Identidades Corporativas no portal do Azure.

    Nota

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

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

Para enviar ou receber mensagens RosettaNet, sua conta de integração requer uma configuração de processo PIP, se você ainda não tiver uma. A configuração do processo armazena todas as características de configuração PIP. Em seguida, você pode 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 RosettaNet PIP.

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

  3. Na página PIP RosettaNet, selecione Adicionar. No painel Adicionar Processo de Interface de 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, código e versão.

    Property Necessário Description
    Nome Sim O seu nome PIP.
    Código PIP Sim O código PIP de três dígitos. Para obter mais informações, consulte PIPs RosettaNet.
    Versão PIP Sim O número da versão PIP, que depende do código PIP selecionado.

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

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

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

    Todas as definições de configuração do processo vêm das especificações do PIP. Os Aplicativos Lógicos do Azure preenchem a maioria das configurações com os valores padrão que são os valores mais usados normalmente para essas propriedades.

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

  6. Confirme se as configurações correspondem aos valores na especificação PIP apropriada e atendem às suas necessidades de negócios. Se necessário, atualize os valores em JSON e salve essas alterações.

Criar contrato 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 chamado Adicionar, aparecem caixas para o nome e o tipo do contrato e para as informações do parceiro.

    Property Necessário Description
    Nome Sim O nome do contrato.
    Tipo de acordo Sim O tipo de acordo. Selecione RosettaNet.
    Parceiro anfitrião Sim A organização que configura o contrato. Um acordo requer um anfitrião e um parceiro convidado.
    Identidade do anfitrião Sim Um identificador para o parceiro anfitrião.
    Parceiro convidado Sim A organização que está fazendo negócios com o parceiro anfitrião. Um acordo requer um anfitrião e um parceiro convidado.
    Identidade do hóspede Sim Um identificador para o parceiro convidado.
    Configurações de recebimento Varia Propriedades que se aplicam a todas as mensagens recebidas pelo parceiro anfitrião.
    Configurações de envio Varia Propriedades que se aplicam a todas as mensagens enviadas pelo parceiro anfitrião.
    Referências PIP RosettaNet Sim As referências PIP para o acordo. Todas as mensagens RosettaNet requerem configurações PIP.
  4. Para configurar seu contrato para receber mensagens recebidas do parceiro convidado, selecione Configurações de recebimento.

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

      Property Necessário Description
      A mensagem deve ser assinada Não A opção para assinar mensagens de entrada com o certificado selecionado
      Certificado Sim, se a assinatura estiver ativada O certificado a ser usado para assinatura
      Habilitar a criptografia de mensagens Não A opção para criptografar mensagens de entrada com o certificado selecionado
      Certificado Sim, se a encriptação estiver ativada O certificado a ser usado para criptografia
    2. Em cada seleção, selecione o certificado em sua conta de integração que você deseja usar para assinatura ou criptografia.

    Captura de ecrã da página Definições de Receção, com opções para assinar e encriptar mensagens e introduzir certificados.

  5. Para configurar seu contrato de envio de mensagens para o parceiro convidado, selecione Configurações de envio.

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

      Property Necessário Description
      Ativar assinatura de mensagens Não A 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 ativada O algoritmo de assinatura a ser usado, com base no certificado selecionado
      Certificado Sim, se a assinatura estiver ativada O certificado a ser usado para assinatura
      Habilitar a criptografia de mensagens Não A opção para criptografar mensagens de saída com o algoritmo de criptografia selecionado e o certificado
      Algoritmo de encriptação Sim, se a encriptação estiver ativada O algoritmo de encriptação a utilizar, com base no certificado selecionado
      Certificado Sim, se a encriptação estiver ativada 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.

      Property Necessário Description
      URL da 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 O URL a ser usado para enviar mensagens de confirmação. O URL é um campo obrigatório para mensagens assíncronas.

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

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

    Captura de tela que mostra uma tabela de informações 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 são baseadas no PIP que você configurou em sua conta de integração. Se necessário, você pode alterar a função PIP.

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

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

Receber ou decodificar mensagens 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 quaisquer outras ações que você deseja executar antes de adicionar a ação RosettaNet. Este exemplo continua com o gatilho Request.

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

    Captura de tela do designer. No gatilho Solicitação, Nova etapa é selecionada.

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

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

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

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

    Property Necessário Description
    Mensagem Sim A mensagem RosettaNet para decodificar
    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 O papel do parceiro anfitrião no PIP

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

Enviar ou codificar mensagens 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 quaisquer outras ações que você deseja executar antes de adicionar a ação RosettaNet. Este exemplo continua com o gatilho Request.

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

    Captura de tela do designer. No gatilho Solicitação, Nova etapa é selecionada.

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

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

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

    Captura de tela da ação RosettaNet Encode onde aparecem caixas para a mensagem, os parceiros, informações PIP, o tipo de mensagem e a função.

    Property Necessário Description
    Mensagem Sim A mensagem RosettaNet para codificar
    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 exclusivo para esta mensagem PIP
    Tipo de mensagem Sim O tipo de mensagem a codificar
    Função Sim O papel do parceiro anfitrião

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

  5. Para enviar a mensagem codificada, o exemplo a seguir usa a ação HTTP , que é renomeada 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 URI, cabeçalho e corpo são inseridos.

    De acordo com os padrões RosettaNet, as transações comerciais são consideradas concluídas apenas quando todas as etapas definidas pelo PIP estiverem 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 await for response.

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

    A duração a ser usada para espera e o número de novas tentativas são baseados na configuração PIP em sua conta de integração. Se a resposta não for recebida, uma Notificação de Falha será gerada. Para lidar com tentativas, sempre coloque as ações Codificar e Esperar por resposta em um loop TUntil .

    Captura de tela do designer. Um loop Until contém ações para codificar e enviar mensagens e para aguardar respostas.

Modelos RosettaNet

Para acelerar o desenvolvimento e recomendar padrões de integração, você pode usar modelos de aplicativo lógico de consumo para decodificar e codificar mensagens RosettaNet. Ao criar um fluxo de trabalho de 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 Integração Empresarial e os modelos para decodificação e codificação de mensagens RosettaNet são selecionados.

Próximos passos