Changelog

Notes An den ContentRatings bei Groupings (Show und Season), Items (Episode, Section, Extra und EventLivestream) sowie PermanentLivestreams kann nun das Feld "descriptorIds" übergeben werden.

Notes Der Sophora Metadata Supplier unterstützt nun Dry-Run-Modi, mit denen das Zuliefern an den ARD Core, das Persistieren von Used Sources und Mapped Resources sowie das Benachrichtigen der FeedbackHandler (z.B. zum Erzeugen der Haftnotizen an den Sophora-Dokumenten) einzeln abgeschaltet werden kann. Um den jeweiligen Modus bestimmen zu können, muss im Mapping-Projekt das Interface IModeSetter implementiert bzw. der Aufruf an der REST-Schnittstelle um den gewünschten Mode-Parameter erweitert werden.

FeedbackHandler können zudem selbst entscheiden, ob/wie sie den verwendeten Modus den Nutzern anzeigen. Standardmäßig wird vor die Meldungen in den Haftnotizen der Prefix "[Dry-Run]" gesetzt, wenn die Inhalte nicht zum ARD Core gesendet werden sollten (Message-Key: "sms.stickynote.mode.dryrun").

Weitere Informationen zum Dry-Run befinden sich in der Dokumentation.

Notes IPrioritySetter können nun neben Priority.HIGH und Priority.NORMAL auch eine Priority.LOW zurück geben, um Mapping-Aufträge niedrig zu priorisieren.

Monitoring:
Die bisherigen Metriken der SupplyJob-Queue wurden beibehalten und spiegeln weiterhin den Gesamtzustand der Queue wieder. Analog zu den Metriken für die "HIGH"- und "NORMAL"-Prioritäten sind Metriken für die neue "LOW"-Priorität hinzugekommen (<priority> steht für "high", "normal" und (neu) "low"):
- metadatasupplier.supplyjob.<priority>.queue.size
- metadatasupplier.supplyjob.<priority>.queued
- metadatasupplier.supplyjob.<priority>.executed

Notes In der 'application.yml' muss nun der Name des Zulieferers von Inhalten an die ARD Mediathek/Audiothek angegeben werden, zum Beispiel "ardmedialibrary.supplier.name: WDR". Falls dieser Parameter nicht gesetzt ist, lässt sich der Sophora-Metadata-Supplier nicht starten!

Notes SubtitleType verfügt nun über die Werte DEFAULT, SIMPLE_LANGUAGE, CLOSED_CAPTIONS und FORCED

Notes GeoAvailability verfügt nun über die Werte DE, DACH, EU und GLOBAL.

Notes Das Enum 'com.subshell.sophora.metadatasupplier.sophora.commons.image.AspectRatio' enthält nun nicht mehr den Wert ASPECT_RATIO_19X4, da die ARD Mediathek/Audiothek das Seitenverhältnis 19:4 nicht mehr unterstützt. Mappings, die auf diesen Wert zugreifen, müssen entsprechend angepasst werden.

Notes Der Endpunkt /actuator/jolokia ist wieder verfügbar

Notes Das SMS 5.x verwendet nun Sophora-Core 5.17.0, Spring Data Sophora 5.8.6 und Spring Boot Sophora Commons 5.3.4.
Das SMS 4.x verwendet nun Sophora-Core 4.36.6, Spring Data Sophora 4.11.6 und Spring Boot Sophora Commons 4.3.25.

Notes Es kann per Konfiguration in der application.yml für alle zulieferbaren Core API Entitäten das importOrigin-Feld angegeben werden.
Bitte beachten: Im Standardfall werden sämtliche Entitäten ohne importOrigin-Feld zugeliefert. Eine explizite Zulieferung des Feldes darf nur nach Absprache mit der ARD Mediathek/Audiothek erfolgen!

Notes Das Skript "Trigger for Metadata Supplier" ("Zur ARD Mediathek/Audiothek senden") nutzt nun den HTTP-Client aus dem IClientScriptContext statt ISophoraClient.getDataFromUrl(...), um den Sophora Metadata Supplier anzusprechen. D.h. der Aufruf der URL zur Rest-Schnittstelle des SMS geht nicht mehr durch den Sophora-Server durch und daher muss sichergestellt sein, dass die URL zur Rest-Schnittstelle des SMS vom DeskClient aus erreichbar ist (Eintrag "sophora.metadata-supplier.url" im Konfigurationsdokument im Adminbereich des DeskClients).

Notes Spring-Boot 3.4.5 wird nun eingebunden

Notes Das Docker-Image in 5.x und 6.x bindet nun Java 21 statt Java 17 ein.
SMS Version 5.x setzt noch Java 17 voraus; ab SMS Version 6.x wird Java 21 vorausgesetzt!

Notes Im com.subshell.sophora.metadatasupplier.sophora.commons.image.ImageMapper können die Methoden mapImages(IImageDataProvider imageDataProvider) und mapImagesToAspectRatioMap(IImageDataProvider imageDataProvider) nun zusätzlich mit IMappingContext als Parameter aufgerufen werden. Dieser wird für neue Feedback-Messages benötigt, welche angezeigt werden, wenn bei der Zulieferung ein Bild auf die Mindestgröße hochskaliert werden musste. Die Message-Codes lauten "sms.sophora.image.minimumSizeRequirementsNotSatisfied.height" und "sms.sophora.image.minimumSizeRequirementsNotSatisfied.width" und können auch aus der Konstanten-Klasse com.subshell.sophora.metadatasupplier.sophora.commons.feedback.MessageCodeConstants des neuen Projektes "metadata-supplier-sophora-commons-api" entnommen werden.

Notes Ab SMS 5.7.3 wird nun Tomcat 10.1.39 bzw. ab SMS 4.32.3 wird nun Tomcat 9.0.102 eingebunden

Notes Abhängigkeiten wurden aktualisiert.

Notes Die Implementation der Methode com.subshell.sophora.metadatasupplier.sophora.commons.image.IImageDataProvider.getBinaryData() wirft bei gesperrten Seitenverhältnis-Bildvarianten standardmäßig keine Exception mehr. Stattdessen werden die Bildvarianten ignoriert, sodass der Mappingvorgang und in Folge auch die Zulieferung an die ARD Mediathek/Audiothek weiter durchgeführt werden können.

Notes Der ImageVariantsProvider verfügt nun über die neuen Methoden 'setImageSizeRequirementsForAspectRatio(IAspectRatio aspectRatio, ImageSizeRequirements imageSizeRequirements)' und 'getImageSizeRequirementsForAspectRatio(IAspectRatio aspectRatio)' für die Angabe einer von der ARD Mediathek/Audiothek gewünschten Bildgröße und einer Mindestgröße (entweder über die Höhe oder über die Breite)

Beispiel-Aufruf für eine gewünschte Breite von 3840px, aber mindestens 1920px bei 16:9-Bildvarianten:
'imageVariantsProvider.setImageSizeRequirementsForAspectRatio(ASPECT_RATIO_16X9, ImageSizeRequirements.createWithWidth(3840, 1920));'

Notes Wenn beim Start der Anwendung eine der Dateien im data-Verzeichnis ("lastHandledEventDate.txt", "mappedResources.json", "usages.json") invalides Datenformat enthält, wird der Start abgebrochen.
Das Datum des zuletzt behandelten Sophora-Events wird nun zusätzlich ins Logfile geschrieben, so dass diese Information auch von dort abgelesen werden kann.
Die Dateien "mappedResources.json" und "usages.json" werden nun zunächst als tmp-Datei im data-Verzeichnis erzeugt und erst anschließend ersetzt, um die Originaldateien zu erhalten, falls die Anwendung während des Schreibens der Dateien beendet wird. Dadurch wird mehr Festplattenspeicherplatz benötigt.

Notes Im "Catalog"-Enum (für ExternalContentIds von Episoden, EventLivestreams, Extras, PermanentLivestreams, Seasons, Sections und Shows) wurde der Wert OTHER entfernt und APPLE_TV hinzugefügt.

Im "PersonCatalog"-Enum (für ExternalPersonIds in PersonCredits von Episoden, EventLivestreams, Extras, Seasons, Sections und Shows) wurde der Wert OTHER entfernt.

Notes Es wird nun Spring 6.1.6 und Spring Boot 3.2.5 genutzt.

Notes Mapping-Projekte können nun bis zu eine ISourceFilter-Komponente bereitstellen, die entscheidet, ob ein Mapping-Auftrag überhaupt vom MetadataSupplier ausgeführt werden soll. Im Gegensatz zu der accept()-Methode der IResourceMapper-Implementationen wird mit dem ISourceFilter auch verhindert, dass nachfolgende Mappings (aufgrund des "Used Sources"-Mechanismus) ausgelöst werden. Wenn der SourceFilter ein Quellobjekt (Source) ablehnt, wird ein Feedback mit MessageCode "sms.source.denied" zurückgeliefert, ansonsten wird die Source wie gehabt gemappt und in der ARD Mediathek/Audiothek aktualisiert.

Die jeweilige Ausführungsdauer für den SourceFilter wird ebenfalls erfasst und sowohl im Feedback als auch über Prometheus-Metriken bereitgestellt.

Für abgelehnte Mapping-Aufträge wird standardmäßig keine Haftnotiz an Sophora-Dokumenten hinterlegt. Dies lässt sich jedoch in der application.yml mit dem Eintrag metadata-supplier-sophora.create-sticky-notes-for-denied-sources: true/false konfigurieren.

Notes AudioBinary und VideoBinary verfügen nun über das neue Feld "allowDeprecatedTermIds".

Notes Create-Requests werden nun ohne Slash am Ende der URL aufgerufen, also z.B. ".../delivery-api/items/event-livestreams" statt ".../delivery-api/items/event-livestreams/"

Notes Einige Validierungsmeldungen wurden um die Platzhalter '${resourceFieldName}', '${coreId}' und '${resourceTypeName}' angereichert, um aussagekräftigere Texte zu erhalten. Zum Beispiel "Das Feld '${resourceFieldName}' der Ressource '${coreId}' vom Typ '${resourceTypeName}' muss gesetzt werden, wenn ContentEventType ${type} ist." statt einfach nur "Muss gesetzt werden, wenn ContentEventType ${type} ist."

