Compartilhar via

Integrar-se ao Power Platform e aos Aplicativos Lógicos usando o conector dos Gêmeos Digitais do Azure

  • Artigo

Você pode integrar os Gêmeos Digitais do Azure a um fluxo do Microsoft Power Platform ou dos Aplicativos Lógicos do Azure usando o conector do Power Platform dos Gêmeos Digitais do Azure.

O conector é um wrapper em torno das APIs do plano de dados dos Gêmeos Digitais do Azure para operações de gêmeo, modelo e consulta, o que permite que o serviço subjacente fale com o Microsoft Power Automate, o Microsoft Power Apps e os Aplicativos Lógicos do Azure. O conector fornece uma maneira para os usuários conectarem suas contas e aproveitarem um conjunto de ações predefinidas para criar seus aplicativos e fluxos de trabalho.

Para obter uma introdução ao conector, incluindo uma demonstração rápida, assista ao seguinte vídeo de exibição de IoT:

Você também pode concluir um passo a passo básico na postagem do blog Simplificar a criação de fluxos de trabalho automatizados e aplicativos da plataforma Gêmeos Digitais do Azure. Para obter mais informações sobre o conector, incluindo uma lista completa das ações do conector e seus parâmetros, consulte a documentação de referência do conector dos Gêmeos Digitais do Azure.

Pré-requisitos

Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar. Entre no portal do Azure com sua conta.

Para trabalhar com os Gêmeos Digitais do Azure neste artigo, você precisará ter uma instância dos Gêmeos Digitais do Azure e as permissões necessárias para usá-la. Se você já tiver uma instância dos Gêmeos Digitais do Azure configurada, use essa instância e vá direto para a próxima seção. Caso contrário, siga as instruções descritas em Configurar uma instância e uma autenticação. As instruções contêm informações que ajudarão você a verificar se cada etapa foi concluída com êxito.

Após configurar a instância, anote o nome do host da instância. Encontre o nome do host no portal do Azure.

Por fim, você precisará configurar todos os serviços do Power Platform em que deseja usar o conector.

Configurar o conector

Para o Power Automate e o Power Apps, configure a conexão primeiro antes de criar um fluxo. Siga as etapas abaixo para adicionar a conexão no Power Automate e no Power Apps.

  1. Selecione Conexões no menu de navegação à esquerda (no Power Automate, ele está sob o título Dados ). Na página Conexões, selecione + Nova conexão.
  2. Pesquise gêmeos digitais do Azure e selecione o conector dos Gêmeos Digitais do Azure (versão prévia).
  3. Quando o conector solicitar o Nome da Instância do ADT, insira o nome do host da instância.
  4. Insira os detalhes de autenticação quando solicitado a concluir a configuração da conexão.
  5. Para verificar se a conexão foi criada, procure-a na página Conexões. Captura de tela do Power Automate mostrando a conexão dos Gêmeos Digitais do Azure na página Conexões.

Para Aplicativos Lógicos, você pode usar a conexão interna dos Gêmeos Digitais do Azure ao criar um fluxo na próxima seção. Para obter mais informações sobre conectores internos, consulte Conectores internos nos Aplicativos Lógicos do Azure.

Criar um fluxo

Você pode incorporar os Gêmeos Digitais do Azure em fluxos do Power Automate, fluxos de Aplicativos Lógicos ou aplicativos do Power Apps. Usando o conector dos Gêmeos Digitais do Azure e mais de 700 outros conectores do Power Platform, você pode ingerir dados de outros sistemas em seus gêmeos ou responder a eventos do sistema.

