Partilhar via


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

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

Importante

  • Esta é uma funcionalidade experimental.
  • As funcionalidades experimentais não se destinam à produção e poderão ter funcionalidades restritas. Estas funcionalidades estão disponíveis antes do lançamento oficial, para que os clientes possam ter acesso antecipadamente e enviar comentários.

Normalmente, o Power Apps utiliza um conjunto de campos fixo devolvido pela origem de dados. No entanto, algumas origens de dados podem devolver um conjunto diferente de campos consoante os valores dos parâmetros de chamada de serviço. Estas chamadas de serviço são consideradas como tendo um esquema dinâmico, uma vez que os campos na resposta à chamada de serviço mudam dinamicamente dependendo da forma como o serviço é chamado.

Por exemplo, os itens de trabalho do Azure DevOps podem utilizar 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 consideradas dinâmicas. Nestas instâncias, obterá potencialmente um conjunto de campos diferente dependendo da organização do Azure DevOps que contém estes campos personalizados.

Nota

Este artigo utiliza o conector do Azure DevOps para explicar a utilização do esquema dinâmico no Power Apps. Para criar uma aplicação de tela que se liga ao Azure DevOps, consulte Ligar ao Azure DevOps a partir do Power Apps. Para configurar o seu projeto do Azure DevOps com um campo personalizado, consulte criar campos personalizados.

Com a funcionalidade experimental Esquema dinâmico, pode agora capturar o esquema para estas origens de dados ao bloquear uma chamada específica com o conjunto de campos devolvidos. E, em seguida, use os campos a partir deste esquema dinâmico enquanto trabalha com dados, em vez do esquema predefinido disponível com as chamadas de serviço predefinidas.

Ativar esquema dinâmico

Para ativar a funcionalidade Esquema dinâmico, vá para Definições > Funcionalidades futuras > Experimental > Esquema dinâmico enquanto mantém a sua aplicação de tela aberta para edição.

Ative a definição Esquema dinâmico.

Feche a sessão atual do Power Apps Studio e reabra a aplicação para edição. Verá um ícone de aviso quando a fórmula usar chamadas de serviço que suportam esquemas dinâmicos. Quando expandir a barra de fórmulas, verá um novo botão denominado Capturar esquema.

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

Utilizar esquema dinâmico

Selecionar Capturar esquema obtém os campos que suportam a chamada de serviço com o esquema, conforme definido na origem de dados específica da chamada de serviço.

Por exemplo, a imagem seguinte mostra uma lista de todos os campos obtidos ao ligar ao projeto do Azure DevOps. A menos que o esquema dinâmico seja "capturado", a lista de campos permanece disponível por predefinição para os itens de trabalho do Azure DevOps.

Lista de todos os campos devolvidos pela chamada de serviço por predefinição que não inclui o ID de Fabrikam.

Considere um projeto no Azure DevOps que utiliza campos personalizados, por exemplo, ID de Fabrikam:

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

Precisará de capturar o esquema para a chamada de serviço para usar este 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 de capturado o esquema dinâmico, poderá utilizar o campo personalizado ID de Fabrikam para o campo selecionado na sua aplicação de tela.

Exemplo de ID de Fabrikam capturado através da funcionalidade de esquema dinâmico.

Também poderá ver o esquema atualizado disponível para utilização para a 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 pendente abaixo da barra de fórmulas para expandir o conjunto de resultados.

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

Consulte também

Ligar ao Azure DevOps a partir do Power Apps

Nota

Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)

O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).