Connettersi a Utenti di Office 365 da Power Apps

Utenti di Office 365.

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

Aggiungi una connessione

  1. Aggiungi una connessione dati e seleziona Utenti di Office 365:

    Connettersi a Office 365.

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

  1. Nel menu Inserisci seleziona Etichetta

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

  1. Nel menu Inserisci seleziona Testo e quindi Input di testo. Assegna al controllo il nome InfoAbout:

    Rinomina il controllo.

  2. In InfoAbout digita o incolla l'indirizzo di posta elettronica di un utente dell'organizzazione. Ad esempio, digita nomeUtente@nomeAzienda.com.

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

  1. Aggiungi un controllo Input di testo (menu Inserisci > Testo) e assegnagli il nome InfoAbout.

  2. In InfoAbout digita l'indirizzo di posta elettronica di un utente dell'organizzazione. Ad esempio, immetti nomeManager@nomeAzienda.com

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

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

  1. Aggiungere un controllo Input di testo (menu Inserisci > Input di testo).

  2. Seleziona Inserisci > Raccolta verticale.

  3. Imposta il layout della raccolta verticale su Titolo, sottotitolo e corpo.

  4. Seleziona l'icona freccia dalla prima riga nella raccolta ed eliminala.

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

  6. Aggiorna i campi della raccolta verticale per mostrare DisplayName nel titolo della raccolta, JobTitle nel sottotitolo e Department nel corpo.

    Campi della raccolta selezionati.

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

    Esempio di ricerca.

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

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