Setting Up Default Language For SMS & Emails

Owned by Anjoo Narayan
Last updated: Sept 08, 2020 by Priyanka Rani (Unlicensed)
3 min read

Overview

Through SMS and Emails necessary information/updates are communicated to the users on their various transactions on DIGIT applications.
For example when a Trade License application is initiated or forwarded or approved or payment done in digit system, the applicant and payer (if payer is other than applicant) will be informed about the status of Trade License application through SMS/Email.
The language for SMS and Email can be set as per requirement/choice.

Pre-requisites

Before proceeding with the configuration, make sure the following pre-requisites are met -

  • Knowledge of DIGIT applications is required.

  • User should be aware of transactional steps in the DIGIT application.

Key Functionalities

  • User can receive Emails and SMS of necessary information/updates in the decided language.

  • The language can be decided by the end-users (either Citizen or Employee). End -users can select the language before logging in or after logging, from inbox page.

  • If the language is not chosen by end-user, then SMS/Email is received in the language of, State requirement based state-level configured language.

Configuration Details

  1. Sms and Email localization should be pushed to the database through the endpoints for all the languages added in system.
    Localization format for SMS/Email:

    { "code": "unique key referred for sms or email", "message": "sms value or email to be received", "module": "rainmaker-<modulename>", "locale": "<language key>" }

    Sample of SMS localisation for Trade License application initiation:
    English localization:

    { "code": "tl.en.counter.initiate", "message": "Dear <1>, Your Trade License application number for <2> has been generated. Your application no. is <3> You can use this application number to know your application status. Thank You. NagarSewa.", "module": "rainmaker-tl", "locale": "en_IN" }


    Hindi localization:

    { "code": "tl.en.counter.initiate", "message": "प्रिय <1>, <2> के व्यापार लाइसेंस के आवेदन के लिए आपका व्यापार लाइसेंस आवेदन संख्या <3> है। आप इस आवेदन संख्या का उपयोग अपनी आवेदन स्थिति जानने के लिए कर सकते हैं। धन्यवाद। नगरसेवा।", "module": "rainmaker-tl", "locale": "hi_IN" }

    Note:-
    The placeholder <1>,<2>,<3> will the replaced by the actual required value which gives important information to the applicant.
    For example: The message will be received by applicant as:
    Dear Kamal, Your Trade License application number for Ramjhula Provisional Store has been generated. Your application no. is UK-TL-2020-07-10-002058 You can use this application number….

  2. Default language for SMS and Email can be set by:
    a) Clicking on the choice language from available language button, in language selection page, which opens before login page.
    b) In Citizen or Employee inbox page, the language can be selected from the drop down, which can be seen in right corner of inbox title bar.
    c) If the language is not chosen by Citizen or Employee, then SMS/Email is received in default configured language. For example in a State if Hindi, English, Kannada are added as three languages in the system and out of these three languages if State decides that Kannada should be configured as default language then Kannada is set as default language in mdms. So when end-user does not choose any language then SMS/Email is send in Kannada language.

  3. The selected language key is send as a parameter along with other required transaction parameter to the back end code.

  4. In the back end, to send SMS/Email logic, language key is checked and based on the language key and SMS unique key, the message is fetched from the database.