Page Comparison

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

Note
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 des Kanals “Online” wechselt von “Erfassung” auf “Publiziert”.

Code Block
... <Kanaele> <Online> <Publizieren>ja</Publizieren> <Start>31<Start>15.0311.20232024 10:38<54</Start> <Status>Publiziert</Status> <Positionen> <Position> <ID>204-4280635<4280637</ID> </Position> </Positionen> <Ende<PaidContent/> <PaidContent<OnlineStatus>Online</>OnlineStatus> </Online> </Kanaele> ...

Anhand des Status des Online-Kanals des publizierten Artikels kann dieser anschließend via [2-4] INBOUND OUTBOUND 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 Drittsystem geschickt angeschlossenes Drittsystem (z.B. Online CMS) gesendet werden.

Note
Standardmäßig erfolgt kein Daten-Export an ein Drittsystem, da die Nutzung der CREATE API vorausgesetzt wird. Die vollständige Dokumentation der CREATE API findet sich hier: https://mt-master-create.peiq.cloud/createapi/createapi.html

Abhängig von der Mitwirkungspflicht von Kund:innen können alternativ beim Publizieren Artikel und zugehörige Bilder auch mittels File

Tip
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” ( Status colour Green title 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 wo diese anschließend abgeholt . Von dort können Drittsysteme die Daten anschließend abholen und an ein angebundenes Online-CMS (= Content Management System) exportiert werden könnenexportieren. Mehr Infos dazu gibt es unter [0-15] OUTBOUND Online-Export CREATE-Artikel.

TipJe nach Parametrisierung, können Inhalte über CREATE auf diversen Plattformen veröffentlicht werden. Mehr dazu unter Kanalsteuerung.

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 https://peiq.atlassian.net/wiki/spaces/PPSD/pages/765788331/Kanalsteuerung#Kanal%C3%BCbergreifende-Metadaten) müssen nach der Aktivierung des Online-Kanals mittels Online-Toggle (optional) v. a. auch die kanalspezifischen Metadaten (mehr dazu unter https://peiq.atlassian.net/wiki/spaces/PPSD/pages/765788331/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.

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

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 (

Status
title GRAUER BALKEN

). Der verlinkte Artikel hingegen ist bereits publiziert/online (

Status
colour Green title 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

Status
title ERFASSUNG

in

Status
colour Green title 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 Added

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

Status
colour Green title Publiziert

in

Status
colour Yellow title 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

Status
colour Green title grünen balken

), stehen den Benutzer:innen zwei neue Schaltflächen die Option “Erneut bearbeiten“ zur Verfügung, um den Artikel zurückzustufen:

“Depublizieren”

:

der Inhalt wird in den Status “Depubliziert” ( StatuscolourYellowtitlegelber balken

• ) zurückgestuft“Erneut bearbeiten”: der Inhalt wird in den Status “Revision” (

  Status
  colour RedYellow title orangener balken

  ) gestuft

Image RemovedImage Added

Die beiden Buttons ‘Depublizieren’ und ‘Erneut bearbeiten’ können je nach gewünschter Arbeitsweise einzeln ein-oder ausgeblendet und auch individuell benannt werden.

Depublizieren

Um eine via CREATE bereits veröffentlichte Online-Ausprägung zurückzustufen, kann neben der Option “Erneut bearbeiten“ auch der Button “Depublizieren“ gewählt werden. Mit Klick auf diesen werden in CREATE gleichzeitig folgende Änderungen vorgenommen:

Der Kanalstatusder Ausprägung wechselt von dem Status “Publiziert” (

Status
colour Green title grüner balken

) hin zu “Depubliziert“ (

Status
colour Yellow title gelber balken

) (siehe dazu auch Statusstufen).

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

Der mit dem Klick auf den “Publizieren“-Button gesetzte Schreibschutzder Ausprägung wird aufgehoben, sodass der Artikel erneut bearbeitet werden kann.Die beiden vorher zur Auswahl stehenden Schaltflächenwerden durch den “Publizieren“-Button ersetzt.Image Removed

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.

Die Funktion “Erneut bearbeiten” ist dafür gedacht, dass bei bereits publizierten Artikeln kurzfristig Änderungen vorgenommen werden können, ohne den bereits veröffentlichten Artikel wieder “Offline” nehmen zu müssen.

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

1. Der Kanalstatus der Ausprägung wechselt von dem Status “Publiziert” (

   Status
   colour Green title grüner balken

   ) hin zu “Revision“ (

   Status
   colour RedYellow title 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 beiden vorher zur Auswahl stehenden Schaltflächen werden durch die Buttons “Publizieren“ und “Depublizieren“ ersetzt.

Image Removed TipMit 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” (

Status
colour Green title grüner balken

) wechselt

1. stehende Schaltfläche “Erneut bearbeiten” wird durch den Button “Publizieren“ ersetzt.

Verwandte Seiten

Filter by label (Content by label)
showLabels false showSpace false cql label = "editor-create" and space = "PPSD"

Include Page
Disclaimer der PEIQ CREATE - Produktdokumentation Disclaimer der PEIQ CREATE - Produktdokumentation

Nur für PEIQ-Mitarbeiter:

/wiki/spaces/CORE/pages/962823748