Trabalhar com fontes de dados baseadas em ação

  • 8 minutos

As fontes de dados baseadas em ação são diferentes das fontes de dados tabulares mais conhecidas. Você usa as funções para interagir com a fonte de dados, em vez de apenas ler e gravar dados. Uma diferença importante a ser observada entre as fontes de dados tabulares e as baseadas em ação é que as baseadas em ação não podem ser usadas com o controle de Formulários. Os formulários só funcionam com fontes de dados tabulares. Isso não significa que as fontes de dados baseadas em ação só possam ler dados. A maioria das fontes de dados baseadas em ação oferece funções para atualizar os dados conforme apropriado. Uma fonte de dados baseada em ação também pode ser usada para enviar emails ou outras notificações, não necessariamente apenas para ler e gravar dados.

Nos exemplos a seguir, você aprenderá a

  • Adicionar o conector Usuários do Office 365 ao seu aplicativo.

  • Consultar usuários.

  • Localizar o gerente do usuário que fez o logon.

  • Atualizar o perfil do usuário que fez o logon.

Adicionar a fonte de dados Usuários do Office 365

Neste exemplo, você adicionará a um aplicativo a fonte de dados Usuários do Office 365, que é baseada em ação. O processo é o mesmo que é usado para adicionar uma fonte de dados tabular.

  1. No Power Apps Studio, selecione Adicionar dados na faixa de opções do menu superior.

  2. Na caixa de pesquisa, digite "Office 365".

  3. A lista de opções será filtrada. Selecione Usuários do Office 365 e, depois, a conexão de conta que você deseja usar.

  4. Confirme se a fonte de dados foi adicionada selecionando o botão Adicionar dados mais uma vez. Em IEm seu aplicativo, você verá a conexão Office365Users que acabou de adicionar.

Você adicionou a fonte de dados Usuários do Office 365 ao seu aplicativo.

Agora que adicionou a fonte de dados ao aplicativo, você pode exibir uma lista de Usuários do Office 365 em uma galeria.

  1. Na faixa de opções do menu, selecione Inserir.

  2. Selecione Galeria.

  3. No menu suspenso, selecione Galeria vertical.

  4. Com a nova galeria selecionada, você pode Selecionar uma fonte de dados e selecionar Office365Users.

    Captura de tela de Selecione uma fonte de dados para sua galeria com o conector Office365Users realçado.

Observe que os dados dos usuários do Office 365 não são mostrados na galeria e alguns campos de erro são exibidos. Isso ocorre porque a galeria mostra apenas fontes de dados tabulares. Você ainda pode usar a fonte de dados baseada em ação conectando-se a uma galeria. Basta realizar algumas modificações nos dados.

  1. Na barra de fórmulas, há uma propriedade Items que, no momento, indica Office365Users.

    Captura de tela de itens de fluxo da propriedade Galeria de itens.

  2. Agora, faça a seguinte adição à propriedade items:

    Office365Users.SearchUser()

    Observe que, quando você faz isso, um dos erros da galeria desaparece, pois fornecemos uma tabela de dados à galeria. Portanto, agora basta modificar os dados da tabela que estão sendo apresentados na galeria.

  3. No painel da galeria à direita da tela, altere o Layout para Título e Subtítulo. Observe como os erros desaparecem e dados começam a ser mostrados na galeria, embora não seja exatamente o que queremos.

  4. Agora selecione Editar nos Campos do painel e defina o rótulo Título como DisplayName.

  5. Defina o rótulo Subtítulo como Email.

    Captura de tela da propriedade de configurações de fluxo nas configurações da galeria.

Agora, a galeria mostra as propriedades DisplayNames e Mail dos usuários do Microsoft 365, exatamente como se você estivesse usando uma fonte de dados tabular. Isso ocorre porque essa função da conexão de dados Usuários do Office 365 retorna dados tabulares. Você pode usar a saída desses dados com qualquer função, como SortByColumns ou Sum, que aceite uma tabela de dados como entrada.

Localizar o endereço de email do gerente do usuário conectado

Outro uso comum da fonte de dados do Office 365 é consultar o gerente do usuário. Com fontes de dados tabulares, você usaria a função LookUp para encontrar esse tipo de informação. Com essa fonte de dados baseada em ação, você usa uma função para consultar diretamente a informação, conforme mostrado no exemplo a seguir.

  1. Selecione uma área fora da galeria do exemplo anterior.

  2. Selecione o botão Inserir na faixa de opções superior.

  3. Selecione Rótulo de texto.

  4. Na barra de fórmulas, exclua "Texto" e digite a seguinte fórmula:

    Office365Users.ManagerV2(User().Email).mail

Observação

Se você receber um erro depois de inserir essa fórmula, isso indicará que o usuário não tem um gerente atribuído no Office 365.

No rótulo, agora você vê o endereço de email do gerente do usuário atual. A tabela a seguir mostra um detalhamento da fórmula.

Argumento da fórmula Entrada da fórmula Observações
id User().Email User() é uma função interna que retorna informações sobre o usuário conectado atual, incluindo FullName, Email e Image.
.property .mail A função retorna o registro de usuário completo do gerente. Para exibir somente o endereço de email em um Rótulo, use a notação de ponto (.).

Atualizar as informações de perfil do usuário que fez o logon

Outra maneira de usar um conector baseado em ação é para atualizar dados. Com uma fonte de dados tabular, você pode atualizar diretamente usando uma função Form ou Patch. Esses recursos não funcionam com fontes de dados baseadas em ação. Em vez disso, para cada fonte de dados baseada em ação, você depende das funções que esse conector oferece para suas opções. O exemplo a seguir mostra como atualizar seu perfil de usuário da Microsoft usando a função fornecida.

  1. Vamos inserir um botão na tela do aplicativo de tela. Selecione + Inserir na faixa de opções superior e, depois, Botão.

  2. Para a propriedade OnSelect do botão, defina a fórmula como

    Office365Users.UpdateMyProfile({aboutMe: "Project manager with 5 years of technical project management experience."})

Esse processo atualizará seu Perfil do Microsoft 365. A tabela a seguir mostra um detalhamento da fórmula.

Argumento da fórmula Entrada da fórmula Observações
Opcional {aboutMe: " Project manager with 5 years of technical project management experience."} Outros parâmetros opcionais: birthday, interests, mySite, pastProjects, schools, skills

Outro exemplo seria atualizar o perfil fazendo referência a um controle de entrada de texto na tela. Se você tiver um controle de entrada de texto na tela chamado textinput1, a fórmula será atualizada para:

Office365Users.UpdateMyProfile({aboutMe: TextInput1.Text})

A fonte de dados com base em ação dos Usuários do Office 365 é uma fonte de dados avançada e comumente usada em muitos aplicativos. Reserve algum tempo para se familiarizar mais com ela. Para obter mais informações, consulte Conectores.

Esses exemplos demonstram como integrar uma fonte de dados baseada em ação ao aplicativo. Os conceitos podem ser semelhantes aos das fontes de dados tabulares, como ao exibir usuários em uma galeria. No entanto, eles também podem ser diferentes, como gravar novamente no perfil de um usuário.

Na próxima unidade, você aprenderá mais sobre o Power Automate e como integrá-lo ao Power Apps.