执行函数
使用“执行函数”操作可执行在 Dynamics 365 CRM 元数据中定义的函数。
完成以下步骤,可在工作流中使用“执行函数”操作:
1. Dynamics 365 CRM 下的“执行函数”操作拖动到工作区,并将指针置于该操作上,然后单击 或双击该操作。“执行函数”窗口随即打开。
2. 根据需要编辑“标签”。默认情况下,标签名称与操作名称相同。
3. 要添加 Dynamics 365 CRM 连接器类型,请参阅支持的 Dynamics 365 CRM 连接器类型
如果先前已添加连接器类型,请选择相应的“连接器类型”,然后在“连接器名称”下选择连接器。
4. 单击“测试”以验证连接器。
5. 单击“映射连接器”,以使用除当前用于填充输入字段的连接器以外的其他连接器来执行操作。在“运行时连接器”字段中,提供有效的 Dynamics 365 CRM 连接器名称。有关“映射连接器”的详细信息,请参阅使用映射连接器
6. 选择“包括参考域”复选框以显示在参考域中通过 FunctionImport 进行说明的所有函数。
7. “函数”列表中,选择要执行的 Dynamics 365 CRM 函数。
输入表单中的字段会根据所选的函数动态更改。
8. 选择“表单”以为表单中列出的各个属性提供输入,或选择“分配 JSON”以通过提供所有必需属性来指定单个 JSON。
9. 使用“查询类型”列表中的选项,根据需要输出的对象属性筛选输出。如果函数未返回对象,则“查询类型”选项不可用。
根据函数的返回类型,查询将包含以下参数:
单个对象 -“选择属性”“添加相关项”
对象集合 -“筛选器”“选择属性”“添加相关项”“限制”“跳过”
“查询类型”列表中,选择“表单查询”“离散查询”“原生查询”以提供查询参数。
“表单查询”
a. (仅适用于对象集合) 在“筛选”组下,执行以下操作:
a. “连接方式”列表中,选择连接筛选子句的逻辑运算符。默认值为
b. “筛选子句”下,单击“添加”以添加筛选器:
“属性”- 选择一个属性。
“匹配条件”- 选择一个条件。条件取决于所选属性的类型,例如“字符串”、“布尔型”等。
“值”- 输入属性值。
单击“添加”以添加多个筛选器。单击 可删除已添加的任何筛选器。
如果添加同一属性,并在“连接方式”列表中选择了“与”,则属性将以“或”运算符连接。
b. “选择属性”下,单击“添加”,然后在“属性”列表中,选择要检索其值的属性。
单击“添加”可添加多个属性。单击 可删除已添加的任何属性。
默认情况下,如果选择任何属性,则会在输出中检索所选属性和 'key' 属性的值。如果未选择任何属性,则默认情况下,输出中会包含所有实体属性。
c. “添加相关项”下,单击“添加”,然后在“相关项”列表中,选择要检索其值的相关项。
单击“添加”可添加多个相关项。单击 可删除已添加的任何相关项。
标记为 NavigationProperty 的任何属性都会被归类为“相关项”
d. (仅适用于对象集合) 在“限制”字段中,输入一个值,以将输出限制为指定数量的实体。
e. (仅适用于对象集合) 在“跳过”字段中,输入要跳过的资源数。
“离散查询”
a. (仅适用于对象集合) 在“筛选”字段中,以 propertyName operator 'value' [and | or | not]... 格式指定 OData 筛选条件。
例如 number eq '0000222341'name eq 'PTC'startswith(name, 'PTC')
b. “选择属性”字段中,指定 OData 选择表达式,以提供以逗号分隔的属性名称列表。
默认情况下,如果在查询中指定任何属性,则会在输出中检索所选属性的值。如果未指定任何属性,则默认情况下,输出中会包含所有实体属性。
c. “添加相关项”字段中,指定 OData 选择表达式,以提供以逗号分隔的相关项列表。
标记为 NavigationProperty 的任何属性都会被归类为“相关项”
d. (仅适用于对象集合) 在“限制”字段中,输入要检索的搜索结果数。
e. (仅适用于对象集合) 在“跳过”字段中,输入要从结果中跳过的顶层搜索结果数。
“原生查询”
“查询”字段中,指定 OData 查询表达式。
例如:$select=name,number&$expand=context&$top=2&$skip=1&$orderby=name asc&$filter=name eq 'PTC'
默认情况下,如果在查询中指定任何属性,则会在输出中检索所选属性的值。如果未指定任何属性,则默认情况下,输出中会包含所有实体属性。
标记为 NavigationProperty 的任何属性都会被归类为“相关项”
根据函数的返回类型,您可以在查询表达式中提供“筛选”、“限制”和“跳过”参数。
10. 单击“完成”
输出架构
根据所选的 Dynamics 365 CRM 函数,“执行函数”操作将返回动态输出架构。如果此操作没有返回类型,则会返回消息字符串。
如果选择“表单查询”来指定查询参数,则输出架构仅提供选定属性的详细信息。
对于“离散查询”“原生查询”,输出架构将包含返回对象的所有属性;但仅提供指定属性的值。
这对您有帮助吗?