AVTool Updates

Changelog

Covered issues for this module.

Version 5.5.8

– 6/16/25

Sophora Client API: 5.16.6.

  • Fixed
    Seitenverhältnisbildvariantenunterstützung – SOYCI-124 (high)
    Notes Es ist nun möglich in der "mediaconfig.xml" bei der "MediaTaggingConfiguration" das Property "podcastImageWidth" zu setzen.
    Bei bereits existierendem "YouTube Kanal"-Dokumenttyp muss bei Bedarf manuell die CND um " - 'sophora-extension:videoImageVariantWidth' (long)" erweitert werden, um das neue Property "Bildbreite für Seitenverhältnisbildvarianten" setzen zu können.
Version 5.5.7

– 6/13/25

Sophora Client API: 5.16.6.

  • Fixed
    Das AVTool muss beim Offline stellen von Dokumenten einen Akamai Purge triggern – SOYCI-128 (medium)
Version 5.5.6

– 6/3/25

Sophora Client API: 5.16.6.

  • Improved
    Lokale Symlinks mit relativen statt absoluten Pfaden anlegen – SOYCI-121 (high)
    Notes "localSymlinkTransporterFactory" erzeugt jetzt Symlinks mit relativen Pfaden anstatt absoluten.
Version 5.5.5

– 5/28/25

Sophora Client API: 5.16.5.

  • Improved
    AVTool Logging verbessern – SOYCI-122 (medium)
Version 5.5.4

– 5/21/25

Sophora Client API: 5.16.5.

  • Changed
    Update auf Spring-Boot 3.4 – SOYCI-117 (medium)
  • Changed
    Umstellung auf Java 21 – SOYCI-71 (medium)
Version 5.5.3

– 4/8/25

Sophora Client API: 5.15.1.

  • Fixed
    Fehler bei Verwendung von SFTPTransportern in Mediaservern behoben – SOYCI-109 (medium)
  • Fixed
    Probleme beim Tagging von MP3 Dateien behoben – SOYCI-107 (medium)
    Notes Die ID3-Tags (Album, Artist, Titel, Coverbild, ...) werden nun immer in der Version 2.4 abgespeichert statt standardmäßig in 2.3 und gelegentlich, falls bereits vorhanden, in 2.4.. Ebenso wird ein neues Text-Encoding verwendet, um u.a. Coverbildanzeigeprobleme zu verhindern.
  • Changed
    Tomcat aktualisiert – SOYCI-116 (medium)
  • Changed
    Tagging pro Dokument deaktivieren können – SOYCI-114 (medium)
    Notes Es wurde ein neues, in Skripten setzbares, Property eingeführt mit dem gesteuert werden kann ob Mediendateien eines Dokuments getaggt werden sollen oder nicht.
    Ist das Property "avtool:enableTagging" in einem Dokument "false" dann werden keine Mediendateien getaggt. Ist es "true" oder "null" (zwecks Abwärtskompatibilität) wird normal wie bisher getaggt.
  • Improved
    Logmeldungen im MediaTagger verbessern – SOYCI-113 (medium)
  • Added
    Symlinks im lokalen Dateisystem und über SFTP ermöglichen – SOYCI-96 (medium)
    Notes Es wurden 3 neue Transporterfactories eingeführt welche das Anlegen von Symlinks erlauben.

    SFTP:
    'protocolConformSFTPSymlinkTransporterFactory'
    'openSSHConformSFTPSymlinkTransporterFactory'
    Diese Transporter unterscheiden sich in der Reihenfolge der Paramter beim Anlegen der Symlinks. Der Grund dafür ist das die SFTP Spezifikation für das Anlegen von Symlinks von Openssh falsch implementiert wurde.
    Siehe: https://man.openbsd.org/sftp.1#ln und https://datatracker.ietf.org/doc/html/draft-ietf-secsh-filexfer-02#section-6.10
    In den meisten Fällen sollten die 'openSSHConformSFTPSymlinkTransporterFactory'. Wird jedoch ein Standardkonformer SFTP Server werdendet dann muss ggf. 'protocolConformSFTPSymlinkTransporterFactory' verwendet werden.

    Lokales Dateisystem:
    'localSymlinkTransporterFactory'

    Die Konfiguration von Media- und Streaming-Servern mit diesen Transportern funktioniert analog zu der Konfiguration von Akamai Symlink Transportern.
Version 5.5.2

– 2/13/25

Sophora Client API: 5.12.2.

  • Changed
    YoutubeChannelConfiguration-Systemdokumenttyp mit Tags-Feld in PromoteArea ausstatten – SOYCI-106 (medium)
    Notes Greift nur in Sophora-Repositories, in denen der AVTool-Nodetype (sophora-extention-nt:youtubeChannelConfiguration) noch nicht enthalten ist, aber importiert werden sollen. Vorhandene Nodetypekonfigurationen werden nicht überschrieben.
    Benötigt einen Server mit SOSI-5552 (Version 5.6.5 bzw. 6.0.0), da dieser die neue hier verwendete Formularfeldgruppe für den Promote-Tab von Systemdokumenttypen bereitstellt.
Version 5.5.1

– 1/27/25

Sophora Client API: 5.12.1.

Maintenance release / Sophora updates.

Version 5.5.0

– 1/27/25

