Skip navigation

We are pleased to announce that version 1.0 of the open source C# Rest client is now available via NuGet. And sources, documentation as well as a community site are now hosted on Codeplex.

 

Documentation | Community

 

 

 

For anyone currently using the sources on Github, note that we’ll continue to maintain both sites, but NuGet will be the recommended source for using the client in your own projects.

 

Getting the C# Rest Client via NuGet

  1. Using the NuGet Package Manager Console :
    • Install-Package Eloqua.Api.Rest.ClientLibrary
  2. Using Visual Studio 2012
    • Right-click on the project's references
    • Select "Manage NuGet Package..."
    • Search for "Eloqua Client"

 

 

We hope that you find this helpful and please let me know if you have any questions.


Thanks,

Fred

 

Disclaimer

Please note that these are my own tools and are meant to help developers build on the Eloqua platform and while I am happy to answer questions and provide support, note that Eloqua is not responsible for and cannot support this product.

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.