使用 Office365 授权方式在 .NET 控制台应用中连接 Dynamics 365

归档62

Dynamics 36529 Firefly主题文章示例9 杂物间9 在路上8 Csharp2 MS Office2 Cooking1 Git和Github1 理解计算机1

525 字

3 分钟

使用 Office365 授权方式在 .NET 控制台应用中连接 Dynamics 365

2022-02-25

Dynamics 365

Dynamics 365 Develop

浏览量加载中...

前言#

本文演示如何使用 Office365 授权方式，在 .NET Framework 控制台应用中连接 Dynamics 365

Microsoft.Xrm.Tooling 支持的授权方式一览#

连接主要使用的是 Microsoft.Xrm.Tooling.Connector 包，这个包提供了多种身份认证方式，但是根据我的实施经验，目前最常用的是以下2种认证方式

Office365（用户名 + 密码）
ClientSecret（应用程序 + 密钥）

Name	Value	Description
Office365	4	Office365 base login process
ClientSecret	7	Client Id + Client Secret Auth
InvalidConnection	-1	Invalid connection
AD	0	Active Directory Auth
Live	1	Live Auth
IFD	2	SPLA Auth
Claims	3	CLAIMS based Auth
OAuth	5	OAuth based Auth
Certificate	6	Certificate based Auth
ExternalTokenManagement	99	Host managed token

详细步骤#

Step 1. 创建控制台应用程序#

打开 Visual Studio —> 创建新项目，选择 “控制台应用(.NET Framework)”

输入项目名称 —> 选择 “.NET Framework 版本” —> 点击 “创建”

Step 2. 添加NuGet包#

为项目安装以下依赖：

Microsoft.CrmSdk.CoreAssemblies
System.Configuration.ConfigurationManage

下面是具体的操作步骤说明和截图：

项目 —> 右键 —> 管理 NuGet 程序包 —>

浏览 —> 搜索 —> 安装

Step 3. 为 App.config 添加连接信息#

在 App.config 文件中添加连接字符串配置：

打开 App.config 文件
在 <configuration> 节点下添加 <connectionStrings> 节
替换以下占位符为实际值：

1
 <connectionStrings>
2
  <!-- Dev 环境（Office365 认证方式） -->
3
  <add name="Dev-Office365"
4
     connectionString="AuthType=Office365;
5
     Url=urlofyourdynamics365instance;
6
     Username=yourusername;
7
     Password=yourpassword;" />
8
 </connectionStrings>

需要替换的值：

https://xxx.crm.dynamics.cn/ → 您的Dynamics 365环境URL
yourusername → 登录用户名（通常是邮箱地址）
yourpassword → 登录密码

Step 4. 添加测试代码#

在 Program.cs 中：

引用命名空间

1
using Microsoft.Crm.Sdk.Messages;
2
using Microsoft.Xrm.Sdk;
3
using Microsoft.Xrm.Tooling.Connector;
4
using System;
5
using System.Configuration;

Main 方法代码

1
string connectionStr = ConfigurationManager.ConnectionStrings["Dev-ClientSecret"].ConnectionString;
2
CrmServiceClient client = new CrmServiceClient(connectionStr);
3
if (client.IsReady)
4
{
5
    IOrganizationService orgServiceorgService = client;
6
    // 使用 WhoAmI 进行测试
7
    WhoAmIResponse resTest = (WhoAmIResponse)orgServiceorgService.Execute(new WhoAmIRequest());
8
    Console.Write($"UserId: {resTest.UserId}");
9
    Console.Read();
10
}
11
else
12
{
13
    throw new Exception(client.LastCrmError);
14
}