PingOne

Form 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 PING_ONE or EXTERNAL. Use this field for forms that allow administrators to create users

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.

Address

Field Description

Street Address

The street address.

City / Locality

The town or locale.

Region

The state or region.

Postal Code

The zip code or postal code.

Country Code

The three-digit country code.

Timezone

The user’s time zone.

Photo

Field Description

Photos Link

The URL for the user’s photo.

Field properties

Clicking on 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.

This property can only be edited for custom fields.

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:

  • Inside

  • Above

Input Type

The type of input provided by the user. Valid types are:

Text

A text field with option validation.

Password

A password-specific field with optional confirmation.

Dropdown

A drop-down list with one or more options you can configure under Options.

ComboBox

A drop-down menu with one or more options you can configure under Options.

Radio

A set of radio buttons.

Single Checkbox

A single checkbox that can be configured to display as a checkbox or toggle.

Checkbox

A set of checkboxes with one or more options.

Phone Number

Turns field into a phone number input component.

Width

The width of the field. Valid values are:

  • Flex (fills the available space)

  • 25%

  • 50%

  • 75%

Validation Type

If you selected Text as the input type, this option lets you validate the text. Valid values are:

  • None

  • Custom

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.