PEIQ Knowledge Base

Übergabe nach Online

Im Reiter “Metadaten und Kanalsteuerung” der gedockten Werkzeugleiste können Benutzer:innen pro Ausprägung die gewünschten, je nach Template zur Verfügung stehenden Online-Publikationskanäle inkl. weiterer wichtiger Metadaten definieren. Mithilfe der Buttons “Publizieren“, “Depublizieren“ und “Erneut bearbeiten“ können die jeweiligen Inhalte samt Metadaten anschließend veröffentlicht bzw. zurückgenommen oder aktualisiert werden, womit auch der Kanalstatus der Ausprägung entsprechend angepasst wird.

Funktionalitäten der Übergabe nach Online in PEIQ CREATE

  • Steuerung der Übergabe zwischen PEIQ und Fremdsystemen mithilfe eines kanalspezifischen Statusstufen-Konzeptes und kanalspezifischen Metadaten

  • Publizieren des Kanals “Online” per 1-Klick

  • Abfragen/Aktualisieren von in CREATE publizierten Inhalten via CREATE API

Inhaltsverzeichnis

Allgemeine Beschreibung

Über den Reiter “Metadaten und Kanalsteuerung” in der vertikalen Toolbar des Editors können pro Ausprägung kanalübergreifende Metadaten verwaltet und zudem über kanalindividuelle Metadaten gesteuert werden, wohin der Inhalt ausgespielt werden soll (mehr dazu unter Kanalsteuerung).

Neben der Übergabe nach Print besteht hier auch die Möglichkeit, einen Artikel an ein Online-Content Management System (= CMS) zu übergeben. Über ein Kanal-spezifisches Statusstufen-Konzept (mehr dazu unter Statusstufen) wird gesteuert, wie Inhalte, die in einer Digital-Ausprägung in CREATE ganz einfach per 1-Klick publiziert werden, anschließend unmittelbar über [2-4] INBOUND OUTBOUND CREATE API abgefragt und an von Kund:innen betriebene Online-CMS geschickt werden können.

Kanal “Online” publizieren

Standardmäßig erfolgt kein Daten-Export an ein Drittsystem, da die Nutzung der CREATE API vorausgesetzt wird.

Mehr Informationen zur CREATE API finden Sie hier: [2-4] INBOUND OUTBOUND CREATE API

Wird der Default-Kanal “Online” einer Ausprägung per Klick auf den Button “Publizieren” in der Kanalsteuerung publiziert, werden die Artikel-Metadaten des CREATE-Artikels entsprechend aktualisiert und der Kanal-Status wechselt von “Erfassung” auf “Publiziert”.

... <Kanaele> <Online> <Publizieren>ja</Publizieren> <Start>15.11.2024 10:54</Start> <Status>Publiziert</Status> <Positionen> <Position> <ID>204-4280637</ID> </Position> </Positionen> <PaidContent/> <OnlineStatus>Online</OnlineStatus> </Online> ...

CREATE-Ausprägung deren Online-Kanäle publiziert wurden, können von Kund:innen mit einem eigenen Endpunkt der CREATE API abgefragt und an ein angeschlossenes Drittsystem (z.B. Online CMS) gesendet werden.

Mit Klick auf die Schaltfläche “Publizieren” wird stets die aktualisierte Version des Artikels inkl. aller vorgenommenen Änderungen veröffentlicht, wodurch der Kanalstatus der Ausprägung erneut auf “Publiziert” (grüner balken) wechselt.

Optional kann der Online-Kanal kundenspezifisch so konfiguriert werden, dass beim Klick auf Publizieren die Ausprägung sowie darin platzierte Bilder via XML-Export auf einen PEIQ sFTP-Server geschrieben werden. Von dort können Drittsysteme die Daten anschließend abholen und an ein angebundenes Online-CMS (= Content Management System) exportieren. Mehr Infos dazu gibt es unter [0-15] OUTBOUND Online-Export CREATE-Artikel.

Auch die Anbindung bereits bei Kund:innen im Einsatz befindlicher, kundenspezifischer Schnittstellen ist möglich.

Voraussetzungen für Publikation des Online-Kanals

Neben den kanalübergreifenden Metadaten (mehr dazu unter Kanalsteuerung | Kanalübergreifende Metadaten) müssen nach der Aktivierung des Online-Kanals mittels Online-Toggle (optional) v. a. auch die kanalspezifischen Metadaten (mehr dazu unter Kanalsteuerung | Kanalspezifische Metadaten des Online Kanals) befüllt werden.

Dazu gehören Positionsinformationen wie das Online-Ressort (= Kanalinfo), in welchem der Artikel erscheinen soll, der Veröffentlichungsbeginn bzw. -zeitraum sowie ggf. die Kennzeichnung, ob der Inhalt hinter einer Paywall versteckt werden soll.

Steuerung der Online-Veröffentlichung

Wurden alle notwendigen Informationen hinterlegt und der Kanal “Online” erfolgreich publiziert, geschieht in CREATE Folgendes:

1. Der Kanalstatus der Ausprägung wechselt von dem initial, bei Anlage vergebenen Status “Erfassung” (grauer balken) hin zu “Publiziert” (grüner balken) (siehe dazu auch Statusstufen).

Online-Artikel im Status “Publiziert”

