This Snap uses account references created on the Accounts page of SnapLogic Manager to handle access to this endpoint. See Configuring Box Accounts for information on setting up this type of account.
Views:
Input
This Snap has exactly one binary 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.
Settings
Label
Required. The name of 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 path
Required. The destination path of the file to be written.
Example: folder1/folder2/file
Default value: [None]
Action
The action to be performed if the file already exists. Choose from the following options in the drop-down menu:
Append: Append the incoming documents to the file.
Overwrite: Overwrite the file with the content from the incoming documents.
Example: Overwrite
Default value: Append
Enable staging
If this is enabled, the Snap first stores the input data into a temporary file in its local disk. At the end of the input data stream, the Snap starts to copy the temporary file to the target Box server. This property helps avoiding the Box server's timeout when upstream Snaps take too long to process the documents, by maintaining a steady stream of input to the server.
Default value: Not selected
Ensure that there is sufficient free disk space, at least as much as the expected size of the temporary files.
Number of retries
Specifies the maximum number of retry attempts when the Snap fails to write. If the value is larger than 0, the Snap first stores the input data in a temporary local file before writing to the target Box file. Ensure that the local drive has sufficient free disk space as large as the expected target file size.
Example: 3
Minimumvalue: 0
Default value: 0
Retry interval (seconds)
Specifies the minimum number of seconds the Snap must wait before each retry attempt.
Example: 3
Minimumvalue: 1
Defaultvalue: 1
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.
Temporary Files
During execution, data processing on Snaplex nodes occurs principally in-memory as streaming and is unencrypted. When larger datasets are processed that exceeds the available compute memory, the Snap writes Pipeline data to local storage as unencrypted to optimize the performance. These temporary files are deleted when the Snap/Pipeline execution completes. You can configure the temporary data's location in the Global properties table of the Snaplex's node properties, which can also help avoid Pipeline errors due to the unavailability of space. For more information, see Temporary Folder in Configuration Options.
Example
To write a file to Box, send a file from the File Reader Snap to the Box Write Snap where the file path is set to the destination path. If the Action property is set to Overwrite, it overwrites the existing file. If the Action property is set to Append, it appends the content to the existing file.
Snap Pack History
Click to view/expand
Release
Snap Pack Version
Date
Type
Updates
November 2024
main29029
Stable
Updated and certified against the current SnapLogic Platform release.
August 2024
main27765
Stable
Updated and certified against the current SnapLogic Platform release.
May 2024
main26341
Stable
Updated and certified against the current SnapLogic Platform release.
February 2024
436patches25102
Latest
Upgraded the Box SDK version from 2.56.0 to 4.7.0 version.
February 2024
main25112
Stable
Updated and certified against the current SnapLogic Platform release.
November 2023
main23721
Stable
Updated and certified against the current SnapLogic Platform release.
August 2023
main22460
Stable
Updated and certified against the current SnapLogic Platform release.
May 2023
main21015
Stable
Upgraded with the latest SnapLogic Platform release.
February 2023
main19844
Stable
Upgraded with the latest SnapLogic Platform release.
November 2022
main18944
Stable
Upgraded with the latest SnapLogic Platform release.
August 2022
main17386
Stable
Upgraded with the latest SnapLogic Platform release.
4.29
main15993
Stable
Enhanced the Box Write Snap with the Write empty file checkbox that allows you to write an empty file when the incoming binary document has empty data.
4.28
main14627
Stable
Upgraded with the latest SnapLogic Platform release.
4.27
main12833
Stable
Added Connectiontimeout and Readtimeout fields in Box accounts that enable the Box Snaps to read and write data within the specified connection and read timeouts.
4.25Patch
425patches10840
Latest
Modified default values for the following fields in Box Read and Box Write Snaps:
Number of Retries - Changed from 3 to 0.
Retry Interval (seconds) - Changed from 5 to 1.
For existing Pipelines which have the EnableStaging (deprecated field) checkbox selected, this Snap retries the connection once even if the Numberof Retries is zero.
4.26
main11181
Stable
Upgraded with the latest SnapLogic Platform release.
4.25 Patch
425patches10072
Latest
Modified default values of the following fields across the Snap Pack to trigger automatic retries by default, in case of connection failures or timeouts:
Number of Retries - Changed from 0 to 3
Retry Interval (seconds) - Changed from 1 to 5
4.25
main9554
Stable
Enhanced the output view of the Box Directory BrowserSnap to display the error message,Error retrieving contents of the folder with id:<Folder ID> instead of No folder exists with <Folder ID> when you enter an invalid folder ID.
4.24
424patches9242
Latest
Enhanced the Box Snap Pack with the Retry mechanism that includes the following settings:
Number of Retries: Specifies the number of attempts the snap should make to perform the selected operation in case of connection failure or timeout.
Retry Interval (seconds): Specifies the minimum number of seconds the Snap must wait before each retry attempt.
4.24
main8556
Stable
Upgraded with the latest SnapLogic Platform release.
4.23 Patch
423patches7526
Latest
Fixes the intermittent failure in access token refresh for the BoxOAuth2 account by adopting the refreshAccessTokenIfExpired() method that checks and refreshes the access token within the last minute of its expiry.
4.23
main7430
Stable
Upgraded with the latest SnapLogic Platform release.
4.22 Patch
422patches6992
Latest
Fixes the Box Write Snap connection retry issue by allowing the Snap to retry only when the given input is at least '1' in Number of retries field. This fix removes the Enable Staging field.
4.22
main6403
Stable
Upgraded with the latest SnapLogic Platform release.
4.21
snapsmrc542
Stable
Upgraded with the latest SnapLogic Platform release.
4.20 Patch
box8743
Latest
Fixes an issue with the Box Snap Pack wherein the OAuth2 token auto-refresh fails for Box accounts. The fix includes a patch released by Box to restore functionality to the "https://www.box.com/api/oauth2/token URL" of the deprecated version 1 of the Box API.
Upgraded with the latest SnapLogic Platform release.
4.19 Patch
azureactivedirectory8341
Latest
Fixes an issue with the Get Group Members Snap wherein the Snap is unable to return more than 100 users.
4.19
snaprsmrc528
Stable
Upgraded with the latest SnapLogic Platform release.
4.18
snapsmrc523
Stable
Added a new account type, Box Service Account, which enables you to create user accounts that can only be accessed programmatically through the APIs.
Added new properties, Number of retries and Retry interval (seconds), in the Box Write Snap to handle failed write attempts.
4.17
ALL7402
Latest
Pushed automatic rebuild of the latest version of each Snap Pack to SnapLogic UAT and Elastic servers.
4.17
snapsmrc515
Stable
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
Stable
Upgraded with the latest SnapLogic Platform release.
4.15
snapsmrc500
Stable
Upgraded with the latest SnapLogic Platform release.
4.14
snapsmrc490
Stable
Upgraded with the latest SnapLogic Platform release.
4.13
snapsmrc486
Stable
Upgraded with the latest SnapLogic Platform release.
4.12 Patch
box5181
Latest
Fixed the Box Write Snap that fails due to a network error.
Fixed the Box Read Snap that hangs while processing documents.
4.12
snapsmrc480
Stable
Upgraded with the latest SnapLogic Platform release.
4.11 Patch
box4306
Latest
Resolved an issue with the Box Read Snap that was unable to run for longer times due to the current token getting expired. The fix helped to proceed with new access token when the current access token expires.
4.11
snapsmrc465
Stable
Upgraded with the latest SnapLogic Platform release.
4.10
snapsmrc414
Stable
Upgraded with the latest SnapLogic Platform release.
4.9
snapsmrc405
Stable
Upgraded with the latest SnapLogic Platform release.
4.8
snapsmrc398
Stable
Upgraded with the latest SnapLogic Platform release.
4.7
snapsmrc382
Stable
Upgraded with the latest SnapLogic Platform release.
4.6
snapsmrc362
Stable
Upgraded with the latest SnapLogic Platform release.
4.5.1
box1576
Stable
Box Permissions Snap is updated to allow removing collaboration from a Box folder. For more information, see Box Permissions.
Box File Operations Snap is updated to route failures due to invalid source file/folder name to error view.
Fixed an error in Box Permissions Snap execution that caused failure in adding collaboration when the Box folder accepted a user as a collaborator.
Fixed an error in Box Read Snap that caused unexpected missing property values failure.
4.5
rcmsf231
Box Permissions Snap updated to allow for future removal of collaboration permissions.
Box Permissions Snap updated to disallow assigning a user as an owner.
4.3.1
Resolved an issue with Snaps in this Snap Pack not being proxy-aware.