Notes ContentEvent verfügt über die neuen Felder timeInContent (String), progressbarIconId (CoreId) und participantIconId (CoreId)

Notes Der Zustandsübergang von Sophora-Dokumenten von "publishAt" zu "prePublished" wird nun als "prePublish" statt "publishAtCanceled" behandelt, da in dem Fall die Veröffentlichung nicht abgebrochen, sondern angestoßen wird (auf den Zustand "prePublished" folgt "published")

Notes Der initiale SourceDescriptor und die Parameter des jeweiligen SMS-Aufrufs werden nun bei jeder zugehörigen Logmeldung mit geloggt. Technisch werden dazu am MDC (Mapped Diagnostic Context) intern die Werte "trigger_source" und "trigger_parameters" gesetzt.

Notes Der Enum com.subshell.sophora.metadatasupplier.sophora.commons.image.AspectRatio stellt nun auch einen Wert ASPECT_RATIO_19X4 bereit

Notes Episoden, Sections, Extras und EventLivestreams verfügen nun über das neue Feld "nonUniqueMatchingBrid".

Notes Es gibt nun Metriken für das Alter der Sophora-Events bzw. Supply-Jobs in der Event- bzw. Job-Queue (/actuator/metrics/metadatasupplier.event.ages und /actuator/metrics/metadatasupplier.supplyjob.ages).

Außerdem werden Metriken für die Ausführungsdauern der accept()- und mapToResources()-Methoden der einzelnen IResourceMapper sowie die Dauer zum Senden der erzeugten Resources an den ARD Core bereitgestellt (/actuator/metrics/metadatasupplier.mapper.accept, /actuator/metrics/metadatasupplier.mapper.map, /actuator/metrics/metadatasupplier.ardcore.calls).

Die Dauer zum Lesen/Schreiben der Used-Sources- und Mapped-Resources-Dateien steht nun ebenfalls als Metrik bereit (/actuator/metrics/metadatasupplier.persistence).

Alle diese Daten sind auch unter /actuator/prometheus abrufbar.

Notes Die Ausführungsdauer der SMS-Aufrufe wird nun geloggt und auch im Feedback zurück geliefert ("diagnostic"). Dabei werden die Gesamtdauer des SMS-Aufrufs und Teildauern für einzelne Schritte erfasst (dazu gehören das Ermitteln des richtigen Mappers, das Mapping selbst und das Senden an die ARD Mediathek/Audiothek). Im eigenen Mapping-Code können über die neue Methode IMappingContext .addDurationOf(...) eigene Zeiten erfasst und zum Feedback hinzugefügt werden. Bei Anbindung an Sophora wird zusätzlich das Alter der einzelnen Einträge in der Event- und SupplyJob-Queue ermittelt und geloggt.

Notes Wenn bei einem (erneuten) Mappingdurchlauf für ein Sophora-Dokument keine gemappten Ressourcen entstehen, bleiben zuvor gesetzte SMS-Haftnotizen an dem Dokument erhalten, statt sie zu entfernen.

Notes Es gibt einen neuen Message-Key "sms.stickynote.unpublish.success" mit dem Standardtext "Die zugehörigen Inhalte wurden am ${date} um ${time} Uhr erfolgreich in der ARD Mediathek/Audiothek depubliziert (${resourceDescriptors})". Der Text erscheint (zusätzlich) in der Haftnotiz am Sophora-Dokument, wenn mindestens eine gemappte Ressource erfolgreich in der ARD Mediathek/Audiothek depubliziert wurde.

Die Formulierung der Feedbacktexte mit den Message-Keys "sms.unpublish.error", "sms.unpublish.success", "sms.unpublish.unable", "sms.unpublish.unnecessary" wurden entsprechend angepasst, so dass die Inhalte nicht "aus der Mediathek entfernt", sondern "in der Mediathek depubliziert" wurden.

Notes Episodes, EventLivestreams, Extras und Sections verfügen nun über das Feld publisherId.
Sections verfügen zusätzlich über das neue Feld timestampInParent.

Notes EventLivestreams verfügen nun über das neue Feld "hasLiveContentEvents".

Notes Während der Synchronisierung eingehende Sophora-Events werden nun nachträglich abgearbeitet

Notes VideoBinary.isHasEmbeddedSubtitles() wurde entfernt. Es muss IVideoBinary.hasEmbeddedSubtitles() genutzt werden.
Der vollständige Fix ist erst ab Version 3.5.4 bzw. 4.5.4 enthalten.

Notes Behebt das Problem, dass URLs am Ende von einzelnen Aufzählungspunkten in den Feedback-Haftnotizen im DeskClient nicht (richtig) als Link erkannt werden

Notes Behebt das Problem, dass die mitgelieferten Übersetzungen zu Fehlermeldungen der Core API oder eigene Übersetzungen in Mapping-Plugins nicht gefunden werden.

Notes Mit diesem Bugfix wird der Onlinestatus in der Kachel im Dashboard repariert. Damit die Daten in den Details auf der rechten Seite im Dashboard angezeigt werden, muss das Admin Dashboard in Version >= 3.1.5, 4.2.4, 5.0.0 verwendet werden.

Notes Proxy-Einstellungen zur ARD Mediathek/Audiothek können nicht mehr in der application.yml über "ardmedialibrary.credentials.proxyUrl" und "ardmedialibrary.credentials.proxyPort" gesetzt werden. Stattdessen muss der Proxy über normale Systemproperties konfiguriert werden, z.B. in der Datei metadata-supplier-application-executable.conf.

Notes Die Standard-URL zur Swagger-UI lautet nun http://localhost:8080/swagger-ui.html (statt http://localhost:8080/swagger-ui/index.html). Siehe Dokumentation bzgl. REST-API, Monitoring und Konfiguration des Webservers.

Notes Die ausführbare metadata-supplier-application-<version>.jar wurde in metadata-supplier-application-<version>-executable.jar umbenannt. Start-/Stop-Skripte, die diese jar ausführen, müssen dementsprechend angepasst werden. Auch die metadata-supplier-application.conf muss in metadata-supplier-application-executable.conf umbenannt werden, sofern vorhanden. Bei der metadata-supplier-application-<version>.jar handelt es sich jetzt stattdessen nur um das einfache Artefakt der metadata-supplier-application, welche für die Plugin-Entwicklung in einem Launcher-Projekt genutzt werden kann.

Notes Mapping-Plugin-Projekte können für einfacheres und konsistentes Dependency Management nun die "pom.xml" von "metadatasupplier-parent" importieren

Notes Die verschiedenen Services der ARD Mediathek/Audiothek (wie Image-Service, Asset-API und Player-API) werden mittlerweile unter einer Delivery-API-URL zusammengefasst und bereitgestellt. Daher lauten die Standard-URL-Konfigurationen im SMS für Image-Service, Asset-API und Player-API nun jeweils https://deliver-test.ard.de/delivery-api statt https://deliver-test.ard.de/image-service, https://deliver-test.ard.de/asset-api und https://deliver-test.ard.de/player-api.
Bei bestehenden SMS-Installationen, die die ARD Mediathek/Audiothek Service-URLs in der application.yml eingetragen haben, müssen diese URLs für jeden der drei Services entsprechend angepasst werden: URL für das Testsystem der ARD Mediathek/Audiothek: https://deliver-test.ard.de/delivery-api bzw. URL für das Live-System der ARD Mediathek/Audiothek: https://deliver.ard.de/delivery-api

Notes Der Builder für NormDbLocations nimmt die Id nun als CoreId-Objekt und als String entgegen. Wenn die Id als String übergeben wird, wird sie ins CoreId-Format umgewandelt, wenn nötig. Z.B. aus dem String "vokabel-1572" wird "urn:ard:location:e4f12d7dba8c438f" und aus dem String "1572" wird ebenfalls "urn:ard:location:e4f12d7dba8c438f". Die Angabe von "urn:ard:location:e4f12d7dba8c438f" bleibt unverändert. Mappings sollten dennoch direkt ein CoreId-Objekt statt einen String übergeben.

Notes Die Hilfsmethoden der ArdNormDbUtil- und SdsArdNormDbUtil-Klassen können jetzt auch die Vokabel-IDs aus Genre- und Subgenre-Auswahlwerten auslesen, die der neuen Struktur folgen, welche mit dem ARD Metadatenpaket 2 eingeführt wurde. Genres und Subgenres, die noch der alten Struktur folgen, funktionieren weiterhin mit den Hilfsmethoden.

Notes Statt ArtworkType COVER_ARTWORK und STAGE_ARTWORK gibt es nun ArtworkType COVER und BACKDROP.

Notes Der Metadata Supplier gibt nun die Version von spring-data-sophora-commons vor, so dass Mapper-Projekte diese einfach verwenden können.

Notes Diverse Abhängigkeiten wurden aktualisiert

Notes Publications können auch angelegt werden, ohne explizit Images hinzufügen zu müssen. In dem Fall werden in der ARD Mediathek/Audiothek die Bilder aus dem referenzierten Item verwendet.

Notes Zum Auslesen der aktuellen Anzahl der aus Sophora getriggerten und noch abzuarbeitenden Mapping-Aufträge wurde die neue Metrik "metadatasupplier.supplyjob.queue.size" hinzugefügt. Die Anzahl der insgesamt aus Sophora getriggerten bzw. abgearbeiteten Mapping-Aufträge seit SMS-Start kann nun über die neuen Metriken "metadatasupplier.supplyjob.queued" bzw. "metadatasupplier.supplyjob.executed" abgefragt werden. Die Gesamtanzahl der Mapping-Aufträge, deren Abarbeitung aufgrund unvorhergesehener Fehler abgebrochen ist, kann über die neue Metrik "metadatasupplier.supplyjob.executionerrors" ausgelesen werden.

Notes Die Operationen "unpublish" bzw. "republish" an der ARD Core API werden nur noch für veröffentlichbare Entitäten ausgeführt, bei denen der Sichtbarkeitszustand geändert werden muss.

Notes Bei Publications kann jetzt auch das Feld "originalClipExternalId" gesetzt werden.