Sophora Client API: 5.12.1.

  • Changed
    Das AVTool muss das neue Property "sophora:isPrePublishedRequired" beachten – SOYCI-104 (medium)
    Notes Das AVTool beachtet jetzt das Property 'sophora:isPrePublishRequired'.
    Wenn kein Wert gesetzt ist, wird das Property als 'true' interpretiert.
    In dem Fall wird also wie bisher nur berücksichtigt, ob das Mixin 'sophora-mix:prePublishRequired' vorhanden ist.
  • Changed
    Verarbeitung bestimmter Dokumente ignorieren (durch Präprozessorskripte) – SOYCI-100 (medium)
    Notes Das AVTool Dokumentenmodell ist um das Property 'avtool:skipProcessing' erweitert worden. Enthält dieses Property den Wert 'true' dann wird das AVTool das entsprechende Dokument nicht vom AVTool verarbeitet. Wenn das Property nicht existiert oder der Wert 'false' ist, dann wird das Dokument wie gewohnt verarbeitet.
Version 5.4.0

– 1/6/25

Sophora Client API: 5.12.0.

  • Added
    Datei als Ziel für Symlinks ermöglichen – SOYCI-94 (medium)
    Notes Das Erzeugen von Symlinks wird jetzt genau so gehandhabt wie normale Uploads.
    Daraus ergibt sich die Notwendigkeit einiger Konfigurationsanpassungen, wenn man das bisherige Verhalten zum Anlegen von Symlinks beibehalten möchte.
    Bisher gab es für das Anlegen von Symlinks dedizierte Konfigurationsparameter in der AkamaiServerDescription.
    Diese lauteten 'symlinkBaseDirectory' und 'symlinkFormatMapping'.
    Diese Parameter werden jetzt durch das normale 'basedir' und 'formatDirectoryMapping' abgebildet.
    Um dem AVTool nun mitzuteilen, dass diese Parameter für das Anlegen von Symlinks verwendet werden sollen (anstatt für den Upload der Dateien) kann man nun die 'akamaiNetStorageSymlinkTransporterFactory' bzw. die 'akamaiNetStorageSymlinkParentTransporterFactory' in der ServerDescription setzen.

    Bisher war es möglich, im 'symlinkFormatMapping' beliebige Dokumentproperties als Platzhalter in den Pfaden zu verwenden. Das war sehr fehleranfällig und wurde deshalb entfernt.
    Wenn dieses Feature verwendet wurde, sollten die Preprozessorskripte angepasst werden um die entsprechenden Pfade mit Hilfe der neuen 'avtool:targetPaths' und 'avtool:previousTargetPaths' Properties abgebildet werden.

    Darüber hinaus gibt es jetzt einen weiteren Konfigurationsparameter für Server. Das AVTool hat eine Optimierung, die einen Upload einer Mediendatei verhindert, wenn der MD5-Hash der Datei dem AVTool bereits bekannt ist. In diesem Fall hat das AVTool die Datei bereits früher hochgeladen und muss die Datei deshalb jetzt nicht nochmal hochladen.
    Der Nachteil dieser Optimierung ist jedoch, dass die Mediendateien immer erst vollständig heruntergeladen werden müssen, um den Hash zu bilden.
    In dem Anwendungsfall, dass das AVTool nur Symlinks oder als erstes Symlinks anlegen soll, ist aber auch der Download der Mediendateien überflüssig.
    Daher gibt es jetzt den Parameter 'ignoreFileDigestCheckBeforeUpload'. Ist dieser 'true' wird dieser Check übersprungen und somit ggf. auch komplett auf den Download verzichtet.
    Der Defaultwert des Parameters ist 'false'. Es empfiehlt sich, den Parameter nur in Kombination mit 'akamaiNetStorageSymlinkTransporterFactory' oder 'akamaiNetStorageSymlinkParentTransporterFactory' zu verwenden, da andere Transporter sowieso auf den Download der Dateien angewiesen sind.
    Wenn man Symlinks und Uploads im Mischbetrieb verwenden möchte, sollten die ServerDescriptions welche Symlinks anlegen, möglichst als Erstes in der Konfiguration stehen. Dann werden die Symlinks sofort abgearbeitet und erst danach für echte Uploads werden die Mediendateien downgeloadet.
  • Added
    Unterstützung mehrerer Zielnamen pro Quelldatei – SOYCI-93 (medium)
    Notes Es ist jetzt möglich, Mediendateien zu mehreren Zielpfaden hochzuladen/zu löschen.
    Dazu wurde das Dokumentenmodell von 'avtool-nt:file' um die Properties 'avtool:targetPaths' und 'avtool:previousTargetPaths' erweitert.
    Beide Properties sind String Multiwerte.

    Beim Veröffentlichen wird das AVTool nun die jeweilige Mediendatei zu allen Pfaden in 'avtool:targetPaths' hochgeladen und von allen Pfaden in 'avtool:previousTargetPaths' entfernt.
    Beim Offline stellen wird das AVTool die Datei sowohl von den Pfaden in 'avtool:targetPaths' als auch in 'avtool:previousTargetPaths' entfernen.
    Konkret werden die '{filename}' Platzhalter in der 'formatDirectoryMapping' Konfigurationen jetzt durch die Pfade in den neuen Properties ersetzt.
    Wenn der Platzhalter nicht vorkommt, werden die Pfade an das konfigurierte Template angehängt.

    Um Abwärtskompatibilität zu wahren und die Preprozessorskripte möglichst einfach zu halten, ist 'MediaFileChildNode' um den neuen Konstruktor 'MediaFileChildNode(String name, String sequence, String format, List<String> targetPaths, List<String> previousTargetPaths)' erweitert worden.
    Der alte Konstruktor existiert weiterhin. Wird dieser verwendet gilt: targetPaths = {name} und previousTargetPaths = {}.
