The PingOne Forms connector lets you include branded forms and messages in your PingOne DaVinci flow.
You can use the PingOne Forms connector to:
- Build flows that include user experiences that you create on the PingOne. tab in
- Show messages using the branding that you define on the PingOne. tab in
Forms are only supported in flows that integrate with your application using the Redirect method.
Setup
Resources
For information and setup help, see the following documentation:
- PingOne Forms
- DaVinci documentation:
Requirements
To use the connector, you'll need:
- A PingOne license
Setting up PingOne Forms
- Creating a form
-
If you want to include a form in your flow, create it in PingOne. For help, see Creating a form.
- Configuring branding for a custom message
-
If you want to include a branded message in your flow, configure your branding in PingOne. For help, see Branding and themes.
Setting up the PingOne Forms connector configuration
Add the connector in DaVinci as shown in Adding a connector. There is no connector configuration.
Using the connector in a flow
Including a form in a flow
The Show Form capability lets you present any form that you create with the drag-and-drop form builder. You can optionally pre-populate form fields with variables from your flow.
For more information about creating forms, see Forms.
- In your flow, add the PingOne Forms connector and select the Show Form capability. Select the node that appears in your flow.
- In the Form list, select a form.
- In the Form Theme list, select a theme for the form.Note:
This list is populated with themes configured in PingOne under . Each theme also has a unique Theme ID which can be copied and pasted into the connector after selecting Use Theme ID.
If no theme is selected, the default PingOne Active Theme will be displayed.
- (Optional) In the Pre-Populate Field Values section, map
flow variables to any fields that you want to be pre-populated when the user sees
the form.
- Find the form field in the Key column.
- In the Value column, enter a static value or click {} to use a variable from your flow.
- (Optional) Click the Enable Device Profiling toggle to enable the PingOne Protect SDK to collect device information.
- (Optional) Click the Include Behavioral Data toggle to
identify non-human activity through behavioral data collection.Note:
To enable Include Behavioral Data, you must first Enable Device Profiling.
- Click Apply.
Showing a message with your branding
The Show Branded Message capability lets you show the user a message within a frame that is branded according to the settings on the tab in PingOne.
- In your flow, add the PingOne Forms connector and select the Show Branded Message capability. Select the node that appears in your flow.
- In the Message field, enter static text or click {} to include variables from your flow.
- In the Form Theme list, select a theme for the branded
message.Note:
This list is populated with themes configured in PingOne under . Each theme also has a unique Theme ID which can be copied and pasted into the connector after selecting Use Theme ID.
If no theme is selected, the default PingOne Active Theme will be displayed.
- Click Apply.