Box Integration
Overview
The Box widget is an integration that provides users with a view into a connected Box folder and its contents. Through this interface, users can interact with existing folder contents, create new folders, and upload new files.
For more information about integrations, refer to the Integrations widget article.
Considerations and caveats
Transferring files between Box and an Igloo Folder Channel
It is not possible to directly transfer files between these two file repositories. You must download the file to your computer from one and then upload it to the other.
Unified Search widget
You can configure the Unified Search widget to search Box in addition to other file repositories. For more information, refer to the Unified Search widget article.
Widget layout
Legend
Label | Name | Description |
|---|---|---|
1 | Breadcrumb trail | The Breadcrumb trail displays where you currently are relative to the configured initial folder. Click a location in this path to navigate directly to that folder. |
2 | Search Box | Enter a term to look for and then press enter to perform the search. Only the names of folders and files are searched. After completing a search, a list of matching results for content within and nested under the configured initial folder are displayed. The Search box can be turned on/off using the Show Search setting. |
3 | Add Folder | Click to add a new folder to your current location. After creating a new folder, you will have the opportunity to give it a name. If you do not give it a name at this time, you must log in to Box to change the name. |
4 | Upload File | Click to upload a new file to your current location. Use the file explorer to find the file on your computer and then click Open to begin the upload. You can select multiple files (ctrl-click / shift-click while selecting a file) to upload more than one at a time. You can also drag files into the widget to upload them. |
5 | File Window | A display of the current folder's contents. This display can look or function differently depending on how the widget is configured:
|
6 | Delete Folder | Click to delete a folder and all of its content from Box. A confirmation window will pop up to confirm this action. |
7 | Actions Menu | Click to access additional file options. Options include:
|
8 | View in Box | Click to open the file (in Box) in a new browser tab. This option may not be available depending on how Enable View in Box is configured. |
9 | Download | Click to download the file to your computer. |
10 | Delete File | Click to delete the file from Box. A confirmation window will pop up to confirm this action. |
11 | Information | Click to show a window that contains the following information about a file:
You can also perform the following actions on the file:
|
12 | Log Out | Click to sign out of the widget. |
Authentication
To access the contents of the Box widget, users must first sign in to it using their Box credentials. After entering their credentials, users must click Grant access to Box to finish signing in to the widget. If a user already has an active Box session in their browser, they will not need to enter their credentials, only click Grant access to Box. The windows for entering credentials and granting access are popups that are separate from your current browser window.
Configuration settings
General
| Setting | Description |
|---|---|
| Initial Folder ID | Enter the Box Folder ID of the folder that you want to display initially. Users can only browse and search nested files and folders under this location. By default, this value is 0 (Box's root folder). To find a folder's ID, navigate to the folder in Box and then look at the URL of that location. The Folder ID is the number that comes after folder/. In the example URL below, the Folder ID would be 126788917518.
https://app.box.com/folder/126788917518
|
Advanced
| Setting | Description |
|---|---|
| Enable View in Box | Select whether users can open a view of the file. If enabled, clicking a file name or selecting View in Box from a file's Actions menu will open the file (in Box) in a new browser tab. If disabled, clicking a file name will download the file, and no View in Box option will appear in a file's Actions menu or Information Panel. |
| Enable Auto Height | Select whether the height of the widget will expand to show all items in a folder. If enabled, the widget will expand the widget's height to show all items in a folder. If disabled, the widget will display items in a fixed height scrollable window. |
| Show search | Select whether users can search the folder and its nested locations. If enabled, users will have access to a search box for entering text queries. If disabled, this search box won't be shown in the widget. |
| Show Last Modified By | Select whether the Last Modified By column is shown. If enabled, this column will show the name of that last user who modified a file. If disabled, this column won't be shown in the widget. |
| Show Last Modified | Select whether the Last Modified column is shown. If enabled, this column will show the date and time when the file was last modified. If disabled, this column won't be shown in the widget. |
| Show File Type | Select whether the File Type column is shown. If enabled, this column will show a file's format. If disabled, this column won't be shown in the widget. |
| Show File Size | Select whether the File Size column is shown. If enabled, this column will show a file's size. If disabled, this column won't be shown in the widget. |
- 1,416 views
- 0 previews
- 13 versions
- 0 comments
- 1 follower
Labels:
- Updated By:
- Jesse Langstaff
- May 4, 2021
- Posted By:
- Matthew Seabrook
- September 4, 2017
- Versions:
- v.13
Viewed 1,416 times
0 Comments