PORTAL und PPS Knowledge Base
Export von Beiträgen vom PRINT PPS ins PORTAL
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 oder die Benutzer:in 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”-FunktionIn einem Overlay wird dem oder der Benutzer:in die Möglichkeit gegeben, den Inhalt als Beitrag oder als Veranstaltung zu veröffentlichen. Nach der Auswahl beginnt der bzw. die Benutzer:in den Export mit Klick auf den Button “Ja, jetzt veröffentlichen”. Der zu veröffentlichende Inhalt im PRINT PPS behält beim Exportieren den Inhaltstypen bei. Es gibt einen Sonderfall für Schnappschüsse: Wenn ein Inhalt ein Schnappschuss ist, wird keine Möglichkeit angeboten, diesen im PORTAL als Schnappschuss zu überschreiben.
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:in des Beitrags wird der bzw. die PRINT PPS Benutzer:in vorbelegt.
Falls die Erstellung des Beitrags auf dem PORTAL aus irgendwelchen Gründen fehlschlägt, erhält der oder die Benutzer:in 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 bzw. die Benutzer:in auf das PORTAL weiter.
- Sofern der oder die Benutzer:in eine laufende Session im PORTAL hat, wird er oder sie direkt auf das geöffnete Beitragsformular weitergeleitet.
- Sofern der oder die Benutzer:in keine laufende Session verfügt, muss er oder sie sich zunächst im PORTAL einloggen und wird dann ebenfalls direkt auf das geöffnete Beitragsformular weitergeleitet.
Der bzw. die Benutzer:in 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 oder die PRINT PPS Benutzer:in den Beitrag im PORTAL nochmals mit den Anpassungen des PRINT PPS Inhaltes überschreiben.
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:in und Optionen) bleiben hiervon unberührt.
Falls die Erstellung des Beitrags auf dem PORTAL aus irgendwelchen Gründen fehlschlägt, erhält der bzw. die Benutzer:in eine Fehlermeldung.
Das PRINT PPS generiert die URL des entsprechenden Beitragsformulars im PORTAL anhand des Musters
/a/edit/{Beitrags-ID}
und leitet den bzw. die Benutzer:in zum PORTAL weiter.
- Sofern der oder die Benutzer:in eine laufende Session im PORTAL hat, wird er oder sie direkt auf das geöffnete Beitragsformular weitergeleitet.
- Sofern der oder die Benutzer:in keine laufende Session verfügt, muss er oder sie sich zunächst im PORTAL einloggen und wird dann ebenfalls direkt auf das geöffnete Beitragsformular weitergeleitet.
Der bzw. die Benutzer:in kann den Beitrag dann nochmals komplett bearbeiten. Die Änderungen am Beitrag im PORTAL wirken sich nicht automatisch auf den Inhalt im PRINT PPS aus.
Ü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 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 Formatierungen | Formatierungsverwaltung).
Verhalten bei Export von Listen
Sofern ein Mapping für nummerierte oder nicht-nummerierte Listen in der Sicht Formatierungen eingerichtet wurde, werden diese Listen im PORTAL Editor im PORTAL (BBCode) entsprechend ausgezeichnet und damit übernommen. Im PRINT PPS werden zwei nummerierte Listen mit Unterbrechung immer fortgeführt. Im PORTAL Editor beginnen hingegen zwei nummerierte Liste mit Unterbrechung immer wieder mit 1. Daher werden zwei nummerierte Listen mit Unterbrechung, die im PRINT PPS fortlaufend sind, im PORTAL nach der Unterbrechung wieder mit 1 beginnen.
Verwandte Seiten