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 |
---|---|---|---|---|
Input | Document
|
|
| Each input document contains data that you want to write to Adobe Experience Platform. |
Output | Document |
|
| 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:
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 |
---|---|---|
Label*
Default Value: Adobe Experience Platform Write | 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 | 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 | Dropdown list | Select the schema type that you want to use to create the file that must be written. The options available are:
|
Snap Execution
Default Value: Execute Only | Dropdown list | Select one of the following three modes in which the Snap executes:
|
Troubleshooting
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
Have feedback? Email documentation@snaplogic.com | Ask a question in the SnapLogic Community
© 2017-2024 SnapLogic, Inc.