Siga as etapas abaixo para criar um fluxo de exemplo com o conector no Power Automate.

  1. No Power Automate, selecione Meus fluxos no menu de navegação à esquerda. Selecione + Novo fluxo e Fluxo de nuvem instantânea.
  2. Insira um Nome de fluxo e selecione Disparar manualmente um fluxo na lista de gatilhos. Crie o fluxo.
  3. Adicione uma etapa ao fluxo e pesquise gêmeos digitais do Azure para encontrar a conexão. Selecione a conexão dos Gêmeos Digitais do Azure. Captura de tela do Power Automate mostrando o conector dos Gêmeos Digitais do Azure em um novo fluxo.
  4. Você verá uma lista de todas as ações disponíveis com o conector. Escolha um deles para interagir com as APIs dos Gêmeos Digitais do Azure. Captura de tela do Power Automate mostrando todas as ações para o conector dos Gêmeos Digitais do Azure.
  5. Você pode continuar editando ou adicionar mais etapas ao fluxo de trabalho, usando outros conectores para criar seu cenário de integração. Captura de tela do Power Automate mostrando uma ação Obter gêmeo por ID do conector dos Gêmeos Digitais do Azure em um fluxo.

Siga as etapas abaixo para criar um fluxo de exemplo com o conector no Power Apps.

  1. No Power Apps, selecione + Criar no menu de navegação à esquerda. Selecione Aplicativo em branco e siga os prompts para criar um novo aplicativo.
  2. No construtor de aplicativos, selecione Dados no menu de navegação à esquerda. Selecione Adicionar dados e pesquise gêmeos digitais do Azure para encontrar a conexão de dados. Selecione a conexão dos Gêmeos Digitais do Azure. Captura de tela do Power Apps mostrando o conector dos Gêmeos Digitais do Azure como uma fonte de dados.
  3. Agora, as ações do conector dos Gêmeos Digitais do Azure estarão disponíveis como funções a serem usadas em seu aplicativo. Captura de tela do Power Apps mostrando a ação Obter gêmeo por ID sendo usada em uma função.
  4. Você pode continuar a criar seu aplicativo com acesso aos dados dos Gêmeos Digitais do Azure. Para obter mais informações sobre como criar o Power Apps, consulte Visão geral da criação de aplicativos no Power Apps.

Siga as etapas abaixo para criar um fluxo de exemplo com o conector nos Aplicativos Lógicos.

  1. Navegue até seu aplicativo lógico no portal do Azure. Selecione Fluxos de trabalho no menu de navegação à esquerda e + Adicionar. Siga os prompts para criar um novo fluxo de trabalho.
  2. Selecione o novo fluxo e insira no Designer.
  3. Adicione um gatilho ao seu aplicativo.
  4. Selecione Escolher uma operação para adicionar uma ação do conector dos Gêmeos Digitais do Azure. Pesquise Gêmeos Digitais do Azure na guia Azure para encontrar a conexão de dados. Selecione a conexão dos Gêmeos Digitais do Azure. Captura de tela dos Aplicativos Lógicos mostrando o conector dos Gêmeos Digitais do Azure.
  5. Você verá uma lista de todas as ações disponíveis com o conector. Escolha um deles para interagir com as APIs dos Gêmeos Digitais do Azure.
  6. Depois de selecionar uma ação no conector dos Gêmeos Digitais do Azure, você será solicitado a inserir detalhes de autenticação para criar a conexão.
  7. Você pode continuar editando ou adicionar mais etapas ao fluxo de trabalho, usando outros conectores para criar seu cenário de integração.

Limitações e sugestões

Aqui estão algumas limitações do conector e sugestões para trabalhar com eles.

  • Algumas ações do conector (como Adicionar Modelo) exigem entrada na forma de uma cadeia de caracteres literal que começa com @. Nesses casos, escape o @ caractere usando @@ em vez disso. Isso impedirá que o valor literal seja interpretado como uma expressão JSON.
  • Como os Gêmeos Digitais do Azure lidam com respostas dinâmicas de esquema, você deve analisar o JSON recebido das APIs antes de consumi-lo em seu aplicativo. Por exemplo, aqui está um conjunto de chamadas que analisam os dados antes de extrair o dtId valor: Set(jsonVal, AzureDigitalTwins.GetTwinById("your_twin_id").result); Set(parsedResp, ParseJSON(jsonVal)); Set( DtId, Text(parsedResp.'$dtId'));.

Próximas etapas

Para obter mais informações sobre conectores do Power Platform, incluindo como usá-los em fluxos de trabalho em vários produtos, consulte a documentação de conectores do Power Platform e dos Aplicativos Lógicos do Azure.