Office365 Users Connector

Office 365 Users Connector – jede Action im Detail erklärt

Hallo zusammen! Heute möchte ich euch den Office 365 Users Connector vorstellen, ein mächtiges Werkzeug in der Microsoft Power Platform, das speziell für uns Citizen Developer entwickelt wurde.

Der Office 365 Users Connector ermöglicht es uns, auf Benutzerprofile in unserer Organisation zuzugreifen, indem wir unser Office 365-Konto verwenden. Stellt euch vor, ihr könntet verschiedene Aktionen ausführen, wie euer eigenes Profil abrufen, das Profil eines anderen Benutzers, den Manager eines Benutzers oder direkte Berichte und sogar ein Benutzerprofil aktualisieren. Klingt das nicht spannend?

Die Nutzungsmöglichkeiten dieses Connectors sind vielfältig. Ihr könnt ihn beispielsweise verwenden, um eine personalisierte Benutzererfahrung in eurer App zu erstellen, indem ihr auf spezifische Benutzerinformationen zugreift. Oder ihr könnt ihn nutzen, um die Kommunikation und Zusammenarbeit in eurem Team zu verbessern, indem ihr beispielsweise automatisch die Manager oder direkten Berichte eines Benutzers abruft. Ihr könnt sogar automatisierte Prozesse oder Workflows erstellen, die auf bestimmten Benutzerinformationen basieren, wie beispielsweise die Aktualisierung von Benutzerprofilen.

Der Office 365 Users Connector ist ein leistungsstarkes Werkzeug, das uns Citizen Developers hilft, unsere Arbeit effizienter und effektiver zu gestalten. Und das Beste daran ist, dass ihr kein Coding-Experte sein müsst, um ihn zu nutzen. Also, worauf wartet ihr noch? Fangt an, den Office 365 Users Connector in euren Projekten zu nutzen und seht selbst, wie er eure Arbeit erleichtern kann!

Actions

Get manager (V2)

Ausdruck: Manager_V2

Mit dieser Funktion holst du den Manager eines bestimmten Users. Das Profil enthält dann z. B. Name, Position und E-Mail des Vorgesetzten – perfekt, wenn du Freigaben an die nächsthöhere Instanz weiterleiten willst oder Eskalationen automatisieren möchtest. Auch hilfreich bei HR-Prozessen oder bei teambasierten Genehmigungsworkflows.

Manager_V2(
    !User (UPN), //id As string - Benutzerprinzipalname oder -id.
    Select fields, //$select As string - Kommagetrennte Liste der auszuwählenden Felder. Beispiel: Nachname, Abteilung, jobTitle
) = GraphUser_V1 -> {
    About Me, //aboutMe As string - Über mich
    Account enabled?, //accountEnabled As boolean - true, wenn das Konto aktiviert ist; andernfalls false. Diese Eigenschaft ist erforderlich, wennEin Benutzer wird erstellt.
    Birthday, //birthday As date-time - Geburtstag
    Business Phones, //businessPhones As array of string - Business-Telefone
    City, //city As string - Die Stadt, in der sich der Benutzer befindet.
    Company name, //companyName As string - Der Name des Unternehmens, in dem der Benutzer arbeitet.
    Country, //country As string - Das Land/die Region, in dem/der sich der Benutzer befindet; zum Beispiel "US" oder "UK".
    Department, //department As string - Der Name der Abteilung, in der der Benutzer arbeitet.
    Display Name, //displayName As string - Anzeigename
    Given Name, //givenName As string - Vorname
    Hire Date, //hireDate As date-time - Einstellungsdatum
    Id, //id As string - Id
    Interests, //interests As array of string - Interessen
    Job Title, //jobTitle As string - Berufsbezeichnung
    Mail, //mail As string - Post
    Nickname, //mailNickname As string - Der E-Mail-Alias für den Benutzer. Diese Eigenschaft muss angegeben werden, wenn ein Benutzererstellt.
    Mobile Phone, //mobilePhone As string - Mobiltelefon
    My Site, //mySite As string - Meine Seite
    Office Location, //officeLocation As string - Standort des Büros
    Past Projects, //pastProjects As array of string - Vergangene Projekte
    Postal code, //postalCode As string - Die Postleitzahl für die Postanschrift des Benutzers. Die Postleitzahl ist spezifisch fürdas Land/die Region des Benutzers. In den Vereinigten Staaten von Amerika ist dieses Attributenthält die Postleitzahl.
    Preferred Language, //preferredLanguage As string - Bevorzugte Sprache
    Preferred Name, //preferredName As string - Bevorzugter Name
    Responsibilities, //responsibilities As array of string - Verantwortlichkeiten
    Schools, //schools As array of string - Schulen
    Skills, //skills As array of string - Fähigkeiten
    State, //state As string - Zustand
    Street Address, //streetAddress As string - Straße
    Surname, //surname As string - Familienname
    User Principal Name, //userPrincipalName As string - Name des Benutzerprinzipals
    User Type, //userType As string - Benutzertyp
        }

