Skip to end of banner
Go to start of banner

Eloqua Delete

Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 17 Next »

On this Page

Overview

This Snap invokes an Eloqua REST API Delete endpoint to delete an Eloqua object of a specified type.

  • Expected input: Each input document should specify the ID of an object of the given type to delete.  Any other content in an input document is ignored.
  • Expected output: The Snap outputs exactly one document for each object successfully deleted, specifying the ID of the deleted object.

Snap Type

The Eloqua Delete Snap is a Write-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

  • Min: 0

  • Max: 

JSON Generator

This Snap has at most one document input view, which can be used to supply documents containing object IDs. The Snap will invoke the Eloqua endpoint once for each input document.

Output

Document


  • Min: 0

  • Max: 1

Mapper

This Snap has at most one document output view and produces one document in the view for each successful call to the Eloqua endpoint.
Error Handling

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:

  • Stop Pipeline Execution: Stops the current pipeline execution when the Snap encounters an error.

  • Discard Error Data and Continue: Ignores the error, discards that record, and continues with the remaining records.

  • Route Error Data to Error View: Routes the error data to an error view without stopping the Snap execution.

Learn more about Error handling in Pipelines.

Snap Settings

Field Name

Field Type

Field Dependency

Description

Label

Default Value: Eloqua Delete

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


Default valueAccounts

ExampleContacts

Dropdown list

N/A

Required. The type of core object to delete. The options available include:

  • Accounts
  • Accounts 2.0
  • Account Fields
  • Account Fields 2.0
  • Campaigns
  • Campaigns 2.0
  • Contacts
  • Contacts 2.0
  • Contact Fields
  • Contact Fields 2.0
  • Contact Lists
  • Contact Lists 2.0
  • Contact Segments
  • Contact Segments 2.0
  • Content Sections
  • Content Sections 2.0
  • Custom Object Metadata
  • Custom Object Metadata 2.0
  • Emails
  • Emails 2.0
  • Email Folders
  • Email Folders 2.0
  • Email Footers
  • Email Footers 2.0
  • Email Groups
  • Email Groups 2.0
  • Email Headers
  • Email Headers 2.0
  • External Activities 2.0
  • External Assets 2.0
  • External Asset Types 2.0
  • Forms
  • Forms 2.0
  • Form Submission Data
  • Images 2.0
  • Imported Files 2.0
  • Landing Pages
  • Landing Pages 2.0
  • Microsites
  • Microsites 2.0
  • Option Lists
  • Option Lists 2.0
All types without a specified version number are version 1.0.

ID

Default Value: None



Required. An identifier for the entity or an expression that evaluates to one.  When there is an input view, this should be an expression that specifies the path of the ID value in each input document, such as "$id".

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 original.



Snap Execution


Dropdown list

N/A


Select one of the three modes in which the Snap executes. Available options are:

  • Validate & Execute: Performs limited execution of the Snap, and generates a data preview during Pipeline validation. Subsequently, performs full execution of the Snap (unlimited records) during Pipeline runtime.
  • Execute only: Performs full execution of the Snap during Pipeline execution without generating preview data.
  • Disabled: Disables the Snap and all Snaps that are downstream from it.


Examples


Sample Input Document


{
  "contactId": "49",
  ...all other fields ignored
}


Sample Output Document


{
  "id": "49"
}

Sample Error Document


{
  "reason": "Object Not Found (id: 49)",
  "status_code": 404,
  "original": {
    "contactId": "49",
    ...
  },
  "error": "The DELETE request failed",
  "url": "https://secure.p02.eloqua.com/API/REST/2.0/data/contact/49"
}


 Click to view/expand
Release Snap Pack VersionDateType  Updates
May 2024main26341 StableUpdated and certified against the current SnapLogic Platform release.
February 2024main25112 StableUpdated and certified against the current SnapLogic Platform release.
November 2023main23721 StableUpdated and certified against the current SnapLogic Platform release.

August 2023

main22460

 

Stable

Updated and certified against the current SnapLogic Platform release.

