InnerWeb
Skip to main content

Updating a film in the library: implementation notes

An instructional film becomes outdated faster than expected: a gate changes, the assembly point moves, a department is renamed. The plant administrator should be able to replace a film file and correct its title and order in the catalog without a developer and without the risk of losing the previous version. Below are the stages and pitfalls of such an update.

6
film fields edited in the browser
1
catalog copy saved before every edit

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

Steps of a film update in orderChart: six steps of a film update, from preparing the file to the change log.0246stepNew fileNew file: 1 step1Local testLocal test: 2 step2UploadUpload: 3 step3Catalog changeCatalog change: 4 step4User testUser test: 5 step5Change logChange log: 6 step6
Source: Example calculation: six update steps described in the text

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