Form configuration
Properties
You can view and edit form properties on the Properties tab.
| Property | Description | ||
|---|---|---|---|
Form Name |
The name of the form. This name is used internally and isn’t visible to the end user. This property is required. |
||
Form Description |
A description of the form. This description is used internally and is not visible to the end user. |
||
Localization Display |
PingOne localization support. Valid displays are:
|
||
Show "Required" field indicators |
When selected, the form indicates the fields that the user must complete. |
||
Show "Optional" field indicators |
When selected, the form indicates the fields that are optional for the user. This property is selected by default. |
||
Enable for text fields |
When selected, autocomplete tools are enabled for text fields. This feature provides assistive tools to make the form more accessible for users. |
||
Enable for password fields |
When selected, autocomplete tools are enabled for password fields. This feature provides assistive tools to make the form more accessible for users. |
Fields
You can add any of the following fields on the Fields tab. After adding the fields, you can configure some of the field properties.
You can add additional user information categories by going to Directory > User Attributes in PingOne. After you add them, these new categories are available as field types.
|
When a form is modified and saved, it could have an immediate impact on a production flow depending on how it’s used in DaVinci. If you add new fields, you must go into the DaVinci flow and modify the mappings with new or updated fields. |
Custom Fields
| Field | Description |
|---|---|
Checkbox List |
A section with a list from which a user can select one or more options. |
Combobox |
A drop-down element for selecting from multiple possible values. |
Dropdown |
A drop-down element. |
Password |
A field for a user’s password. |
Phone Number Input |
A field for a user’s country code and phone number for validation. |
Radio Button List |
A section of options where a user can only select one. |
Text Input |
A field for a user’s text input. |
PingOne Attribute Fields
User Account
| Field | Description |
|---|---|
Username |
The account username. |
Password |
A field that allows the user to enter their current PingOne password or set a new one. Enable Verify Password to require the user to confirm the new password. Enable Show Password Requirements to show requirements set by the environment’s default password policy. |
Current Password |
A field that prompts the user to enter their current PingOne password for authentication. |
New Password |
A field that allows the user to set a new PingOne password. Enable Verify Password to require the user to confirm the new password. Enable Show Password Requirements to show requirements set by the environment’s default password policy. |
Recovery Code |
The recovery code for the user’s account. This field can be used with the New Password field for password recovery. |
Type |
The type of user. Must be |
Contact
| Field | Description |
|---|---|
Email Address |
The user’s email address. |
Primary Phone |
The user’s primary phone number. |
Mobile Phone |
The user’s mobile phone number. |
Name
| Field | Description |
|---|---|
Formatted |
The form of the user’s name. |
Given Name |
The user’s given name. |
Middle Name |
The user’s middle name. |
Family Name |
The user’s family name. |
Nickname |
The user’s nickname. |
Title |
The user’s title. |
Honorific Prefix |
The honorific prefix for the user’s name. |
Honorific Suffix |
The honorific suffix for the user’s name. |
Language
| Field | Description |
|---|---|
Locale |
The user’s locale. |
Preferred Language |
The user’s preferred language. |
Field properties
Clicking a field already in your form displays the field properties in the sidebar.
| Property | Description | ||
|---|---|---|---|
Field Type |
The type of field, such as Text Input or Password. |
||
Key |
The key value for the provided data.
|
||
Label |
The field label that’s displayed for the end user. |
||
Label Position |
Configures whether the label displays inside the field or above the field. Valid positions are:
|
||
Input Type |
The type of input provided by the user. Valid types are:
|
||
Width |
The width of the field. Valid values are:
|
||
Validation Type |
If you selected Text as the input type, this option lets you validate the text. Valid values are:
If you select Custom, the Regex and Error Message fields show. The Regex value is used to validate the text, and the Error Message value appears if the text is invalid. |
||
Verify Password |
If you selected Password as the input type, this checkbox adds a field to verify the provided password. |
||
Field Required |
This checkbox indicates that the field is required. The form properties determine whether optional or required fields are indicated. |
Toolbox
You can add any of the following components on the Toolbox tab to customize the layout and appearance of the form.
| Tool | Description | ||
|---|---|---|---|
Agreement |
Select an agreement configured in User Experience > Agreements to present to a user. |
||
Divider |
A horizontal divider. Add optional text to your divider in the Label field and align the text with Label Alignment. |
||
Empty Block |
An empty space that can be moved and resized. |
||
Error Display |
A space that shows any form or flow-level errors. |
||
Flow Button |
A customizable button to include in a form. |
||
Flow Link |
A custom link to include in a form. For example, you can add a Forgot Password link for password reset. |
||
Google reCAPTCHA v2 |
A Google reCAPTCHA tool can distinguish between human and automated accesses. You can customize the alignment, size, and theme of the reCAPTCHA tool.
|
||
Polling |
An activity indicator. This component also enables polling functionality and configuration in the PingOne Forms connector. |
||
QR Code |
A scannable QR code. This component is useful for several use cases, including prompting an end user to:
|
||
Rich Text |
A block of custom text.
|
||
Social Login |
A social login button. |
||
Translatable Rich Text |
A block of custom text that can be translated.
|
||
Submit Button |
A submit button. The button is removable. Forms configured with MFA components don’t require an additional submit button. |
||
Show Hidden |
When selected, displays any hidden elements. |
MFA components
You can use MFA components to create MFA forms for device authentication, device registration, and FIDO2 registration or authentication in your PingOne DaVinci flow.
| Tool | Description |
|---|---|
MFA - Device Selection Authentication |
Provides multiple authentication methods defined by the MFA policy or device list configured in your PingOne Forms connector. |
MFA - Device Selection Registration |
Provides multiple registration methods defined by the MFA policy or device list configured in your PingOne Forms connector. |
FIDO2 |
A submit button for FIDO2 registration or authentication forms. |