Über das Schnittstellen-Log besteht die Möglichkeit HTTP-Fehler beim Livingdocs-Import eigenständig zu identifizieren. Bei inhaltlichen Fehlern werden Fehlerartikel in PRINT NGEN angelegt.
Inhaltsverzeichnis
Schnittstellen-Log
Das Schnittstellen-Log der Livingdocs-Schnittstelle kann über den Menüpunkt “Schnittstellen-Log öffnen” im Drop-Down-Menü neben dem Button “Livingdocs” in der Standardwerkzeugleiste geöffnet werden.
Das Log wird in einem Browserfenster in der Cloud geöffnet und protokolliert jeden HTTP-Fehler in XML-Form. Pro Fehler wird das Tag <WFAktivierung> und darunter der Zeitpunkt des versuchten Imports (<WFAktivierungsZeit>), der ausführende Dämon (<Daemon>) und die Fehlermeldung inklusive der Livingdocs-ID des betroffenen Artikels (<WFFehler>) ausgegeben.
Beispiel-Fehler im Log:
<WFAktivierung> <WFAktivierungsZeit>04.09.2024 13:25:06</WFAktivierungsZeit> <Daemon>workflow_01</Daemon> <WFFehler> ActiveX-Meldung: 'LD-API liefert NotFound, id=12345678 <?ZE ?> ' </WFFehler> </WFAktivierung>
Hierbei handelt es sich um den HTTP-Fehler 404 “Not Found”. Der Livingdocs-Artikel mit der ID=12345678 kann nicht gefunden und daher nicht importiert werden.
Die Fehler sind in absteigender Reihenfolge aufgeführt. Die neueste Meldung steht an oberster Stelle. Die Liste ist begrenzt auf eine festgelegte Textlänge von 10.000 Zeichen.
Wenn Livingdocs-seitig kein Fehler zu dem im Log angegebenen Artikel gefunden werden kann, kann mit den Informationen aus dem Log (ID, Zeitpunkt, Dämon, Fehlermeldung) ein Ticket im PEIQ Service Desk zur Analyse aufgegeben werden.
Das Log aktualisiert sich nicht selbstständig. Ein Neuladen des Browsertabs ist erforderlich, um die Meldungen seit dem letzten Aufruf der URL zu laden.
Das Log ist über die URL von extern aufrufbar.
Falls es getrennte Importe je nach Objekt gibt (aufgrund bspw. unterschiedlicher API-Token), wird das Schnittstellen-Log pro Objekt in einem separaten Browsertab geöffnet.
HTTP-Fehler
HTTP-Fehler, die beim Abfragen der Artikel über die Livingdocs-API zurückgeliefert werden, werden im Schnittstellen-Log protokolliert.
404 “Not Found”: Bei der Livingdocs-Schnittstelle wird zuerst eine Liste der IDs der neusten Printartikel abgefragt. Im nächsten Schritt wird zu jeder Livingdocs-Artikel-ID das Artikel-JSON mit dem Inhalt und den Metadaten des Artikels abgefragt. Beim HTTP-Fehler 404 kann der Artikel zu der jeweiligen ID nicht in der Livingdocs Datenbank gefunden werden, da er vermutlich in Livingdocs gelöscht wurde. Die Schnittstelle überspringt diesen Artikel und ruft den nächsten Artikel aus der Liste der neusten Printartikel ab.
Falls ein Artikel, bei dem der Fehlercode 404 zurückgeliefert wurde, in PRINT NGEN vermisst wird, kann in Livingdocs geprüft werden, ob zu der ID ein Artikel existiert. Ist das der Fall, kann der Artikel erneut publiziert werden, sodass er wieder in der Liste der neusten Printartikel enthalten ist.
500 “Internal Server Error“: Bei diesem Fehler handelt es sich um ein serverseitiges Problem, das die Verarbeitung der Abfragen verhindert. Normalerweise ist der Server nur kurzfristig nicht erreichbar, z.B. aufgrund von Neustart oder Wartung des Servers. Wenn dieser Fehler für einen Artikel zurückgegeben wird, wird der Artikel nicht übersprungen, sondern PRINT NGEN versucht erneut, den Artikel abzurufen, bis der Fehlercode 500 nicht mehr zurückgeliefert wird und der Server wieder erreichbar ist.
Wenn ein Fehler 500 den Import der Livingdocs-Artikel für eine längere Zeit blockiert, sollte bei Livingdocs nach der Fehlerursache gesucht werden. Der Fehlercode sollte nicht für einzelne fehlerhafte Artikel sondern nur bei allgemeinen serverseitigen Problemen zurückgeliefert werden.
Weitere HTTP-Fehler: Auch bei anderen HTTP-Fehlern wird der Artikel nicht übersprungen, sondern die Schnittstelle versucht den Artikel immer wieder abzurufen, bis der Fehler nicht mehr zurückgeliefert wird.
Wenn der Livingdocs-Import nicht durch einen Fehler 500 sondern einem anderen HTTP-Fehler blockiert wird, kann mit den Informationen aus dem Schnittstellen-Log (ID, Zeitpunkt, Dämon, Fehlermeldung) ein Ticket im PEIQ Service Desk zur Analyse aufgegeben werden.
Inhaltliche Fehler
Bei inhaltlichen/syntaktischen Fehlern im Artikel-JSON, ist das XML nicht gültig und kann damit nicht verarbeitet werden. Das XSLT zum Umwandeln der Bereiche und Tags kann nicht ablaufen und der Artikel kann somit nicht importiert werden. Es wird ein Fehlerartikel in NGEN angelegt, der in der Artikelsuche mit der gleichen Namenskonvention “livingdocs-{Livingdocs-Document-ID}” gefunden werden kann. In dem Fehlerartikel steht die Ursache, weshalb der Import fehlgeschlagen hat.
Beispiel:
"Fehler bei der Verarbeitung des Inhalts: Fehler beim Ausführen des Xslt 'Default#Master.Livingdocs':'„' is an unexpected token. The expected token is '"' or '''. Line 1, position 1496."
Hier wurden Links mit deutschen Anführungszeichen (unten und oben) übergeben werden. Diese müssen jedoch mit " oder ' übergeben werden. Nur so ist das übertragene XML gültig und Links (“<a href>“) können richtigerweise ignoriert bzw. herausgefiltert werden.
Der Syntax-Fehler muss Livingdocs-seitig korrigiert werden. In diesem Beispiel kann als kurzfristiger Workaround der Link im Livingdocs-Aritkel entfernt und der Artikel erneut nach nach PRINT NGEN übergeben werden.
Nähere Informationen dazu, welche Textformate übernommen werden, finden Sie unter Produktübergreifender Standard: Tags/Makros/Bereiche für XSLT Stylesheets.
Verwandte Seiten
Disclaimer
Für die vorliegende Systemübersicht/Publikation behalten wir uns alle Rechte vor. Nachdruck, Vervielfältigung und Verbreitung (auch auszugsweise) ist nur mit schriftlicher Genehmigung der PEIQ GmbH erlaubt. Wir behalten uns vor, die Systemübersicht/Publikation jederzeit ohne vorherige Ankündigung zu ändern und/oder zu erweitern. Die vorliegenden Angaben dienen lediglich Informationszwecken. Die PEIQ GmbH übernimmt keinerlei Haftung und/oder Garantie für Fehler und/oder unvollständige Angaben in der Systemübersicht/Publikation, mit Ausnahme von vorsätzlich falschen oder arglistig verschwiegenen Angaben. Da unsere Software laufend weiter entwickelt wird, handelt es sich bei den vorliegenden nur um allgemeine Angaben. Es handelt sich weder um eine Zusicherung von Mindestvertragsinhalten, noch um Beschaffenheitsgarantien im Sinne des § 443 BGB.