museumvok-ws: Schnittstellen-Definition

Initiative museumsvokabular.de Web Services für kontrolliertes Vokabular museumvok-ws: Schnittstellen-Definition Version 0.4 Stand 14.08.2007 Autoren: Regine Stein & Carlos Saro Konrad-Zuse-Zentrum für Informationstechnik (ZIB) Takustr. 7 D 14195 Berlin stein@zib.de saro@zib.de Seite 1 /24

Einleitung... 3 museumvok-ws: Funktionen und Parameter... 4 Beschreibung der Parameter... 4 Übergabeparameter:... 4 direction... 4 Id... 4 IdList... 4 level... 5 password... 5 returnmode... 5 returnnumberofconcepts... 5 schema... 5 schemelist... 6 searchfields... 6 searchlang... 6 searchtermmode... 6 server... 7 session_id... 7 sortfield... 7 termlist... 7 username... 7 Rückgabeparameter:... 8 result... 8 resultnumber... 8 session_id... 8 statuscode... 8 Beschreibung der Funktionen... 10 getschememetadata... 10 searchconceptsbyid... 11 searchconceptsbyterm... 12 fetchhierarchy... 13 Login... 14 Logout... 15 museumvok-ws: WSDL Web Service Definitionsdatei... 16 Seite 2 /24

Einleitung In dieser Referenz wird die Schnittstelle des Vokabular Web Service der Initiative museumsvokabular.de definiert. Die Beschreibung richtet sich einerseits an die Entwickler von Museumsinformationssystemen, welche auf den Web Service zugreifen sollen. Andererseits können Anbieter von kontrolliertem Vokabular ihrerseits eigene Web Services gemäß dieser Schnittstellendefinition bereit stellen und damit das Angebot von museumsvokabular.de unter ihrer eigenen Ägide erweitern. Die Schnittstellendefinition 1 basiert auf der unter http://museum.zib.de/museumsvokabular/documents/museumvok0.2.pdf verfügbaren, SKOSkompatiblen 2 Formatbeschreibung museumvok für die strukturierte Bereitstellung von kontrolliertem Vokabular und enthält in ihrem Hauptteil die genaue Beschreibung der bereit gestellten SOAP-RPC Funktionen. Ein vom Zuse-Institut Berlin implementierter Protoyp des Services ist zugänglich unter http://museum.zib.de/museumsvokabular/webservice/museumvok-ws0.4.wsdl Sie können den Service mit einem von Digicult Schleswig-Holstein und ZIB zur Verfügung gestellten Client testen: http://museum.zib.de/museumsvokabular/webservice/museumvok-client0.4.php Die Initiative museumsvokabular.de wird den Web Service kontinuierlich weiter entwickeln, bitte konsultieren Sie regelmäßig die Seite http://www.museumsvokabular.de > Tech-Dok. 1 Als wesentliche Grundlage für die Schnittstellendefinition diente dabei ein von der US-amerikanischen National Agricultural Library bereit gestellter Thesaurus Web Service, s. das NAL Thesaurus Web Services Reference Manual, download unter http://agclass.nal.usda.gov/agt/progmanual.pdf 2 S. http://www.w3.org/2004/02/skos/ Seite 3 /24

museumvok-ws: Funktionen und Parameter Beschreibung der Parameter Die Übergabe- und Rückgabeparameter der weiter hinten beschriebenen Funktionen werden hier allgemein definiert, sie erschließen sich ggf. jedoch erst im Zusammenhang mit den Funktionsdefinitionen. Übergabeparameter: direction direction ist ein String mit drei zulässigen Werten, der die Suchrichtung in der Hierarchie angibt bzw. nur die Top Terms anfordert: ASC = suche aufsteigend, Oberbegriffe DESC = suche absteigend, Unterbegriffe TOP = Top Terms, suche nur die Begriffe der ersten Hierarchieebene Id Id ist ein String mit einem Identifikator. Beispiel: $Id = '00000001'; $Id = 'Erntegerät'; IdList IdList ist ein Array von Identifikatoren von Konzepten sie können im Vokabular enthalten sein oder nicht. Beispiel: $IdList = array('00000001', 'XYZ00099'); Seite 4 /24

