用途
该技能面向需要编写 TypeScript 代码访问 Microsoft 365 平台资源的场景,核心是两套 API:Dataverse Web API(/api/data/v9.2/)与 Microsoft Graph(graph.microsoft.com)。它提供认证、带类型客户端和组合预配三方面的模式与参考。
主要能力
- 共享令牌提供器:用同一个凭证实例同时服务 Dataverse 与 Graph。DefaultAzureCredential 依次尝试环境变量、Workload Identity(Kubernetes)、托管标识(Azure VM、Functions、AKS)、Azure CLI、Azure PowerShell。
- Dataverse 客户端:环境 URL 初始化、连接测试(whoAmI)、增删改查(create/get/patch/delete)与 OData 过滤查询。
- Graph 服务:用户查询、创建 Teams 频道、创建 SharePoint 文件夹、列出群组成员等。
- 联合预配工作流:先在 Dataverse 创建状态为 provisioning 的项目记录,并行通过 Graph 创建 Teams 频道与 SharePoint 文件夹,再把资源 ID 回写 Dataverse 并将状态改为 active。
- 环境认证策略:本地开发用环境变量(AZURE_TENANT_ID、AZURE_CLIENT_ID、AZURE_CLIENT_SECRET),Azure Functions 用系统分配托管标识,AKS 用 Workload Identity,非 Azure K8s 与 CI/CD 用客户端密钥。DefaultAzureCredential 使代码跨环境无需改动。
使用方式
安装依赖:
npm install @azure/identity @microsoft/microsoft-graph-client
npm install @microsoft/microsoft-graph-client/authProviders/azureTokenCredentials
典型代码:
import { DefaultAzureCredential, TokenCredential } from "@azure/identity";
export function getCredential(): TokenCredential {
return new DefaultAzureCredential();
}
const client = new DataverseClient(
{ environmentUrl: "https://contoso.crm.dynamics.com" },
getCredential()
);
const whoAmI = await client.whoAmI();
const id = await client.create("accounts", { name: "Contoso" });
const graph = new GraphService(getCredential());
const channel = await graph.createTeamsChannel(teamId, "Project Alpha");
Entra 配置清单:注册应用;为 Dynamics CRM 配置 user_impersonation(委托)或应用权限,为 Graph 配置所需应用权限(如 User.Read.All、Files.ReadWrite.All、Channel.Create);授予管理员同意;在 Dataverse 环境创建绑定该 Client ID 的应用用户并分配安全角色;生产环境可改用托管标识并赋予相同权限。
技能附带参考文件:references/azure-auth.md(认证与 Entra 配置)、references/dataverse-client.md(完整带类型客户端、OData、批处理、分页)、references/graph-client.md(Graph 服务类)、references/environment-strategies.md(环境与密钥管理)、references/graph-client-patterns.md(中间件、JSON Batch、PageIterator),以及 examples 下的认证、Dataverse、Graph 与组合流程示例。
适用场景
Node/TypeScript 后端服务、Azure Functions、AKS 工作负载中需要同时读写 Dataverse 数据并操作 Microsoft 365 资源(Teams、SharePoint、用户、群组、邮件、日历)的集成与自动化预配。
限制
该资料未提供收费、价格、平台支持范围之外的信息;除上述已列 API 与能力外的功能暂未提供。