Adding a New Field to an Existing Module

This doc explains how to add a new field to an existing module. Consider that the core system/Transact has an additional field named Birth Country that you want to add to the Personal Information module of the Infinity Origination journey. Currently, the Personal Info section is as follows.

You must make the following changes to add a field for Birth Country in the Personal Information module.

NOTE:
  • As the Birth Country field is already available in Transact, you need not configure the DBX DB.
  • The aforementioned changes are sufficient for the Applicant and Co-Applicant sections.

Client Application Extensions

This section provides information about the client-side changes that are required to add the Birth Country field to the Personal Information module. Client Application Extensions involve configuring the following elements:

UI/UX Modifications:

UI/UX modifications represent the changes that are required to enable the Birth Country field. As the UI is non-extensible, you must update the required forms directly. In this case, you have to create a new entry in the form that is associated with the Personal Information section. To do so, make the following configurations in the Infinity Origination Visualizer project.

  1. Go to Project Explorer > Forms. Open the form that is used for the Personal Information section.
    Consider that you want to add the Birth Country field after the Email Address field. To do so, you must modify the component that is linked to the Personal Information section. In this case, the personal information section uses the com.nuo.UserInformation component.
  2. Go to Templates and search for the com.nuo.UserInformation component, and add a new flex row for birth country below the UI element of email address.
  3. In the Action Editor, configure the Flex fields for this flex row.
  4. After configuring the Flex fields, insert the com.loans.AnimatedTextBox component into the flex row that you added and rename it as atbxBirthCountry.
  5. Open the lblAnimatedKA label and configure the following fields in the Action Editor:
    • Change the value of the Text field to Birth Country.
    • Map the respective i18n key in the Text i18n Key field.

NOTE: The layout of the screens is created by the designers of the implementation team. Based on the layout design, the developers of the implementation team configure the layout properties.

To add i18n keys for the birth country field, follow these steps.

  1. From the main menu, go to Edit > Internationalization. The Configure Internationalization screen appears.

  2. Click the plus (+) button. A new key is added.
  3. Add the required i18n keys as follows.

These keys are used in the code as follows.

kony.i18n.getLocalizedString("kony.nuo.PersonalInfo.InvalidBirthCountry")

Form Controller Extension

To make a change in a form, you cannot directly modify the code in the Form Controller. You must create a Form Controller Extension and modify the code as required. A Form Controller Extension is required to validate the new fields. It includes operations such as the addition of a JSON payload, fetching the back-end response, and mapping the error modules.

To create a form controller extension in the Infinity Origination Visualizer project, follow these steps.

  1. In the Project explorer, expand the Modules section.
  2. Right-click the require tab, and then select New Require module. A new JS file is created.
  3. Rename the new JS file to PersonalInfoControllerExtn.
  4. Define the functions that are required for the Birth Country field in the PersonalInfoControllerExtn file. The functions are as follows.
    • resetfocus()
      resetFocus: function() {
    this.super('resetFocus', []);
    this.view.UserInformation.atbcBirthCountry.tbxAnimatedKA.onEndEditing();
}
    • resetSkin()
      resetSkins: function () {
      this.super('resetSkins',[]);
      this.view.UserInformation.lblError2.setVisibility(false);
      this.view.UserInformation.atbxBirthCountry.flxUnderlineKA.skin = applicationManager.getConfigurationManager().getConfigurationValue("underlineSkin");
    }
    • setDefaultValues()
      setDefaultValues: function() {
    this.super('setDefaultValues', []);
    this.view.UserInformation.tbxAnimatedKA.text = '';
}
    • getPersonalinfoPayload()
      getPersonalinfoPayload: function() {
    var extPayload = this.super('getPersonalinfoPayload', []);
    extPayload.BirthCountry = this.view.UserInformation.atbxBirthCountry.tbxAnimatedKA.text;
    return extPayload;
}
    • populatePersonalInfo()
      populatePersonalInfo: function(personalInfo) {
    this.super('populatePersonalInfo', [personalInfo]);
    this.view.UserInformation.atbxBirthCountry.tbxAnimatedKA.text = personalInfo.BirthCountry;
    this.resetFocus();
}
    • populatePartyResponse()
      populatePartyResponse: function(personalInfo) {
    this.super('populatePartyResponse', personalInfo);
    this.view.UserInformation.atbxBirthCountry.tbxAnimatedKA.text = personalInfo.BirthCountry;
}
    • populateScannedData()
      populateScannedData: function(data) {
    this.super('populateScannedData', [data]);
    this.view.UserInformation.atbxBirthCountry.tbxAnimatedKA.text = "";
}
  5. After you define the functions, link the new extension file to your ModuleConfig file of the Personal Information module. To do so, go to Project > Reference Architecture Extensions > PersonalInfoModule > Config > ModuleConfig.
    Add the following code to the Forms method:
    "ControllerExtensions": ["PersonalInfoControllerExtn"]

Data Validation

