...
In this
...
article
Table of Contents | ||||
---|---|---|---|---|
|
Overview
This Snap is used to retrieve the activities associated with one or more Eloqua contact asset. It invokes the Eloqua REST API 1.0 "Read (list)" endpoint for Activities.
Expected input: The typical input for this Snap would be documents containing Eloqua contact IDs, such as the output of the Eloqua Read Snap for the Contacts type.
Expected output: One output document per contact ID, containing the contact ID and a list of zero or more activities for that contact.
Snap Type
The Eloqua Query Activities Snap is a Read-type Snap.
Prerequisites
None.
Support for Ultra Pipelines
Works in Ultra Task Pipelines.
Limitations and Known Issues
None.
Snap Views
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 | 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
Snap type: | Read | |
---|---|---|
Description: | This Snap is used to retrieve the activities associated with one or |
...
more Eloqua contact asset. It invokes |
...
the Eloqua REST API 1.0 "Read (list)" endpoint for Activities.
|
...
|
...
| ||
Prerequisites: | [None] | |
---|---|---|
Support and limitations: | Works in Ultra Task Pipelines. | |
Account: | 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. | ||||||||
Views: |
| |||||||
---|---|---|---|---|---|---|---|---|
Settings | ||||||||
Label | 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. | |||||||
Contact ID | Required. ID of |
...
the Eloqua contact associated with the activities of interest, or an expression which evaluates to a contact ID. Example: | ||
Activity Type | Required. The type of activity you wish to retrieve for the specified contact. One of:
| |
---|---|---|
Start Date/Time | Required. Start of the time range for activities to retrieve. This should be a 10-digit Unix timestamp, or an expression that evaluates to a timestamp or |
...
a DateTime. See http://www.unixtimestamp.com/.
| ||||||||||||||
End Date/Time | Required. End of the time range for activities to retrieve. | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Count | Maximum number of activities to retrieve for each contact. This is not a limit on the number of documents to output, which is always equal to the number of input documents (or 1 if there are no input documents). | |||||||||||||
|
|
Examples
...
Sample input:
Code Block |
---|
[
{
"id": "4156"
},
{
"id": "4157"
},
{
"id": "4158"
}
] |
Sample output:
Code Block |
---|
[
{
"contactId" : "4156",
"activities" : [
{
"type" : "Activity",
"activityDate" : "1403589324",
"activityType" : "emailSubscribe",
"asset" : "0",
"assetType" : "email",
"contact" : "4156",
"details" : [ ],
"id" : "130345"
},
{
"type" : "Activity",
"activityDate" : "1341343693",
"activityType" : "emailSubscribe",
"asset" : "0",
"assetType" : "email",
"contact" : "4156",
"details" : [ ],
"id" : "2947"
}
]
},
{
"contactId" : "4157",
"activities" : [ ]
},
{
"contactId" : "4158",
"activities" : [
{
"type" : "Activity",
"activityDate" : "1341343693",
"activityType" : "emailSubscribe",
"asset" : "0",
"assetType" : "email",
"contact" : "4158",
"details" : [ ],
"id" : "2948"
}
]
}
]
|
Insert excerpt | ||||||
---|---|---|---|---|---|---|
|