Version 5.3.1

– 11/21/24

Sophora Client API: 5.10.0.

Maintenance release / Sophora updates.

Version 5.3.0

– 11/21/24

Sophora Client API: 5.10.0.

  • Fixed
    ParentPodcastFinder soll nur Referenzen abfragen für die es eine Konfiguration gibt – SOYCI-99 (medium)
  • Changed
    AVTool Refactoring – SOYCI-91 (medium)
    Notes Bei der Bean "com.subshell.sophora.avtool.podcast.api.PodcastDocumentDescription" muss das Property "childNodes" zu "childNodeFormats" umbenannt werden. Der Wert bleibt gleich.
Version 5.2.0

– 11/12/24

Sophora Client API: 5.9.0.

  • Fixed
    Der DocumentPublisher muss ein abgebrochenes PrePublish erkennen – SOYCI-92 (medium)
  • Changed
    Die AVTools zu einem Produkt zusammenführen – SOYCI-85 (medium)
    Notes com.subshell.sophora.avtool.ndr.api.FormatSuffixMapping wurde zu com.subshell.sophora.avtool.app.api.FormatSuffixMapping umbenannt.
Version 5.1.0

– 10/1/24

Sophora Client API: 5.7.3.

  • Changed
    Update auf Spring 6.1 und Spring Boot 3.2 – SOYCI-80 (medium)
  • Added
    MP3 Tagging für das AVTool in eigenes Projekt auslagern – SOYCI-87 (medium)
    Notes Konfigurationsänderung: Der Konfigurationsparamerter mp4TagsNdrMapping wurde umbenannt zu mp4TagsMapping.
    Die Bean Klasse com.subshell.sophora.avtool.ndr.api.MediaTaggingConfiguration wurde umbenannt zu com.subshell.sophora.avtool.mediatagging.api.MediaTaggingConfiguration.
    Die Bean Klasse com.subshell.sophora.avtool.ndr.api.ChapterTaggingConfiguration wurde umbenannt zu com.subshell.sophora.avtool.mediatagging.api.ChapterTaggingConfiguration.
  • Added
    Podcastlogik für das AVTool in eigenes Projekt auslagern – SOYCI-86 (medium)
    Notes Konfigurationsänderung: Die Bean Klasse com.subshell.sophora.avtool.ndr.api.PodcastDocumentDescription wurde umbenannt zu com.subshell.sophora.avtool.podcast.api.PodcastDocumentDescription.
Version 5.0.4

– 7/3/24

Sophora Client API: 5.5.0.

Maintenance release / Sophora updates.

Version 5.0.3

– 6/27/24

Sophora Client API: 5.5.0.

Maintenance release / Sophora updates.

Version 5.0.2

– 6/18/24

Sophora Client API: 5.4.0.

  • Changed
    AV-Tool: Erweiterung zur Ausspielung von tagesschau in einfacher Sprache auf Youtube – SOYCI-77 (high)
Version 5.0.1

– 4/12/24

Sophora Client API: 5.0.0.

  • Changed
    Neues Videoformat "thirdParty1080" zum NDR-AudioVideoDocumentNormalization.groovy hinzufügen – SOYCI-74 (high)
Version 5.0.0

– 3/12/24

