Die dpa-Themenwelten sind Evergreen-Content, ihr Lifecycle ist auf eine möglichst lange Publikationsdauer ausgegelegt, worin sie sich von den vorwiegend tagesaktuellen Inhalten der dpa-WebLines unterscheiden. Das bringt redaktionell und technisch einige Besonderheiten hinsichtlich Auslieferung und Aktualisierung mit sich. Ein Überblick:


Inhaltsverzeichnis


Themenwelten-Besonderheiten


Belieferung

Nach initialer Aktivierung der Belieferung (also des wireQ-Endpunkts oder des s3push-Versands) erhalten Sie einmalig gesammelt alle verfügbaren Themenwelten-Artikel (initiale Belieferung). Anschließend werden nur noch solche Artikel übermittelt, an denen die Themenwelten-Redaktion Updates oder Änderungen vorgenommen hat. Entsprechend empfehlen wir, diese erste Kollektion von Artikeln wiederverwendbar abzuspeichern, um Artikel bei Tests oder technischen Änderungen nicht zu verlieren. 


Publikation

Artikel der dpa-Themenwelten sind daran erkennbar, dass im categories-Teil des dpa-digitalwires-Formats der entsprechende dpasrv im qcode auftaucht:

{
 "type": "dnltype:wire",
 "name": "themenwelten",
 "qcode": "dpasrv:themenwelten"
}


Themenwelten-Artikel zuordnen

Die Zuordnung eines Artikels zu einer konkretenThemenwelt erfolgt über einen Flextag. Dieser findet sich ebenfalls im categories-Teil:

{
 "type": "dnltype:flextag",
 "name": "Laufen",
 "qcode": "dpaflextag:pc.topic.laufen"
}

Der name gibt hierbei den Namen der Themenwelt an. Der qcode-Teil nach pc.topic. kann bspw. als URL-Slug für eine Themenseite verwendet werden   Beispiel: 

Jeder Themenwelten-Artikel ist anhand seiner urn (Schema: urn:newsml:dpa.com:20090101:xxxxx) eindeutig erkennbar. Aktualisiert die Redaktion einen Artikel, bleibt seine urn gleich, version und version_created machen den neuen Stand erkennbar.

Ein Überblick über alle Themenwelten-Artikel findet sich unter:

Unter den jeweiligen Artikeln steht das zugehörige dpa-digitalwires-JSON-Dokument zur Ansicht bereit.


Lebenszyklus der Artikel

Im Unterschied zu anderen dpa-Inhalten sind Artikel der dpa-Themenwelten Evergreen-Content. Das heißt: Ein Artikel gilt nicht nach einer gewissen Zeit als veraltet und sollte von der Webseite entfernt werden. Im Gegenteil: Themenwelten-Artikeln werden teils in Zyklen von mehreren Monaten aktualisiert und in der Zwischenzeit nicht erneut publiziert. 

Das Vorgehen dabei kann beispielhaft wie folgt aussehen:

  1. Artikel wird initial durch dpa publiziert
  2. Einen Monat nach Erstpublikation werden einige Bilder ausgetauscht und der Artikel erneut publiziert
  3. Nach einem halben Jahr werden einige Details im Artikel aktualisiert und dieser erneut publiziert

Diese Vorgehensweise muss beim Import in Ihr CMS entsprechend berücksichtig werden. Mögliche Probleme, für die ggf. technische oder redaktionelle Lösungsansätze nötig sind:

  • Themenwelten-Artikel werden nach einer bestimmten Zeit von der Webseite/aus dem CMS entfernt, sodass neue dpa-Versionen nicht mehr importiert werden können → Tipp: Entfernen von Themenwelten-Artikeln sollte verhindert werden
  • Themenwelten-Artikel werden von der Redaktion bearbeitet, sodass ein einfaches technisches Update durch neue dpa-Versionen nicht mehr möglich ist → Tipp: Falls die Redaktion Themenwelten-artikel bearbeitet, ist ein zusätzliches Monitoring/Benachrichtigungssystem für Updates durch die dpa-Redaktion nötig (z.B. Anlegen der neuen Artikelversion als Kopie im CMS, Benachrichtigung via Mail/Messenger, vgl. nächster Punkt).


Gründe für die erneute Publikation ermitteln