2. Der bzw. die Benutzer:in erhält an der Systemoberfläche eine Meldung, dass der Artikel erfolgreich übertragen wurde.

 

3. Der CREATE-Artikel erhält einen Schreibschutz und wird daher ausgegraut dargestellt. Am oberen Rand des Editors erscheint folgender Hinweis: “Der Artikel wurde bereits abgegeben und kann in CREATE nicht mehr verändert werden.”

Meldung, wenn ein verlinktes Element noch nicht im jeweiligen Kanal publiziert wurde

Zur Veranschaulichung dient folgendes Beispiel: In einem Artikel sind ein weiterer Artikel sowie eine eigenständige Bildergalerie verlinkt. Die verlinkten Elemente wurden noch nicht publiziert (weder Online noch in Print) oder das Veröffentlichungsdatum des verlinkten Artikels liegt weiter in der Zukunft als das Veröffentlichungsdatum des Hauptartikels.

Wird der Hauptartikel nun online publiziert obwohl die verlinkten Elemente noch nicht veröffentlicht wurden, so öffnet sich beim Klick auf die Schaltfläche "Publizieren" folgende Meldung:

Dem/der Benutzer:in wird angezeigt, dass die verlinkte Bildergalerie noch nicht publiziert wurde und sich im Status "Erfassung" befindet (GRAUER BALKEN). Der verlinkte Artikel hingegen ist bereits publiziert/online (GRÜNER BALKEN), jedoch liegt das Veröffentlichungsdatum in der Zukunft.

Der/die Benutzer:in kann nun entweder “Abbrechen“, den Artikel “Trotzdem publizieren” oder die verlinkten Artikel öffnen und prüfen. Beim Öffnen der verlinkten Artikel können die Kanalinfos bearbeitet werden, woraufhin nachträglich publiziert werden kann.

Handling des Kanal-Status “Online”

Da unterschiedliche Systeme bzw. (kundenspezifische) Schnittstellen angebunden sein können, die beim Publizieren des Online-Kanals aufgerufen werden, wurde in CREATE ein komplexes Status-Handling implementiert.

Der Kanal-Status wird erst nach Abschluss des Übertragungsprozesses entsprechend der jew. Aktion gesetzt:

  • Bei erfolgreicher Aktion Publizieren →  Status=Publiziert

  • Bei erfolgreicher Aktion ErneutBearbeiten→  Status=Revision

Der Kanal-Status des Online-Kanals wechselt also erst dann von ERFASSUNG in PUBLIZIERT, wenn der Prozess des Übertragens, abh. vom System bzw. Schnittstelle, erfolgreich abgeschlossen wurde. Solange der Prozess des “Online-Stellens” noch in Arbeit ist, wird dies am “Publizieren-Button” entsprechend durch ein “spinning wheel” (drehender Kreis) signalisiert: image-20241115-103758.png

War das Onlinestellen erfolgreich, wird statt des Buttons zum “Publizieren” der Button “Erneut bearbeiten” eingeblendet, mit dem der Kanal in den Status “Revision” depubliziert werden kann.

Auch beim Wechsel des Kanal-Status von Publiziert in REVISIOn wird der Status erst dann gesetzt, wenn der Prozess des Depublizierens erfolgreich abgeschlossen wurde.

Fehlerbehandlung

Tritt beim Publizieren oder Depublizieren ein Fehler auf, wird die Fehlermeldung intern gespeichert und eine entsprechende Meldung an der Oberfläche in CREATE ausgegeben.

Im Fehlerfall bleibt der vorherige Status erhalten, also entweder Erfassung (bei Erstübertragung), Publiziert oder Revision.

Auch die Schaltfläche in der Kanalsteuerung bleibt unverändert auf “Publizieren” oder “Erneut bearbeiten”.

Artikel in CREATE zurückstufen

Wurde ein Artikel in CREATE via “Publizieren“-Button bereits weitergestuft (erkennbar am grünen balken), stehen den Benutzer:innen die Option “Erneut bearbeiten“ zur Verfügung, um den Artikel zurückzustufen:

  • “Erneut bearbeiten”: der Inhalt wird in den Status “Revision” (orangener balken) gestuft

Erneut bearbeiten

Um eine via CREATE bereits veröffentlichte Online-Ausprägung zurückzustufen, kann neben der Option “Depublizieren“ auch der Button “Erneut bearbeiten“ gewählt werden.

Mit Klick auf diesen werden in CREATE gleichzeitig folgende Änderungen vorgenommen:

  1. Der Kanalstatus der Ausprägung wechselt von dem Status “Publiziert” (grüner balken) hin zu “Revision“ (orangener balken) (siehe dazu auch Statusstufen).

  2. Der bzw. die Benutzer:in erhält an der Systemoberfläche eine Meldung, dass der Artikel erfolgreich zurückgestuft bzw. in Revision genommen werden konnte.

  3. Der mit dem Klick auf den “Publizieren“-Button gesetzte Schreibschutz der Ausprägung wird aufgehoben, sodass der Artikel erneut bearbeitet werden kann.

  4. Die vorher zur Auswahl stehende Schaltfläche “Erneut bearbeiten” wird durch den Button “Publizieren“ ersetzt.

Verwandte Seiten

 

Nur für PEIQ-Mitarbeiter:

https://peiq.atlassian.net/wiki/spaces/CORE/pages/962823748