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.
- Navigate to Assets , then click Forms.
- Click Integrate an External Form.
- Copy the URL of the external form and paste it into the blank field of the External Form Integration wizard, then click Next Step.
Note: The domain hosting your form needs to be in the domain whitelist, otherwise Oracle Eloqua returns an error.
- 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.
- Copy the HTML of the hidden form fields and the action URL from the wizard. You need these in a later step.
- 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.
- Locate the
<form>tag in the HTML. Here is an example form tag:
<form action="[URLFromFormIntegrationWizard]" method="post" name="[YourFormNameFromStep4]">
- Update the
actionattribute 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.
- Update the
nameattribute to match the form name you entered in step 4.
- After the
<form>tag, paste the hidden fields from step 5.
- In Oracle Eloqua, click Next Step, then Finish. The form opens once the integration is finished.
- Click Processing, then 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.
- 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.
- 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.