Notes Das "metadata-supplier-plugin-example" enthält jetzt zusätzlich einen Beispiel-Mapper, der Spring-Data-Sophora nutzt. Außerdem wir ein "jar-with-dependencies" erstellt. GroupId: "com.subshell.sophora.metadatasupplier", ArtifactId: "metadata-supplier-plugin-example" bzw. "metadata-supplier-plugin-example-launcher".

Notes Es gibt nun keine "Erfolgreich an die ARD Mediathek/Audiothek gesendet"-Feedbackmeldung mehr für Objekte vom Typ Publishable, da über diese keine Resourcen in der Mediathek angelegt oder inhaltlich aktualisiert werden können. Die Feedbackmeldungen "Erfolgreich in der ARD Mediathek/Audiothek veröffentlicht" bzw. "Erfolgreich aus der ARD Mediathek/Audiothek entfernt" erscheinen weiterhin.

Es gibt neue, zusätzliche Feedbackmeldungen, wenn Resourcen in der ARD Mediathek/Audiothek veröffentlicht/depubliziert werden sollten, die bereits veröffentlicht/depubliziert sind: "Ein (erneutes) Veröffentlichen in der ARD Mediathek/Audiothek war nicht notwendig" und "Ein (erneutes) Entfernen aus der ARD Mediathek/Audiothek war nicht notwendig".

Es gibt neue, zusätzliche Feedbackmeldungen, wenn Resourcen in der ARD Mediathek/Audiothek veröffentlicht/depubliziert werden sollten, die dort gar nicht existieren: "Ein Veröffentlichen in der ARD Mediathek/Audiothek war nicht möglich" bzw. "Ein Entfernen aus der ARD Mediathek/Audiothek war nicht möglich".

Notes Alle Resourcen werden nur noch auf Trace-Level geloggt.

Notes Wenn die <my-mapping>-jar-with-dependencies.jar eine META-INF/MANIFEST.MF mit Eintrag für "Implementation-Version" hat, wird die Versionsnummer der Mapper-Klassen geloggt.

Notes Der JavaDoc an den Interfaces für Resourcen (IShow, ISeason, IEpisode, usw.) wurde aktualisiert.

Notes Der ImageMapper bietet nun zusätzlich die Methode mapImagesToAspectRatioMap(IImageDataProvider imageDataProvider) an, welche Map<IAspectRatio, IImage> zurück liefert.

Notes Beim Auftreten eines LinkageError zwischen SMS und Mapping erscheint dieser nun in der Logdatei und das SMS wird mit Exitcode 192 beendet.

Notes Über den VM-Parameter -Dspring.profiles.active=json-logs (oder über die Angabe in der application.yml) kann strukturiertes (Json-)Logging aktiviert werden.
Vorsicht: Fügt eine Abhängigkeit zu "net.logstash.logback" "logstash-logback-encoder" hinzu, die in Mapping-Projekten ggf. zu Abhängigkeitskonflikten mit Jackson führen kann.

Notes In "metadata-supplier-sophora-commons" gibt es nun einen com.subshell.sophora.metadatasupplier.sophora.commons.Iso8601Converter

Notes In com.subshell.sophora.metadatasupplier.sophora.commons.ArdNormDbUtil sind nun entsprechende Methoden enthalten

Notes Die Enums aus com.subshell.ardcore.model.types haben nun alle eine valuesOf(Collection<String> names)-Methode

Notes Das bestehende Verhalten bei der Erzeugung von ImageCollections wurde durch weitere Unittests abgesichert

Notes Manche deutsche Übersetzungen der englischsprachigen Validierungsmeldungen von der ARD Mediathek/Audiothek wurden verbessert

Notes Bei Bildern sind nun folgende Seitenverhältnisse möglich: 2:3, 3:4, 16:7, 16:9, 32:9, 64:9

Notes Exceptions in IResourceMapper.accept(...) werden nun abgefangen und so behandelt, als ob es keinen Mapper für die Source gäbe. Eine entsprechende Feedbackmeldung wird zurückgegeben.

Notes ACHTUNG: Inkompatible Model-API-Änderung! Die Felder genreCategoryId, subgenreCategoryIds und thematicCategoryIds an Shows, Sections, Seasons usw. sind nun vom Typ CoreId statt String! Die Mapper-Projekte/-Klassen müssen dementsprechend angepasst werden, bevor diese Metadata Supplier Version produktiv eingesetzt wird, ansonsten funktioniert das Mapping nicht!
Dazu `String genreCategoryCoreId = "urn:ard:category-genre:myExternalIdHash";` ändern zu `CoreId genreCategoryCoreId = CoreId.create("urn:ard:category-genre:myExternalIdHash");` oder `CoreId genreCategoryCoreId = CoreId.create(Type.GENRE_CATEGORY.getCoreIdPrefix(), "myExternalIdHash");` bzw. `String genreCategoryId = CoreId.create(Type.GENRE_CATEGORY, "myExternalId").getId();` ändern zu `CoreId genreCategoryCoreId = CoreId.create(Type.GENRE_CATEGORY, "myExternalId");`.
Zum Lesen von List<CoreId> als List<String> (z.B. in Tests) kann CoreId.getStrings() verwendet werden, falls benötigt.

Notes Die Behandlung von Sophora-Dokumentänderungen kann nun priorisiert werden ("normal" und "hoch"). Auf diese Weise lassen sich z.B. redaktionelle Dokumentänderungen vor automatischen Dokumentänderungen (bspw. durch den Sophora-Importer) an die ARD Mediathek/Audiothek senden. Abgrenzung: Mappings, die per REST-Schnittstelle oder "Used Sources"-Feature ausgelöst werden, können hiermit nicht priorisiert werden. Weitere Informationen sind dem "Sophora Metadata Supplier for ARD Mediathek/Audiothek Developing Guide" unter dem Stichwort "IPrioritySetter" zu entnehmen.

Monitoring:
Die bisherigen Metriken der SupplyJob-Queue wurden beibehalten und spiegeln den Gesamtzustand der Queue wieder. Zusätzlich sind folgende Metriken neu hinzugekommen, welche sich auf die jeweilige Priorität beziehen (<priority> steht für "normal" bzw. "high"):
- metadatasupplier.supplyjob.<priority>.queue.size
- metadatasupplier.supplyjob.<priority>.queued
- metadatasupplier.supplyjob.<priority>.executed

Die Entgegennahme von Dokumentänderungsevents und deren Abarbeitung wurde in diesem Zuge voneinander getrennt. Dafür wurde eine Event-Queue eingeführt und vor der SupplyJob-Queue angesiedelt. Folgende neue Metriken zeigen den Zustand dieser Event-Queue an:
- metadatasupplier.event.queue.size
- metadatasupplier.event.queued
- metadatasupplier.event.executed
- metadatasupplier.event.executionerrors

Notes Die folgenden neuen Felder können nun angeliefert werden:
- "companyCredits" (für Seasons, Shows, EventLivestreams, Episoden, Sections und Extras)
- "creationBrid" (für Seasons, Shows, EventLivestreams, Episoden, Sections, Extras und Permanent-Livestreams)
- "creativeCommonsLicense" (für Episoden, Sections und Extras)
- "isClosedNarration" (für Shows mit Show-Type "INFINITE_SERIES")
- "isSensitiveContent" (für Shows, EventLivestreams, Episoden, Sections und Extras)
- "loginOnlyUntil" (für Publications)
- "permanentLivestreamType" (für PermanentLivestreams)
- "producedForOnDemand" (für Shows (nur Audio))
- "publicationBrid" (für Publications und Permanent-Livestreams)
- "relatedShowIds" (für Shows)
- "showNotes" (für Episoden)
- "videoLanguage" (für VideoBinaries)

Außerdem:
- Die deprecated Felder "isMovie" und "premiereDate" wurden aus Episoden komplett entfernt
- Das Feld "involvedInternalInstitutionsAndFinancialShares" von InternalOwnerships ist nun kein Pflichtfeld mehr und braucht somit nicht mehr explizit gesetzt werden

Folgende Message-Keys wurde korrigiert:
- error.deliveryapi.service.validation.image_binary.undetermineable_mediatype => error.deliveryapi.service.validation.image_binary.indeterminable_mediatype
- error.deliveryapi.service.validation.asset.category_distribution_missmatch_publisher_type => error.deliveryapi.service.validation.asset.category_distribution_mismatch_publisher_type

Folgende Message-Keys sind neu hinzugekommen:
- error.deliveryapi.service.brid.brid_not_unique
- error.deliveryapi.service.validation.must_be_equal_or_greater_than
- error.deliveryapi.service.validation.audio_binary.audiotracks.invalid_audioversion
- error.deliveryapi.service.validation.video_binary.no_embedded_subtitles_or_sign_language_available_for_videoLanguage
- error.deliveryapi.service.validation.video_binary.incorrect_language_type_for_videoLanguage_with_sign_languages
- error.deliveryapi.service.validation.video_binary.incorrect_language_type_for_videoLanguage_with_subtitles
- error.deliveryapi.service.validation.asset.invalid_html_in_shownotes
- error.deliveryapi.service.validation.asset.company_credit.exactly_one_identifier_must_be_set
- error.deliveryapi.service.validation.asset.company_credit.role_description_mandatory_for_role_other
- error.deliveryapi.service.validation.show.produced_for_on_demand_not_supported_for_video_shows
- error.deliveryapi.service.validation.show.is_closed_narration_not_valid_for_show_type
- error.deliveryapi.service.validation.publication.login_only_until_not_after_created
- error.deliveryapi.service.validation.publication.login_only_until_not_after_start_date
- error.deliveryapi.service.validation.publication.login_only_until_with_event_livestream
- error.deliveryapi.service.validation.content_event.content_event_unique_type
- error.deliveryapi.service.validation.content_event.content_events_overlap
- error.deliveryapi.service.validation.content_event.content_events_type_ordering

Die vollständige Liste aller Message-Keys und deren Texte befindet sich im ARD-Developer-Portal.

Notes "personCredits" wird an allen Items und Groupings unterstützt; "audioTracks"-Feld wird an allen Binaries unterstützt; "subtitleTracks" wird an VideoBinaries unterstützt; "contentEvents"-Feld wird an allen OnDemand Inhalten (Episode, Extra, Section) unterstützt; "language" und "subtitleType" werden an Subtitle unterstützt

