Swap Email Address Cloud App Documentation

Purpose

This app allows to force a Contact field to have certain length, you can select the Source Contact field, the Destination Contact field the minimum and maximum length the field should have.

This document will show how this Cloud Action can be used inside Campaign and Program Canvas.

Set-up in Oracle Eloqua

Please follow these instructions to set up this cloud app in your Oracle Eloqua instance.

  • Log in to Oracle Eloqua.
  • Click on Get App below to install.

  NOTE: If prompted to log again, please do so.

  •  In the next screen, click “Sign In” and then “Accept”
Force Field Length Cloud Action Documentation 12
  • You’re all set. The cloud action is ready to be used.
Force Field Length Cloud Action Documentation 13

How to use

The following instructions show a basic/simple usage.  You can incorporate this Cloud Action to Campaign and Program Canvas.

  • Create/Open a Campaign or Program Canvas
  • Click on “Actions” on the top left side then “Show All Steps” and then locate the “Force Field Length” Cloud Action under the Actions options (colored in purple).
Force Field Length Cloud Action Documentation 14
Force Field Length Cloud Action Documentation 15
  • Double click the Force Field Length step, you will see some options for this element.
    • Rename the step if needed
Force Field Length Cloud Action Documentation 16
  • Click the pencil icon to open the settings for this step.

You will need a user to log in and configure this Cloud Action. If you don’t have one, you can create one. If you do, use your user to Log In in the page shown in the following screenshot:

Force Field Length Cloud Action Documentation 17
  • For this cloud action, you can indicate the Fields to execute the Force Field Length App.
    • Source Field: This field will be forced to have a length between the sizes you identify.
    • Destination Field: This field will be populated after the app performs action on the source field.
    • Minimum Length: If the field length is less than the minimum, the Destination Field will be populated with the original value (Source) and ‘blank spaces’ up to the minimum.
    • Maximum Length: If the source field length is larger than the maximum, it will be truncated at the maximum length.
Force Field Length Cloud Action Documentation 18
  • Recommended: Create an element in the program in case an error happens, in this example it’s a Wait Step. Check the box to “Automatically route contacts with errors from cloud app”. Select the step where you want the contacts to be routed. 
Force Field Length Cloud Action Documentation 19
  • Logs Tab: This section shows the execution logs for the respective cloud app
Force Field Length Cloud Action Documentation 20
    • Show: Here you can select what type of log you want to see, it gives you an option to select “All logs”, “Successful logs only”, “Failed logs only”
    • Within the following timeframe: This field allows you to select the timeframe to view the execution logs.

    Note: You can view up to 2 months older logs only

Force Field Length Cloud Action Documentation 21

That’s all. Activate the Program

Note: Most 4Thought Marketing apps use the Eloqua BULK API to export/import records, therefore when an app is used in a campaign or program the user that activates the campaign should have the following permissions:

  • API 
    • Consume API
  • Contacts
    • Upload Contacts/Prospects/Companies
    • Manage Data Export
    • Manage Contacts

License Information

You need a license to configure and execute this Cloud App. Otherwise in the configuration page you will see the following error:

Force Field Length Cloud Action Documentation 22

Additionally, if you happen to see records stuck in the Cloud Action step, it may be due to a missing or expired License which you can get with your corresponding Account Manager.