Set up a Phone field
Level: beginner
Use Phone fields to manage phone numbers. This is particularly useful for any app that involves internal or external communication.
Example
Set up a Preferred contact phone (request) phone field on the request page. Apply the phone pattern to field values.
- Drag a Phone field to the canvas and open the field setup area.
- Enter “Preferred contact phone (request)” in the Title parameter. You can click the button to the right to localize the title to other languages you are going to use in the app. Learn more about localizing Freedom UI elements in a separate article: Localize a Freedom UI element.
- Review the unique name Creatio uses to add a column in the Code parameter. The parameter is populated automatically. You can specify a custom code that starts with the prefix specified in the “Prefix for object name” (“SchemaNamePrefix”) system setting (by default, “Usr”) if needed. This helps no-code creators and software developers to grow and maintain the app easier. For this example, change the code to “UsrRequestPreferredContactPhone.”
- View the field format in the Format parameter. Only “Phone number” value is available.
- Enter internal information about the field that helps to understand its functionality in the Description parameter. Creatio displays this information in the Object Designer. For this example, enter “Preferred contact phone specified by the requester. If the field is empty, use the phone specified on the contact page.” You can localize the parameter similarly to the Title parameter.
- Select No in the Required parameter.
- Clear the Copy this value while copying records checkbox to prevent Creatio from copying the field value to the record copy in the list. This option is useful for fields that contain system values, auto-populated data, or unique record data.
- Select the Display input mask checkbox to apply the phone number pattern to field values, i. e., add a selectable country code and spaces between the country code, operator code, and the number itself. For example, “+44 9999 111456.”
- Select the Read-only checkbox to make the field read-only. For this example, leave the checkbox clear.
- Click the or button in the Visibility group to make the element visible or invisible by default on the page, respectively. For this example, leave the field visible.
- Click Setup conditions in the Visibility group to set up element business rules. For this example, do not add business rules. Learn more about setting up business rules in a separate article: Set up business rules.
- Specify the position of the title relative to the field in the Title position parameter. For this example, select “Above.”
- Enter Title on page parameter if the title on the page must differ from the title in Creatio. For this example, enter “Preferred contact phone.” You can localize the parameter similarly to the Title parameter.
- Enter the hint on how to fill out the field in the Placeholder parameter. Creatio displays hints in fields before a user starts entering a value. For this example, leave the parameter empty. If you fill out the parameter, you can localize it similarly to the Title parameter.
- Enter the tooltip that contains an additional hint in the Tooltip parameter. After you fill out the parameter, Creatio displays the icon next to the field. Hold the pointer over the icon to view the tooltip. For this example, enter “If you leave the field empty, you will be contacted via the phone specified on your contact page.” You can localize the parameter similarly to the Title parameter.
- Change the data source in the Data source parameter. For this example, use the original data source.
- View the unique field code in the page schema in the Element code parameter. Creatio uses this code in page schemas. You can change it if needed. This helps software developers to customize the app easier, especially if you have multiple similar fields on the page. For this example, leave the code as is.
As a result, Creatio will add the Preferred contact phone (request) phone field to the request page. The field will apply the phone number pattern to its values.
See also
Overview of Freedom UI Designer and its elements