Herstellen einer Verbindung mit Office 365-Benutzer aus PowerAppsConnect to Office 365 Users connection from PowerApps

Office 365-Benutzer

Office 365-Benutzer bietet Ihnen Zugriff auf Benutzerprofile in Ihrer Organisation mithilfe Ihres Office 365-Kontos.Office 365 Users lets you access user profiles in your organization using your Office 365 account. Sie können verschiedene Aktionen ausführen, z. B. Ihr Profil, das Profil eines Benutzers, den Vorgesetzten oder die direkten Mitarbeiter eines Benutzers abrufen.You can perform various actions such as get your profile, a user's profile, a user's manager or direct reports.

Sie können diese Informationen in einer Bezeichnung in Ihrer App anzeigen.You can display this information in a label on your app. Sie können eine Funktion oder mehrere Funktionen anzeigen und sogar verschiedene Funktionen kombinieren.You can display one function, multiple functions, or even combine different functions. Beispielsweise können Sie einen Ausdruck erstellen, der den Benutzernamen und die Telefonnummer kombiniert, und dann diese Information in der App anzeigen.For example, you can create an expression that combines the User Name and Phone Number, and then display this information in your app.

In diesem Thema wird gezeigt, wie Sie Office 365-Benutzer als Verbindung hinzufügen, Office 365-Benutzer Ihrer App als Datenquelle hinzufügen und wie Sie Tabellendaten in einem Katalogsteuerelement verwenden.This topic shows you how to add Office 365 Users as a connection, add Office 365 Users as a data source to your app, and use table data in a gallery control.

 

What you need to get started

Eine Verbindung hinzufügenAdd a connection

  1. Fügen Sie eine Datenverbindung hinzu, und wählen Sie Office 365-Benutzer aus:Add a data connection and select Office 365 Users:

    Herstellen einer Verbindung mit Office 365

  2. Wählen Sie Verbinden aus, und wenn Sie aufgefordert werden, sich anzumelden, geben Sie Ihr Geschäftskonto ein.Select Connect, and if prompted to sign in, enter your work account.

Die Verbindung mit Office 365-Benutzer wurde erstellt und Ihrer App hinzugefügt.The Office 365 Users connection has been created and added to your app. Sie kann jetzt verwendet werden.Now, it's ready to be used.

Verwenden der Verbindung in der AppUse the connection in your app

Informationen über den aktuellen Benutzer anzeigenShow information about the current user

  1. Wählen Sie im Menü Insert (Einfügen) die Option Label (Bezeichnung) ausOn the Insert menu, select Label
  2. Legen Sie in der Funktionsleiste die Text-Eigenschaft auf eine der folgenden Formeln fest:In the function bar, set its Text property to any of the following formulas:

    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

In der Bezeichnung werden die Informationen über den aktuellen Benutzer angezeigt, die Sie eingegeben haben.The label shows the information that you entered about the current user.

Anzeigen von Informationen zu einem anderen BenutzerShow information about another user

  1. Klicken Sie im Menü Insert (Einfügen) auf Text, und wählen Sie dann Texteingabe (Texteingabe) aus.On the Insert menu, select Text, and then select Text input. Benennen Sie das Steuerelement in InfoAbout um:Rename it InfoAbout:

    Umbenennen des Steuerelements

  2. Geben Sie in InfoAbout eine E-Mail-Adresse eines Benutzers in Ihrer Organisation ein, oder fügen Sie sie ein.In InfoAbout, type or paste an email address of a user in your organization. Geben Sie z. B. IhrName@IhrUnternehmen.com ein.For example, type in yourName@yourCompany.com.
  3. Fügen Sie ein Label (Bezeichnung) hinzu (Menü Einfügen), und legen Sie seine Text-Eigenschaft auf eine der folgenden Formeln fest:Add a Label (Insert menu), and set its Text property to any of the following formulas:

    • So zeigen Sie Informationen zu einem anderen Benutzer an:To show information about another user:

      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

    • So zeigen Sie Informationen zum Vorgesetzten eines anderen Benutzers an:To show information about another user's manager:

      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

In der Bezeichnung werden die Informationen angezeigt, die Sie über den von Ihnen angegebenen Benutzer oder den Vorgesetzten dieses Benutzers eingegeben haben.The label shows the information that you entered about the user you specified or that user's manager.

Hinweis: Wenn Sie eine App basierend auf einer Entität im Common Data Service entwickeln, können Sie einen Benutzer anhand der ID statt anhand der E-Mail-Adresse angeben.Note: If you're developing an app based on an entity in the Common Data Service, you can specify a user based on ID instead of email address.

