Informazioni di riferimento sugli utenti di IQ aziendale (anteprima)

Overview

Strumenti disponibili

mcp_graph_getDirectReports

Elenca i report diretti di un utente specificato nella directory. Devi fornire o l'ID dell'oggetto (GUID) dell'utente o il loro userPrincipalName UPN (simile a una email). Non usare me come userIdentifier.

Parametri obbligatori:

• userIdentifier: ID oggetto dell'utente (GUID) o userPrincipalName (UPN)

Parametri facoltativi:

• seleziona: Elenco separato da virgola delle proprietà da restituire (ad esempio, id, displayName, mail, jobTitle, userPrincipalName)
• top: numero di elementi da restituire per pagina

mcp_graph_getMyManager

Recupera il gestore dell'utente connesso (il chiamante). Questo endpoint restituisce sempre il gestore del contesto utente corrente.

Parametri facoltativi:

• select: elenco di proprietà dei manager separato da virgole da restituire

mcp_graph_getMyProfile

Recupera i dettagli del profilo dell'utente connesso (il chiamante). Questo endpoint restituisce sempre il profilo del contesto utente corrente.

Parametri facoltativi:

• select: elenco delimitato da virgole delle proprietà del profilo utente
• Espandi: Espandi le tabelle correlate (ad esempio, manager, directReports)

mcp_graph_getUserProfile

Recupera il profilo di un utente specificato nella directory. Devi fornire o l'ID dell'oggetto (GUID) dell'utente o il loro userPrincipalName UPN (simile a una email). Non usare me come userIdentifier. Per l'utente connesso, usare mcp_graph_getMyProfile.

Parametri obbligatori:

• userIdentifier: ID oggetto dell'utente (GUID) o userPrincipalName (UPN)

Parametri facoltativi:

• select: elenco delimitato da virgole di proprietà utente da restituire
• Espandi: Espandi una tabella correlata (manager oppure directReports). Puoi espandere una sola proprietà per richiesta.

mcp_graph_getUsersManager

Recupera il gestore di un utente specificato nella directory . Fornire l'ID oggetto (GUID) dell'utente oppure l'UPN userPrincipalName (simile a un indirizzo e-mail). Non usare me come userIdentifier. Per l'utente connesso, usare mcp_graph_getMyManager.

Parametri obbligatori:

• userIdentifier: ID oggetto dell'utente (GUID) o userPrincipalName (UPN)

Parametri facoltativi:

• Selezionare: Elenco delimitato da virgole di proprietà da restituire per il gestore, ad esempio id, displayNamemail, , jobTitle,userPrincipalName

mcp_graph_listUsers

Recupera un elenco di utenti nell'organizzazione. Supporta opzioni di query come $select, $filter, $top, $orderby. Il valore predefinito ConsistencyLevel è finale.

Parametri facoltativi:

• Superiore: Mostra solo i n primi utenti
• select: elenco delimitato da virgole di proprietà utente da restituire
• Filtro: Filtra gli utenti per proprietà, ad esempio startswith(displayName,'A')
• Orderby: L'ordine risulta tramite una proprietà data, come ad esempio displayName
• search: ricerca di testo libero per gli utenti. Formato: "property:value", ad esempio displayName:Neha per cercare nomi visualizzati contenenti Neha. Supporta più proprietà che includono spazi. Regola di fallback: se $search ha esito negativo o non restituisce risultati, riprovare automaticamente con $filter.
• Conteggio: Includi conteggio degli elementi (vero o falso)
• ConsistencyLevel: Intestazione obbligatoria per le query avanzate (impostazione predefinita: finale)

Funzionalità principali

Conoscenza di sé

• Ottenere il profilo dell'utente connesso.
• Recupera il responsabile dell'utente connesso.
• Accedere alle informazioni sul contesto utente correnti.
• Nessuna necessità di identificatori utente.

Profili utente

• Recuperare il profilo di qualsiasi utente in base all'ID o all'UPN.
• Accedere alle proprietà utente, ad esempio displayName, mailjobTitle, e altro ancora.
• Espandere le tabelle correlate, manager ad esempio e directReports.
• Selezionare le proprietà usando $select.

Gerarchia organizzativa

• Ottieni il responsabile di un utente.
• Ottenere i report diretti di un utente.
• Passare in rassegna la gerarchia dei report.
• Responsabili e relazioni con i collaboratori diretti.

Ricerca utente

• Elencare gli utenti nell'organizzazione.
• Ricerca a testo libero con fallback automatico.
• Filtro e ordinamento di OData.
• Supporto per la paginazione.
• Contare gli utenti nei risultati.

Funzionalità di query

• OData $select per la selezione delle proprietà.
• OData $filter per il filtro utente.
• OData $expand per le entità correlate.
• $orderby OData per l'ordinamento.
• $search di testo libero con fallback.
• Supporto della coerenza finale.

Notes

• Usa mcp_graph_getMyProfile per l'utente che ha effettuato l'accesso, non mcp_graph_getUserProfile con me.
• Usare mcp_graph_getMyManager per il responsabile dell'utente che ha effettuato l'accesso.
• userIdentifier deve essere l'ID dell'oggetto (GUID) o userPrincipalName (UPN), non utilizzare il nome visualizzato.
• Se è disponibile solo il nome visualizzato, utilizzare mcp_graph_listUsers per cercare prima l'utente.
• $expand può espandere una sola proprietà per richiesta (manager o directReports).
• $search passa automaticamente a $filter se la ricerca non riesce.
• ConsistencyLevel eventual è richiesto per le query avanzate.
• Formato di ricerca: "property:value" con virgolette.

Casi d'uso comuni

Ottenere le mie informazioni

• Usa mcp_graph_getMyProfile per ottenere il profilo dell'utente corrente.
• Usa mcp_graph_getMyManager per ottenere il manager dell'utente corrente.

Trovare un utente

• Utilizzamcp_graph_listUsers con il parametro di ricerca.

  Esempio: search='"displayName:John"' per trovare utenti denominati John.

• Recuperare userPrincipalName o l'ID dell'oggetto dai risultati.

Ottenere i dettagli utente

• Uso di mcp_graph_getUserProfile con userIdentifier.
• Usare select per ottenere proprietà specifiche.
• Usa espandi per includere manager o directReports

Recupera la struttura organizzativa

• Utilizzare mcp_graph_getUsersManager per ottenere il manager di un utente.
• Usare mcp_graph_getDirectReports per ottenere i report diretti di un utente.
• Concatenare le chiamate per spostarsi nella gerarchia dei report.