The first step in designing models is to create an IRIS Project.
In the DS workbench application, projects are top-level containers that store and organize
a project’s resources.
• On clicking on File -> New -> Other, ‘New Project Wizard’ opens up.
• Navigate to ‘Design Studio’ and on expanding it the ‘Design Studio Template Projects’ is
available.
Choose IRIS Data Service Project from the Design Studio Template Projects.
• The project name is entered in the project-name property.
• On clicking on Finish new IRIS project is created.
Configure Server Properties:
A Design Studio server provides a connection to a T24 environment. A server is also a
project with a name and properties. The workspace can hold many servers, pointing to one
or many T24 environments.
A server can be either:
• jAgent:- T24 jbase_agent, providing a listening port on remote server.
• Web Service: communication service over the Web. This is the type of server required for
TAFJ installation.
Double click on server.properties in the –server project to open the server properties in the
editor window. Enter a valid T24 username and password. For the tafj runtime, choose the
protocol as ws.
In the Server view pane, right-click on the server name and choose Add/Remove
project(s)... A dialog box is displayed with a list of all -gen projects of the workspace.
Check each project to deploy and click OK to validate the selection.
Start Server:
Now we will start Tafj server.
For Enquiry:
Select File > Import > Design Studio - Import T24 Enquiries. T24 Enquiries
import wizard is opened.
• Select the T24 server from the list and click on Next. DS connects to the T24
server and retrieves all the existing enquiries from the ENQUIRY application.
• Select the enquiry you want to import. For a global selection, click on the
Select All button. You can filter the selection by the enquiry name, product
and component.
• Click on Next
• Select the package where you want the enquiry to be imported and then click on the
‘Finish’ button.
• The imported enquiry model is displayed here
For Version/Screen:
Step#1: Create folder for Application
Step#2: Import Application
Step#3: Create screen folder
Step#4: Import Screen
• Select File > Import > Design Studio - Import T24 Screens. T24 Screens import wizard is
opened.
• Select the T24 server from the list and click on Next. DS connects to the T24 server and
retrieves all the existing versions from the VERSION application.
• Select the version you want to import. For a global selection, click on the Select All
button. You can filter the selection by the Application, Screen Name, Product, Component
and Description.
• Click on Next.
• Select the package where you want the screens to be imported and then click on the
‘Finish’ button.
• The imported screen model is displayed here.
Step#5: Generate RIM
• To generate the resource and interaction models from the T24 models, we must run
Generate Code for these models in DS. Right click on the specific T24 model or the folder
containing the models > Design Studio > Generate Code. This will generate the data service
resources that will become part of the web application deployed for the interaction
service. The data service resources are:
1. A *.rim file – Resource Interaction Model. This is a model file which defines the
“interactions between the resources” that are made available to the user agent through
this interaction service.
2. A *.properties file which contains the mapping between the T24 field names and the
OData fields.
3. Metadata files *.xml, which contains the metadata information of all the fields in the
application i.e., the attributes of the fields,
As shown in the snapshot, when you Generate Code for the
TC.EB.EXTERNAL.USER.enquiry and CUSTOMER,TC.version, corresponding *.rim files gets
generated.
Step#6: Update Service Document
Open Test.rim file, scroll down to initial resource Service Document and add resource links
GET -> T24.enqTcEbExternalUser.enqTcEbExternalUsers
GET -> T24.verCustomer_Tc.verCustomer_Tcs
Step#7: Build Data Service
• To get a deployable war for an external application server, you can build the project using
maven.
In the –iris-parent folder right click on the Package.launch > Run As > Package.
• This will generate a war file in the Test-iris/target folder by the project name – Test-
iris.war.
Step#8: Deploy Web Application
• Copy the Test-iris.war file which gets generated in the target folder of the Test-iris project
into the deployments folder of JBoss.
• Update the T24 resource provider files with OFS value as TCIB
• Now the interaction service is ready to be accessed.
• Access the service deployed on JBoss using this url:
http://localhost:9089/Testiris/Test.svc/GB0010001
