My Files
- Navigation
- Add a Storage Location
- Add a subfolder
- Folder permissions
- Synchronize storage location
- Folder details
Once logged in, the initial screen will be displayed, which shows the button “My Files” on the top navigation bar.
Clicking on "My Files" will bring up a page displaying existing folders and the option to 'Connect Storage' (for elevated users).
To navigate the page, use the dropdown at the bottom of the list of folders to select how many folders you want to see in the list, or the left and right arrows to navigate between pages of the list. This is only applicable if many folders are being displayed.
To setup a new storage location source (also known as a "bucket" in S3), click on "Connect Storage". Once the button has been clicked, the dialog will be displayed, requiring you to fill in the bucket configuration information.
Need a bucket? Contact NRIDS Optimization (Natural Resource ministries) or your ministry's service desk.
- Folder Name (mandatory) - your custom display name for the folder.
- Bucket (mandatory) - your storage provider's bucket identifier.
- Endpoint (mandatory) - the URL of the object storage server.
- Access key identifier / User account (mandatory) - user/account identifier or username.
- Secret access key (mandatory) - a password used to access the bucket.
- Path (optional) - an optional path prefix within a bucket (the path will be created if it doesn't already exist).
You can also re-configure an existing folder by clicking the gear-shaped action button next to an existing bucket, which will open the same dialog.
After connecting the bucket, a sync process is triggered after which, and existing sub-folders and files should be visible. > Learn more about storage syncronisation.
If you want to work with a folder structure, additional subfolders can be manually added in BCBox.
To add a subfolder, click on the folder-with-plus-sign icon and fill in the fields:
- Path - the relative path to the folder you want to add
- Folder display name - the name to display in BCBox (it does not need to match the actual folder name)
You can also add folders or paths that already exist in your object storage to BCBox. If the folder has existing files, you will need to sync the folder before the files appear in BCBox.
Folders (and individual files) can also be 'shared'.
If changes were made to the storage location externally (for example, with external tools like GeoDrive, S3 Browser, Cyberduck, etc.), syncing will be required in order to bring those changes into BCBox.
If a file or folder has any existing S3 bucket policies and ACLs, they will also be brought into BCBox.
Syncing is processed in a background 'queue' shared across all users. Completion time will depend on the number of files and server load.
Syncing can be triggered in the following ways:
-
Auto-Sync:
- Navigating into a folder in BCBox will automatically trigger a sync of files directly inside that folder, but not its subfolders. This will only be triggered if the folder was last synced more than 24 hours ago.
-
Full Manual Sync:
- The user can also manually start a full sync of all subfolders and files below that folder, by clicking the 'Sync' button in the folder view or settings dialog. A full manual sync is available 30 minutes after the last sync was requested.
-
Connecting a new storage location:
- When the user first configures their storage location in BCBox, a full sync will be automatically triggered.
Syncing a folder with many subfolders and files will slow down the sync queue for everyone, and should be done sparingly.
Currently, when new files and versions in your storage location are synced into BCBox, they will show the date that they were synced as their creation date rather than the actual date they were created in object storage.
To view folder details, click on the "i"-shaped action button next to an existing folder. The bucket details view provides you with a general properties of the folder – folder name, source storage location id and who manages its access.
