WS-Beschreibung - Terminologieserver Search ListCodeSystemConcepts
Aus Termserver-CTS2
Version vom 26. März 2012, 11:04 Uhr von Muetzner (Diskussion | Beiträge)
System | Terminologieserver |
Webservice | Search |
WSDL | http://www.term.mi.fh-dortmund.de:8080/Terminologieserver/Search?wsdl |
Methode | ListCodeSystemConcepts |
Inhaltsverzeichnis |
Funktionalität
Listet alle Konzepte des angegebenen Vokabulars bzw. einer Vokabularversion an. Es können Filter benutzt werden um nach bestimmten Konzepten zu suchen. Welche Filter genutzt werden können ist der Eingabe-Tabelle zu entnehmen.
Vorbedingungen
Request/Response
Request
Parameter | Typ | Länge | Kardinalität | Beschreibung |
---|---|---|---|---|
LoginType | 0..1 | Login-Informationen | ||
ip | String | - | Die IP-Adresse des Benutzers (wird intern vergeben) | |
password | String | - | Passwort des Benutzers (als MD5-Wert) | |
sessionID | String | 1..1 | Die Session-ID des Benutzers | |
username | String | - | Benutzername | |
code_system | 1..1 | Name eines Codesystems/Vokabulars. Jedes Codesystem muss mindestens 1 Version besitzen. | ||
currentVersionId | Long | - | Die aktuelle Versions-ID | |
description | String | 65535 | - | Beschreibung eines Codesystems |
id | Long | 1..1 | ||
insertTimestamp | java.util.Date | - | Zeitstempel, wann das Codesystem eingefügt worden ist | |
name | String | 100 | - | Name des Codesystems. Der genau Name sollte in der Version angegeben werden |
code_system_version | 0..1 | Version eines Codesystems | ||
codeSystemId | Long | - | ||
description | String | 65535 | - | Beschreibung des Codesystems |
expirationDate | java.util.Date | - | Datum, bis wann die Version gültig ist | |
insertTimestamp | java.util.Date | - | Zeitstempel, wann die Codesystem-Version eingefügt worden ist | |
licenceHolder | String | 65535 | - | Besitzer der Lizenz |
name | String | 100 | - | Vollständiger Name des Codesystems |
oid | String | 100 | - | Offizielle OID |
preferredLanguageId | Long | - | Bevorzugte Sprache des Codesystems (ID ist aus der Domäne 'ISO_639_1_Language_Codes' mit der ID 1 zu entnehmen) | |
previousVersionID | Long | - | Gibt es mehr als 1 Version, zeigt diese ID auf die vorherige Version. | |
releaseDate | java.util.Date | - | Datum, ab wann die Version gültig ist | |
source | String | 65535 | - | Herausgeber der Codesystem-Version |
status | Integer | - | Der Status des aktuellen Eintrags. Kann einer Domäne entnommen werden. | |
statusDate | java.util.Date | - | Änderungszeitpunkt des Status | |
underLicence | Boolean | - | true, wenn das Vokabular unter Lizenzen fällt (ist dann für Benutzer ohne entsprechende Rechte nicht sichtbar) | |
versionId | Long | 1..1 | ||
code_system_entity | 0..1 | Abstrakte Klasse. Eine Eintrag muss mindestens einen Eintrag in code_system_entity_version besitzen. | ||
currentVersionId | Long | - | Die aktuelle ID der code_system_entity_version | |
id | Long | - | ||
code_system_entity_version | 0..1 | Ein code_system_entity_version ist die Oberklasse entweder eines Begriffs oder einer Beziehung. | ||
codeSystemEntityId | Long | - | ||
effectiveDate | java.util.Date | - | Zeitpunkt der letzten Änderung | |
insertTimestamp | java.util.Date | - | Zeitstempel, wann der Eintrag eingefügt worden ist | |
isLeaf | Boolean | - | Gibt an, wenn ein Begriff das Blattelement ist. Dieser Wert wird durch Trigger gesetzt, kann also nur gelesen werden. | |
majorRevision | Integer | - | Hauptversion dieses Eintrags (Zusammensetzung aus Haupt- und Nebenversion, z.B. 1.3) | |
minorRevision | Integer | - | Nebenversion dieses Eintrags (Zusammensetzung aus Haupt- und Nebenversion, z.B. 1.3) | |
previousVersionId | Long | - | Gibt es mehr als 1 Version, zeigt diese ID auf die vorherige Version. | |
status | Integer | - | Der Status des aktuellen Eintrags. Kann einer Domäne entnommen werden. | |
statusDate | java.util.Date | 0..1 | Änderungszeitpunkt des Status | |
versionId | Long | - | ||
code_system_concept | 0..1 | Stellt ein Konzept bzw. ein Begriff dar. Speziealisierung von code_system_entity_version. | ||
code | String | 100 | 0..1 | |
codeSystemEntityVersionId | Long | - | ||
isPreferred | Boolean | 1..1 | ||
term | String | 65535 | 0..1 | |
termAbbrevation | String | 50 | 0..1 | |
code_system_concept_translation | 0..1 | Übersetzung eines Begriffs. | ||
codeSystemEntityVersionId | Long | - | ||
id | Long | - | ||
languageId | Long | 0..1 | ||
term | String | 65535 | 0..1 | |
termAbbrevation | String | 50 | 0..1 | |
code_system_version_entity_membership | 0..1 | Stellt die Verknüpfung zwischen einer Codesystem-Version und den Entitäten her. | ||
codeSystemEntityId | Long | - | ||
codeSystemVersionId | Long | - | ||
isAxis | Boolean | 0..1 | true, wenn die zugehörige Entity des Eintrags eine Achse des Codesystems ist | |
isMainClass | Boolean | 0..1 | true, wenn die zugehörige Entity des Eintrags eine Hauptklasse (root-Element) des Codesystems ist | |
SearchType | 0..1 | Spezifiziert die Ergebnismenge von Suchergebnissen. | ||
caseSensitive | Boolean | 1..1 | true, wenn zwischen Groß- und Kleinschreibung unterschieden werden soll | |
pageIndex | Integer | 1..1 | Gibt den Index der Seite an, zu dem die Ergebnisse berechnet werden sollen (z.B. bei einer pageSize von 10 und einem Index von 2 werden die Ergebnisse 20-29 geliefert) | |
pageSize | Integer | 1..1 | Gibt die Anzahl der Ergebnisse pro Seite an | |
startsWith | Boolean | 1..1 | true, wenn das Ergebniswort mit dem Suchbegriff beginnen soll | |
traverseConceptsToRoot | Boolean | 1..1 | true, wenn (bei hierarchischen Codesystemen) zu einem Begriff alle Begriffe bis zur Wurzel abgerufen werden sollen. Die Suche dauert anhand der Traversierungen dementstprechend länger, deshalb sollte eine kleine pageSize gewählt werden | |
wholeWords | Boolean | 1..1 | true, wenn der Suchbegriff einem Ergebebniswort komplett übereinstimmen soll |
Response
Parameter | Typ | Länge | Kardinalität | Beschreibung |
---|---|---|---|---|
ReturnType | 1..1 | Entählt 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_entity | 0..N | Abstrakte Klasse. Eine Eintrag muss mindestens einen Eintrag in code_system_entity_version besitzen. | ||
currentVersionId | Long | 1..1 | Die aktuelle ID der code_system_entity_version | |
id | Long | 1..1 | ||
code_system_entity_version | 1..1 | Ein code_system_entity_version ist die Oberklasse entweder eines Begriffs oder einer Beziehung. | ||
codeSystemEntityId | Long | 1..1 | ||
effectiveDate | java.util.Date | 1..1 | Zeitpunkt der letzten Änderung | |
insertTimestamp | java.util.Date | 1..1 | Zeitstempel, wann der Eintrag eingefügt worden ist | |
isLeaf | Boolean | 1..1 | Gibt an, wenn ein Begriff das Blattelement ist. Dieser Wert wird durch Trigger gesetzt, kann also nur gelesen werden. | |
majorRevision | Integer | 1..1 | Hauptversion dieses Eintrags (Zusammensetzung aus Haupt- und Nebenversion, z.B. 1.3) | |
minorRevision | Integer | 1..1 | Nebenversion dieses Eintrags (Zusammensetzung aus Haupt- und Nebenversion, z.B. 1.3) | |
previousVersionId | Long | - | Gibt es mehr als 1 Version, zeigt diese ID auf die vorherige Version. | |
status | Integer | 1..1 | Der Status des aktuellen Eintrags. Kann einer Domäne entnommen werden. | |
statusDate | java.util.Date | 1..1 | Änderungszeitpunkt des Status | |
versionId | Long | 1..1 | ||
code_system_concept | 1..1 | Stellt ein Konzept bzw. ein Begriff dar. Speziealisierung von code_system_entity_version. | ||
code | String | 100 | 1..1 | |
codeSystemEntityVersionId | Long | 1..1 | ||
isPreferred | Boolean | 1..1 | ||
term | String | 65535 | 1..1 | |
termAbbrevation | String | 50 | 1..1 | |
code_system_concept_translation | 0..N | Übersetzung eines Begriffs. | ||
codeSystemEntityVersionId | Long | 1..1 | ||
id | Long | 1..1 | ||
languageId | Long | 1..1 | ||
term | String | 65535 | 1..1 | |
termAbbrevation | String | 50 | 1..1 | |
code_system_version_entity_membership | 1..1 | Stellt die Verknüpfung zwischen einer Codesystem-Version und den Entitäten her. | ||
codeSystemEntityId | Long | 1..1 | ||
codeSystemVersionId | Long | 1..1 | ||
isAxis | Boolean | 1..1 | true, wenn die zugehörige Entity des Eintrags eine Achse des Codesystems ist | |
isMainClass | Boolean | 1..1 | true, wenn die zugehörige Entity des Eintrags eine Hauptklasse (root-Element) des Codesystems ist |
Anmerkungen
Besonderheiten
Filter
Filter dienen dazu die Suche einzuschränken.
Such-Parameter
- pageSize und pageIndex: pageSize und pageIndex begrenzen die Menge an zurückgelieferten Treffern, damit die Suchanfragen nicht so viele Resourcen verbrauchen. pageSize gibt dabei an, wieviele Treffer angezeigt werden sollen. pageIndex gibt an, welche Treffer angezeigt werden sollen. Stellt man pageSize auf 5 und pageIndex auf 0, würden die Treffer 1-5 angezeigt werden. Stellt man pageIndex auf 2, die Treffer 11-15.
- traverseConceptsToRoot: Bewirkt, dass zu jedem gefundenem Konzept die übergeordneten Konzepte bis zur Wurzel mit angegeben werden.
- caseSensitive: Groß-/Kleinschreibung wird beachtet.
- startsWith: Konzept beginnt mit dem angegebenen Term.
- wholeWords: Nur nach ganzen Wörtern suchen.
Hinweise
Die Ergebnismenge kann sehr groß werden (ICD-10 ca. 28.000). Daher sollten Suchen ohne Filter vermieden werden.
Beispiele
SOAP-Nachrichten
Einfache Suche ohne Filter
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sear="http://search.ws.terminologie.fhdo.de/"> <soapenv:Header/> <soapenv:Body> <sear:ListCodeSystemConcepts> <parameter> <codeSystem> <codeSystemVersions> <versionId>1</versionId> </codeSystemVersions> <id>1</id> </codeSystem> </parameter> </sear:ListCodeSystemConcepts> </soapenv:Body> </soapenv:Envelope>
Suche nach Konzepten die einen bestimmten Term enthalten
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sear="http://search.ws.terminologie.fhdo.de/"> <soapenv:Header/> <soapenv:Body> <sear:ListCodeSystemConcepts> <parameter> <codeSystem> <codeSystemVersions> <versionId>4</versionId> </codeSystemVersions> <id>1</id> </codeSystem> <codeSystemEntity> <codeSystemVersionEntityMemberships> <isAxis>false</isAxis> </codeSystemVersionEntityMemberships> <codeSystemEntityVersions> <codeSystemConcepts> <term>Zungen</term> </codeSystemConcepts> </codeSystemEntityVersions> </codeSystemEntity> </parameter> </sear:ListCodeSystemConcepts> </soapenv:Body> </soapenv:Envelope>
Suche mit Filter- und Such-Kriterien
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:sear="http://search.ws.terminologie.fhdo.de/" xmlns:de="de.fhdo.termserver.types"> <soapenv:Header/> <soapenv:Body> <sear:ListCodeSystemConcepts> <parameter> <codeSystem> <codeSystemVersions> <versionId>4</versionId> </codeSystemVersions> <id>1</id> </codeSystem> <codeSystemEntity> <codeSystemEntityVersions> <codeSystemConcepts> <term>Zunge</term> <isPreferred>true</isPreferred> </codeSystemConcepts> </codeSystemEntityVersions> </codeSystemEntity> <searchParameter> <pageSize>5</pageSize> <pageIndex>0</pageIndex> <traverseConceptsToRoot>true</traverseConceptsToRoot> </searchParameter> </parameter> </sear:ListCodeSystemConcepts> </soapenv:Body> </soapenv:Envelope>