Box query files

Query files in Box.

Note: This is an external action and may execute on servers running outside your data center Centralized locations used to house servers used by Nintex for remote storage, processing, or distribution of data. Nintex has a number of regional data centers available for Nintex for Office 365. For information about Nintex data centers and where your data center is located, contact your Nintex account or territory manager. region. Before implementing, consider performance and regional concerns where digital boundaries are an issue. For more information, see In-tenant and external actions.

Action settings

Do one of the following to open the Action configuration window:

  • Double-click the action.
  • Click on the action and then click Configure.

See Action configuration window for more information.

Field Description
Folder

Specify the folder to retrieve a list of Box filenames.
Filters

Specify whether or not a filter should be used.

  • Select all items
  • Select items only when the following is true: 

    • When item: Select an item property, select an operand, and enter a value.

    • Add filter rule: Click to add a filter rule.
Order by

Select the property by which to sort the files.

  • Created
  • Modified
  • Name
  • Size
Direction

Select the sort direction.

  • Ascending
  • Descending
Time zone

Specify the time zone for all time related values.

Default value: UTC.

Authorizing user

Specify an email address to receive the authorization request for the action. External email addresses can be used.

  1. When the action runs, an email with the below content is sent to the email address selected for the Authorizing user.

    2. From: notification@nintexlive.com

    Subject: Contains phrases "Nintex Live" and "Request authorization".

    Contents: Contains links to authorize or deny the operation.

  2. When the link to provide authorization is clicked the user is prompted to do the following:
    1. Log in to the external service.
    2. Allow Nintex Live to access the external service.
    3. Option to stop receiving future authorization requests for the service.

If the authorizationis not provided for one of the following reasons, the workflow is suspended.

  • The authorizing user denies the authorization request by:
    • Clicking the deny link in the email received.
    • Not allowing Nintex live to access the external service.

    The workflow is suspended with the error "The service request has been denied".

  • Authorization is not provided within 7 days after the authorization request is sent.
    • The authorizing user never clicks the authorize link in the email message.
    • The authorizing user initiates the process by clicking the link but does not complete all steps. For example, the authorizing user logs in to the external service but does not complete the step to allow Nintex Live to access the external service.

    • The workflow is suspended with the error "The service request has expired".
ID

Specify a collection or dictionary variable to store the ID of the item.
Name

Specify a collection or dictionary variable to store the item name.
Type

Specify a collection or dictionary variable to store the type of the item.
Size (in bytes)

Specify a collection or dictionary variable to store the size of the item.
Created

Specify a collection or dictionary variable to store the created item.
Modified

Specify a collection or dictionary variable to store the modified item.
Result count

Specify a numeric variable to store the result count of the item.
Results in XML

Specify a workflow variable to store the results in XML.
For more information about how to use Lookups in configuration fields, see Lookups in action configuration fields.