Adicionar metadados para encontrar artefactos B2B em fluxos de trabalho para aplicações Azure Logic

Aplica-se a: Azure Logic Apps (Consumo e Standard)

Para ajudar o seu fluxo de trabalho a encontrar rapidamente os artefactos business-to-business (B2B) corretos para usar em tempo de execução, pode adicionar metadados personalizados como pares-chave-valor a artefactos como parceiros comerciais, acordos, esquemas e mapas. Metadados personalizados para artefactos ajudam-no a cumprir os seguintes objetivos ou tarefas:

• Impor as convenções de nomenclatura.
• Apoiar a reutilização e evitar definições duplicadas.
• Encaminhe as cargas para os passos corretos de codificação ou decodificação.
• Proporcione mais controlo sobre a movimentação de artefactos através do desenvolvimento, teste e produção.
• Aplique a validação ou transformação correta sem lógica codificada fixamente.
• Facilitar o rastreamento, rastreabilidade, governação e auditoria.
• Facilitar a migração do BizTalk Server para o Azure Logic Apps.

A lista seguinte descreve exemplos de metadados úteis, baseados no tipo de artefacto:

Para fins de rastreio e alimentação de tabelas ou dashboards de rastreio B2B, metadados úteis incluem propriedades de correlação como número de intercâmbio, número de grupo, ID de conjunto de transações, bem como ID de execução do fluxo de trabalho, IDs de parceiros e acordos, estado e carimbos temporais.

Este guia mostra como adicionar metadados a um artefacto numa conta de integração, encontrar o artefacto usando a ação incorporada da Conta de Integração chamada pesquisa de artefacto da conta de integração, e referenciar os metadados do artefacto no seu fluxo de trabalho.

Pré-requisitos

• Uma conta Azure e uma assinatura. Crie uma conta Azure gratuita.

• O recurso e o fluxo de trabalho da aplicação lógica onde queres obter e usar os metadados do artefacto.

  O seu fluxo de trabalho pode começar com qualquer gatilho e precisa de uma ação que funcione com os metadados após a recuperação. Este exemplo utiliza o gatilho de Requisição denominado Quando uma requisição HTTP é recebida, que pode passar dinamicamente o nome do artefacto a partir de uma requisição HTTPS recebida.

  Para obter mais informações, consulte:

  • Criar um fluxo de trabalho de Consumo no Azure Logic Apps

  • Criar um fluxo de trabalho padrão no Azure Logic Apps

• Um recurso de conta de integração que contém os artefatos onde pretende adicionar metadados.

  Pode adicionar metadados personalizados aos seguintes artefactos:

  • Sócio
  • Acordo
  • Esquema
  • Mapa

  O exemplo deste guia utiliza um artefacto parceiro chamado TradingPartner1.

  • 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.

  • Antes de começar a trabalhar com a ação de pesquisa de artefactos da conta de Integração , deve ligar a sua aplicação Lógica de Consumo ou a sua aplicação Lógica Padrão à conta de integração. Pode ligar uma conta de integração a múltiplos recursos da aplicação Consumption ou Standard Logic para partilhar os mesmos artefactos.

Adicionar metadados a um artefacto

Siga estes passos para adicionar metadados personalizados para um artefacto B2B na sua conta de integração.

1. No portal Azure, vai ao recurso da tua conta de integração.

2. Na barra lateral de recursos, em Definições, seleciona a categoria de artefactos.

   Este exemplo adiciona metadados a um artefacto de parceiro comercial, por isso, neste cenário, o exemplo seleciona Parceiros.

3. Na página da categoria de artefactos, seleciona o artefacto e depois seleciona Editar.

   O exemplo seguinte mostra a página de edição de um artefacto parceiro chamado TradingPartner1.

   

4. Em Metadados, nas colunas Chave e Valor , introduza os seus metadados personalizados como um par chave-valor. Quando tiver terminado, selecione OK.

   O exemplo a seguir mostra metadados de amostra como pares de chave-valor:

   

5. Para visualizar estes metadados na definição de JavaScript Object Notation (JSON) para o artefacto, ao lado de Editar, selecione Editar como JSON em vez disso.

   

Encontre o artefacto

Siga estes passos para encontrar o artefacto e os metadados associados na sua conta de integração. O exemplo procura um artefacto específico de parceiro comercial.

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

2. No designer, siga estes passos gerais para adicionar a ação incorporada da Conta de Integração chamada Pesquisa de artefacto da conta de Integração, que encontra o artefacto e os metadados especificados.

