如何通过Graph Client Factory获取直属特定经理的所有用户？

当前代码的核心问题 #

你现在的写法存在两个关键问题：

• Graph API 不支持直接在$filter中使用manager/userPrincipalName，因为manager属于导航属性，无法直接通过其属性做过滤条件。
• 代码片段未完成API请求调用，缺少.get()这类触发请求的方法，导致查询不会实际执行。

两种可行解决方案 #

方案1：使用directReports端点（推荐） #

这个端点是Graph API专门用于获取用户直接下属的接口，逻辑更直观且效率更高：

this.props.context.msGraphClientFactory
  .getClient('3')
  .then((client: MSGraphClientV3) => {
    // 先通过用户主体名获取经理的ID
    client
      .api(`users?$filter=userPrincipalName eq '${escape(this.state.searchForManager)}'&select=id`)
      .version("v1.0")
      .get()
      .then((managerRes: any) => {
        if (managerRes.value.length > 0) {
          const managerId = managerRes.value[0].id;
          // 获取该经理的所有直接下属
          client
            .api(`users/${managerId}/directReports`)
            .version("v1.0")
            .select("displayName,mail,userPrincipalName")
            .get()
            .then((directReports: any) => {
              // 处理下属数据
              console.log(directReports.value);
            });
        }
      });
  });

方案2：通过经理ID过滤用户列表 #

如果需要保留users端点的查询方式，需先获取经理的ID，再用ID作为过滤条件：

this.props.context.msGraphClientFactory
  .getClient('3')
  .then((client: MSGraphClientV3) => {
    client
      .api(`users?$filter=userPrincipalName eq '${escape(this.state.searchForManager)}'&select=id`)
      .version("v1.0")
      .get()
      .then((managerRes: any) => {
        if (managerRes.value.length > 0) {
          const managerId = managerRes.value[0].id;
          client
            .api("users")
            .version("v1.0")
            .select("displayName,mail,userPrincipalName")
            .filter(`manager/id eq '${managerId}'`)
            .get()
            .then((users: any) => {
              // 处理查询结果
              console.log(users.value);
            });
        }
      });
  });

必要权限配置 #

确保你的SPFx项目已在package-solution.json中声明正确的Graph API权限，示例：

"webApiPermissionRequests": [
  {
    "resource": "Microsoft Graph",
    "scope": "User.Read.All"
  }
]

部署项目后，需在SharePoint管理中心批准该权限请求。

内容的提问来源于stack exchange，提问作者Nicolas Duchaine