FOLIO Upgrade - good to know

Zentrale visuelle und textliche Anpassungen

Beim Bauen der Frontend Module mit Stripes gibt es Möglichkeiten das Erscheinungsbild und zentrale Anzeigetexte bedingt anzupassen. Dafür muss die Datei stripes.config.js vor dem Bau modifiziert werden.

Branding

Hier ḱönnen Logo, Favicon sowie Farben der Navigationsleiste und des Anmeldeschirms angepasst werden:

https://github.com/folio-org/stripes/blob/master/doc/branding.md

Anpassen von zentralen Texten

Folgende Texte können derzeit geändert werden:

welcomeMessage -- Überschreibt die Standardnachricht "Welcome, the Future Of Libraries Is OPEN!"
platformName -- Der Text rechts des Bienen-Logos auf der Startseite als auch im Seitentitel.

aboutInstallVersion -- wird in den Einstellungen unter Installationsdeteails angezeigt

aboutInstallDate -- wird in den Einstellungen unter Installationsdeteails angezeigt

Beispiel:

module.exports = {
  okapi: { 'url':'http://localhost:9130', 'tenant':'diku' },
  config: {
    logCategories: 'core,path,action,xhr',
    logPrefix: '--',
    maxUnpagedResourceCount: 2000,
    welcomeMessage: 'Welcome to FOLIO Test!',
    platformName: 'FOLIO - Test',
    showPerms: false
  },

Quelle: https://folio-project.slack.com/archives/C9BBWRCNB/p1670600916077559?thread_ts=1670597459.780619&cid=C9BBWRCNB

Hinzufügen von Release-Informationen

aboutInstallVersion wird bei den Mainzer Testsystemen aktuell verwendet, um bei der Installation/Upgrade die installierte FOLIO-Version zu hinterlegen.

<Release-Name> - <Github-Tag von Platform-Complete>

Lokalangepasste Referenzdaten sichern und wieder einspielen

Bei der Installation / Beim Upgrade sollten Referenzdaten der neuen Modul-Versionen miteingespielt werden, da diese neue Referenzdaten enthalten können, die für die Funktion des Moduls notwendig sind. Allerdings können dadurch auch lokalangepasste Referenzdaten wie Übersetzungen oder gar andere Einstellungen überschrieben werden. Folgende Tabelle soll einen Überblick geben, welche eine genaue Beachtung erfordern. Diese Liste sollte fortgeführt und gepflegt werden.

Je Modul sollte ein Bug-Jira angelegt werden. Bei jedem Flowerrelease sollte es überprüft und im Jira ergänzt werden, dass das Problem weiterhin besteht und relevant ist, indem sowohl unter "Affected Version(s)" die weitere Modulversion eingetragen wird, also auch in der Bugbeschreibung und/oder als extra Kommentar darauf hingewiesen wird. Bitte Jiras hier verlinken!

Modul	Referenzdaten	API(s)	Beschreibung/Anleitung
mod-inventory-storage	Reference-data (alle)	mod-inventory-storage_apis	Projekt der deutschen Übersetzung der Inventory-Referenzdaten Nötige Referenzdaten für das CBS2FOLIO Mapping der Hebis-Teilnehmerbibliotheken https://github.com/folio-org/mod-inventory-storage/commit/db04967f5f60bf5b17f35eb1ff81b49b61e5abc1 "Disable updating reference/sample data on upgrade." Gefixt in Kiwi GA. MODINVSTOR-443 "Move locations and location-units from reference data to sample data" Gefixt in Nolana GA. MODINVSTOR-1015 "LCNAF translation overwritten on upgrade to 25.0.3". Gefixt in Nolana Hot Fix 2.
mod-circulation-storage	staff-slips	staff-slips_api	Dienstzettel werden bei jedem Update überschrieben und müssen gesondert gesichert und wieder eingespielt werden.*
mod-circulation-storage	circulation-rules-storage	circulation_rules_storage_api	Ausleihregeln werden bei jedem Update überschrieben und müssen gesondert gesichert und wieder eingespielt werden.*
...	...	...	...

* Axel Dörrer schreibt hierfür Tickets. Muss noch prüfen, für welche Version das noch gilt (MG oder Nolana)