Box
by Appian Corporation
Description
Enables automated server-to-server file management between Appian and Box, individual user-delegated actions, native Box Sign e-signature cycles, and structured document classification through metadata templates. Please see the Box Connected System Set Up document for more details and instructions.
[Deprecated] Provides Smart Services and custom functions to integrate Appian with Box document management. Please see the Box File Utilities guide included with the download for complete setup and usage instructions.
Features
Connected Systems: BoxConnectedSystem (Client Credentials Grant), OAuthBoxConnectedSystem, JWTBoxConnectedSystemTemplate & DeveloperTokenBoxConnectedSystem
UploadFile: Uploads an Appian document to Box or creates a new file version ListItemsInFolder: Lists files, folders, and web links inside a specific Box folder DownloadFile: Downloads a Box file and saves it as an Appian document GetCurrentUser: Returns the profile identity details of the current token bearer CreateAppUser: Creates a platform or app user within Box GetFileMetadata: Reads the metadata instance values attached to a specific file UpdateFileMetadata: Sets or updates metadata field values on a Box file DeleteFileMetadata: Removes a specific metadata template instance from a file ListMetadataTemplates: Lists available metadata templates within global or enterprise scopes GetFileDownloadUrl: Generates a temporary direct download URL for a Box file RevokeAccessToken: Revokes the active OAuth access token to end the session DeleteFile: Moves a specified file to the Box Trash CreateSignRequest: Creates and sends a new Box Sign signature request GetSignRequest: Retrieves the current status and details of a signature request ListSignRequests: Lists signature requests associated with the account GetSignedDocument: Returns temporary download URLs for completed signed files. CancelSignRequest: Cancels an active Box Sign signature request ResendSignRequest: Resends a reminder for an active signature request ListSignTemplates: Lists available Box Sign templates GetSignTemplate: Retrieves the configuration details of a specific Box Sign template DownloadSignedDocument: Downloads completed signed documents directly into an Appian folder QueryFilesByMetadata: Finds and lists files that have a specific metadata template attached
[Deprecated] Functions > createtoken() > constructboxurl() > generateboxurl()
[Deprecated] Smart Services > File Upload > File Download to Appian > File Download
Release notes
> Shifted from legacy smart services and functions to native Appian connected systems and integration objects. > Introduced native templates for OAuth 2.0, JWT (Server Auth), Client Credentials Grant (CCG), and short-lived Developer Tokens > Added support for native Box Sign workflows and metadata management > Deprecated Features: Legacy components (createtoken, box, burl, the old upload/download smart services, and the download servlet) have been deprecated and should not be used for new work.
Version history (15)
1.4.3
Upgraded commons-io library apache tika-core version for vulnerability fix
1.4.2
Upgraded Bouncy Castle Provider library
1.4.1
Upgraded jose4j library
1.4.0
Updated deprecated API usage
1.3.6
Upgraded jackson databind
1.3.5
Updates to jackson databind and jose4j libraries and added a license file.
1.3.4
Updated bouncycastle library
1.3.3
Security Updates
1.3.2
Security Updates
1.3.0
Added Function generateboxurl
1.2.0
Updated JAR with missing property files from last submission
1.2.0
1.2.0 - Updated with latest versions of dependent libraries.
1.1.0
Fixed JWT token issue where multiple tokens created at the same time, were being invalidated.
Fixed file download and upload to and from Appian, with correct file extensions and file sizes.
Fixed a Cloud Security issue.
[MIGRATED] Utilities to integrate Appian with Box
Create a JSON Web Token (JWT) It provides a custom function called createtoken that will provide the user with a JWT that can be used for up to 60 seconds as authentication with the /token API from Box.
File Upload Smart Service After obtaining a JWT, this smart service uses the access token and calls the file upload API passing in the contents of a provided Appian Document.
File Download to Appian This part of the plugin exposes a smart service to download a file from Box and store it in a provided Appian Folder.
File Download Servlet The servlet is very similar to the download smart service, however, it does not create an Appian Document, instead, it downloads the file directly to the browser for the user to view/save to their computer. For security reasons most of the parameters passed to the servlet are obfuscated. Use the "constuctboxurl" function to create a URL to access the servlet securely. Box File Upload Box File Download
1.0.10
Fixed a Cloud Security issue.
[MIGRATED] Utilities to integrate Appian with Box
Create JSON Web Token (JWT) Provides a custom function called createtoken that will provide the user with a JWT that can be used for up to 60 seconds as authentication with the /token API from Box.
File Upload Smart Service After obtaining a JWT, this smart service uses the access token and calls the file upload API passing in the contents of a provided Appian Document.
File Download to Appian This part of the plugin exposes a smart service to download a file from Box and store it in a provided Appian Folder.
File Download Servlet The servlet is very similar to the download smart service, however, does not create an Appian Document, instead it downloads the file directly to the browser for the user to view/save to their computer. For security reasons most of the parameters passed to the servlet are obfuscated. Use the "constuctboxurl" function to create a url to access the servlet securely. Box File Upload Box File Download
1.0.9
[MIGRATED] Utilities to integrate Appian with Box
Create JSON Web Token (JWT) Provides a custom function called createtoken that will provide the user with a JWT that can be used for up to 60 seconds as authentication with the /token API from Box.
File Upload Smart Service After obtaining a JWT, this smart service uses the access token and calls the file upload API passing in the contents of a provided Appian Document.
File Download to Appian This part of the plugin exposes a smart service to download a file from Box and store it in a provided Appian Folder.
File Download Servlet The servlet is very similar to the download smart service, however, does not create an Appian Document, instead it downloads the file directly to the browser for the user to view/save to their computer. For security reasons most of the parameters passed to the servlet are obfuscated. Use the "constuctboxurl" function to create a url to access the servlet securely. Box File Upload Box File Download