Beispielsweise können Sie eine App automatisch erstellen, einen Bildschirm hinzufügen, der ein Label-Steuerelement (Bezeichnung) enthält, und die Text-Eigenschaft des Steuerelements auf diese Formel festlegen:For example, you can create an app automatically, add a screen that contains a Label control, and set the control's Text property to this formula:
Office365Users.UserProfile(BrowseGallery1.Selected.CreatedByUser).DisplayNameOffice365Users.UserProfile(BrowseGallery1.Selected.CreatedByUser).DisplayName

Wenn Sie einen Kontakt erstellen und in der App diesen Kontakt im Bildschirm zum Durchsuchen auswählen, wird im Label-Steuerelement (Bezeichnung) der Anzeigename angezeigt.If you create a contact and select that contact in the browse screen of the app, the Label control will show your display name.

Anzeigen der direkt unterstellten Mitarbeiter eines anderen BenutzersShow the direct reports of another user

  1. Fügen Sie ein Texteingabe-Steuerelement hinzu (Menü Insert (Einfügen) > Text > Text input (Texteingabe)), und benennen Sie es in InfoAbout um.Add a Text input control (Insert menu > Text), and rename it InfoAbout.
  2. Geben Sie in InfoAbout die E-Mail-Adresse eines Benutzers in Ihrer Organisation ein.In InfoAbout, enter the email address of a user in your organization. Geben Sie z. B. NameIhresVorgesetzten@IhrUnternehmen.com ein.For example, enter yourManagersName@yourCompany.com
  3. Fügen Sie einen Katalog mit Text hinzu (Menü Insert (Einfügen) > Gallery (Katalog)), und legen Sie dessen Items-Eigenschaft auf die folgende Formel fest:Add a With text gallery (Insert menu > Gallery), and set its Items property to the following formula:

    Office365Users.DirectReports(InfoAbout.Text)

    Im Katalog werden Informationen zu den direkt unterstellten Mitarbeitern des von Ihnen eingegebenen Benutzers angezeigt.The gallery shows information about the direct reports of the user you entered.

    Wenn der Katalog ausgewählt ist, werden im rechten Bereich Optionen für diesen Katalog angezeigt.With the gallery selected, the right-hand pane shows options for that gallery.

  4. Wählen Sie in der zweiten Liste JobTitle aus.In the second list, select JobTitle. Wählen Sie in der dritten Liste DisplayName aus.In the third list, select DisplayName. Der Katalog wird mit diesen Werten aktualisiert.The gallery is updated to show these values.


    HINWEIS: Das erste Feld ist eigentlich eine Bildsteuerung.NOTE The first box is actually an image control. Wenn Sie über kein Bild verfügen, können Sie die Bildsteuerung löschen und stattdessen eine Bezeichnung hinzufügen.If you don't have an image, you can delete the image control, and add a label in its place. Unter Hinzufügen und Konfigurieren von Steuerelementen finden Sie viele hilfreiche Informationen.Add and configure controls is a good resource.

Nach Benutzern suchenSearch for users

  1. Fügen Sie ein Texteingabe-Steuerelement hinzu (Menü Insert (Einfügen) > Text > Text input (Texteingabe)), und benennen Sie es in SearchTerm um.Add a Text input control (Insert menu > Text), and rename it SearchTerm. Geben Sie einen zu suchenden Namen ein.Enter a name to search. Geben Sie beispielsweise Ihren Vornamen ein.For example, enter your first name.
  2. Fügen Sie einen Katalog mit Text hinzu (Menü Insert (Einfügen) > Gallery (Katalog)), und legen Sie dessen Items-Eigenschaft auf die folgende Formel fest:Add a With text gallery (Insert menu > Gallery), and set its Items property to the following formula:

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

    Im Katalog werden Benutzer angezeigt, deren Name den von Ihnen eingegebenen Suchtext enthält.The gallery shows users whose name contains the search text you entered.

    Wenn der Katalog ausgewählt ist, werden im rechten Bereich Optionen für diesen Katalog angezeigt.With the gallery selected, the right-hand pane shows options for that gallery.

  3. Wählen Sie in der zweiten Liste Mail aus.In the second list, select Mail. Wählen Sie in der dritten Liste DisplayName aus.In the third list, select DisplayName.

    Die zweite und dritte Bezeichnung im Katalog werden aktualisiert.The second and third labels in the gallery are updated.

Anzeigen der verfügbaren FunktionenView the available functions

