Adobe Experience Platform Read (PS Snap)

In this article

Overview

You can use this Snap to read the dataset from the Adobe Enterprise Platform.

Snap Type

Adobe Experience Platform Read Snap is a READ-type Snap that reads the data from the input stream.

Prerequisites

None.

Limitations and Known Issues

None.

Snap Views

Type

Format

Number of Views

Examples of Upstream and Downstream Snaps

Description

Type

Format

Number of Views

Examples of Upstream and Downstream Snaps

Description

Input 

Document

  • Min: 0

  • Max: 1

  • Mapper Snap

  • Binary to Document Snap

  • Sort Snap

Optional. Use upstream Snaps to pass the dataset name.

Output

Document

  • Min: 0

  • Max: 1

  • Mapper Snap

  • Join Snap

  • Union Snap

Documents in the dataset.

Error

Error handling is a generic way to handle errors without losing data or failing the Snap execution. You can manage the errors that the Snap might encounter when 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 if 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

  • Asterisk ( * ): Indicates a mandatory field.

  • Suggestion icon (): Indicates a dynamically populated list based on the configuration.

  • Expression icon ( ): Indicates the value is an expression (if enabled) or a static value (if disabled). Learn more about Using Expressions in SnapLogic.

  • Add icon ( ): Indicates that you can add fields in the fieldset.

  • Remove icon ( ): Indicates that you can remove fields from the fieldset.

  • The upload icon ( ): Indicates that you can upload files.

Field Name

Field Type

Description

Field Name

Field Type

Description

Label*

 

Default Value: Adobe Experience Platform Read
Example: Adobe Enterprise Platform Read Snap

String

Specify a 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.

Dataset Name*

 

Default Value: NA
Example: Adobe Demo 1 Dataset

String

The name of the dataset from which you want to read the data. This is a suggestible field. This property is expression-enabled. For more information on the expression language, see Understanding Expressions in SnapLogic and Using Expressions. For information on Pipeline Parameters, see Pipeline Properties.

Batch IDs

Specify the Batch IDs for the datasets provided. Use this field set to specify the Batch IDs for the datasets provided. Specify the BatchID Value for as many columns as you need to load in the target table.

 

BatchID Value

Default Value: None
Example: AEM_batch1

String

Enter the values of the Batch ID for the data sets provided.

Snap Execution

Default Value: Execute Only
Example: Validate & Execute

Dropdown list

Select one of the following three modes in which the Snap executes:

  • Validate & Execute: Performs limited execution of the Snap and generates a data preview during Pipeline validation. Subsequently, performs complete execution of the Snap (unlimited records) during Pipeline runtime.

  • Execute only: Performs complete execution of the Snap during Pipeline execution without generating preview data.

  • Disabled: Disables the Snap and all Snaps that are downstream from it.

Troubleshooting

Error

Reason

Resolution

Error

Reason

Resolution

Missing property value

The snap settings are not correct.

You may see this error because you did not provide a mandatory value.

Check to ensure that all mandatory values are provided and valid.

Invalid Snap configuration

Target Dataset Name is null or missing.

This typically means that you did not specify the dataset to which the Snap must read the file or that the dataset name specified does not exist in Adobe Enterprise Platform.

Ensure that the property Dataset Name has a valid dataset name. Use the Suggestion button next to the Dataset Name field to select a valid dataset.

Unable to load the private key for the given alias

File not found on <your SnapLogic instance> at <account location>

The error appears when the account does not have valid values. Ensure that the Keystore path, Keystore passphrase, private key alias, and private key passphrase are correct. Also, you must upload the Keystore in the Keystore Path that you specify.

Unable to obtain an access token

The message appears when the endpoint account details are incorrect.

Check your Organization ID, Technical Account ID, Client ID, and Client Secret Key details, and try again.

Snap Pack History