...
In this article
Table of Contents | ||||
---|---|---|---|---|
|
Overview
You can use this Snap
...
Write
...
Description:
...
to create an Eloqua object of a specified type by invoking an Eloqua REST API Create endpoint
...
.
...
Snap Type
The Eloqua Create Snap is a Write-type Snap.
Prerequisites
None.
Support for Ultra Pipelines
Works in Ultra Pipelines.
Limitations and Known Issues
None.
Snap Views
...
[None]
...
This Snap uses account references created on the Accounts page of SnapLogic Manager to handle access to this endpoint. See Eloqua Account for more information.
...
Type | Format | Number of Views | Examples of Upstream and Downstream Snaps | Description |
---|---|---|---|---|
Input | Document |
| JSON Generator | The Snap invokes the Eloqua endpoint for the given object type once for each input document, using the document as the content sent to the endpoint. Check the Eloqua API documentation to understand the required and supported fields specific to the object type. Note that the Eloqua documentation is not very complete/accurate in this respect. |
...
Output | Document
|
| Mapper | The Snap produces one document in the view for each successful call to the Eloqua endpoint. |
Error |
...
Settings
...
Label
Error handling is a generic way to handle errors without losing data or failing the Snap execution. You can handle the errors that the Snap might encounter while running the Pipeline by choosing one of the following options from the When errors occur list under the Views tab:
Learn more about Error handling in Pipelines. |
Snap Settings
Field Name | Field Type | Field Dependency | Description | ||
---|---|---|---|---|---|
Label Default Value: Eloqua Create Example: Create Accounts | String | N/A | Required. The name for the Snap. You can modify this to be more specific, especially if you have more than one of the same Snap in your pipeline. | ||
Core object type Example: Contacts | Dropdown list | N/A | Required. The type of core object to create. The options available include:
|
...
Custom Object Metadata ID Default Value: None Example: 7 | Integer/Expression | Appears when Custom Object Data is selected in Core object type dropdown. | Specify the ID of the metadata that must be associated with the Custom Object Data. | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Pass through Default Value: Deselected | Checkbox | N/A | Select this checkbox to enable the Snap to pass the input document to the output view under the key
| ||||||||||||
| Dropdown list | N/A |
|
Example
...
Sample Input Document
Code Block |
---|
{
"emailAddress": "s.smith@Snaplogic.com",
"firstName": "Somebody",
"lastName": "Smith",
"title": "Sr. Software Engineer",
"accountName": "SnapLogic",
"businessPhone": "123-456-7890",
"mobilePhone": "987-654-3210",
"address1": "929 Pearl St",
"address2": "Suite 200",
"city": "Boulder",
"province": "CO",
"postalCode": "80302",
"country": "USA",
"fieldValues": [
{
"id": "100017",
"value": "Sir"
},
{
"id": "100043",
"value": "Developer"
}
]
} |
Sample Output Document
Code Block |
---|
{
"type": "Contact",
"currentStatus": "Awaiting action",
"id": "49",
"createdAt": "1450313715",
"depth": "complete",
"name": "s.smith@Snaplogic.com",
"updatedAt": "1450313715",
"accountName": "SnapLogic",
"address1": "929 Pearl St",
"address2": "Suite 200",
"businessPhone": "123-456-7890",
"city": "Boulder",
"country": "USA",
"emailAddress": "s.smith@Snaplogic.com",
"emailFormatPreference": "unspecified",
"fieldValues": [
{
"type": "FieldValue",
"id": "100005"
},
{
"type": "FieldValue",
"id": "100017",
"value": "Sir"
},
...
{
"type": "FieldValue",
"id": "100043",
"value": "Developer"
}
...
],
"firstName": "Somebody",
"isBounceback": "false",
"isSubscribed": "true",
"lastName": "Smith",
"mobilePhone": "987-654-3210",
"postalCode": "80302",
"province": "CO",
"subscriptionDate": "1450313715",
"title": "Sr. Software Engineer"
} |
Code Block |
---|
Sample Error Document
Code Block |
---|
{
"reason": "Conflicts Found",
"details": [
{
"type": "ObjectValidationError",
"container": {
"type": "ObjectKey",
"objectType": "Contact"
},
"property": "emailAddress",
"requirement": {
"type": "UniquenessRequirement",
"uniquenessScope": "global"
},
"value": "s.smith@Snaplogic.com"
}
],
"status_code": 409,
"original": {
"emailAddress": "s.smith@Snaplogic.com",
"firstName": "Somebody",
...
},
"error": "The POST request failed",
"url": "https://secure.p02.eloqua.com/API/REST/2.0/data/contact"
}
|
Snap Pack History
Insert excerpt | ||||||
---|---|---|---|---|---|---|
|