Description:
This widget provides a control for entering a phone number, including the area code.
Inputs
- ID/Name - Name of widget generated by FlowWright (read-only field)
Design:
The Phone Number widget is an Engine-category form widget registered under the name phonenumber. Its implementation is associated with the FlowWright.Forms.clsPhoneNumber class in FlowWright.Forms.dll.
The Phone Number widget is registered as a form widget in FlowWright's Engine category. Its metadata identifies the display name as Phone Number and its implementation class as FlowWright.Forms.clsPhoneNumber.
To document or configure the widget accurately:
- Locate the Phone Number widget in the form designer.
- Add it to the relevant form, if available in the designer.
- Review the widget's properties in the designer to determine whether additional configuration is supported.
- Preview and test the form to confirm the displayed input, accepted phone-number formats, and any validation behavior.
- Verify how the entered value is saved and made available to subsequent form or workflow operations.
Typical Workflow Suggestions:
The following are potential use cases for a phone-number field in a FlowWright form. They assume the widget supports capturing a phone number; the supplied XML does not confirm its runtime behavior.
Customer Registration
Include a phone-number field in a customer registration form to collect contact information for a customer profile.
Employee Onboarding
Consider using the widget in an employee onboarding form to capture a contact number for personnel records.
Service Request Submission
Include a phone-number field in a service request form so that the requester can provide contact details for follow-up.
Vendor Registration
Use the widget as a candidate field in a vendor registration form to collect a vendor representative's contact number.
Appointment or Callback Requests
Include a phone-number field in an appointment or callback request form to capture the request-associated number.
These are illustrative workflow suggestions, not confirmed integrations or capabilities of the widget.
Example:
Let’s build and execute the “PhonenumberDef” example.
- Create a new Form Definition called “PhonenumberDef.”
- Drag the “BootstrapGrid, Label, PhoneNumber, and Submit” controls onto the canvas and arrange them as shown below.
- Double-click the “Phonenumber” to configure the “Settings” properties. A pop-up window appears for configuration. Provide a name for the control. Select the “Hide” checkbox to hide this widget at runtime. Click the “Lock Widget” button to toggle the lock/unlock feature and prevent accidental configuration changes. Click the “Save” button.
- Save the Form definition. Choose Actions > Create Form Instance. Generate a new Form instance, then check the box to edit it.
- The Form appears as shown below. Fill in the required information, then click the Submit button to complete the process.
Tips:
- Test input formats: Check whether local and international phone-number formats are accepted.
- Verify validation: Confirm whether invalid or incomplete numbers are rejected.
- Check required-field behavior: Determine whether the field can be made mandatory.
- Test persistence: Confirm that the entered value remains available after saving and reopening a form.
- Review data handling: Ensure phone numbers are handled appropriately wherever they are stored, displayed, or used.
Definition Sample:
You may download and extract the sample definition(s) from the link below and later import them (drag-and-drop) into your FlowWright Process Definition (XML file) or Form Definition (HTML file) page.
Note: Please verify and complete the import process steps for any missing configurations, such as file path references and database connections. Then, save the definition to confirm the changes.
Click here to download the sample file.