Informationen zur Ursache für das Update an einem Artikel und ggf. die bearbeiteten Abschnitte liefert der Notizblock im notepad-Teil des dpa-digitalwires-Formats. Unter public_html befindet sich der öffentliche Teil des Notizblocks im HTML-Format.

Ein Update durch die dpa-Redaktion ist daran erkennbar, dass die umschließende HTML-section mit einem <h4>Aktualisierung</h4> beginnt. Falls vorhanden, folgen in einer unsortierten Liste konkretere Angaben zur Ursache des Updates.

"public_html": "<section class=\"np-public\"><h4>Aktualisierung</h4><ul><li>Dieser Text wurde mit Blick auf die Umstellung auf Sommerzeit (26. März) aktualisiert.</li></ul><h4>Internet</h4><ul><li><a href=\"http://dpaq.de/fuS4d\">maiLab-Video: Was die Zeitumstellung mit deinem K\u00f6rper macht</a></li></ul></section>"


Web Components

Um die Inhalte bestmöglich aufzubereiten und die Aufenthaltsdauer auf den Artikeln zu erhöhen, enthalten Artikel der dpa-Themenwelten allerlei multimediale Komponenten. Dazu gehören aktuell: Social Media Embeds, interaktive Erklär- und Datengrafiken sowie im Artikel positionierte Bilder. Die Bestandteile werden technisch als Web Components ausgezeichnet. Sollen diese angezeigt werden, ist eine entsprechende Implementierung nötig.

Hierfür gibt es mehrere Möglichkeiten:

  • Web Components werden schon beim Import ins CMS umgewandelt und in die dortige Komponententechnologie übersetzt. Wir empfehlen dieses Vorgehen.
  • Web Components unverändert bis in die App oder auf die Webseite durchreichen und sie dort mit Hilfe von entsprechendem Code entfalten. 

Eine Referenzimplementierung für die einzelnen Web Components des dpa-newslabs ist auf Github als open-source veröffentlicht. Weitere Details finden sich auch im API-Portal.


Table of content

 Zur Erstellung einer Inhaltsübersicht können die Zwischenüberschriften <h2> verwendet werden. Werden diese mit einer id (z.B. <h2 id="1-wie-viele-läufer-gibt-es-in-deutschland">1. Wie viele Läufer gibt es in Deutschland?</h2>) versehen, können über dem Artikel Deeplinks zum jeweiligen Abschnitt angezeigt werden. Eine Beispielimplementierung steht auf Github bereit.


dpa-digitalwires-Grundlagen


Die URLs zu den Bildern eines Artikels sind signiert und haben ein Ablaufdatum von ca. 2 Tagen, s.a. Dokumentation der digital wires im dpa-API-Portal: 

Dies sollte ausreichen, um das Bild in das eigene CMS zu importieren. 

Vor allem für den Abruf der wireQ-API heißt das: Werden Artikel länger als 2 Tage in der Queue vorgehalten, werden die im digitalwires-JSON enthaltenen Bilderlinks ungültig.


Wie erkenne ich den neuesten Artikel

Ein Artikel wird inhaltlich anhand des Attributs urn identifiziert. Die neuste Version ergibt sich aus den Attributen version, version_created und updated. s.a. Dokumentation der digital wires im dpa-API-Portal: 

Im FAQ des API-Portal: 

haben wir versucht, wiederkehrende Fragen unserer Kunden zu beantworten. Es finden sich dort auch viele Einträge zum Thema: Wie finde ich die aktuellste Version eines Artikels.


Tipps zum Abruf mittels wireQ-API

Der wireQ-Feed ist eine Queue - kein Feed im klassischen Sinne. Diese Queue muss regelmäßig nicht nur abgerufen werden (GET), sondern auch geleert werden (DELETE). Alternativ bieten wir diesen Schritt auch über POST /dequeue-entries.json an.Haben sie bisher den Feed nur mit GET abgerufen, so sollten Sie Ihre Implementierung unbedingt anpassen!Als Hilfestellung haben wir dazu für unsere Kunden ein paar sehr hilfreiche Best-Practices auf Github veröffentlicht:

GET/DELETE:

POST: 

Noch ein kleiner Tipp zum Schluss - in der Referenzimplementierung werten wir auch den retry-after Header aus:


so können Sie im Fall von vielen Artikeln die Queue relativ schnell "abräumen".


Haben Sie weitere Fragen wenden Sie sich bitte an: service@dpa-info.com