What is data and what is code
Adding or replacing a film is a data change on the installation: the catalog file and files in object storage. It is not a change to the system code, so it does not require a new release or developer involvement. The service administrator can change the description, thumbnail, title, number, category and order of a film in the browser.
It is worth knowing this before the first update, because it changes the approach to scheduling. A correction to the voiceover or to a frame does not wait for the producer's deployment window, but it requires discipline on the plant side, because nobody other than the administrator will check it.
Stages of a film update
Carry out the update in a fixed order, so that no step is skipped.
- Prepare the new file according to the naming pattern: language and caption variant in fixed parts.
- Check the file in a local player: picture, voiceover, captions, ending.
- Upload the file to object storage under a new name, without overwriting the previous one.
- Change the catalog in the browser: title, number, category and order.
- Open the film from an ordinary user account and check the language and the CC switch.
- Record the date, the reason and the approving person in the change log.
Steps of a film update in order
Catalog copy and reverting a change
Before every catalog edit the system saves a copy of the previous catalog file. This makes it possible to revert an incorrect title or category. The safeguard covers the catalog, meaning descriptions and order, not the film files themselves. For this reason upload a new video file under a new name, and keep the old one until it is confirmed that the change works.
Settle at the plant how long previous versions of films are kept. An outdated version, for example one with the old assembly point, should not be available to users, but the plant may want to keep it as evidence of the state on the day of training.
Pitfalls of the library view
The first pitfall is a title that is too long, which disturbs the layout of the cards in the category grid. The second is a duplicated number, which changes the order in an unintended way. The third is moving a film to another category without correcting its description, so the card contains information that does not match the new category.
The fourth pitfall concerns languages: a language without any film is disabled with the label "coming soon", so deleting the only file in a given language disables that whole language. The player fits the film in the window without scrolling the page, and the selected language is remembered in the user's browser, so after a change it is worth refreshing the view on several workstations.
Checklist
Video
Frequently asked questions
Does replacing a film require a developer?
No. It is a data change on the installation, and the administrator edits the description, thumbnail, title, number, category and order in the browser.
Can an incorrect title or category be reverted?
Yes. Before every catalog edit the system saves a copy of the previous file.
What happens when I delete the only film in a given language?
That language is disabled in the library and marked as "coming soon".
Let's go through a film update together
We will show the catalog panel and the copy made before editing on a sample film. The plant administrator will go through the whole process without a developer.
Let's talk