This documentation is still in progress. We are working hard to update all our screenshots to the new Magnolia 6 style. Please bear with us.
How the example works
The External Forms IBM module adds a
watsonFormSample page in the Pages app. The page contains a form with an email field. The form was created in IBM Watson and is rendered by Magnolia.
When a visitor types their email address into the field and submits the form, Magnolia processes the input. Magnolia uses an ExternalFormService named
ibm to process the form data. Magnolia asks the visitor to give consent for storing personal data and how long that consent should be valid.
The example uses Magnolia's default data privacy mechanism. The mechanism records the consent in the Visitors app Magnolia and links to IBM Watson as the external data storage. The default privacy mechanism comes from
magnolia‐privacy‐visitor‐manager which is a submodule of the Privacy module. A custom visitor reference searcher called
info.magnolia.extforms.consent.WatsonReferencesSearcher processes the personal data on the form.
Install the External Forms module which is an EE Standard module. The module is not bundled with Magnolia by default.
External forms: eenders external forms as Magnolia forms.
External forms IBM: example implementation for the IBM Watson Campaign Automation tool.
- External forms Infusionsoft: not needed, you can exclude this.
- External forms Eloqua: not needed, you can exclude this.
Connecting to IBM Watson database
- Create a Single Opt-In database in Watson Campaign Automation account.
- Make sure that
- Open the additional details and copy the Database ID.
- In Magnolia, go to Configuration app >
- Add a
watsonidproperty node under
databaseIdsand set its value to the Database ID you copied earlier. The name of the property is arbitrary. You can add as many database IDs as required.
- Go to Configuration app >
- Add your IBM Watson credentials for the three properties:
Creating an external web form with a privacy-aware email field
If you already have an IBM Watson Marketing Automation web form with an Email field, add the form on the
watsonFormSample page. Use the External Form component. The component extends the default
externalForm component and does the following:
- Fetches a form from IBM Watson as configured in site URL.
- Asks for visitor consent before submitting the form. The consent is given by checking a box.
- Sends the visitor an opt-in email for the second phase of the opt-in procedure.
To create an external web form and connect it to Magnolia:
- In your IBM Watson Automation Campaign database, create a new standard web form.
- Keep the default form fields and follow the instructions in the IBM wizard.
- Publish the form.
- On the Publish Confirmation page, click Publish Site.
- In Site Settings, copy the site URL, for example
- In Magnolia, go to the Pages app and open the
- Edit the External Form sample component. Add the URL of the site you just published.
The component can now fetch data from IBM Watson Automation Campaign.
Viewing consent in Magnolia and IBM Watson Campaign Automation
If you want to act as a visitor and test this process yourself, you must configure your Mail settings in Magnolia first.
- Preview the
watsonFormSamplepage in the Pages app.
- Fill the form with your email address.
- Give consent to processing personal data.
- Open the Tools > Visitors app. Your entry as a visitor is created but no consent to storing personal data is recorded yet until the double opt-in process is complete. You can see this by selecting the item in the Visitors app and clicking Update consent.
- Complete the double opt-in process. Open your email inbox and click the link in an email that was sent to you. Click the Proceed button on the web page to confirm your consent.
The email message sent to visitors is configured in the Opt-in Email tab of the External Forms component. See GDPR and Forms for details about configuring email options and consent duration settings.
- Once a visitor confirms their consent, you can see a record of it in the Visitors app.
- Click Show dependencies to see the link to the external source, in this case IBM Watson Campaign Automation.
The link takes you to your Watson dashboard where you can see an entry for the visitor along with the consent recorded.
You can also use other Magnolia data privacy features with an external source:
- Export all data (export from JCR but also JSON from Watson)
- Forget a visitor
- Delete a visitor's data (request sent to Watson)