SuperAPI AI 工具集

add-office365-users

办公与效率

查看项目

更新于 10-16 06:47

技能介绍

用途:该技能用于在 Microsoft Managed Apps 项目中添加 Office 365 用户连接器,从而访问用户资料、汇报关系等信息。它本身是一个薄封装,唯一实现路径是调用 /add-data-source。

主要能力:添加连接器后,可导入生成的 Office365UsersService,使用 V2 方法获取当前登录用户资料(MyProfile_V2)、按 ID 或 UPN 获取用户资料(UserProfile_V2)、查询经理(Manager_V2)、查询直属下属(DirectReports_V2)、搜索人员(SearchUserV2)以及获取头像元数据和图片(UserPhotoMetadata、UserPhoto_V2)。

使用方式:以 api-id 为 shared_office365users、mode 为 action 调用 /add-data-source。查询时建议用 $select 只请求界面需要的字段,例如 id、displayName、jobTitle、department、mail、userPrincipalName、officeLocation。DirectReports_V2 需要目标经理的目录 ID 或 UPN;对当前用户先调 MyProfile_V2('id,userPrincipalName') 再取 id 或回退到 UPN。返回结果通过 success、data、error 判断;data.value 为空数组表示无下属,属正常状态。头像需先调 UserPhotoMetadata,HasPhoto 为 false 时渲染备用内容;UserPhoto_V2 返回二进制数据,需转换为 data: URL 再用于 img,不要直接拼 base64,也不要使用 blob: URL,因为部署环境的 CSP 可能拦截。

适用场景:在 Managed Apps 中构建涉及组织架构、人员卡片、汇报关系或员工头像展示的界面。

限制:必须通过生成的连接器服务调用,不能直接调用 Microsoft Graph,也不能把认证后的运行时 URL 赋给 img src。资料未提供安装命令以外的收费、价格或平台信息。