Notes An Groupings (Season und Show), Items (EventLivestream, Episode, Section und Extra) sowie PermanentLivestreams können nun die Felder "contentRatings", "countriesOfOrigin", "embeddingType", "externalContentIds", "geoLocations", "internalOwnership", "normDbLocations", "originalRelease", "originalSpokenLanguages" und "seo" übergeben werden. Außerdem lassen sich an Images die Felder "artworkType" und "isBranded" setzen.

Notes Das Feedback wurde um Message-Codes mit Platzhalter-Argumenten, einer Auflistung der zusätzlich verwendeten Quellen (Used Sources) und den jew. HTTP-Status-Code von der ARD Mediathek/Audiothek erweitert. Die bisher hart codierten Feedbacktexte können somit nun per "messages.properties"-Dateien individualisiert werden. Manche der Texte wurden bereits umformuliert. Achtung: Die Textkonstanten aus FeedbackService, UnpublishOperation und RepublishOperation wurden entfernt.

Damit die Meldungstexte im Feedback und die Haftnotiztexte in den Sophora-Dokumenten weiterhin in deutscher Sprache erscheinen, muss der Metadata Supplier mit deutschem Locale gestartet werden. Diese Haftnotiztexte lassen sich ebenfalls individualisieren.

Die beim Mapping verwendeten Quellen (Used Sources) werden standardmäßig ebenfalls in die Haftnotiz geschrieben. Dies lässt sich per Konfigurationsparameter "metadata-supplier-sophora.attach-used-sources-to-sticky-notes" in der application.yml abschalten.

Weitere Informationen befinden sich in der Dokumentation zum Sophora Metadata Supplier.

Notes JMX MBeans können nun per HTTP unter /actuator/jolokia/ verwendet werden. Ab Sophora 4 ist der Sophora Metadata Supplier damit auch im Sophora Admin Dashboard monitorbar.

Notes Texte zu Fehlermeldungen aus der ARD Core API werden nun je nach Default Locale vom Sophora Metadata Supplier auf deutsch oder englisch (default) als Feedback ausgegeben. Darüber hinaus ist es möglich, eigene Übersetzungen zu verwenden. Dazu müssen entsprechende "messages properties"-Datei(en) im "i18n"-Verzeichnis der Sophora Metadata Supplier Installation abgelegt werden. Weitere Information hierzu sind der Dokumentation zu entnehmen.

Notes Neben "CoreId createId(IResource resource)" gibt es jetzt auch "List<CoreId> createIds(Collection<? extends IResource> resources)"

Notes Die Klassen com.subshell.sophora.metadatasupplier.sds.commons.SdsArdNormDbUtil und com.subshell.sophora.metadatasupplier.sds.commons.TenantUtil aus dem neuen "metadata-supplier-spring-data-sophora-commons"-Artefakt bieten Methoden an, um aus SDS-MultiSelectValue-Objekten entsprechende CoreIds für (Sub)GenreCategories oder ThematicCategories bzw. die Tenants zu erhalten.

Notes Bei AudioBinary und VideoBinary kann die TermId nun statt im CoreID-Format (z.B. "urn:ard:termid-video:9bb5a34d66e2ec19") auch im CcAvTermId-Format (z.B. "1.2.3.14.1") angegeben werden, z.B. IVideoBinary videoBinary = VideoBinary.builder().with...(...).withCcAvTermId(CcAvTermId.of("1.2.3.14.1")).build();

Notes IdUtils.createIdOrNull(Type type, ExternalId externalId) liefert die CoreId zu dem angegebenen Type und ExternalId. Falls keine ExternalId angegeben wurde, liefert die Methode null (im Gegensatz zu IdUtils.createId(Type type, ExternalId externalId), was eine Zufalls-Id liefert).

Notes Beim Hinzufügen von Feedback-Einträgen zu Feedbacks werden bereits vorhandene Einträge nun ignoriert, so dass der gleiche Feedback-Eintrag nicht mehrfach im Feedback enthalten ist.

Notes Die Metriken zu Anzahl und Größe der "Used Sources" und "Mapped Resources" sind nun unter http://<host>:<port>/actuator/metrics/ abrufbar.

Notes Per IMetadataSupplier.supply(SourceDescriptor, Parameters) und über die REST-Schnittstelle können nun zusätzliche Parameter von außen ins Mapping reingereicht werden.
ACHTUNG: Inkompatible API-Änderung! IResourceMapper.accept(SourceDescriptor) wurde geändert zu IResourceMapper.accept(SourceDescriptor, Parameters), d.h. alle Mapper-Klassen müssen die neue Methodensignatur implementieren bevor diese Metadata Supplier Version produktiv eingesetzt wird, ansonsten funktioniert das Mapping nicht! In Tests kann Parameters.of() für den neuen Methodenparameter übergeben werden.
In IResourceMapper.mapToResources(SourceDescriptor, IMappingContext) kann über den IMappingContext auf die Parameter zugegriffen werden, falls benötigt.

Notes Das Projekt "metadata-supplier-sophora-commons" enthält nun nützliche Hilfsklassen und -methoden, um Sophora-Inhalte zu IResource-Objekten zu mappen. Z.B. ImageMapper, IImageVariantsProvider und IImageDataProvider, um Sophora-Bilddokumente zu mappen, wobei pro Seitenverhältnis aus einer Liste von Bildvarianten die erste Bildvariante des Bilddokumentes mit Binärdaten verwendet wird (Codebeispiel befindet sich im "metadata-supplier-plugin-example"). ArdNormDbUtil, um aus einem Auswahlwertdokument die ARD-Normdatenbank-Werte zu ermitteln. SophoraStringUtils, um z.B. aus dem "sophora:tags"-Property die einzelnen Tag-Einträge als Liste zu erhalten. Außerdem wurde Logging beim Hinzufügen von Feedback-Einträgen eingebaut und die IdUtils um eine Methode zum Erzeugen einer CoreId aus einer ExternalId erweitert.

Notes Per IMappingContext.setUnpublishPreviouslyMappedResources(true/false) können die Resourcen zum Mappingergebnis hinzugefügt werden, welche beim aktuellen Mappingdurchlauf depubliziert werden müssen, weil sie beim vorherigen Durchlauf in der ARD Mediathek/Audiothek erzeugt und publiziert wurden, nun aber z.B. nicht mehr in der Quelle enthalten sind und deswegen in der ARD Mediathek/Audiothek depubliziert sein sollen (sofern sie nicht auch zu einer anderen Source gemappt und veröffentlicht wurden).
Außerdem existiert per IMappingContext.getResourceProvider() Zugriff auf die gespeicherten Informationen zu den zuletzt erfolgreich gemappten Resourcen der gerade zu mappenden Source.

Notes Per "ardmedialibrary.retry.maxAttempts" und "ardmedialibrary.retry.delayInMillis" kann konfiguriert werden, wie häufig und in welchen Abständen versucht werden soll, eine Resource in der ARD Mediathek/Audiothek anzulegen bzw. zu aktualisieren, wenn eine "Resource does not exist"-Fehlermeldung auftritt.

Notes Neue Methode hinzugefügt: IMappingContext.getPreviousUsedSources()

Notes Über die neue IResource-Implementation "Publishable" lassen sich Resourcen in der ARD Mediathek/Audiothek (de)publizieren, ohne dass die komplette konkrete Resource (z.B. Show) gemappt werden muss.
Zusätzlich kann per IResource.createIfNotExisting() bestimmt werden, ob eine Resource in der ARD Mediathek/Audiothek erzeugt werden soll, wenn sie dort noch nicht existiert (Standard ist "true").

Notes Der Metadata-Supplier verfügt nur noch über die Schnittstelle "supply(SourceDescriptor)". Die REST-Schnittstelle befindet sich bei /metadata-supplier/<source-type>/<source-id> ("put" und "get"). Die Mapper müssen bei Shows, Seasons, PermanentLivestreams und Publications nun per Builder.withPublished(true/false) angeben, ob die jeweilige Resource in der ARD Mediathek sichtbar sein soll oder nicht.

Notes Die Mapper können bei Shows, Seasons, PermanentLivestreams und Publications nun per Builder.withPublished(true/false) angeben, ob die jeweilige Resource in der ARD Mediathek sichtbar sein soll oder nicht.

Notes Es gibt nun ein DeskClient-Skript "Zur ARD Mediathek/Audiothek senden", um das Senden von Inhalten an die ARD Mediathek/Audiothek zu triggern, ohne Sophora-Dokumente (erneut) veröffentlichen zu müssen. Weitere Informationen dazu sind dem Abschnitt "Client Script to manually trigger the Sophora Metadata Supplier" der Dokumentation "Sophora Metadata Supplier for ARD Mediathek/Audiothek Operation" zu entnehmen.

Notes Per metadata-supplier-sophora:sync-at-startup:false in der application.yml kann die initiale Synchronisation der Inhalte aus dem Sophora-Server abgeschaltet werden

Notes In der application.yml muss nun angegeben werden, welche Dokumentstatusänderungen bei welchen Dokumenttypen im Metadata Supplier behandelt werden sollen. Siehe Dokumentation für weitere Informationen.

Notes An den ContentRatings bei Groupings (Show und Season), Items (Episode, Section, Extra und EventLivestream) sowie PermanentLivestreams kann nun das Feld "descriptorIds" übergeben werden.

Notes Der Sophora Metadata Supplier unterstützt nun Dry-Run-Modi, mit denen das Zuliefern an den ARD Core, das Persistieren von Used Sources und Mapped Resources sowie das Benachrichtigen der FeedbackHandler (z.B. zum Erzeugen der Haftnotizen an den Sophora-Dokumenten) einzeln abgeschaltet werden kann. Um den jeweiligen Modus bestimmen zu können, muss im Mapping-Projekt das Interface IModeSetter implementiert bzw. der Aufruf an der REST-Schnittstelle um den gewünschten Mode-Parameter erweitert werden.

