This Snap polls the target directory and looks for file names matching the specified pattern. It continues polling at the intervals specified in the Polling interval property until the timeout (specified in the Polling timeout property) is reached. Once polling is done, the Snap lists all files whose names match the specified pattern.
This Snap polls the target directory only; subdirectories, if any, are ignored. Use the Directory Browser Snap if you want to poll files in the directory and all subdirectories, as well as to poll a directory only once.
The File Poller Snap can be used in situations where an operation must be triggered when a specific file is found in the target directory. The pipeline can be configured with additional Snaps to process the Snap's output and delete the matched file before the Polling interval value is reached.
Expected upstream Snaps: Any Snap with a document output view, such as Mapper, JSON Generator.
Expected downstream Snaps: Any Snap with a document input view, such as File Reader, Mapper, JSON Formatter.
Expected input: An optional document to evaluate expressions in the Directory and/or File filter properties. Note that each input document will trigger the execution of the Snap.
Expected output: A full path in each document as a value for a key "path". If there are multiple files matching the filter, the same number of documents will be provided in the output view after each interval.
The 'IAM_CREDENTIAL_FOR_S3' feature is to access S3 files from EC2 Groundplex, without Access-key ID and Secret key in the AWS S3 account in the Snap. The IAM credential stored in the EC2 metadata is used to gain the access rights to the S3 buckets. To enable this feature, the following line should be added to global.properties and the jcc (node) restarted: jcc.jvm_options = -DIAM_CREDENTIAL_FOR_S3=TRUE
Please note this feature is supported in the EC2-type Groundplex only.
For S3 folders, the Snap currently supports polling the target directory for a maximum of 10,000 files. If there are more than that, the Snap does not provide any output.
Account:
This Snap uses account references created on the Accounts page of SnapLogic Manager to handle access to this endpoint. This Snap supports several account types, as listed in the table below, or no account. See Binary Account for information on setting up these types of accounts. Account types supported by each protocol are as follows:
Protocol
Account types
sldb
no account
s3
AWS S3
ftp
Basic Auth
sftp
Basic Auth, SSH Auth
ftps
Basic Auth
hdfs
no account
webhdfs
no account
smb
SMB
wasb
Azure Storage
wasbs
Azure Storage
gs
Google Storage
file
Local file system
Required settings for account types are as follows:
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.
Directory
This property is a URL path to the directory where files will be searched. The expected syntax is:
[protocol]://[host][:port]/[path]
The supported file protocols are:
s3:
file:
ftp:
ftps:
sftp:
hdfs:
webhdfs:
sldb:
smb:
wasb:
wasbs:
gs:
Example:
s3:///[bucket_name]/[dir_path]
sftp://ftp.snaplogic.com:22/home/test/dir
ftp://ftp.snaplogic.com/test/csv
$directory
_directory (A key-value pair with "directory" key should be defined as a pipeline parameter. Ensure that the '=' button is enabled when using parameters.)
file:///D:/testFolder/ (if the Snap is executed in the Windows Groundplex and needs to access the D: drive)
wasb:///Snaplogic/testDir/ or wasbs:///Snaplogic/testDir/
gs:///testBucket/testDir/
Default value: [None]
The protocol and the rest of the URL should be separated by "://". The host name and the port number should be between "://" and "/".
Not all file protocols support "//", use "///" instead. For example, if polling files in SLDB and S3 (see the examples shown above).
This property should be an absolute path for all protocols except SLDB. For SLDB, the Snap can access only the same project directory or the shared project directory, and cannot access other project directories.
If you want this property to refer to the SLDB project (or shared project) directory where the pipeline of this Snap belongs to, enter "sldb:///" or leave it blank.
If the pipeline is created in a project other than the shared project and you want this property to refer to the shared project, enter "shared" or "sldb:///shared".
If the port number is omitted, a default port for the protocol is used. The hostname and port number are omitted in the SLDB and S3 protocols.
File filter
Required. A GLOB pattern to be applied to select one or more files in the directory. The File filter property can be a JavaScript expression which will be evaluated with values from the input view document. Example:
*.txt
ab????xx.csv
Default value: [None]
Glob Pattern Interpretation Rules
Use glob patterns in this filter to select one or more files in the directory. For example:
*.java Matches file names ending in .java.
*.* Matches file names containing a dot.
*.{java,class} Matches file names ending with .java or .class.
foo.? Matches file names starting with foo. and a single character extension.
The following rules are used to interpret glob patterns:
The * character matches zero or more characters of a name component without crossing directory boundaries.
The ? character matches exactly one character of a name component.
The backslash character (\) is used to escape characters that would otherwise be interpreted as special characters. For example, the expression \\ matches a single backslash, and "\{" matches a left brace.
The [ ] characters are a bracket expression that match a single character of a name component out of a set of characters. For example, [abc] matches 'a', 'b', or 'c'. The hyphen (-) may be used to specify a range; so, [a-z] specifies a range that matches from 'a' to 'z' (inclusive). These forms can be mixed; so, [abce-g] matches 'a'", 'b', 'c', 'e', 'f' or 'g'. If the character after the '[' is an '!', then it is used for negation; so, [!a-c] matches any character except 'a', 'b', or 'c'.
Within a bracket expression, the *, ?, and \ characters match themselves. The (-) character matches itself if it is the first character within the brackets, or the first character after the '!', if negating.
The { } characters are a group of subpatterns, where the group matches if any subpattern in the group matches. The ',' character is used to separate subpatterns. Groups cannot be nested.
Leading period / dot characters in file names are treated as regular characters in match operations. For example, the '*' glob pattern matches file name '.login'.
Some special characters are not supported. A partial list of unsupported special characters: #, ^, â, ê, î, ç, ¿, SPACE.
Polling interval in seconds
Required. The time-gap between each poll request (in seconds).
Example: 10
Default value: 30
Polling timeout
Required.A period of time after which file polling must end. You specify the number here and the time unit in the next property. Its unit is selected in the next property.
Example:
-1 (to poll indefinitely)
0 (to poll once)
60 (its unit shown in the next property)
Default value: 30
Configure this property based on the expected number of files in the targetdirectory.If there aremany files and this property's valueis small,the Snap may complete the operationand stop before the file is found.
Polling-timeout unit
Unit for the polling timeout. Allowed values are SECONDS, MINUTES and HOURS.
Example: SECONDS
Default value: MINUTES
Only Output on Change
Select this check box to instruct the Snap to provide an output only when there is a change in the contents of the polled directory. When selected, the Snap provides an output during its initial run if it finds matching documents. However, it provides polling results in the next run only if the polled directory has newer files that match the pattern specified.
Default value: Selected
Number of retries
Specifies the maximum number of retry attempts in case of a network failure.
Example: 3
Minimum value: 0
Default value: 0
Retry interval (seconds)
Specifies the minimum number of seconds for which the Snap must wait before attempting recovery from a network failure.
Writing out the List of Files in a Specific Directory Using the File Poller
In this example, you test the File Poller Snap to see whether it reliably lists out files from a specific directory. You then write the output to a file and run the File Poller Snap again to check whether the new file was created as expected. To ensure that the File Poller Snap doesn't pick up any existing files, you use an unusual extension for this exercise.
You add a File Poller Snap and configure it to poll a directory for all files with the extension ".JSON2":
You then use a combination of JSON Formatter and File Writer Snaps to process the output and write it out to a file. You use the date.now() function to give the file a name, so every time you run the pipeline, a new file is created.
You use the JSON Formatter Snap with the default settings.
File Writer
When used in production, the output from the File Poller Snap can be used to trigger specific tasks as needed. In this example, you write it to a file:
As expected, the file contains no output, as there is no file in the target directory with the extension ".JSON2".
You now add a second File Poller Snap and configure it exactly as you configured the first one. Once again, you add a JSON Formatter and File Writer Snap with the same settings as for the previous pair. But this time, the file created is not blank: It lists out the file that you created using the first three Snaps in the pipeline:
This tells you that the File Poller Snap works as expected with the settings you have used.
To make this example work, you must perform the following tasks:
Create a pipeline that receives specifications from ServiceNow on the file type for which you want to poll a directory.
Create a Trigger Task that will make the pipeline available as a REST API.
Create a REST call in ServiceNow that will trigger the Task created in Step 2 above.
Creating the File Poller Pipeline
You design a pipeline containing the following Snaps:
CSV Parser: Parses the data coming in from ServiceNow as a CSV document.
Mapper: Makes the contents of the input CSV document available as a parameter.
File Poller: Polls a specific directory for files matching the pattern specified in the parameter received from the Mapper Snap.
You will note that the File Poller has open input and output views. This is because it receives data from the Trigger Task associated with it and returns processed data back to the same Trigger Task.
CSV Parser
You use the CSV Parser Snap with the default settings:
Mapper
You configure the Mapper Snap to receive the parsed CSV data and map the message in the CSV document to the $msg variable:
File Poller
You configure the File Poller Snap to poll the /QA/Documentation/File Poller/ directory for all files that match the pattern contained in the $msg variable, which you use as a file filter parameter:
Creating a Trigger Task for the File Poller Pipeline
You save the pipeline, click the (Create Task) button, and configure the Trigger Task:
You click Update to complete setting up the task; then navigate to the Manager to view the Trigger Task's properties:
You copy the Cloud URL and authorization bearer token, and navigate to ServiceNow to set up the API call.
Creating a REST call in ServiceNow
Create a REST Call in ServiceNow by appending the authorization token to the Cloud URL that you copied in the previous step:
For details on how to set up REST calls using ServiceNow, see ServiceNow documentation.
While configuring the REST call, ensure that:
HTTP Method is POST.
Endpoint contains the Cloud URL concatenated with the bearer token.
HTTP Parameters > Content contains the variable and extension value that you want to use.
You click Test to check the REST call. For a successful execution, the pipeline returns a list of files whose extension matches the value in the Content field:
Updated and certified against the current SnapLogic Platform release.
August 2024
438patches28197
Latest
Fixed an issue in the Binary Snap Pack that caused intermittent errors on the Groundplex nodes when using the SMB protocol. The errors occurred when multiple IPs were returned for the same address, and one of the IPs was unreachable by the SMB server
Fixed an issue in the Directory Browser Snap where a mount error was displayed if the hostname contained an underscore, resulting in an empty hostname in the SMB URL.
August 2024
main27765
Stable
Upgraded the org.json.json library from v20090211 to v20240303, which is fully backward compatible.
May 2024
437patches27146
Latest
Enhanced the Azure Storage Account with Managed Identity, which provides applications with an automatically managed identity for connecting to resources that support Microsoft Entra ID authentication.
May 2024
437patches26873
Latest
Fixed an issue with the File Poller Snap where the Snap applied a case-sensitive filter in the Windows operating system.
May 2024
437patches26592
Latest
Enhanced the Decompress Snap to support encrypted and unencrypted ZIP and 7z files through the new File Password Account type.
Fixed an SMB (server message block) connectivity issue within the Binary Snap Pack, as the incorrect name provided by the SMB client did not match the Windows cluster virtual name, affecting the SPN (service principal name) connection.
February 2024
436patches25332
Latest
Fixed a null pointer exception in the Public Key Account for Binary Snap Pack when the Public Key field value is null. Now, the account displays a configuration exception for a null value.
February 2024
436patches25241
Latest
Fixed an issue with the File Writer Snap, which partially writes the file for some FTPS servers by pausing for seconds before closing the output stream as specified in the global property ftpsDelayBeforeClosing.
February 2024
436patches25161
Latest
Fixed an issue with the File Poller Snap that displayed an exception when an unauthorized character ':' was used in the Windows Snaplex.
February 2024
main25112
Stable
Updated and certified against the current SnapLogic Platform release.
November 2023
435patches24525
Latest
Fixed an issue with the File Poller Snap that caused it to poll recursively for files in the root directory of the S3 bucket.
November 2023
435patches23780
Latest
Fixed an issue with the Binary Snaps that failed to build a data connection when connecting to the FTP server over FTPS protocol.
November 2023
main23721
Stable
Updated and certified against the current SnapLogic Platform release.
August 2023
434patches23502
Latest
Fixed an issue with the File Operation Snap (SFTP protocol) where the error message did not display during a move operation, although the existing file was available in the target path and the Error if exists checkbox was selected.
August 2023
434patches23302
Latest
Fixed an issue that occurred when node properties were used to override default algorithm specifications for SFTP operations.
August 2023
434patches22976
Latest
Fixed an issue that caused account credentials to be visible in the stack trace of some failed SFTP operations.
August 2023
434patches22842
Latest
Fixed an issue that caused NTLM authentication issues when trying to access SMB servers.
August 2023
434patches22639
Latest
The JSON key field in the Binary Google Service Account supports JSON strings. You can upload the JSON key either from SLDB or dynamically pass the value using a pipeline parameter or access values from Secrets Manager.
August 2023
main22460
Stable
Updated and certified against the current SnapLogic Platform release.
May 2023
433patches22297
Latest
Fixed an issue with the PGP Sign Snap that caused an error when using an encryption subkey for signing.
Fixed an issue with the File Writer Snap where the file was unable to validate when the File action field was set to IGNORE for the WASB and WASBs protocols.
May 2023
433patches21913
Latest
Dynamic ports are supported for the SMB file protocol.
Fixed an issue with the File Writer Snap that caused slow performance when writing large files and the Flush interval was set to a positive value.
May 2023
433patches21870
Latest
Added the PGP Sign Snap, which allows binary data to be signed using PGP.
May 2023
433patches21645
Latest
With the 4.33 GA release, support for some algorithms for SFTP connection negotiation is removed for improved security and because we’ve updated the library used to connect to SFTP sources. With Snap Pack version 433patches21645, you can modify the global properties. Refer to the Configuration Settings for Snaps documentation for details about how to revert to the previous settings.
May 2023
433patches21576
Latest
Fixed the issues with the AES Encrypt and AES Decrypt Snaps, where the Snaps previously did not include the error stack trace in the error view. The Snaps now provide detailed information in case of any issues or errors.
May 2023
433patches21482
Latest
Fixed an issue that caused a String index out of range error with the SFTP protocol in the File Writer Snap when it attempted to create a top-level directory.
Enhanced the PGP Encrypt Snap with the Encryption key ID field, which allows you to specify the key ID for encrypting the data. If you do not specify an encryption key ID, the Snap uses the primary key in the public key (master key).
Starting from version 433patches21482, the PGP Encrypt Snap will no longer support encryption with an expired key. To ensure continued support for encryption, we highly recommend extending the expiration of your PGP key.
May 2023
433patches21291
Latest
Fixed an issue with the Multi File Reader Snap where it failed with the error S3 object not found when the Snap found no matching file to read and the Folder/File property value did not end with a forward slash (/).
May 2023
433patches21179
Latest
Fixed an issue with the File DeleteSnap where the Snap failed with a 404 Not Founderror when trying to delete files from an Amazon S3 bucket. This issue occurred only with the Identity and Access Management (IAM) role in an Amazon AWS S3 Account.
Fixed an issue where Binary Snaps could not handle region information for the Amazon S3 file protocol, which resulted in an error.
May 2023
main21015
Stable
The Key passphrase field in the Private Key Account now supports expressions, allowing dynamic evaluation using pipeline parameters when the expression button is enabled.
February 2023
432patches20458
Latest
Fixed an issue where the ZipFile Read and ZipFIle Write Snaps failed to display the input schema for the File or File name field when using an expression.
February 2023
432patches20431
Latest
Fixed an issue where the File Writer Snap would not retry on completing the writing of the file.
Added a configuration warning message when using the WASBS protocol with AzCopy, as it supports only the HTTPS protocol.
February 2023
432patches20349
Latest
The JSCH library has been upgraded to version 0.2.7.
February 2023
main19844
Stable
Upgraded with the latest SnapLogic Platform release.
November 2022
431patches18977
Latest
The PGP Decrypt Snap now allows you to skip the signature verification when you face an issue with the signature in the encrypted file.
November 2022
main18944
Stable
Upgraded with the latest SnapLogic Platform release.
September 2022
430patches17933
Latest
The File Delete Snap now passes the input document to the error view correctly.
The AWS S3 and S3 Dynamic accounts now support the maximum session duration of an IAM role defined in AWS.
August Patch
430patches17292
Stable and Latest
Fixed an issue with the Directory Browser Snap, which failed with a null pointer exception error when connecting to the SFTP server containing a port number.
The Binary Snap Pack is deployed as both the latest and stable distribution. We recommend that you use this version for your Org when using the recommended Snaplex version (main-13269 - 4.30 GA).
August 2022
main17386
Stable
The File Operation Snap supports moving data from a local node to an Azure blob through the AZ Copy utility.
The Azure Storage Account includes the Request Size (MB) field to set the buffer limit before writing to Azure storage to enhance the performance.
The SSH Auth Account supports dynamic values for the following fields that allow you to use Pipeline parameters.
Username
Private key
Key passphrase
4.29 Patch
429patches16569
Latest
Enhanced the File Operation Snap to support moving data from local node to Azure blob through the AZ Copy utility.
Enhanced Azure Storage Account with the Request Size (MB) field to set the buffer limit before writing to Azure storage to enhance the performance.
Enhanced the following Binary Snaps to partially support '?' character in the file names and file paths:
Improved the tooltip for the File action field in the ZipFile Write Snap.
Enhanced the SSH Auth Account with Expression enabler () for the following fields that allow the use of Pipeline parameters to populate the properties.
Username
Private key
Key passphrase
4.29
main15993
Stable
Enhanced the following Snaps and Accounts that use SnapLogic File System (SLFS) to display Lint warnings in Pipelines when using incorrect file paths to read and write files. We recommend that you use the File Upload :Upload_icon: icon to specify the file path.
Fixed an issue with the Directory Browser Snap where the Snap failed while parsing the value in the Amazon S3 client region.
Enhanced the File Writer Snap with the Prevent URL encoding checkbox to manage the URL encoding. Select this checkbox to prevent the encoding of the file path URL automatically. This allows the Snap to use the file path value as-is. Deselect this checkbox to automatically encode the characters in the File URL.
Fixed an issue with the ZipFile Write Snap where the Snap displayed a null pointer exception when the path in the upstream File Reader Snap started with "../".
Fixed an issue in the File Reader Snap where the Snap displayed an SMB Mount error when trying to connect to Mount Share. This Snap now supports SMB version 3.1.1.
Fixed an issue with the File Writer Snap where the Snap did not display an error when an error occurred while writing a file.
4.28 Patch
428patches14736
Latest
Fixed an issue in the File Writer, S3 File Writer, and ZipFile Write Snaps where the Snaps failed with AccessControlListNotSupported error when using an external AWS account to write to the bucket if it has the bucket-owner-enforced setting enabled. With this fix, you can select the None option (the default value), from the AWS Canned ACL dropdown list, indicating that no Canned ACL request is set when writing a new file to prevent the error.
4.28
main14627
Stable
Enhanced the File Operation Snap to support Azure Data Lake Storage (ADLS) Gen2 protocol for moving and copying files in the Azure Blob File System (ABFS).
Fixed an issue with the File Poller Snap to enhance performance of the polling operations that allows the Snap to poll the files without stopping.
Enhanced the File Writer, S3 File Writer, and ZipFile Write Snaps with the AWS Canned ACL(Access Control List) permission mode that enables you to use Canned ACLs when creating the S3 Object. This feature allows you to grant full access of the object to the S3 bucket owner.
4.27 Patch
427patches14283
Latest
Fixed an issue with the File Writer Snap where the Server Message Block (SMB) mount failed to connect unless the Pipeline was restarted.
Enhanced the S3 File Writer Snap with the Suggest fully-qualified file names checkbox that allows you to use fully-qualified file names in the File name Suggestions list for gov cloud instances.
Fixed an issue with the File Poller Snap to handle indefinite polling operations without stopping in the process of execution.
Fixed an issue with the ZipFile Write Snap where the ZIP extension files were downloaded with an incorrect file extension.
Fixed an issue with the Zip File Read Snap where an archive failed to uncompress.
Fixed an issue with the File Writer Snap when a file greater than 10 MB failed to write when uploading to Google Storage.
Upgraded the Google Cloud Storage Java libraries from version 1.105.1 to version 2.2.2.
4.27 Patch
427patches13004
Latest
Fixed an issue with the SMB Account where the Snaps could not re-establish a lost connection to the SMB mount point.
4.27
main12833
Stable
Enhanced the File Operation Snap with a new field Azcopy absolute path that enables the Snap to make a single API call to move an entire directory. This field supports directory and wildcard characters for Azure blob storage for all three operations: Copy, Move and Rename.
Enhanced the Azure Storage Account with a new option called SAS URI in the Auth Type dropdown. This enables you to select either Access Key or the SAS URI while configuring the account settings.
4.26 Patch
426patches12288
Latest
Fixed a memory leak issue when using HDFS protocol in Binary Snaps.
4.26 Patch
426patches11922
Latest
Fixed an issue with the File Writer Snap, where the Snap failed to open a channel while accessing through a SFTP protocol.
4.26 Patch
426patches11529
Latest
Fixed an issue with the Decompress Snap, where the Snap prematurely uncompressed multi-stream BZIP2 files.
Enhanced the PGP Encrypt Snap with improved memory usage and also fixed an issue with this Snap, where the Snap failed to encrypt large size files due to the lack of memory.
4.26
main11181
Stable
Upgraded with the latest SnapLogic Platform release.
4.25 Patch
425patches10994
Latest
Removed duplicate strings in the request’s User Agent header sent by S3 File Writer and S3 File Reader Snaps to display the string without any duplicates.
Enhanced the Directory Browser Snap to process the files with the owner field for the SFTP protocol. Upon validation, the output of the Snap fetches the owner’s name, which was previously displayed as unknown.
Fixed an issue with the File Writer Snap where the Snap fails to connect to the SFTP endpoint using the AWS Transfer Family.
Fixed an issue where integration Pipelines fail to connect the SFTP Server with the Binary Snap Pack when upgraded to the SnapLogic 4.25 release version (main9554).
4.25 Patch
425patches10217
Latest
Fixed the following issues in the PGP DecryptSnap caused due to the Snap patch 425patches9581:
The Snap writes an empty document to the output view when there is an error in the Snap. It will now decrypt the document and write it to the output view only if it succeeds.
The Snap fails to decrypt any non-signed encrypted file more than 500 bytes. It will now decrypt both non-signed and signed encrypted files.
Removed the Project ID field from the Google Service Account, since the JSON Key already contains information about the Project ID.
4.25 Patch
425patches9581
Latest
Fixed an issue with the PGP Decrypt Snap where the Snap writes an empty document to the output view when there is an error in the Snap. It will now decrypt the document and write it to the output view only if it succeeds.
As of we have discovered an issue with this Binary patch affecting the PGP Decrypt Snap. In case your Pipelines use the PGP Decrypt Snap, we recommend you to NOT use this patch. Else, your Pipelines will likely fail. We're working on a fix and will be deploying a Snap patch soon.
4.25 Patch
425patches9564
Latest
Enhanced the SFTP session in Binary Snaps to support the SFTP servers which close SFTP sessions slowly.
4.25
main9554
Stable
Enhanced theS3 File Writer Snap with an ability to write S3objects with Access Control List (ACL) details in a single API call.
In the 4.23 release, the S3 File Writer Snap used to write an S3 file and then set ACL if the ACL property was not empty. If the file write was successful and the ACL setting failed, both the output document in the output view and the error document in the error view was displayed. This issue has been resolved in the 4.24 release by enabling the Snap to configure ACL while writing the file. Therefore, the Snap produces an error document in the error view if the ACL configuration fails, irrespective of whether the file write action passes or fails.
4.24 Patch
424patches9044
-
Latest
Enhanced the S3 File Writer to use an MD5 checksum that automatically checks for data integrity and corruption while uploading the file.
4.24 Patch
424patches9020
Latest
Fixed the file operation error of copying large S3 files in the File Operation Snap by supporting the transfer of zero-byte S3 files while uploading a file.
4.24 Patch
424patches8876
Latest
Fixed the missing library error in Binary Snap Pack when running Hadoop Pipelines in JDK11 runtime.
Enhanced the Binary Snap Pack by adding a new account Two-Factor Auth Account that supports two layers of authentication for Secure File Transfer Protocol (SFTP). The two secure layers of verification to grant access include the Basic Auth (username/password) and the SSH Key (username/private key) methods.
4.24
main8556
Stable
Upgraded with the latest SnapLogic Platform release.
4.23 Patch
423patches8453
Latest
Fixed an issue in the File Writer Snap with the ADL protocol, to perform the correct action when OVERWRITE is selected from the File Action drop-down field.
4.23 Patch
423patches8368
-
Latest
Fixed an encryption issue with the File Operation Snap by implementing both SSE-KMS and SSE-S3 supports to the Snap.
4.23 Patch
423patches8368
-
Latest
Fixed an issue in the Snap Pack by removing the plaintext credentials in file URL from JCC log messages.
4.23 Patch
423patches8099
-
Latest
Enhanced the Snap Pack by upgrading SMB client library.
4.23 Patch
423patches7958
-
Latest
Fixed an issue with the File Writer Snap by avoiding overwriting of documents when using appending the data to a CSV file in SFTP.
4.23 Patch
423patches7958
-
Latest
Rolled back the recent patch to Binary Snap Pack (File Writer Snap - 423patches7923) that might have induced SSL handshake failures/terminations in existing Pipelines.
4.23 Patch
423patches7923
Latest
Fixed the SFTP connection failure issue inFile WriterSnap by
Ensuring that the BouncyCastleProvider is the first in the list of providers in the Security object.
Upgrading the BouncyCastle version to 1.67.
Do not use the 423patches7923 build for the File Writer Snap, because it causes connectivity issues with the Snaplex nodes.
4.23 Patch
423patches7795
-
Latest
Fixed an issue with File Writer Snap by skipping the validation of the SAS URI having write permission, if the SAS URI uses an access policy.
4.23 Patch
423patches7660
-
Latest
Enhanced the File Poller Snap by adding a field, Exit on first matches, which when set to true stops the Snap from executing after the first file paths matching the filter are written to the output view. If the field is not configured or is set to false (default value), then the Snap continues to poll the directory until the Polling timeout is reached.
4.23
main7430
-
Stable
Enhanced the ZipFile Write Snap to provide the ability to change the default content-type (application/octet-stream) for any file that is stored into the Azure Blob Storage (WASB: or WASBS: file protocol). Hence, the files that the ZipFile Write Snap writes into the Blob Storage can be saved with content-type asapplication/zipor any other type instead of application/octet-streamalways.
You can now prevent the Snap from writing files always to Azure Blob Storage (WASB: or WASBS: file protocol) with the application/octet-stream content-type. To do so, configure a binary header property in an upstream Snap, such as JSON Formatter or Mapper, to match the file's content – application/zip, application/java-archive and so on; and pass it as the$content-type (case-sensitive) for the file.
4.22 Patch
422patches6947
-
Latest
Fixed the issue of the hanging thread in the SMB accounts.
Fixed theZipFile WriteSnap error by allowing the number of retries to be set greater than 0.
4.22 Patch
422patches6542
-
Latest
Fixed SMB hanging threads by upgrading SMB client library.
4.22
main6403
-
Latest
Added theCross Account IAM Rolefeature to the existing accounts, AWS S3 Account and S3 Dynamic Account,to enable the AWS account user to access the resources of another AWS account for a specified time without sharing the login credentials.
Enhanced the File OperationSnap by adding a new property Simple file operation that allows moving or copying a file, through FTP protocol, irrespective of the account's access permissions on source and target directories.
4.21 Patch
421patches6136
-
Latest
Fixed the issue with Multi File Reader Snap that continues to look for a directory even whenFileSysteminformation is unavailable.
4.21 Patch
421patches6090
-
Latest
Fixed the 'Connection pool shut down' error in S3 File Writer Snap by keeping the AmazonS3Client class object open until all the documents are processed.
4.21 Patch
421patches6077
-
Latest
Fixed the UnknownHostExceptionerror in Binary Snaps due to intermittent failures in FileSystemProviderregistration, by replacing ServiceLoader with direct instantiations of FileSystemProvider class objects.
4.21 Patch
421patches5994
-
Latest
Fixed an error in Multi File Reader and File Delete Snaps during Pipeline execution where the Snaps fail to retrieve the temporary files from the given S3 location.
4.21 Patch
421patches5963
-
Latest
Enhanced the Directory Browser Snap by making the File filter field optional.
4.21 Patch
421patches5975
-
Latest
Fixed the Directory Browser Snap that fails with an Unable to create filesystem object for smb:// error, by rolling back the SMB client library to the prior working version as in snapsmrc542.
4.21 Patch
421patches5871
-
Latest
When configuring the SSH Auth account type, SSH passphrase is now optional, whereas it was a required field earlier.
4.21 Patch
binary8849
-
Latest
Enhanced the Directory Browser Snap by adding a new advanced property Use fast file-type check for wasb/wasbs protocols for quick Snap execution.
4.21 Patch
binary8843
-
Latest
Fixed the issue in PGP Encrypt Snap where decrypting its output file using a third-party PGP software adds a random suffix and TMP extension in the file name. This issue occurs only when using the PGP Encrypt Snap in a Windows-based Groundplex.
4.21
snapsmrc542
-
Stable
Upgraded with the latest SnapLogic Platform release.
4.20 Patch
binary8801
-
Latest
Fixed the Decompress Snap wherein the Snap stops decompressing at 64MB without displaying any error, when decompressing using the GZIP scheme.
Fixed an issue in the PGP Encrypt Snap so that third-party decryption tools do not receive a .tmp file from the Snap.
4.20 Patch
binary8791
-
Latest
Fixed the ZipFile Write Snap wherein the Snap fails to execute if it finds different zip file paths when processing multiple input binary data.
4.20 Patch
binary8785
-
Latest
Added theUser-defined object metadataandObject tagsproperties in the S3 File Writer Snap and the Get Object Tagsproperty in the S3 File Reader Snaps to allow the inclusion of user-defined metadata and object tags.
Fixed a regression caused by Patch binary8775 wherein the File Reader and S3 File Reader Snaps fail to read S3 files with an account that does not include GetObjectTagging permission.
4.20 Patch
binary8775
-
Latest
Fixed the File Writer Snap to allow the deletion of temporary Google Storage files from the/tmpdirectory of the Groundplex if Pipeline execution stops before completion.
4.20 Patch
binary8741
-
Latest
Fixed the ZipFile Write Snap wherein the Snap gives a Null Pointer Exception error if no input data is received by it during execution.
Fixed the Email Sender & Reader Snaps where the Snaps fail to execute due to resource exhaustion on the Snaplex.
4.20 Patch
binary8710
-
Latest
Fixed the ZipFile Write Snap where the Snap generates files with incorrect names when the Use input view label checkbox is selected.
Fixed the File Writer Snap where the Snap fails intermittently when there is a network disruption.
Fixed the File Reader Snap where the Snap generates an output view, along with the error view, if there is an error when using the Google Service account.
4.20
snapsmrc535
-
Stable
Upgraded with the latest SnapLogic Platform release.
4.19 Patch
binary8369
-
Latest
Fixed the following issues associated with the SMB account wherein:
Pipelines with multiple concurrent SMB connections hang intermittently.
Directories are not deleted completely.
4.19
snaprsmrc528
-
Latest
The Key Passphrase field is now a mandatory field for the SSH Auth account. Ensure that you provide a passphrase when adding/editing accounts. Else, you will likely lose all updates related to the account and Pipeline.
Raises the minimum buffer size in the S3 File Writer Snap to 6 MB.
4.18 Patch
binary8768
-
Latest
Fixed the File Reader, File Writer, and Directory Browser Snaps to resolve 0x103 (STATUS_PENDING) and 0xc000022d (STATUS_RETRY) errors for SMB file operations.
4.18 Patch
binary8046
-
Latest
Enhanced the Snap Pack to support AWS SDK 1.11.634 to fix the NullPointerException issue in the AWS SDK. This issue occurred in AWS-related Snaps that had HTTP or HTTPS proxy configured without a username and/or password.
4.18 Patch
MULTIPLE7884
-
Latest
Fixed an issue with the PostgreSQL grammar to better handle the single quote characters.
4.18 Patch
binary7860
-
Latest
Fixed an issue with the File Writer Snap wherein the Snap is intermittently unable to set correct permissions.
4.18 Patch
binary7851
-
Latest
Added new field, Advanced properties, in the File Reader, File Writer, File Delete, ZipFile Read, ZipFile Write, Directory Browser, Multi File Reader, File Poller, and File Operation Snaps. Use this field to configure the SAS URI to access Azure Storage. Supported SAS types are Service SAS on container, Service SAS on blob, and Account SAS.
Added new Snap, SAS Generator. This Snap enables you to generate Shared Access Storage (SAS) URIs for accessing Azure Storage containers and blobs.
4.18 Patch
binary7746
-
Latest
Fixed an issue with the SMB file protocol wherein Binary Snaps are unable to create a native thread using an SMB file path.
4.18 Patch
MULTIPLE7778
-
Latest
Updated the AWS SDK library version to default to the Signature Version 4 Signing process for API requests across all regions.
4.18 Patch
binary7720
-
Latest
Fixed an issue with the ZipFile Read Snap wherein the Snap fails to extract files from a zip file heavier than 100MB when the number of retries is greater than zero.
4.18
snapsmrc523
-
Latest
Added a new account type,Google Service Account, which enables you to isolate workflows from individual users.
4.18
snapsmrc523
-
Latest
Added a new account type,Google Service Account, which enables you to isolate workflows from individual users.
4.17 Patch
binary7589
-
Latest
Fixed an issue with the File Reader Snap wherein SMB fails to provide multiple Snaps with concurrent access.
4.17 Patch
binary7487
-
Latest
Fixed an issue with the File Writer Snap wherein the Overwrite File action for SMB files fails on subsequent executions.
4.17 Patch
ALL7402
-
Latest
Pushed automatic rebuild of the latest version of each Snap Pack to SnapLogic UAT and Elastic servers.
4.17 Patch
binary7381
-
Latest
Fixed an issue with SMB accounts wherein login to the server fails if password contains a plus (+) sign.
4.17 Patch
binary7366
-
Latest
Added support for multiple slashes as a prefix for SMB file URLs.
4.17 Patch
binary7280
-
Latest
Added a new field, File Delete Action, to the File Delete Snap that handles missing target files.
Enhanced the Snap Pack to support SMB versions 2.0 and 3.0 for the File Delete, File Poller, File Reader, File Writer, Multi File Reader, ZipFile Read, ZipFile Write, Email Reader, Email Sender Snaps.
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 Patch
binary7049
-
Latest
Fixed an issue with the File Writer Snap wherein the Snap writes FTPS files partially. Two new global properties, ftpsDelayBeforeClosing and ftpDelayBeforeClosing, enable you to add delays to the FTP file protocol to handle the partial write.
4.16 Patch
binary7049
-
Latest
Fixed an issue with the File Writer Snap wherein the Snap writes FTPS files partially. Two new global properties, ftpsDelayBeforeClosing and ftpDelayBeforeClosing, enable you to add delays to the FTP file protocol to handle the partial write.
4.16 Patch
binary6975
-
Latest
Added a new property, Blob endpoint, for Binary Accounts, which enables you to specify the Azure Blob Storage endpoint that you want to use with an Azure Storage account.
4.16
snapsmrc508
-
Latest
Added a new property Only Output on Change in the File Poller Snap. This property helps avoid redundancy by not displaying the same matching file in every polling result unless the file is changed.
4.15 Patch
binary6744
-
Latest
Fixed a timeout error while writing to S3 in the S3 File Writer Snap.
4.15 Patch
binary6414
-
Latest
Fixed an issue wherein the hostname specified in the Directory Browser path failed to appear as a path in the output document.
4.15 Patch
binary6414
-
Latest
Fixed an issue wherein the hostname specified in the Directory Browser path failed to appear as a path in the output document.
4.15
snapsmrc500
-
Latest
Added a new property, Binary Header Properties, to the CSV Formatter Snap. This property can be configured with the binary headers and their values in the incoming document.
4.14 Patch
MULTIPLE5732
-
Latest
Fixed an issue with S3 file reads getting aborted intermittently because of incomplete consumption of input stream.
4.14
snapsmrc490
-
Latest
Enhanced the Basic Auth and Symmetric Crypto accounts to support pipeline parameters.Using pipeline parameters, Basic Auth now supports passing username and password, and Symmetric Crypto now supports passing secret key dynamically.
4.13 Patch
binary5372
-
Latest
Updated the File Operation Snap for S3 to support files larger than 5GB by using an API for multipart upload copy.
4.13 Patch
binary5315
-
Latest
Added a new property "Enable staging" to enable the File Reader and S3 File Reader Snaps to perform as expected even in a slow network connection to AWS S3.
4.13
snapsmrc486
-
Latest
Added AWS Key Management Service (KMS) encryption support to AWS S3 and S3 Dynamic accounts in the Binary Snap Pack.
4.12
binary5044
-
Latest
Fixed an issue with the S3 File Writer Snap, which corrupts while writing files if retry value is set to 1.
4.12 Patch
binary4882
-
Latest
Fixed issue caused in the File Operation Snap due to the rollback after the 4.12 release that impacted the S3 and FTP protocols.
4.12 Patch
binary4840
-
Latest
Fixed an issue in the File Delete Snap, wherein if no account is given for the SFTP protocol, then the error did not display.
4.12 Patch
binary4797
-
Latest
Added a new property 'Number of retries' in the File Writer Snap to fix interoperability issues with a server software.
4.12 Patch
binary4736
-
Latest
Fixed the issue where File Writer Snap does not write files to Windows Serv-U FTP server, while not displaying any error message.
4.12
snapsmrc480
-
Latest
Added new Snaps - File Operation Snap and S3 File Reader Snap.
Updated S3 File Writer Snap to provide suggestions for S3 buckets and file names (versioning support).
4.11 Patch
binary4424
-
Latest
Resolved an Issue with SFTP server where the pipeline stopped responding while writing to the Tumbleweed server (SFTP server). Fixed the code in a way that the SFTP server now flushes out data after each write.
4.11 Patch
binary4328
-
Latest
Fixed an issue with the File Delete Snap that was unable to delete the file with a size greater than 1MB.
4.11 Patch
snapsmrc465
-
Latest
Added the new Snaps, Multipart Reader and Multipart Writer.
Updated the S3 File Writer Snap with Maximum upload threads property to support the performance.
The File Reader and the ZipFile Reader Snaps now show the progress message during the pipeline runtime.
4.11
binary4019
-
Stable
Resolved an issue with the File Writer Snap writing to an FTP Server that may prematurely close the connection; this patch ensures the write has fully completed before disconnecting.
4.10 Patch
binary3930
-
Latest
Directory Browser - When "Ignore empty result" is not selected, the "original" passthrough document is now returned even when the S3 directory is empty.
4.10 Patch
binary3840
-
Latest
S3OutputStream handles failures.
4.10
snapsmrc414
-
Stable
No updates made. Automatic rebuild with a platform release.
4.9 Patch
binary3331
-
Latest
Directory Browser Snap - fixed NPE issue, "File filter" property, and "Display update time and owner for S3 subdirectories" property.
4.9 Patch
binary3183
-
Latest
Fixed SFTP connection leak when "Validate after write" is checked for File Write Snap.
4.9 Patch
binary3170
-
Latest
Addressed the following issue in Directory Browser: "Update time" being returned "unknown" for directories within S3 objects
4.9 Patch
binary3081
-
Latest
Added ability to sign PGP encrypted files.
4.9 Patch
binary3060
-
Latest
Addressed an issue in Directory Browser and fixed issue in writing the original document to output view when reading from S3.
4.9 Patch
binary3022
-
Latest
Addressed an issue regarding an array out of bounds exception when IAM Role is enabled.
4.9 Patch
binary3000
-
Latest
Restore the update date date-time format for using Directory Browser with S3. A new property Display update time and owner name for s3 subfolders was added that, when enabled, will calculate update times and owners on AWS S3 subfolders.
Added theIAMsupport to the AWS S3 account.
4.9
Snapsmrc405
-
Stable
No updates made. Automatic rebuild with a platform release.
4.8 Patch
Snapsmrc405
-
Latest
Addressed an issue with Directory Browser taking too lont to start listing files from S3 bucket and then failing with partial results due to CPU spikes.
4.8
Snapsmrc398
-
Latest
Info tab added to accounts.
Streaming performance improvement while writing to an S3 bucket using S3 File Writer. Updated the S3 File Writer Snap with a Buffer size(MB) property.
The 'content-location' in the output header of Binary Snaps was updated to correctly reflect the location (for example, sldb:/// instead of sldb://). This may impact your Pipeline if you are using this information in the following Snaps:File Reader, AES Encrypt, AES Decrypt, BlowFish Encrypt, Blowfish Decrypt, Compress, Decompress, File Writer, Multi File Reader, PGP Encrypt, PGP Decrypt, TwoFish Encrypt, TwoFish Decrypt, or S3 File Writer.
4.7.0 Patch
binary2346
-
Latest
ZipFile Read Snap: Added support for reading 7z archive formats created using Windows machines.
4.7.0 Patch
binary2337
-
Latest
Added Encrypted filename property to PGP Encrypt Snap.
4.7
Snapsmrc382
-
Latest
Updated the Snap Account settings with a new Account Type, Azure Data Lake.
Updated the Snaps- Directory Browser, File Writer, File Reader with the account Type, Azure Data Lake.
Updated the File Reader and ZipFile Read Snaps with the property,Prevent URL encoding.
Spark mode support added to S3 File Writer for AWS S3.
Spark mode support added to File Reader for AWS S3.
4.6.0 Patch
binary2110
-
Latest
File Writer: fixed an issue on Windows Snaplexes that prevented creating directories that are not present.
4.6.0 Patch
binary2009
-
Latest
File Writer: fixed an issue on Windows Snaplexes that prevented creating directories that are not present.
4.6.0 Patch
binary1898
-
Latest
File Reader and ZipFile Reader Snaps: Added a new "Prevent URL encoding" setting to allow users to disable automatic URL encoding of file paths. This allows pre-encoded URLs and file paths to be used as-is.
4.6.0 Patch
binary1851
-
Latest
Resolved an issue with Directory Browser Snap not freeing up connections in Windows Groundplex.
4.6.0
Snapsmrc362
Stable
Binary Snaps that work with AWS S3 accounts can now configure their accounts with IAM Role.
Enhanced the File Writer Snap with an option to create a directory if the specified directory path does not exist, the newly added field, Create directory if not present.
Updated based on the currently supported account types. The supported account types are: Basic Auth, AWS S3, S3 Dynamic, SSH Auth, SMB, Azure Storage, and Google Storage.
4.5.1
binary1563
-
Latest
File Reader, ZipFile Read, Multi File Reader Snaps are updated with the Execute during preview field to execute the Snap during the Save operation so that the output view can produce the preview data. For more information, see File Reader, ZipFile Read, & Multi File Reader.
File Delete & File Writer Snaps are updated with an option to validate file deletion & file writing after Snap execution. For more information, see File Delete & File Writer.
ZipFile Write Snap is updated with an option, Use input view label, to enable sequential file naming of files added to zip file. For more information, see ZipFile Write.
Fixed an error in File Reader Snap that exposed account credentials in an error message.
Fixed an error in File Writer & File Delete Snap to ensure consistent error handling for all the protocols.
4.5
Snapsmrc344
-
Stable
File Reader, File Writer, S3 File Writer, ZipFile Read, Directory Browser, Multi File Reader, File Poller, File Delete, ZipFile Write, HDFS Reader and HDFS Writer updated to support IAM Roles for Amazon EC2.
Support for Google Storage added to File Reader, File Writer, Directory Browser, Multi File Reader, File Poller, File Delete, ZipFile Read, and ZipFile Write Snaps.
Resolved an issue in File Writer Snap that occurred when writing to an SFTP file with an SSH account.
Resolved an issue in Multi File Reader Snap that occurred when adding error views and performing binary data streaming.
Doc Enhancement: Example added to File Delete Snap.
4.4.1
-
-
Latest
A new Snap property Write empty file has been added to File Writer and S3 File Writer Snaps to allow for creation of zero byte files.
Resolved an exception in File Writer when 'file name' has no value.
ZipFile Read: "zip-filename" was added to the header of the output binary document.
4.
-
-
Stable
Resolved an issue with File Writer failing to timeout when attempting to connect to an SFTP location that was unreachable.
Resolved an issue with File Reader failing validation is FTP connection password had special characters.
Support for WASB and WASBS in Directory Browser, Multi File Reader, File Delete, File Poller, ZipFile Read, and ZipFile Write Snaps.
4.3.2
-
-
Latest
NEW! S3 File Writer
Implemented wasbs:// protocol support in Binary Snap Pack.
In the SnapLogic 4.3.2 release, WASB (Windows Azure Storage Blob) or WASBS protocol (wasb:/// or wasbs:///) support has been added to the Binary Snaps.
In the WASB and WASBS file URL, the top directory should be the name of the 'Azure Storage container'.
Set the Key Value parameters under global properties as below and restart the JCC for Azure Storage support:
Resolved an issue with Directory Browser Snap returning Invalid Path.
4.3.1
-
-
-
Feature: Enhanced File Delete Snap to support S3 protocol.
Resolved an issue with smb pathname failing when directory name contained a space.
Resolved an issue with a pipeline showing as successful when writing to a project to which it had no access.
Resolved an issue with Directory Browser not returning any data when target files were not present. The option, Ignore empty result, now allows you to determine whether or not to output an empty document if no data is passed through.
4.3.0
-
-
-
File Reader and File Writer now support Azure Blob as a file protocol.
Support for specifying another Windows drive path added to Directory Browser, File Poller, Multi File Reader, File Reader, and File Writer.
File Delete no longer displays user credentials in error messages.
Resolved an issue with File Poller failing to properly determine directories versus files in an S3 path.
4.2.2
-
-
-
Resolved an issue with the ZipFile Read Snap failing to decompress a zip file.
Resolved an issue with MultiFile Reader not able to read UNC-syntax local files in Windows Groundplex.
Resolved an SFTP I/O error with File Read.
Resolved an issue in SFTP pooling when a large number of connections are opened for both pooling enabled and disabled.
Resolved an issue in File Poller where setting Polling timeout to a negative number below -1 caused the Snap to run forever.
Resolved an issue in AES Snap with 256 bit keys.
Resolved a file size issue in File Writer with the Dropbox FTP site.
4.2.1
-
-
NEW! File Poller Snap. This Snap polls a directory looking for files matching the specified pattern.
PGP Decrypt now supports files that are encrypted and signed.
Resolved Directory Browser unable to support file protocol on Windows Groundplex
Resolved Multi File Reader File protocol is not working for Windows Groundplex
Directory Browser Snap listed wrong path for S3 sub-directories
-
-
-
Directory Browser: added pass-through capability
File Delete: resolved an error writing to network stream
File Writer: The output view field "fileAction" has changed to "result", web HDFS enhancements
-
-
-
Compress and Decompress: Resolved an issue with pipeline preview not limiting the amount of data available in preview.
File Writer: Improved error messages.
Multi File Reader: Resolved an issue were some files were read twice if Include subfolders was selected when using the S3 protocol.
-
-
-
Tooltip cleanup
-
-
November 2014
-
File Writer now lets you set file permissions.
-
-
July/Summer 2014
-
NEW!ZipFile Read and Write
-
-
April 2014
-
File Writer Snap updated to allow for appending, overwriting, ignoring or erroring out if the file already exists.
-
-
March 2014
-
NEW!Encrypt and Decrypt Snaps for AES
NEW!Encrypt and Decrypt Snaps for Blowfish
NEW!Encrypt and Decrypt Snaps for Twofish
NEW!Directory Browser
Execute during preview was added to the File Writer Snap.
-
-
January 2014
-
An output view was added to File Writer.
-
-
December 2013
-
NEW! File Delete Snap
NEW! PGP Decrypt and PGP Encrypt
-
-
November 2013
-
NEW! Compress and Decompress
Writer Snaps can now be enabled to write during preview.
Reader Snaps allow you to pass through data from the input view. The output of the reader will provide a new document element holding the original data from the input view (under original).
-
-
July 2013
-
There are now separate Snaps for reading a single file into SnapLogic and reading multiple files (File Reader and Multi File Reader).
-
-
June 2013
-
Initial release. Read/write support for popular data formats: Binary, CSV, HTML, JSON