第十九章 开发Productions - ObjectScript Productions - 添加和删除设置

要为Productions、业务主机或适配器提供新设置，请按如下方式修改其类定义：

• 为希望定义的每个配置设置添加一个属性。
• 向类中添加一个名为 SETTINGS 的类参数。
• 将 SETTINGS 的值设置为刚刚定义的属性名称的逗号分隔列表。例如：

Property foo As %String;

Property bar As %String;

Parameter SETTINGS = "foo,bar";

现在，每当选择该类别的项目进行配置时，foo和bar设置都会自动显示在生产配置页面上的配置显示中。

要删除继承的配置设置，请在 SETTINGS 类参数中列出属性，并在前面加上连字符 (-)。例如：

Parameter SETTINGS = "-foo";

为设置指定类别和控件

默认情况下，当配置制作时，设置会显示在“详细信息”选项卡上的“其他设置”类别中。默认情况下，设置提供以下输入机制之一，具体取决于设置所基于的属性：

• 在大多数情况下，该设置显示为一个普通的输入字段。
• 如果该属性指定 VALUELIST 参数，则该设置将显示为一个下拉列表。将出现在下拉列表中的项目必须使用逗号作为分隔符进行分隔。
• 如果该属性的类型为 %Boolean，则该设置显示为复选框。

在所有情况下，属性的 InitialExpression（如果指定）控制输入字段的初始状态。

可以覆盖位置和控件类型。为此，请在 SETTINGS 中包含设置名称，如下所示：

Parameter SETTINGS = "somesetting:category:control";

Parameter SETTINGS = "somesetting:category";

Parameter SETTINGS = "somesetting::control";

其中category和control分别表示要使用的类别和控件。以下小节提供了详细信息。

可以包括多个设置，如下所示：

Parameter SETTINGS = "setting1:category:control1,setting2:control2:editor,setting3:category:control3";

例如（包括不允许的换行符）：

Parameter SETTINGS = "HTTPServer:Basic,HTTPPort:Basic,SSLConfig:Connection:sslConfigSelector,
ProxyServer:Connection,ProxyPort:Connection,ProxyHTTPS:Connection,
URL:Basic,Credentials:Basic:credentialsSelector,UseCookies,ResponseTimeout:Connection" 

设置类别

category 是以下区分大小写的文字值之一：

• Info信息 - 将设置放入信息设置类别。
• Basic基本 — 将设置放入基本设置类别。
• Connection连接 — 将设置放入连接设置类别。
• Additional附加 — 将设置放入附加设置类别（默认）。
• Alerting警报 — 将设置放入警报控制类别。
• Dev — 将设置放入开发和调试类别。

或者使用您自己的类别名称。

Control for a Setting

控件指定在“生产Productions”页中查看和修改设置时使用的特定控件的名称。使用选择器或使用EnsPortal.Component包中的类名。请参阅设置控件的示例。

要向组件提供额外的值以显示一组合适的选项，请追加一组名称-值对，如下所示：

myControl?Prop1=Value1&Prop2=Value2&Prop3=Value3

• Prop1、Prop2、Prop3等是控件的属性名称。例如：多选

• Value1、Value2、Value3等是相应的值。

  使用语法@Propertyname来引用Java脚本zenPage对象的属性。支持的变量如下：

  • CurrHostID是指当前Ens.Config.Item的ID。
  • productionId 是指Ens.Config.Production正在使用的ID。

  使用 \@ 按原样指示字符 @。

  要将值传递给控件的上下文属性，请将值括在花括号中。请参阅小节。

将值传递给控件的上下文属性

IRIS 使用通用选择器组件，也可以使用它；为此，将控件指定为选择器，然后附加属性/值对。

选择器组件允许向用户显示几乎任何数据或选项列表，并且允许用户在需要时键入数据。要以这种方式配置组件，请使用以下语法设置控件的上下文属性：

context={ContextClass/ContextMethod?Arg1=Value1&Arg2=Value2&Arg3=Value3}

• ContextClass 是上下文类的名称。这必须是 %ZEN.Portal.ContextSearch或 Ens.ContextSearch的子类。请参阅设置控件示例。
• ContextMethod 是该类中的一个方法。此方法提供用户从中选择值的数据。
• Arg1、Arg2、Arg3 等是该方法的多维参数的名称。
• Value1、Value2、Value3 等是这些参数的值。值的规则与前面给出的相同（例如，可以使用@propertyname）。

注意：请注意，选择器组件还有一个名为 multiSelect 的属性。默认情况下，用户只能选择一项。要使用户能够选择多个项目，请包含一个属性/值对，如下所示：multiSelect=1。

参数名称和值必须经过 URL 编码。例如，将 % 替换为 %25。

设置控件示例

下面的列表给出了控件的示例，按它们允许用户选择的数据类型组织。

这些示例使用 IRIS 类。其中许多示例使用 Ens.ContextSearch 类，它提供了大量有用的方法。如果此列表未涵盖方案，请参阅 Ens.ContextSearch 的类文档以确定是否有任何现有方法提供需要的数据。如果该类不涵的场景，可以创建自己的 Ens.ContextSearch子类。

BPL

bplSelector

business hosts in the same production

selector?multiSelect=1&context={Ens.ContextSearch/ProductionItems?targets=1&productionName=@productionId}

或者，如果用户应该只选择一个业务主机：

selector?context={Ens.ContextSearch/ProductionItems?targets=1&productionName=@productionId}

business partners

partnerSelector

business rules

ruleSelector

character sets

selector?context={Ens.ContextSearch/CharacterSets}

credential sets

credentialsSelector

directories

directorySelector

DTL

dtlSelector

files

fileSelector

framing

selector?context={Ens.ContextSearch/getDisplayList?host=@currHostId&prop=Framing}

local interfaces

selector?context={Ens.ContextSearch/TCPLocalInterfaces}

适用于特定业务主机的模式类别

selector?context={Ens.ContextSearch/SchemaCategories?host=classname}

• 其中 classname 是业务主机的类名。例如：

selector?context={Ens.ContextSearch/SearchTableClasses?host=EnsLib.MsgRouter.RoutingEngineST}

schedules

scheduleSelector

适合特定业务主机的搜索表类

selector?context={Ens.ContextSearch/SearchTableClasses?host=classname}

• 其中 classname 是业务主机的类名。例如：

selector?context={Ens.ContextSearch/SearchTableClasses?host=EnsLib.EDI.EDIFACT.Service.Standard}

SSL configurations

sslConfigSelector