Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

In this article

...

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

Field Name

Field Type

Description


Label*

Default ValueZipFile Read
ExampleZipFile Read

String

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

File*


Default value: [None] 
Example: contact.zip


String/Expression

Specify the URL for the zip file source. It should start with a file protocol. The supported file protocols are:

  • http

  • https

  • s3

  • sftp

  • ftp

  • ftps

  • sldb

  • smb

  • wasb

  • wasbs

  • gs

This Snap supports S3 Virtual Private Cloud (VPC) endpoint.

Note
  • Ensure the file name, folder name, or the file path does not contain '?' character because it is not fully supported and when present, the Snap might fail.

  • The FTPS file protocol works only in explicit mode. The implicit mode is not supported.

Multiexcerpt include macro
nameAcceptable File Paths
pageFile Writer

Multiexcerpt include macro
nameLint Warning
pageFile Writer

Prevent URL encoding


Default Value: Deselected


Checkbox

Excerpt

Select this checkbox to prevent the Snap from automatically encoding the URL file path (including the query string if it exists) and use the file path value as-is.  

Deselect this checkbox to encode the URLs. The following are some of the common characters that are automatically encoded by the Snap:

Character name Character  URL Encoded value
backslash      \ %5C
Pound #    %23
space       
 %20 
 percent    %     %25 
Left-angle<%3C
Right-angle>%3E
Left-angle[%5B
Right-square]%5D
Right-curly{%7B
Right-curly}%7D


And these are some of the characters that are not automatically encoded by the Snap:

Character name Character  URL Encoded value

semi-colon    

 ;   

 %3B

question mark     

?

 %3F

forward slash      

/

 %2F

colon       

 : 

  %3A 

ampersand      

 &  

%26

equals   

 =  

%3D

plus        

+  

%2B

dollar   

 $    

 %24

comma  

   ,     

%2C


  

Number of retries


Default Value: 0
Example:  3


Integer/Expression

Specify the maximum number of retry attempts that the Snap must make in case there is a network failure, and the Snap is unable to read the target file.

If the value is larger than 0, the Snap first downloads the target file to a temporary zip file. If any error occurs during the download, the Snap waits for the time specified in the Retry interval and attempts to download the file again from the beginning. When the download is successful, the Snap starts to unzip the data and stream the data from the temporary file to the downstream Pipeline. All temporary local files are deleted when they are no longer needed.

Info

Ensure that the local drive has sufficient free disk space to store the temporary local file.

Minimum value: 0

Retry interval (seconds)


Default Value: 1
Example: 3

Integer/Expression

Specify the minimum number of seconds for which the Snap must wait before attempting recovery from a network failure.

Minimum value: 1

Advanced properties

Use this field set to define additional properties for the Snap.

SAS URI

Dropdown

Multiexcerpt include macro
nameSASURI_Description
pageFile Reader

Note

If you specify the SAS URI value in the Snap settings, then the settings provided in the account (if any account is attached) are ignored.

Values

String/Expression

Provide a value for the SAS URI.

Snap Execution

Default ValueExecute only
Example: Validate & Execute

Dropdown list

Multiexcerpt include macro
nameSnap_Execution_Introduced
page


...

Insert excerpt
Binary Snap Pack
Binary Snap Pack
nopaneltrue