Naslagwerk voor gebruikers (preview)

Overzicht

Beschikbare hulpmiddelen

mcp_graph_getDirectReports

Geeft een lijst weer van de directe rapporten van een opgegeven gebruiker in de directory. U moet de object-id (GUID) van de gebruiker of de userPrincipalName (e-mailadresachtige UPN) opgeven. Gebruik niet me als de userIdentifier.

Vereiste parameters:

• userIdentifier: Object-id van gebruiker (GUID) of userPrincipalName (UPN)

Optionele parameters:

• Selecteer: Door komma's gescheiden lijst met eigenschappen die moeten worden geretourneerd (bijvoorbeeld, id, displayNamemail, jobTitle, userPrincipalName)
• Boven: Aantal items dat per pagina moet worden geretourneerd

mcp_graph_getMyManager

Haalt de manager van de aangemelde gebruiker (de beller) op. Dit eindpunt retourneert altijd de manager van de huidige gebruikerscontext.

Optionele parameters:

• selecteren: Door komma's gescheiden lijst met managereigenschappen die moeten worden geretourneerd

mcp_graph_getMyProfile

Haalt de profielgegevens van de aangemelde gebruiker (de beller) op. Dit eindpunt retourneert altijd het profiel van de huidige gebruikerscontext.

Optionele parameters:

• selecteren: Door komma's gescheiden lijst met eigenschappen van gebruikersprofielen
• Uitbreiden: Gerelateerde tabellen uitvouwen (bijvoorbeeld manager, directReports)

mcp_graph_getUserProfile

Hiermee haalt u het profiel van een specifieke gebruiker op in de adreslijst. U moet de object-id (GUID) van de gebruiker of de userPrincipalName (e-mailadresachtige UPN) opgeven. Gebruik niet me als de userIdentifier. Gebruik voor de aangemelde gebruiker mcp_graph_getMyProfile.

Vereiste parameters:

• userIdentifier: Object-id van gebruiker (GUID) of userPrincipalName (UPN)

Optionele parameters:

• selecteren: Door komma's gescheiden lijst met gebruikerseigenschappen die moeten worden geretourneerd
• Uitbreiden: Vouw een gerelateerde tabel uit (manager OF directReports). U kunt slechts één eigenschap per aanvraag uitbreiden.

mcp_graph_getUsersManager

Haalt de manager van een opgegeven gebruiker in de directory op. Geef de object-id (GUID) van de gebruiker of diens userPrincipalName (e-mailadresachtige UPN) op. Gebruik niet me als de userIdentifier. Gebruik voor de aangemelde gebruiker mcp_graph_getMyManager.

Vereiste parameters:

• userIdentifier: Object-id van gebruiker (GUID) of userPrincipalName (UPN)

Optionele parameters:

• Selecteer: Door komma's gescheiden lijst met eigenschappen die moeten worden geretourneerd voor de manager, zoals id, displayName, mail, , jobTitleuserPrincipalName

mcp_graph_listUsers

Hiermee wordt een lijst met gebruikers in de organisatie opgehaald. Ondersteunt queryopties zoals $select, $filter, $top, . $orderby De standaardwaarde ConsistencyLevel is uiteindelijke.

Optionele parameters:

• Boven: Alleen de eerste n gebruikers weergeven
• selecteren: Door komma's gescheiden lijst met gebruikerseigenschappen die moeten worden geretourneerd
• Filter: Gebruikers filteren op eigenschap, zoals startswith(displayName,'A')
• Orderby: Resultaten ordenen op opgegeven eigenschap, zoals displayName
• zoeken: Zoek in vrije tekst naar gebruikers. Indeling: "property:value", zoals displayName:Neha, om te zoeken naar weergavenamen die Neha bevatten. Ondersteunt meerdere eigenschappen met spaties. Terugvalregel: als $search dit mislukt of geen resultaten retourneert, probeert u het automatisch opnieuw met $filter.
• aantal: Aantal items opnemen (true of false)
• ConsistencyLevel: Vereiste header voor geavanceerde query's (standaard: uiteindelijk)

Belangrijkste kenmerken

Zelfkennis

• Haal het profiel van de aangemelde gebruiker op.
• Vraag de manager van de aangemelde gebruiker op.
• Toegang tot huidige gebruikerscontextgegevens.
• U hoeft geen gebruikers-id's te gebruiken.

Gebruikersprofielen

• Haal het profiel van een gebruiker op id of UPN op.
• Toegang tot gebruikerseigenschappen zoals displayName, mail, en jobTitlemeer.
• Gerelateerde tabellen zoals manager en directReportsuitvouwen.
• Eigenschappen selecteren met behulp van $select.

Organisatiehiërarchie

• Vraag de manager van een gebruiker op.
• De directe rapporten van een gebruiker ophalen.
• Navigeer door de rapportagestructuur.
• Relaties tussen managers en hun direct ondergeschikten.

Gebruikersdetectie

• Vermeld gebruikers binnen de organisatie.
• Zoeken in vrije tekst met automatische terugval.
• OData-filtering en sorteren.
• Ondersteuning voor paginering.
• Tel gebruikers in resultaten.

Zoekmogelijkheden

• OData $select voor het selecteren van eigenschappen.
• OData-$filter voor het filteren van gebruikers.
• OData $expand voor gerelateerde entiteiten.
• OData $orderby voor sortering.
• Vrijetekstzoekopdracht $search met terugvaloptie.
• Uiteindelijke consistentieondersteuning.

Aantekeningen

• Gebruik mcp_graph_getMyProfile voor de ingelogde gebruiker, niet mcp_graph_getUserProfile met mij.
• Gebruik mcp_graph_getMyManager voor de manager van de aangemelde gebruiker.
• userIdentifier moet object-ID (GUID) of userPrincipalName (UPN) zijn, gebruik geen weergavenaam.
• Als alleen de weergavenaam beschikbaar is, gebruik mcp_graph_listUsers om eerst de gebruiker op te zoeken.
• $expand kan slechts één eigenschap per aanvraag (manager of directReports) uitbreiden.
• $search heeft automatische terugval naar $filter als zoeken mislukt.
• ConsistencyLevel eventual vereist voor geavanceerde query’s.
• Zoekindeling: "property:value" met aanhalingstekens.

Veelvoorkomende gebruiksvoorbeelden

Mijn gegevens ophalen

• Gebruik mcp_graph_getMyProfile om het profiel van de huidige gebruiker op te halen.
• Gebruik mcp_graph_getMyManager om de manager van de huidige gebruiker te krijgen.

Een gebruiker zoeken

• Gebruik mcp_graph_listUsers met de zoekparameter.

  Voorbeeld: search='"displayName:John"' om gebruikers met de naam John te vinden.

• Haal userPrincipalName of object-ID op uit de resultaten.

Gebruikersgegevens ophalen

• Gebruik mcp_graph_getUserProfile met userIdentifier.
• Gebruik select dit om specifieke eigenschappen op te halen.
• Gebruik expand om manager of directReports toe te voegen.

Organisatiestructuur ophalen

• Gebruik mcp_graph_getUsersManager om de manager van een gebruiker op te halen.
• Gebruik mcp_graph_getDirectReports om de directe ondergeschikten van een gebruiker op te halen.
• Ketenoproepen om door de rapportagehiërarchie te navigeren.