WS-Beschreibung - Terminologieserver Administration ImportValueSet
Aus Termserver-CTS2
Version vom 17. Januar 2013, 09:29 Uhr von Muetzner (Diskussion | Beiträge)
System | Terminologieserver |
Webservice | Administration |
WSDL | http://www.term.mi.fh-dortmund.de:8080/Terminologieserver/Administration?wsdl |
Methode | ImportValueSet |
Inhaltsverzeichnis |
Funktionalität
Mit ImportValueSet können Value Set-Inhalte in den Terminologieserver importiert werden. Dabei müssen die Daten im CSV-Format vorliegen.
Vorbedingungen
Erfordert Login.
Request/Response
Request
Parameter | Typ | Länge | Kardinalität | Beschreibung |
---|---|---|---|---|
importInfos | ImportType | 1..1 | Import-Metadaten | |
filecontent | byte[] | 1..1 | Der Dateiinhalt. CSV-Dateien müssen mit ISO-8859-1 kodiert werden. | |
LoginType | LoginType | 1..1 | Login-Informationen | |
sessionID | String | 1..1 | Die Session-ID des Benutzers | |
value_set | value_set | 1..1 | Stellt eine Untermenge von Begriffen dar. Jedes Valueset hat mindestens eine Valueset-Version. | |
description | String | 65535 | 0..1 | Beschreibung des Valuesets Dieses Feld wird nur benötigt, wenn Sie ein neues Value Set anlegen. |
id | Long | 0..1 | ID des Valuesets Sie müssen entweder die ID eines Value Sets angeben oder einen Namen angeben, falls Sie ein neues Value Set erstellen möchten. | |
name | String | 50 | 0..1 | Name des Valuesets Sie müssen entweder die ID eines Value Sets angeben oder einen Namen angeben, falls Sie ein neues Value Set erstellen möchten. |
value_set_version | value_set_version | 0..1 | Stellt die Version eines Valuesets dar. | |
preferredLanguageId | Long | 0..1 | Bevorzugte Sprache des Codesystems (ID ist aus der Domäne 'ISO_639_1_Language_Codes' mit der ID 1 zu entnehmen) | |
releaseDate | java.util.Date | 0..1 | Datum, ab dem die Valueset-Version gültig ist |
Response
Parameter | Typ | Länge | Kardinalität | Beschreibung |
---|---|---|---|---|
ReturnType | ReturnType | 1..1 | Enthält Informationen über die Antwort. | |
count | Integer | 1..1 | Anzahl der Ergebnisse | |
message | String | 1..1 | Status- oder Fehlermeldung | |
overallErrorCategory | 1..1 | INFO, WARN, ERROR | ||
status | 1..1 | OK, FAILURE | ||
value_set | value_set | 0..1 | Stellt eine Untermenge von Begriffen dar. Jedes Valueset hat mindestens eine Valueset-Version. | |
id | Long | 1..1 | ID des Valuesets | |
value_set_version | value_set_version | 1..1 | Stellt die Version eines Valuesets dar. | |
versionId | Long | 1..1 | Versions-ID des Valuesets |
Anmerkungen
Besonderheiten
CSV-Import
Die kommagetrennte Datei muss folgendermaßen aufgebaut sein:
- Syntax
- Codierung: ISO-8859-1
- Felder getrennt mit einem Semikolon ;
- Strings können, falls Sie Sonderzeichen oder Trennzeichen enthalten, mit " " angegeben werden
- 1. Zeile enthält Informationen über die Spalten
- Felder
- erlaubte Werte
- code (entweder code oder conecpt_id verpflichtend)
- concept_id (entweder code oder conecpt_id verpflichtend)
- codesystem_version_id (muss angegeben werden, wenn der code angegeben ist)
- erlaubte Werte
*Kursive Einträge sind optional
Ist keine Konzept-ID angegeben, wird die Code-Bezeichnung verwendet, um die Konzept-ID zu lesen (schlechtere Performance).
Hinweise
Beispiele
Dateien
SOAP-Nachrichten
Einfügen in ein neues Value Set
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:adm="http://administration.ws.terminologie.fhdo.de/"> <soapenv:Header/> <soapenv:Body> <adm:ImportValueSet> <parameter> <valueSet> <name>NEUER VALUESET NAME</name> </valueSet> <importInfos> <filecontent>BASE64-CONTENT</filecontent> <!-- kann man in Soap-UI direkt importieren (Kontextmenü) --> </importInfos> <login> <sessionID>b8857f39-fc81-47a1-bec7-1b7935814199</sessionID> <!-- Session-ID vom Login einfügen --> </login> </parameter> </adm:ImportValueSet> </soapenv:Body> </soapenv:Envelope>
Einfügen in ein vorhandenes Value Set
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:adm="http://administration.ws.terminologie.fhdo.de/"> <soapenv:Header/> <soapenv:Body> <adm:ImportValueSet> <parameter> <valueSet> <id>10</id> <valueSetVersions> <versionId>11</versionId> </valueSetVersions> </valueSet> <importInfos> <filecontent>BASE64-CONTENT</filecontent> <!-- kann man in Soap-UI direkt importieren (Kontextmenü) --> </importInfos> <login> <sessionID>b8857f39-fc81-47a1-bec7-1b7935814199</sessionID> <!-- Session-ID vom Login einfügen --> </login> </parameter> </adm:ImportValueSet> </soapenv:Body> </soapenv:Envelope>