//Ruft das Profil des Vorgesetzten des angegebenen Benutzers ab.Get manager (V2)
GraphUser_V1

Office365Users.ManagerV2("Flowbert@Lowcode.com")

Get my profile (V2)

Ausdruck: MyProfile_V2

Diese Action ist der Klassiker: Du ziehst damit dein eigenes Benutzerprofil direkt aus Microsoft 365. Ideal, wenn du z. B. deinen Namen, E-Mail-Adresse, Position oder Abteilung in einer App anzeigen willst – etwa auf einem Dashboard oder in einem Formular. Dank des selectFields-Parameters kannst du gezielt nur die Daten abfragen, die du brauchst, was deine App deutlich performanter macht.

MyProfile_V2(
    Select fields, //$select As string - Kommagetrennte Liste der auszuwählenden Felder. Beispiel: Nachname, Abteilung, jobTitle
) = GraphUser_V1 -> {
    About Me, //aboutMe As string - Über mich
    Account enabled?, //accountEnabled As boolean - true, wenn das Konto aktiviert ist; andernfalls false. Diese Eigenschaft ist erforderlich, wennEin Benutzer wird erstellt.
    Birthday, //birthday As date-time - Geburtstag
    Business Phones, //businessPhones As array of string - Business-Telefone
    City, //city As string - Die Stadt, in der sich der Benutzer befindet.
    Company name, //companyName As string - Der Name des Unternehmens, in dem der Benutzer arbeitet.
    Country, //country As string - Das Land/die Region, in dem/der sich der Benutzer befindet; zum Beispiel "US" oder "UK".
    Department, //department As string - Der Name der Abteilung, in der der Benutzer arbeitet.
    Display Name, //displayName As string - Anzeigename
    Given Name, //givenName As string - Vorname
    Hire Date, //hireDate As date-time - Einstellungsdatum
    Id, //id As string - Id
    Interests, //interests As array of string - Interessen
    Job Title, //jobTitle As string - Berufsbezeichnung
    Mail, //mail As string - Post
    Nickname, //mailNickname As string - Der E-Mail-Alias für den Benutzer. Diese Eigenschaft muss angegeben werden, wenn ein Benutzererstellt.
    Mobile Phone, //mobilePhone As string - Mobiltelefon
    My Site, //mySite As string - Meine Seite
    Office Location, //officeLocation As string - Standort des Büros
    Past Projects, //pastProjects As array of string - Vergangene Projekte
    Postal code, //postalCode As string - Die Postleitzahl für die Postanschrift des Benutzers. Die Postleitzahl ist spezifisch fürdas Land/die Region des Benutzers. In den Vereinigten Staaten von Amerika ist dieses Attributenthält die Postleitzahl.
    Preferred Language, //preferredLanguage As string - Bevorzugte Sprache
    Preferred Name, //preferredName As string - Bevorzugter Name
    Responsibilities, //responsibilities As array of string - Verantwortlichkeiten
    Schools, //schools As array of string - Schulen
    Skills, //skills As array of string - Fähigkeiten
    State, //state As string - Zustand
    Street Address, //streetAddress As string - Straße
    Surname, //surname As string - Familienname
    User Principal Name, //userPrincipalName As string - Name des Benutzerprinzipals
    User Type, //userType As string - Benutzertyp
        }

//Ruft das Profil des aktuellen Benutzers ab.Get my profile (V2)
GraphUser_V1

Set(
    varUser,
    With(
        Office365Users.MyProfileV2(),
        {
            profil: ThisRecord,
            image: If(
                Office365Users.UserPhotoMetadata(ThisRecord.id).HasPhoto,
                Office365Users.UserPhotoV2(ThisRecord.id),
                SampleImage
            )
        }
    )
)

Get user photo (V2)

Ausdruck: UserPhoto_V2

Damit lädst du das Profilbild eines Benutzers als Binärwert (Base64) herunter. Perfekt für Apps, die Avatare anzeigen sollen – z. B. bei Benutzerkarten, Kommentarfunktionen oder Leaderboards. Kombiniert mit der Metadaten-Abfrage kannst du vorher prüfen, ob überhaupt ein Bild vorhanden ist.

UserPhoto_V2(
    !User (UPN), //id As string - Benutzerprinzipalname oder -id.
) = Binärdatei Inhalt der Bilddatei

//Ruft das Foto des angegebenen Benutzers ab, falls vorhanden.Get user photo (V2)
binary

Set(
    varUser,
    With(
        Office365Users.MyProfileV2(),
        {
            profil: ThisRecord,
            image: If(
                Office365Users.UserPhotoMetadata(ThisRecord.id).HasPhoto,
                Office365Users.UserPhotoV2(ThisRecord.id),
                SampleImage
            )
        }
    )
)

Get user photo metadata

Ausdruck: UserPhotoMetadata

