Adicionar contratos entre parceiros a contas de integração para fluxos de trabalho nos Aplicativos Lógicos do Azure

  • Artigo

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

Depois de adicionar parceiros à sua conta de integração, especifique como os parceiros trocam mensagens definindo contratos em sua conta de integração. Os contratos ajudam as organizações a se comunicarem perfeitamente entre si definindo o protocolo padrão específico do setor para trocar mensagens e fornecendo os seguintes benefícios compartilhados:

  • Permitir que as empresas troquem informações em um formato conhecido.

  • Melhorar a eficiência de transações B2B (entre empresas).

  • Facilitar a criação, o gerenciamento e o uso de contratos para criar soluções de integração empresarial.

Um contrato requer um parceiro de host, que é sempre sua organização e um parceiro convidado, que é a organização que troca mensagens com sua organização. O parceiro convidado pode ser outra empresa ou até mesmo um departamento dentro da sua organização. Usando esse contrato, você especifica como lidar com mensagens de entrada e saída da perspectiva do parceiro de host.

Este artigo mostra como criar e gerenciar um contrato, que você pode usar para trocar mensagens B2B com outro parceiro usando as operações AS2, X12, EDIFACT ou RosettaNet.

Se ainda não estiver familiarizado com os aplicativos lógicos, veja O que são os Aplicativos Lógicos do Azure? Para mais informações sobre a integração empresarial B2B, consulte Fluxos de trabalho de integração empresarial B2B com Aplicativos Lógicos do Azure e Enterprise Integration Pack.

Pré-requisitos

  • Uma conta e uma assinatura do Azure. Caso ainda não tenha uma assinatura, inscreva-se em uma conta gratuita do Azure.

  • Um recurso de conta de integração no qual você define e armazena artefatos, como parceiros comerciais, contratos, certificados e assim por diante, para usar em seus fluxos de trabalho de integração empresarial e B2B. O recurso precisa atender aos seguintes requisitos:

    • Estar associado à mesma assinatura do Azure que o recurso de aplicativo lógico.

    • Existe no mesmo local ou região do Azure que o recurso do aplicativo lógico.

    • Se você estiver usando o tipo de recurso Aplicativo Lógico (Consumo), sua conta de integração exigirá um link para o recurso do aplicativo lógico antes de poder usar artefatos no fluxo de trabalho.

    • Se você estiver usando o tipo de recurso Aplicativo lógico (padrão), sua conta de integração não precisará de um vínculo com o recurso do aplicativo lógico, mas ainda será necessário para armazenar outros artefatos, como parceiros, contratos e certificados, além de usar as operações AS2, X12 ou EDIFACT. Sua conta de integração ainda precisa atender a outros requisitos, como usar a mesma assinatura do Azure e existir no mesmo local que o recurso do aplicativo lógico.

    Observação

    Atualmente, somente o tipo de recurso Aplicativo Lógico (consumo) oferece suporte a operações RosettaNet. O tipo de recurso Aplicativo Lógico (Padrão) não inclui operações RosettaNet.

  • Pelo menos dois parceiros comerciais na conta de integração. Um contrato requer um parceiro de host e um parceiro convidado. Além disso, um contrato requer que ambos os parceiros usem o mesmo qualificador de identidade de negócios compatível ou que seja apropriado para um contrato AS2, X12, EDIFACT ou RosettaNet.

  • Opcionalmente, o recurso de aplicativo lógico e o fluxo de trabalho em que você deseja usar o contrato para trocar mensagens. O fluxo de trabalho requer de um gatilho que inicie o fluxo de trabalho do aplicativo lógico.

Se você for novato em aplicativos lógicos,leia os artigos O que são Aplicativos Lógicos do Azure e Criar um exemplo de fluxo de trabalho de aplicativo lógico de Consumo.

Adicionar um contrato

  1. Na caixa de pesquisa do portal do Azure, insira integration accounts e selecione Contas de integração.

  2. Em Contas de integração, selecione a conta de integração onde você deseja adicionar seus parceiros.

  3. No menu da conta de integração, em Configurações, escolha Acordos.

  4. No painel Contratos, selecione Adicionar.

  5. No painel Adicionar, forneça as seguintes informações sobre o contrato:

    Propriedade Obrigatório Valor Descrição
    Nome Sim < agreement-name> O nome do contrato
    Tipo de contrato Sim AS2, X12, EDIFACT ou RosettaNet O tipo de protocolo do contrato. Ao criar o arquivo do contrato, o conteúdo dele deve corresponder ao tipo de contrato.
    Parceiro de Host Sim < host-partner-name> O parceiro de host representa sua organização
    Identidade do Host Sim < host-partner-identifier> O identificador do parceiro de host
    Parceiro Convidado Sim < guest-partner-name> O parceiro convidado representa a organização que se comunica com a sua organização
    Identidade do Convidado Sim < guest-partner-identifier> O identificador do parceiro convidado
    Configurações de Recebimento Varia Varia Essas propriedades especificam como o parceiro de host recebe todas as mensagens de entrada do parceiro convidado no contrato. Para saber mais, revise o tipo de contrato respectivo:

    - Configurações de mensagens AS2
    - Configurações de mensagens EDIFACT
    - Configurações de mensagens X12
    Configurações de Envio Varia Varia Essas propriedades especificam como o parceiro de host envia as mensagens de saída ao parceiro convidado no contrato. Para saber mais, revise o tipo de contrato respectivo:

    - Configurações de mensagens AS2
    - Configurações de mensagens EDIFACT
    - Configurações de mensagens X12
    Referências do PIP do RosettaNet Varia Varia Esse painel especifica informações sobre um ou mais PIP (Processos de Interface de Parceiro) para usar mensagens RosettaNet. Para obter mais informações, consulte Trocar mensagens do RosettaNet.

    Importante

    A resolução de um contrato depende da correspondência dos seguintes itens definidos no parceiro e na mensagem de entrada:

    • O qualificador e o identificador do remetente
    • O qualificador e o identificador do destinatário

    Se os valores do parceiro forem alternados, não deixe de atualizar o contrato.

  6. Quando terminar, selecione OK.

    Seu contrato agora aparece na lista Contratos.

Editar um contrato

  1. Na caixa de pesquisa do portal do Azure, insira integration accounts e selecione Contas de integração.

  2. Em Contas de integração, selecione a conta de integração onde você deseja adicionar seus parceiros.

  3. No menu da conta de integração, em Configurações, escolha Acordos.

  4. No painel Contratos, selecione seu contrato, selecione Editar e faça suas alterações.

  5. Quando terminar, selecione OK.

Excluir um contrato

  1. Na caixa de pesquisa do portal do Azure, insira integration accounts e selecione Contas de integração.

  2. Em Contas de integração, selecione a conta de integração onde você deseja adicionar seus parceiros.

  3. No menu da conta de integração, em Configurações, escolha Acordos.

  4. No painel Contratos, selecione o contrato a ser excluído e, em seguida, selecione Excluir.

  5. Para confirmar que você deseja excluir o contrato, selecione Sim.

Próximas etapas