level level ist ein Integer, der die Anzahl der Hierarchiestufen, die durchsucht werden sollen, angibt. Wenn kein level angegeben ist, wird er standardmäßig mit 1 belegt, d.h. es wird nur eine Ebene nach oben oder unten durchsucht. Wenn level gleich 0 ist, werden alle Hierarchiestufen bis zum Ende durchsucht. Beachte, dass große Werte oder level=0 ggf. sehr große Ergebnis-Arrays zurückliefern können! password password ist ein String, der zum Login benötigt wird. returnmode returnmode ist ein Integer im Wertebereich [0-2], der das Rückgabeformat für das Ergebnis bestimmt: 0 = komplettes museumvok-element 1 = SKOS-Element: about/labels/semanticrelations/notes (Bezeichnungen, Beziehungen und Semantik des Konzepts, keine Verwaltungsinformation) 2 = about/labels/semanticrelations (nur Bezeichnungen und Beziehungen, keine Definitionen/Beschreibungen/Anmerkungen, keine Verwaltungsinformation) returnnumberofconcepts returnnumberofconcepts ist ein Integer, der die Anzahl der zurückzugebenden Elemente, unabhängig von der Trefferzahl, beschränkt. schema schema ist ein String, der das anzusprechende Vokabular identifiziert. Beispiel: $schema = Gefaess ; Seite 5 /24

schemelist schemelist ist ein Array, das angibt, für welche Schemata die Funktion getschememetadata Informationen zurückliefern soll. schemelist = array('all') bedeutet, dass die Metadaten für alle bereitgestellten Schemata zurückgeliefert werden. Voreinstellung ist 'ALL'. searchfields searchfields ist ein Array, das angibt, welche Bezeichnungen zu durchsuchen sind, zulässige Werte sind 'preflabel' => Suche nach Vorzugsbezeichnung 'altlabel' => Suche nach alternativen Bezeichnungen 'notation' => Suche nach Notation 'hiddenlabel' => Suche nach versteckten Bezeichnungen und alle Kombinationen daraus, z.b. $searchfield = array('preflabel', 'altlabel') => Suche in Vorzugs- und alternativen Bezeichnungen. searchlang searchlang ist ein Array, das angibt, in welchen Sprachen die Bezeichnungen zu durchsuchen sind, zulässige Werte sind Sprachattribute gemäß RFC 3066: Tags for the Identification of Languages und alle Kombination daraus. searchlang = array('all') bedeutet, dass alle Sprachen durchsucht werden. Voreinstellung ist 'de'. searchtermmode searchtermmode ist ein Integer-Wert (Flag Byte), der den Suchmodus bestimmt. 0 = exakte Suche 1 = Groß-/Kleinschreibung ignorieren 2 = Sonderzeichen ignorieren 4 = Linkstrunkierung: Suche nach *Begriff 8 = Rechtstrunkierung: Suche nach Begriff* Kombination der Modi durch Addition, z.b.: 13 = Teiltextsuche, case-insensitive Seite 6 /24

server server ist ein String, der den anzusprechenden Server identifiziert. Beispiel: $server = 'museum.zib.de'; session_id session_id ist ein String, der beim Login vom Server für die Session an den Client vergeben wird und bei jedem Funktionsaufruf zur Authentifizierung zwischen Client und Server übertragen wird. sortfield sortfield ist ein String, der das Sortierkriterium für die Ergebnismenge angibt, zulässige Werte sind 'preflabel' => Sortiere nach Vorzugsbezeichnung. 'about' => Sortiere nach ID. 'notation' => Sortiere nach Notation. termlist termlist ist ein Array von Bezeichnungen, die im Vokabular enthalten sein können oder nicht. Beispiel: $termlist = array('königskuchenform', 'Lammform', 'Napfkuchenform'); username username ist ein String, der zum Login benötigt wird. Seite 7 /24

