Utenti di Office 365

Utenti di Office 365 consente di accedere ai profili utente dell'organizzazione usando l'account Office 365. È possibile eseguire diverse azioni, ad esempio ottenere il proprio profilo, il profilo di un utente, il manager di un utente o i dipendenti diretti.

È possibile visualizzare queste informazioni in una casella di testo nell'app. È possibile visualizzare una o più funzioni o combinare diverse funzioni. È possibile, 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 argomento 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.

 

Elementi necessari per iniziare

Aggiungere una connessione

  1. Aggiungere una connessione dati e selezionare Utenti di Office 365:

    Connettersi a Office 365

  2. Selezionare Connect (Connetti) e, se viene richiesto di effettuare l'accesso, immettere l'account aziendale.

La connessione Utenti di Office 365 è stata creata e aggiunta all'app. Tale connessione è ora pronta per l'uso.

Usare la connessione nell'app

Mostrare informazioni sull'utente corrente

  1. Nel menu Insert (Inserisci) selezionare Text box (Casella di testo)
  2. Nella barra delle funzioni impostare la proprietà Text su una delle formule seguenti:

    Office365Users.MyProfile().Department
    Office365Users.MyProfile().DisplayName
    Office365Users.MyProfile().GivenName
    Office365Users.MyProfile().Id
    Office365Users.MyProfile().JobTitle
    Office365Users.MyProfile().Mail
    Office365Users.MyProfile().MailNickname
    Office365Users.MyProfile().Surname
    Office365Users.MyProfile().TelephoneNumber
    Office365Users.MyProfile().UserPrincipalName
    Office365Users.MyProfile().AccountEnabled

La casella di testo contiene le informazioni immesse in relazione all'utente corrente.

Mostrare informazioni relative a un altro utente

  1. Nel menu Insert (Inserisci) selezionare Text e quindi Text input (Input di testo). Assegnare al controllo il nome InfoAbout:

    Rinominare controllo

  2. In InfoAbout digitare o incollare l'indirizzo di posta elettronica di un utente dell'organizzazione. Ad esempio, digitare NomeUtente@NomeAzienda.com.

  3. Aggiungere un controllo Text box (Casella di testo) (menu Insert (Inserisci)) e impostarne la proprietà Text su una delle formule seguenti:

    • Per mostrare informazioni relative a un altro utente:

      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).Surname
      Office365Users.UserProfile(InfoAbout.Text).TelephoneNumber
      Office365Users.UserProfile(InfoAbout.Text).UserPrincipalName
      Office365Users.UserProfile(InfoAbout.Text).AccountEnabled

    • Per mostrare informazioni sul manager di un altro utente:

      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).Surname
      Office365Users.Manager(InfoAbout.Text).TelephoneNumber
      Office365Users.Manager(InfoAbout.Text).UserPrincipalName
      Office365Users.Manager(InfoAbout.Text).AccountEnabled

La casella di testo contiene le informazioni immesse in relazione all'utente specificato o al manager di tale utente.

Nota: se si sta sviluppando un'applicazione basata su un'entità di Common Data Service, è possibile specificare un utente in base all'ID anziché all'indirizzo di posta elettronica.

Ad esempio, è possibile creare un'app automaticamente, aggiungere una schermata contenente un controllo Text box (Casella di testo) e impostare la proprietà Text di tale controllo sulla formula seguente:
Office365Users.UserProfile(BrowseGallery1.Selected.CreatedByUser).DisplayName

Se si crea un contatto e si seleziona tale contatto nella schermata di navigazione dell'applicazione, il controllo Text box (Casella di testo) mostrerà il nome visualizzato.

Visualizzare i dipendenti diretti di un altro utente

  1. Aggiungere un controllo di tipo Text input (Input di testo) (menu Insert (Inserisci) > Text) e assegnargli il nome InfoAbout.

  2. In InfoAbout digitare l'indirizzo di posta elettronica di un utente dell'organizzazione. Ad esempio, immettere NomeManager@NomeAzienda.com

  3. Aggiungere una raccolta With text (Con testo) (menu Insert (Inserisci) > Gallery) e impostarne la proprietà Items sulla formula seguente:

    Office365Users.DirectReports(InfoAbout.Text)

    La raccolta riporta informazioni sui dipendenti diretti dell'utente immesso.

    Se la raccolta è selezionata, il riquadro di destra visualizza le opzioni relative alla raccolta stessa.

  4. Nel secondo elenco selezionare JobTitle. Nel terzo elenco selezionare DisplayName. La raccolta viene aggiornata per mostrare tali valori.


    NOTA La prima casella è in realtà un controllo di tipo immagine. Se non si dispone di un'immagine, è possibile eliminare il controllo e aggiungere al suo posto una casella di testo. La capacità di aggiungere e configurare controlli è una risorsa valida.