Sophora Client API: 5.0.0.

  • Fixed
    YouTube-Autorisation muss dauerhaft funktionieren – SOYCI-59 (critical)
    Notes Der Tab "YouTube Autorisierung" muss als URL nun den Pfad "/api/oauth2/status/youtube" verwenden.

    Das Feld "AuthCode" kann aus der Formularfeldgruppe "Zugangsdaten" entfernt werden. Ist in einer mediaconfig.xml noch '<property name="authCode"' vorhanden muss es entfernt werden.
  • Fixed
    YouTube Authentifizierung muss auch mit Partner-Accounts funktionieren – SOYCI-57 (critical)
    Notes Falls in der mediaconfig.xml ein `YouTubeContentPartner`-Bean erzeugt wird, dann muss dies angepasst werden. Dort wird nun eine `YoutubeContentPartnerConfig` gesetzt statt einzelner Werte.
  • Fixed
    AV-Tool: NPE beim Youtube Video-Upload – SOYCI-66 (medium)
  • Fixed
    Dokumente in PrePublish sollen am Ende immer im Status Published sein – SOYCI-63 (medium)
    Notes Dokumente mit dem Mixin `sophora-mix:prePublishRequired` werden nur dann veröffentlicht, wenn das Dokument nach der Verarbeitung durch das AVTool noch immer im Status "PRE_PUBLISHED" ist. Falls dies nicht mehr der Fall ist wird der Dokumentstatus nicht geändert.
  • Fixed
    JMX API (MBeans) des AVTool muss zugreifbar sein – SOYCI-55 (medium)
  • Fixed
    Beim Upload von lokalisierten Texten muss immer die Standardsprache gesetzt sein – SOYCI-34 (medium)
  • Fixed
    Bei Aktualisierungen von Titel und Beschreibung muss auch der lokalisierte Text der Standardsprache angepasst werden – SOYCI-30 (medium)
  • Fixed
    AVTool: YouTubeIntegrationTest schlägt manchmal fehl – SOYCI-28 (medium)
  • Changed
    Authorisierung für YouTube-Kanäle auf Web-App-Flow umstellen – SOYCI-53 (critical)
    Notes Die YouTube-/Google-Credentials müssen neu erstellt werden, siehe Dokumentation für die notwendigen Schritte: https://subshell.com/docs/4/youtubeconnector/youtubeconnector106.html#Authentication-OAuth. Die neuen Credentials müssen dann in der Konfiguration des jeweiligen YouTube-Channels eingetragen werden.

    Wenn der AVTool-User die Berechtigungen hat, dann legt das AVTool beim Start einen Tab "YouTube Autorisierung" im Dokumenttyp "YouTube Kanal" an. Bitte prüfen Sie, ob die richtige URL zum YouTube-Connector eingetragen wurde. Alternativ legen Sie selbst diesen Tab vom Typ "Browser" an. Die URL muss folgendes Schema haben, wobei die Werte in spitzen Klammern ersetzt werden müssen: http://<hostname>:<serverPort>/api/oauth2/start/youtube?channelId=${sophora-extension:id}. Ggf. brauchen noch administrative Rollen Leserechte für diesen Tab, damit er im Editor sichtbar ist. Für YouTube-Accounts "in production" muss HTTPS verwendet werden. Falls dies noch nicht der Fall ist, muss in der application.yaml SSL konfiguriert werden und die URL im Tab auf HTTPS angepasst werden.

    Das Spring Profil "youtube" muss aktiv sein für den YouTube-Upload (ist es per Default). Dazu muss ggf. die application.yml angepasst werden, falls dort explizit Profile gesetzt wurden:

    <pre>spring.profiles.active = client, jobmanager, jmx, streaming, youtube</pre>
  • Changed
    Anpassungen für Java 17 – SOYCI-65 (medium)
  • Changed
    Länge von Untertiteln ändern – SOYCI-43 (medium)
  • Changed
    Länge von Videos zugänglich machen – SOYCI-42 (medium)
  • Changed
    Untertitelzeiten des Hauptvideos um Länge eines möglichen Intros anpassen – SOYCI-41 (medium)
  • Changed
    Konfiguration mehrerer Medienserver ermöglichen – SOYCI-38 (medium)
    Notes In der mediaconfig.xml muss ab jetzt eine Liste für die Medienserver angegeben werden: <util:list id="mediaServerDescriptionList">...</util:list> muss um das <bean id="mediaServerDescription" ...> herum eingefügt werden.
  • Improved
    YouTube-OAuth soll auch externe Redirect-URLs nutzen können – SOYCI-60 (high)
  • Improved
    Performanz-Optimierung: Zeit zum Hinzufügen von Einträgen darf nicht mehr linear wachsen und Stunden hinterherhängen – SOYCI-56 (high)
  • Improved
    AV-Tool: Für jeden Purge-Typ soll eine Zeitverzögerung eingestellt werden können – SOYCI-51 (medium)
  • Improved
    YouTube Libraries aktualisieren – SOYCI-45 (medium)
  • Added
    AV-Tool: Akamai-Purging via Tags ermöglichen – SOYCI-33 (blocker)
    Notes The configuration property "akamaiUrlPrefixes" has been deprecated with version 3.1.0 and 4.1.0 of the AV-Tool/YouTube-Connector and will be removed with 5.0.0. Use "akamaiUrlPatterns" instead.

    It is also now possible to do (additional) Akamai purge requests for tags. If you want to know how to adapt your configuration, please consult the official documentation of the YouTube-Connector.
  • Added
    Angebot erstellen, wenn Fehler beim Verarbeiten eines Dokuments auftreten – SOYCI-37 (high)
  • Added
    Erweiterung des NDR-A/V-Tools um das Ansprechen der Netstorage-API beim Veröffentlichen und Depublizieren von Inhalten – SOYCI-48 (medium)
  • Added
    Dokumenttyp „YouTube-Intro/Outro“ schaffen und Videodokumenttyp anpassen – SOYCI-40 (medium)
    Notes Es wird ein neuer Dokumenttyp "YouTube-Intro/Outro" angelegt, nachdem der YouTube Connector gestartet wurde. Dokumente von diesem Typ enthalten einen Namen und eine Verknüpfung zu einem Intro- und einem Outro-(Video-)Dokument. Um "YouTube-Intro/Outro"-Dokumente in Videos verwenden zu können, muss das Mixin "sophora-extension-mix:introOutroSet" dem Videodokumenttyp hinzugefügt werden und das Property "sophora-extension:introOutroSet" auf einem Tab platziert werden. Um nur Videodokumente als Intro/Outro zuzulassen muss die Validierung für die Properties "sophora-extension:introDocument"/"sophora-extension:outroDocument" um den eigenen Videodokumenttyp ergänzt werden.
  • Added
    YouTube-Connector um Intro-/Outro-Mechanik erweitern – SOYCI-39 (medium)
    Notes A new property 'openerCloser.cache.dir' defines the folder in which intro/outro video files will be cached locally. By default it is in the working folder in the folder "openerCloserCache".
Version 4.10.5

– 6/13/25

Sophora Client API: 4.36.4.

  • Fixed
    Das AVTool muss beim Offline stellen von Dokumenten einen Akamai Purge triggern – SOYCI-128 (medium)
Version 4.10.4

– 6/3/25

Sophora Client API: 4.36.4.

  • Improved
    Lokale Symlinks mit relativen statt absoluten Pfaden anlegen – SOYCI-121 (high)
    Notes "localSymlinkTransporterFactory" erzeugt jetzt Symlinks mit relativen Pfaden anstatt absoluten.
Version 4.10.3

– 5/28/25

Sophora Client API: 4.36.4.

  • Improved
    AVTool Logging verbessern – SOYCI-122 (medium)