After you add a new field, you can define certain rules that are specific to the Birth Country field. For example, if the name of your birth country supports only 10 characters and you enter an 11-character word, the app should throw an error. These details must be defined in the Spotlight app and Form Controller Extension. To do so, follow these steps.

  1. Open the Spotlight app.
  2. From the left pane, select System Configurations. The System Configurations page appears.


  3. Open the Infinity Origination bundle named Retail Origination_Infinity . The View Bundle page appears that contains the details of the Infinity Origination keys.


  4. Search for the DATA_VALIDATION_NUO key and select Edit from the contextual menu. The Add Configuration window appears.


  5. In the Value field, add the Birth Country field along with the validation rule and click Update.

  6. After updating the DATA_VALIDATION_NUO key, click Update in the View Bundle page. For more information about adding configurations in the Spotlight app, click here.

    The DATA_VALIDATION_NUO is as follows.

    {
    "PersonalInfo": {
        "FirstName": "FIRSTNAME",
        "LastName": "LASTNAME",
        "Age": "MINOR_AGE",
        "Email": "EMAIL",
        "MobileNumber": "MOBILE_NUMBER",
        "BirthCountry": "NAME",
        "CIF": "ID_ALPHANUMERIC",
        "DateOfBirth": "DATE",
        "IsExistentMember": "BOOLEAN"
    },
    "IdentityInfo": {
        "IdNum": "ID_ALPHANUMERIC"
    },
    "AddressInfo": {
        "Country": "NAME",
        "State": "NAME",
        "Zipcode": "ZIPCODE"
    }
}

    NOTE: The NAME rule is used as an example for validating the Birth Country field. In the Spotlight app, each field can be associated with either a rule from the common rule set or a custom rule. To create or use the rules for data validation, refer to Data Validation.

  7. After configuring the Infinity Origination Bundle in the Spotlight app, you must define the following functions in the Form Controller Extension (PersonalInfoControllerExtn) that you created.
    • Error scenario for the Birth Country field
      showWidgetErrors: function(response) {
    this.super('showWidgetErrors', [response]);
    for (var key in response) {
        if (response[key] !== "") {
            if (key === "BirthCountry") {
                this.view.UserInformation.atbxBirthCountry.flxUnderlineKA.skin = applicationManager.getConfigurationManager().getConfigurationValue("underlineErrorSkin");
                section2Err = response.BirthCountry;
                this.view.UserInformation.lblError2.setVisibility(true);
                this.view.UserInformation.lblError2.text = section2Err;
            }
        }
    }

      Map the underlineErrorSkin skin to flxUnderlineKA in the error scenario. The error is displayed in the lblError2 label.
    • As the Birth Country is a mandatory field, you must define the necessary field validations. To do so, define the following functions in the Form Controller of the Personal Information module.

      These functions map the underlineErrorSkin skin to flxUnderlineKA in error scenario and disable the Continue button if the Birth Country field is empty.
      initActions: function() {
    this.super('initActions', []);
    this.view.UserInformation.atbxBirthCountry.tbxAnimatedKA.onKeyUp = this.onBirthCountryTextChange.bind(this);
},

onBirthCountryTextChange: function() { //called by initActions()
    if (this.view.UserInformation.atbxBirthCountry.tbxAnimatedKA.text.trim() != "") {
        this.view.UserInformation.atbxBirthCountry.flxUnderlineKA.skin = applicationManager.getConfigurationManager().getConfigurationValue("underlineSkin");
    }
    this.changeContinueButtonState();
},

isPersonalInformationValid: function() { // called by this.changeContinueButtonState()
    var isvalid = this.super('isPersonalInformationValid', []);
    var birthCountry = this.view.UserInformation.atbxBirthCountry.tbxAnimatedKA.text.trim() === "" ? false : true;
    return isvalid && birthCountry;
}

Origination Data Microservice

After you create and configure new fields on the client-side, you must extend the ODMS functionality.

Update the ODMS

  1. Open Postman.
  2. From the left pane, expand the Storage-MS-API collection.
  3. Click Update Entity Definition By Code and then navigate to the Body tab.
  4. In the code, under the entityItemDefinitions, go to the Personal Information entity.
  5. Add the BirthCountry parameter in the value of the seed key.
    "seed": "{\"Title\":\"\",\"FirstName\":\"\",\"MiddleName\":\"\",\"LastName\":\"\",\”BirthCountry\”:\”\”,\"DateOfBirth\":\"\",\"Email\":\"\",\"MobileCountryCode\":\"\",\"MobileNumber\":\"\"}"
  6. Then, click Send.
    The new field is updated.

Server-side Extensions

This section provides information about the server-side changes that are required to add the Birth Country field to the Personal Information module.

After you implement the client application and extend the ODMS functionality, you must configure the server-side implementations to bind the UI elements with the back-end data. This involves configuring the following elements:

Java Integration Service

This section explains how to extend the existing data transfer objects to add a new field. This facilitates storing the new data in the back end.

IMPORTANT: Before configuring Java Integration Service, ensure to set up an IDE and configure the server-side code.

In the case of adding the Birth Country field, you must configure the java services for the following projects:

Onboarding

To modify the Onboarding Java Service, follow these steps.

  1. Open your Eclipse project.
  2. Create a new maven project.
  3. Add the base Infinity Origination Java Project as a dependency in the pom.xml file.
    <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.temenos</groupId>
  <artifactId>OnBoardingServicesImpl</artifactId>
  <name>OnBoardingServicesImpl</name>
  
  <dependencies>
		<dependency>
			<groupId>com.temenos</groupId>
			<artifactId>OnBoardingServices</artifactId>
			<version>0.0.1</version>
		</dependency>
  </dependencies>
		
</project>
  4. Build the jar by using the maven commands.

DbpLocalServices

To create a party and a core customer record, you must configure the Fabric queue system. To store the new entries in the Party microservice or Core system, you must extend the DbpLocalServices project.

NOTE: The extensibility for the Party microservice is enabled, by default. In the Party microservice, the product APIs support storage and retrieval of the extension data along with the product data. To do so, the product API payload contains the extension data JSON.

The POST/PUT APIs are used to create/update the extension data along with the product data whereas the GET API is used to retrieve the extension data.

To extend the DbpLocalServices project, follow these steps.

  1. Open your Eclipse project.
  2. Create a new maven project and add the DbpLocalServices project as a dependency.
  3. To add a new field, you must extend the Customer DTO functionality by creating a new class named CustomerDTOExtn.java as follows.
    package com.temenos.extn.dbx.product.dto;

import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
import com.fasterxml.jackson.annotation.JsonInclude;
import com.fasterxml.jackson.annotation.JsonInclude.Include;

@JsonIgnoreProperties(ignoreUnknown = true)
@JsonInclude(value = Include.NON_NULL)
public class CustomerDTOExtn {

	private static final long serialVersionUID = -5256207912161885043L;
	
	private String birthCountry;
	public String getBirthCountry() {
		return birthCountry;
	}

	public void setBirthCountry(String birthCountry) {
		this.birthCountry = birthCountry;
	}	
}
  4. Extend the functionality of the buildCustomerDto method of CustomerUtils that is invoked from the Resource layer. To do so, create a new class named CustomerUtilsExtn.java.
    public static CustomerDTO buildCustomerDTO(String customerID, Map<String, String> inputParamMap, DataControllerRequest dcRequest) {
    CustomerDTOExtn customerDTO = super.buildCustomerDTO(String customerID, Map<String, String> inputParamMap, DataControllerRequest dcRequest);
    CustomerDTOExtn.setBirthCountry(dcRequest.getParameter("BirthCountry"));
 }
  5. Extend the functionality of the buildPartyDTO method that is invoked from the Business Delegate. To do so, create a new class named CustomerUtilsExtn.java.
    public static PartyDTO buildPartyDTO(CustomerDTO customerDTO, PartyDTO partyDTO) {
  PartyDTO partyData = super.buildPartyDTO(CustomerDTO customerDTO, PartyDTO partyDTO);
  PartyNames names = partyData.getPartyNames();
  names.setExtensionData(customerDTO.getBirthCountry);
  partyData.setPartyNames(customerDTO.getirthCountry);
  return partyData
}
  6. Build the jar by using the maven commands.

Experience API Changes in Quantum Fabric

For the Birth Country field to work, you must create the back-end data in Quantum Fabric and link it to the front-end data. To do so, follow these steps.

  1. Sign in to your Quantum Fabric Console. The Applications page opens.
  2. Open the Origination app from the Applications page.
  3. In the Integration tab, go to the OnboardingJavaServices service definition.
  4. Expand the Advanced section. In the Custom Code tab, click Upload New and add the java service that you configured for the Origination project.
    This java service extends the available jar package and binds the new java service as an extended package. It also overrides the existing jar file operations.

  5. Add the BirthCountry field as a request parameter to the applicable operations. For example, createApplicant operation.
  6. Go to the OnboardingDBXServices service definition and open the createDBXProspect operation.
  7. Under the Request Input section, add the BirthCountry field as a request parameter.

  8. After adding the request parameter, open the Objects tab, go to the PersonalInfo object model and add the Birth Country entry under Fields.

  9. Save the changes and publish the application.
  10. After publishing the application, test the service from the Console.

    Sample Request Payload

    {
"Application_id" : "2D5SRWW",
"ApplicantType" : "Applicant",
"FirstName" : "Something",
"LastName" : "Another",
"Email" : "sad@sac.com",
"DateOfBirth" : "1990-10-10",
"MobileCountryCode" : "+91",
"BirthCountry" : "India"
}

    Sample Response Output

Expand/Collapse
Share
Print

In this topic

Copyright © 2020- Temenos Headquarters SA

Published on :
Monday, May 2, 2022 5:51:19 PM IST

Feedback
x