Rückgabeparameter: Alle Funktionen außer Login/Logout geben dieselbe Struktur aus vier Elementen zurück, bestehend aus einem Ergebnis-String, der Trefferanzahl, einem numerischen Statuscode und der Session-ID. Login/Logout geben nur Statuscode und Session-ID zurück. result result ist ein String, i.d.r. museumvok-strukturiertes XML je nach angefordertem Rückgabemodus enthält er die vollständigen Konzepte oder nur Teile davon. resultnumber resultnumber ist ein Integer, der die Anzahl der zurück gelieferten Konzepte oder Schemata angibt. Beachte, dass er auch bei erfolgreichem Funktionsaufruf null sein kann. session_id session_id ist ein String, der beim Login vom Server für die Session an den Client vergeben wird und bei jedem Funktionsaufruf zur Authentifizierung zwischen Client und Server übertragen wird. statuscode statuscode ist ein Integer, der gleich null ist, wenn der Funktionsaufruf erfolgreich abgearbeitet werden konnte, oder einen der folgenden Fehlercodes enthält. Beachte, dass ein erfolgreicher Funktionsaufruf nicht notwendig Konzepte zurückliefert! 0 = Ok. 101 = Authentifikation fehlgeschlagen. 102 = Funktion nicht realisiert. 103 = Suchparameter fehlerhaft: Keine IdList fuer Funktion searchconceptsbyid / Kein arrayofstrings uebergeben. Keine termlist fuer Funktion searchconceptsbyterm/ Kein arrayofstrings uebergeben. Keine Id fuer Funktion fetchhierarchy / Kein string uebergeben. 104 = Server nicht erreichbar / Uebergebener Parameter server fehlerhaft. 105 = Schema existiert nicht / Uebergebener Parameter schema fehlerhaft. 106 = Unzulaessiger searchmode-parameter fuer Funktion searchconceptsbyid oder searchconceptsbyterm Seite 8 /24

107 = Unzulaessiger returnmode-parameter fuer Funktion searchconceptsbyid oder searchconceptsbyterm 108 = Unzulaessiger level-parameter fuer Funktion fetchhierarchy / Kein integer-wert uebergeben. 109 = Unzulaessiger direction-parameter fuer Funktion fetchhierarchy Seite 9 /24

Beschreibung der Funktionen getschememetadata FUNKTION NOCH NICHT IMPLEMENTIERT! SYNOPSIS getschememetadata (schemelist, server, returnmode, returnnumberofconcepts, session_id) BESCHREIBUNG Die Funktion liefert Metadaten zu einem oder mehreren Schemata wie Versionsnummer, Beschreibung und Autor zurück. Für schemelist=array('all') werden die angeforderten Informationen, in Abhängigkeit des returnmode, für alle verfügbaren Schemata zurückgeliefert. RÜCKGABE getschememetadata gibt ein Array aus vier Elementen zurück (result, resultnumber, statuscode, session_id), resultnumber enthält hier die Anzahl der gefundenen Schemata. Seite 10 /24

searchconceptsbyid SYNOPSIS searchconceptsbyid (IdList, server, schema, sortfield, returnmode, returnnumberofconcepts, session_id) BESCHREIBUNG Für jeden Identifikator aus der Liste IdList sucht die Funktion die zugehörigen Konzepte im angegebenen Vokabular (server + schema). sortfield gibt das Sortierkriterium für die Ergebnismenge an. Der Rückgabemodus returnmode bestimmt, in welchem Format die gefundenen Konzepte zurück geliefert werden, entsprechend der obigen Parameter-Definitionen. returnnumberofconcepts beschränkt die Anzahl der zurückzugebenden Elemente. Die session_id dient der Authentifizierung am Server. Beachte: Falls aus einer Liste von Identifikatoren auch nur ein einzelner Identifikator nicht gefunden wird, ist die Treffermenge leer! Ein PHP-Funktionsaufruf könnte z.b. folgendermaßen aussehen: $IdList = array('51','2','17'); $server = 'museum.zib.de'; $schema = Gefaess ; $sortfield = 'preflabel'; $result = $soap-> soapcall("searchconceptsbyid", array('idlist'=>$idlist, 'server'=>$server, 'schema'=>$schema, 'sortfield'=>$sortfield, 'returnmode'=>0, 'returnnumberofconcepts'=>10, 'session_id'=$session_id)); RÜCKGABE searchconceptsbyid gibt ein Array aus vier Elementen zurück (result, resultnumber, statuscode, session_id), wobei result die Ergebniselemente im museumvok-format enthält. Seite 11 /24