Version 4.10.2

– 4/14/25

Sophora Client API: 4.36.3.

  • Changed
    Tagging pro Dokument deaktivieren können – SOYCI-114 (medium)
    Notes Es wurde ein neues, in Skripten setzbares, Property eingeführt mit dem gesteuert werden kann ob Mediendateien eines Dokuments getaggt werden sollen oder nicht.
    Ist das Property "avtool:enableTagging" in einem Dokument "false" dann werden keine Mediendateien getaggt. Ist es "true" oder "null" (zwecks Abwärtskompatibilität) wird normal wie bisher getaggt.
  • Improved
    Logmeldungen im MediaTagger verbessern – SOYCI-113 (medium)
Version 4.10.1

– 4/8/25

Sophora Client API: 4.36.3.

  • Fixed
    Fehler bei Verwendung von SFTPTransportern in Mediaservern behoben – SOYCI-109 (medium)
  • Fixed
    Probleme beim Tagging von MP3 Dateien behoben – SOYCI-107 (medium)
    Notes Die ID3-Tags (Album, Artist, Titel, Coverbild, ...) werden nun immer in der Version 2.4 abgespeichert statt standardmäßig in 2.3 und gelegentlich, falls bereits vorhanden, in 2.4.. Ebenso wird ein neues Text-Encoding verwendet, um u.a. Coverbildanzeigeprobleme zu verhindern.
  • Changed
    Tomcat aktualisiert – SOYCI-116 (medium)
  • Added
    Symlinks im lokalen Dateisystem und über SFTP ermöglichen – SOYCI-96 (medium)
    Notes Es wurden 3 neue Transporterfactories eingeführt welche das Anlegen von Symlinks erlauben.

    SFTP:
    'protocolConformSFTPSymlinkTransporterFactory'
    'openSSHConformSFTPSymlinkTransporterFactory'
    Diese Transporter unterscheiden sich in der Reihenfolge der Paramter beim Anlegen der Symlinks. Der Grund dafür ist das die SFTP Spezifikation für das Anlegen von Symlinks von Openssh falsch implementiert wurde.
    Siehe: https://man.openbsd.org/sftp.1#ln und https://datatracker.ietf.org/doc/html/draft-ietf-secsh-filexfer-02#section-6.10
    In den meisten Fällen sollten die 'openSSHConformSFTPSymlinkTransporterFactory'. Wird jedoch ein Standardkonformer SFTP Server werdendet dann muss ggf. 'protocolConformSFTPSymlinkTransporterFactory' verwendet werden.

    Lokales Dateisystem:
    'localSymlinkTransporterFactory'

    Die Konfiguration von Media- und Streaming-Servern mit diesen Transportern funktioniert analog zu der Konfiguration von Akamai Symlink Transportern.
Version 4.10.0

– 1/6/25

Sophora Client API: 4.34.10.

  • Added
    Datei als Ziel für Symlinks ermöglichen – SOYCI-94 (medium)
    Notes Das Erzeugen von Symlinks wird jetzt genau so gehandhabt wie normale Uploads.
    Daraus ergibt sich die Notwendigkeit einiger Konfigurationsanpassungen, wenn man das bisherige Verhalten zum Anlegen von Symlinks beibehalten möchte.
    Bisher gab es für das Anlegen von Symlinks dedizierte Konfigurationsparameter in der AkamaiServerDescription.
    Diese lauteten 'symlinkBaseDirectory' und 'symlinkFormatMapping'.
    Diese Parameter werden jetzt durch das normale 'basedir' und 'formatDirectoryMapping' abgebildet.
    Um dem AVTool nun mitzuteilen, dass diese Parameter für das Anlegen von Symlinks verwendet werden sollen (anstatt für den Upload der Dateien) kann man nun die 'akamaiNetStorageSymlinkTransporterFactory' bzw. die 'akamaiNetStorageSymlinkParentTransporterFactory' in der ServerDescription setzen.

    Bisher war es möglich, im 'symlinkFormatMapping' beliebige Dokumentproperties als Platzhalter in den Pfaden zu verwenden. Das war sehr fehleranfällig und wurde deshalb entfernt.
    Wenn dieses Feature verwendet wurde, sollten die Preprozessorskripte angepasst werden um die entsprechenden Pfade mit Hilfe der neuen 'avtool:targetPaths' und 'avtool:previousTargetPaths' Properties abgebildet werden.

    Darüber hinaus gibt es jetzt einen weiteren Konfigurationsparameter für Server. Das AVTool hat eine Optimierung, die einen Upload einer Mediendatei verhindert, wenn der MD5-Hash der Datei dem AVTool bereits bekannt ist. In diesem Fall hat das AVTool die Datei bereits früher hochgeladen und muss die Datei deshalb jetzt nicht nochmal hochladen.
    Der Nachteil dieser Optimierung ist jedoch, dass die Mediendateien immer erst vollständig heruntergeladen werden müssen, um den Hash zu bilden.
    In dem Anwendungsfall, dass das AVTool nur Symlinks oder als erstes Symlinks anlegen soll, ist aber auch der Download der Mediendateien überflüssig.
    Daher gibt es jetzt den Parameter 'ignoreFileDigestCheckBeforeUpload'. Ist dieser 'true' wird dieser Check übersprungen und somit ggf. auch komplett auf den Download verzichtet.
    Der Defaultwert des Parameters ist 'false'. Es empfiehlt sich, den Parameter nur in Kombination mit 'akamaiNetStorageSymlinkTransporterFactory' oder 'akamaiNetStorageSymlinkParentTransporterFactory' zu verwenden, da andere Transporter sowieso auf den Download der Dateien angewiesen sind.
    Wenn man Symlinks und Uploads im Mischbetrieb verwenden möchte, sollten die ServerDescriptions welche Symlinks anlegen, möglichst als Erstes in der Konfiguration stehen. Dann werden die Symlinks sofort abgearbeitet und erst danach für echte Uploads werden die Mediendateien downgeloadet.
  • Added
    Unterstützung mehrerer Zielnamen pro Quelldatei – SOYCI-93 (medium)
    Notes Es ist jetzt möglich, Mediendateien zu mehreren Zielpfaden hochzuladen/zu löschen.
    Dazu wurde das Dokumentenmodell von 'avtool-nt:file' um die Properties 'avtool:targetPaths' und 'avtool:previousTargetPaths' erweitert.
    Beide Properties sind String Multiwerte.

    Beim Veröffentlichen wird das AVTool nun die jeweilige Mediendatei zu allen Pfaden in 'avtool:targetPaths' hochgeladen und von allen Pfaden in 'avtool:previousTargetPaths' entfernt.
    Beim Offline stellen wird das AVTool die Datei sowohl von den Pfaden in 'avtool:targetPaths' als auch in 'avtool:previousTargetPaths' entfernen.
    Konkret werden die '{filename}' Platzhalter in der 'formatDirectoryMapping' Konfigurationen jetzt durch die Pfade in den neuen Properties ersetzt.
    Wenn der Platzhalter nicht vorkommt, werden die Pfade an das konfigurierte Template angehängt.

    Um Abwärtskompatibilität zu wahren und die Preprozessorskripte möglichst einfach zu halten, ist 'MediaFileChildNode' um den neuen Konstruktor 'MediaFileChildNode(String name, String sequence, String format, List<String> targetPaths, List<String> previousTargetPaths)' erweitert worden.
    Der alte Konstruktor existiert weiterhin. Wird dieser verwendet gilt: targetPaths = {name} und previousTargetPaths = {}.
