Connettersi a Utenti di Office 365 da Power Apps
Utenti di Office 365 ti consente di accedere ai profili utente dell'organizzazione usando l'account Office 365. Puoi eseguire diverse azioni, ad esempio ottenere il tuo profilo, il profilo di un utente, il manager di un utente o i subalterni.
Puoi visualizzare queste informazioni in un'etichetta nell'app. Puoi visualizzare una o più funzioni o combinare diverse funzioni. Puoi, ad esempio, creare un'espressione che combina il nome dell'utente e il suo numero di telefono e quindi visualizzare queste informazioni nell'app.
Questo articolo illustra come aggiungere Utenti di Office 365 come connessione, aggiungere utenti di Office 365 come origine dati alla propria app e come usare i dati di tabella in un controllo di tipo raccolta.
Prerequisiti
- Accesso a Power Apps
- Aggiungere la connessione
- Creare un'app da un modello, da dati o da zero
Aggiungi una connessione
Aggiungi una connessione dati e seleziona Utenti di Office 365:
Selezionare Connetti e, se viene richiesto di accedere, inserire il proprio account aziendale.
La connessione Utenti di Office 365 è stata creata e aggiunta all'app. La connessione è ora pronta per l'uso.
Usare la connessione nell'app
Mostrare informazioni sull'utente corrente
Nel menu Inserisci seleziona Etichetta
Nella barra delle funzioni imposta la proprietà Text su una delle formule seguenti:
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
L'etichetta contiene le informazioni immesse in relazione all'utente corrente.
Mostrare informazioni relative a un altro utente
Nel menu Inserisci seleziona Testo e quindi Input di testo. Assegna al controllo il nome InfoAbout:
In InfoAbout digita o incolla l'indirizzo di posta elettronica di un utente dell'organizzazione. Ad esempio, digita nomeUtente@nomeAzienda.com.
Aggiungi un controllo Etichetta (menu Inserisci) e impostane la proprietà Text su una delle formule seguenti:
Per mostrare informazioni relative a un altro utente:
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).BusinessPhones
Per mostrare informazioni sul manager di un altro utente:
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
L'etichetta contiene le informazioni immesse in relazione all'utente specificato o al manager di tale utente.
Nota
Se stai sviluppando un'applicazione basata su una tabella in Microsoft Dataverse, è possibile specificare un utente in base all'ID anziché all'indirizzo e-mail.
Ad esempio, puoi creare un'app automaticamente, aggiungere una schermata contenente un controllo Etichetta e impostare la proprietà Text di tale controllo sulla formula seguente:
Office365Users.UserProfile(BrowseGallery1.Selected.CreatedByUser).DisplayName
Se crei un contatto e selezioni tale contatto nella schermata di navigazione dell'applicazione, il controllo Etichetta mostrerà il nome visualizzato.
Visualizzare i dipendenti diretti di un altro utente
Aggiungi un controllo Input di testo (menu Inserisci > Testo) e assegnagli il nome InfoAbout.
In InfoAbout digita l'indirizzo di posta elettronica di un utente dell'organizzazione. Ad esempio, immetti nomeManager@nomeAzienda.com
Aggiungi una raccolta Con testo (menu Inserisci > Raccolta) e impostane la proprietà Items sulla formula seguente:
Office365Users.DirectReports(InfoAbout.Text)
La raccolta mostra le informazioni sui subalterni dell'utente immesso.
Se la raccolta è selezionata, il riquadro di destra visualizza le opzioni relative alla raccolta stessa.
Nel secondo elenco seleziona JobTitle. Nel terzo elenco seleziona DisplayName. La raccolta viene aggiornata per mostrare tali valori.
Nota
La prima casella è in realtà un controllo di tipo immagine. Se non hai un'immagine, puoi eliminare il controllo e aggiungere al suo posto un'etichetta. La capacità di aggiungere e configurare controlli è una risorsa valida.
Cercare utenti
Aggiungere un controllo Input di testo (menu Inserisci > Input di testo).
Seleziona Inserisci > Raccolta verticale.
Imposta il layout della raccolta verticale su Titolo, sottotitolo e corpo.
Seleziona l'icona freccia dalla prima riga nella raccolta ed eliminala.
Aggiorna la formula della raccolta verticale come segue.
Office365Users.SearchUserV2({searchTerm:TextInput1.Text,top:5}).value
Nella formula sopra, il termine di ricerca fa riferimento al testo immesso nel controllo Input di testo ("TextInput1" in questo esempio); e i risultati della ricerca sono limitati ai primi 5.
Aggiorna i campi della raccolta verticale per mostrare DisplayName nel titolo della raccolta, JobTitle nel sottotitolo e Department nel corpo.
Esegui l'app e immetti il testo nella casella di input di testo. Quando immetti il testo, i risultati cambiano in base alle modifiche della stringa di input.
Visualizzare le funzioni disponibili
Questa connessione include le funzioni seguenti:
Nome funzione | Descrizione |
---|---|
DirectReports | Restituisce i subalterni dell'utente specificato. |
Responsabile | Recupera il profilo utente del manager dell'utente specificato. |
MyProfile | Recupera il profilo dell'utente corrente. |
SearchUser | Recupera i risultati di ricerca dei profili utente. |
UserProfile | Recupera il profilo di un utente specifico. |
MyProfile
Recupera profilo dell'utente corrente: recupera il profilo dell'utente corrente.
Proprietà di input
Nessuna.
Proprietà di output
Nome proprietà | Tipo | Descrizione |
---|---|---|
Città | string | Città dell'utente. |
CompanyName | string | Società dell'utente. |
Paese | string | Paese dell'utente. |
Reparto | string | Reparto dell'utente. |
DisplayName | string | Nome visualizzato dell'utente. |
GivenName | string | Nome specificato dell'utente. |
ID | string | ID utente. |
JobTitle | string | Posizione dell'utente. |
Posta | string | ID di posta elettronica dell'utente. |
MailNickname | string | Nome alternativo dell'utente. |
mobilePhone | string | Numero di cellulare dell'utente. |
OfficeLocation | string | Sede di lavoro dell'utente. |
PostalCode | string | Codice postale dell'utente. |
Surname | string | Cognome dell'utente. |
TelephoneNumber | string | Numero di telefono dell'utente. |
UserPrincipalName | string | Nome dell'entità utente. |
AccountEnabled | boolean | Flag di abilitazione dell'account. |
BusinessPhones | string | Numeri di telefono aziendali dell'utente. |
UserProfile
Recupera il profilo utente: recupera un profilo utente specifico.
Proprietà di input
Nome | Tipo di dati | Necessari | Descrizione |
---|---|---|---|
ID | string | sì | Nome dell'entità utente o ID di posta elettronica. |
Proprietà di output
Nome proprietà | Tipo | Descrizione |
---|---|---|
Città | string | Città dell'utente. |
CompanyName | string | Società dell'utente. |
Paese | string | Paese dell'utente. |
Reparto | string | Reparto dell'utente. |
DisplayName | string | Nome visualizzato dell'utente. |
GivenName | string | Nome specificato dell'utente. |
ID | string | ID utente. |
JobTitle | string | Posizione dell'utente. |
Posta | string | ID di posta elettronica dell'utente. |
MailNickname | string | Nome alternativo dell'utente. |
Surname | string | Cognome dell'utente. |
TelephoneNumber | string | Numero di telefono dell'utente. |
UserPrincipalName | string | Nome dell'entità utente. |
AccountEnabled | boolean | Flag di abilitazione dell'account. |
BusinessPhones | string | Numeri di telefono aziendali dell'utente. |
Responsabile
Recupera il responsabile: recupera il profilo utente del manager dell'utente specificato.
Proprietà di input
Nome | Tipo di dati | Necessari | Descrizione |
---|---|---|---|
ID | string | sì | Nome dell'entità utente o ID di posta elettronica. |
Proprietà di output
Nome proprietà | Tipo | Descrizione |
---|---|---|
Città | string | Città dell'utente. |
CompanyName | string | Società dell'utente. |
Paese | string | Paese dell'utente. |
Reparto | string | Reparto dell'utente. |
DisplayName | string | Nome visualizzato dell'utente. |
GivenName | string | Nome specificato dell'utente. |
ID | string | ID utente. |
JobTitle | string | Posizione dell'utente. |
Posta | string | ID di posta elettronica dell'utente. |
MailNickname | string | Nome alternativo dell'utente. |
mobilePhone | string | Numero di cellulare dell'utente. |
OfficeLocation | string | Sede di lavoro dell'utente. |
PostalCode | string | Codice postale dell'utente. |
Surname | string | Cognome dell'utente. |
TelephoneNumber | string | Numero di telefono dell'utente. |
UserPrincipalName | string | Nome dell'entità utente. |
AccountEnabled | boolean | Flag di abilitazione dell'account. |
BusinessPhones | string | Numeri di telefono aziendali dell'utente. |
DirectReports
Recupera i subalterni: ottieni i subalterni.
Proprietà di input
Nome | Tipo di dati | Necessari | Descrizione |
---|---|---|---|
ID | string | sì | Nome dell'entità utente o ID di posta elettronica. |
Proprietà di output
Nome proprietà | Tipo | Descrizione |
---|---|---|
Città | string | Città dell'utente. |
CompanyName | string | Società dell'utente. |
Paese | string | Paese dell'utente. |
Reparto | string | Reparto dell'utente. |
DisplayName | string | Nome visualizzato dell'utente. |
GivenName | string | Nome specificato dell'utente. |
ID | string | ID utente. |
JobTitle | string | Posizione dell'utente. |
Posta | string | ID di posta elettronica dell'utente. |
MailNickname | string | Nome alternativo dell'utente. |
mobilePhone | string | Numero di cellulare dell'utente. |
OfficeLocation | string | Sede di lavoro dell'utente. |
PostalCode | string | Codice postale dell'utente. |
Surname | string | Cognome dell'utente. |
TelephoneNumber | string | Numero di telefono dell'utente. |
UserPrincipalName | string | Nome dell'entità utente. |
AccountEnabled | boolean | Flag di abilitazione dell'account. |
BusinessPhones | string | Numeri di telefono aziendali dell'utente. |
SearchUser
Cerca utenti: recupera i risultati di ricerca dei profili utente.
Proprietà di input
Nome | Tipo di dati | Necessari | Descrizione |
---|---|---|---|
searchTerm | string | no | Stringa di ricerca. Si applica a: nome visualizzato, nome, cognome, posta elettronica, nome alternativo di posta elettronica e nome dell'entità utente. |
Proprietà di output
Nome proprietà | Tipo | Descrizione |
---|---|---|
Città | string | Città dell'utente. |
CompanyName | string | Società dell'utente. |
Paese | string | Paese dell'utente. |
Reparto | string | Reparto dell'utente. |
DisplayName | string | Nome visualizzato dell'utente. |
GivenName | string | Nome specificato dell'utente. |
ID | string | ID utente. |
JobTitle | string | Posizione dell'utente. |
Posta | string | ID di posta elettronica dell'utente. |
MailNickname | string | Nome alternativo dell'utente. |
mobilePhone | string | Numero di cellulare dell'utente. |
OfficeLocation | string | Sede di lavoro dell'utente. |
PostalCode | string | Codice postale dell'utente. |
Surname | string | Cognome dell'utente. |
TelephoneNumber | string | Numero di telefono dell'utente. |
UserPrincipalName | string | Nome dell'entità utente. |
AccountEnabled | boolean | Flag di abilitazione dell'account. |
BusinessPhones | stringa | Numeri di telefono aziendali dell'utente. |
Vedi anche
- Vedi tutte le connessioni disponibili.
- Informazioni su come aggiungere connessioni alle app.
Nota
Puoi indicarci le tue preferenze di lingua per la documentazione? Partecipa a un breve sondaggio. (il sondaggio è in inglese)
Il sondaggio richiederà circa sette minuti. Non viene raccolto alcun dato personale (Informativa sulla privacy).