Compartilhar via


Trabalhar com fontes de dados do esquema dinâmico no Power Apps (experimental)

[Este artigo faz parte da documentação de pré-lançamento e está sujeito a alterações.]

Importante

  • Este é um recurso experimental.
  • Os recursos experimentais não foram criados para uso em ambientes de produção e podem ter funcionalidade restrita. Esses recursos são disponibilizados antes de um lançamento oficial para que os clientes possam ter acesso antecipado e forneçam comentários.

O Power Apps geralmente usa um conjunto fixo de campos retornados pela fonte de dados. No entanto, algumas fontes de dados podem retornar um conjunto diferente de campos, dependendo dos valores dos parâmetros de chamada de serviço. Considera-se que essas chamadas de serviço têm o esquema dinâmico, pois os campos na resposta da chamada de serviço mudam dinamicamente dependendo de como o serviço é chamado.

Por exemplo, itens de trabalho do Azure DevOps podem usar campos personalizados. Como os campos personalizados não estão disponíveis para todos os itens de trabalho, algumas chamadas para o Azure DevOps são considerados dinâmicos. Nesses casos, você possivelmente obterá um conjunto diferente de campos, dependendo da organização do Azure DevOps que contém esses campos personalizados.

Observação

Este artigo usa o conector do Azure DevOps para explicar o uso do esquema dinâmico no Power Apps. Para criar um aplicativo de tela que se conecte ao Azure DevOps, consulte Conectar ao Azure DevOps a partir do Power Apps. Para configurar seu projeto do Azure DevOps com um campo personalizado, consulte Criar campos personalizados.

Com o recurso experimental Esquema dinâmico, agora você pode capturar esquemas para essas fontes de dados bloqueando uma chamada específica com o conjunto de campos retornado. E, em seguida, use os campos desse esquema dinâmico ao trabalhar com dados, em vez do esquema padrão disponível com as chamadas de serviço padrão.

Habilitar esquema dinâmico

Para ativar o recurso Esquema dinâmico, vá para Configurações > Próximos recursos > Experimental > Esquema dinâmico enquanto mantém seu aplicativo de tela aberto para edição.

Ative a configuração de esquema dinâmico.

Feche a sessão atual do Power Apps Studio e reabra o aplicativo para edição. Você verá um ícone de aviso quando a fórmula usar chamadas de serviço que dão suporte ao esquema dinâmico. Ao expandir a barra de fórmulas, você verá um novo botão chamado Capturar esquema.

Opção para capturar o esquema e uma mensagem de aviso para chamadas de serviço de esquema dinâmico.

Usar esquema dinâmico

Selecionando Capturar esquema recupera os campos que dão suporte à chamada de serviço com esquema conforme definido na fonte de dados específica para a chamada de serviço.

Por exemplo, a imagem a seguir mostra uma lista de todos os campos recuperados ao se conectar o projeto do Azure DevOps. A menos que o esquema dinâmico seja "capturado", a lista de campos permanece disponível por padrão para itens de trabalho do Azure DevOps.

Lista de todos os campos retornados pela chamada de serviço por padrão que não inclui o ID da Fabrikam.

Considere um projeto no Azure DevOps que usa campo personalizado—por exemplo, Código da Fabrikam:

Exemplo de ID da Fabrikam como um campo personalizado no Azure DevOps.

Você precisará capturar o esquema da chamada de serviço para usar esse campo personalizado. Para capturar o esquema, selecione e expanda a fórmula que mostra a mensagem de aviso e, em seguida, selecione Capturar esquema.

Depois que o esquema dinâmico for capturado, você poderá usar o campo personalizado Código da Fabrikam para o campo selecionado em seu aplicativo de tela.

Exemplo de ID da Fabrikam capturado por meio do recurso de esquema dinâmico.

Você também pode ver o esquema atualizado disponível para uso na chamada de serviço da galeria que foi usada para capturar o esquema. Para ver este detalhe do esquema, mova o cursor no final da fórmula e selecione o botão suspenso abaixo da barra de fórmulas para expandir o conjunto de resultados.

Exemplo de esquema capturado com o ID da Fabrikam listado na barra de fórmulas.

Confira também

Conectar-se ao Azure DevOps a partir do Power Apps

Observação

Você pode nos falar mais sobre suas preferências de idioma para documentação? Faça uma pesquisa rápida. (Observe que esta pesquisa está em inglês)

A pesquisa levará cerca de sete minutos. Nenhum dado pessoal é coletado (política de privacidade).