Version 4.9.0

– 11/21/24

Sophora Client API: 4.34.9.

  • Fixed
    ParentPodcastFinder soll nur Referenzen abfragen für die es eine Konfiguration gibt – SOYCI-99 (medium)
  • Changed
    AVTool Refactoring – SOYCI-91 (medium)
    Notes Bei der Bean "com.subshell.sophora.avtool.podcast.api.PodcastDocumentDescription" muss das Property "childNodes" zu "childNodeFormats" umbenannt werden. Der Wert bleibt gleich.
Version 4.8.0

– 11/12/24

Sophora Client API: 4.34.8.

  • Fixed
    Der DocumentPublisher muss ein abgebrochenes PrePublish erkennen – SOYCI-92 (medium)
  • Changed
    Die AVTools zu einem Produkt zusammenführen – SOYCI-85 (medium)
    Notes com.subshell.sophora.avtool.ndr.api.FormatSuffixMapping wurde zu com.subshell.sophora.avtool.app.api.FormatSuffixMapping umbenannt.
  • Added
    MP3 Tagging für das AVTool in eigenes Projekt auslagern – SOYCI-87 (medium)
    Notes Konfigurationsänderung: Der Konfigurationsparamerter mp4TagsNdrMapping wurde umbenannt zu mp4TagsMapping.
    Die Bean Klasse com.subshell.sophora.avtool.ndr.api.MediaTaggingConfiguration wurde umbenannt zu com.subshell.sophora.avtool.mediatagging.api.MediaTaggingConfiguration.
    Die Bean Klasse com.subshell.sophora.avtool.ndr.api.ChapterTaggingConfiguration wurde umbenannt zu com.subshell.sophora.avtool.mediatagging.api.ChapterTaggingConfiguration.
  • Added
    Podcastlogik für das AVTool in eigenes Projekt auslagern – SOYCI-86 (medium)
    Notes Konfigurationsänderung: Die Bean Klasse com.subshell.sophora.avtool.ndr.api.PodcastDocumentDescription wurde umbenannt zu com.subshell.sophora.avtool.podcast.api.PodcastDocumentDescription.
Version 4.7.7

– 7/3/24

Sophora Client API: 4.34.0.

Maintenance release / Sophora updates.

Version 4.7.6

– 6/27/24

Sophora Client API: 4.34.0.

Maintenance release / Sophora updates.

Version 4.7.5

– 6/18/24

Sophora Client API: 4.32.0.

  • Changed
    AV-Tool: Erweiterung zur Ausspielung von tagesschau in einfacher Sprache auf Youtube – SOYCI-77 (high)
Version 4.7.4

– 4/12/24

Sophora Client API: 4.29.0.

  • Changed
    Neues Videoformat "thirdParty1080" zum NDR-AudioVideoDocumentNormalization.groovy hinzufügen – SOYCI-74 (high)
Version 4.7.3

– 2/26/24

Sophora Client API: 4.27.3.

  • Fixed
    Kompatibilität mit aktueller Sophora Base POM – SOYCI-73 (blocker)
  • Changed
    Update auf Spring-Boot-Dependencies 2.7.17 und Kotlin 1.9.20 – SOYCI-70 (medium)
Version 4.7.2

– 11/15/23

Sophora Client API: 4.24.0.

  • Fixed
    AV-Tool: NPE beim Youtube Video-Upload – SOYCI-66 (medium)
Version 4.7.0

