Media Files
The Media Files page decides which media file types — cover images, samples, audio, video and so on — can be attached to the titles of your ONIXEDIT Server, and how each type behaves: whether it is authorised, whether several files of that type may be attached to one title, the captions shown to your users, the mask that names uploaded files, and an optional unique identifier.
Where to find it
- Settings menu: Media Files. Route:
/preferences/media-files. - Visible to accounts with access to Preferences.
Screen overview
- Search — filters the table on the type's name as you type.
- Cancel and Save — both stay disabled until you change something.
- Table — one row per media file type: Media File Type, Authorized (may this type be used at all), Multiple Items (may several files of this type be attached to one title), Unique ID (None, String or Integer), and a pencil button that opens the details. Pages of 15, 30 or 50 rows.
Changes made directly in the table (the two checkboxes and the Unique ID dropdown) are staged, like those made in the dialog: nothing reaches the server until you click Save.
How to authorise a media file type
- Find the type with Search.
- Tick Authorized. Tick Multiple Items as well if a title may carry several files of that type.
- Click Save. The page confirms with Changes have been successfully saved.
How to set the file name mask and captions
- Click the pencil button at the end of the row. The Edit Media File dialog opens.
- Fill in Caption EN and Caption FR — the names your users see for this type.
- Fill in File Name Mask — the pattern used to name files of this type when they are uploaded.
- Click OK to stage the change, then Save on the page.
How to require a unique identifier
- Open the type's dialog and set Unique ID Type to String or Integer. The four fields below become editable.
- Fill in Unique ID Caption EN / FR (the label of the identifier) and Alternate Message EN / FR (the message shown when the identifier is empty).
- The Unique ID XPaths table lists where the identifier is read in the ONIX record. Existing XPaths can be removed with the trash button; adding new ones is not available yet (Coming soon).
- Click OK, then Save.
Tips
- The list of types is fixed by ONIXEDIT Server: you can configure the types offered, not add or remove them.
- Cancel asks All modifications will be lost. Do you want to proceed? and reloads the saved settings.
- Saving writes every changed row; if one of them fails you get Failed to save settings. and the unsaved edits stay on the page so you can try again.
- The maximum file size per type is set on the Media Space page, not here.
Frequently asked questions
Why can't I add a new media file type?
The list of types is defined by ONIXEDIT Server. You can authorise and configure the existing types, not create or delete them.
I ticked a box but nothing changed on the server.
Edits made in the table are staged. Click Save at the top of the page to write them.
Why are the Unique ID caption fields greyed out?
Because Unique ID Type is None. Pick String or Integer to enable them.
Why can't I add an XPath?
The XPath picker is not available yet (Coming soon). Existing XPaths can still be deleted.