On this Page

This page is no longer maintained (Jul 12, 2023). For the most current information, go to Anaplan Action.

Snap type:

Write

Description:

This Snap is used to run an action in Anaplan, such as a delete action.

Expected upstream Snaps: Any document processing Snap, such as a Mapper Snap.
Expected downstream Snaps: Optional Snap that reads the output result of the Write operation and performs follow-up actions.
Expected input: The properties of the Read Snap can be defined as expressions in case the input variable shall determine the value of one of the properties.
Expected output: Datetime finished, Failure or success message with any details provided by Anaplan.

Prerequisites:

None

Support and limitations:

Works in Ultra Task Pipelines.

Account:

This Snap uses account references created on the Accounts page of SnapLogic Manager to handle access to this endpoint. See Anaplan Account for information on setting up this type of account.

Views:

Input	This Snap has at most one document input view.
Output	This Snap has at most one document output view.
Error	This Snap has at most one document error view and produces zero or more documents in the view.

Settings

Label

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.

Workspace

Required. The workspace that contains the target model.

Workspace ID and Workspace Name can be used interchangeably.

Default value: N/A

Model

Required. The model on which you want the Snap to operate.

Model ID and Model Name can be used interchangeably.

Default value: N/A

Action name

Required. The name of the action to run.

Default value: N/A

Output Handling

Required. Select one of the following options to determine how the output should be handled. This setting only applies to import action.

AllSuccess: If the import action was successful with no errors/warnings, records are written in the output view. Else, the error messages and details are written to the error view.
Mixed: If an error occurs in the import action, the import file is downloaded and compared with the error records. Rows without an error are written to the output view, and rows with an error are written to the error view.
Stream errors: If the Action fails, the error documents will be posted to the error view, one error document for each error record, and a task result summary document will be posted to the output view.
Data errors/warnings: If you select this option, the Snap classifies your errors into two categories:
- Errors which display critical and fatal errors.
- DataErrorsOrWarnings which specifically highlight errors or warnings associated with the data, indicating potential inaccuracies or inconsistencies in the data.

The error document schema in the Stream errors mode is different from the ones in other modes. Prior to 4.6.0 release, this property did not exists and its equivalent default behavior was AllSuccess. Therefore, the pipelines that existed prior to 4.6.0 will automatically be set to Stream errors and might fail if the downstream Snaps at the error view of this Snap have dependency in the error document schema.

Default value: Stream errors

Retry limit

The maximum number of connection retry attempts in case of a connection failure. If the retry attempts exceed the configured value, the pipeline execution fails and an error message appears.

Default value: 3

Retry interval

The minimum retry time interval in seconds. Enter the time interval for the Snap to retry a connection request after a failed connection. The time increases exponentially between failures. For example, if the timeout is set to 3 seconds, the first timeout is at 3, the second is at 4.5 etc.

Default value: 3

HTTP timeout

The connection timeout value in seconds. In case of a connection failure, the Snap aborts the pipeline execution.
For example, if the HTTP timeout is set to 30 seconds, and the Snap fails to establish a connection until 30 seconds, the pipeline logs a timeout exception and aborts execution.

Default value: 60

Snap execution

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.

Example

The example assumes that you have configured & authorized a valid Anaplan account (see Configuring Anaplan Accounts) to be used with this Snap. The following Anaplan Action Snap executes an Anaplan operation that is defined and configured in your Anaplan Workspace. In this example, an existing action, Delete the Sales - Customer 1.csv File, is triggered and executed. This action is configured to delete file data from the Anaplan Workspace, SnapLogic QA, and Model, Anaplan Snap Test:

After a successful validation of the Snap, you will see a data preview that gives the status of executed Anaplan action and its details:

Snap Pack History

Click to view/expand

