Storage layout in External File Storage¶

With External File Storage, Media Bridge stores one file per record, organised in folders:

<root folder>/<company>/<entity folder>/<bucket>/<file name>.<extension>

Part	Value
root folder	External Storage Root Folder on Media Bridge Setup. Empty means the root of the account.
company	The company name, without the characters that are not allowed in file names.
entity folder	`Items`, `ItemVariants` or `Employees`.
bucket	The first two characters of the record number, in upper case: the item number for items and variants, the employee number for employees. It keeps folders small in large catalogues.
file name	The record ID without the characters that are not allowed in file names, for example `Item 1000` or `Item Variant 1000,RED`.
extension	From the picture type: `jpeg`, `png`, `gif`, `webp` or `bmp`.

Example for item 1000 in company CRONUS International Ltd., with root folder mediabridge:

mediabridge/CRONUS International Ltd./Items/10/Item 1000.png

What is kept on the record¶

Each item, item variant and employee stores:

Field	Content
External File Path	The full path above.
External File Modified At	When the file was uploaded.
External File MIME Type	The picture type, for example `image/png`.

These fields are read-only. Media Bridge fills them when a picture is uploaded and clears them when it is deleted.

One company per folder. Pictures of different companies never overwrite each other, even for the same item number.
Replacing a picture of another type creates a file with another extension. The record points to the new file.
Don't rename or move files in the storage account. The record keeps the exact path, and the picture would no longer be found.
Changing the root folder only affects new uploads. Existing pictures keep their path.