Skip to Content

Define a Validation Rule in an MDK App

test
0 %
Define a Validation Rule in an MDK App
Details

Define a Validation Rule in an MDK App

Jitendra Kansal
Jitendra Kansal
May 9, 2021
Created by
jitendrakansal
April 23, 2019
Beginner
10 min.
mobile development kit client, SAP Business Technology Platform, Mobile, Tutorial, iOS, SAP Business Application Studio, Android, SAP Mobile Services, Beginner
Write a JavaScript logic to validate an email address format in an MDK app.

You will learn

  • How to write a rule to validate an UI field
QR code

MDK
Step 1: Create a validation message

When allowing end-users to make updates to data, it is important to add validation rules to verify that they are entering valid information.
If the Update action fails due to the validation rule, the application will display a validation failure message to the end-user. You can customize this message by creating a Message action and adding the action to the validation Failure Message field in the Update action.

  1. Right-click the Actions folder | MDK: New Action | choose MDK Message Actions in Category | click Message Action | Next.

    MDK

  2. Provide the below information:

    Field Value
    Action Name ValidationFailure
    Type Select Message from the dropdown
    Message Email address is not in the correct format recipient @ domain . domaintype
    Title Validate Email
    OKCaption OK
    OnOK --None--
    CancelCaption leave it blank
    OnCancel --None--
    MDK

  3. Click Next and then Finish on the Confirmation step.

Done
Log on to answer question
Step 2: Create a new rule
View Full Instructions

In the MDK editor, you will create a new JavaScript file called EmailValidation.js to handle validation if a @ symbol exists in the email address. In the validation rule, you will grab the data entered by the end-user, validate it and check for the @ symbol then return true if the email address is of a valid format or false if it is not. The returning result of the validation rule can be used in the Update action to determine whether the action succeeds or fails.

You can find more details about writing a Rule.

  1. Right-click the Rules folder | MDK: New Rule File | select Empty JS Rule.

    MDK

  2. Enter the Rule name EmailValidation, click Next and then Finish on the confirmation step.

    MDK

  3. Replace the generated snippet with below code.

    export default function EmailValidation(context) {
    //The following evaluateTargetPath will retrieve the current value of the email control
    if ((context.evaluateTargetPath('#Control:FCEmail/#Value').indexOf('@')) === -1) {
        //If email value does not contain @ display a validation failure message to the end-user
        context.executeAction('/DemoSampleApp/Actions/ValidationFailure.action');
    } else {
        //If @ is present in the email value, return true to indicate validation is successful
        return true;
    }
}

  4. Save the changes.

    The indexOf() method returns the index within the calling String object of the first occurrence of the specified value and -1, if no occurrence is found.

    In above code there is a reference to ValidationFailure.action , you can navigate directly from here to the MDK file by right clicking on it.
    MDK

Done
Log on to answer question
Step 3: Add the validtion rule to the Update entity

Now, that you have created the validation rule, you will add it to the Update action. This will tell the Update action to run the validation rule before saving any data. If the validation rule is successful, the Update action will save the changes as expected. If the validation rule fails, the end-user receives the validation failure message telling them useful information so they can fix the problem before continuing.

  1. Open Customers_UpdateEntity.action by double clicking on the action in the project explorer pane.

  2. Expand the Common Action Properties and select EmailValidation.js rule for Validation Rule field.

    MDK
What is the executeAction path set in EmailValidation.js rule?
×
Step 4: Deploy the application

Deploy the updated application to your MDK client.

  1. Right-click Application.app and select MDK: Deploy.

    MDK

  2. Select deploy target as Mobile & Cloud.

    MDK

    You should see success message for both deployments.

    MDK
Done
Log on to answer question
Step 5: Test the application

Make sure you are choosing the right device platform tab above.

  1. Re-launch the app on your device, you may asked to authenticate with passcode or Biometric authentication. You will see a Confirmation pop-up, click OK.

  2. In EMAIL property, enter a value with no contain of @, it throws a validation failure message on saving the record.

    MDKMDK

  1. Re-launch the app on your device, you may asked to authenticate with passcode or Biometric authentication. You will see a Confirmation pop-up, click OK.

  2. In Email property, enter a value with no contain of @, it throws a validation failure message on saving the record.

    MDKMDK

  1. Either click the highlighted button or refresh the web page to load the changes.

    MDK

    If you see the error 404 Not Found: Requested route ('xxxxxtrial-dev-nsdemosampleapp-approuter.cfapps.xxxx.hana.ondemand.com') does not exist. while accessing the web application, make sure that in your space cockpit, highlight applications are in started state.

    MDK

  2. In Email property, enter a value with no contain of @, it throws a validation failure message on saving the record.

    MDKMDK
For which example, validation rule returns false?
×

Congratulations, you have successfully completed create Your First MDK Application mission and you are now all set to enhance Your First MDK App with Additional Functionalities mission.

Next Steps

Navigate tutorial steps

QR Code

QR code
Back to top