Cercare utenti

  1. Aggiungere un controllo di tipo Text input (Input di testo) (menu Insert (Inserisci) > Text) e assegnargli il nome SearchTerm. Immettere un nome da cercare. Ad esempio, immettere il proprio nome.

  2. Aggiungere una raccolta With text (Con testo) (menu Insert (Inserisci) > Gallery) e impostarne la proprietà Items sulla formula seguente:

    Office365Users.SearchUser({searchTerm: SearchTerm.Text})

    La raccolta mostra gli utenti il cui nome contiene il testo di ricerca immesso.

    Se la raccolta è selezionata, il riquadro di destra visualizza le opzioni relative alla raccolta stessa.

  3. Nel secondo elenco selezionare Mail. Nel terzo elenco selezionare DisplayName.

    La seconda e la terza casella della raccolta vengono aggiornate.

Visualizzare le funzioni disponibili

Questa connessione include le funzioni seguenti:

Nome della funzione Descrizione
MyProfile Recupera il profilo dell'utente corrente
UserProfile Recupera un profilo utente specifico
Manager Recupera il profilo utente del manager dell'utente specificato
DirectReports Restituisce i dipendenti diretti relativi all'utente specificato
SearchUser Recupera i risultati di ricerca dei profili utente

MyProfile

Get my profile (Recupera profilo dell'utente corrente): recupera il profilo dell'utente corrente.

Proprietà di input

Nessuna.

Proprietà di output

Nome della proprietà Tipo Descrizione
Department stringa Reparto dell'utente.
DisplayName stringa Nome visualizzato dell'utente.
GivenName stringa Nome dell'utente.
Id stringa ID dell'utente.
JobTitle stringa Qualifica professionale dell'utente.
Mail stringa ID di posta elettronica dell'utente.
MailNickname stringa Nome alternativo dell'utente.
Surname stringa Cognome dell'utente.
TelephoneNumber stringa Numero di telefono dell'utente.
UserPrincipalName stringa Nome dell'entità utente.
AccountEnabled valore booleano Flag di abilitazione dell'account.

UserProfile

Get user profile (Recupera il profilo utente): recupera un profilo utente specifico.

Proprietà di input

Nome Tipo di dati Obbligatorio Descrizione
Id stringa Nome dell'entità utente o ID di posta elettronica.

Proprietà di output

Nome della proprietà Tipo Descrizione
Department stringa Reparto dell'utente.
DisplayName stringa Nome visualizzato dell'utente.
GivenName stringa Nome dell'utente.
Id stringa ID dell'utente.
JobTitle stringa Qualifica professionale dell'utente.
Mail stringa ID di posta elettronica dell'utente.
MailNickname stringa Nome alternativo dell'utente.
Surname stringa Cognome dell'utente.
TelephoneNumber stringa Numero di telefono dell'utente.
UserPrincipalName stringa Nome dell'entità utente.
AccountEnabled valore booleano Flag di abilitazione dell'account.

Manager

Get manager (Recupera il responsabile): recupera il profilo utente del manager dell'utente specificato

Proprietà di input

Nome Tipo di dati Obbligatorio Descrizione
Id stringa Nome dell'entità utente o ID di posta elettronica.

Proprietà di output

Nome della proprietà Tipo Descrizione
Department stringa Reparto dell'utente.
DisplayName stringa Nome visualizzato dell'utente.
GivenName stringa Nome dell'utente.
Id stringa ID dell'utente.
JobTitle stringa Qualifica professionale dell'utente.
Mail stringa ID di posta elettronica dell'utente.
MailNickname stringa Nome alternativo dell'utente.
Surname stringa Cognome dell'utente.
TelephoneNumber stringa Numero di telefono dell'utente.
UserPrincipalName stringa Nome dell'entità utente.
AccountEnabled valore booleano Flag di abilitazione dell'account.

DirectReports

Get direct reports (Ottieni dipendenti diretti): ottiene i dipendenti diretti

Proprietà di input

Nome Tipo di dati Obbligatorio Descrizione
Id stringa Nome dell'entità utente o ID di posta elettronica.

Proprietà di output

Nome della proprietà Tipo Descrizione
Department stringa Reparto dell'utente.
DisplayName stringa Nome visualizzato dell'utente.
GivenName stringa Nome dell'utente.
Id stringa ID dell'utente.
JobTitle stringa Qualifica professionale dell'utente.
Mail stringa ID di posta elettronica dell'utente.
MailNickname stringa Nome alternativo dell'utente.
Surname stringa Cognome dell'utente.
TelephoneNumber stringa Numero di telefono dell'utente.
UserPrincipalName stringa Nome dell'entità utente.
AccountEnabled valore booleano Flag di abilitazione dell'account.

SearchUser

Search for users (Cerca utenti): recupera i risultati di ricerca dei profili utente

Proprietà di input

Nome Tipo di dati Obbligatorio Descrizione
searchTerm stringa 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 della proprietà Tipo Descrizione
Department stringa Reparto dell'utente.
DisplayName stringa Nome visualizzato dell'utente.
GivenName stringa Nome dell'utente.
Id stringa ID dell'utente.
JobTitle stringa Qualifica professionale dell'utente.
Mail stringa ID di posta elettronica dell'utente.
MailNickname stringa Nome alternativo dell'utente.
Surname stringa Cognome dell'utente.
TelephoneNumber stringa Numero di telefono dell'utente.
UserPrincipalName stringa Nome dell'entità utente.
AccountEnabled valore booleano Flag di abilitazione dell'account.

Collegamenti utili