FeedbackHandler können zudem selbst entscheiden, ob/wie sie den verwendeten Modus den Nutzern anzeigen. Standardmäßig wird vor die Meldungen in den Haftnotizen der Prefix "[Dry-Run]" gesetzt, wenn die Inhalte nicht zum ARD Core gesendet werden sollten (Message-Key: "sms.stickynote.mode.dryrun").

Weitere Informationen zum Dry-Run befinden sich in der Dokumentation.

Notes IPrioritySetter können nun neben Priority.HIGH und Priority.NORMAL auch eine Priority.LOW zurück geben, um Mapping-Aufträge niedrig zu priorisieren.

Monitoring:
Die bisherigen Metriken der SupplyJob-Queue wurden beibehalten und spiegeln weiterhin den Gesamtzustand der Queue wieder. Analog zu den Metriken für die "HIGH"- und "NORMAL"-Prioritäten sind Metriken für die neue "LOW"-Priorität hinzugekommen (<priority> steht für "high", "normal" und (neu) "low"):
- metadatasupplier.supplyjob.<priority>.queue.size
- metadatasupplier.supplyjob.<priority>.queued
- metadatasupplier.supplyjob.<priority>.executed

Notes In der 'application.yml' muss nun der Name des Zulieferers von Inhalten an die ARD Mediathek/Audiothek angegeben werden, zum Beispiel "ardmedialibrary.supplier.name: WDR". Falls dieser Parameter nicht gesetzt ist, lässt sich der Sophora-Metadata-Supplier nicht starten!

Notes SubtitleType verfügt nun über die Werte DEFAULT, SIMPLE_LANGUAGE, CLOSED_CAPTIONS und FORCED

Notes GeoAvailability verfügt nun über die Werte DE, DACH, EU und GLOBAL.

Notes Das Enum 'com.subshell.sophora.metadatasupplier.sophora.commons.image.AspectRatio' enthält nun nicht mehr den Wert ASPECT_RATIO_19X4, da die ARD Mediathek/Audiothek das Seitenverhältnis 19:4 nicht mehr unterstützt. Mappings, die auf diesen Wert zugreifen, müssen entsprechend angepasst werden.

Notes Das SMS 5.x verwendet nun Sophora-Core 5.17.0, Spring Data Sophora 5.8.6 und Spring Boot Sophora Commons 5.3.4.
Das SMS 4.x verwendet nun Sophora-Core 4.36.6, Spring Data Sophora 4.11.6 und Spring Boot Sophora Commons 4.3.25.

Notes Es kann per Konfiguration in der application.yml für alle zulieferbaren Core API Entitäten das importOrigin-Feld angegeben werden.
Bitte beachten: Im Standardfall werden sämtliche Entitäten ohne importOrigin-Feld zugeliefert. Eine explizite Zulieferung des Feldes darf nur nach Absprache mit der ARD Mediathek/Audiothek erfolgen!

Notes Im com.subshell.sophora.metadatasupplier.sophora.commons.image.ImageMapper können die Methoden mapImages(IImageDataProvider imageDataProvider) und mapImagesToAspectRatioMap(IImageDataProvider imageDataProvider) nun zusätzlich mit IMappingContext als Parameter aufgerufen werden. Dieser wird für neue Feedback-Messages benötigt, welche angezeigt werden, wenn bei der Zulieferung ein Bild auf die Mindestgröße hochskaliert werden musste. Die Message-Codes lauten "sms.sophora.image.minimumSizeRequirementsNotSatisfied.height" und "sms.sophora.image.minimumSizeRequirementsNotSatisfied.width" und können auch aus der Konstanten-Klasse com.subshell.sophora.metadatasupplier.sophora.commons.feedback.MessageCodeConstants des neuen Projektes "metadata-supplier-sophora-commons-api" entnommen werden.

Notes Ab SMS 5.7.3 wird nun Tomcat 10.1.39 bzw. ab SMS 4.32.3 wird nun Tomcat 9.0.102 eingebunden

Notes Abhängigkeiten wurden aktualisiert.

Notes Die Implementation der Methode com.subshell.sophora.metadatasupplier.sophora.commons.image.IImageDataProvider.getBinaryData() wirft bei gesperrten Seitenverhältnis-Bildvarianten standardmäßig keine Exception mehr. Stattdessen werden die Bildvarianten ignoriert, sodass der Mappingvorgang und in Folge auch die Zulieferung an die ARD Mediathek/Audiothek weiter durchgeführt werden können.

Notes Der ImageVariantsProvider verfügt nun über die neuen Methoden 'setImageSizeRequirementsForAspectRatio(IAspectRatio aspectRatio, ImageSizeRequirements imageSizeRequirements)' und 'getImageSizeRequirementsForAspectRatio(IAspectRatio aspectRatio)' für die Angabe einer von der ARD Mediathek/Audiothek gewünschten Bildgröße und einer Mindestgröße (entweder über die Höhe oder über die Breite)

Beispiel-Aufruf für eine gewünschte Breite von 3840px, aber mindestens 1920px bei 16:9-Bildvarianten:
'imageVariantsProvider.setImageSizeRequirementsForAspectRatio(ASPECT_RATIO_16X9, ImageSizeRequirements.createWithWidth(3840, 1920));'

Notes Wenn beim Start der Anwendung eine der Dateien im data-Verzeichnis ("lastHandledEventDate.txt", "mappedResources.json", "usages.json") invalides Datenformat enthält, wird der Start abgebrochen.
Das Datum des zuletzt behandelten Sophora-Events wird nun zusätzlich ins Logfile geschrieben, so dass diese Information auch von dort abgelesen werden kann.
Die Dateien "mappedResources.json" und "usages.json" werden nun zunächst als tmp-Datei im data-Verzeichnis erzeugt und erst anschließend ersetzt, um die Originaldateien zu erhalten, falls die Anwendung während des Schreibens der Dateien beendet wird. Dadurch wird mehr Festplattenspeicherplatz benötigt.

Notes Das Docker-Image vom SMS enthält nun Java 17 statt Java 11. Das SMS ist weiterhin kompatibel mit Java 11.

Notes Mapping-Projekte können nun bis zu eine ISourceFilter-Komponente bereitstellen, die entscheidet, ob ein Mapping-Auftrag überhaupt vom MetadataSupplier ausgeführt werden soll. Im Gegensatz zu der accept()-Methode der IResourceMapper-Implementationen wird mit dem ISourceFilter auch verhindert, dass nachfolgende Mappings (aufgrund des "Used Sources"-Mechanismus) ausgelöst werden. Wenn der SourceFilter ein Quellobjekt (Source) ablehnt, wird ein Feedback mit MessageCode "sms.source.denied" zurückgeliefert, ansonsten wird die Source wie gehabt gemappt und in der ARD Mediathek/Audiothek aktualisiert.

Die jeweilige Ausführungsdauer für den SourceFilter wird ebenfalls erfasst und sowohl im Feedback als auch über Prometheus-Metriken bereitgestellt.

Für abgelehnte Mapping-Aufträge wird standardmäßig keine Haftnotiz an Sophora-Dokumenten hinterlegt. Dies lässt sich jedoch in der application.yml mit dem Eintrag metadata-supplier-sophora.create-sticky-notes-for-denied-sources: true/false konfigurieren.

Notes Im "Catalog"-Enum (für ExternalContentIds von Episoden, EventLivestreams, Extras, PermanentLivestreams, Seasons, Sections und Shows) wurde der Wert OTHER entfernt und APPLE_TV hinzugefügt.

Im "PersonCatalog"-Enum (für ExternalPersonIds in PersonCredits von Episoden, EventLivestreams, Extras, Seasons, Sections und Shows) wurde der Wert OTHER entfernt.

Notes AudioBinary und VideoBinary verfügen nun über das neue Feld "allowDeprecatedTermIds".

Notes Create-Requests werden nun ohne Slash am Ende der URL aufgerufen, also z.B. ".../delivery-api/items/event-livestreams" statt ".../delivery-api/items/event-livestreams/"

Notes Einige Validierungsmeldungen wurden um die Platzhalter '${resourceFieldName}', '${coreId}' und '${resourceTypeName}' angereichert, um aussagekräftigere Texte zu erhalten. Zum Beispiel "Das Feld '${resourceFieldName}' der Ressource '${coreId}' vom Typ '${resourceTypeName}' muss gesetzt werden, wenn ContentEventType ${type} ist." statt einfach nur "Muss gesetzt werden, wenn ContentEventType ${type} ist."

Notes ContentEvent verfügt über die neuen Felder timeInContent (String), progressbarIconId (CoreId) und participantIconId (CoreId)

Notes Der Zustandsübergang von Sophora-Dokumenten von "publishAt" zu "prePublished" wird nun als "prePublish" statt "publishAtCanceled" behandelt, da in dem Fall die Veröffentlichung nicht abgebrochen, sondern angestoßen wird (auf den Zustand "prePublished" folgt "published")

Notes Der initiale SourceDescriptor und die Parameter des jeweiligen SMS-Aufrufs werden nun bei jeder zugehörigen Logmeldung mit geloggt. Technisch werden dazu am MDC (Mapped Diagnostic Context) intern die Werte "trigger_source" und "trigger_parameters" gesetzt.

Notes Der Enum com.subshell.sophora.metadatasupplier.sophora.commons.image.AspectRatio stellt nun auch einen Wert ASPECT_RATIO_19X4 bereit

Notes Episoden, Sections, Extras und EventLivestreams verfügen nun über das neue Feld "nonUniqueMatchingBrid".

Notes Es gibt nun Metriken für das Alter der Sophora-Events bzw. Supply-Jobs in der Event- bzw. Job-Queue (/actuator/metrics/metadatasupplier.event.ages und /actuator/metrics/metadatasupplier.supplyjob.ages).

Außerdem werden Metriken für die Ausführungsdauern der accept()- und mapToResources()-Methoden der einzelnen IResourceMapper sowie die Dauer zum Senden der erzeugten Resources an den ARD Core bereitgestellt (/actuator/metrics/metadatasupplier.mapper.accept, /actuator/metrics/metadatasupplier.mapper.map, /actuator/metrics/metadatasupplier.ardcore.calls).

