Dev GuideAPI ReferenceUser Guide
HomeDev GuideAPI Reference
Dev GuideAPI ReferenceUser GuideGitHubNuGetDev CommunityDoc feedbackLog In
GitHubNuGetDev CommunityDoc feedback

Note

Optimizely Forms is only supported by MVC-based websites and HTML5-compliant browsers.

An external system can connect with Optimizely Forms, and provide datasources (such as SQL tables). Each datasource can contain columns (like columns in an SQL table).

If Optimizely Forms detects an external system, the Forms edit view has a built-in user interface for mapping, as shown in the following images.

  • Datasource connection maps with a form.

  • Column connections map with a form element.

  • The mapping user interface is applied to` Form` and `FormElement`.

**Example 1**

580


**Example 2**

587


### Mapping table

The `mappingTable` (similar to the following code and image) is provided to `Actors` and `AutofillProvider` as `IDictionary<string, RemoteFieldInfo>`. The key is the `formElement.ElementName`, and the value is a `RemoteFieldInfo`, which contains information about the external system, such as datasource and column.


599

### Transfer form submission data to external system, using Actor
  • Actor provides full `SubmissionData`, and the active `MappingTable` (with external system).
  • On `Actor.Run()`...
    • `ActiveExternalFieldMappingTable` provides the `MappingTable` of the current active datasource (of the form).
    • `SubmissionData` is the data from the visitor.
    • `HttpRequest` and `HttpReponse` (to inspect the visitor, and modify the response, cookie, and so on, if needed).
From a combination of form submission, such as  **F1=[[email protected]](🔗), F2=Allan + a mapping table F1=SILVERPOP\_EMAIL, F2=RECIPIENTNAME**, actors have enough information to send **SILVERPOP\_EMAIL="[[email protected]](🔗)", RECIPIENTNAME="Allan"** to Acoustic (Silverpop) through a server-to-server API call.