searchconceptsbyterm SYNOPSIS searchconceptsbyterm (termlist, server, schema, searchtermmode, searchfields, searchlang, sortfield, returnmode, returnnumberofconcepts, session_id) BESCHREIBUNG Für jede Bezeichnung aus der Liste termlist sucht die Funktion die zugehörigen Konzepte im angegebenen Vokabular (server + schema). Der Suchmodus searchtermmode bestimmt, ob und wie die Suche normalisiert und/oder trunkiert werden soll. searchfields enthält die zu durchsuchenden Bezeichnungen, searchlang die zu durchsuchenden Sprachen. sortfield gibt das Sortierkriterium für die Ergebnismenge an. Der Rückgabemodus returnmode bestimmt, in welchem Format die gefundenen Konzepte zurück geliefert werden, entsprechend der obigen Parameter-Definitionen. returnnumberofconcepts beschränkt die Anzahl der zurückzugebenden Elemente. Die session_id dient der Authentifizierung am Server. Ein PHP-Funktionsaufruf könnte z.b. folgendermaßen aussehen: $termlist = array('königskuchenform', 'Lammform', 'Napfkuchenform'); $server = 'museum.zib.de'; $schema = Gefaess ; $searchfields = array('preflabel', 'altlabel'); $sortfield = 'preflabel'; $result = $soap-> soapcall("searchconceptsbyterm", array('termlist'=>$termlist, 'server'=>$server, 'schema'=>$schema, 'searchtermmode'=>13, 'searchfields'=>$searchfields, 'searchlang'=>array('all'), 'sortfield'=>$sortfield, 'returnmode'=>0, 'returnnumberofconcepts'=>10, 'session_id'=$session_id)); RÜCKGABE searchconceptsbyterm gibt ein Array aus vier Elementen zurück (result, resultnumber, statuscode, session_id), wobei result die Ergebniselemente im museumvok-format enthält. Seite 12 /24

fetchhierarchy SYNOPSIS fetchhierarchy (Id, server, schema, level, direction, returnmode, returnnumberofconcepts, session_id) BESCHREIBUNG Die Funktion gibt zu einem mit dem Parameter Id eindeutig adressierbaren Konzept im angegebenen Vokabular (server + schema) den angeforderten Hierarchiezweig zurück: Je nach Suchtiefe level und Suchrichtung direction werden die in Hierarchie über- oder untergeordneten Konzepte als XML im museumvok-format zurückgeliefert. Das Ergebnis erlaubt die Rekonstruktion der Hierarchie durch die broader-/narrower-relationen. Für direction='top' werden nur die Top Terms zurückgeliefert. Ein PHP-Funktionsaufruf könnte z.b. folgendermaßen aussehen: $Id = '51'; $server = 'museum.zib.de'; $schema = Gefaess ; $result = $soap-> soapcall("fetchhierarchy", array('id'=>$id, 'server'=>$server,'schema'=>$schema, 'level'=>0, 'direction'=>'desc', 'returnmode'=>0, 'returnnumberofconcepts'=>10, 'session_id'=$session_id)); RÜCKGABE fetchhierarchy gibt ein Array aus vier Elementen zurück (result, resultnumber, statuscode, session_id), wobei result die Ergebniselemente im museumvok-format enthält. Beachte, dass große Werte für den Parameter level oder level=0 ggf. sehr große Ergebnis-Arrays zurückliefern können! Seite 13 /24

Login FUNKTION NOCH NICHT IMPLEMENTIERT! SYNOPSIS Login (username, password) BESCHREIBUNG Login-Funktion zum Beginn einer Session. RÜCKGABE Login gibt ein Array aus zwei Elementen zurück (statuscode, session_id), die session_id wird dabei vom Server erzeugt. Seite 14 /24

Logout FUNKTION NOCH NICHT IMPLEMENTIERT! SYNOPSIS Logout (session_id) BESCHREIBUNG Logout-Funktion zur Beendigung einer Session. RÜCKGABE Logout gibt ein Array aus zwei Elementen zurück (statuscode, session_id). Seite 15 /24

