Design Studio

Pre-requisites
Archetype-catalog.xml file

Create Maven Project for Service

Open the Design Studio and Click on File -> New -> Maven Project

Configure > Add Local Catalog

Create Service Container Project
Open the Design Studio and Click on File -> New -> Maven Project
Workbench
Workshop 1 – Process FundsTransfer - POST
Artifacts generated

Add the generated artifacts to src/main/resources folder

Remove existing files.

Right-click IRIS-Demo > Run As > Maven Install

Maven Clean if Error

Inside the jar go to the below path as shown in the image and open pom.xml

Copy groupId, artifactId and version as highlighted below in pom.xml

Right Click Container project > Run As > Maven Build

This will create .war file in target

In the IRIS-DemoContainer.war file , open pom.xml as shown below

Add a section called dependency and paste the copied groupId, artefactId and version in pom.xml as
shown below

Copy the IRIS-Demo-0.0.1-SNAPSHOT.jar and place it in this path inside the IRIS-DemoContainer.war
file “C:\Temenos\R20\Products\DesignStudioT24-R20.21\workspace\IRIS-Demo\IRIS-
DemoContainer\target\IRIS-DemoContainer.war\WEB-INF\lib\”
Update standalone-comms.properties file

C:\Temenos\R20\Products\DesignStudioT24-R20.21\workspace\IRIS-Demo\IRIS-DemoContainer\
target\IRIS-DemoContainer.war\WEB-INF\classes\irf-config\

To Post request use:

http://localhost:9089/IRIS-DemoContainer/api/v1.0.0/party/payments/generic

If Credentials are needed then can be inserted like this:

http://localhost:9089/IRIS-DemoContainer/api/v1.0.0/party/payments/generic?validate_only=true

validate_only=true shall be removed as this will only validate

File > Import > Browse Swagger File

Construct base URL

Request:

{
"header": {
},
"body": {
"debitAccountId": "10995",
"debitCurrencyId": "USD",
"creditAccountId": "11193",
"creditCurrencyId": "USD",
"creditAmount": 500,
"transactionType": "AC"
}
}

Response:

{
"header": {
"transactionStatus": "Live",
"audit": {
 "T24_time": 5023,
"responseParse_time": 1,
"requestParse_time": 2,
"versionNumber": "1"
},
"id": "FT201087ZPVV",
"status": "success"
},
"body": {
"transactionType": "AC",
"debitCurrencyId": "USD",
"processingDate": "2020-04-17",
"creditCurrencyId": "USD",
"debitAccountId": "10995",
"creditAccountId": "11193",
"creditAmount": 500
}
}
Workshop 2 – Create Lending - POST
Create AA Lending using API.

Version to be copied.

AA.ARRANGEMENT.ACTIVITY,AA.NEW

API > Create Provider API

File > New > Maven Project > irf-service-archetype
Remove file from src/main/resources and place newly generated ones

Run As > Maven Clean

Run As > Maven Install

Got error:
Errors in swagger file demo-api-v1.0.0-swagger.json:
[INVALID_DESCRIPTION:Description is mandatory and should be in same
line:payload, INVALID_DESCRIPTION:Description is mandatory and should be in
same line:credentials, INVALID_DESCRIPTION:Description is mandatory and
should be in same line:companyId]

Fix error by updating swagger file

Now it is time to deploy in the container file.

Open the jar file. And go to the directory and open pom.xml file to get groupId, VersionId, artifact id.

<groupId>com.temenos.demo</groupId>
<artifactId>IRIS-Demo-ConsumerLoan</artifactId>
<version>0.0.1-SNAPSHOT</version>
In the container file, add dependency for this

Place jar file in the web-inf/libs

Deploy in deployments folder

Import swagger file in Postman

File > Import > Browse Swagger File

http://localhost:9089/IRIS-DemoContainer/api/v1.0.0/party/products

Request:

{
"header": {
"override": {
"overrideDetails": [
{
"id": "DM.CONFIRM.DOC",
"description": "Have you received Loan Agreement/AAA*203 from 100100}RECEIVED_NO
T RECEIVED",
"responseCode": "RECEIVED"
}
]
}
},
"body": {
"customerId": "100100",
"productId": "CONSUMER.LOAN",
"currencyId": "USD",
"commitment": {
"amount": 5000,
"term": "3M"
}
}
}