May 2023main21015 StableUpgraded with the latest SnapLogic Platform release.
February 2023main19844 StableUpgraded with the latest SnapLogic Platform release.
November 2022main18944 Stable

The Eloqua Snaps now include the Pass through checkbox, which enables the Snap to pass the input document to the output view under the key original.

August 2022430patches17270 Latest

The Custom Object Metadata ID field in the Eloqua Create Snap allows you to specify an ID for creating custom object data. This conditional field appears only when you select Custom Object Data as the Core object type.

August 2022main17386 StableUpgraded with the latest SnapLogic Platform release.
4.29main15993 StableUpgraded with the latest SnapLogic Platform release.
4.28main14627 StableUpgraded with the latest SnapLogic Platform release.

4.27

main12833

 

Stable

Upgraded with the latest SnapLogic Platform release.
4.26main11181 StableUpgraded with the latest SnapLogic Platform release.
4.25main9554
 
StableUpgraded with the latest SnapLogic Platform release.
4.24main8556
StableUpgraded with the latest SnapLogic Platform release.
4.23main7430
 
StableUpgraded with the latest SnapLogic Platform release.
4.22main6403
 
StableUpgraded with the latest SnapLogic Platform release.
4.21snapsmrc542

 

StableUpgraded with the latest SnapLogic Platform release.
4.20snapsmrc535
 
StableUpgraded with the latest SnapLogic Platform release.
4.19snaprsmrc528
 
StableUpgraded with the latest SnapLogic Platform release.
4.18snapsmrc523
 
StableUpgraded with the latest SnapLogic Platform release.
4.17ALL7402
 
Latest

Pushed automatic rebuild of the latest version of each Snap Pack to SnapLogic UAT and Elastic servers.

4.17snapsmrc515
 
Latest

Added the Snap Execution field to all Standard-mode Snaps. In some Snaps, this field replaces the existing Execute during preview check box.

4.16snapsmrc508
 
StableUpgraded with the latest SnapLogic Platform release.
4.15snapsmrc500
 
StableUpgraded with the latest SnapLogic Platform release.
4.14snapsmrc490
 
StableUpgraded with the latest SnapLogic Platform release.
4.13

snapsmrc486

 
StableUpgraded with the latest SnapLogic Platform release.
4.12

snapsmrc480

 
StableUpgraded with the latest SnapLogic Platform release.
4.11snapsmrc465
 
StableUpgraded with the latest SnapLogic Platform release.
4.10

snapsmrc414

 
StableUpgraded with the latest SnapLogic Platform release.
4.9snapsmrc405
 
StableUpgraded with the latest SnapLogic Platform release.
4.8

snapsmrc398

 
StableUpgraded with the latest SnapLogic Platform release.
4.7

snapsmrc382

 
StableUpgraded with the latest SnapLogic Platform release.
4.6snapsmrc362
 
StableUpgraded with the latest SnapLogic Platform release.
4.5.1

snapsmrc344

 
LatestUpgraded with the latest SnapLogic Platform release.
4.5

snapsmrc344

 StableUpgraded with the latest SnapLogic Platform release.
4.4.1N/A LatestUpgraded with the latest SnapLogic Platform release.
4.4N/A StableUpgraded with the latest SnapLogic Platform release.
4.3.2N/A Latest
  • NEW! Create, Delete, Query Activities, and Update Snaps added.
  • Added core object types to support all remaining REST 1.0 and 2.0 endpoints in Read and Query Snaps.
  • Read Snap now supports expressions for Search setting and an input view.
  • Resolved an issue with Eloqua Snaps not correctly obtaining the base URL from the login id endpoint.
  • Resolved an issue with Eloqua Snaps not handling Additional Parameters correctly.
  • Resolved an issue with Eloqua Read settings listing core object types that aren't applicable for this Snap and will always fail.
  • Resolved an issue with Eloqua Read and Query Snap not able read or query External Asset object type.
  • Resolved an exception with Eloqua Query when Activities returns no content.
  • Resolved an exception with Eloqua Query when Activities returns content.
  • Resolved an issue with Eloqua Read returning duplicate items when Count was greater than 1000.

  • No labels