Now that you've built your Cloud Connector, it's time to get your service "installed" in Eloqua, so that it can be chosen in the cloud connector step on the Canvas or in Program Builder.

 

Let's take a look at how an Eloqua Customer Administrator manages cloud connectors in the application.

 

Under Setup...Database, there is an icon titled Cloud Connector.

CloudConnectorSetup.PNG

Clicking on this icon will take you to the Cloud Connector Management area.

CloudConnectorManagement.png

 

On this screen, you will see the Current Registered Services table.  This is where you want your new connector to appear, as it is these connectors that appear in the select list on the program step.


In order to register a new cloud connector service, the Customer Administrator will need the following three (3) pieces of information:

 

    • Service Name - a name for the connector (this is the friendly name that will show in the drop-down when setting up the step)
    • Service URL: the URL to your configuration page.  This URL must ask for STEP_ID and COMPANY.  When the user clicks the configuration button from the step, Eloqua will call your URL and pass the Step ID and Eloqua Company to you as parameters.

               For Example: https://myconnectorservice.com/config.aspx?StepID={STEP_ID}&Company={COMPANY}

    • Unique Id:  a unique name for your connector (this must be unique in the Current Registered Services table/list.

 

Once your service (connector) is "installed", when the user creates a Cloud Connector step, they will see your connector in the list, and be able to select it, then click the configuration button to set it up.

Canvas2.png

You can then take the STEP_ID and COMPANY parameters that were sent, and use those to aid in the configuration.  This eliminates the need for the user to provide your app with the Company and Step, which would be needed if they were using the Manual setup (by clicking the check-box instead of selecting from the list).

 

Things to keep in mind:

 

  • Only an Eloqua Customer Administrator can see and access the Cloud Connector Management area in an Eloqua install.
  • Your URL *MUST* request the STEP_ID and COMPANY, but you can choose whether or not to use it.
  • You do not need to install your connector in Eloqua, this is optional.  The user can check the Manual box, and then go to your setup page on their own and enter the Step ID and other required information.