Nedenfor findes en liste over de fejlsvar OpenXDS kan give i forbindelse med kald af servicens snitflader ITI-41 (ProvideAndRegisterDocumentSet) og ITI-43 (RetrieveDocumentSet). Alle fejl returneres som RegistryError-elementer i standard IHE-svarstruktur. Alle kald med fejl returnerer med http status 200 OK.
Listen er grupperet efter snitflade - først listet de fejl, som er fælles for snitfladerne, herefter ITI-41 og til sidst ITI-43.
OpenXDS kalder også NXRG for at registrere metadata omkring dokumenterne med ITI-42 (RegisterDocumentSet) så OpenXDS kan returnere fejlsvar fra NXRG, som dermed ikke er beskrevet i detaljer i det nedenstående, men alene inkluderet som et element i fejlgrupperingerne med link til relevant dokumentation.
Tabellen indholder følgende kolonnner
| Fejltekst | IHE fejlkategori | Begrundelse for fejl | Anvisning til hvordan man bør håndtere fejlen | |
|---|---|---|---|---|
| SOAP/HTTP-protokolfejl. De kan forekomme for både ITI-41 og ITI-43 kald Disse fejl gælder begge endpoints og opstår, inden den egentlige forretningstransaktion behandles. De skyldes mangler i den indkommende SOAP-meddelelse. | ||||
Request body is null | XDSRepositoryError | SOAP request body er null – forespørgslen er tom eller HTTP-body kunne ikke læses af Axis2-frameworket. | Der skal fejlsøges og justeres i kaldet, der er lavet mod OpenXDS | |
| SOAP 1.1 not supported | XDSRepositoryError | Kalderen har sendt en SOAP 1.1-meddelelse; serveren kræver SOAP 1.2. | ||
| No SOAP envelope found | XDSRepositoryError | SOAP-konvolutten mangler helt i meddelelsen, fx fordi HTTP-content-type ikke er sat korrekt eller body er tom. | ||
| No SOAP header found | XDSRepositoryError | SOAP-headeren mangler i konvolutten; den er påkrævet for WS-Addressing-elementerne. | ||
| WS-Action required in header | XDSRepositoryError | WS-Addressing Action-elementet mangler i SOAP-headeren; det er obligatorisk for at identificere transaktionstypen. | ||
| This transaction must use MTOM, SIMPLE SOAP found | XDSRepositoryError | Endpoint kræver MTOM-encoding, men kalderen har sendt en simpel SOAP-meddelelse uden MIME-vedhæftninger. | ||
ITI-41 – XML-namespace og skemavalidering Disse fejl er specifikke for ITI-41 og opstår ved validering af XML-namespace og XML-skema på den indkommende ProvideAndRegisterDocumentSetRequest | ||||
| Invalid namespace on ProvideAndRegisterDocumentSetRequest <namespace-uri> | XDSRepositoryError | ProvideAndRegisterDocumentSetRequest-elementet har en forkert XML-namespace-URI i stedet for den forventede IHE XDS.b-namespace. | Der skal fejlsøges og justeres i kaldet, der er lavet mod OpenXDS | |
| Schema Validation Errors: Input did not validate against schema:<schemafejl> | XDSRepositoryError | XML-strukturen i anmodningen opfylder ikke det tilknyttede XML-skema – fx manglende obligatoriske elementer, forkert elementrækkefølge eller ugyldig attributværdi. | ||
| XDS Internal Error: Schema Validation threw internal error: <fejlbesked> | XDSRepositoryError | Selve XML-schemavalidatoren finder en fejl under validering – typisk pga. ressourcemangel, låst schemafil eller JVM-fejl. | Kontakt support | |
ITI-41 – Metadata-struktur og overensstemmelse mellem dokumenter og metadata Disse fejl opstår ved validering af SubmitObjectsRequest-strukturen og sammenhængen mellem de indsendte dokumenter og de tilhørende ExtrinsicObject-elementer i metadata. | ||||
| Test input incorrect: Cannot find SubmitObjectsRequest element in submission - top level element is <elementnavn> | XDSRepositoryMetadataError | Det øverste XML-element i forsendelsen er ikke SubmitObjectsRequest; kalderen har sendt et forkert eller malformet dokument. | Der skal fejlsøges og justeres i kaldet, der er lavet mod OpenXDS | |
| Document with id <id> is missing | XDSMissingDocument | Metadata indeholder et ExtrinsicObject med det angivne id, men der er intet tilsvarende Document-element med samme id i forsendelsen. | ||
| XDSDocumentEntry with id <id> is missing | XDSMissingDocumentMetadata | Forsendelsen indeholder et Document-element, men metadata mangler et ExtrinsicObject med samme id. | ||
| Submission contained <N> documents but <M> ExtrinsicObjects in metadata - they must match | XDSMissingDocumentMetadata | Antallet af Document-elementer i forsendelsen stemmer ikke overens med antallet af ExtrinsicObjects i metadata. | ||
| Cannot find attachment for id <id> | XDSMissingDocument | XDS.a: Forsendelsen indeholder et ExtrinsicObject-id, men der er ingen MIME-vedhæftning i meddelelsen med dette id. | ||
| Metadata Validation Errors: Document submitted with id of <id> but no ExtrinsicObject exists in metadata with same id | XDSRepositoryError | Dokumentets id matcher ikke noget ExtrinsicObject i metadata – konstateret ved opstart af lagring; kan ske ved intern inkonsistens. | ||
| Metadata Validation Errors: Document <id> does not have a Unique ID | XDSRepositoryError | ExtrinsicObject mangler XDSDocumentEntry.uniqueId external identifier; påkrævet for at identificere dokumentet entydigt. | ||
| Metadata Validation Errors: ExtrinsicObject <id> does not have a mimeType | XDSRepositoryError | ExtrinsicObject mangler mimeType-attributten; påkrævet for at bestemme dokumentets filformat ved lagring. | ||
ITI-41 – Dokumentegenskaber, XOP-encoding og lagring i repository Disse fejl opstår ved beregning og validering af dokumentegenskaber samt ved den fysiske lagring af dokumenter i repository-komponenten. | ||||
| XDS IO Error: Submission uses XOP for optimized encoding - not acceptable on this endpoint | XDSRepositoryError | Dokumentets binære data er XOP-encodet (isOptimized=true på OMText-node), men endpoint er konfigureret med accept_xop=false. | Der skal fejlsøges og justeres i kaldet, der er lavet mod OpenXDS | |
| XDS IO Error: Submission uses XOP for optimized encoding - this is not acceptable on this endpoint | XDSRepositoryError | Dokumentdata er pakket i en DataHandler (optimeret), men endpoint accepterer ikke XOP-optimering. | ||
| Size attribute in Provide and Register metadata does not match supplied document: Metadata has <størrelse> and contents has <beregnet-størrelse> | XDSRepositoryMetadataError | Kalderen har angivet en size-attribut i metadata, som ikke matcher den faktisk beregnede størrelse på det modtagne dokument. | ||
| Hash attribute in Provide and Register metadata does not match supplied document: Metadata has <hash> and contents has <beregnet-hash> | XDSRepositoryMetadataError | Kalderen har angivet en hash-attribut i metadata, som ikke matcher den faktisk beregnede SHA-1-hash på det modtagne dokument. | ||
| XDS Internal Error: Error saving document to the repository - document unique id already exist in repository | XDSRepositoryError | Dokumentets unique id er allerede registreret i databasen med en anden hash-værdi; dokumentet eksisterer men indholdet er forskelligt. | ||
| XDS Internal Error: XDS.a: PnR: no MessageContext | XDSRepositoryError | XDS.a-forsendelse, men MessageContext er null; indikerer en intern Axis2-konfigurationsfejl. | Kontakt support | |
| XDS Internal Error: Error calculating size on repository file | XDSRepositoryError | Fejl ved beregning af dokumentets byte-størrelse fra DataHandler (SWA/XOP-sti); typisk en I/O-fejl ved læsning af MIME-vedhæftningen. | ||
| XDS Internal Error: Error calculating hash on repository file | XDSRepositoryError | Fejl ved beregning af SHA-1-hash på dokumentdata; kan skyldes I/O-fejl eller manglende kryptografiprovider. | ||
| XDS Internal Error: Error saving document to the repository - error while converting datahandler object into byte array | XDSRepositoryError | I/O-fejl ved læsning af dokumentindholdet fra DataHandler's InputStream, fx ved en netværksfejl. | ||
| XDS Internal Error: Error saving document to the repository - error closing inputstream | XDSRepositoryError | Fejl ved lukning af InputStream efter læsning af dokumentdata; ressourcen kunne ikke frigives korrekt. | ||
ITI-41 – Videresendelse til registry via ITI-42 Efter at dokumenterne er gemt i repository, videresendes SubmitObjectsRequest til registry via et internt ITI-42 SOAP-kald. Fejl i dette kald kan enten skyldes kommunikationsfejl mod registry, eller at registry returnerer et fejlsvar. | ||||
| <fejlbesked fra SOAP-kommunikationsfejl mod registry> | XDSRepositoryError | Netværksfejl, timeout eller SOAP-protokolfejl ved det interne SOAP-kald til registry's ITI-42 endpoint. | Kontakt support | |
| Null response message from Registry | XDSRepositoryError | Det interne ITI-42 SOAP-kald returnerede null som resultat i stedet for et RegistryResponse-element; indikerer kommunikationsfejl mod registry. | ||
| Null status from Registry | XDSRepositoryError | Registry-svaret indeholder ikke en status-attribut; svaret er defekt eller parsingen af svaret fejlede. | ||
| Registry returned Failure but no error list | XDSRepositoryError | Registry returnerede status=Failure men svaret indeholdt ingen RegistryErrorList; registry har ikke givet nogen fejlforklaring. | ||
| <fejlbesked fra uventet exception under registry-kald> | XDSRepositoryError | Uventet fejl i forbindelse med kald til registry. | ||
| Fejlkoder og fejltekster fra registry propageres uændret | Registry returnerede status=Failure med en RegistryErrorList; fejlene er defineret af registry-komponenten og kan fx skyldes dubletter, ukendt patient-id eller ACL-regler. | Se dokumentation for NXRG | ||
ITI-41 – Uventet fejl Denne fejl er specifik for ITI-41 og opstår når ikke andre fejltyper dækker. | ||||
| Input Error - no SOAP Body: <fejlbesked> | XDSRepositoryError | En uventet fejl der ikke er af de kendte typer ; opstår kun ved en programfejl eller uforudset runtime-fejl. | Kontakt support | |
ITI-43 – XML-namespace og skemavalidering Disse fejl er specifikke for ITI-43 og opstår ved validering af XML-namespace og XML-skema på den indkommende RetrieveDocumentSetRequest | ||||
| Invalid namespace on RetrieveDocumentSetRequest <namespace-uri> | XDSRepositoryError | RetrieveDocumentSetRequest-elementet har en forkert XML-namespace-URI i stedet for den forventede IHE XDS.b-namespace. | Der skal fejlsøges og justeres i kaldet, der er lavet mod OpenXDS | |
| Schema validation errors: <fejlbesked fra skemavalidator> | XDSRepositoryError | XML-strukturen i RetrieveDocumentSetRequest opfylder ikke XML-skemaet, eller selve schemavalidatoren giver en fejl. | ||
ITI-43 – Dokument-forespørgsel og hentning fra repository Disse fejl opstår under behandlingen af selve RetrieveDocumentSetRequest, dvs. når de individuelle DocumentRequest-elementer afkodes og dokumenterne hentes fra repository | ||||
| Request Validation Error: Cannot extract RepositoryUniqueId from DocumentRequest | XDSRepositoryError | Et DocumentRequest-element mangler RepositoryUniqueId-subelementet, eller det er tomt; påkrævet for at identificere repository. | Der skal fejlsøges og justeres i kaldet, der er lavet mod OpenXDS | |
| Request Validation Error: Cannot extract DocumentUniqueId from DocumentRequest | XDSRepositoryError | Et DocumentRequest-element mangler DocumentUniqueId-subelementet, eller det er tomt; påkrævet for at identificere dokumentet. | ||
| Repository Unique ID in request <req-id> does not match this repository's id <rep-id> | XDSRepositoryWrongRepositoryUniqueId | Det angivne RepositoryUniqueId svarer ikke til dette repository's id; kalderen har henvendt sig til et forkert repository-endpoint. | ||
| Document not found in repository: Document='<doc-id>', Repository='<rep-id>' | XDSMissingDocument | Dokumentet kan ikke hentes fordi det ikke findes | ||
| Cannot find repository item for document id, <doc-id> | XDSRepositoryError | Dokumentet kan ikke hentes fordi noget gik galt i fremsøgningen | Kontakt support | |