– 4/26/23

Maintenance release / Sophora updates.

Version 4.6.6

– 4/20/23

Sophora Client: 4.16.0.

Maintenance release / Sophora updates.

Version 4.6.5

– 3/16/23

Sophora Client: 4.16.0.

Maintenance release / Sophora updates.

Version 4.6.4

– 2/23/23

Sophora API: 4.15.1. Sophora Client: 4.15.1.

Maintenance release / Sophora updates.

Version 4.6.3

– 2/22/23

Sophora API: 4.15.1. Sophora Client: 4.15.1.

Maintenance release / Sophora updates.

Version 4.6.2

– 2/16/23

Sophora Client: 4.15.0.

  • Fixed
    Dokumente in PrePublish sollen am Ende immer im Status Published sein – SOYCI-63 (medium)
    Notes Dokumente mit dem Mixin `sophora-mix:prePublishRequired` werden nur dann veröffentlicht, wenn das Dokument nach der Verarbeitung durch das AVTool noch immer im Status "PRE_PUBLISHED" ist. Falls dies nicht mehr der Fall ist wird der Dokumentstatus nicht geändert.
Version 4.6.1

– 1/19/23

Sophora API: 4.14.6. Sophora Client: 4.14.6.

  • Improved
    Performanz-Optimierung: Zeit zum Hinzufügen von Einträgen darf nicht mehr linear wachsen und Stunden hinterherhängen – SOYCI-56 (high)
Version 4.6.0

– 10/17/22

Sophora API: 4.14.2. Sophora Client: 4.14.2.

  • Fixed
    JMX API (MBeans) des AVTool muss zugreifbar sein – SOYCI-55 (medium)
  • Changed
    SFTP-Client updaten, um aktuelle OpenSSH-Server zu unterstützen – SOYCI-61 (medium)
    Notes With this version of the YouTube Connector, the outdated ssh-rsa will not be supported anymore by default. You will either need to update your server (SFTP target) to support ssh-rsa2 or add the following Java options to your .conf file to re-enable ssh-rsa:
    "-Djsch.server_host_key=...,ssh-rsa -Djsch.client_pubkey=...,ssh-rsa"
Version 4.5.4

– 10/4/22

Sophora Client: 4.10.0.

Maintenance release / Sophora updates.

Version 4.5.3

– 9/29/22

Sophora Client: 4.10.0.

  • Improved
    YouTube-OAuth soll auch externe Redirect-URLs nutzen können – SOYCI-60 (high)
Version 4.5.2

– 9/27/22

Sophora Client: 4.10.0.

  • Fixed
    YouTube-Autorisation muss dauerhaft funktionieren – SOYCI-59 (critical)
    Notes Der Tab "YouTube Autorisierung" muss als URL nun den Pfad "/api/oauth2/status/youtube" verwenden.

    Das Feld "AuthCode" kann aus der Formularfeldgruppe "Zugangsdaten" entfernt werden. Ist in einer mediaconfig.xml noch '<property name="authCode"' vorhanden muss es entfernt werden.
Version 4.5.1

– 9/22/22

Sophora Client: 4.10.0.

  • Fixed
    YouTube Authentifizierung muss auch mit Partner-Accounts funktionieren – SOYCI-57 (critical)
    Notes Falls in der mediaconfig.xml ein `YouTubeContentPartner`-Bean erzeugt wird, dann muss dies angepasst werden. Dort wird nun eine `YoutubeContentPartnerConfig` gesetzt statt einzelner Werte.
Version 4.5.0

– 9/12/22

  • Changed
    Authorisierung für YouTube-Kanäle auf Web-App-Flow umstellen – SOYCI-53 (critical)
    Notes Die YouTube-/Google-Credentials müssen neu erstellt werden, siehe Dokumentation für die notwendigen Schritte: https://subshell.com/docs/4/youtubeconnector/youtubeconnector106.html#Authentication-OAuth. Die neuen Credentials müssen dann in der Konfiguration des jeweiligen YouTube-Channels eingetragen werden.

    Wenn der AVTool-User die Berechtigungen hat, dann legt das AVTool beim Start einen Tab "YouTube Autorisierung" im Dokumenttyp "YouTube Kanal" an. Bitte prüfen Sie, ob die richtige URL zum YouTube-Connector eingetragen wurde. Alternativ legen Sie selbst diesen Tab vom Typ "Browser" an. Die URL muss folgendes Schema haben, wobei die Werte in spitzen Klammern ersetzt werden müssen: http://<hostname>:<serverPort>/api/oauth2/start/youtube?channelId=${sophora-extension:id}. Ggf. brauchen noch administrative Rollen Leserechte für diesen Tab, damit er im Editor sichtbar ist. Für YouTube-Accounts "in production" muss HTTPS verwendet werden. Falls dies noch nicht der Fall ist, muss in der application.yaml SSL konfiguriert werden und die URL im Tab auf HTTPS angepasst werden.

    Das Spring Profil "youtube" muss aktiv sein für den YouTube-Upload (ist es per Default). Dazu muss ggf. die application.yml angepasst werden, falls dort explizit Profile gesetzt wurden:

    <pre>spring.profiles.active = client, jobmanager, jmx, streaming, youtube</pre>
Version 4.4.3

– 6/7/22

Sophora Client: 4.10.0.

Maintenance release / Sophora updates.

Version 4.4.2

– 5/24/22

Sophora Client: 4.10.0.

  • Improved
    AV-Tool: Für jeden Purge-Typ soll eine Zeitverzögerung eingestellt werden können – SOYCI-51 (medium)
