Capturing submission data from an external form

You can integrate an external form into Oracle Eloqua, or an Oracle Eloqua form into an external web page. This is useful when you want to extend the audience of the form, or post the form on an external site and use Oracle Eloqua to collect all form data.

Important: Integrating an external form with Oracle Eloqua requires a working knowledge of HTML.

Before you begin:

  • The domain hosting your form must be added to the domain whitelist.
  • Integrating an external form creates a form within Oracle Eloqua, and requires you to update the HTML of the domain hosting the external form.

To capture submission data from an external form:

  1. Navigate to Assets An image of the Assets icon, which is represented by a black pencil., then click Forms.
  2. Click Integrate an External Form.
  3. Copy the URL of the external form and paste it into the blank field of the External Form Integration wizard, then click Next Step.

    An image of the external form integration wizard with the URL field highlighted.

    Note: The domain hosting your form needs to be in the domain whitelist, otherwise Oracle Eloqua returns an error.

  4. Rename the form and provide a brief description, then select the form fields from which Oracle Eloqua collects submission data using the check boxes. Click Next Step.
  5. Copy the HTML of the hidden form fields and the action URL from the wizard. You need these in a later step.

    An image of the integration wizard displaying the action URL and hidden fields.

  6. Update the HTML of the external form:

    Note: There are a couple things worth noting:

    • It is a good practice to save the original HTML before altering it. In the event that you need to revert changes this ensures you can return to the original HTML.
    • If you do not have access to the HTML, contact you web site developer and provide them with the copied information from step 5.
    1. Locate the <form> tag in the HTML. Here is an example form tag:

      <form action="[URLFromFormIntegrationWizard]" method="post" name="[YourFormNameFromStep4]">

    2. Update the action attribute with the form action URL from step 5.

      Note: To post the form data to both Oracle Eloqua and the external form processor, copy the original form action URL from the <form> tag. You can add this as a form processing step later.

    3. Update the name attribute to match the form name you entered in step 4.
    4. After the <form> tag, paste the hidden fields from step 5.
  7. In Oracle Eloqua, click Next Step, then Finish. The form opens once the integration is finished.
  8. Click Processing, then An image of the Key Field Mapping button. at the bottom of the window. Configure how to uniquely identify the contact that submitted the form. Typically this is done using the email address submitted with the form.
  9. Depending on the information you are collecting from the form, add a form processing step to update contacts, accounts, or custom data objects with form data.
  10. Add any other processing steps, then click Save.

Tip: To also post the form data to the external form processor that you copied earlier, add the Post Data to Server processing step to your form. Simply paste the action URL you copied from the original form, to the URL field of this form processing step.

Related

Forms

Processing form data

Reposting externally hosted forms

Whitelisting domains

Topliners: How Does Form Integration Work