Gerenciar metadados de artefato em contas de integração para Aplicativos Lógicos do Azure
Aplica-se a: Aplicativos Lógicos do Azure (Consumo)
Você pode definir metadados personalizados para artefatos em contas de integração e obter esses metadados durante o tempo de execução para o fluxo de trabalho do aplicativo lógico usar. Por exemplo, você pode fornecer metadados para artefatos, como parceiros, contratos, esquemas e mapas. Todos esses tipos de artefatos armazenam metadados como pares chave-valor.
Este guia de instruções mostra como adicionar metadados a um artefato de conta de integração. Em seguida, você pode usar ações em seu fluxo de trabalho para recuperar e usar os valores de metadados.
Pré-requisitos
Uma conta e subscrição do Azure. Se você não tiver uma assinatura, crie uma conta gratuita.
Uma conta de integração que tem os artefatos onde você deseja adicionar metadados. Os artefatos podem ser dos seguintes tipos:
O fluxo de trabalho do aplicativo lógico onde você deseja usar os metadados do artefato. Verifique se o fluxo de trabalho tem pelo menos um gatilho, como o gatilho Request ou HTTP , e a ação que você deseja usar para trabalhar com metadados de artefatos. O exemplo neste artigo usa o gatilho de solicitação chamado Quando uma solicitação HTTP é recebida.
Para obter mais informações, veja a seguinte documentação:
Certifique-se de vincular sua conta de integração ao recurso do aplicativo lógico de consumo ou ao fluxo de trabalho do aplicativo lógico padrão.
Adicionar metadados a artefatos
No portal do Azure, vá para sua conta de integração.
Selecione o artefacto onde pretende adicionar metadados e, em seguida, selecione Editar.
No painel Editar, insira os detalhes dos metadados desse artefato e selecione OK. A captura de tela a seguir mostra três pares chave-valor de metadados:
Para exibir esses metadados na definição JSON (JavaScript Object Notation) da conta de integração, selecione Editar como JSON, que abre o editor JSON.
Obter metadados de artefactos
No portal do Azure, abra o recurso de aplicativo lógico vinculado à sua conta de integração.
No menu de navegação do aplicativo lógico, selecione Designer de aplicativo lógico.
No designer, adicione a ação Pesquisa de Artefato de Conta de Integração para obter os metadados.
Sob o gatilho ou uma ação existente, selecione Nova etapa.
Na caixa Escolha uma pesquisa de operação, selecione Incorporado. Na caixa de pesquisa, insira conta de integração.
Na lista de ações, selecione a ação chamada Pesquisa de Artefato de Conta de Integração.
Forneça as seguintes informações para o artefato que você deseja localizar:
Property Necessário Valor Description Tipo de artefato Sim Esquema, mapa, parceiro, contrato ou um tipo personalizado O tipo para o artefato que você deseja obter Nome do artefato Sim <nome do artefato> O nome do artefato que você deseja obter Este exemplo obtém os metadados de um artefato de parceiro comercial seguindo estas etapas:
Em Tipo de artefato, selecione Parceiro.
Em Nome do Artefato, clique dentro da caixa de edição. Quando a lista de conteúdo dinâmico for exibida, selecione a saída do nome no gatilho.
Agora, adicione a ação que você deseja usar para usar os metadados. Este exemplo continua com a ação HTTP interna.
Forneça as seguintes informações para os metadados do artefato que você deseja que a ação HTTP use.
Por exemplo, suponha que você queira obter os
routingUrlmetadados adicionados anteriormente. Aqui estão os valores de propriedade que você pode especificar:Property Necessário Valor Description Valor de exemplo Método Sim <operação para execução> A operação HTTP a ser executada no artefato. Use o método GET para esta ação HTTP. URI Sim <localização dos metadados> O ponto de extremidade para o qual você deseja enviar a solicitação de saída. Para fazer referência ao routingUrlvalor de metadados do artefato recuperado, siga estas etapas:
1. Clique dentro da caixa URI .
2. Na lista de conteúdo dinâmico que se abre, selecione Expressão.
3. No editor de expressão, insira uma expressão como o exemplo a seguir:outputs('Integration_Account_Artifact_Lookup')['properties']['metadata']['routingUrl']
4. Quando terminar, selecione OK.Cabeçalhos Não <valores de cabeçalho> Qualquer saída de cabeçalho do gatilho que você deseja passar para a ação HTTP. Para passar o Content-Typevalor do cabeçalho do gatilho, siga estas etapas para a primeira linha em Cabeçalhos:
1. Na primeira coluna, digiteContent-Typecomo 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 oHostvalor do cabeçalho do gatilho, siga estas etapas para a segunda linha em Cabeçalhos:
1. Na primeira coluna, digiteHostcomo 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 que você queira passar pela propriedade da bodyação HTTP.Para passar os valores do propertiesartefato para a ação HTTP:
1. Clique dentro da caixa Corpo para abrir a lista de conteúdo dinâmico. Se nenhuma propriedade for exibida, selecione Ver mais.
2. Na lista de conteúdo dinâmico, em Pesquisa de Artefato de Conta de Integração, selecione Propriedades.A captura de tela a seguir mostra os valores de exemplo:
Para verificar as informações fornecidas para a ação HTTP, você pode exibir a definição JSON do fluxo de trabalho. Na barra de ferramentas do designer, selecione Visualização de código.
A definição JSON do fluxo de trabalho é exibida, conforme mostrado no exemplo a seguir:
Na barra de ferramentas da visualização de código, selecione Designer.
Todas as expressões inseridas no designer agora aparecem resolvidas.