Reponse:

{
"header": {
"transactionStatus": "Live",
 "audit": {
"T24_time": 8024,
"responseParse_time": 18,
"requestParse_time": 1
},
"aaaId": "AAACT20108KNGQLYV5",
"status": "success"
},
"body": {
"arrangementActivity": {
"arrangementId": "AA201085TJ9W",
"productId": "CONSUMER.LOAN",
"activityRef": "LENDING-NEW-ARRANGEMENT",
"customerId": 100100,
"currencyId": "USD"
}
}
}
Workshop 3 – Create Customer - POST
CUSTOMER,TEST.API.V.1.0.0

Create Provider Api

 Remove {id} from URL

File > New > Maven Project

Copy the file created from workbench to src/main/resources (remove existing)

Before:

After:

Run As > Maven Clean

Run As > Maven Install

Got Error:
Errors in swagger file demo-api-v1.0.0-swagger.json:
[INVALID_DESCRIPTION:Description is mandatory and should be in same
line:credentials, INVALID_DESCRIPTION:Description is mandatory and should
be in same line:companyId]

 Add description field in credentials & companyId in swagger file.

Maven Clean

Maven Install

[INFO] BUILD SUCCESS

Target File Created.

Now it is time to deploy in the container file.

Open the jar file. And go to the directory and open pom.xml file to get groupId, VersionId, artifact id.
 <groupId>com.temenos.demo</groupId>

<artifactId>IRIS-Demo-Customer</artifactId>

<version>0.0.1-SNAPSHOT</version>

In the container file, add dependency for this

Add the jar file to web-inf/lib

 Update deployments file.

Time to test webservice.

URL:
http://localhost:9089/IRIS-DemoContainer/api/v1.0.0/party/customers/customer/testing

Headers:

Request:

{
"header": {
},
"body": {
"Name": [
{
"Name": "Ali Qazi"
}
],
"SecondName": [
{
"SecondName": "Sadan"
}
],
"Mnemonic": [
{
"Mnemonic": "C19990"
}
],
"ShortName": [
{
"ShortName": "Ali"
}
],
"Sector": [
{
"Sector": "1001"
}
],
"Language": [
{
"Language": "1"
}
]
}
}
Response:

{
"header": {
"transactionStatus": "Live",
"audit": {
"T24_time": 748,
"responseParse_time": 1,
"requestParse_time": 0,
"versionNumber": "1"
},
"id": "190298",
"status": "success"
},
"body": {
"Language": [
{
"Language": "1"
}
],
"Sector": [
{
"Sector": "1001"
}
],
"Mnemonic": [
{
"Mnemonic": "C19990"
}
],
"ShortName": [
{
"ShortName": "Ali"
}
],
"SecondName": [
{
"SecondName": "Sadan"
}
],
"Name": [
{
"Name": "Ali Qazi"
}
]
}
}
Workshop 4 – Create Customer with Multivalues – POST

Multi-value field:

Request:

{
"header": {
},
"body": {
"Name": [
{
"Name": "Ali Name 1"
},
{
"Name": "Ali Name 2"
}
],
"SecondName": [
{
"SecondName": "Ali ShortName 1"
},
{
"SecondName": "Ali ShortName 2"
}
],
"Mnemonic": [
{
"Mnemonic": "C19991"
}
],
"ShortName": [
{
 "ShortName": "Ali"
}
],
"Sector": [
{
"Sector": "1001"
}
],
"Language": [
{
"Language": "1"
}
]
}
}

Response:

{
"header": {
"transactionStatus": "Live",
"audit": {
"T24_time": 2248,
"responseParse_time": 10,
"requestParse_time": 5,
"versionNumber": "1"
},
"id": "190299",
"status": "success"
},
"body": {
"Language": [
{
"Language": "1"
}
],
"Sector": [
{
"Sector": "1001"
}
],
"Mnemonic": [
{
"Mnemonic": "C19991"
}
],
"ShortName": [
{
"ShortName": "Ali"
}
],
 "SecondName": [
{
"SecondName": "Ali ShortName 1"
},
{
"SecondName": "Ali ShortName 2"
}
],
"Name": [
{
"Name": "Ali Name 1"
},
{
"Name": "Ali Name 2"
}
]
}
}
Workshop 5 – Reverse FundsTransfer – DELETE