Die Dauer zum Lesen/Schreiben der Used-Sources- und Mapped-Resources-Dateien steht nun ebenfalls als Metrik bereit (/actuator/metrics/metadatasupplier.persistence).

Alle diese Daten sind auch unter /actuator/prometheus abrufbar.

Notes Die Ausführungsdauer der SMS-Aufrufe wird nun geloggt und auch im Feedback zurück geliefert ("diagnostic"). Dabei werden die Gesamtdauer des SMS-Aufrufs und Teildauern für einzelne Schritte erfasst (dazu gehören das Ermitteln des richtigen Mappers, das Mapping selbst und das Senden an die ARD Mediathek/Audiothek). Im eigenen Mapping-Code können über die neue Methode IMappingContext .addDurationOf(...) eigene Zeiten erfasst und zum Feedback hinzugefügt werden. Bei Anbindung an Sophora wird zusätzlich das Alter der einzelnen Einträge in der Event- und SupplyJob-Queue ermittelt und geloggt.

Notes Wenn bei einem (erneuten) Mappingdurchlauf für ein Sophora-Dokument keine gemappten Ressourcen entstehen, bleiben zuvor gesetzte SMS-Haftnotizen an dem Dokument erhalten, statt sie zu entfernen.

Notes Es gibt einen neuen Message-Key "sms.stickynote.unpublish.success" mit dem Standardtext "Die zugehörigen Inhalte wurden am ${date} um ${time} Uhr erfolgreich in der ARD Mediathek/Audiothek depubliziert (${resourceDescriptors})". Der Text erscheint (zusätzlich) in der Haftnotiz am Sophora-Dokument, wenn mindestens eine gemappte Ressource erfolgreich in der ARD Mediathek/Audiothek depubliziert wurde.

Die Formulierung der Feedbacktexte mit den Message-Keys "sms.unpublish.error", "sms.unpublish.success", "sms.unpublish.unable", "sms.unpublish.unnecessary" wurden entsprechend angepasst, so dass die Inhalte nicht "aus der Mediathek entfernt", sondern "in der Mediathek depubliziert" wurden.

Notes Episodes, EventLivestreams, Extras und Sections verfügen nun über das Feld publisherId.
Sections verfügen zusätzlich über das neue Feld timestampInParent.

Notes EventLivestreams verfügen nun über das neue Feld "hasLiveContentEvents".

Notes Der Builder für NormDbLocations nimmt die Id nun als CoreId-Objekt und als String entgegen. Wenn die Id als String übergeben wird, wird sie ins CoreId-Format umgewandelt, wenn nötig. Z.B. aus dem String "vokabel-1572" wird "urn:ard:location:e4f12d7dba8c438f" und aus dem String "1572" wird ebenfalls "urn:ard:location:e4f12d7dba8c438f". Die Angabe von "urn:ard:location:e4f12d7dba8c438f" bleibt unverändert. Mappings sollten dennoch direkt ein CoreId-Objekt statt einen String übergeben.

Notes Während der Synchronisierung eingehende Sophora-Events werden nun nachträglich abgearbeitet

Notes Die Behandlung von Sophora-Dokumentänderungen kann nun priorisiert werden ("normal" und "hoch"). Auf diese Weise lassen sich z.B. redaktionelle Dokumentänderungen vor automatischen Dokumentänderungen (bspw. durch den Sophora-Importer) an die ARD Mediathek/Audiothek senden. Abgrenzung: Mappings, die per REST-Schnittstelle oder "Used Sources"-Feature ausgelöst werden, können hiermit nicht priorisiert werden. Weitere Informationen sind dem "Sophora Metadata Supplier for ARD Mediathek/Audiothek Developing Guide" unter dem Stichwort "IPrioritySetter" zu entnehmen.

Monitoring:
Die bisherigen Metriken der SupplyJob-Queue wurden beibehalten und spiegeln den Gesamtzustand der Queue wieder. Zusätzlich sind folgende Metriken neu hinzugekommen, welche sich auf die jeweilige Priorität beziehen (<priority> steht für "normal" bzw. "high"):
- metadatasupplier.supplyjob.<priority>.queue.size
- metadatasupplier.supplyjob.<priority>.queued
- metadatasupplier.supplyjob.<priority>.executed

Die Entgegennahme von Dokumentänderungsevents und deren Abarbeitung wurde in diesem Zuge voneinander getrennt. Dafür wurde eine Event-Queue eingeführt und vor der SupplyJob-Queue angesiedelt. Folgende neue Metriken zeigen den Zustand dieser Event-Queue an:
- metadatasupplier.event.queue.size
- metadatasupplier.event.queued
- metadatasupplier.event.executed
- metadatasupplier.event.executionerrors

Notes Behebt das Problem, dass URLs am Ende von einzelnen Aufzählungspunkten in den Feedback-Haftnotizen im DeskClient nicht (richtig) als Link erkannt werden

Notes Manche deutsche Übersetzungen der englischsprachigen Validierungsmeldungen von der ARD Mediathek/Audiothek wurden verbessert

Notes Die folgenden neuen Felder können nun angeliefert werden:
- "companyCredits" (für Seasons, Shows, EventLivestreams, Episoden, Sections und Extras)
- "creationBrid" (für Seasons, Shows, EventLivestreams, Episoden, Sections, Extras und Permanent-Livestreams)
- "creativeCommonsLicense" (für Episoden, Sections und Extras)
- "isClosedNarration" (für Shows mit Show-Type "INFINITE_SERIES")
- "isSensitiveContent" (für Shows, EventLivestreams, Episoden, Sections und Extras)
- "loginOnlyUntil" (für Publications)
- "permanentLivestreamType" (für PermanentLivestreams)
- "producedForOnDemand" (für Shows (nur Audio))
- "publicationBrid" (für Publications und Permanent-Livestreams)
- "relatedShowIds" (für Shows)
- "showNotes" (für Episoden)
- "videoLanguage" (für VideoBinaries)

Außerdem:
- Die deprecated Felder "isMovie" und "premiereDate" wurden aus Episoden komplett entfernt
- Das Feld "involvedInternalInstitutionsAndFinancialShares" von InternalOwnerships ist nun kein Pflichtfeld mehr und braucht somit nicht mehr explizit gesetzt werden

Folgende Message-Keys wurde korrigiert:
- error.deliveryapi.service.validation.image_binary.undetermineable_mediatype => error.deliveryapi.service.validation.image_binary.indeterminable_mediatype
- error.deliveryapi.service.validation.asset.category_distribution_missmatch_publisher_type => error.deliveryapi.service.validation.asset.category_distribution_mismatch_publisher_type

Folgende Message-Keys sind neu hinzugekommen:
- error.deliveryapi.service.brid.brid_not_unique
- error.deliveryapi.service.validation.must_be_equal_or_greater_than
- error.deliveryapi.service.validation.audio_binary.audiotracks.invalid_audioversion
- error.deliveryapi.service.validation.video_binary.no_embedded_subtitles_or_sign_language_available_for_videoLanguage
- error.deliveryapi.service.validation.video_binary.incorrect_language_type_for_videoLanguage_with_sign_languages
- error.deliveryapi.service.validation.video_binary.incorrect_language_type_for_videoLanguage_with_subtitles
- error.deliveryapi.service.validation.asset.invalid_html_in_shownotes
- error.deliveryapi.service.validation.asset.company_credit.exactly_one_identifier_must_be_set
- error.deliveryapi.service.validation.asset.company_credit.role_description_mandatory_for_role_other
- error.deliveryapi.service.validation.show.produced_for_on_demand_not_supported_for_video_shows
- error.deliveryapi.service.validation.show.is_closed_narration_not_valid_for_show_type
- error.deliveryapi.service.validation.publication.login_only_until_not_after_created
- error.deliveryapi.service.validation.publication.login_only_until_not_after_start_date
- error.deliveryapi.service.validation.publication.login_only_until_with_event_livestream
- error.deliveryapi.service.validation.content_event.content_event_unique_type
- error.deliveryapi.service.validation.content_event.content_events_overlap
- error.deliveryapi.service.validation.content_event.content_events_type_ordering

Die vollständige Liste aller Message-Keys und deren Texte befindet sich im ARD-Developer-Portal.

Notes Falls Bildvarianten in einem Bilddokument nicht existieren, wird nun neben dem Bildvariantennamen auch die Sophora-ID des betroffenen Bilddokumentes geloggt.

Notes Das bestehende Verhalten bei der Erzeugung von ImageCollections wurde durch weitere Unittests abgesichert

Notes Es gibt nun ein DeskClient-Skript "Zur ARD Mediathek/Audiothek senden", um das Senden von Inhalten an die ARD Mediathek/Audiothek zu triggern, ohne Sophora-Dokumente (erneut) veröffentlichen zu müssen. Weitere Informationen dazu sind dem Abschnitt "Client Script to manually trigger the Sophora Metadata Supplier" der Dokumentation "Sophora Metadata Supplier for ARD Mediathek/Audiothek Operation" zu entnehmen.

Notes Das Feedback wurde um Message-Codes mit Platzhalter-Argumenten, einer Auflistung der zusätzlich verwendeten Quellen (Used Sources) und den jew. HTTP-Status-Code von der ARD Mediathek/Audiothek erweitert. Die bisher hart codierten Feedbacktexte können somit nun per "messages.properties"-Dateien individualisiert werden. Manche der Texte wurden bereits umformuliert. Achtung: Die Textkonstanten aus FeedbackService, UnpublishOperation und RepublishOperation wurden entfernt.

Damit die Meldungstexte im Feedback und die Haftnotiztexte in den Sophora-Dokumenten weiterhin in deutscher Sprache erscheinen, muss der Metadata Supplier mit deutschem Locale gestartet werden. Diese Haftnotiztexte lassen sich ebenfalls individualisieren.

Die beim Mapping verwendeten Quellen (Used Sources) werden standardmäßig ebenfalls in die Haftnotiz geschrieben. Dies lässt sich per Konfigurationsparameter "metadata-supplier-sophora.attach-used-sources-to-sticky-notes" in der application.yml abschalten.

Weitere Informationen befinden sich in der Dokumentation zum Sophora Metadata Supplier.

