Modelo de tela Pessoas em aplicativos de tela

Em um aplicativo de tela, adicione uma tela de pessoas que permita que os usuários pesquisem pessoas em suas organizações. Os usuários podem procurar, selecionar e adicionar pessoas a uma coleção. Você pode alterar os tipos de dados que aparecem na galeria de resultados da pesquisa, usar as seleções de pessoas para enviar um email e fazer outras personalizações.

Você também pode adicionar outras telas baseadas em modelo que mostram dados diferentes do Office 365, como o email, um calendário de usuários em uma organização e a disponibilidade das pessoas que os usuários talvez queiram convidar para uma reunião.

Esta visão geral ensina:

• Como usar a tela de pessoas padrão.
• Como modificar a tela.
• Como integrar a tela em aplicativos.

Para aprofundar-se na funcionalidade padrão desta tela, consulte a referência da tela de pessoas.

Pré-requisito

Familiaridade com como adicionar e configurar telas e outros controles, conforme você cria um aplicativo no Power Apps.

Funcionalidade padrão

Para adicionar uma tela de pessoa a partir do modelo:

1. Entre em para Power Apps e crie um aplicativo ou abra um aplicativo existente no Power Apps Studio.

   Este tópico mostra um aplicativo para telefone, mas os mesmos conceitos se aplicam a um aplicativo para tablet.

2. Na guia Página Inicial da faixa de opções, selecione Nova tela > Pessoas.

   Por padrão, a tela é semelhante a esta:

   

3. Para começar a procurar usuários, selecione a caixa de entrada de texto na parte superior e comece a digitar o nome de um colega de trabalho. Os resultados da pesquisa aparecem abaixo da caixa de entrada de texto:

   

4. Quando você seleciona indivíduos nos resultados da pesquisa, eles são adicionados à coleção MyPeople. O valor de entrada da barra de pesquisa é redefinido, revelando a coleção de pessoas que você selecionou:

   

Modificar a tela

Você pode modificar a funcionalidade padrão dessa tela, mostrando dados diferentes para pessoas.

Se você deseja modificar ainda mais a tela, use a referência da tela de pessoas como guia.

Mostrar dados diferentes para as pessoas

Essa tela usa a operação Office365Users.SearchUser para procurar usuários em sua organização. Ela fornece campos adicionais para cada evento além do que aparece no controle UserBrowseGallery. Adicionar ou alterar campos na galeria é um processo simples:

1. Em UserBrowseGallery, selecione um rótulo para modificar (ou adicione um e mantenha-o selecionado).

2. Com a propriedade Text selecionada, na barra de fórmulas, substitua o conteúdo por ThisItem.

   O IntelliSense mostra uma lista os campos que podem ser selecionados.

3. Selecione o campo que você deseja.

   A propriedade Text deve ser atualizada para ThisItem.{FieldSelection}.

Como integrar a tela em um aplicativo

A tela de pessoas é um conjunto avançado de controles por si só, mas geralmente apresenta um desempenho melhor como parte de um aplicativo maior e mais versátil. É possível integrar esta tela a um aplicativo maior de várias maneiras, incluindo a usando sua lista de pessoas em cache.

Usar sua lista de pessoas em cache

A tela pessoas armazena em cache suas seleções de pessoas na coleção MyPeople. Caso seu cenário de negócios exija uma consulta por pessoa, você precisará saber como usar esta coleção. Aqui, você verá como conectar essa tela a uma tela de email básico e enviar emails para usuários na coleção MyPeople. Você também terá uma ideia de como a tela de email funciona.

1. Adicione a fonte de dados do Office 365 ao seu aplicativo, selecionando a guia Exibir, Fontes de dados > Adicionar fonte de dados e procurando o conector do Office 365 Outlook. Você pode ter que selecionar Nova conexão para encontrá-lo.

2. Após inserir a tela de pessoas, insira uma nova tela em branco. Dentro dessa tela, adicione um ícone de seta para voltar, duas caixas de entrada de texto e um ícone de envio.

3. Renomeie a tela como EmailScreen, o ícone de seta para voltar para BackIcon, uma caixa de entrada de texto para SubjectLine, a outra para MessageBody e o ícone de envio para SendIcon.

4. Defina a propriedade OnSelect de BackIcon como Back().

5. Defina a propriedade OnSelect do SendIcon, conforme esta fórmula:

   Office365.SendEmailV2( 
       Concat( MyPeople, UserPrincipalName & ";" ), 
       SubjectLine.Text, 
       MessageBody.Text 
   )
   

   Aqui, você está usando o conector do Outlook para enviar um email. Você passa-o Concat(MyPeople, UserPrincipalName & ";") como a lista de destinatários. Essa fórmula concatena todos os endereços de email na coleção MyPeople em uma única string com ponto-e-vírgula separando-os. Isso não é diferente de escrever uma sequência de endereços de email separados por ponto e vírgula na linha "Para" do seu cliente de email favorito.

   • Você está informando SubjectLine.Text como o assunto da mensagem e MessageBody.Text como o corpo da mensagem.

6. Na tela de pessoas, no canto superior direito, insira o ícone Enviar. Mude a cor do ícone para a de sua preferência.

7. Defina a propriedade OnSelect de SendIcon para Navigate( EmailScreen, None ).

   Agora você tem um aplicativo de duas telas no qual pode selecionar usuários, redigir uma mensagem de email a eles e enviá-la. Sinta-se à vontade para testá-lo, mas tenha cuidado, porque o aplicativo envia emails para todos que você adicionar à coleção MyPeople.

Próximas etapas

• Veja a documentação de referência para esta tela.
• Saiba mais sobre o conector do Office 365 Outlook.
• Saiba mais sobre o conector de Usuários do Office 365.

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).