Ligar a uma ligação de utilizadores do Office 365 a partir do Power Apps
Os Utilizadores do Office 365 permitem-lhe aceder aos perfis dos utilizadores na sua organização com a sua conta do Office 365. Pode efetuar várias ações, como obter o seu perfil, um perfil de utilizador, um gestor do utilizador ou relatórios diretos.
Pode apresentar estas informações numa etiqueta na sua aplicação. Pode apresentar uma função, várias funções ou mesmo combinar funções diferentes. Por exemplo, pode criar uma expressão que combina o Nome de Utilizador e o Número de Telefone e, em seguida, apresentar estas informações na sua aplicação.
Este artigo mostra-lhe como adicionar Utilizadores do Office 365 como uma ligação, adicionar Utilizadores do Office 365 como uma origem de dados para a sua aplicação e utilizar dados de tabela num controlo Galeria.
Pré-requisitos
- Acesso ao Power Apps
- Adicionar a ligação
- Crie uma aplicação a partir de um modelo, dados ou de raiz
Adicionar uma ligação
Adicione uma ligação de dados e selecione Office 365 Utilizadores:
Selecione Ligar e se lhe for pedido para iniciar sessão, introduza a sua conta profissional.
A ligação dos Utilizadores do Office 365 foi criada e adicionada à sua aplicação. Agora está pronta a ser utilizada.
Utilize a ligação na sua aplicação
Mostra informações sobre o utilizador atual
No menu Inserir, selecione Etiqueta
Na barra de função, defina a propriedade Texto com qualquer uma das seguintes fórmulas:
Office365Users.MyProfile().City
Office365Users.MyProfile().CompanyName
Office365Users.MyProfile().Country
Office365Users.MyProfile().Department
Office365Users.MyProfile().DisplayName
Office365Users.MyProfile().GivenName
Office365Users.MyProfile().Id
Office365Users.MyProfile().JobTitle
Office365Users.MyProfile().Mail
Office365Users.MyProfile().MailNickname
Office365Users.MyProfile().mobilePhone
Office365Users.MyProfile().OfficeLocation
Office365Users.MyProfile().PostalCode
Office365Users.MyProfile().Surname
Office365Users.MyProfile().TelephoneNumber
Office365Users.MyProfile().UserPrincipalName
Office365Users.MyProfile().AccountEnabled
A etiqueta mostra as informações que introduziu sobre o utilizador atual.
Mostrar informações sobre outro utilizador
No menu Inserir, selecione Texto e, em seguida, selecione Introdução de texto. Mude o nome para InfoAbout:
Em InfoAbout, escreva ou cole um endereço de e-mail de um utilizador na sua organização. Por exemplo, escreva oSeuNome@aSuaEmpresa.com.
Adicione uma Etiqueta (Menu Inserir)e defina a propriedade Text como uma das seguintes fórmulas:
Para mostrar informações sobre outro utilizador:
Office365Users.UserProfile(InfoAbout.Text).City
Office365Users.UserProfile(InfoAbout.Text).CompanyName
Office365Users.UserProfile(InfoAbout.Text).Country
Office365Users.UserProfile(InfoAbout.Text).Department
Office365Users.UserProfile(InfoAbout.Text).DisplayName
Office365Users.UserProfile(InfoAbout.Text).GivenName
Office365Users.UserProfile(InfoAbout.Text).Id
Office365Users.UserProfile(InfoAbout.Text).JobTitle
Office365Users.UserProfile(InfoAbout.Text).Mail
Office365Users.UserProfile(InfoAbout.Text).MailNickname
Office365Users.UserProfile(InfoAbout.Text).mobilePhone
Office365Users.UserProfile(InfoAbout.Text).OfficeLocation
Office365Users.UserProfile(InfoAbout.Text).PostalCode
Office365Users.UserProfile(InfoAbout.Text).Surname
Office365Users.UserProfile(InfoAbout.Text).TelephoneNumber
Office365Users.UserProfile(InfoAbout.Text).UserPrincipalName
Office365Users.UserProfile(InfoAbout.Text).AccountEnabled
Office365Users.UserProfile(InfoAbout.Text).BusinessPhonesPara mostrar informações sobre o gestor de outro utilizador:
Office365Users.Manager(InfoAbout.Text).City
Office365Users.Manager(InfoAbout.Text).CompanyName
Office365Users.Manager(InfoAbout.Text).Country
Office365Users.Manager(InfoAbout.Text).Department
Office365Users.Manager(InfoAbout.Text).DisplayName
Office365Users.Manager(InfoAbout.Text).GivenName
Office365Users.Manager(InfoAbout.Text).Id
Office365Users.Manager(InfoAbout.Text).JobTitle
Office365Users.Manager(InfoAbout.Text).Mail
Office365Users.Manager(InfoAbout.Text).MailNickname
Office365Users.Manager(InfoAbout.Text).mobilePhone
Office365Users.Manager(InfoAbout.Text).OfficeLocation
Office365Users.Manager(InfoAbout.Text).PostalCode
Office365Users.Manager(InfoAbout.Text).Surname
Office365Users.Manager(InfoAbout.Text).TelephoneNumber
Office365Users.Manager(InfoAbout.Text).UserPrincipalName
Office365Users.Manager(InfoAbout.Text).AccountEnabled
Office365Users.Manager(InfoAbout.Text).BusinessPhones
A etiqueta mostra as informações que introduziu sobre o utilizador que especificou ou o gestor desse utilizador.
Nota
Se estiver a desenvolver uma aplicação com base numa tabela no Microsoft Dataverse, pode especificar um utilizador com base no ID, em vez do endereço de e-mail.
Por exemplo, pode criar automaticamente uma aplicação, adicionar um ecrã que contém um controlo de Etiqueta e definir a propriedade Text do controlo como esta fórmula:
Office365Users.UserProfile(BrowseGallery1.Selected.CreatedByUser).DisplayName
Se criar um contacto e selecionar esse contacto no ecrã de procura da aplicação, o controlo de Etiqueta irá mostrar o seu nome a apresentar.
Mostrar os relatórios diretos de outro utilizador
Adicione um controlo Introdução de texto (Menu Inserir > Texto) e mude o nome para InfoAbout.
Em InfoAbout, introduza o endereço de e-mail de um utilizador na sua organização. Por exemplo, introduza oNomeDoSeuGestor@aSuaEmpresa.com
Adicione uma galeria Com texto (Menu Inserir > Galeria) e defina a respetiva propriedade Itens com a seguinte fórmula:
Office365Users.DirectReports(InfoAbout.Text)A galeria mostra informações sobre os relatórios diretos do utilizador que introduziu.
Com a galeria selecionada, o painel do lado direito apresenta opções para essa galeria.
Na segunda lista, selecione JobTitle. Na terceira lista, selecione DisplayName. A galeria é atualizada para mostrar estes valores.
Nota
A primeira caixa é um controlo Imagem. Se não tiver uma imagem, pode eliminar o controlo Imagem e adicionar uma etiqueta em vez daquele. Adicionar e configurar os controlos é um bom recurso.
Procurar utilizadores
Adicione um controlo Introdução de texto (Inserir menu > Introdução de texto).
Selecione Inserir > Galeria vertical.
Altere o esquema da galeria vertical para Título, legenda e corpo.
Selecione o ícone de seta a partir da primeira linha dentro da galeria e elimine-o.
Atualize a fórmula de galeria vertical para o seguinte.
Office365Users.SearchUserV2({searchTerm:TextInput1.Text,top:5}).valueNa fórmula acima, o termo de pesquisa referencia o texto introduzido no controlo Introdução de texto ("TextInput1" neste exemplo); e os resultados da pesquisa estão limitados aos 5 primeiros.
Atualizar os campos da galeria verticais para mostrar DisplayName no título da galeria, JobTitle na legenda e Department no corpo.
Reproduza a aplicação e introduza texto dentro da caixa Introdução de texto. Ao introduzir texto, os resultados são alterados com base nas alterações da cadeia de introdução.
Ver as funções disponíveis
Esta ligação inclui as seguintes funções:
| Nome da Função | Descrição |
|---|---|
| DirectReports | Devolve os relatórios diretos do utilizador especificado. |
| Gestor | Obtém o perfil de utilizador do gestor do utilizador especificado. |
| MyProfile | Obtém o perfil do utilizador atual. |
| SearchUser | Obtém os resultados de pesquisa dos perfis de utilizador. |
| UserProfile | Obtém um perfil de utilizador específico. |
MyProfile
Obter o meu perfil: obtém o perfil do utilizador atual.
Propriedades de entrada
Nenhum.
Propriedades de saída
| Nome de Propriedade | Tipo | Descrição |
|---|---|---|
| Localidade | string | Cidade do utilizador. |
| CompanyName | string | Empresa do utilizador. |
| País | string | País do utilizador. |
| Departamento | string | Departamento do utilizador. |
| DisplayName | string | Nome a apresentar do utilizador. |
| GivenName | string | Nome dado do utilizador. |
| ID | string | ID do Utilizador. |
| JobTitle | string | Cargo do utilizador. |
| Correio | string | ID do e-mail do utilizador. |
| MailNickname | string | Alcunha do utilizador. |
| mobilePhone | string | Telemóvel do utilizador. |
| OfficeLocation | string | Localização do escritório do utilizador. |
| PostalCode | string | Código postal do utilizador. |
| Apelido | string | Apelido do utilizador. |
| TelephoneNumber | string | Número de telefone do utilizador. |
| UserPrincipalName | string | Nome Principal de Utilizador. |
| AccountEnabled | boolean | Sinalizador ativado para conta. |
| BusinessPhones | string | Números de telefone da empresa do utilizador. |
UserProfile
Obter perfil do utilizador: obtém um perfil de utilizador específico.
Propriedades de entrada
| Nome | Tipo de Dados | Necessária | Descrição |
|---|---|---|---|
| ID | string | sim | ID do nome ou e-mail principal do utilizador. |
Propriedades de saída
| Nome de Propriedade | Tipo | Descrição |
|---|---|---|
| Localidade | string | Cidade do utilizador. |
| CompanyName | string | Empresa do utilizador. |
| País | string | País do utilizador. |
| Departamento | string | Departamento do utilizador. |
| DisplayName | string | Nome a apresentar do utilizador. |
| GivenName | string | Nome dado do utilizador. |
| ID | string | ID do Utilizador. |
| JobTitle | string | Cargo do utilizador. |
| Correio | string | ID do e-mail do utilizador. |
| MailNickname | string | Alcunha do utilizador. |
| Apelido | string | Apelido do utilizador. |
| TelephoneNumber | string | Número de telefone do utilizador. |
| UserPrincipalName | string | Nome Principal de Utilizador. |
| AccountEnabled | boolean | Sinalizador ativado para conta. |
| BusinessPhones | string | Números de telefone da empresa do utilizador. |
Gestor
Obter gestor: obtém o perfil de utilizador do gestor do utilizador especificado.
Propriedades de entrada
| Nome | Tipo de Dados | Necessária | Descrição |
|---|---|---|---|
| ID | string | sim | ID do nome ou e-mail principal do utilizador. |
Propriedades de saída
| Nome de Propriedade | Tipo | Descrição |
|---|---|---|
| Localidade | string | Cidade do utilizador. |
| CompanyName | string | Empresa do utilizador. |
| País | string | País do utilizador. |
| Departamento | string | Departamento do utilizador. |
| DisplayName | string | Nome a apresentar do utilizador. |
| GivenName | string | Nome dado do utilizador. |
| ID | string | ID do Utilizador. |
| JobTitle | string | Cargo do utilizador. |
| Correio | string | ID do e-mail do utilizador. |
| MailNickname | string | Alcunha do utilizador. |
| mobilePhone | string | Telemóvel do utilizador. |
| OfficeLocation | string | Localização do escritório do utilizador. |
| PostalCode | string | Código postal do utilizador. |
| Apelido | string | Apelido do utilizador. |
| TelephoneNumber | string | Número de telefone do utilizador. |
| UserPrincipalName | string | Nome Principal de Utilizador. |
| AccountEnabled | boolean | Sinalizador ativado para conta. |
| BusinessPhones | string | Números de telefone da empresa do utilizador. |
DirectReports
Obter relatórios diretos: obtém relatórios diretos.
Propriedades de entrada
| Nome | Tipo de Dados | Necessária | Descrição |
|---|---|---|---|
| ID | string | sim | ID do nome ou e-mail principal do utilizador. |
Propriedades de saída
| Nome de Propriedade | Tipo | Descrição |
|---|---|---|
| Localidade | string | Cidade do utilizador. |
| CompanyName | string | Empresa do utilizador. |
| País | string | País do utilizador. |
| Departamento | string | Departamento do utilizador. |
| DisplayName | string | Nome a apresentar do utilizador. |
| GivenName | string | Nome dado do utilizador. |
| ID | string | ID do Utilizador. |
| JobTitle | string | Cargo do utilizador. |
| Correio | string | ID do e-mail do utilizador. |
| MailNickname | string | Alcunha do utilizador. |
| mobilePhone | string | Telemóvel do utilizador. |
| OfficeLocation | string | Localização do escritório do utilizador. |
| PostalCode | string | Código postal do utilizador. |
| Apelido | string | Apelido do utilizador. |
| TelephoneNumber | string | Número de telefone do utilizador. |
| UserPrincipalName | string | Nome Principal de Utilizador. |
| AccountEnabled | boolean | Sinalizador ativado para conta. |
| BusinessPhones | string | Números de telefone da empresa do utilizador. |
SearchUser
Pesquisar utilizadores: obtém os resultados de pesquisa dos perfis de utilizador.
Propriedades de entrada
| Nome | Tipo de Dados | Necessária | Descrição |
|---|---|---|---|
| searchTerm | string | não | Cadeia de pesquisa. Aplica-se a: nome a apresentar, nome dado, apelido, correio, alcunha do correio e nome principal do utilizador. |
Propriedades de saída
| Nome de Propriedade | Tipo | Descrição |
|---|---|---|
| Localidade | string | Cidade do utilizador. |
| CompanyName | string | Empresa do utilizador. |
| País | string | País do utilizador. |
| Departamento | string | Departamento do utilizador. |
| DisplayName | string | Nome a apresentar do utilizador. |
| GivenName | string | Nome dado do utilizador. |
| ID | string | ID do Utilizador. |
| JobTitle | string | Cargo do utilizador. |
| Correio | string | ID do e-mail do utilizador. |
| MailNickname | string | Alcunha do utilizador. |
| mobilePhone | string | Telemóvel do utilizador. |
| OfficeLocation | string | Localização do escritório do utilizador. |
| PostalCode | string | Código postal do utilizador. |
| Apelido | string | Apelido do utilizador. |
| TelephoneNumber | string | Número de telefone do utilizador. |
| UserPrincipalName | string | Nome Principal de Utilizador. |
| AccountEnabled | boolean | Sinalizador ativado para conta. |
| BusinessPhones | string | Números de telefone da empresa do utilizador. |
Consulte também
- Veja todas as ligações disponíveis.
- Saiba como adicionar ligações às suas aplicações.
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).
Comentários
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja: https://aka.ms/ContentUserFeedback.
Submeter e ver comentários