Notes Zum Auslesen der aktuellen Anzahl der aus Sophora getriggerten und noch abzuarbeitenden Mapping-Aufträge wurde die neue Metrik "metadatasupplier.supplyjob.queue.size" hinzugefügt. Die Anzahl der insgesamt aus Sophora getriggerten bzw. abgearbeiteten Mapping-Aufträge seit SMS-Start kann nun über die neuen Metriken "metadatasupplier.supplyjob.queued" bzw. "metadatasupplier.supplyjob.executed" abgefragt werden. Die Gesamtanzahl der Mapping-Aufträge, deren Abarbeitung aufgrund unvorhergesehener Fehler abgebrochen ist, kann über die neue Metrik "metadatasupplier.supplyjob.executionerrors" ausgelesen werden.

Notes Die Hilfsmethoden der ArdNormDbUtil- und SdsArdNormDbUtil-Klassen können jetzt auch die Vokabel-IDs aus Genre- und Subgenre-Auswahlwerten auslesen, die der neuen Struktur folgen, welche mit dem ARD Metadatenpaket 2 eingeführt wurde. Genres und Subgenres, die noch der alten Struktur folgen, funktionieren weiterhin mit den Hilfsmethoden.

Notes Bei Bildern sind nun folgende Seitenverhältnisse möglich: 2:3, 3:4, 16:7, 16:9, 32:9, 64:9

Notes "personCredits" wird an allen Items und Groupings unterstützt; "audioTracks"-Feld wird an allen Binaries unterstützt; "subtitleTracks" wird an VideoBinaries unterstützt; "contentEvents"-Feld wird an allen OnDemand Inhalten (Episode, Extra, Section) unterstützt; "language" und "subtitleType" werden an Subtitle unterstützt

Notes Behebt das Problem, dass die mitgelieferten Übersetzungen zu Fehlermeldungen der Core API oder eigene Übersetzungen in Mapping-Plugins nicht gefunden werden.

Notes Mit diesem Bugfix wird der Onlinestatus in der Kachel im Dashboard repariert. Damit die Daten in den Details auf der rechten Seite im Dashboard angezeigt werden, muss das Admin Dashboard in Version >= 3.1.5, 4.2.4, 5.0.0 verwendet werden.

Notes Es wird nun Spring Boot 2.7.11 (statt 2.7.10) mit Spring 5.3.27 (statt 5.3.26) eingesetzt. In bestehenden Mapping-Projekten müssen ggf. die Abhängigkeiten angepasst werden.

Notes An Groupings (Season und Show), Items (EventLivestream, Episode, Section und Extra) sowie PermanentLivestreams können nun die Felder "contentRatings", "countriesOfOrigin", "embeddingType", "externalContentIds", "geoLocations", "internalOwnership", "normDbLocations", "originalRelease", "originalSpokenLanguages" und "seo" übergeben werden. Außerdem lassen sich an Images die Felder "artworkType" und "isBranded" setzen.

Notes Die Standard-URL zur Swagger-UI lautet nun http://localhost:8080/swagger-ui.html (statt http://localhost:8080/swagger-ui/index.html). Siehe Dokumentation bzgl. REST-API, Monitoring und Konfiguration des Webservers.

Notes Mapping-Projekte müssen ggf. an die neuen verwendeten Versionen angepasst werden.

Notes Texte zu Fehlermeldungen aus der ARD Core API werden nun je nach Default Locale vom Sophora Metadata Supplier auf deutsch oder englisch (default) als Feedback ausgegeben. Darüber hinaus ist es möglich, eigene Übersetzungen zu verwenden. Dazu müssen entsprechende "messages properties"-Datei(en) im "i18n"-Verzeichnis der Sophora Metadata Supplier Installation abgelegt werden. Weitere Information hierzu sind der Dokumentation zu entnehmen.

Notes Es wird nun SpringDataSophora 4.4.0 verwendet, u.a. mit der Erweiterung für das IPTC-Add-on an Bilddokumenttypen und korrekter Beachtung im OfflineDateCalculator, wenn "sophora:offlineAfterDays" auf "-" gesetzt ist (= "nie offline stellen").

Notes Der Metadata Supplier gibt nun die Version von spring-data-sophora-commons vor, so dass Mapper-Projekte diese einfach verwenden können.

Notes In Mapping-Projekten müssen JUnit-Abhängigkeiten nun ggf. explizit angegeben werden.

Notes In der RestTemplateFactory verwendet der RestTemplateBuilder nun die per RestTemplateFactory.createRequestFactory() erzeugte ClientHttpRequestFactory. Es reicht also, die Methode statt der ganzen Klasse zu überschreiben, wenn eine andere RequestFactory verwendet werden soll.

Notes Exceptions in IResourceMapper.accept(...) werden nun abgefangen und so behandelt, als ob es keinen Mapper für die Source gäbe. Eine entsprechende Feedbackmeldung wird zurückgegeben.

Notes Diverse Abhängigkeiten wurden aktualisiert

Notes Es gibt nun keine "Erfolgreich an die ARD Mediathek/Audiothek gesendet"-Feedbackmeldung mehr für Objekte vom Typ Publishable, da über diese keine Resourcen in der Mediathek angelegt oder inhaltlich aktualisiert werden können. Die Feedbackmeldungen "Erfolgreich in der ARD Mediathek/Audiothek veröffentlicht" bzw. "Erfolgreich aus der ARD Mediathek/Audiothek entfernt" erscheinen weiterhin.

Es gibt neue, zusätzliche Feedbackmeldungen, wenn Resourcen in der ARD Mediathek/Audiothek veröffentlicht/depubliziert werden sollten, die bereits veröffentlicht/depubliziert sind: "Ein (erneutes) Veröffentlichen in der ARD Mediathek/Audiothek war nicht notwendig" und "Ein (erneutes) Entfernen aus der ARD Mediathek/Audiothek war nicht notwendig".

Es gibt neue, zusätzliche Feedbackmeldungen, wenn Resourcen in der ARD Mediathek/Audiothek veröffentlicht/depubliziert werden sollten, die dort gar nicht existieren: "Ein Veröffentlichen in der ARD Mediathek/Audiothek war nicht möglich" bzw. "Ein Entfernen aus der ARD Mediathek/Audiothek war nicht möglich".

Notes JMX MBeans können nun per HTTP unter /actuator/jolokia/ verwendet werden. Ab Sophora 4 ist der Sophora Metadata Supplier damit auch im Sophora Admin Dashboard monitorbar.

Notes Behebt ein Maven-Enforcer-Plugin-Problem für SMS-Mapper-Plugin-Projekte bzgl. der verwendeten Sophora-Core-Version.

Notes Die verschiedenen Services der ARD Mediathek/Audiothek (wie Image-Service, Asset-API und Player-API) werden mittlerweile unter einer Delivery-API-URL zusammengefasst und bereitgestellt. Daher lauten die Standard-URL-Konfigurationen im SMS für Image-Service, Asset-API und Player-API nun jeweils https://deliver-test.ard.de/delivery-api statt https://deliver-test.ard.de/image-service, https://deliver-test.ard.de/asset-api und https://deliver-test.ard.de/player-api.
Bei bestehenden SMS-Installationen, die die ARD Mediathek/Audiothek Service-URLs in der application.yml eingetragen haben, müssen diese URLs für jeden der drei Services entsprechend angepasst werden: URL für das Testsystem der ARD Mediathek/Audiothek: https://deliver-test.ard.de/delivery-api bzw. URL für das Live-System der ARD Mediathek/Audiothek: https://deliver.ard.de/delivery-api

Notes Mapping-Plugin-Projekte können für einfacheres und konsistentes Dependency Management nun die "pom.xml" von "metadatasupplier-parent" importieren

Notes Alle Resourcen werden nur noch auf Trace-Level geloggt.

Notes Die Metriken zu Anzahl und Größe der "Used Sources" und "Mapped Resources" sind nun unter http://<host>:<port>/actuator/metrics/ abrufbar.

Notes Der JavaDoc an den Interfaces für Resourcen (IShow, ISeason, IEpisode, usw.) wurde aktualisiert.

Notes Über den VM-Parameter -Dspring.profiles.active=json-logs (oder über die Angabe in der application.yml) kann strukturiertes (Json-)Logging aktiviert werden.
Vorsicht: Fügt eine Abhängigkeit zu "net.logstash.logback" "logstash-logback-encoder" hinzu, die in Mapping-Projekten ggf. zu Abhängigkeitskonflikten mit Jackson führen kann.

Notes Publications können auch angelegt werden, ohne explizit Images hinzufügen zu müssen. In dem Fall werden in der ARD Mediathek/Audiothek die Bilder aus dem referenzierten Item verwendet.

Notes Wenn die <my-mapping>-jar-with-dependencies.jar eine META-INF/MANIFEST.MF mit Eintrag für "Implementation-Version" hat, wird die Versionsnummer der Mapper-Klassen geloggt.

Notes Die Metriken enthalten nun {application="Sophora Metadata Supplier for ARD Mediathek/Audiothek"}

Notes Bei AudioBinary und VideoBinary kann die TermId nun statt im CoreID-Format (z.B. "urn:ard:termid-video:9bb5a34d66e2ec19") auch im CcAvTermId-Format (z.B. "1.2.3.14.1") angegeben werden, z.B. IVideoBinary videoBinary = VideoBinary.builder().with...(...).withCcAvTermId(CcAvTermId.of("1.2.3.14.1")).build();

Notes Neben "CoreId createId(IResource resource)" gibt es jetzt auch "List<CoreId> createIds(Collection<? extends IResource> resources)"

Notes Die Klassen com.subshell.sophora.metadatasupplier.sds.commons.SdsArdNormDbUtil und com.subshell.sophora.metadatasupplier.sds.commons.TenantUtil aus dem neuen "metadata-supplier-spring-data-sophora-commons"-Artefakt bieten Methoden an, um aus SDS-MultiSelectValue-Objekten entsprechende CoreIds für (Sub)GenreCategories oder ThematicCategories bzw. die Tenants zu erhalten.