Diese Verbindung umfasst die folgenden Funktionen:This connection includes the following functions:

FunktionsnameFunction Name BeschreibungDescription
MyProfileMyProfile Ruft das Profil für den aktuellen Benutzer ab.Retrieves the profile for the current user
UserProfileUserProfile Ruft ein bestimmtes Benutzerprofil ab.Retrieves a specific user profile
ManagerManager Ruft das Benutzerprofil für den Vorgesetzten des angegebenen Benutzers ab.Retrieves user profile for the manager of the specified user
DirectReportsDirectReports Gibt die direkt unterstellten Mitarbeiter für den angegebenen Benutzer zurück.Returns the direct reports for the specified user
SearchUserSearchUser Ruft die Suchergebnisse von Benutzerprofilen ab.Retrieves search results of user profiles

MyProfileMyProfile

Mein Profil abrufen: Ruft das Profil für den aktuellen Benutzer ab.Get my profile: Retrieves the profile for the current user.

EingabeeigenschaftenInput properties

KeineNone.

AusgabeeigenschaftenOutput properties

EigenschaftsnameProperty Name TypType BeschreibungDescription
DepartmentDepartment Zeichenfolgestring Die Abteilung des BenutzersDepartment of the user.
DisplayNameDisplayName Zeichenfolgestring Der Anzeigename des BenutzersDisplay name of user.
GivenNameGivenName Zeichenfolgestring Der Vorname des BenutzersGiven name of user.
IdId Zeichenfolgestring Die Benutzer-IDUser id
JobTitleJobTitle Zeichenfolgestring Die Position des BenutzersJob Title of the user.
MailMail Zeichenfolgestring Die E-Mail-ID des BenutzersEmail id of user.
MailNicknameMailNickname Zeichenfolgestring Der Spitzname des BenutzersNickname of user.
SurnameSurname Zeichenfolgestring Der Nachname des BenutzersSurname of user.
TelephoneNumberTelephoneNumber Zeichenfolgestring Die Telefonnummer des BenutzersTelephone number of user.
UserPrincipalNameUserPrincipalName Zeichenfolgestring Der BenutzerprinzipalnameUser Principal Name.
AccountEnabledAccountEnabled Booleschboolean Flag für aktiviertes KontoAccount enabled flag.

UserProfileUserProfile

Benutzerprofil abrufen: Ruft ein bestimmtes Benutzerprofil ab.Get user profile: Retrieves a specific user profile.

EingabeeigenschaftenInput properties

NameName DatentypData Type ErforderlichRequired BeschreibungDescription
IdId Zeichenfolgestring jayes Der Prinzipalname oder die E-Mail-ID des BenutzersUser principal name or email id

AusgabeeigenschaftenOutput properties

EigenschaftsnameProperty Name TypType BeschreibungDescription
DepartmentDepartment Zeichenfolgestring Die Abteilung des BenutzersDepartment of the user.
DisplayNameDisplayName Zeichenfolgestring Der Anzeigename des BenutzersDisplay name of user.
GivenNameGivenName Zeichenfolgestring Der Vorname des BenutzersGiven name of user.
IdId Zeichenfolgestring Die Benutzer-IDUser id
JobTitleJobTitle Zeichenfolgestring Die Position des BenutzersJob Title of the user.
MailMail Zeichenfolgestring Die E-Mail-ID des BenutzersEmail id of user.
MailNicknameMailNickname Zeichenfolgestring Der Spitzname des BenutzersNickname of user.
SurnameSurname Zeichenfolgestring Der Nachname des BenutzersSurname of user.
TelephoneNumberTelephoneNumber Zeichenfolgestring Die Telefonnummer des BenutzersTelephone number of user.
UserPrincipalNameUserPrincipalName Zeichenfolgestring Der BenutzerprinzipalnameUser Principal Name.
AccountEnabledAccountEnabled Booleschboolean Flag für aktiviertes KontoAccount enabled flag.

ManagerManager

Vorgesetzten abrufen: Ruft das Benutzerprofil für den Vorgesetzten des angegebenen Benutzers ab.Get manager: Retrieves user profile for the manager of the specified user

EingabeeigenschaftenInput properties

NameName DatentypData Type ErforderlichRequired BeschreibungDescription
IdId Zeichenfolgestring jayes Der Prinzipalname oder die E-Mail-ID des BenutzersUser principal name or email id

AusgabeeigenschaftenOutput properties

