Fehlercodes
Jeder Job-Aufruf liefert einen ganzzahligen Rückgabewert: 0 bedeutet Erfolg, jeder andere Wert einen Fehler (siehe Einleitung). Diese Seite sammelt die bislang dokumentierten Fehlercodes zentral, gegliedert nach Bedeutung.
|
Diese Übersicht ist neu und noch nicht vollständig. Sie enthält ausschließlich Fehlercodes, die an anderer Stelle der Dokumentation oder aus konkreten Implementierungen beschrieben sind, und wird fortlaufend ergänzt. Das Fehlen eines Codes bedeutet nicht, dass er nicht auftreten kann. |
Alle Codes sind ganzzahlige (INT)-Rückgabewerte desselben Mechanismus. Sie sind in der Regel nicht jobspezifisch, sondern gelten übergreifend für die Job-Aufrufe (z. B. dms.XMLInsert, dms.XMLUpdate, dms.XMLImport, dms.GetResultList, Check-in/Check-out). Die Code-Spalte führt den dezimalen Rückgabewert (vorzeichenbehaftete 32-Bit-Ganzzahl). In der Jobs-Spalte sind die gegen einen enaio®-Server verifizierten Auslöser vermerkt.
1. Jobabhängige Besonderheiten
Folgende Beobachtungen wurden direkt gegen einen Testserver verifiziert und sind beim Auswerten der Rückgabewerte zu beachten:
-
Dieselbe Fehlerursache liefert je nach Job einen anderen Code:
-
Unbekanntes Feld: dms.XMLImport →
-24, dms.GetResultList →-1031. -
Unbekannter Objekttyp: dms.XMLImport →
-7, dms.GetResultList →-1030.
-
-
dms.XMLImport meldet XML-Strukturfehler als generisches
-1. Die eigentliche Diagnose steht nur imDMSResult-Buffer, nicht im Rückgabewert. dms.GetResultList liefert dagegen spezifische Codes (-1016/-1029). -
Jeder Server-Namespace hat eigene Codes für Parameterfehler. Die
dms.-Jobs liefern kleine, dokumentierte Codes (-1024/-1025) oder-1;std.,mng.,wfm.undkrn.*liefern stattdessen große, HRESULT-artige Werte (siehe Parameterfehler nach Namespace). -
Kein-Fehler-Fälle: Manche Jobs liefern bei einer fachlich negativen Antwort dennoch
0— das Ergebnis steckt im Ausgabewert, nicht im Rückgabewert. Beispiele: dms.GetUserData und dms.IsUserData mit unbekanntem Namen; krn.VerifyPassword mit falschem Passwort; ado.ExecuteSQL mit ungültigem SQL (return_code = 0und leeres Ergebnis — der SQL-Fehler wird verschluckt, eine Fehlererkennung darf sich hier nicht auf den Rückgabewert verlassen). -
Konfigurationsabhängige Befunde: dms.XMLMove kann eine serverseitig konfigurierte Zielkapazität durchsetzen (
-89bei Überschreitung).-1012(Register in ein eigenes Kind verschieben) war auf dem Testserver nicht reproduzierbar — der Move wurde mitreturn_code = 0zugelassen; das Verhalten ist somit nicht garantiert.
2. Parameterfehler nach Namespace
Jeder Server-Namespace liefert für Parameterfehler eigene Codes, gegliedert nach Fehlerklasse. Die dms.-Jobs geben kleine, in dieser Liste dokumentierte Codes zurück; die übrigen Namespaces (std., mng., wfm., krn.*) liefern stattdessen große, HRESULT-artige Werte:
| Namespace | Parameter fehlt | Parametertyp falsch | Wert nicht unterstützt |
|---|---|---|---|
|
|
|
— |
|
|
|
— |
|
|
|
— |
|
|
|
— |
|
— |
— |
|
|
Diese Tabelle ist nicht abschließend. Auch weitere Namespaces und Jobs ( |
3. Allgemeine Fehler
| Code | Bedeutung | Jobs |
|---|---|---|
|
Allgemeiner Fehler (nicht näher spezifizierbar). |
dms.XMLImport bei XML-Strukturfehlern (Details nur im |
|
Kein Schrank angegeben. |
|
|
Kein Registertyp angegeben. |
|
|
Kein Dokumenttyp angegeben. |
|
|
Erforderliche Mappen-Identifikation fehlt. Server-Meldung: |
dms.XMLImport (Dokument-Insert ohne |
|
Erforderliche Dokument-Identifikation fehlt. |
|
|
Erforderliche Register-Identifikation fehlt. |
|
|
Aktualisierung der Mappe fehlgeschlagen. |
|
|
Aktualisierung des Dokuments fehlgeschlagen. |
|
|
Aktualisierung des Registers fehlgeschlagen. |
|
|
Der Feldname konnte nicht aufgelöst werden. Server-Meldung: |
dms.XMLImport (unbekanntes Feld) (verifiziert) |
|
Der Wert für das angegebene Feld ist nicht zulässig. |
|
|
Die angegebene Objekt-ID ist ungültig. |
|
|
Die Pflichtfelder wurden nicht ausgefüllt. Server-Meldung: |
dms.XMLImport (verifiziert) |
|
Der angegebene Wert entspricht nicht dem Typ auf dem Archivserver. Server-Meldung: |
dms.XMLImport (ungültiger Datums-/Dezimalwert) (verifiziert) |
|
Ein Übergabeparameter ist fehlerhaft oder fehlt. |
|
|
Es konnte kein Index vom Server bezogen werden. |
|
|
Es wurde keine Dokumentliste angegeben. |
|
|
Die angeforderte Funktionalität ist in der aktuellen Version nicht implementiert. |
|
|
Beim Lesen der Objektdefinitionen ist ein Fehler aufgetreten. |
|
|
Es wurde eine System-ID, aber keine Fremd-ID angegeben. |
|
|
Beim Parsen des XML-Texts ist ein Fehler aufgetreten. Server-Meldung: |
dms.GetResultList (fehlerhaftes XML / fehlendes Typ-Attribut) (verifiziert) |
|
Bei der Validierung des XML-Texts ist ein Fehler aufgetreten. |
|
|
Der XML-Text ist unvollständig. |
|
|
Ein Job-Parameter fehlt oder hat den falschen Typ. Server-Meldung: |
dms.GetObjectDetails (fehlend und falscher Typ), dms.GetObjectTypeByID, dms.RemoveStoredQuery, dms.IsUserData, dms.GetUserData (verifiziert) |
|
Der angegebene Parameterwert ist ungültig oder fehlt. Server-Meldung: |
dms.GetResultList, dms.ExecuteStoredQuery, dms.GetStoredQuery (verifiziert) |
|
Für ein Tabellenfeld wurden mehr Werte angegeben als Spalten vorhanden sind. |
|
|
Beim Einfügen der Notiz-Objekte/-Texte ist ein Fehler aufgetreten. |
|
|
Ein XML-Element ist unbekannt oder falsch positioniert. Server-Meldung: |
dms.GetResultList (verifiziert) |
|
Der Job wurde auf Benutzerwunsch abgebrochen. |
|
|
Die angegebene Bedingung ist ungültig. |
|
|
Ein XML-Attribut ist ungültig. |
|
|
Ein erforderliches XML-Attribut fehlt. |
|
|
Die Userdata-Angaben sind nicht eindeutig. |
|
|
Das Abfrageformat wird nicht unterstützt. |
|
|
Ein Ausdruck hat ein ungültiges Format. |
|
|
Der Sektionsname ist ungültig. |
|
|
Allgemeiner Fehler beim Lesen der Abfrage. |
|
|
Unbekannter Abfragetyp. |
|
|
Die Abfrage konnte nicht verarbeitet werden. |
|
|
Die Volltextabfrage enthält nur Wörter, die ignoriert werden sollen. |
|
|
Es ist nicht genügend Speicher verfügbar. |
|
Ein als Pflicht markierter GUID-Parameter ist leer ( |
||
|
Fehlender oder typfalscher Parameter im |
|
|
Fehlender Parameter im |
|
|
Falscher Parametertyp im |
|
|
Nicht unterstützter Parameterwert im |
4. Objekt / Ressource nicht gefunden
| Code | Bedeutung | Jobs |
|---|---|---|
|
Angegebener Schrank unbekannt. |
|
|
Angegebener Registertyp unbekannt. |
|
|
Angegebener Dokumenttyp unbekannt. Server-Meldung: |
dms.XMLImport (unbekannter Objekttyp) (verifiziert) |
|
Erforderliche Register-Identifikation unbekannt. |
|
|
Erforderliche Mappen-Identifikation unbekannt. |
|
|
Erforderliche Dokument-Identifikation unbekannt. |
|
|
Das angegebene/erforderliche Objekt ist unbekannt. Server-Meldung: |
dms.XMLUpdate, dms.XMLDelete, dms.XMLMove ( |
|
Die ID des angegebenen Registers existiert nicht auf dem Archivserver. |
|
|
Die angegebene/erforderliche Datei existiert nicht. |
|
|
Der angegebene Wert konnte im zugehörigen Katalog nicht gefunden werden. |
|
|
Der angegebene Eigentümer konnte nicht ermittelt werden. |
|
|
Die Referenz wurde nicht gefunden. |
|
|
Ein Objekttyp wurde auf dem DMS-Server nicht gefunden. Server-Meldung: |
dms.GetResultList (unbekannter Objekttyp) (verifiziert) |
|
Ein Objektfeld wurde auf dem DMS-Server nicht gefunden. Server-Meldung: |
dms.GetResultList (unbekanntes Feld) (verifiziert) |
|
Die übergeordnete Variante des Dokuments konnte nicht ermittelt werden. |
|
|
Die Dokumentvariante konnte nicht ermittelt werden. Server-Meldung: |
dms.XMLImport ( |
|
Die Abfrage wurde nicht gefunden. Server-Meldung: |
dms.ExecuteStoredQuery, dms.GetStoredQuery, dms.RemoveStoredQuery (unbekannte Query-ID) (verifiziert) |
|
Der Schrankname konnte nicht gelesen werden. |
|
|
Der Dokumentname konnte nicht gelesen werden. |
|
|
Der Registername konnte nicht gelesen werden. |
|
|
Der Ablageort des Objekts konnte nicht ermittelt werden. |
5. Falscher Zustand / ungültige Operation
| Code | Bedeutung | Jobs |
|---|---|---|
|
Das angegebene Register befindet sich nicht in der angegebenen Mappe. |
|
|
Der angegebene Dokumenttyp ist im angegebenen Schrank nicht zulässig. |
|
|
Das Dokument wurde bereits archiviert. |
|
|
Das Dokument hat keine Seiten. |
|
|
Das Verschieben von Mappen ist nicht zulässig. Server-Meldung: |
dms.XMLMove (Ordner verschieben nicht erlaubt) (verifiziert) |
|
Die Beziehung zwischen Dokument und Register ist nicht zulässig. Server-Meldung: |
dms.XMLImport (Dokument an unzulässigem Speicherort); dms.XMLMove (Ziel-Ordner nicht gefunden / Zielkapazität überschritten) (verifiziert) |
|
Verweisdokumente können nicht ohne Angabe eines Ablageorts verschoben werden. |
|
|
Dokumentseiten sind nicht zulässig. |
|
|
Das Schlüsselfeld ist nicht eindeutig. Server-Meldung: |
dms.XMLImport (Key-Field-Kombination nicht eindeutig) (verifiziert) |
|
Das angegebene Objekt ist mit einem Workflow-Prozess verbunden. |
|
|
Das Objekt befindet sich im Papierkorb. Server-Meldung: |
dms.XMLDelete (Objekt bereits im Papierkorb) (verifiziert) |
|
Das Dokument befindet sich in einem Portfolio. |
|
|
Die Rekursionstiefe ist zu groß, die Aktion wurde abgebrochen. |
|
|
Das Zielregister ist ein Kind des zu verschiebenden Registers. |
|
|
An ein Verweisdokument können keine Seiten angehängt werden. |
|
|
Das Dokument kann kein anderes Dokument referenzieren, da es Seiten besitzt. |
|
|
Der Objekttyp ist für diese Operation ungültig. |
|
|
Das kaskadierende Löschen ist nicht zulässig, das Objekt hat noch Kindobjekte. Server-Meldung: |
dms.XMLDelete (Objekt hat noch Kindobjekte) (verifiziert) |
|
Es dürfen nur Dokumente aus-/eingecheckt werden. Server-Meldung: |
dms.CheckOutDocument (Zielobjekt ist kein Dokument) (verifiziert) |
|
Das Dokument wurde eingecheckt. Server-Meldung: |
dms.UndoCheckOutDocument (Dokument war nicht ausgecheckt) (verifiziert) |
|
Das Dokument wurde ausgecheckt. |
|
|
Das Dokument wurde von einem anderen Benutzer ausgecheckt. |
|
|
Das Dokument wurde an einer anderen Station ausgecheckt. |
|
|
Das Dokument kann nicht ausgecheckt werden, da es keine Seiten besitzt. Server-Meldung: |
dms.CheckOutDocument (Dokument ohne Seiten) (verifiziert) |
|
Das Dokument befindet sich nicht in der Workflow-Ablage. |
|
|
Das Dokument befindet sich in der Workflow-Ablage. |
|
|
Neue Varianten dürfen nur für W-Dokumente erstellt werden. |
|
|
Eine gleichzeitige Aktualisierung eines Objekts ist fehlgeschlagen (veralteter |
dms.XMLUpdate (verifiziert) |
|
Die Kopie des Objekts existiert bereits am angegebenen Ablageort. |
|
|
Die neue Variante wurde erstellt, konnte aber nicht auf „Aktiv" gesetzt werden. |
|
|
Das Verschieben oder Verknüpfen von Objekten ist systemweit gesperrt. |
|
|
Das Dokument existiert bereits am Ablageort. |
|
|
Das Kopieren von Objekten mit Schlüsselfeldern ist nicht zulässig. |
|
|
Es wurde als Aktion für die Trefferanzahl |
dms.XMLImport (Quellcode-Kommentar) |
6. Zugriff verweigert
| Code | Bedeutung | Jobs |
|---|---|---|
|
Der Benutzer hat nicht die erforderlichen Rechte auf dem Archivserver. |
|
|
Es wurde versucht, ein schreibgeschütztes Feld zu setzen. |
|
|
Auf eine angeforderte Datei konnte nicht zugegriffen werden. |
|
|
Das angegebene Systemfeld kann vom Benutzer nicht geändert werden. |
|
|
Es ist dem Benutzer nicht möglich, die Rechteprüfung zu deaktivieren. |
|
|
Das angegebene Passwort ist falsch. Server-Meldung: |
krn.SessionChangePassword (falsches altes Passwort) (verifiziert) |
|
Das neue und das alte Passwort sind identisch. |
|
|
Der Zugriff auf eine Systemressource wurde verweigert. |
dms.GetObjectDetails (Rechteprüfung vor ID-Prüfung) (beobachtet) |
Die Lizenz LIS fehlt, obwohl OSFTS mit |
||
Dem aufrufenden Benutzer fehlt die Systemrolle |
Verändernde mng-Jobs für Benutzer und Gruppen (z. B. mng.CreateUser) |
|
Dem aufrufenden Benutzer fehlt die Systemrolle |
krn.RunScript (verifiziert) |