Notes IdUtils.createIdOrNull(Type type, ExternalId externalId) liefert die CoreId zu dem angegebenen Type und ExternalId. Falls keine ExternalId angegeben wurde, liefert die Methode null (im Gegensatz zu IdUtils.createId(Type type, ExternalId externalId), was eine Zufalls-Id liefert).

Notes Es gibt jetzt SophoraSourceDescriptor.create(ISophoraDocument), um den SourceDescriptor zu einem Sophora-Dokument zu erzeugen.
Das neue Artefakt "metadata-supplier-spring-data-sophora-commons" enthält DocumentEntitySourceDescriptor.create(SophoraDocumentEntity), womit SourceDescriptor-Objekte zu SophoraDocumentEntity-Objekten erzeugt werden können.
Zu beachten: Das neue Artefakt bringt die Abhängigkeit zu "metadata-supplier-sophora-commons" und zu "spring-data-sophora" mit.

Notes VideoBinary.isHasEmbeddedSubtitles() wurde entfernt. Es muss IVideoBinary.hasEmbeddedSubtitles() genutzt werden.
Der vollständige Fix ist erst ab Version 3.5.4 bzw. 4.5.4 enthalten.

Notes VideoBinary.isHasEmbeddedSubtitles() wurde entfernt. Es muss IVideoBinary.hasEmbeddedSubtitles() genutzt werden.
Der vollständige Fix ist erst ab Version 3.5.4 bzw. 4.5.4 enthalten.

Notes Beim Hinzufügen von Feedback-Einträgen zu Feedbacks werden bereits vorhandene Einträge nun ignoriert, so dass der gleiche Feedback-Eintrag nicht mehrfach im Feedback enthalten ist.

Notes Der ImageMapper bietet nun zusätzlich die Methode mapImagesToAspectRatioMap(IImageDataProvider imageDataProvider) an, welche Map<IAspectRatio, IImage> zurück liefert.

Notes Beim Auftreten eines LinkageError zwischen SMS und Mapping erscheint dieser nun in der Logdatei und das SMS wird mit Exitcode 192 beendet.

Notes ACHTUNG: Inkompatible Model-API-Änderung! Die Felder genreCategoryId, subgenreCategoryIds und thematicCategoryIds an Shows, Sections, Seasons usw. sind nun vom Typ CoreId statt String! Die Mapper-Projekte/-Klassen müssen dementsprechend angepasst werden, bevor diese Metadata Supplier Version produktiv eingesetzt wird, ansonsten funktioniert das Mapping nicht!
Dazu `String genreCategoryCoreId = "urn:ard:category-genre:myExternalIdHash";` ändern zu `CoreId genreCategoryCoreId = CoreId.create("urn:ard:category-genre:myExternalIdHash");` oder `CoreId genreCategoryCoreId = CoreId.create(Type.GENRE_CATEGORY.getCoreIdPrefix(), "myExternalIdHash");` bzw. `String genreCategoryId = CoreId.create(Type.GENRE_CATEGORY, "myExternalId").getId();` ändern zu `CoreId genreCategoryCoreId = CoreId.create(Type.GENRE_CATEGORY, "myExternalId");`.
Zum Lesen von List<CoreId> als List<String> (z.B. in Tests) kann CoreId.getStrings() verwendet werden, falls benötigt.

Notes Per IMetadataSupplier.supply(SourceDescriptor, Parameters) und über die REST-Schnittstelle können nun zusätzliche Parameter von außen ins Mapping reingereicht werden.
ACHTUNG: Inkompatible API-Änderung! IResourceMapper.accept(SourceDescriptor) wurde geändert zu IResourceMapper.accept(SourceDescriptor, Parameters), d.h. alle Mapper-Klassen müssen die neue Methodensignatur implementieren bevor diese Metadata Supplier Version produktiv eingesetzt wird, ansonsten funktioniert das Mapping nicht! In Tests kann Parameters.of() für den neuen Methodenparameter übergeben werden.
In IResourceMapper.mapToResources(SourceDescriptor, IMappingContext) kann über den IMappingContext auf die Parameter zugegriffen werden, falls benötigt.

Notes In "metadata-supplier-sophora-commons" gibt es nun einen com.subshell.sophora.metadatasupplier.sophora.commons.Iso8601Converter

Notes In com.subshell.sophora.metadatasupplier.sophora.commons.ArdNormDbUtil sind nun entsprechende Methoden enthalten

Notes Die Enums aus com.subshell.ardcore.model.types haben nun alle eine valuesOf(Collection<String> names)-Methode

Notes Der Metadata Supplier verwendet nun Sophora Core 3.9.4 bzw. 4.9.4. Mapper-Projekte mit Metadata Supplier 3.4.2 bzw. 4.4.2 und Spring-Data-Sophora 3.2.8 bzw. 4.0.14 müssen u.U. org.slf4j:slf4j-api:1.7.32 bzw. org.slf4j:jcl-over-slf4j:1.7.32 statt Version 1.7.30 einbinden.

Notes Bei Publications kann jetzt auch das Feld "originalClipExternalId" gesetzt werden.

Notes Das Projekt "metadata-supplier-sophora-commons" enthält nun nützliche Hilfsklassen und -methoden, um Sophora-Inhalte zu IResource-Objekten zu mappen. Z.B. ImageMapper, IImageVariantsProvider und IImageDataProvider, um Sophora-Bilddokumente zu mappen, wobei pro Seitenverhältnis aus einer Liste von Bildvarianten die erste Bildvariante des Bilddokumentes mit Binärdaten verwendet wird (Codebeispiel befindet sich im "metadata-supplier-plugin-example"). ArdNormDbUtil, um aus einem Auswahlwertdokument die ARD-Normdatenbank-Werte zu ermitteln. SophoraStringUtils, um z.B. aus dem "sophora:tags"-Property die einzelnen Tag-Einträge als Liste zu erhalten. Außerdem wurde Logging beim Hinzufügen von Feedback-Einträgen eingebaut und die IdUtils um eine Methode zum Erzeugen einer CoreId aus einer ExternalId erweitert.

Notes Per IMappingContext.setUnpublishPreviouslyMappedResources(true/false) können die Resourcen zum Mappingergebnis hinzugefügt werden, welche beim aktuellen Mappingdurchlauf depubliziert werden müssen, weil sie beim vorherigen Durchlauf in der ARD Mediathek/Audiothek erzeugt und publiziert wurden, nun aber z.B. nicht mehr in der Quelle enthalten sind und deswegen in der ARD Mediathek/Audiothek depubliziert sein sollen (sofern sie nicht auch zu einer anderen Source gemappt und veröffentlicht wurden).
Außerdem existiert per IMappingContext.getResourceProvider() Zugriff auf die gespeicherten Informationen zu den zuletzt erfolgreich gemappten Resourcen der gerade zu mappenden Source.

Notes Per "ardmedialibrary.retry.maxAttempts" und "ardmedialibrary.retry.delayInMillis" kann konfiguriert werden, wie häufig und in welchen Abständen versucht werden soll, eine Resource in der ARD Mediathek/Audiothek anzulegen bzw. zu aktualisieren, wenn eine "Resource does not exist"-Fehlermeldung auftritt.

Notes Neue Methode hinzugefügt: IMappingContext.getPreviousUsedSources()

Notes Über die neue IResource-Implementation "Publishable" lassen sich Resourcen in der ARD Mediathek/Audiothek (de)publizieren, ohne dass die komplette konkrete Resource (z.B. Show) gemappt werden muss.
Zusätzlich kann per IResource.createIfNotExisting() bestimmt werden, ob eine Resource in der ARD Mediathek/Audiothek erzeugt werden soll, wenn sie dort noch nicht existiert (Standard ist "true").

Notes Proxy-Einstellungen zur ARD Mediathek/Audiothek können nicht mehr in der application.yml über "ardmedialibrary.credentials.proxyUrl" und "ardmedialibrary.credentials.proxyPort" gesetzt werden. Stattdessen muss der Proxy über normale Systemproperties konfiguriert werden, z.B. in der Datei metadata-supplier-application-executable.conf.

Notes Das "metadata-supplier-plugin-example" enthält jetzt zusätzlich einen Beispiel-Mapper, der Spring-Data-Sophora nutzt. Außerdem wir ein "jar-with-dependencies" erstellt. GroupId: "com.subshell.sophora.metadatasupplier", ArtifactId: "metadata-supplier-plugin-example" bzw. "metadata-supplier-plugin-example-launcher".

Notes Die Operationen "unpublish" bzw. "republish" an der ARD Core API werden nur noch für veröffentlichbare Entitäten ausgeführt, bei denen der Sichtbarkeitszustand geändert werden muss.

Notes Der Metadata-Supplier verfügt nur noch über die Schnittstelle "supply(SourceDescriptor)". Die REST-Schnittstelle befindet sich bei /metadata-supplier/<source-type>/<source-id> ("put" und "get"). Die Mapper müssen bei Shows, Seasons, PermanentLivestreams und Publications nun per Builder.withPublished(true/false) angeben, ob die jeweilige Resource in der ARD Mediathek sichtbar sein soll oder nicht.

Notes Die Mapper können bei Shows, Seasons, PermanentLivestreams und Publications nun per Builder.withPublished(true/false) angeben, ob die jeweilige Resource in der ARD Mediathek sichtbar sein soll oder nicht.

Notes In der application.yml muss nun angegeben werden, welche Dokumentstatusänderungen bei welchen Dokumenttypen im Metadata Supplier behandelt werden sollen. Siehe Dokumentation für weitere Informationen.

Notes Die ausführbare metadata-supplier-application-<version>.jar wurde in metadata-supplier-application-<version>-executable.jar umbenannt. Start-/Stop-Skripte, die diese jar ausführen, müssen dementsprechend angepasst werden. Auch die metadata-supplier-application.conf muss in metadata-supplier-application-executable.conf umbenannt werden, sofern vorhanden. Bei der metadata-supplier-application-<version>.jar handelt es sich jetzt stattdessen nur um das einfache Artefakt der metadata-supplier-application, welche für die Plugin-Entwicklung in einem Launcher-Projekt genutzt werden kann.

Notes Per metadata-supplier-sophora:sync-at-startup:false in der application.yml kann die initiale Synchronisation der Inhalte aus dem Sophora-Server abgeschaltet werden