配置属性和配置选项

在 Coach 视图中定义配置选项,以便用户可以定制该 Coach 视图的特定实例。 用户将这些配置选项视为该实例中的配置属性。

例如,“单选按钮”库存控件具有 layout 配置选项和 Layout 标签。将“单选按钮”实例放在 Coach 视图布局上,然后选择该实例时,“属性”区域会显示配置属性的列表。其中一个配置属性为“布局”。可以为此配置属性选择“水平”或“垂直”。此选项仅影响该“单选按钮”实例。

为 Coach 视图定义配置选项时,设置对应配置属性及其显示的信息的外观。
  • 标签字段中,提供配置属性的显示名称。如果不提供标签,那么 Coach 视图实例使用配置选项的名称作为显示名称。
  • 文档字段中,提供悬浮式帮助文本以帮助用户决定该配置属性的设置。
  • 要对若干相关配置选项进行分组,请提供组名。Coach 视图实例显示具有折叠标记的组名。 当用户展开折叠标记时,将会显示具有同一组名的配置属性。例如,将 config1config2 添加到 Config 组。
    Configuration Option config1 with the Group Name field set to Config
    When users click an instance of the coach view, they see the Config group. If users expand the twistie, they see config1 and config2.
    Config group with the config1 and config2 configuration properties
配置选项的数据类型会影响 Coach 视图实例显示对应配置属性的方式。如果类型是简单类型(如“字符串”)或者基于简单类型,那么对应配置属性是相应的控件。 例如,控件是与“布尔”类型对应的复选框或与“字符串”类型对应的文本字段。如果类型是业务对象,那么配置属性是包含作为配置属性的业务对象参数的组。
Configuration option config4 is a business object that contains three parameters. The last
parameter is also a business object.
此处是显示为配置属性的 config4
Configuration property config4 is a group that contains parameters that display as
configuration properties
如果类型是列表,那么配置属性是一个两列表。表中的各行表示列表中的一项。
Configuration option config5 is a list of Strings
此处是显示为配置属性的 config5,其格式为一张表。
Configuration property config5 is a table that contains two added items
如果类型是业务对象列表,那么配置属性是一个具有标题行和表示各列表项的行的表。业务对象中的各参数在表中具有对应列。如果参数也是业务对象,那么对应列会细分为若干子列,分别表示子业务对象中的各个参数。
Configuration option config6 as a list of business objects. param6, param7, and param8 are
Strings
此处是显示为配置属性的 config6,其格式为一张含三列的表。
Configuration property config6 is a table with a column for the three simple types in the
business object hierarchy

如果用户未设置配置属性的值,那么 Coach 视图实例将使用隐式缺省值。隐式缺省值取决于类型。当您定义布尔类型的配置选项时,必须考虑其隐式缺省值(为 false)。 这表示,缺省情况下,Process Designer 将显示设置为 false 的布尔类型的配置选项(如未选中复选框)。

您可以设置配置选项,以便能响应屏幕大小设置,允许 Coach 视图的实例最多具有三种不同的配置属性设置,每一种设置对应于一种不同的屏幕大小设置。例如,如果 Coach 视图具有一个配置属性,用于控制将选择控件呈现为复选框、单选按钮还是滑块控件,那么用户可以将 Coach 视图实例配置为在不同的用户环境中针对该控件具有三种不同的呈现。要使配置选项能够响应,请单击响应屏幕大小
Configuration options 7a, 7b, 7c, and 7d are set to respond to screen size
Here are the four corresponding configuration properties:
Configuration property config 7a has no value set, 7b has a value for large screens, 7c has a
value for medium screens, and 7d has a value for small screens

如果用户要配置 Coach 视图实例,并希望针对每个屏幕大小设置不同的值,他们可以单击配置选项旁的屏幕大小图标,以指定适用于大、中、小屏幕大小的值。然后可以将屏幕大小设置更改为新的大小,为配置选项输入新值。有关针对 Coach 视图实例的响应设置的信息,请参阅主题coach 视图的响应式设置

在 Coach 视图实例上设置(绑定到数据)配置属性时,可以静态或动态绑定该配置属性。 要静态将其绑定,请输入或选择配置属性的值。要动态将其绑定,请通过单击指定变量图标 指定变量 为配置属性指定变量。然后,可以从呈现的列表中选择现有变量。缺省情况下,列表会显示所有变量。数据类型与为配置选项定义的类型相匹配的变量以粗体显示。但是,您可以选择仅显示这些变量。如果选择变量且该变量的类型与为配置选项定义的类型不匹配,那么 Designer 会显示警告。您可以通过选择显示配置选项图标 显示配置选项,使设计器创建正确类型的配置选项,并将配置属性绑定到此配置选项,而不是选择变量。
限制:
  • 您不能以静态方式绑定到包含嵌套列表的业务对象。而是必须以动态方式进行绑定。
  • 如果为响应配置选项实例设置了动态值,那么仅可以选择一个值。例如,无法为每个屏幕大小设置绑定不同的变量。该限制的一个例外是具有 URL 类型的配置选项。如果此类配置选项设置为能够响应,那么它们可以接受不同屏幕大小设置的值(假定这些值为 Web 文件)。
  • 只有属于对象类型的配置选项可标记为响应式。服务类型配置选项不支持响应式设置。