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 direct reports (V1) [DEPRECATED]
Ausdruck: DirectReports
DirectReports( !User (UPN), //userId As string - Benutzerprinzipalname oder -id. ) = User -> { User id, //Id As string - Ein eindeutiger Bezeichner für das Benutzerobjekt im Verzeichnis. Account enabled?, //AccountEnabled As boolean - true, wenn das Konto aktiviert ist; andernfalls false. Diese Eigenschaft ist erforderlich, wennEin Benutzer wird erstellt. Business phones, //BusinessPhones As array of string - Eine Liste der geschäftlichen Telefonnummern für den Benutzer 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 - Der Name, der im Adressbuch des Benutzers angezeigt wird. Dies ist in der Regel dieKombination aus Vorname, zweiter Initiale und Nachname des Benutzers. Das-Eigenschaft ist erforderlich, wenn ein Benutzer erstellt wird, und kann während derAktualisierungen. Given name, //GivenName As string - Der Vorname (Vorname) des Benutzers. Job title, //JobTitle As string - Die Berufsbezeichnung des Benutzers. Email, //Mail As string - Die SMTP-/E-Mail-Adresse des Benutzers, z. B."jeff@contoso.onmicrosoft.com". Schreibgeschützt. Nickname, //MailNickname As string - Der E-Mail-Alias für den Benutzer. Diese Eigenschaft muss angegeben werden, wenn ein Benutzererstellt. Office location, //OfficeLocation As string - Der Bürostandort am Geschäftssitz des Benutzers. 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. Surname, //Surname As string - Der Nachname des Benutzers (Nachname oder Nachname). Telephone number, //TelephoneNumber As string - Die primäre Mobiltelefonnummer für den Benutzer. User Principal Name (UPN), //UserPrincipalName As string - Der Benutzerprinzipalname (UPN) des Benutzers. Der UPN ist eine Anmeldung im Internet-StilName für den Benutzer basierend auf dem Internetstandard RFC 822. Gemäß der Konventionsollte dem E-Mail-Namen des Benutzers zugeordnet werden. Das allgemeine Format ist alias@domain, wobeiDomäne muss in der Sammlung der überprüften Domänen des Mandanten vorhanden sein. } //Diese Aktion ist veraltet.
Get direct reports (V1) [DEPRECATED]
array of User
!!! In Arbeit !!!
Get direct reports (V2)
Ausdruck: DirectReports_V2
Diese Action liefert dir alle Benutzer, die einem bestimmten User direkt unterstellt sind. Ob du eine Teamübersicht bauen willst oder wissen musst, wem du Aufgaben zuweisen kannst – hiermit bekommst du eine Liste mit vollständigen Profilinformationen, direkt aus dem Active Directory. Kombiniert mit Rollenlogik lassen sich damit auch Führungsspannen visualisieren.
DirectReports_V2(
!User (UPN), //id As string - Benutzerprinzipalname oder -id.
Select fields, //$select As string - Kommagetrennte Liste der auszuwählenden Felder. Beispiel: Nachname, Abteilung, jobTitle
Top, //$top As integer - Begrenzung der Anzahl der zurückzugebenden Ergebnisse. Standardmäßig werden alle Einträge zurückgegeben.
) -> {
value, //value As array of GraphUser_V1 - Wert
}
//Ruft die Benutzerprofile der direkten Mitarbeiter des angegebenen Benutzers ab.
Get direct reports (V2)
!!! In Arbeit !!!
Get manager (V1) [DEPRECATED]
Ausdruck: Manager
Manager( !User (UPN), //userId As string - Benutzerprinzipalname oder -id. ) = User -> { User id, //Id As string - Ein eindeutiger Bezeichner für das Benutzerobjekt im Verzeichnis. Account enabled?, //AccountEnabled As boolean - true, wenn das Konto aktiviert ist; andernfalls false. Diese Eigenschaft ist erforderlich, wennEin Benutzer wird erstellt. Business phones, //BusinessPhones As array of string - Eine Liste der geschäftlichen Telefonnummern für den Benutzer 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 - Der Name, der im Adressbuch des Benutzers angezeigt wird. Dies ist in der Regel dieKombination aus Vorname, zweiter Initiale und Nachname des Benutzers. Das-Eigenschaft ist erforderlich, wenn ein Benutzer erstellt wird, und kann während derAktualisierungen. Given name, //GivenName As string - Der Vorname (Vorname) des Benutzers. Job title, //JobTitle As string - Die Berufsbezeichnung des Benutzers. Email, //Mail As string - Die SMTP-/E-Mail-Adresse des Benutzers, z. B."jeff@contoso.onmicrosoft.com". Schreibgeschützt. Nickname, //MailNickname As string - Der E-Mail-Alias für den Benutzer. Diese Eigenschaft muss angegeben werden, wenn ein Benutzererstellt. Office location, //OfficeLocation As string - Der Bürostandort am Geschäftssitz des Benutzers. 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. Surname, //Surname As string - Der Nachname des Benutzers (Nachname oder Nachname). Telephone number, //TelephoneNumber As string - Die primäre Mobiltelefonnummer für den Benutzer. User Principal Name (UPN), //UserPrincipalName As string - Der Benutzerprinzipalname (UPN) des Benutzers. Der UPN ist eine Anmeldung im Internet-StilName für den Benutzer basierend auf dem Internetstandard RFC 822. Gemäß der Konventionsollte dem E-Mail-Namen des Benutzers zugeordnet werden. Das allgemeine Format ist alias@domain, wobeiDomäne muss in der Sammlung der überprüften Domänen des Mandanten vorhanden sein. } //Diese Aktion ist veraltet.
Get manager (V1) [DEPRECATED]
User
!!! In Arbeit !!!
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 (V1) [DEPRECATED]
Ausdruck: MyProfile
MyProfile( ) = User -> { User id, //Id As string - Ein eindeutiger Bezeichner für das Benutzerobjekt im Verzeichnis. Account enabled?, //AccountEnabled As boolean - true, wenn das Konto aktiviert ist; andernfalls false. Diese Eigenschaft ist erforderlich, wennEin Benutzer wird erstellt. Business phones, //BusinessPhones As array of string - Eine Liste der geschäftlichen Telefonnummern für den Benutzer 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 - Der Name, der im Adressbuch des Benutzers angezeigt wird. Dies ist in der Regel dieKombination aus Vorname, zweiter Initiale und Nachname des Benutzers. Das-Eigenschaft ist erforderlich, wenn ein Benutzer erstellt wird, und kann während derAktualisierungen. Given name, //GivenName As string - Der Vorname (Vorname) des Benutzers. Job title, //JobTitle As string - Die Berufsbezeichnung des Benutzers. Email, //Mail As string - Die SMTP-/E-Mail-Adresse des Benutzers, z. B."jeff@contoso.onmicrosoft.com". Schreibgeschützt. Nickname, //MailNickname As string - Der E-Mail-Alias für den Benutzer. Diese Eigenschaft muss angegeben werden, wenn ein Benutzererstellt. Office location, //OfficeLocation As string - Der Bürostandort am Geschäftssitz des Benutzers. 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. Surname, //Surname As string - Der Nachname des Benutzers (Nachname oder Nachname). Telephone number, //TelephoneNumber As string - Die primäre Mobiltelefonnummer für den Benutzer. User Principal Name (UPN), //UserPrincipalName As string - Der Benutzerprinzipalname (UPN) des Benutzers. Der UPN ist eine Anmeldung im Internet-StilName für den Benutzer basierend auf dem Internetstandard RFC 822. Gemäß der Konventionsollte dem E-Mail-Namen des Benutzers zugeordnet werden. Das allgemeine Format ist alias@domain, wobeiDomäne muss in der Sammlung der überprüften Domänen des Mandanten vorhanden sein. } //Diese Aktion ist veraltet.
Get my profile (V1) [DEPRECATED]
User
!!! In Arbeit !!!
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 my trending documents
Ausdruck: MyTrendingDocuments
Diese Funktion analysiert, welche Dokumente in deinem Arbeitsumfeld gerade „heiß“ sind. Das basiert auf Nutzungsdaten aus Microsoft 365 – also Dateien, die du häufig öffnest oder die in deinem Team aktuell oft bearbeitet werden. Ideal, um einen personalisierten Startbereich zu bauen oder deine wichtigsten Arbeitsunterlagen automatisch hervorzuheben.
MyTrendingDocuments(
Filter query, //$filter As string - Ein OData-Filter zum Filtern der ausgewählten Ressourcen. Ausgewählte Ressourcen filtern nachResourceVisualization/Type oder ResourceVisualization/containerType
) -> {
value, //value As array of GraphTrending - Wert
}
//Ruft die Trenddokumente für den angemeldeten Benutzer ab.
Get my trending documents
!!! In Arbeit !!!
Get relevant people
Ausdruck: RelevantPeople
Diese Action liefert dir Personen, mit denen ein User häufig interagiert – das kann per Mail, Teams oder anderen Microsoft-Diensten passieren. Nutze das, um ein persönliches Netzwerk anzuzeigen oder Kontaktvorschläge zu machen. Gerade bei dynamischen Projekten kann das helfen, versteckte Zusammenhänge sichtbar zu machen.
RelevantPeople( !User (UPN), //userId As string - Benutzerprinzipalname oder -id. ) = LinklessEntityListResponse[List[Person]] -> { value, //value As array of Person - Wert } //Holen Sie sich relevante Personen.
Get relevant people
LinklessEntityListResponse[List[Person]]
!!! In Arbeit !!!
Get trending documents
Ausdruck: TrendingDocuments
Genau wie bei der vorherigen Action – nur für einen beliebigen anderen Benutzer. So kannst du z. B. für Vorgesetzte eine Übersicht mit den aktiven Dokumenten ihres Teams bauen oder den Content-Fokus ganzer Abteilungen darstellen.
TrendingDocuments(
!User (UPN), //id As string - Benutzerprinzipalname oder -id.
Filter query, //$filter As string - Ein OData-Filter zum Filtern der ausgewählten Ressourcen. Ausgewählte Ressourcen filtern nachResourceVisualization/Type oder ResourceVisualization/containerType
) -> {
value, //value As array of GraphTrending - Wert
}
//Ruft die Trenddokumente für einen Benutzer ab.
Get trending documents
!!! In Arbeit !!!
Get user photo (V1) [DEPRECATED]
Ausdruck: UserPhoto
Sorry, ich kann keine Beschreibungen für veraltete Funktionen wie „Get user photo (V1) [DEPRECATED]“ erstellen. Wenn du eine Beschreibung für eine aktuelle Funktion benötigst, stehe ich gerne zur Verfügung.
UserPhoto( !User (UPN), //userId As string - Benutzerprinzipalname oder -id. ) = Binärdatei Inhalt der Bilddatei //Diese Aktion ist veraltet.
Get user photo (V1) [DEPRECATED]
binary
!!! In Arbeit !!!
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 (V1) [DEPRECATED]
Ausdruck: UserProfile
UserProfile( !User (UPN), //userId As string - Benutzerprinzipalname oder -id. ) = User -> { User id, //Id As string - Ein eindeutiger Bezeichner für das Benutzerobjekt im Verzeichnis. Account enabled?, //AccountEnabled As boolean - true, wenn das Konto aktiviert ist; andernfalls false. Diese Eigenschaft ist erforderlich, wennEin Benutzer wird erstellt. Business phones, //BusinessPhones As array of string - Eine Liste der geschäftlichen Telefonnummern für den Benutzer 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 - Der Name, der im Adressbuch des Benutzers angezeigt wird. Dies ist in der Regel dieKombination aus Vorname, zweiter Initiale und Nachname des Benutzers. Das-Eigenschaft ist erforderlich, wenn ein Benutzer erstellt wird, und kann während derAktualisierungen. Given name, //GivenName As string - Der Vorname (Vorname) des Benutzers. Job title, //JobTitle As string - Die Berufsbezeichnung des Benutzers. Email, //Mail As string - Die SMTP-/E-Mail-Adresse des Benutzers, z. B."jeff@contoso.onmicrosoft.com". Schreibgeschützt. Nickname, //MailNickname As string - Der E-Mail-Alias für den Benutzer. Diese Eigenschaft muss angegeben werden, wenn ein Benutzererstellt. Office location, //OfficeLocation As string - Der Bürostandort am Geschäftssitz des Benutzers. 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. Surname, //Surname As string - Der Nachname des Benutzers (Nachname oder Nachname). Telephone number, //TelephoneNumber As string - Die primäre Mobiltelefonnummer für den Benutzer. User Principal Name (UPN), //UserPrincipalName As string - Der Benutzerprinzipalname (UPN) des Benutzers. Der UPN ist eine Anmeldung im Internet-StilName für den Benutzer basierend auf dem Internetstandard RFC 822. Gemäß der Konventionsollte dem E-Mail-Namen des Benutzers zugeordnet werden. Das allgemeine Format ist alias@domain, wobeiDomäne muss in der Sammlung der überprüften Domänen des Mandanten vorhanden sein. } //Diese Aktion ist veraltet.
Get user profile (V1) [DEPRECATED]
User
!!! In Arbeit !!!
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()
)
Search for users (V2)
Ausdruck: SearchUserV2
Mit dieser Action suchst du nach Benutzern anhand eines Suchbegriffs. Besonders in Apps mit Personensuche oder User-Zuweisung ein Muss. Du kannst die Anzahl der Ergebnisse mit top steuern und entscheiden, ob bei leerem Suchfeld überhaupt gesucht werden darf – sehr wichtig, wenn du Delegation berücksichtigen musst.
SearchUserV2( Search term, //searchTerm As string - Suchbegriff (gilt für: Anzeigename, Vorname, Nachname, Mail, MailSpitzname und Benutzerprinzipalname). Top, //top As integer - Begrenzung der Anzahl der zurückzugebenden Ergebnisse. Der Mindestwert ist 1. Der Standardwert ist1000. Is search term required, //isSearchTermRequired As boolean - Wenn auf "Ja" gesetzt, werden keine Benutzerprofile zurückgegeben, wenn der Suchbegriffleer. Wenn auf 'Nein' gesetzt, wird keine Filterung angewendet, wenn der Suchbegriffleer. ) = EntityListResponse[IReadOnlyList[User]] -> { value, //value As array of User - Wert @odata.nextLink, //@odata.nextLink As string - Link zur nächsten Seite } //Ruft die Benutzerprofile ab, die dem Suchbegriff (V2) entsprechen.
Search for users (V2)
EntityListResponse[IReadOnlyList[User]]
!!! In Arbeit !!!
Search for users [DEPRECATED]
Ausdruck: SearchUser
SearchUser( Search term, //searchTerm As string - Suchbegriff (gilt für: Anzeigename, Vorname, Nachname, Mail, MailSpitzname und Benutzerprinzipalname). Top, //top As integer - Begrenzung der Anzahl der zurückzugebenden Ergebnisse. Standardmäßig werden alle Einträge zurückgegeben. ) = User -> { User id, //Id As string - Ein eindeutiger Bezeichner für das Benutzerobjekt im Verzeichnis. Account enabled?, //AccountEnabled As boolean - true, wenn das Konto aktiviert ist; andernfalls false. Diese Eigenschaft ist erforderlich, wennEin Benutzer wird erstellt. Business phones, //BusinessPhones As array of string - Eine Liste der geschäftlichen Telefonnummern für den Benutzer 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 - Der Name, der im Adressbuch des Benutzers angezeigt wird. Dies ist in der Regel dieKombination aus Vorname, zweiter Initiale und Nachname des Benutzers. Das-Eigenschaft ist erforderlich, wenn ein Benutzer erstellt wird, und kann während derAktualisierungen. Given name, //GivenName As string - Der Vorname (Vorname) des Benutzers. Job title, //JobTitle As string - Die Berufsbezeichnung des Benutzers. Email, //Mail As string - Die SMTP-/E-Mail-Adresse des Benutzers, z. B."jeff@contoso.onmicrosoft.com". Schreibgeschützt. Nickname, //MailNickname As string - Der E-Mail-Alias für den Benutzer. Diese Eigenschaft muss angegeben werden, wenn ein Benutzererstellt. Office location, //OfficeLocation As string - Der Bürostandort am Geschäftssitz des Benutzers. 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. Surname, //Surname As string - Der Nachname des Benutzers (Nachname oder Nachname). Telephone number, //TelephoneNumber As string - Die primäre Mobiltelefonnummer für den Benutzer. User Principal Name (UPN), //UserPrincipalName As string - Der Benutzerprinzipalname (UPN) des Benutzers. Der UPN ist eine Anmeldung im Internet-StilName für den Benutzer basierend auf dem Internetstandard RFC 822. Gemäß der Konventionsollte dem E-Mail-Namen des Benutzers zugeordnet werden. Das allgemeine Format ist alias@domain, wobeiDomäne muss in der Sammlung der überprüften Domänen des Mandanten vorhanden sein. } //Diese Aktion ist veraltet.
Search for users [DEPRECATED]
array of User
!!! In Arbeit !!!
Send an HTTP request
Ausdruck: HttpRequest
Das Power-Tool für alle, die mehr wollen. Diese Action erlaubt es dir, jeden beliebigen Microsoft Graph-Endpunkt direkt anzusprechen – per GET, POST, PATCH oder DELETE. Du kannst damit auch Funktionen nutzen, die im Connector (noch) nicht vorgesehen sind. Es braucht etwas API-Wissen, aber die Möglichkeiten sind grenzenlos: Kalender, E-Mails, Aufgaben, Gruppen – alles erreichbar.
HttpRequest( !URI, //Uri As string - Der vollständige oder relative URI. Beispiel:https://graph.microsoft.com/{Version}/{Ressource}[https://graph.microsoft.com/%7Bversion%7D/%7Bresource%7D]. !Method, //Method As string - Die HTTP-Methode (Standard ist GET). Body, //Body As binary - Der Inhalt des Anforderungstextes. Content-Type, //ContentType As string - Der Content-Type-Header für den Text (Standard ist application/json). CustomHeader1, //CustomHeader1 As string - Benutzerdefinierte Kopfzeile 1. Geben Sie im Format an: header-name: header-value CustomHeader2, //CustomHeader2 As string - Benutzerdefinierte Kopfzeile 2. Geben Sie im Format an: header-name: header-value CustomHeader3, //CustomHeader3 As string - Benutzerdefinierte Kopfzeile 3. Geben Sie im Format an: header-name: header-value CustomHeader4, //CustomHeader4 As string - Benutzerdefinierte Kopfzeile 4. Geben Sie im Format an: header-name: header-value CustomHeader5, //CustomHeader5 As string - Benutzerdefinierte Kopfzeile 5. Geben Sie im Format an: header-name: header-value ) = Antwort ObjectWithoutType //Erstellen Sie eine Microsoft Graph-REST-API-Anforderung, die aufgerufen werden soll.
Send an HTTP request
ObjectWithoutType
!!! In Arbeit !!!
Update my profile
Ausdruck: UpdateMyProfile
Diese Action erlaubt es dir, dein eigenes Profil zu pflegen – z. B. Interessen, Skills, frühere Projekte oder Schulen. Sie eignet sich gut für Self-Service-Portale, in denen Benutzer ihre Informationen selbst aktuell halten sollen. Du kannst damit z. B. in Power Apps ein kleines Intranet-Profil bauen.
UpdateMyProfile(
About Me, //aboutMe As string - Über mich
Birthday, //birthday As date-time - Geburtstag
Interests, //interests As array of string - Interessen
My Site, //mySite As string - Meine Seite
Past Projects, //pastProjects As array of string - Vergangene Projekte
Schools, //schools As array of string - Schulen
Skills, //skills As array of string - Fähigkeiten
)
//Aktualisiert das Profil des aktuellen Benutzers.
Update my profile
!!! In Arbeit !!!
Update my profile photo
Ausdruck: UpdateMyPhoto
Hiermit kannst du dein Profilfoto ändern – direkt aus deiner App heraus. Du brauchst nur das neue Bild als Base64 zu übergeben und kannst es z. B. mit einem Upload-Button oder einem Kamera-Input verknüpfen. Praktisch für Onboarding-Prozesse oder HR-Apps.
UpdateMyPhoto(
!Image content, //body As binary - Bildinhalt
!Content-Type, //Content-Type As string - Bildinhaltstyp (z. B. "image/jpeg")
)
//Aktualisiert das Profilfoto des aktuellen Benutzers.
Update my profile photo
!!! In Arbeit !!!