WS-Beschreibung - Terminologieserver Search ListCodeSystemConcepts

Aus Termserver-CTS2
Wechseln zu: Navigation, Suche
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.
codeSystemType String 30 - Gibt den Typ des Codesystems an (z.B. Taxonomie, Ontologie, ...). Eine mögliche Werteliste ist in der Domaintabelle vorhanden.
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 Der Code zu einem Begriff bzw. Konzepts
codeSystemEntityVersionId Long -
description String - Beschreibung zu einem Begriff
isPreferred Boolean 1..1 Gibt an, ob es sich um einen Vorzugsbegriff handelt
term String 65535 0..1 Der Begriff selbst
termAbbrevation String 50 0..1 Abkürzung des Begriffs
code_system_concept_translation 0..1 Übersetzung eines Begriffs.
codeSystemEntityVersionId Long -
description String - Beschreibung des übersetzten Begriffs
id Long -
languageId Long 0..1 Sprache der Übersetzung. Der Wert kommt von Domain-Value mit der Domain-ID 1 (ISO_639_1_Language_Codes)
term String 65535 0..1 Übersetzter Begriff
termAbbrevation String 50 0..1 Abkürzung des übersetzten Begriffs
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
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
PagingType 0..1
allEntries Boolean 0..1 true, wenn alle Einträge unabhängig von der pageSize zurückgegeben werden sollen. Dieses Attribut benötigt Berechtigungen, so dass man sich vorher einloggen muss.
pageIndex Integer 1..1 Gibt die Seite an, für welche die Ergebnisse zurückgegeben werden sollen. Ist z.B. pageSize mit 20 und pageIndex mit 2 angegeben, so werden die Einträge 40-59 zurückgegeben.
pageSize Integer 1..1 Gibt die gewünschte Anzahl an Treffern an, welche auf einer Seite dargestellt werden. Überschreitet der Wert die maximale Systemgröße, wird dieser automatisch verkleinert.

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 Der Code zu einem Begriff bzw. Konzepts
codeSystemEntityVersionId Long 1..1
description String - Beschreibung zu einem Begriff
isPreferred Boolean 1..1 Gibt an, ob es sich um einen Vorzugsbegriff handelt
term String 65535 1..1 Der Begriff selbst
termAbbrevation String 50 1..1 Abkürzung des Begriffs
code_system_concept_translation 0..N Übersetzung eines Begriffs.
codeSystemEntityVersionId Long 1..1
description String - Beschreibung des übersetzten Begriffs
id Long 1..1
languageId Long 1..1 Sprache der Übersetzung. Der Wert kommt von Domain-Value mit der Domain-ID 1 (ISO_639_1_Language_Codes)
term String 65535 1..1 Übersetzter Begriff
termAbbrevation String 50 1..1 Abkürzung des übersetzten Begriffs
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
PagingResultType 0..1 Wird automatisch zurückgegeben, wenn die Treffermenge größer der maximalen Systembegrenzung ist. Die Treffermenge wird dabei automatisch verkleinert. Ist z.B. pageSize mit 20 und pageIndex mit 2 angegeben, so werden die Einträge 40-59 zurückgegeben.
maxPageSize Integer 1..1 Systembeschränkung für maximale Einträge pro Seite
pageIndex Integer 1..1 aktuelle Seite
pageSize Integer 1..1 Anzahl an Treffern pro Seite

Anmerkungen

Besonderheiten

Filter

Filter dienen dazu die Suche einzuschränken.

Such-Parameter

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>

Code-Beispiele

Java

 
Von „http://www.wiki.mi.fh-dortmund.de/cts2/index.php?title=WS-Beschreibung_-_Terminologieserver_Search_ListCodeSystemConcepts“
Meine Werkzeuge
Namensräume
Varianten
Aktionen
Navigation
Werkzeuge