Dynamics 365
借助 Dynamics 365 连接器,您可以从应用连接到 Dynamics 365 中的实时数据。您可以访问 Dynamics 365 数据,就像访问数据库一样,并对数据执行读取、写入和更新操作。
准备工作
在使用 Dynamics365 连接器之前,请先完成以下任务:
- 在您的 Google Cloud 项目中:
- 确保已设置网络连接。如需了解网络模式,请参阅网络连接。
- 启用以下服务:
secretmanager.googleapis.com
(Secret Manager API)connectors.googleapis.com
(Connectors API)
如需了解如何启用服务,请参阅启用服务。
如果之前没有为您的项目启用这些服务或权限,则在您配置连接器时,系统会提示您启用。
配置连接器
配置连接器时,您需要创建与数据源(即后端系统)的连接。一个连接需专用于一个数据源。这意味着,如果您有许多数据源,则必须为每个数据源创建单独的连接。如需创建连接,请执行以下步骤:
- 在 Cloud 控制台 中,进入 Integration Connectors > 连接页面,然后选择或创建一个 Google Cloud 项目。
- 点击 + 新建以打开创建连接页面。
- 在位置部分中,选择连接的位置。
- 区域:从下拉列表中选择一个位置。
连接器支持的区域包括:
如需查看所有受支持区域的列表,请参阅位置。
- 点击下一步。
- 区域:从下拉列表中选择一个位置。
- 在连接详情部分中,完成以下操作:
- 连接器:从可用连接器的下拉列表中选择 Dynamics 365。
- 连接器版本:从可用版本的下拉列表中选择一个连接器版本。
- 在连接名称字段中,输入连接实例的名称。
连接名称必须符合以下条件:
- 连接名称可以使用字母、数字或连字符。
- 字母必须小写。
- 连接名称必须以字母开头,以字母或数字结尾。
- 连接名称不能超过 49 个字符。
- (可选)输入连接实例的说明。
- 您可以选择启用 Cloud Logging,然后选择日志级别。默认情况下,日志级别设置为
Error
。 - 服务账号:选择具有所需角色的服务账号。
- (可选)配置连接节点设置:
- 节点数下限:输入连接节点数下限。
- 节点数上限:输入连接节点数上限。
节点是处理事务的连接单元(或副本)。 连接处理越多事务就需要越多节点,相反,处理越少事务需要越少节点。 如需了解节点如何影响连接器价格,请参阅连接节点的价格。如果未输入任何值,则默认情况下,节点数下限设置为 2(以便提高可用性),节点数上限设置为 50。
- Azure 租户:用于访问数据的 Microsoft 在线租户。如果未指定,系统将使用您的默认租户。
- 组织网址:您的 Dynamics 365 组织的网址。例如,https://abc123.cloudax.dynamics.com/。
- ADFS 服务器:用于进行身份验证的 ADFS 服务器。仅适用于 FinOpsOnPremise 版本。
- API 版本:默认值为 9.0。您可以指定此值,以便在 API 的新版本发布后访问该版本。此属性仅在“版本”设置为“CustomerService”“FieldService”“Marketing”“ProjectOperations”或“Sales”时适用。
- 跨公司:是拉取所有公司的数据,还是仅拉取用户的默认公司的数据。
- 版本:所使用的 Dynamics 365 版本。
- 包含格式化值:指示是否应公开包含格式化值的列。
- Include Navigation Properties:指示是否应在列中列出导航属性。
- 使用动态存储过程:指明是否应公开动态存储过程。
- 详细程度级别:连接的详细程度级别,介于 1 到 5 之间。详细级别越高,系统会记录的通信详细信息(请求、响应和 SSL 证书)就越多。
- (可选)点击 + 添加标签,以键值对的形式向连接添加标签。
- 点击下一步。
-
在身份验证部分中,输入身份验证详细信息。
- 选择身份验证类型,然后输入相关详细信息。
Dynamics 365 连接支持以下身份验证类型:
- OAuth 2.0 身份验证代码授权
- 点击下一步。
如需了解如何配置这些身份验证类型,请参阅配置身份验证。
- 选择身份验证类型,然后输入相关详细信息。
- 查看:查看您的连接和身份验证详细信息。
- 点击创建。
配置身份验证
根据您要使用的身份验证输入详细信息。
-
OAuth 2.0 授权码授予
- 访问令牌:通过基于 auth-code-flow 的连接对请求进行身份验证时所用的访问令牌。
- 客户端 ID:请求访问令牌时所用的客户端 ID。
- 客户端密钥:请求访问令牌时所用的客户端密钥。
Dynamics365 配置
请完成以下步骤来配置 Dynamics 365。
创建用户
- 登录 Azure 门户。
- 创建新用户并分配系统管理员角色。
创建应用
- 在 Azure 门户中,依次前往 Azure Active Directory > Application Registrations(应用注册)。
- 点击 New registration(新注册)。
- 输入应用的名称。
- 将“单个”指定为租户设置。
- 将重定向网址设置为
http://localhost:33333
或其他端口,并将 Callback网址 设置为您定义的回复网址。 - 点击注册。
- 前往 Certificates & Secrets,然后定义应用身份验证类型。
- 为应用选择新的客户端密钥,并指定其有效期。保存客户端密钥后,Microsoft Office 365 会显示密钥值。
- 复制键值,您将其用作客户端密钥。
组织网址、版本、范围和授权网址
以下是组织网址、版本、范围和授权网址的值:- 组织网址是实例网址。
- 您可以选择以下版本之一:营销、销售或客户服务。
- 范围:[org url]/.default
- 授权网址:https://login.microsoftonline.com/{TENANT_ID}/oauth2/v2.0/authorize
配置用于连接授权的重定向网址
- 在 Azure 门户中,从应用注册中选择相应应用。
- 在基本功能中,添加重定向网址。
- 添加平台,选择网站,然后粘贴重定向网址。
Dynamics365 Customerservice 版连接类型
字段名称 | 详细信息 |
---|---|
位置 | us-central1 |
连接器 | Dynamics365 |
连接器版本 | 1 |
连接名称 | google-cloud-dynamic365-rest-customerservice |
服务账号 | SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com |
Azure 租户 | AZURE_TENANT |
组织网址 | https://orgurl.com |
版本 | 客户服务 |
添加导航栏属性 | True |
详细程度 | 5 |
节点数下限 | 2 |
节点数上限 | 2 |
客户端 ID | CLIENT_ID |
范围 | [组织网址]/.default |
客户端密钥 | SECRET |
密钥版本 | 5 |
授权网址 | https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/authorize |
Dynamics 365 Sales 版连接类型
字段名称 | 详细信息 | |
---|---|---|
位置 | us-central1 | |
连接器 | Dynamics365 | |
连接器版本 | 1 | |
连接名称 | googlecloud-dynamic365-rest-sales | |
服务账号 | SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com | |
Azure 租户 | AZURE_TENANT | |
组织网址 | https://orgurl.com | |
版本 | 销售 | |
添加导航栏属性 | True | |
详细程度 | 5 | |
节点数下限 | 2 | |
节点数上限 | 2 | |
客户端 ID | CLIENT_ID | |
范围 | [组织网址]/.default | |
客户端密钥 | SECRET | |
密钥版本 | 5 | |
授权网址 | https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/authorize | |
Dynamics 365 Marketing 版连接类型
字段名称 | 详细信息 |
---|---|
位置 | us-central1 |
连接器 | Dynamics365 |
连接器版本 | 1 |
连接名称 | google-dynamic365-rest-marketing |
服务账号 | SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com |
Azure 租户 | AZURE_TENANT |
组织网址 | https://orgurl.com |
版本 | 营销 |
添加导航栏属性 | True |
详细程度 | 5 |
节点数下限 | 2 |
节点数上限 | 2 |
客户端 ID | CLIENT_ID |
范围 | [组织网址]/.default |
客户端密钥 | SECRET |
密钥版本 | 5 |
授权网址 | https://login.microsoftonline.com/{tenant-id}/oauth2/v2.0/authorize |
实体、操作和动作
所有集成连接器都会为所连接应用的对象提供抽象层。您只能通过此抽象访问应用的对象。抽象作为实体、操作和动作向您展示。
- 实体:实体可以被视为连接的应用或服务中的对象或属性集合。不同连接器的实体定义也会有所不同。例如,在数据库连接器中,表是实体;在文件服务器连接器中,文件夹是实体;在消息传递系统连接器中,队列是实体。
但可能的情况是,连接器不支持或不具有任何实体,在这种情况下,
Entities
列表将为空。 - 操作:操作是指您可以对实体执行的操作。您可以对实体执行以下任一操作:
从可用列表中选择一个实体,系统会生成该实体可用的操作列表。如需了解操作的详细说明,请参阅连接器任务的实体操作。不过,如果连接器不支持任何实体操作,则
Operations
列表中不会列出此类不受支持的操作。 - 动作:动作是可通过连接器接口提供给集成的头等函数。动作可让您对一个或多个实体进行更改,并且动作因连接器而异。通常,操作会有一些输入参数和一个输出参数。但可能的情况是,连接器不支持任何动作,在这种情况下,
Actions
列表将为空。
系统限制
Dynamics 365 连接器每个节点每秒可处理 1 笔交易,并会对超出此限制的所有交易进行节流。默认情况下,集成连接器会为连接分配 2 个节点(以提高可用性)。
如需了解适用于集成连接器的限制,请参阅限制。
实体操作示例
本部分介绍如何在此连接器中执行一些实体操作。
示例 - 列出所有商品
此示例列出了 Products
实体中的所有商品。
- 在
Configure connector task
对话框中,点击Entities
。 - 从
Entity
列表中选择Products
。 - 选择
List
操作,然后点击完成。 - 您还可以在连接器任务的任务输入部分中,通过指定过滤条件子句来过滤结果集。 请务必使用英文单引号 (') 指定过滤条件子句值。
示例 - 获取潜在客户
以下示例会从 Leads
实体中获取指定 ID 的潜在客户。
- 在
Configure connector task
对话框中,点击Entities
。 - 从
Entity
列表中选择Leads
。 - 选择
Get
操作,然后点击完成。 - 在连接器任务的任务输入部分,点击 EntityId,然后在默认值字段中输入
c5233ad8-a1a4-ee11-a568-000d3ac9f67f
。其中,
c5233ad8-a1a4-ee11-a568-000d3ac9f67f
是Leads
实体中的唯一记录 ID。
示例 - 创建潜在客户
此示例在 Leads
实体中创建了潜在客户。
- 在
Configure connector task
对话框中,点击Entities
。 - 从
Entity
列表中选择Leads
。 - 选择
Create
操作,然后点击完成。 - 在连接器任务的任务输入部分中,点击
connectorInputPayload
,然后在Default Value
字段中输入类似于以下内容的值:{ "fullname": "nameadded1703832358758", "subject": "test subject", "firstname": "firstname1703832358766", "lastname": "lastname1703832358767" }
如果集成成功,连接器任务的
connectorOutputPayload
字段的值将类似于以下内容:[{ "leadid": "220166e8-15a6-ee11-a569-002248d5dd6b" }]
示例 - 更新订单
此示例会更新 SalesOrder
实体中的记录。
- 在
Configure connector task
对话框中,点击Entities
。 - 从
Entity
列表中选择SalesOrder
。 - 选择
Update
操作,然后点击完成。 - 在连接器任务的任务输入部分中,点击
connectorInputPayload
,然后在Default Value
字段中输入类似于以下内容的值:{ "name": "Nameupdated1704863189087" }
- 点击 entityId,然后在 Default Value 字段中输入
580775a4-17aa-ee11-a568-000d3ac9f67f
。如果集成成功,连接器任务的
connectorOutputPayload
字段的值将类似于以下内容:[{ "salesorderid": "580775a4-17aa-ee11-a568-000d3ac9f67f" }]
示例 - 删除联系人
以下示例会删除 Contacts
实体中指定 ID 的联系人。
- 在
Configure connector task
对话框中,点击Entities
。 - 从
Entity
列表中选择Contacts
。 - 选择
Delete
操作,然后点击完成。 - 在连接器任务的任务输入部分,点击 entityId,然后在默认值字段中输入
524f543b-3ea5-ee11-a568-000d3ac9f67f
。
在集成中使用 Dynamics 365 连接
创建连接后,该连接将在 Apigee Integration 和 Application Integration 中可用。您可以通过连接器任务在集成中使用该连接。
- 如需了解如何在 Apigee Integration 中创建和使用连接器任务,请参阅连接器任务。
- 如需了解如何在 Application Integration 中创建和使用连接器任务,请参阅连接器任务。