FAQ

Warum können Batches im Input Management nicht geladen werden?

Beim Öffnen des Input Management Dashboards erscheint eine Fehlermeldung und die betroffenen Batches können nicht geöffnet werden.

Die Ursache sind inkonsistente content-Einträge in der Datenbank.

Was verursacht das Problem?

Das Problem entsteht durch eine Race Condition bei der Erstellung von Dokumenten in der Datenbank.

Dadurch werden mehrere aktive content-Einträge für dieselbe document_id angelegt.
Das Dashboard kann diese inkonsistenten Datensätze nicht korrekt verarbeiten.

Welche Voraussetzungen sind für die Fehlerbehebung erforderlich?

Folgende Zugriffsrechte und Tools werden benötigt:

• Zugriff auf den PROD-DE-Cluster
• Berechtigung für Port-Forwarding
• Zugriff auf die stp_im-Datenbank
• Ein SQL-Client, z. B. pgAdmin 4

Wie wird die Verbindung zur Datenbank hergestellt?

Um auf die Datenbank zuzugreifen, muss zunächst eine Port-Forwarding-Verbindung eingerichtet werden:

kubectl -n lexolution port-forward svc/portforward-aurora-shared 5432:5432

Dadurch ist ein lokaler Zugriff auf die Datenbank möglich.

##Wie können betroffene Dokumente identifiziert werden?

Führen Sie die folgende Abfrage auf der stp_im-Datenbank aus:

select document_id, count(*) as anz
from content
where deleted_at is null
  and content_parent_id is null
group by document_id
order by anz desc
limit 10

Der oberste Eintrag mit dem höchsten Wert bei anz identifiziert in der Regel die betroffene document_id.

Hinweis

In seltenen Fällen können mehrere Dokumente mit anz > 1 existieren. Die folgenden Schritte müssen dann für jedes betroffene Dokument durchgeführt werden.

Wie wird der fehlerhafte Content-Eintrag identifiziert?

Setzen Sie die ermittelte document_id in die folgende Abfrage ein:

select *
from content
where document_id = 'xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx'
  and deleted_at is null
  and content_parent_id is null
order by created_at desc

Es sollten zwei aktive Einträge zurückgegeben werden.

Für die Bereinigung wird die ID eines der beiden Einträge benötigt. Es spielt keine Rolle, welcher der beiden verwendet wird.

Wie wird der fehlerhafte Eintrag bereinigt?

Führen Sie folgende Abfrage aus:

update content
set deleted_at = CURRENT_TIMESTAMP,
    deleted_by = '11111111-1111-1111-1111-111111111111'
where id = 'yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy'

Hinweis

Die WHERE-Klausel darf niemals entfernt werden. Ohne diese Einschränkung würden alle Content-Einträge als gelöscht markiert werden.

Was passiert nach der Behebung des Problems?

Nach erfolgreicher Bereinigung sollte sich das Input Management Dashboard wieder korrekt öffnen lassen.

Die betroffenen Batches können dann wieder geladen werden.

Um alle Dokumente aus dem Papierkorb zu exportieren, wurde die Input Management CLI um eine administrative Funktion erweitert.

Was ist zu beachten?

Hinweis
Die CLI ist als Entwicklungs- und Administrationswerkzeug gedacht und nicht für die Auslieferung an Endkunden vorgesehen. Nutzung auf eigene Gefahr.

Wie wird die CLI vorbereitet?

Nach dem Herunterladen des CLI-Pakets entpacken Sie das ZIP-Archiv.

Anschließend muss die enthaltene appsettings.json-Datei in einem Texteditor angepasst werden, sodass sie auf den richtigen Mandanten verweist.

Der Hostname, der sowohl für Authority als auch ServiceUrl eingetragen ist, muss durch die mandantenspezifische Domain des Kunden ersetzt werden.

Hinweis
Stellen Sie sicher, dass sowohl Authority als auch ServiceUrl auf den richtigen Mandanten zeigen. Sind diese Einstellungen nicht korrekt, schlagen Authentifizierung und Export fehl.

Wie authentifiziere ich mich?

Vor dem Exportieren von Dokumenten muss sich der Benutzer authentifizieren, um gültige Zugangsdaten zu erhalten.

STP.IM.Service.Cli.exe login

In der Konsole wird eine Hilfenachricht angezeigt.

Öffnen Sie den darin enthaltenen Link in einem Webbrowser. Auf der Anmeldeseite werden die angeforderten Berechtigungen angezeigt. Schließen Sie die Anmeldung ab, um fortzufahren.

Wie kann der Papierkorb exportiert werden?

Nach erfolgreicher Authentifizierung führen Sie folgenden Befehl aus:

STP.IM.Service.Cli.exe export-recycle-bin

Es ist möglich, einen Zielpfad für das Backup als einzigen Parameter dieses Befehls anzugeben.

STP.IM.Service.Cli.exe export-recycle-bin D:\my\recycle\bin\backup

Wo werden die exportierten Dokumente gespeichert?

Der Zielpfad ist optional.

Wird kein Zielpfad angegeben, wird im aktuellen Arbeitsverzeichnis ein Unterordner mit dem Namen recycleBinExport erstellt.

In diesem Ordner wird für jedes exportierte Dokument ein eigener Unterordner angelegt.

Jeder Dokumentenordner enthält die Originaldatei mit dem Namen, unter dem sie ursprünglich hochgeladen wurde.

Dieser Artikel wurde automatisch von einer KI übersetzt und kann Fehler enthalten.