WS-Beschreibung - Terminologieserver Administration ImportCodeSystem
Aus Termserver-CTS2
Version vom 8. August 2013, 09:20 Uhr von Becker (Diskussion | Beiträge)
Inhaltsverzeichnis |
Functionality
Imports a whole code system. There are two import formats available: ClaML and CSV.
You have to specify a code system for each import. All new concepts will be added to that code system.
Prerequisites
Requires Login.
Request/Response
Request
Parameter | Typ | Länge | Kardinalität | Beschreibung |
---|---|---|---|---|
LoginType | LoginType | 1..1 | Login-Informationen | |
sessionID | String | 1..1 | Die Session-ID des Benutzers | |
ImportType | ImportType | 1..1 | Import-Metadaten | |
filecontent | byte[] | 1..1 | Der Dateiinhalt. CSV-Dateien müssen mit ISO-8859-1 kodiert werden. | |
formatId | Long | 1..1 | Das Format des Dateiinhalts.
ClaML: 193 CSV: 194 LOINC: 200 LOINC Beziehungen: 201 KBV Keytab: 234 |
|
code_system | code_system | 1..1 | Name eines Codesystems/Vokabulars. Jedes Codesystem muss mindestens 1 Version besitzen. | |
description | String | 65535 | 0..1 | Beschreibung des anzulegenden Codesystems |
name | String | 100 | 1..1 | Name des anzulegenden Codesystems |
code_system_version | code_system_version | - | Die Version des anzulegenden Codesystems | |
description | String | 65535 | 0..1 | Beschreibung des Codesystems |
expirationDate | java.util.Date | 0..1 | Datum, bis wann die Version gültig ist | |
licenceHolder | String | 65535 | 0..1 | Besitzer der Lizenz |
name | String | 100 | 1..1 | Der Name der anzulegenden Codesystem-Version |
oid | String | 100 | 0..1 | Offizielle OID |
releaseDate | java.util.Date | 0..1 | Datum, ab wann die Version gültig ist | |
source | String | 65535 | 0..1 | Herausgeber der Codesystem-Version |
underLicence | Boolean | 1..1 | true, wenn das Vokabular unter Lizenzen fällt (ist dann für Benutzer ohne entsprechende Rechte nicht sichtbar) | |
licence_type | licence_type | 0..N | Arten von Lizenztypen | |
typeTxt | String | 65535 | 1..1 | Typ der Lizenz |
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 | ||
code_system | code_system | 1..1 | Name eines Codesystems/Vokabulars. Jedes Codesystem muss mindestens 1 Version besitzen. | |
currentVersionId | Long | 1..1 | Die neue ID der hinzugefügten Codesystem-Version | |
id | Long | 1..1 | Die neue ID des hinzugefügten Codesystems | |
code_system_version | code_system_version | 1..1 | Die Version des angelegtem Codesystems | |
versionId | Long | 1..1 | Die neue ID der hinzugefügten Codesystem-Version |
Examples
SOAP messages
Simple domain
Complex domain
Code example
Java
Annotations
Noteworthiness
CSV-Import
The comma separated file has to be build in this pattern:
- Syntax
- Coding: ISO-8859-1
- Fields will be separated by a ";"
- Strings has to be encapsulated with " ", if there are any special or delimiter symbols
- First row contains informations about columns
- Fields
- legal values
- code (either code or term are required)
- term (either code or term are required)
- term_abbrevation
- description
- is_axis (1/0 or true/false, standard: 0)
- is_mainclass (1/0 or true/false, standard: 0)
- is_preferred (1/0 or true/false, standard: 1)
- relation (Code, a association will be build up to)
- association_kind (1=ontological, 2=taxonomic, 3=cross mapping; standard: 2)
- association_type (Association description, string, e.g. 'is subclass of', required if 'relation' is set)
- association_type_reverse (Association description reversed, string, e.g. 'is upper class of', required if 'relation' is set)
- translation_XX (XX represents the ID of the language, that can be determined by the domains)
- metadata_XX (XX represents the names of metadata, that will be created automatically)
- legal values
*italic Entries are optional If no code is given, term will be used as code (cut to a maximum length of 100 characters)
Hints
Examples
Files
The following file shows a example of a csv import of a small code system with associations:CSV-Import_Beispiel
Example file (CSV) with some translations can be found here: Geschlechtercodes CSV
SOAP messages
<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> <!-- can be imported directly in Soap-UI (context menu) --> <formatId>194</formatId> </importInfos> <login> <sessionID>71a4f756-dc1a-41a6-941d-0e4fb0145f7f</sessionID> <!-- insert Session-ID from login --> </login> </parameter> </adm:ImportCodeSystem> </soapenv:Body> </soapenv:Envelope>