Das PRINT PPS legt über die Beitrags-API im PORTAL neue Beiträge an bzw. überschreibt bestehende Beiträge. Die Übertragung findet über das PEIQ SDK statt.
Funktionalitäten des Exports von Beiträgen vom PRINT PPS ins PORTAL
Export eines Beitrags vom PRINT PPS ins PORTAL
Überschreiben des Inhalts im PRINT PPS für einen Beitrag im PORTAL
Inhaltsverzeichnis
Allgemeine Beschreibung
Beiträge können vom PRINT PPS ins PORTAL exportiert werden. Außerdem ist es möglich, Inhalte im PRINT PPS für das PORTAL zu überschreiben.
Workflows
Erstmaliger Export eines Inhalts als Beitrag
Der Benutzer kann entweder über das Kontextmenü des Inhalts in der Seitenplanung, im Inhaltspool oder über den Link in “Verwendet in” einen Inhalt online veröffentlichen.
Funktion “Beitrag veröffentlichen” im Kontextmenü
Funktion “Beitrag veröffentlichen” als Link im Overlay der “Verwendet-in”-Funktion
In einem Overlay wird dem Benutzer die Möglichkeit gegeben, den Inhalt als Beitrag oder als Veranstaltung zu veröffentlichen. Nach der Auswahl beginnt der Benutzer den Export mit Klick auf den Button “Ja, jetzt veröffentlichen”.
Export-Overlay
Im Falle eines Exports als Beitrag wird der Inhalt über den POST /articles-Endpunkt der Beitrag-API als Entwurf (
"status": "draft") im PORTAL angelegt.Dabei werden alle Bilder, unabhängig davon, ob sie im Printinhalt verwendet wurden, an das PORTAL übergeben.
Als Autor des Beitrags wird der PRINT PPS Benutzer vorbelegt.
Falls die Erstellung des Beitrags auf dem PORTAL aus irgendwelchen Gründen fehlschlägt, erhält der Benutzer eine Fehlermeldung.
Das PRINT PPS erhält als Rückgabewert unter anderem die ID des erstellten Beitrags und verknüpft diese mit dem Inhalt im PRINT PPS.
Im Kontextmenü kann nun der Link zum Online-Beitrag (
/{Beitrags-ID}) abgerufen werden.In der Verwendet-in-Funktion wird der Online-Beitrag mit ID angezeigt, zudem ändert sich die Funktion von “Inhalt online veröffentlichen” auf “Inhalt online überschreiben”.
Das PRINT PPS generiert die URL des entsprechenden Beitragsformulars im PORTAL anhand des Musters
/a/edit/{Beitrags-ID}und leitet den Benutzer auf das PORTAL weiter.
- Sofern der Benutzer eine laufende Session im PORTAL hat, wird er direkt auf das geöffnete Beitragsformular weitergeleitet.
- Sofern der Benutzer keine laufende Session verfügt, muss er sich zunächst im PORTAL einloggen und wird dann ebenfalls direkt auf das geöffnete Beitragsformular weitergeleitet.
Der Benutzer kann den Beitrag dann nochmals komplett bearbeiten. Die Änderungen am Beitrag im PORTAL wirken sich nicht automatisch auf den Inhalt im PRINT PPS aus.
Bestehender Beitrag online überschreiben
Über die Verwendet-in-Funktion kann der PRINT PPS Benutzer den Beitrag im PORTAL nochmals mit den Anpassungen des PRINT PPS Inhaltes überschreiben.
“Verwendet-in”-Funktion nach erfolgreichem Export
Dies wird über den im oben beschrieben Overlay befindender Button “Ja, jetzt übergeben” gesteuert.
Überschriften, Text und Bilder des Beitrags werden über den PUT /articles/{article_id}-Endpunkt der Beitrag-API mit den PRINT PPS Inhalten überschrieben. Alle anderen Anpassungen (Status, Kategorie, Tags, Autor und Optionen) bleiben hiervon unberührt.
Falls die Erstellung des Beitrags auf dem PORTAL aus irgendwelchen Gründen fehlschlägt, erhält der Benutzer eine Fehlermeldung.
Das PRINT PPS generiert die URL des entsprechenden Beitragsformulars im PORTAL anhand des Musters
/a/edit/{Beitrags-ID}und leitet den Benutzer zum PORTAL weiter.
- Sofern der Benutzer eine laufende Session im PORTAL hat, wird er direkt auf das geöffnete Beitragsformular weitergeleitet.
- Sofern der Benutzer keine laufende Session verfügt, muss er sich zunächst im PORTAL einloggen und wird dann ebenfalls direkt auf das geöffnete Beitragsformular weitergeleitet.
Der Benutzer kann den Beitrag dann nochmals komplett bearbeiten. Die Änderungen am Beitrag im PORTAL wirken sich nicht automatisch auf den Inhalt im PRINT PPS aus.
Exportierter Inhalt im Beitragsformular
Übergabe Formatierungen
Beim Export eines Inhalts vom PRINT PPS ins PORTAL werden jene Formatierungen übergeben, die in der Basis-Elemente-Verwaltung am Element festgelegt wurden (siehe https://peiq.atlassian.net/wiki/spaces/PPSD/pages/305136301/Basis-Elemente+verwalten#Bearbeiten). Bei Inhalten mit mehreren Elementen sind die Formatierungen des ersten Templates führend. Wurden im Basis-Element-Overlay keine vom Standard abweichenden Formatierungen konfiguriert, so werden die Formatierungen übergeben, wie sie in der Formatierungsverwaltung global konfiguriert wurden (siehe https://peiq.atlassian.net/wiki/spaces/PPSD/pages/236126459/Formatierungen#Formatierungsverwaltung).