museumvok-ws: WSDL Web Service Definitionsdatei URL: http://museum.zib.de/museumsvokabular/webservice/museumvok-ws0.4.wsdl <?xml version="1.0" encoding="utf-8"?> <wsdl:definitions xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tns="urn:museumvok" xmlns:xsd="http://www.w3.org/2001/xmlschema" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns="http://schemas.xmlsoap.org/wsdl/" targetnamespace="urn:museumvok" name="museumvok"> <wsdl:types> <xsd:schema targetnamespace="urn:museumvok"> <xsd:complextype name="arrayofstrings"> <xsd:complexcontent> <xsd:restriction base="soapenc:array"> <xsd:sequence> <xsd:element maxoccurs="unbounded" minoccurs="0" name="item" type="xsd:string"/> </xsd:sequence> <xsd:attribute ref="soapenc:arraytype" wsdl:arraytype="xsd:string[]"/> </xsd:restriction> </xsd:complexcontent> </xsd:complextype> <xsd:complextype name="arrayofsearchfields"> <xsd:complexcontent> <xsd:restriction base="soapenc:array"> <xsd:sequence> <xsd:element maxoccurs="unbounded" minoccurs="0" name="onefield" type="tns:searchfields"/> </xsd:sequence> <xsd:attribute ref="soapenc:arraytype" wsdl:arraytype="xsd:string[]"/> </xsd:restriction> </xsd:complexcontent> </xsd:complextype> <xsd:simpletype name="searchtermmode"> <xsd:annotation> <xsd:documentation xml:lang="de">suchmodus<br/> 0 = exakte Suche 1 = Gro?/Kleinschreibung ignorieren Seite 16 /24

2 = Sonderzeichen ignorieren 4 = Linkstrunkierung 8 = Rechtstrunkierung Kombination der Modi durch Addition </xsd:documentation> </xsd:annotation> <xsd:restriction base="xsd:integer"> <xsd:pattern value="[0-15]"/> </xsd:restriction> </xsd:simpletype> <xsd:simpletype name="returnmode"> <xsd:annotation> <xsd:documentation xml:lang="de">rueckgabemodus: 0 = komplettes museumvok-element 1 = SKOS-Element: about/labels/semanticrelations/notes (Bezeichnungen, Beziehungen und Semantik des Konzepts, keine Verwaltungsinformation) 2 = about/labels/semanticrelations (nur Bezeichnungen und Beziehungen, keine Definitionen/Beschreibungen/Anmerkungen, keine Verwaltungsinformation) 3 = about/labels (nur Bezeichnungen) </xsd:documentation> </xsd:annotation> <xsd:restriction base="xsd:integer"> <xsd:pattern value="[0-2]"/> </xsd:restriction> </xsd:simpletype> <xsd:simpletype name="direction"> <xsd:annotation> <xsd:documentation xml:lang="de">suchrichtung in der Hierarchie: ASC = aufsteigend, Oberbegriffe DESC = absteigend, Unterbegriffe TOP = TopTerms, alle Begriffe der ersten Hierarchieebene </xsd:documentation> </xsd:annotation> <xsd:restriction base="xsd:string"> <xsd:enumeration value="asc"/> <xsd:enumeration value="desc"/> <xsd:enumeration value="top"/> </xsd:restriction> </xsd:simpletype> <xsd:simpletype name="statuscode"> <xsd:annotation> <xsd:documentation xml:lang="de">rueckgabestatus / Fehlercodes:<br/> Seite 17 /24

0 = Ok.<br/> 101 = Authentifikation fehlgeschlagen.<br/> 102 = Funktion nicht realisiert.<br/> 103 = Suchparameter fehlerhaft: Keine IdList fuer Funktion searchconceptsbyid / Kein arrayofstrings uebergeben.<br/> Keine termlist fuer Funktion searchconceptsbyterm/ Kein arrayofstrings uebergeben. <br/> Keine Id fuer Funktion fetchhierarchy / Kein string uebergeben.<br/> 104 = Server nicht erreichbar / Uebergebener Parameter Server fehlerhaft.<br/> 105 = Schema existiert nicht / Uebergebener Parameter Schema fehlerhaft.<br/> 106 = Unzulaessiger searchmode-parameter fuer Funktion searchconceptsbyid oder searchconceptsbyterm<br/> 107 = Unzulaessiger returnmode-parameter fuer Funktion searchconceptsbyid oder searchconceptsbyterm<br/> 108 = Unzulaessiger level-parameter fuer Funktion fetchhierarchy / Kein integer-wert uebergeben.<br/> 109 = Unzulaessiger direction-parameter fuer Funktion fetchhierarchy<br/> </xsd:documentation> </xsd:annotation> <xsd:restriction base="xsd:integer"> <xsd:pattern value="[0,100-199]"/> </xsd:restriction> </xsd:simpletype> <xsd:simpletype name="searchfields"> <xsd:annotation> <xsd:documentation xml:lang="de">angabe der zu durchsuchenden Bezeichnungen preflabel = Vorzugsbezeichnung altlabel = Alternative Bezeichnungen notation = Notation hiddenlabel = Versteckte Bezeichnungen </xsd:documentation> </xsd:annotation> <xsd:restriction base="xsd:string"> <xsd:enumeration value="altlabel"/> <xsd:enumeration value="hiddenlabel"/> <xsd:enumeration value="notation"/> <xsd:enumeration value="preflabel"/> </xsd:restriction> </xsd:simpletype> <xsd:simpletype name="sortfield"> <xsd:annotation> Seite 18 /24

