Brugerreference (forhåndsvisning)

Oversigt

Tilgængelige værktøjer

mcp_graph_getDirectReports

Viser en angivet brugers direkte rapporter i mappen. Du skal enten angive brugerens objekt-id (GUID) eller vedkommendes userPrincipalName (maillignende UPN). Brug ikke me som userIdentifier.

Påkrævede parametre:

• userIdentifier: Brugerens objekt-id (GUID) eller userPrincipalName (UPN)

Valgfrie parametre:

• Vælg: Kommasepareret liste over egenskaber, der skal returneres (f.eks. id, displayName, mail, , jobTitle) userPrincipalName
• top: Antal elementer, der skal returneres pr. side

mcp_graph_getMyManager

Henter den nærmeste leder for den loggede bruger (den kaldende bruger). Dette slutpunkt returnerer altid lederen for den aktuelle brugerkontekst.

Valgfrie parametre:

• vælg: Kommasepareret liste over egenskaber, der returneres

mcp_graph_getMyProfile

Henter profiloplysningerne for den bruger, der er logget på (kalderen). Dette slutpunkt returnerer altid profilen for den aktuelle brugerkontekst.

Valgfrie parametre:

• markere: Kommasepareret liste over brugerprofilegenskaber
• Udvide: Udvid relaterede tabeller (f.eks. leder directReports)

mcp_graph_getUserProfile

Henter en angivet brugers profil i mappen. Du skal enten angive brugerens objekt-id (GUID) eller vedkommendes userPrincipalName (maillignende UPN). Brug ikke me som userIdentifier. For den bruger, der er logget på, skal du bruge mcp_graph_getMyProfile.

Påkrævede parametre:

• userIdentifier: Brugerens objekt-id (GUID) eller userPrincipalName (UPN)

Valgfrie parametre:

• vælg: Kommasepareret liste over brugeroplysninger, der skal returneres
• Udvide: Udvid en relateret tabel (leder ELLER directReports). Du kan kun udvide én egenskab pr. anmodning.

mcp_graph_getUsersManager

Henter lederen for en angivet bruger i mappen. Angiv enten brugerens objekt-id (GUID) eller vedkommendes userPrincipalName (maillignende UPN). Brug ikke me som userIdentifier. For den bruger, der er logget på, skal du bruge mcp_graph_getMyManager.

Påkrævede parametre:

• userIdentifier: Brugerens objekt-id (GUID) eller userPrincipalName (UPN)

Valgfrie parametre:

• Vælg: Kommasepareret liste over egenskaber, der skal returneres for lederen, f.eks id. , displayName, mail, jobTitle, userPrincipalName

mcp_graph_listUsers

Henter en liste over brugere i organisationen. Understøtter forespørgselsindstillinger som $select, $filter, $top, $orderby. Standarden ConsistencyLevel er eventuel.

Valgfrie parametre:

• Top: Vis kun de første n-brugere
• vælg: Kommasepareret liste over brugeroplysninger, der skal returneres
• Filter: Filtrer brugere efter egenskab, f.eks. startswith(displayName,'A')
• Sorterefter: Bestil resultater efter en given egenskab, f.eks. displayName
• søge: Fritekstsøgning for brugere. Format: "property:value", f.eks displayName:Neha . for at søge efter viste navne, der indeholder Neha. Understøtter flere egenskaber med mellemrum. Fallback-regel: Hvis $search mislykkes eller ikke returnerer nogen resultater, skal du automatisk prøve igen med $filter.
• Tælle: Medtag antal elementer (sand eller falsk)
• Konsistensniveau: Påkrævet header til avancerede forespørgsler (standard: eventual)

Nøglefunktioner

Selverkendelse

• Hent profilen for den bruger, der er logget på.
• Hent lederen for den bruger, der er logget på.
• Få adgang til aktuelle brugerkontekstoplysninger.
• Der er ikke behov for bruger-id'er.

Brugerprofiler

• Hent en brugers profil efter id eller UPN.
• Få adgang til brugeregenskaber som displayName, mail, jobTitleog meget mere.
• Udvid relaterede tabeller, f.eks manager . og directReports.
• Vælg egenskaber ved hjælp $selectaf .

Organisationshierarki

• Hent en brugers chef.
• Hent en brugers direkte rapporter.
• Naviger i rapporteringsstrukturen.
• Chef og direkte rapportrelationer.

Brugeropdagelse

• Opfør brugere i organisationen.
• Fritekstsøgning med automatisk fallback.
• OData-filtrering og -sortering.
• Understøttelse af sideinddeling.
• Antal brugere i resultater.

Forespørgselsfunktioner

• OData $select til valg af egenskab.
• OData $filter til brugerfiltrering.
• OData-$expand for relaterede objekter.
• OData $orderby til sortering.
• Fritekst $search med fallback.
• Eventuel understøttelse af konsistens.

Noter

• Brug mcp_graph_getMyProfile den til den indloggede bruger, ikke mcp_graph_getUserProfile hos mig.
• Brug mcp_graph_getMyManager til den indloggede brugers leder.
• userIdentifier skal være objekt-ID (GUID) eller userPrincipalName (UPN), brug ikke displaynavn.
• Hvis kun visningsnavnet er tilgængeligt, skal du bruge mcp_graph_listUsers til først at slå brugeren op.
• $expand kan kun udvide én egenskab pr. anmodning (manager eller directReports).
• $search har automatisk fallback til $filter , hvis søgningen mislykkes.
• ConsistencyLevel kræves eventuelt til avancerede forespørgsler.
• Søgeformat: "property:value" med anførselstegn.

Almindelige anvendelsestilfælde

Hent mine oplysninger

• Brug mcp_graph_getMyProfile det til at få den nuværende brugers profil.
• Brug mcp_graph_getMyManager til at få den aktuelle brugers leder.

Find en bruger

• Brug mcp_graph_listUsers med søgeparameteren.

  Eksempel: search='"displayName:John"' for at finde brugere med navnet John.

• Hent userPrincipalName eller objekt-id fra resultater.

Hent brugeroplysninger

• Bruges mcp_graph_getUserProfile sammen med userIdentifier.
• Bruges select til at hente bestemte egenskaber.
• Brug expand til at inkludere manager eller directReports.

Hent organisationsstrukturen

• Brug mcp_graph_getUsersManager til at hente en brugers leder.
• Bruges mcp_graph_getDirectReports til at hente en brugers direkte rapporter.
• Kædekald for at navigere i rapporteringshierarkiet.