传统平台

修改向导流

当您向现有规则添加屏幕或添加输出值时,将更新向导流。

过程

  1. 创建 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 指示向导页面是否相互独立。 可能的值:
    1. True-指示向导页面独立。
    2. False-指示向导页面是从属页面。
    您可以在 type=PAGEwizardEntity 中修改以下属性:
    表 2。 页面中可修改的 XML 属性

    下表提供了可在页面中修改的向导属性的列表。

    属性 描述
    screenId 指示页面中显示的屏幕的类名。
    开始 指示该页面是否是向导中的第一个页面。 可能的值:
    • True-指示页面是向导中的起始页或第一页。
    • False-指示页面不是向导中的起始页或第一页。
    结束 指示该页面是否为向导的最后一页。 可能的值:
    • True-指示该页面是向导中的最后一页。
    • False-指示该页面不是向导中的第一个页面。
    类别 指示页面所属的类别。 此属性用于面包屑。

    您可以在 type=RULEwizardEntity 中修改以下属性:

    表 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发生异常。
  2. <INSTALL_DIR>/extensions/将该 incrementalwizards.xml 文件复制到 wsc/webpages/wizardxmls/ 文件夹中。
  3. 可选: 如果要应用基于标识符的多个扩展名,请修改 incrementalwizards.xml 文件中相应标识符的向导定义。 将用于标识符的 incrementalwizards.xml 文件复制到 <INSTALL_DIR>/extensions/wsc/webpages/<identifier ID>/wizardxmls/ 文件夹。 例如,如果要为 Org1 标识符 ID 创建向导,请将 incrementalwizards.xml 文件复制到 <INSTALL_DIR>/extensions/wsc/org1/wizardxmls/ 文件夹。