第十九章 开发Productions - ObjectScrip
第十九章 开发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
