WS-Beschreibung - Terminologieserver Administration ImportValueSet
Aus Termserver-CTS2
Version vom 17. Januar 2013, 07:34 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
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 term verpflichtend)
- term (entweder code oder term verpflichtend)
- term_abbrevation
- description
- is_axis (1/0 oder true/false, Standard: 0)
- is_mainclass (1/0 oder true/false, Standard: 0)
- is_preferred (1/0 oder true/false, Standard: 1)
- relation (Code, zu dem eine Beziehung aufgebaut wird)
- association_kind (1=ontologisch, 2=taxonomisch, 3=cross mapping; Standard: 2)
- association_type (Assoziationsbeschreibung, String, z.B. 'ist Unterklasse von', verpflichtend, wenn 'relation' angegeben ist)
- association_type_reverse (Assoziationsbeschreibung rückwärts, String, z.B. 'ist Oberklasse von', verpflichtend, wenn 'relation' angegeben ist)
- translation_XX (XX steht für eine ID einer Sprache, welche über die Domains bestimmt werden kann)
- erlaubte Werte
*Kursive Einträge sind optional
Ist kein Code angegeben, wird die Term-Bezeichnung dafür verwendet (wird gekürzt auf eine max. Länge von 100 Zeichen)
Hinweise
Beispiele
Dateien
Die folgende Datei zeigt ein Beispiel eines CSV-Imports mit einem kleinen Vokabular inklusive Beziehungen: CSV-Import_Beispiel
Eine Beispieldatei (CSV) mit verschiedenen Übersetzungen ist hier zu finden: Geschlechtercodes CSV
SOAP-Nachrichten
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:adm="http://administration.ws.terminologie.fhdo.de/"> <soapenv:Header/> <soapenv:Body> <adm:ImportCodeSystem> <parameter> <codeSystem> <codeSystemVersions> <name>Administrative sex (HL7)</name> <underLicence>0</underLicence> </codeSystemVersions> <name>Administrative sex (HL7)</name> </codeSystem> <importInfos> <filecontent>BASE64-CONTENT</filecontent> <!-- kann man in Soap-UI direkt importieren (Kontextmenü) --> <formatId>194</formatId> </importInfos> <login> <sessionID>71a4f756-dc1a-41a6-941d-0e4fb0145f7f</sessionID> <!-- Session-ID vom Login einfügen --> </login> </parameter> </adm:ImportCodeSystem> </soapenv:Body> </soapenv:Envelope>