Reverse FT

Set function to reverse in …service…xml file in services folder of generated artifacts

Same steps:

Request:
http://localhost:9089/IRIS-DemoContainer/api/v1.0.0/party/payments/FT2009405KLT/generic

id mentioned in the URL

Response:

{
"header": {
"transactionStatus": "Reversed",
"audit": {
"T24_time": 5495,
"responseParse_time": 1,
"requestParse_time": 1844,
"versionNumber": "2"
},
"id": "FT2009405KLT",
"status": "success"
},
"body": {
"transactionType": "AC",
"debitCurrencyId": "CAD",
"processingDate": "2020-05-01",
"customerRate": "1.362924",
 "creditCurrencyId": "USD",
"debitAccountId": "79607",
"creditAccountId": "20656",
"overrides": [
{
"override": "DATE.GT.14}DATE MORE THAN 14 DAYS AHEAD"
},
{
"override": "DR.GT.FWD}DEBIT VALUE EXCEEDS MAX FWD VALUE"
},
{
"override": "GT.CR.VAL}CREDIT VALUE EXCEEDS MAX FWD VALUE"
}
],
"creditAmount": 132
}
}

From T24:
General
This is used to list all the available services:

http://localhost:9089/IRIS-DemoContainer/api/v1.0.0/meta/apis

{
"services": [
{
"service": "party-payments-demo-api.service.v1.0.0",
"endPoints": [
{
"method": "DELETE",
"uri": "/v1.0.0/party/payments/{id}/generic"
}
]
},
{
"service": "party-products-demo-api.service.v1.0.0",
"endPoints": [
{
"method": "POST",
"uri": "/v1.0.0/party/products/"
}
]
},
{
"service": "party-customers-demo-api.service.v1.0.0",
"endPoints": [
{
"method": "POST",
"uri": "/v1.0.0/party/customers/customer/testing"
}
]
}
],
"key": "demo-api-v1.0.0-swagger"
}
Workshop 6 – Enquiry for Account Details – GET
Remove resources and replace with generated ones

Add dependency for this ws

<groupId>com.temenos.demo</groupId>
<artifactId>IRIS-Demo-getAccountList</artifactId>
<version>0.0.1-SNAPSHOT</version>

Add the jar file in web-inf/lib

Testing the webservice

http://localhost:9089/IRIS-DemoContainer/api/v1.0.0/party/accountlist?accountId=16837

Response:

{
"header": {
"audit": {
"T24_time": 902,
"responseParse_time": 0,
"requestParse_time": 1
},
"page_start": 1,
"page_token": "202004174800777782.01,99",
"total_size": 1,
"page_size": 99
},
"body": [
 {
"accountId": "16837",
"customerId": "100391",
"mnemonic": "PACKERK",
"currency": "USD"
}
]
}
 Go to:
C:\Temenos\java\jdk1.8.0_162\bin>keytool -genkey -alias temenos -keyalg RSA -keystore
temenos.keystore -validity 365

Microsoft Windows [Version 6.3.9600]

(c) 2013 Microsoft Corporation. All rights reserved.

C:\Temenos\java\jdk1.8.0_162\bin>keytool -genkey -alias temenos -keyalg RSA -keystore temenos.keystore -validity 365
Enter keystore password:
Re-enter new password:
What is your first and last name?
[Unknown]: localhost
What is the name of your organizational unit?
[Unknown]: IT
What is the name of your organization?
[Unknown]: temenos
What is the name of your City or Locality?
[Unknown]: Birmingham
What is the name of your State or Province?
[Unknown]: WestMidlands
What is the two-letter country code for this unit?
[Unknown]: GB
Is CN=localhost, OU=IT, O=temenos, L=Birmingham, ST=WestMidlands, C=GB correct?
[no]: yes

Enter key password for <temenos>

(RETURN if same as keystore password):
Re-enter new password:

Warning:
The JKS keystore uses a proprietary format. It is recommended to migrate to PKCS12 which is an industry standard format
using "key
tool -importkeystore -srckeystore temenos.keystore -destkeystore temenos.keystore -deststoretype pkcs12".