Adobe Experience Platform Write (PS Snap)

In this article

Overview

You can use this Snap to restructure and write input JSON data as JSON or Parquet files into the Experience Platform.

Snap Type

Adobe Experience Platform Write Snap is a Write-type Snap that writes the JSON data to the dataset in the Adobe Experience Platform.

Prerequisites

The data set into which you want to write the output of the Adobe Experience Platform Write Snap. If you do not have the dataset ready, you must create it using the Adobe Experience Platform UI or the Adobe Experience Platform S3 Connector Snap.

Limitations

When the Dataset Name field is expression enabled, its purpose is to read Pipeline parameter values. This Snap does not read values from upstream Snaps. However, you can add this Snap in the Pipelines with other Snaps to execute them in a sequence.

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: 1

  • Max: 1

  • Mapper Snap

  • Binary to Document Snap

  • Sort Snap

Each input document contains data that you want to write to Adobe Experience Platform.

Output

Document

  • Min: 0

  • Max: 1

  • Mapper Snap

  • Join Snap

  • Union Snap

Each output document lists the status and other details associated with the writing process.

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 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 list that is dynamically populated 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 field set.

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

  • 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 Write
Example: Write Documents into Adobe Experience Platform

String

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.

 

Dataset Name*

 

Default Value: NA
Example: Adobe Generic Dataset

String/Expression

Specify the name of the data set into which you want to write the input data. This is a suggestible field.

This Snap reads Pipeline parameters, but not values from upstream Snaps. You can, however, add this Snap to the Pipelines with other Snaps to execute them in a sequence.

Schema Type

 

Default Value: Parquet
Example: JSON

Dropdown list

Select the schema type that you want to use to create the file that must be written. The options available are:

  • Parquet

  • JSON

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

Troubleshooting

 

Error

Reason

Resolution

Error

Reason

Resolution

Missing property value

The Snap settings are not correct.

You might 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 data set into which the Parquet file must be written or that the data set name specified doesn't exist in Adobe Experience Platform.

Ensure that the property Dataset Name has a valid data set name. Use the dropdown button adjacent to the Dataset Name field to select a valid data set.

Unable to load the private key for the given alias

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

This error appears when the account doesn't 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

This message appears when the endpoint account details are incorrect.

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

Snap Pack History