{"type":"doc","content":[{"type":"panel","attrs":{"panelType":"info"},"content":[{"type":"paragraph","content":[{"text":"Der JSON-Feed ermöglicht es, bestimmte Inhalte des PORTALs per URL in Form von JSON-Objekten abzurufen.","type":"text"}]},{"type":"paragraph","content":[{"text":"Die ","type":"text"},{"text":"JavaScript Object Notation","type":"text","marks":[{"type":"strong"}]},{"text":" (","type":"text"},{"text":"JSON","type":"text","marks":[{"type":"strong"}]},{"text":") ist ein kompaktes Datenformat in einer einfach lesbaren Textform und dient dem Zweck des Datenaustausches zwischen Anwendungen.","type":"text"}]},{"type":"paragraph","content":[{"text":"Der Feed (von engl. to feed – im Sinne von füttern, einspeisen, zuführen) kann für ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://peiq.atlassian.net/wiki/spaces/PUPKB/pages/301858946"}},{"text":" und für ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://peiq.atlassian.net/wiki/spaces/PUPKB/pages/273252464"}},{"text":" genutzt werden. Durch die Verwaltung können Zugänge für bestimmte Feeds erstellt werden. Es kann z. B. eingestellt werden, welche Inhalte im Feed verfügbar sein sollen. Zugreifbar wird der Feed durch ein im System generiertes Zugriffstoken.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Funktionalitäten des JSON-Feeds","type":"text","marks":[{"type":"strong"}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Abrufen von PORTAL-Inhalten im JSON-Format ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Flexible Selektion der gewünschten Inhalte","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Flexible Handhabung der zugreifbaren Inhalte pro Client ","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"JSON-Feeds im PEIQ PORTAL basieren auf dem neuesten Standard","type":"text"},{"type":"hardBreak"}]}]}]},{"type":"paragraph","content":[{"text":"Inhaltsverzeichnis","type":"text","marks":[{"type":"strong"}]}]},{"type":"expand","attrs":{"title":"Inhaltsverzeichnis anzeigen"},"content":[{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"toc","parameters":{"macroParams":{"maxLevel":{"value":"4"}},"macroMetadata":{"macroId":{"value":"e4b7b54a-5f60-4d8e-be61-3f56a945095f"},"schemaVersion":{"value":"1"},"title":"Table of Contents"}},"localId":"357aa1d0-93ab-4744-9b29-d49677b1283c"}}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Allgemeine Beschreibung","type":"text"}]},{"type":"paragraph","content":[{"text":"Im Gegensatz zum ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://peiq.atlassian.net/wiki/spaces/PUPKB/pages/232914956"}},{"text":", bei dem bestimmte Zielseiten des PORTALs in Form einer XML-Struktur extrahiert bzw. gelesen werden können, liegt die Selektion der Inhalte beim JSON-Feed in der Hand des Benutzers bzw. der Benutzerin. Der Output des Feeds sind die selektierten Inhalte als JSON-Objekte, welche dann auf einer Zielseite verarbeitet werden können, z. B. in Form von Teasern o.ä.. Zugriff auf den Feed erhält nur, wer den dafür generierten (aktiven) Zugriffstoken hat.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Erstellung und Verwaltung","type":"text"}]},{"type":"paragraph","content":[{"text":"Die Erstellung und Verwaltung ist mit der Berechtigung “Zugang zur JSON-Feed-Zugangsverwaltung / Zugänge bearbeiten und löschen” möglich.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1330,"id":"26b2111e-d3ed-40fe-b9a0-ef761030362e","collection":"contentId-329285668","type":"file","height":552}},{"type":"caption","content":[{"text":"Bearbeitungsmaske in der JSON-Feed-Zugangsverwaltung","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Die Verwaltung findet sich für berechtigte Benutzer:innen unter ","type":"text"},{"text":"/admin/federation/client","type":"text","marks":[{"type":"code"}]},{"text":". Über “Zugang erstellen” lässt sich ein neuer Client für einen JSON-Feed generieren. Bearbeitungs- und Löschvorgänge kann der oder die Benutzer:in über die Übersichtsseite vornehmen.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":80.0},"content":[{"type":"media","attrs":{"width":1137,"id":"28717922-444c-4b05-9699-ea347f52cc24","collection":"contentId-329285668","type":"file","height":342}},{"type":"caption","content":[{"text":"Eingabefeld zum Erstellen eines neuen Clients","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Generell können zwei Zugangsmodi konfiguriert werden","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"type":"status","attrs":{"color":"blue","style":"bold","text":"ZUGANG AKTIVIEREN","localId":"d997efae-c599-4f64-b7cb-327105cd0476"}},{"text":" Dieser Modus regelt den generellen Zugriff auf den Feed. Hierüber lässt sich der Zugriff temporär deaktivieren, ohne den Feed löschen zu müssen.","type":"text"}]},{"type":"paragraph","content":[{"type":"status","attrs":{"color":"blue","style":"bold","text":"ZUGANG BESCHRÄNKEN","localId":"ebbd58f0-5a40-48ef-9805-e326c6c49959"}},{"text":" Dieser Modus regelt die Selektion der zugreifbaren Inhalte. Ist die Zugriffsbeschränkung aus, können die Daten via der unten genannten URL-Parameter selektiert werden. Wird die Zugriffsbeschränkung eingeschalten, öffnet sich das folgende Formular. Hierüber kann genau spezifiziert werden, auf welche Inhalte der Feed eingeschränkt werden soll.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center","width":80.0},"content":[{"type":"media","attrs":{"width":943,"id":"62253630-0013-43c7-9499-1443f0300ee7","collection":"contentId-329285668","type":"file","height":1151}},{"type":"caption","content":[{"text":"Auswahlfelder zur Beschränkung der zugreifbaren Inhalte eines Benutzers","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Zugriff","type":"text"}]},{"type":"paragraph","content":[{"text":"Zugriffs-URL für Beiträge und Schnappschüsse:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"https:///a/federation/.json?access_token=","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Die Inhaltsform ist dabei mit folgenden Parametern zu belegen:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"articles","type":"text","marks":[{"type":"code"}]},{"text":"für Beiträge","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"imageposts","type":"text","marks":[{"type":"code"}]},{"text":" für Schnappschüsse","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Zugriffs-URL für Veranstaltungen:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"https:///event/federation/events.json?access_token=","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":" ","type":"text"}]},{"type":"paragraph","content":[{"text":"Das Zugriffstoken kann für den jeweiligen Feed über die Startseite der Verwaltung abgerufen werden. Über das Schlüssel-Icon wird das Token angezeigt und kann über das erscheinende Copy-Icon kopiert werden.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1487,"id":"8f7c16ef-a67b-4a19-b062-76a0748d0d0d","collection":"contentId-329285668","type":"file","height":398}},{"type":"caption","content":[{"text":"Bearbeitungsmaske in der JSON-Feed-Zugangsverwaltung","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Parameter","type":"text"}]},{"type":"paragraph","content":[{"text":"Bei einem uneingeschränkten Feed lässt sich die Inhaltsselektion mittels angehängter Parameter steuern, welche hinten an die Grund-URL angehängt werden.","type":"text"}]},{"type":"paragraph","content":[{"text":"&=","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"z. B. ","type":"text"},{"text":"&category=sport","type":"text","marks":[{"type":"code"}]}]},{"type":"paragraph","content":[{"text":"Folgende Parameter stehen zur Verfügung:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"category","type":"text","marks":[{"type":"code"}]},{"text":" Eine durch Komma getrennte Liste von normalisierten Kategorien, anhand deren die Beiträge gefiltert werden.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"tag ","type":"text","marks":[{"type":"code"}]},{"text":"Eine durch Komma getrennte Liste von normalisierten Tags, anhand deren die Beiträge gefiltert werden. Mehrere Tags werden als OR Verknüpfung verwendet, es wird keine Schnittmenge aller angegebenen Tags gebildet.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"location ","type":"text","marks":[{"type":"code"}]},{"text":"Eine durch Komma getrennte Liste von normalisierten Ortsnamen, anhand deren die Beiträge gefiltert werden.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"limit","type":"text","marks":[{"type":"code"}]},{"text":" Maximale Anzahl von zurück gelieferten Beiträgen. Der Default-Wert ist 10, maximal ist ein Wert von 100 erlaubt.","type":"text"}]}]},{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"offset","type":"text","marks":[{"type":"code"}]},{"text":" Die Anzahl der Beiträge der aktuellen Selektion, die übersprungen werden sollen.","type":"text"}]}]}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Aus technischen Gründen darf die Summe von limit und offset den Wert 10.000 nicht überschreiten. Andernfalls liefert die API den HTTP Code 400 (Bad Request) zurück.","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Bearbeitungsprotokoll","type":"text"}]},{"type":"paragraph","content":[{"text":"Über das Bearbeitungsprotokoll lässt sich nachvollziehen, wer, wann einen Zugang erstellt, bearbeitet oder gelöscht hat. Das Bearbeitungsprotokoll findet sich in der Verwaltung über das Optionsmenü.","type":"text"}]},{"type":"mediaSingle","attrs":{"layout":"center"},"content":[{"type":"media","attrs":{"width":1378,"id":"b461a245-a173-421a-8555-fcc8b0531826","collection":"contentId-329285668","type":"file","height":286}},{"type":"caption","content":[{"text":" Listenansicht des Bearbeitungsprotokolls","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Datenstruktur","type":"text"}]},{"type":"paragraph","content":[{"text":"Im Gegensatz zur ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://peiq.atlassian.net/wiki/spaces/PUPKB/pages/78284050"}},{"text":" werden die Daten beim JSON-Feed in Plain Text ausgegeben. Hierbei müssen bspw. nicht die Beitrags-ID und zusätzlich noch die jeweiligen Daten dazu gesondert gezogen werden. Die Ausgabe beinhaltet alle Informationen zum vorliegenden Inhalt.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Beitrag","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"url\": , // URL des Beitrags im Portal\n \"id\": , // Beitrags ID\n \"created\": , // Erstellungsdatum\n \"published\": , // Veröffentlichungsdatum\n \"updated\": , // Letzte Aktualisierung\n \"title\": , // Beitrags Überschrift\n \"comment_count\": , // Anzahl Kommentare\n \"static_tags\": [], // Statische Tags / Flags\n \"text_elements\": , // Textelemente\n \"user\": , // Beitrags-Autor / Owner\n \"category\": , // Beitrags-Kategorie,\n \"location\": , // Beitrags-Verortung\n \"images\": [], // Bilder des Beitrags\n \"image_count\": , // Anzahl Bilder\n \"tags\": [], // Tags des Beitrags\n}","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Schnappschuss","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"url\": , // URL des Schnappschuss im Portal\n \"id\": , // Schnappschuss ID\n \"created\": , // Erstellungsdatum\n \"published\": , // Veröffentlichungsdatum\n \"updated\": , // Letzte Aktualisierung\n \"title\": , // Schnappschuss Überschrift\n \"static_tags\": [], // Statische Tags / Flags\n \"image\": [], // Bild des Schnappschuss\n \"user\": , // Schnappschuss-Autor / Owner\n \"location\": , // Schnappschuss-Verortung\n \"comment_count\": , // Anzahl Kommentare\n}","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Veranstaltung","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"url\": , // URL der Veranstaltung im Portal\n \"id\": , // Veranstaltungs-ID\n \"created\": , // Erstellungsdatum\n \"published\": , // Veröffentlichungsdatum\n \"image_count\": , // Anzahl Bilder\n \"comment_count\": , // Anzahl Kommentare\n \"title\": , // Veranstaltungs Überschrift\n \"description\": , // Veranstaltungs Beschreibung\n \"static_tags\": [], // Statische Tags / Flags\n \"category\": , // Veranstaltungs-Kategorie,\n \"location\": , // Veranstaltungs-Verortung\n \"user\": , // Veranstaltungs-Autor / Owner\n \"images\": [], // Bilder der Veranstaltung\n \"tags\": [], // Tags der Veranstaltung\n \"eventitem_date\": , // Datum der Veranstaltung\n \"event_locations\": , // Veranstaltungs-Ort\n}","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Text-Elemente","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"kicker\": , // Dachzeile\n \"text\": , // Beitrags-Text\n \"subline\": , // Anreißer-Text\n \"teaser\": , // Teaser-Text\n}","type":"text"}]},{"type":"panel","attrs":{"panelType":"note"},"content":[{"type":"paragraph","content":[{"text":"Der Text enthält HTML- und BBCODE-Elemente des Inhalts. Sind diese auf der Zielseite nicht gewünscht, müssen die Elemente an dieser Stelle herausgezogen werden.","type":"text"}]}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Benutzer-Elemente","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"full_name\": , // Der Name des Benutzers\n \"user_segment\": // Das Segment des Benutzers\n}","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Bild-Elemente","type":"text"}]},{"type":"codeBlock","content":[{"text":"{\n \"url_set\": {\n // Key-Value Liste der einzelnen Bildressourcen (verschiedene Größen)\n },\n \"native_width\": , // Native Bildbreite in px\n \"native_height\": , // Native Bildhöhe in px\n \"aspect_ratio\": , // Seitenverhältnis (Höhe / Breite)\n \"focus_x\": , // Relativer Bildfokus-Punkt (X-Achse)\n \"focus_y\": , // Relativer Bildfokus-Punkt (Y-Achse)\n \"caption\": , // Bildunterschrift\n \"copyright\": , // Copyright-Vermerk des Bildes\n}","type":"text"}]},{"type":"paragraph"},{"type":"heading","attrs":{"level":2},"content":[{"text":"Verwandte Seiten","type":"text"}]},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"contentbylabel","parameters":{"macroParams":{"showLabels":{"value":"false"},"maxCheckbox":{"value":"false"},"showSpace":{"value":"false"},"reverse":{"value":"false"},"cql":{"value":"label in ( \"json-feed\" , \"json-format\" ) and space = \"PUPKB\""}},"macroMetadata":{"macroId":{"value":"8432957f-fe43-467d-9146-e672c67f0760"},"schemaVersion":{"value":"4"},"title":"Filter by label (Content by label)"}},"localId":"b51d2b9c-8991-4bac-88c9-15f13bbb7d18"}},{"type":"paragraph"},{"type":"extension","attrs":{"layout":"default","extensionType":"com.atlassian.confluence.macro.core","extensionKey":"include","parameters":{"macroParams":{"":{"value":"Disclaimer der PEIQ PORTAL - Produktdokumentation"}},"macroMetadata":{"macroId":{"value":"60b65bc737cf751dc581580cfded7016"},"schemaVersion":{"value":"1"},"title":"Include Page"}},"localId":"f82f5d01-eda6-42ac-8acc-eafad435a6a6"}},{"type":"paragraph","content":[{"text":"Nur für PEIQ-Mitarbeiter:innen","type":"text","marks":[{"type":"subsup","attrs":{"type":"sup"}}]},{"type":"hardBreak"},{"type":"inlineCard","attrs":{"url":"https://peiq.atlassian.net/wiki/x/C4D_EQ"}}]}],"version":1}