12. Validate Input

Validating input to verify the content being provided. To recap the steps in the video:

Action Validation: Contact Number

Add an action to validate the data typed in for new contacts:

1. Open the Contacts stream,
2. Go to the section Actions, and add a new action
3. Give the action the following settings:
   1. Name: Validate Contact
   2. Display Name: Validate Contact
   3. Go to the section Action Validation

      • Type in the following expression, to check that phone numbers typed in contain only numbers or spaces:

        do (
            if (!matches(_form.ContactNumber, "[0-9 ]+"),
                error("Invalid phone number")
            )
        )

        Raising an error in a validation expression - using the error() function will stop the action at that point. That is, the data in the form will not be saved, and any other tasks in the action (e.g. running task plans) will not go ahead.

      • Go to the section Stream Item Action Rules
        • Add a Stream Item Action Rule
          • Add a Stream Action Item
            • Name: Validate Contact
            • Set Stream Item Action to Update
            • Press Apply
            • Tick Copy Values by Name
        1. Save all your changes to the action
        2. Drag the action on top of the Add button, and the Update button on the ContactManager dashboard.

Action Validation: Contact Name

We'll add some additional validation to check that the contacts names have been entered:

1. Open the configuration form for the Action Validate Contact
   1. You can either open the stream configuration form for Contacts, and find the list of actions; or click on the Add or Update button, and from the button configuration form, follow the quick link to the action details
2. Add a condition to the Action Validation to check that the FirstName and FamilyName are both set:
   1. Add the following expression to the existing Action Validation statement, to check that both names are provided:

if ( (isEmpty(_form.FirstName) || isEmpty(_form.FamilyName) ),
    error("Please complete both names for the contact")
)

Save your changes and that completes the configuration. It is useful to see what is going on behind the scenes - click on the Add button - in the configuration, you can see that by dragging the action on the button, you have set the action for the button to Validate Contact.
Go into App Mode. Type in a new contact, and include an invalid character in the telephone number - for example, a letter. This should be through an error. You can correct this, then save the new contact. Also test the contact name validation.

The final Action Validation should look like this:

do(
    // Validate the Contact Number
    if (!matches(_form.ContactNumber, "[0-9 ]+"),
        error("Invalid phone number")
    ),

	// Validate the Contact Names
    if ((isEmpty(_form.FirstName) || isEmpty(_form.FamilyName)),
        error("Please complete both names for the contact")
    )

)