<xsd:documentation xml:lang="de">sortierung nach about = ID preflabel = Vorzugsbezeichnung notation = Notation </xsd:documentation> </xsd:annotation> <xsd:restriction base="xsd:string"> <xsd:enumeration value="about"/> <xsd:enumeration value="notation"/> <xsd:enumeration value="preflabel"/> </xsd:restriction> </xsd:simpletype> <xsd:complextype name="baseconcept"> <xsd:annotation> <xsd:documentation xml:lang="de"> Einfacher String, der entweder komplettes museumvok-element oder Teile davon in XML- Syntax enthaelt. <br/> Kann ggf. zu strukturiertem Element ausgebaut werden. </xsd:documentation> </xsd:annotation> <xsd:all> <xsd:element maxoccurs="1" minoccurs="1" name="concept" type="xsd:string"/> </xsd:all> </xsd:complextype> <!-- Nachfolgender Type wird derzeit nicht gebraucht --> <xsd:complextype name="arrayofconcepts"> <xsd:complexcontent> <xsd:restriction base="soapenc:array"> <xsd:sequence> <xsd:element maxoccurs="unbounded" minoccurs="0" name="oneconcept" type="tns:baseconcept"/> </xsd:sequence> <xsd:attribute ref="soapenc:arraytype" wsdl:arraytype="xsd:string[]"/> </xsd:restriction> </xsd:complexcontent> </xsd:complextype> </xsd:schema> </wsdl:types> <message name="searchconceptsbyidrequest"> <part name="idlist" type="tns:arrayofstrings"/> <part name="server" type="xsd:string"/> <part name="schema" type="xsd:string"/> Seite 19 /24

<part name="sortfield" type="tns:sortfield"/> <part name="returnmode" type="tns:returnmode"/> <part name="returnnumberofconcepts" type="xsd:integer"/> <part name="session_id" type="xsd:string"/> </message> <message name="searchconceptsbyidresponse"> <part name="result" type="xsd:string"/> <part name="resultnumber" type="xsd:integer"/> <part name="statuscode" type="xsd:integer"/> <part name="session_id" type="xsd:string"/> </message> <message name="searchconceptsbytermrequest"> <part name="termlist" type="tns:arrayofstrings"/> <part name="server" type="xsd:string"/> <part name="schema" type="xsd:string"/> <part name="searchtermmode" type="tns:searchtermmode"/> <part name="searchfields" type="tns:arrayofsearchfields"/> <part name="searchlang" type="tns:arrayofstrings"/> <part name="sortfield" type="tns:sortfield"/> <part name="returnmode" type="tns:returnmode"/> <part name="returnnumberofconcepts" type="xsd:integer"/> <part name="session_id" type="xsd:string"/> </message> <message name="searchconceptsbytermresponse"> <part name="result" type="xsd:string"/> <part name="resultnumber" type="xsd:integer"/> <part name="statuscode" type="tns:statuscode"/> <part name="session_id" type="xsd:string"/> </message> <message name="fetchhierarchyrequest"> <part name="id" type="xsd:string"/> <part name="server" type="xsd:string"/> <part name="schema" type="xsd:string"/> <part name="level" type="xsd:integer"/> <part name="direction" type="tns:direction"/> <part name="returnmode" type="tns:returnmode"/> <part name="returnnumberofconcepts" type="xsd:integer"/> <part name="session_id" type="xsd:string"/> </message> <message name="fetchhierarchyresponse"> <part name="result" type="xsd:string"/> <part name="resultnumber" type="xsd:integer"/> Seite 20 /24

