Adobe Cloud Platform Read
On this Page
ACP Read Snap Deprecation Notice
Since Adobe Cloud Platform (ACP) is deprecated by Adobe, we are replacing the ACP Snap Pack with the Adobe Experience Platform (AEP) Snap Pack starting from 4.22 GA release. Hence, ACP Read Snap is deprecated in 4.22 release. For more information, see the Adobe Experience Platform Read Snap article.
Overview
The Adobe Experience Platform Read Snap is a Read type Snap and can be used to read data sets in the Adobe Experience Platform console using information like Dataset ID for a selected data set schema. The Snap supports reading data sets in the following data set schema:
- Profile XSD
- CSV
- Parquet
The Snap accepts document input and generates a document output. Snaps with document input/output view such as Mapper can be used upstream/downstream of the Snap.
Prerequisites
Access to Adobe Experience Platform is required in order to be able to use this Snap.
Configuring Accounts
This Snap uses account references created on the Accounts page of SnapLogic Manager to handle access to this endpoint. See Configuring Adobe Experience Platform Accounts for information on setting up this type of account.
Configuring Views
Input | This Snap has at most one document input view. |
|---|---|
| Output | This Snap has exactly one document output view. |
| Error | This Snap has at most one document error view and produces zero or more documents in the view. |
Limitations and Known Issues
As of its initial release, the Snap supports only Profile XSD, CSV, and Parquet formats.
Modes
- Ultra Pipelines: Works in Ultra Pipelines.
Snap Settings
| Label | Required. The name for the Snap. Modify this to be more specific, especially if there are more than one of the same Snap in the pipeline. |
|---|---|
| Dataset schema | This is a drop-down list that lets the user select the schema of the data set that is to be read. The suggestions in Dataset name and Dataset ID are based on this selection. The following options are available in this drop-down menu:
Default value: Parquet |
| Dataset name | The name of the data set to be read. This is a suggestible field and will provide names of all the data sets within the Account based on the selection in the Dataset schema property. Example: doctest Default value: [None] 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. |
| Dataset ID | Required. The data set ID of the data set to be read. This is a suggestible field and will provide IDs of all the data sets within the Account based on the Dataset schema and Dataset nameproperty's configuration. Example: 5acdb87f9iqdrac201da2e0e9 Default value: [None] 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. |
| Refresh datasets cache | If selected, the Snap will refresh the cache and show refreshed results. This is handy in cases where changes are made to the data set outside of SnapLogic, such as a new data set created, existing data set deleted, and so on. In such cases, enabling this property will refresh the cache and display updated content. Default value: Not selected. New data sets This property is disabled by default to save on unnecessary API calls but it is useful in cases where a new data set is added after the Snap's initial configuration. New data sets will not be visible in the Snap's suggestions unless this property is enabled. |
Snap execution | Select one of the three modes in which the Snap executes. Available options are:
|
Troubleshooting
Snap throws an error when Pipeline execution is done in Cloudplex
To execute Pipelines in a Cloudplex, you must set ALLOW_CLOUDPLEX_PROCESS_CREATION to true in the SnapLogicSecurityManager.java file. Contact SnapLogic Customer Support for help with the setting.
Examples
Reading from Adobe Experience Platform and Writing into SLDB and S3
The pipeline below demonstrates the following operations:
- Reading a data set from the Adobe Experience Platform
- Filtering the data set
- Writing the filtered data into SLDB and S3 (data matching one criteria to be written into the SLDB, while data matching another criteria to be written into S3)
The data set is a CSV file in the Adobe Experience Platform, it is a task list containing information such as Assignee, Reporter, Priority, and Resolution. This data is read using the Adobe Experience Platform Read Snap. The Snap is configured as shown below:
The output preview below shows the data set:
This data is filtered using Filter Snaps, the filtering criteria is the Priority - Highest, and Lowest. All tasks with priority Highest are written into the SLDB using the File Writer Snap and all tasks with priority Lowest are written into the S3 storage using the S3 File Writer Snap. The data is written into these Snaps in JSON format using the JSON Formatter Snaps. The File Writer and S3 File Writer Snaps are configured as shown below:
Downloads
Snap Pack History
Have feedback? Email documentation@snaplogic.com | Ask a question in the SnapLogic Community
© 2017-2024 SnapLogic, Inc.