Version 4.4.1

– 5/17/22

Maintenance release / Sophora updates.

Version 4.4.0

– 5/16/22

Maintenance release / Sophora updates.

Version 4.3.2

– 5/9/22

Sophora Client: 4.10.0.

  • Added
    Erweiterung des NDR-A/V-Tools um das Ansprechen der Netstorage-API beim Veröffentlichen und Depublizieren von Inhalten – SOYCI-48 (medium)
Version 4.3.1

– 3/11/22

Sophora Client: 4.0.0.

  • Fixed
    Es müssen auch nach einem YouTube-Upload mit den neuen Verpackungen noch alle Formate auf Streamingserver übertragen werden – SOYCI-46 (critical)
Version 4.3.0

– 3/3/22

Sophora Client: 4.0.0.

  • Changed
    Länge von Untertiteln ändern – SOYCI-43 (medium)
  • Changed
    Länge von Videos zugänglich machen – SOYCI-42 (medium)
  • Changed
    Untertitelzeiten des Hauptvideos um Länge eines möglichen Intros anpassen – SOYCI-41 (medium)
  • Improved
    YouTube Libraries aktualisieren – SOYCI-45 (medium)
  • Added
    Dokumenttyp „YouTube-Intro/Outro“ schaffen und Videodokumenttyp anpassen – SOYCI-40 (medium)
    Notes Es wird ein neuer Dokumenttyp "YouTube-Intro/Outro" angelegt, nachdem der YouTube Connector gestartet wurde. Dokumente von diesem Typ enthalten einen Namen und eine Verknüpfung zu einem Intro- und einem Outro-(Video-)Dokument. Um "YouTube-Intro/Outro"-Dokumente in Videos verwenden zu können, muss das Mixin "sophora-extension-mix:introOutroSet" dem Videodokumenttyp hinzugefügt werden und das Property "sophora-extension:introOutroSet" auf einem Tab platziert werden. Um nur Videodokumente als Intro/Outro zuzulassen muss die Validierung für die Properties "sophora-extension:introDocument"/"sophora-extension:outroDocument" um den eigenen Videodokumenttyp ergänzt werden.
  • Added
    YouTube-Connector um Intro-/Outro-Mechanik erweitern – SOYCI-39 (medium)
    Notes A new property 'openerCloser.cache.dir' defines the folder in which intro/outro video files will be cached locally. By default it is in the working folder in the folder "openerCloserCache".
Version 4.2.0

– 1/17/22

Sophora Client: 4.0.0.

  • Changed
    Konfiguration mehrerer Medienserver ermöglichen – SOYCI-38 (medium)
    Notes In der mediaconfig.xml muss ab jetzt eine Liste für die Medienserver angegeben werden: <util:list id="mediaServerDescriptionList">...</util:list> muss um das <bean id="mediaServerDescription" ...> herum eingefügt werden.
Version 4.1.6

– 1/5/22

Sophora Client: 4.0.0.

Maintenance release / Sophora updates.

Version 4.1.5

– 12/15/21

Sophora Client: 4.0.0.

Maintenance release / Sophora updates.

Version 4.1.4

– 12/13/21

Sophora Client: 4.0.0.

Maintenance release / Sophora updates.

Version 4.1.3

– 11/26/21

Sophora Client: 4.0.0.

Maintenance release / Sophora updates.

Version 4.1.2

– 11/11/21

Sophora Client: 4.0.0.

  • Added
    Angebot erstellen, wenn Fehler beim Verarbeiten eines Dokuments auftreten – SOYCI-37 (high)
Version 4.1.1

– 10/7/21

Sophora Client: 4.0.0.

  • Fixed
    Beim Upload von lokalisierten Texten muss immer die Standardsprache gesetzt sein – SOYCI-34 (medium)
Version 4.1.0

– 8/31/21

Sophora Client: 4.0.0.

  • Added
    AV-Tool: Akamai-Purging via Tags ermöglichen – SOYCI-33 (blocker)
    Notes The configuration property "akamaiUrlPrefixes" has been deprecated with version 3.1.0 and 4.1.0 of the AV-Tool/YouTube-Connector and will be removed with 5.0.0. Use "akamaiUrlPatterns" instead.

    It is also now possible to do (additional) Akamai purge requests for tags. If you want to know how to adapt your configuration, please consult the official documentation of the YouTube-Connector.
Version 4.0.1

– 3/17/21

Sophora Client: 4.0.0.

  • Fixed
    Bei Aktualisierungen von Titel und Beschreibung muss auch der lokalisierte Text der Standardsprache angepasst werden – SOYCI-30 (medium)
  • Fixed
    AVTool: YouTubeIntegrationTest schlägt manchmal fehl – SOYCI-28 (medium)
Version 4.0.0

– 9/30/20

Sophora Client: 4.0.0.

  • Changed
    Gelöschte Sophora-Dokumente mit niedrigerer Priorität verarbeiten – SOYCI-25 (medium)
  • Changed
    Deprecation-Warning im AV-Tool beheben – SOYCI-21 (medium)
  • Added
    Das Akamai-Handling in den YouTube-Connector integrieren – SOYCI-24 (medium)
    Notes If you don't already have an entry for the "streamingServerDescriptionList" in your "mediaconfig.xml", you need to add the following entry:
    <util:list id="streamingServerDescriptionList" />

Last modified on 11/14/24

The content of this page is licensed under the CC BY 4.0 License. Code samples are licensed under the MIT License.

Icon