Release	Snap Pack Version	Date	Type	Updates
August 2023	434patches22600	21 Aug 2023	Latest	Fixed an issue with the Anaplan Action Snap that caused the `File Not Found` error to display when multiple instances of the Anaplan Upload Snap (which included empty files) were executed concurrently. Enhanced the Anaplan Snap Pack with support for retries to avoid `Server failure` error during the pipeline execution.
August 2023	main22460	16 Aug 2023	Stable	Updated and certified against the current SnapLogic Platform release.
May 2023	433patches22443	10 Aug 2023	Latest	The Anaplan Action Snap now supports data errors/warnings for better output handling and also fixed empty reason for process failure. All the Anaplan Snaps now display the status code as part of the error message if the error status code is available as part of the Anaplan API response.
May 2023	433patches22009	21 Jul 2023	Latest	Fixed an issue with the Anaplan Upload Snap where the Snap displayed an error when attempting to upload different files using multiple Anaplan Upload Snaps in parallel. The Snap now works as expected and successfully uploads the files with different filenames. Fixed the following intermittent issues in Anaplan Upload Snap by implementing the retry feature: `Connection Error` `Anaplan Upload cannot create temp file to upload using Anaplan Java API`
May 2023	main21015	10 May 2023	Stable	Updated and certified against the current SnapLogic Platform release.
February 2023	main19844	09 Feb 2023	Stable	Updated and certified against the current SnapLogic Platform release.
November 2022	main18944	10 Nov 2022	Stable	Updated and certified against the current SnapLogic Platform release.
August 2022	main17386	11 Aug 2022	Stable	Updated and certified against the current SnapLogic Platform release.
4.29	main15993	14 May 2022	Stable	Updated and certified against the current SnapLogic Platform release.
4.28	main14627	12 Feb 2022	Stable	Updated and certified against the current SnapLogic Platform release.
4.27	427patches13160	29 Nov 2021	Latest	Fixed the issue with Anaplan Snaps, where the log messages were stored in `jccoutput.log` file instead of `jcc.json` file, and updated the dependent libraries.
4.27	main12833	13 Nov 2021	Stable	Updated and certified against the current SnapLogic Platform release.
4.26	main11181	14 Aug 2021	Stable	Updated and certified against the current SnapLogic Platform release.
4.25 Patch	425patches10360	15 Jul 2021	Latest	Added the following fields to the Anaplan Write Snap: Override server settings Separator Text Delimiter
4.25	main9554	09 May 2021	Stable	No updates made.
4.24	424patches9313	20 Apr 2021	Latest	Fixed an issue related to Index out of range in the Anaplan Upload Snap when the separator is not present or does not match the one in the upload file.
4.24	main8556	13 Feb 2021	Stable	No updates made.
4.23	main7430	14 Nov 2020	Stable	No updates made.
4.22	422patches7392	06 Nov 2020	Latest	Fixed the Snap Pack error handling issue by reverting the `getChunk` method, that returns a variant that contains all or a part of the contents of a large text or binary data Field object, of 1.4.4.2 jar version to 1.4.4.1 jar version and upgraded the jar version to 1.4.4.3.
4.22	422patches6561	26 Oct 2021	Latest	Fixed the Anaplan Snaps by displaying the same value for both Task ID and Task Name, by following the Anaplan client SDK. Enhanced the Anaplan Snaps by allowing you to provide interchangeable inputs for the following fields: Workspace ID and Workspace Name Model ID and Model Name Introduces a suggestible option that enables you to select the Workspace Name and Model Name.
4.22	main6403	12 Sep 2020	Stable	No updates made.
4.21	421patches5851	04 Jun 2020	Latest	Fixed the Anaplan Action Snap that outputs the same value for TaskID and TaskName parameters.
4.21	snapsmrc542	09 May 2020	Stable	No updates made.
4.20	snapsmrc535	08 Feb 2020	Stable	No updates made
4.19	snaprsmrc528	09 Nov 2019	Latest	Removed the suggestion button from the Workspace and Model fields in the Snap Settings dialog. Hence, you need to enter the field values manually.
4.18	snapsmrc523	10 Aug 2019	Stable	No updates made.
4.17	Anaplan7422	18 Jun 2019	Latest	Fixed an issue with the Anaplan Read Snap wherein the Snap pulls archived and deleted models.
4.17	ALL7402	11 Jun 2019	Latest	Pushed automatic rebuild of the latest version of each Snap Pack to SnapLogic UAT and Elastic servers.
4.17	snapmrc515		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.16	snapsmrc508	16 Feb 2019	Stable	No updates made. Automatic rebuild with a platform release.
4.15	snapsmrc500	09 Nov 2018	Latest	To support Anaplan v2.0 API, we have enhanced the Anaplan Account configuration. Added retry capability to Anaplan Action, Read, Write, and Upload Snaps that allow you to handle connection timeouts during Pipeline execution.
4.14	anaplan6247	11 Nov 2018	Latest	Added a new property, Override server settings, to override a few settings saved on Anaplan's server.
4.14	anaplan5742	07 Sep 2018	Latest	Fixed an issue where certain JCC-logging configurations had conflicts in class loading that resulted in inaccurate log information.
4.14	snapsmrc490	11 Aug 2018	Stable	No updates made. Automatic rebuild with a platform release.
4.13	snapsmrc486	12 May 2018	Stable	No updates made. Automatic rebuild with a platform release.
4.12	snapsmrc480	17 Feb 2018	Stable	No updates made. Automatic rebuild with a platform release.
4.11	snapsmrc465	11 Nov 2017	Stable	No updates made. Automatic rebuild with a platform release.
4.10	snapsmrc414	12 Aug 2017	Stable	No updates made. Automatic rebuild with a platform release.
4.9	snapsmrc405	13 May 2017	Latest	Added connection retry logic to Anaplan Action Snap. "Re-submission of chunks" logic added to Anaplan Upload Snap.
4.8	snapsmrc398	11 Feb 2017	Stable	No updates made. Automatic rebuild with a platform release. Info tab added to accounts.
4.7	anaplan2179	23 Nov 2016	Latest	Improved suggest lookup of Anaplan Snaps server files setting.
4.7	snapsmrc382	12 Oct 2016	Latest	Updated the Anaplan Action Snap with a new output handling mechanism, Stream errors. Additionally, starting from 4.7 release, the default output handling mechanism is Stream errors. Prior to 4.7 release, the default mechanism was AllSuccess.
4.6	anaplan1874	29 Aug 2016	Latest	Improved the error doc schema and error handling.
4.6	anaplan1870	25 Aug 2016	Latest	Implemented new "Stream errors" mode.
4.6	anaplan1863	23 Aug 2016	Latest	Resolved an issue with the Anaplan Action Snap failing with Java Heap Space.
4.6	snapsmrc362	18 Jun 2016	Latest	Extended support for a der encoded representation of Anaplan Certificate for Anaplan account validation. Anaplan Action Snap is enhanced to support handling of output during an import action. If an import operation is unsuccessful, rows without an error are written to the output view, and rows with an error are written to the error view.
4.5.1		18 May 2016	Stable	No updates made. Automatic rebuild with a platform release.
4.5	snapsmrc344	14 May 2016	Latest	Resolved an issue with some Anaplan Snaps stopping on error even when an error view was enabled. Improved error handling and output information to the Snaps in the Anaplan Snap Pack. Support for Upload only operation in Anaplan Write Snap to upload a file to a server without running an import job. Doc Enhancement: Examples added to Anaplan Snap documentation.
4.4.1		18 Mar 2016	Latest	Anaplan Action Snap updated to include "resolution" in error output.
4.4		13 Feb 2016	Latest	Resolved a "String index out of range" issue in the Anaplan Write Snap.
4.3.2		15 Jan 2016	Latest	NEW! Anaplan Upload Snap Anaplan Write now outputs more details to error view. Resolved an issue in the Anaplan Read Snap where the suggested values for Export ID came back null. Resolved an issue with the Anaplan Write Snap failing when writing to the error output view. Resolved an issue with the Anaplan Action Snap not showing a list of the processes during Suggest.
4.3.1		13 Nov 2015	Latest	Resolved an issue with Anaplan Write Snap's error handling in some cases producing inaccurate information. Resolved null pointer exceptions in the Write Snap. Server filename is now suggestible. Migration impact: The output of the Write Snap is now a document instead of a string. Any pipelines using Anaplan Write along with a downstream Snap that is parsing the Anaplan Write output it will have to be reworked to use the new document map.
4.3		24 Oct 2015	Latest	Migration Impact: The Anaplan Read Snap now writes the Anaplan file data read into the binary output view as a stream. This was done to resolve an issue with the Snap generating all column values into a single column.4.2.2
4.2.1		07 Aug 2015	Latest	Resolved an issue with the Anaplan Write Snap skipping the first row. Resolved an Anaplan Exception when writing from a database to Anaplan. Resolved an issue with requests routing to error view but the file getting imported into Anaplan instance. Migration Impact: The Anaplan Read Snap now writes the Anaplan file data read into the binary output view as a stream. This was done to resolve an issue with the Snap generating all column values into a single column.
		June 2015	Latest	Anaplan action Snap should work for Anaplan processes as well.June 6, 2015 (2015.20)
		March 2015	Latest	Anaplan accounts now work with Anaplan certificates
		December 2014	Latest	NEW! Anaplan Action & Write
		October 2014	Latest	NEW! Anaplan Read (Beta)