Box is a cloud storage service provided by Box Inc. and now offers “Box Sign” as a new Box service. This article describes Questetra’s automated process that works with Box Sign.

1. About Box Sign

Box Sign is a service that adds digital signatures to files stored in Box. A request email is sent to the recipient by specifying the file to be signed and the email address of the person whose signature is to be requested. The recipient of the email accesses the file on Box and signs it. When all signatories have signed the file, a PDF file showing the signed file and the proof of the signature will be created in the specified folder in Box.

Box Documentation: Introducing Box Sign

Box Sign Activation

Box Sign is a service that is available to all users with Box accounts, but is disabled by default; it requires prior arrangements such as Box Sign functionality being enabled by a user with an administrator account on the Box platform and permissions being granted to the user or group.
Also, the Questetra automated process described in this article will not work with the individual service user accounts (Individual, Personal Pro, Business Starter).

Box Documentation: Enabling Box Sign

2. Questetra’s Automated Processes

Questetra has added a built-in automated process to perform the above Box Sign signature request. (Available in Ver. 14.1, Advanced Edition and above)

By using this newly added automatic process, [Box Sign: Create Sign Request], Box will automatically send a signature request e-mail after specifying files and signatories in the Questetra application.

Box Sign: Create Sign Request

Box Sign: Create Sign Request Settings Screen

Prepare the information required to send a request in Data Items and specify the input values in the respective configuration fields.

  • The Box registered email address of the authenticated user in [C1: OAuth2 Setting] will be the sender of the request email.
  • If the value of the Data Item specified in [C4: Email Addresses of the signers] is empty or exceeds 35, it will result in an error
  • If a password is used (a String-type Data Item is specified in [C5: Password for each signer]) and the number of values does not match the number of signer email addresses (e.g. it is empty), it will result in an error
  • If the target file is watermarked, it will result in an error (as of 2022-10-28)
  • The signing order is not configurable
  • An expiration date for the request cannot be set
  • A Box template cannot be used

3. Box and Questetra Integration Settings

Configure authentication settings for integration with Box.
For specific instructions, please refer to the article Using Box to Send Files to People Outside the Company.

4. Sample App

When a file is registered in the Human Task ‘Specify File/Signer’, the file will be uploaded to the specified folder in Box. An email requesting a signature for the uploaded file will be sent to the email address registered at the ‘Specify File/Signer’ Step. The recipient of the email will access the file from the incoming email and sign it.

Workflow App Settings

Data Items

Data Item NameData TypeField NameRequiredSpecify File/Signer stepDescription
TitleEditableProcess title
FileFile Typeq_fileEditableRegister files to be uploaded/signed
Folder IDString-type (single line)q_folder_idNo displaySpecify the folder where the file will be uploaded / Box folder ID where the PDF file for signature will be saved (use default value) (*1)
File IDString-type (single line)q_file_idNo displayThe ID of the target file in the Box is saved (*2)
Signatory AddressString-type (multiple lines)q_addressEditableEnter the email address to which the request email will be sent
When entering multiple entries, a new line is inserted for each entry (*3)
PasswordString-type (multiple lines)q_passwordEditableEnter the password required when the recipient signs the request (*4)
If it does not match the number of email addresses, an error will occur (*3)
Email SubjectString-type (single line)q_subjectEditableThis will be the subject line of the request email
If no input is provided, the Box defaults will be used
Email BodyString-type (multiple lines)q_bodyEditableThis will be the body of the request email
If no input is provided, the Box defaults will be used
  • (*1) To separate the folder where the file is uploaded and the folder where the PDF file for signature is saved, please add a Data Item to separate the two folders
  • (*2) The ID is obtained when the file is uploaded and the value is automatically entered. If you wish to manually enter the ID of a file that has already been uploaded to the Box, use [Exclusive Gateway] or other settings to bypass the file uploading process
  • (*3) If specific signers are specified each time, use [Initial Value] and set its permission to [Only display] or [No display]
  • (*4) It is assumed that the signers know the password in advance

‘File Upload’ Step

Item NameRequiredDescription
C1: OAuth2 Settings*Specify OAuth2 settings to be used for connection to Box. The OAuth2 setting to be specified requires a token to be obtained in advance (see “Box and Questetra Integration Settings”)
C2: File type data item whose attached files will be uploaded *Specify the Data Item containing the file to be uploaded, in this case “File”
C3: Folder ID that files will be uploaded (Root folder if blank)Specify the ID of the folder where the uploaded file will be saved
In this case, specify “#{#q_folder_id}”, which is the field name of the Data Item “Folder ID”.
C4: String type data item that will save uploaded file idsSpecify the Data Item to which the ID of the uploaded file is to be saved
C5: String type data item that will save uploaded file urlsSpecify the Data Item to which the URL of the uploaded file will be saved. Not used in this case.

‘Request Signature’ Step

Item NameRequiredDescription
C1: OAuth2 SettingsSpecify OAuth2 settings to be used for connection to Box. The OAuth2 settings you specify must have a token obtained in advance (see “Box and Questetra Integration Settings”).
C2: Source File ID to create a signing document fromSpecify the Data Item “File ID” to which the ID of the uploaded file will be saved.
C3: Folder ID to save the signing document (Root cannot be used)Specify the ID of the Box folder where the signed PDF file and certificate PDF will be stored
This time, specify the Data Item “Folder ID”
C4: Email Addresses of the signers (Write one per line)Specify the Data Item “Signer Address” in which the signer’s email address is entered
C5: Password for each signer (please start a new line for each case)Specify the Data Item “Password” in which the password is to be entered
If you do not want to use the password, specify “blank” at the top of the drop-down and delete the “Password” Data Item
C6: Email Subject (Default subject if blank)Specify “#{#q_subject}” that refers to the data item “Email Subject” in which the string that will become the subject of the email to be sent is entered
C7: Message to include in the email (Default message if blank)Specifies “#{#q_body}” that refers to the Data Item “Email Body” in which the string that will become the body of the email to be sent is entered

Workflow App Operation

Enter the information required for the first Human Task “Specify File/Signer”. If the signer and folder are the same every time, you can set the address and folder ID in [Initial Value] so that the input can be completed by simply selecting the file.

In the following automatic step “File Upload,” the file is uploaded to the folder in the Box specified in the “Folder ID” Data Item, and the file ID in Box is obtained and saved in the “File ID” Data Item.

In the “Request Signature” step, the values of the specified Data Items are passed to Box, and Box will send a signature request email based on this information. The sender’s information will be the information registered in Box by the User who has set up OAuth2 authentication.

The sample Apps introduced here are simple enough to check the operation of Box Sign, but Questetra provides many other automated processes that work with Box, so please challenge yourself to develop more convenient workflow Apps that use a combination of these processes.

Reference:
Utilising Box From Your Workflow
Process Start Triggered by a File Upload to Box

%d bloggers like this: