General Migration Steps (if the Ajax channel is enabled)

Procedure

  1. Update BTT tooling plugins to BTT version 8.0.1 or later.
  2. Restart RAD with "-clean" option to make sure the latest BTT tooling plugin will take effect. This step is optional.
  3. Replace BTT jar files with BTT version 8.0.1 or later.
  4. Clean project, to make sure BTT DDE editor can locate the new version classes. This step is optional.
  5. Update btt.xml
    1. Add new parameter "navigationMode" to HTML channel definition. If customer wants to enable popup and client state, this parameter should set to ajax. Otherwise, if customer want to keep using legacy form submission, this property is unnecessary to add, or set the value to “html”.

      Sample : <field id="navigationMode" value="ajax" />

    2. Change the implementation class of presentationHandler for both html channel and remote channel.

      ImplClass : com.ibm.btt.cs.html.ExtendHtmlPresentationHandler

    3. Add PopupPageState definition to processer definition. Sample:

      <field id="popupPageState"value="com.ibm.btt.automaton.ext.PopupPageClientState" />

  6. Change the implementation class of "CSReqServlet" in web.xml.

    ImplClass : com.ibm.btt.cs.html.HTMLReqServlet

  7. Replace the All BTT JavaScript file with BTT version 8.0.1 or later.
  8. Replace the generation template with BTT version 8.0.1 or later. If project already contains a customized generation template, then please update it by following steps:
    1. Update all ${encoding} to UTF-8, this will solve most of the encoding problem.
    2. Add following Java snippets to templates:
    3. Add following CSS which used for screen cover:
    4. Change ECA engine clarification to following, which support mode change between ajax submission and form submission:
    5. Change ECA rule js import snippet into <body></body> section in order to be compatible with IE browser as following:
  9. Rebuild project to re-generate btt artifacts, such as xml, jsp and js.
  10. For newly created projects, user can directly use application wizard, the newly created project will following new approach and contains all modifications mentioned above.