3. Forneça a seguinte informação para o artefacto, com base no seu tipo de fluxo de trabalho:

   Parâmetro	Obrigatório	Valor	Description
   - Consumo: nome do artefacto - Padrão: Nome do artefacto	Yes	< nome do artefato>	O nome do artefacto, que podes introduzir como um nome codificado fixamente ou como saída dinâmica do trigger ou ação anterior no workflow.
   - Consumo: artefactType - Padrão: Tipo de artefacto	Yes	Acordo, Mapa, Parceiro ou Esquema	O tipo de artefato.

   1. Para fornecer o nome do artefacto como saída do gatilho ou ação anterior, siga estes passos:

      1. Selecione dentro da caixa Nome do Artefacto ou Nome do Artefacto , depois selecione o ícone do relâmpago para abrir a lista dinâmica de conteúdo.

      2. Na lista dinâmica, sob o nome do gatilho ou ação, selecione a saída que especifica o nome do artefacto.

   2. Para tipo de artefacto ou tipo de artefacto, selecione o tipo de artefacto. Neste exemplo, o tipo é Parceiro.

      

4. Salve seu fluxo de trabalho.

Metadados de artefactos de referência no fluxo de trabalho

Siga estes passos para utilizar os metadados do artefacto recuperados no seu fluxo de trabalho. O exemplo faz referência aos metadados do artefacto recuperado na secção anterior.

1. No módulo de design, na ação de pesquisa de artefacto da conta de integração, siga estas etapas gerais para adicionar a ação desejada.

   Este exemplo continua com a ação incorporada HTTP , que envia um pedido HTTP do fluxo de trabalho para um destino especificado.

2. No painel de ações, forneça informações sobre como pretende usar os metadados do artefacto.

   Este exemplo utiliza os routingUrl metadados como destino do pedido HTTP. A tabela seguinte especifica valores de exemplo para a ação HTTP neste exemplo:

   Parâmetro	Obrigatório	Valor	Description	Valor de exemplo
   URI	Yes	< destination-URL>	O URL do endpoint para onde quer enviar o pedido.	Para consultar os metadados do routingUrl parceiro, siga estes passos: 1. Selecione dentro da caixa URI . 2. Selecione o ícone de função para abrir o editor de expressões. 3. No editor, introduza uma expressão como o seguinte exemplo, com base no tipo de fluxo de trabalho: Consumo outputs('Integration_Account_Artifact_Lookup')?['properties']?['metadata']['routingUrl'] Standard outputs('Integration_account_artifact_lookup')?['properties']?['metadata']['routingUrl'] 4. Quando terminares, seleciona Adicionar.
   Método	Yes	< Método HTTP>	A operação HTTP a executar.	Este exemplo utiliza a operação GET .
   Cabeçalhos	Não	< valores de cabeçalho>	Qualquer cabeçalho de saída do gatilho deve passar pela ação HTTP.	Para passar um valor do cabeçalho de gatilho Content-Type, em Cabeçalhos, siga estes passos para a primeira linha: 1. Na primeira coluna, digite Content-Type como o nome do cabeçalho. 2. Na segunda coluna, use o editor de expressões para inserir a seguinte expressão como o valor do cabeçalho: triggeroutputs()?['headers']['Content-Type'] Para passar o Host valor do cabeçalho de ativação, em Cabeçalhos, siga estes passos para a segunda linha: 1. Na primeira coluna, digite Host como o nome do cabeçalho. 2. Na segunda coluna, use o editor de expressões para inserir a seguinte expressão como o valor do cabeçalho: triggeroutputs()?['headers']['Host']
   Corpo	Não	< corpo-conteúdo>	Qualquer outro conteúdo para passar pela propriedade da ação body.	Para passar os valores do properties artefacto para a ação HTTP , siga estes passos: 1. Selecione dentro da caixa Corpo , depois selecione o ícone de relâmpago para abrir a lista dinâmica de conteúdo. Se não aparecerem saídas, selecione Ver mais. 2. Na lista de conteúdo dinâmico, em Pesquisa de Artefatos da Conta de Integração, selecione Propriedades.

   No cenário de exemplo, a ação HTTP utiliza os seguintes valores de exemplo:

   

3. Para confirmar a informação na ação HTTP, consulte a definição JSON subjacente do seu fluxo de trabalho. Na barra de ferramentas do designer, selecione Visualização de código.

   A definição JSON subjacente ao fluxo de trabalho aparece, por exemplo:

   

4. Volte ao designer. Na barra de ferramentas da visualização de código, selecione Designer.

   Quaisquer expressões que tenha inserido no designer agora parecem resolvidas, por exemplo:

   

Conteúdo relacionado

• Adicionar acordos entre parceiros