核心功能
- 支持多种 Azure 身份验证方案的 Microsoft Dynamics 365 集成
- 用于数据操作的标准数据库端口操作（Select、Lookup、Upsert 和存储过程）
建立连接
要允许知行之桥使用 Dynamics 365 中的数据，必须首先建立到 Dynamics 365 的连接。有两种方式可以建立此连接：- 将 Dynamics 365 端口添加到工作流中。然后在设置窗格中，点击连接下拉列表旁边的创建。
- 打开知行之桥设置页面，然后打开连接选项卡。点击添加，选择 Dynamics 365，然后点击下一步。
- 只有第一次创建连接时才需要登录过程。
- 到 Dynamics 365 的连接可以被多个 Dynamics 365 端口重复使用。
-
在添加连接模态中输入如下连接信息：
- 名称 — 连接的静态名称。填入你期望的名称。
- 类型 — 端口名称。此字段始终设置为 Dynamics 365。
- 组织 URL — Microsoft Dynamics 365 组织的 URL。
- 版本 — Microsoft Dynamics 365 版本。支持以下版本：CustomerService、FieldService、FinOpsOnline、FinOpsOnPremise、HumanResources、Marketing、ProjectOperations 和 Sales。
- 身份验证方案 — 用于连接的身份验证方案。选项包括 AzureAD、AzureServicePrincipal 和 AzureMSI。
- Azure 租户 — Microsoft Azure Active Directory 的租户 ID。
- OAuth 授权类型 — 用于获取令牌的授权类型（仅限 AzureAD 和 AzureServicePrincipal 身份验证方案）。选项包括 Code、Client 和 Password。
- OAuth 客户端 ID — 帐户的客户端 ID。（仅限客户端授权类型。）
- OAuth 客户端密钥 — 帐户的客户端密钥。（仅限客户端授权类型。）
- 如有必要，单击高级打开高级连接设置的下拉菜单。大多数情况下不需要这些设置。
- 单击连接以确保知行之桥可以使用提供的信息连接到 Dynamics 365。如果发生错误，请检查所有字段并重试。
- 单击添加连接以完成连接。
- 从配置窗格的设置选项卡上显示的连接下拉列表中选择新创建的连接。
- 单击保存更改。
选择一个操作
与 Dynamics 365 建立连接后，必须选择 Dynamics 365 端口将执行的操作。下表概述了每个操作及其在知行之桥工作流中的位置。高级选项卡
高级选项卡上的许多设置是从你正在使用的数据源动态加载的，因此本文档不对其进行说明。 以下描述的选项适用于所有数据源。消息
保存至 Sent 文件夹和Sent 文件夹方案设置已弃用，默认处于隐藏状态。只有先前已启用这些设置或将其配置为非默认值的端口才会显示它们。若要保留成功处理的文件副本，请在工作流中右键单击该端口，选择显示成功路径，然后将成功路径连接到File 端口。
高级设置
高级设置 是依赖任意数据库驱动（例如 Database、CData 和 API 端口）连接到各种数据源的端口的通用设置。其他设置
其他设置 适用于特定使用场景。自动化选项卡
自动化设置
与端口自动处理文件相关的设置。性能
与端口资源分配相关的设置。告警选项卡
与配置告警相关的设置。 在执行服务级别协议（SLA）之前，你需要设置电子邮件告警通知。默认情况下，知行之桥使用告警选项卡上的全局设置。若要为此端口使用其他设置，请开启覆盖全局设置。 默认情况下，错误告警已启用，这意味着每当发生错误时都会发送电子邮件。若要关闭，请取消选中启用复选框。 输入主题（必填），然后可选填入以逗号分隔的收件人电子邮件列表。SLA 选项卡
与配置服务级别协议（SLA）相关的设置。 SLA 允许你配置期望工作流中端口发送或接收的数据量，并设置期望在该时间范围内满足该数据量。知行之桥会在 SLA 未满足时发送电子邮件警告用户，并将 SLA 标记为_风险中_，表示如果 SLA 不久内仍未满足，将被标记为_已违反_。这给用户一个机会介入，确定 SLA 未满足的原因，并采取适当的行动。如果 SLA 在风险期结束时仍未满足，SLA 将被标记为已违反，并再次通知用户。 要定义 SLA，开启预期数据量，然后点击设置选项卡。
- 如果你的端口具有单独的发送和接收操作，请使用单选按钮指定 SLA 涉及的方向。
- 在窗口的至少预期部分：
- 设置你期望处理的最小事务数（数据量）
- 使用每字段指定时间范围
- 指示 SLA 何时生效。如果选择从…开始，请填写日期和时间字段。
- 勾选你希望 SLA 生效的星期几的复选框。如有必要，使用下拉菜单选择每天。
- 在窗口的**设置状态为”风险中”**部分，指定 SLA 何时应标记为风险中。
- 默认情况下，在 SLA 违反之前不会发送通知。若要更改此设置，勾选发送”风险中”通知。
如有必要，你可以关闭 SLA 告警。这在维护窗口期间很有用。在导航栏中点击设置，然后导航到告警 > 常规告警。点击铅笔图标进行编辑，并取消勾选 SLA 告警设置。
宏
在文件命名策略中使用宏可以提升组织效率并加深对数据的了解。通过在文件名中融入宏，你可以动态包含标识符、时间戳和消息头信息等相关信息，为每个文件提供有价值的上下文。这有助于确保文件名反映对你的组织重要的详细信息。 知行之桥支持以下宏，所有宏均使用以下语法：%Macro%。
示例
有些宏（如 %Ext% 和 %ShortDate%）不需要参数，而其他宏需要参数。所有带参数的宏均使用以下语法：%Macro:argument%
以下是一些带参数的宏示例：
- %Header:headername%：其中
headername是消息上消息头的名称。 - %Header:mycustomheader% 解析为输入消息上设置的
mycustomheader消息头的值。 - %Header:ponum% 解析为输入消息上设置的
ponum消息头的值。 - %RegexFilename:pattern%：其中
pattern是正则表达式模式。例如，%RegexFilename:^([\w][A-Za-z]+)%匹配并解析为文件名中的第一个词（不区分大小写，test_file.xml解析为test）。 - %Vault:vaultitem%：其中
vaultitem是保险库中某个项目的名称。例如，%Vault:companyname%解析为保险库中存储的companyname项目的值。 - %DateFormat:format%：其中
format是接受的日期格式（详情请参见日期格式示例）。例如，%DateFormat:yyyy-MM-dd-HH-mm-ss-fff%解析为文件的日期和时间戳。
- 在一个文件名中组合多个宏：
%DateFormat:yyyy-MM-dd-HH-mm-ss-fff%%EXT% - 在宏外部包含文本：
MyFile_%DateFormat:yyyy-MM-dd-HH-mm-ss-fff% - 在宏内部包含文本：
%DateFormat:'DateProcessed-'yyyy-MM-dd_'TimeProcessed-'HH-mm-ss%