Diese Action verrät dir, ob ein Benutzer überhaupt ein Profilbild hat, und liefert dir zusätzliche Infos wie Bildgröße und Dateiformat. Du kannst damit z. B. Standardbilder einblenden, falls kein echtes Foto vorhanden ist. In Flows kannst du so intelligent zwischen Benutzerbildern und Platzhaltern unterscheiden.

UserPhotoMetadata(
    !User (UPN), //userId As string - Benutzerprinzipalname oder -id.
) = ClientPhotoMetadata -> {
    Has photo, //HasPhoto As boolean - Hat Foto
    Height, //Height As integer - Höhe des Fotos
    Width, //Width As integer - Breite des Fotos
    ContentType, //ContentType As string - Inhalt Art des Fotos
    Image File Extension, //ImageFileExtension As string - Dateierweiterung für das Foto (z. B. ".jpg")
        }

//Abrufen von Metadaten für Benutzerfotos.Get user photo metadata
ClientPhotoMetadata

Set(
    varUser,
    With(
        Office365Users.MyProfileV2(),
        {
            profil: ThisRecord,
            image: If(
                Office365Users.UserPhotoMetadata(ThisRecord.id).HasPhoto,
                Office365Users.UserPhotoV2(ThisRecord.id),
                SampleImage
            )
        }
    )
)

Get user profile (V2)

Ausdruck: UserProfile_V2

Diese Action holt dir das vollständige Benutzerprofil einer beliebigen Person aus Microsoft 365 – also nicht nur dein eigenes. Du musst dafür entweder die UserPrincipalName (UPN) oder die Azure AD-User-ID angeben. Im Gegenzug bekommst du eine strukturierte JSON-Antwort mit allen verfügbaren Profilfeldern: Anzeigename, Jobtitel, Abteilung, Telefonnummern, E-Mail-Adresse, Standort und viele mehr. Genau wie bei „Get my profile (V2)“ kannst du den Rückgabeumfang mit selectFields gezielt einschränken – das macht die Aktion deutlich effizienter.

UserProfile_V2(
    !User (UPN), //id As string - Benutzerprinzipalname oder -id.
    Select fields, //$select As string - Kommagetrennte Liste der auszuwählenden Felder. Beispiel: Nachname, Abteilung, jobTitle
) = GraphUser_V1 -> {
    About Me, //aboutMe As string - Über mich
    Account enabled?, //accountEnabled As boolean - true, wenn das Konto aktiviert ist; andernfalls false. Diese Eigenschaft ist erforderlich, wennEin Benutzer wird erstellt.
    Birthday, //birthday As date-time - Geburtstag
    Business Phones, //businessPhones As array of string - Business-Telefone
    City, //city As string - Die Stadt, in der sich der Benutzer befindet.
    Company name, //companyName As string - Der Name des Unternehmens, in dem der Benutzer arbeitet.
    Country, //country As string - Das Land/die Region, in dem/der sich der Benutzer befindet; zum Beispiel "US" oder "UK".
    Department, //department As string - Der Name der Abteilung, in der der Benutzer arbeitet.
    Display Name, //displayName As string - Anzeigename
    Given Name, //givenName As string - Vorname
    Hire Date, //hireDate As date-time - Einstellungsdatum
    Id, //id As string - Id
    Interests, //interests As array of string - Interessen
    Job Title, //jobTitle As string - Berufsbezeichnung
    Mail, //mail As string - Post
    Nickname, //mailNickname As string - Der E-Mail-Alias für den Benutzer. Diese Eigenschaft muss angegeben werden, wenn ein Benutzererstellt.
    Mobile Phone, //mobilePhone As string - Mobiltelefon
    My Site, //mySite As string - Meine Seite
    Office Location, //officeLocation As string - Standort des Büros
    Past Projects, //pastProjects As array of string - Vergangene Projekte
    Postal code, //postalCode As string - Die Postleitzahl für die Postanschrift des Benutzers. Die Postleitzahl ist spezifisch fürdas Land/die Region des Benutzers. In den Vereinigten Staaten von Amerika ist dieses Attributenthält die Postleitzahl.
    Preferred Language, //preferredLanguage As string - Bevorzugte Sprache
    Preferred Name, //preferredName As string - Bevorzugter Name
    Responsibilities, //responsibilities As array of string - Verantwortlichkeiten
    Schools, //schools As array of string - Schulen
    Skills, //skills As array of string - Fähigkeiten
    State, //state As string - Zustand
    Street Address, //streetAddress As string - Straße
    Surname, //surname As string - Familienname
    User Principal Name, //userPrincipalName As string - Name des Benutzerprinzipals
    User Type, //userType As string - Benutzertyp
        }

//Ruft das Profil eines bestimmten Benutzers ab.Get user profile (V2)
GraphUser_V1

IfError(
    Office365Users.UserProfileV2("CodeyKlick@Lowcode.com").mobilePhone,
    Blank()
)

Office365 Users Connector

Themen