<part name="statuscode" type="tns:statuscode"/> <part name="session_id" type="xsd:string"/> </message> <message name="getschememetadatarequest"> <wsdl:documentation> * schemelist An array of schemata of which requested information is returned. Default is "ALL": returns information about all available schemata. </wsdl:documentation> <part name="schemelist" type="tns:arrayofstrings"/> <part name="server" type="xsd:string"/> <part name="returnmode" type="tns:returnmode"/> <part name="returnnumberofconcepts" type="xsd:integer"/> <part name="session_id" type="xsd:string"/> </message> <message name="getschememetadataresponse"> <part name="result" type="xsd:string"/> <part name="resultnumber" type="xsd:integer"/> <part name="statuscode" type="xsd:integer"/> <part name="session_id" type="xsd:string"/> </message> <message name="loginrequest"> <part name="username" type="xsd:string"/> <part name="password" type="xsd:string"/> </message> <message name="loginresponse"> <part name="statuscode" type="tns:statuscode"/> <part name="session_id" type="xsd:string"/> </message> <message name="logoutrequest"> <part name="session_id" type="xsd:string"/> </message> <message name="logoutresponse"> <part name="statuscode" type="tns:statuscode"/> <part name="session_id" type="xsd:string"/> </message> <porttype name="museumvokporttype"> <operation name="searchconceptsbyid"> <input message="tns:searchconceptsbyidrequest"/> <output message="tns:searchconceptsbyidresponse"/> </operation> <operation name="searchconceptsbyterm"> Seite 21 /24

<input message="tns:searchconceptsbytermrequest"/> <output message="tns:searchconceptsbytermresponse"/> </operation> <operation name="fetchhierarchy"> <input message="tns:fetchhierarchyrequest"/> <output message="tns:fetchhierarchyresponse"/> </operation> <operation name="getschememetadata"> <input message="tns:getschememetadatarequest"/> <output message="tns:getschememetadataresponse"/> </operation> <operation name="login"> <input message="tns:loginrequest"/> <output message="tns:loginresponse"/> </operation> <operation name="logout"> <input message="tns:logoutrequest"/> <output message="tns:logoutresponse"/> </operation> </porttype> <binding name="museumvokbinding" type="tns:museumvokporttype"> <soap:binding style="rpc" transport="http://schemas.xmlsoap.org/soap/http"/> <operation name="searchconceptsbyid"> <soap:operation soapaction="urn:soapservice#searchconceptsbyid"/> <input> <soap:body use="encoded" encodingstyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="urn:soapservice"/> </input> <output> <soap:body use="encoded" encodingstyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="urn:soapservice"/> </output> </operation> <operation name="searchconceptsbyterm"> <soap:operation soapaction="urn:soapservice#searchconceptsbyterm"/> <input> <soap:body use="encoded" encodingstyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="urn:soapservice"/> </input> <output> <soap:body use="encoded" encodingstyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="urn:soapservice"/> Seite 22 /24

</output> </operation> <operation name="fetchhierarchy"> <soap:operation soapaction="urn:soapservice#fetchhierarchy"/> <input> <soap:body use="encoded" encodingstyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="urn:soapservice"/> </input> <output> <soap:body use="encoded" encodingstyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="urn:soapservice"/> </output> </operation> <operation name="getschememetadata"> <soap:operation soapaction="urn:soapservice#getschememetadata"/> <input> <soap:body use="encoded" encodingstyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="urn:soapservice"/> </input> <output> <soap:body use="encoded" encodingstyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="urn:soapservice"/> </output> </operation> <operation name="login"> <soap:operation soapaction="urn:soapservice#login"/> <input> <soap:body use="encoded" encodingstyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="urn:soapservice"/> </input> <output> <soap:body use="encoded" encodingstyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="urn:soapservice"/> </output> </operation> <operation name="logout"> <soap:operation soapaction="urn:soapservice#logout"/> <input> <soap:body use="encoded" encodingstyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="urn:soapservice"/> </input> <output> Seite 23 /24

<soap:body use="encoded" encodingstyle="http://schemas.xmlsoap.org/soap/encoding/" namespace="urn:soapservice"/> </output> </operation> </binding> <service name="museumvok"> <port name="museumvokport" binding="tns:museumvokbinding"> <soap:address location="http://museum.zib.de/museumsvokabular/webservice/museumvokws0.4.php"/> </port> </service> </wsdl:definitions> Seite 24 /24