FieldBind 元素 (WorkflowActions)
适用于:SharePoint 2016 |SharePoint Foundation 2013 |SharePoint Online |SharePoint Server 2013
FieldBind 元素是 RuleDesigner 元素的子级。 这些元素共同用于创建一个易读的语句,此语句用于描述需要计算的条件或必须执行的活动。 正确构造后,这些元素还可用于在句子中插入变量 (如超链接) ,以便无代码工作流编辑器可以在工作流运行时将动态值替换为工作流。 FieldBind 元素将工作流创建者的输入映射到随后传递给Microsoft SharePoint Foundation 2010的参数。
注意
使用 SharePoint Designer 创建工作流时,不支持使用自定义设计器类型或自定义字段类型,除非它们是现有受支持类型的子类型,或者与支持的设计器或参数类型兼容。
定义
<RuleDesigner>
<FieldBind>
<Option />
<DataSourceRef>
</FieldBind>
</RuleDesigner>
元素和属性
下面各部分介绍了属性、子元素和父元素。
Attributes
属性 |
说明 |
---|---|
**DesignerType** |
可选 **text**。 指定当工作流创建者在工作流编辑器中构建语句时所看到的控件或用户输入的类型。 **注意**:如果未指定 DesignerType 属性,则使用默认的 DesignerType 属性。 默认的“DesignerType”是一个文本框,后跟省略号按钮 (...) 和一个查找按钮。 **注意**:无代码工作流编辑器应将服务器返回的值视为不区分大小写。 |
**领域** |
必需 **text**。 表示用于生成工作流的 **Parameter** 元素。 定义参数类型和方向时,“Field”属性直接映射到一个或多个 “Parameter” 元素。 **注意**:如果对 **Field** 属性使用多个参数,则参数名称应用逗号分隔 (例如,“Field”=“Variable**,**ValueType**”) 。 |
**功能** |
可选 **Boolean**。 当设置为 “true”时,此属性会将 **Action** 方法的名称插入句子中。 |
**Id** |
必需 **Integer** (非负) 。 **Id** 用作 FieldBind 元素与父 **RuleDesigner** 元素的 **Sentence** 属性之间的关系键,这与在数据库中使用主键非常类似。 |
**OperatorTypeFrom** |
必需 **text**。 仅在将“DesignerType”属性设置为“Operator”时使用。 此属性根据相应的参数元素中列出的 Microsoft .NET 数据类型确定用户可用的运算符类型。 为 “OperatorTypeFrom” 属性指定的参数可以不同于 Field 属性中列出的参数。 |
**文本** |
必需 **text**。 以条件语句中超链接的形式向用户显示的文本。 |
**TypeFrom** |
可选 **text**。 指定可用于 **FieldBind** 元素实例的有效 .NET 数据类型。 TypeFrom 属性与包含类型定义的 **Parameter** 元素相关联。 |
**价值** |
保留供以后使用。 |
DesignerType 属性
DesignerType |
参数 |
用户界面元素 |
---|---|---|
(省略) (未知) Text TextBox |
String |
单行文本框。 |
AddPermission |
角色列表 用户列表 |
允许向用户添加角色的对话框。 |
分配 |
分配到 CC Comments 主题 持续时间 持续时间单位 截止日期 |
用于设置工作分配、截止日期和其他数据参数的对话框。 |
Bool |
Boolean |
包含选项 TRUE 或 FALSE 的列表。 |
CheckPermission |
单个参数 |
用于选择一组权限的对话框。 |
ChooseDocLibItem |
列表标识符 列表项 |
文档库项选择对话框。 |
ChooseListItem |
列表标识符 列表项 |
“列表项选择”对话框。 |
CreateListItem |
列表标识符 项属性 覆盖 |
带有按钮的单行文本框,显示要绑定到特定列表项的对话框。 |
DataSourceFieldNames |
单个参数 |
包含从具有与子 DataSourceRef 元素匹配的 DataSource 元素的上级 Action 元素或 CompositeStep 元素检索的选项的列表。 从此列表中选择元素的结果应为所选文本值。 |
DataSourceValues |
单个参数 |
包含从具有与子 DataSourceRef 元素匹配的 DataSource 元素的上级 Action 元素或 CompositeStep 元素检索的选项的列表。 从此列表中选择元素的结果应该是数据源中所选字段的运行时值。 |
日期 |
日期/时间 |
接受日期和时间的文本框。 |
依赖 |
单个参数 |
显示的用户界面元素取决于 TypeFrom 属性和 OperatorTypeFrom 属性的值。 |
下拉列表 |
单个参数 |
包含指定为 FieldBind 元素的 Option 元素的选项的列表。 |
电子邮件 |
To CC 主题 正文 |
用于撰写电子邮件的对话框。 |
FieldNames |
字段 |
与工作流关联的列表或文档库中所有字段的列表。 |
浮点 |
浮点 |
接受浮点数的文本框。 |
Hyperlink |
URL |
“URL”对话框。 |
整数 |
Int |
接受整数的文本框。 |
ListNames |
列表标识符 |
当前网站上的列表列表。 |
运算符 |
值 |
包含指定为 FieldBind 元素的 Option 元素的运算符选项的列表。 运算符列表根据操作数的类型进行筛选。 |
ParameterNames |
名称 |
包含当前工作流中定义的变量的名称的列表。 |
人员 |
人员列表 |
用于在当前网站上选择帐户的对话框。 |
RemovePermission |
角色列表 用户列表 |
用于从用户中删除角色的对话框。 |
ReplacePermission |
角色列表 用户列表 |
用于替换用户角色的对话框。 |
SinglePerson |
人员 |
用于在当前网站上选择单个帐户的对话框。 |
StatusDropdown |
状态值 |
用于输入新状态值或重用现有值的下拉列表。 |
StringBuilder |
String |
单行文本框。 |
调查 |
标题 内容类型标识符 |
用于生成调查表单的对话框,以便在运行时向工作流的用户显示以收集数据。 |
TaskSummary |
单个参数 |
用于设置任务进程的属性的视图。 |
TextArea |
String |
文本框。 |
UpdateListItem |
列表标识符 列表项 项属性 |
包含每个列表中的列表和字段列表的对话框,允许为列表中的字段设置新值。 |
WritableFieldNames |
名称列表 |
包含与工作流关联的列表或文档库中所有非只读字段的列表,或当前网站上所有非只读文档库的列表,具体取决于上下文。 |
子元素
父元素
示例
下面的示例演示如何构造 RuleDesigner 父元素中的 FieldBind 元素,以便后者可在工作流设计器中正确显示。
<RuleDesigner Sentence="%1">
<FieldBind Field="MyParameter1"
Text="text" Id="1"
DesignerType="Dropdown"
TypeFrom="MyParameter1">
<Option Name="Display Name" Value="Display Value"/>
</FieldBind>
</RuleDesigner>