修改向导流
当您向现有规则添加屏幕或添加输出值时,将更新向导流。
过程
- 创建 incrementalwizards.xml 文件。 确保 incrementalwizards.xml 文件中指定的向导标识与要修改的 XML 文件的向导标识相匹配。
<wizards> <wizard id= "wsc.shipment.wizards.CustomerPickupWizard"> <wizardEntities> <!-- Create a new screen --> <wizardEntity id="Page8" screenId="extn.org1.shipment.NewScreen1" impl="/platform/jsps/dojo/xapiajaxsuccesshandler.jsp" last="false" type="PAGE" category="Cat1"/> <!--Replace an existing screen --> <wizardEntity id="Page1" screenId="wsc.shipment.customerpick.additems.AddItems"/> <!-- Modify a rule --> <wizardEntity id="Rule1"> <output value="1"/> <output value="2"/> <output value="3"/> <output value="4"/> <output value="5"/> </wizardEntity> </wizardEntities> <!-- Modify a wizard transition --> <wizardTransitions> <wizardTransition id="Transition1" source="Rule1"> <output target="Page8" value="1"/> <output target="Page2" value="2"/> <output target="Page7" value="3"/> <output target="Page4" value="4"/> <output target="Page5" value="5"/> </wizardTransition> </wizardTransitions> </wizard> </wizards>只能修改现有向导的某些属性。 下表提供了可编辑向导属性的列表:
表 1. 可编辑向导 XML 属性 下表提供了可编辑向导属性的列表。
属性 描述 independentPages 指示向导页面是否相互独立。 可能的值: - True-指示向导页面独立。
- False-指示向导页面是从属页面。
您可以在type=PAGE的wizardEntity中修改以下属性:表 2。 页面中可修改的 XML 属性 下表提供了可在页面中修改的向导属性的列表。
属性 描述 screenId 指示页面中显示的屏幕的类名。 开始 指示该页面是否是向导中的第一个页面。 可能的值: - True-指示页面是向导中的起始页或第一页。
- False-指示页面不是向导中的起始页或第一页。
结束 指示该页面是否为向导的最后一页。 可能的值: - True-指示该页面是向导中的最后一页。
- False-指示该页面不是向导中的第一个页面。
类别 指示页面所属的类别。 此属性用于面包屑。 您可以在
type=RULE的wizardEntity中修改以下属性:表 3. 规则中可修改的 XML 属性 下表提供了可在规则中修改的向导属性的列表。
属性 描述 impl Java 类必须实现接口 com.sterlingcommerce.ui.web.platform.wizard.ISCUIWizardRule。 您可以使用install3rdParty实用程序将第三方定制 JAR 添加到各种实用程序和企业归档 (EAR) 文件的类路径。例如,
impl=java:com.ibm.wsc.shipment.customerpickup.rules.CustomerPickupFirstPageWizardRule是提供执行的向导规则。开始 指示该规则是否是向导中的第一个规则。 可能的值如下所示: - True-指示规则是向导中的起始规则或第一个规则。
- False-指示规则不是向导中的起始规则或第一个规则。
最后一个 指示规则是否是向导的最后一条规则。 可能的值如下所示: - True-指示规则是向导中的最后一个规则。
- False-指示规则不是向导中的第一个规则。
输出 指示规则的可能返回字符串。 该值指示向导转换中的下一个页面。 您可以通过指定退出规则 <output value="-1" type="exit"/>来定义向导规则以退出向导流。注: 如果 Java 返回与输出值不匹配的字符串,那么SCUIWizardRuleHolder: Undeclared output from implementation发生异常。 - <INSTALL_DIR>/extensions/将该
incrementalwizards.xml文件复制到 wsc/webpages/wizardxmls/ 文件夹中。 - 可选: 如果要应用基于标识符的多个扩展名,请修改
incrementalwizards.xml文件中相应标识符的向导定义。 将用于标识符的incrementalwizards.xml文件复制到 <INSTALL_DIR>/extensions/wsc/webpages/<identifier ID>/wizardxmls/ 文件夹。 例如,如果要为Org1标识符 ID 创建向导,请将incrementalwizards.xml文件复制到 <INSTALL_DIR>/extensions/wsc/org1/wizardxmls/ 文件夹。