IBM WebSphere Multichannel Bank Transformation Toolkit, Version 7.1

Configuring the BTT definition files

About this task

You must configure the BTT definition files in the client side, and these files are in the src\definitions folder of the BTTJumpStartSampleRCPClient Project. Do the following steps:

Procedure

  1. Update btt.xml file:

    Copy the btt.xml file from <toolkit_root>\samples\ BTTJumpStartSampleRCPClient.zip\BTTJumpStartSampleRCPClient\src\definitions\ to the src\definitions folder of the BTTJumpStartSampleRCPClient Project.

    BTT provides a tool to configure the btt.xml file. For more information, see Deployment Descriptor editor.

  2. Update type.xml file:
    Replace type.xml file with the following:
    <type id="String" implClass="com.ibm.btt.base.DataField">
    		 <StringDescriptor id="typeDefault"  implClass="com.ibm.btt.base.types.ext.StringPropertyDescriptor">
    			<param id="initialValue" value="null"/>
    			<Converter convTypes="default" implClass="com.ibm.btt.base.types.ext.StringConverter"/>
    			<Validator implClass="com.ibm.btt.base.types.ext.StringValidator"/>
    		 </StringDescriptor>
    	 </type>	      
    <type id="Amount" implClass="com.ibm.btt.base.DataField">
              <descriptor id="typeDefault" implClass="com.ibm.btt.base.types.ext.DoublePropertyDescriptor">
                   <Converter convTypes="default" implClass="com.ibm.btt.base.types.ext.FloatConverter">
                        <param id="size" value="8"/>
                   </Converter>
                   
              </descriptor>
         </type> 
         <type id="Account" implClass="com.ibm.btt.base.KeyedCollection">
              <descriptor id="typeDefault" implClass="com.ibm.btt.base.types.KCollPropertyDescriptor"/>
              <dataDescriptor id="name" refType="String"/>
              <dataDescriptor id="type" refType="String"/>
              <dataDescriptor id="number" refType="String"/>
              <dataDescriptor id="amount" refType="Amount"/>                              
         </type>
         
    	     <type id="AccountList" implClass="com.ibm.btt.base.IndexedCollection">
              <descriptor id="typeDefault" implClass="com.ibm.btt.base.types.ICollPropertyDescriptor">
                   <param id="size" value="0"/>
              </descriptor>
              <dataDescriptor id="account" refType="Account"/>
         </type>
         <type id="SSNumber" implClass="com.ibm.btt.base.KeyedCollection">
              <descriptor id="typeDefault" implClass="com.ibm.btt.base.types.KCollPropertyDescriptor"/>
              <dataDescriptor id="ssn1" refType="String"/>
              <dataDescriptor id="ssn2" refType="String"/>
              <dataDescriptor id="ssn3" refType="String"/>
         </type>
  3. Update data.xml
    Replace the data.xml with the following:
         <data id="BranchId" value="1005" refType="String"/>
    <data  id="TID" refType="String"/>
    	<data id="userId" refType="String">
    		<param id="isMandatory" value="true" />
    		<param id="minLength" value="3" />
    		<param id="maxLength" value="20" />
    		<param id="description" value="userId" />
    	</data>
    	<data id="pw" refType="String">
    		<param id="isMandatory" value="true" />
    		<param id="minLength" value="4" />
    		<param id="maxLength" value="16" />
    		<param id="description" value="Password" />
    	</data>
    <field id="sessionID"/>
    <field id="locale" />
    <field id="dse_errorMessages" />
    <field id="TrxReplyCode"/>
    <!--=========================================================================-->
         <!-- Branch Data                                                             -->
         <!--=========================================================================-->
         <kColl id="branchData">
              <refData refId="BranchId"/>
         </kColl>
         <!--=========================================================================-->
         <!-- WorkStation Data                                                        -->
         <!--=========================================================================-->
         <kColl id="workstationData">
              <refData refId="TID"/>
              <refData refId="userId"/>
              <refData refId="pw"/>
              <refData refId="sessionID"/>
         </kColl>
         <!--=========================================================================-->
         <!-- StartUp Data                                                            -->
         <!--=========================================================================-->
         <kColl id="startupClientData">
              <refData refId="TID"/>
              <refData refId="sessionID"/>
              <field id="eventsPort"/> 
              <field id="ipAddress"/> 
              <field id="permanentConnectionForEvents"/> 
              <field id="instanceId"/>
              <field id="TrxReplyCode"/>
         </kColl>
         <!--=========================================================================-->
         <!-- End Session Data                                                        -->
         <!--=========================================================================-->
         <kColl id="endSessionClientData"/>
         <!--=========================================================================-->
         <!--Sign In Data                                                        -->
         <!--=========================================================================-->
    	    <kColl id="signInData">
    		<refData refId="userId" />
    		<refData refId="pw" />
    		<refData refId="locale" />
    		<refData refId="dse_errorMessages" />
    	     </kColl>
         <!--=========================================================================-->
         <!--Log Off  Data                                                        -->
         <!--=========================================================================-->
    	    <kColl id="logOffData">
    		<refData refId="userId" />
    		<refData refId="pw" />
    		<refData refId="locale" />
    		<refData refId="TrxReplyCode" />
    	     </kColl>
         <!--=========================================================================-->
         <!-- withDraw  Data                                                          -->
         <!--=========================================================================-->
          <kColl id="withDrawData">
    		<field id="TrxId"  />
             <field id="TxReqXUIFile"  value="jar://xui/withDrawReq_Proc.xui" />
             <field id="TxRespXUIFile" value="jar://xui/summary.xui" />
    		<field id="account" />
    		<field id="currency"  />
    		<field id="amount" />
    		<field id="realAmount" />
    		<field id="certID" />
    		<field id="certType" />
    		<field id="feeType" />
    		<field id="fee" />
    		<field id="feeDiscount" />
    		<field id="feeRate" />
    		<field id="feeDiscountRate" />
    		<field id="customerName" />
    		<field id="customerType" />
            <field id="TrxReplyCode" />
            <field id="balance" />
    	     </kColl>
  4. Update format.xml
    Replace format.xml with the following:
    	<fmtDef id="startupReqFmt">
    		<record>
    			<fString dataName="TID" />
    			<delim delimChar="#" />
    		</record>
    	</fmtDef>
    
    	<fmtDef id="startupRecFmt">
    		<record>
    			<fString dataName="TrxReplyCode" />
    			<delim delimChar="#" />
    		</record>
    	</fmtDef>
    
    	<fmtDef id="logOffReqFmt">
    		<record></record>
    	</fmtDef>
    	<fmtDef id="logOffRecFmt">
    		<record>
    			<fString dataName="TrxReplyCode" />
    			<delim delimChar="#" />
    		</record>
    	</fmtDef>
    
    	<fmtDef id="signInOpSendFmt">
    		<record>
    			<fString dataName="userId" />
    			<delim delimChar="#" />
    			<fString dataName="pw" />
    			<delim delimChar="#" />
    			<fString dataName="locale" />
    		</record>
    	</fmtDef>
    
    	<fmtDef id="signInOpRecFmt">
    		<record>		 
    			<fString dataName="dse_errorMessages" />
    			<delim delimChar="#" />
    		</record>
    	</fmtDef>
  5. Update context.xml
    Replace the context.xml with the following:
         <!-- CLIENT CONTEXT DEFs.=================================================== -->
         <!--=========================================================================-->
         <!-- Branch Context                                                          -->
         <!--=========================================================================-->
         <context id="branchClientCtx" type="branch">
              <refKColl refId="branchData"/>
         </context>
         
         <!--=========================================================================-->
         <!-- WorkStation Context                                                     -->
         <!--=========================================================================-->
         <context id="workstationCtx" parent="branchClientCtx" type="branch">
              <refKColl refId="workstationData"/>
         </context>
         <!--=========================================================================-->
         <!-- StartUp Operation Context                                               -->
         <!--=========================================================================-->
         <context id="startupClientCtx" parent="workstationCtx" type="op">
              <refKColl refId="startupClientData"/>
         </context>
         <!--=========================================================================-->
         <!-- End Session Operation Context                                           -->
         <!--=========================================================================-->
         <context id="endSessionClientCtx" parent="workstationCtx" type="op">
              <refKColl refId="endSessionClientData"/>
         </context>
         <!--=========================================================================-->
         <!-- SignIn Client Operation client Context                                  -->
         <!--=========================================================================-->
    	<context id="signInCtx" type="op" parent="workstationCtx">
    		<refKColl refId="signInData" />
    	</context>
         <!--=========================================================================-->
         <!-- LogOff Client Operation client Context                                  -->
         <!--=========================================================================-->
    	<context id="logOffCtx" type="op"  parent="workstationCtx">
    		<refKColl refId="logOffData" />
    	</context>
  6. Update operation.xml
    Replace the operation.xml file with the following code:
    	<operation id="logoffClientOp" context="logOffCtx"
    		implClass="com.ibm.btt.jumpstart.sample.operation.LogoffClientOp"
    		serverOperation="LogoutOp">
    		<refFormat name="csRequestFormat" refId="logOffReqFmt" />
    	</operation>
    	
    	
    	<operation id="signinClientOp" context="signInCtx"
    		implClass="com.ibm.btt.jumpstart.sample.operation.SignInClientOperation"
    		serverOperation="signInOp">
    		<refFormat name="csRequestFormat" refId="signInOpSendFmt" />
    	</operation>
  7. Update service.xml
    Replace service.xml with the following:
     <CSClient id="realCSClient"
    			serverName="http://hostname:port/ContextRoot"
    			sessionType="NonSecure" retryOnError="true"
    			csAssignServletName="/servlet/com.ibm.btt.cs.servlet.CSAssignServiceIdAndServerTIDProtocolServlet"
    			csNotifClToSrvServletName="/servlet/com.ibm.btt.event.CSNotifClToSrvProtocolServlet"
    			csNotifSrvToClServletName="/servlet/com.ibm.btt.event.CSNotifSrvToClProtocolServlet"
    			csReqProtocolServletName="/servlet/com.ibm.btt.cs.servlet.CSReqProtocolServlet"
    			usedForServerToClientEventNotification="true"
    			reconnectionAttempts="20"
    			timeBetweenReconnectionAttempts="10000" userAgent="CSClient"
    			useProxy="false" proxyHost="localhost" proxyPort="9080"
    			serverCredentials="cred:cred" proxyCredentials="cred:cred"
    			defaultOperationTimeout="10000" keepAliveConnection="false"
    			runInSession="true" setTcpNoDelay="true" sendBufferSize="0"
    			permanentConnectionForEvents="true" eventsPort="8082" />
    Note: You must change the hostname, port, and ContexRoot in serverName="http://hostname:port/ContextRoot. In jump-start sample, the ContexRoot is BTTJumpStartSampleWeb.


Feedback