EigenschaftsnameProperty Name TypType BeschreibungDescription
DepartmentDepartment Zeichenfolgestring Die Abteilung des BenutzersDepartment of the user.
DisplayNameDisplayName Zeichenfolgestring Der Anzeigename des BenutzersDisplay name of user.
GivenNameGivenName Zeichenfolgestring Der Vorname des BenutzersGiven name of user.
IdId Zeichenfolgestring Die Benutzer-IDUser id
JobTitleJobTitle Zeichenfolgestring Die Position des BenutzersJob Title of the user.
MailMail Zeichenfolgestring Die E-Mail-ID des BenutzersEmail id of user.
MailNicknameMailNickname Zeichenfolgestring Der Spitzname des BenutzersNickname of user.
SurnameSurname Zeichenfolgestring Der Nachname des BenutzersSurname of user.
TelephoneNumberTelephoneNumber Zeichenfolgestring Die Telefonnummer des BenutzersTelephone number of user.
UserPrincipalNameUserPrincipalName Zeichenfolgestring Der BenutzerprinzipalnameUser Principal Name.
AccountEnabledAccountEnabled Booleschboolean Flag für aktiviertes KontoAccount enabled flag.

DirectReportsDirectReports

Get direct reports (Direkt unterstellte Mitarbeiter abrufen): Ruft die direkt unterstellten Mitarbeiter ab.Get direct reports: Get direct reports

EingabeeigenschaftenInput properties

NameName DatentypData Type ErforderlichRequired BeschreibungDescription
IdId Zeichenfolgestring jayes Der Prinzipalname oder die E-Mail-ID des BenutzersUser principal name or email id

AusgabeeigenschaftenOutput properties

EigenschaftsnameProperty Name TypType BeschreibungDescription
DepartmentDepartment Zeichenfolgestring Die Abteilung des BenutzersDepartment of the user.
DisplayNameDisplayName Zeichenfolgestring Der Anzeigename des BenutzersDisplay name of user.
GivenNameGivenName Zeichenfolgestring Der Vorname des BenutzersGiven name of user.
IdId Zeichenfolgestring Die Benutzer-IDUser id
JobTitleJobTitle Zeichenfolgestring Die Position des BenutzersJob Title of the user.
MailMail Zeichenfolgestring Die E-Mail-ID des BenutzersEmail id of user.
MailNicknameMailNickname Zeichenfolgestring Der Spitzname des BenutzersNickname of user.
SurnameSurname Zeichenfolgestring Der Nachname des BenutzersSurname of user.
TelephoneNumberTelephoneNumber Zeichenfolgestring Die Telefonnummer des BenutzersTelephone number of user.
UserPrincipalNameUserPrincipalName Zeichenfolgestring Der BenutzerprinzipalnameUser Principal Name.
AccountEnabledAccountEnabled Booleschboolean Flag für aktiviertes KontoAccount enabled flag.

SearchUserSearchUser

Search for users (Benutzer suchen): Ruft die Suchergebnisse von Benutzerprofilen ab.Search for users: Retrieves search results of user profiles

EingabeeigenschaftenInput properties

NameName DatentypData Type ErforderlichRequired BeschreibungDescription
searchTermsearchTerm Zeichenfolgestring Neinno SuchzeichenfolgeSearch string. Gilt für: Anzeigename, Vorname, Nachname, E-Mail-ID, E-Mail Spitzname und BenutzerprinzipalnameApplies to: display name, given name, surname, mail, mail nickname, and user principal name

AusgabeeigenschaftenOutput properties

EigenschaftsnameProperty Name TypType BeschreibungDescription
DepartmentDepartment Zeichenfolgestring Die Abteilung des BenutzersDepartment of the user.
DisplayNameDisplayName Zeichenfolgestring Der Anzeigename des BenutzersDisplay name of user.
GivenNameGivenName Zeichenfolgestring Der Vorname des BenutzersGiven name of user.
IdId Zeichenfolgestring Die Benutzer-IDUser id
JobTitleJobTitle Zeichenfolgestring Die Position des BenutzersJob Title of the user.
MailMail Zeichenfolgestring Die E-Mail-ID des BenutzersEmail id of user.
MailNicknameMailNickname Zeichenfolgestring Der Spitzname des BenutzersNickname of user.
SurnameSurname Zeichenfolgestring Der Nachname des BenutzersSurname of user.
TelephoneNumberTelephoneNumber Zeichenfolgestring Die Telefonnummer des BenutzersTelephone number of user.
UserPrincipalNameUserPrincipalName Zeichenfolgestring Der BenutzerprinzipalnameUser Principal Name.
AccountEnabledAccountEnabled Booleschboolean Flag für aktiviertes KontoAccount enabled flag.