Referenz - Die Parameter des Webservice und der Benutzeroberfläche

DiaCollo ist ein Webservice, der eine Reihe von Eingabe-Parametern erwartet. Alle Parameter sind Attribut-Wert-Paare. Die meisten Attribute haben eine feste Menge von Werten oder erwarten Werte eines bestimmten Datentyps (STRING etc.).

Einige der Parameter sind obligatorisch, andere optional.

Die Angabe eines Parameters kann abhängig sein vom Wert eines anderen Parameters. Beispiel: die Parameter ~YEAR, ~DATE, ~SLICE können nur dann angegeben werden, wenn das Attribut PROFILE einen der Werte hat, die mit “diff:” beginnen (Vergleich zweier Profile).

Wenn ein nicht-zulässiges Attribut oder ein Attribut mit einem nicht-zulässigen Wert übergeben wird, gibt der Service u.a. eine erklärende Fehlermeldung zurück.

Die Benutzeroberfläche von DiaCollo vereinfacht die Angabe der Parameter für den Programmaufruf und verringert die Zahl möglicher Eingabefehler.

Der Webservice baut zum einen auf der Abfragesprache DDC auf (s. die DDC-Dokumentation ⇗ und die Hilfe zur Suche ⇗), zum anderen, z.B. bei regulären Ausdrücken, auf der Programmiersprache PERL (s. Perl Regular Expressions ⇗). Um das Potenzial dieses Webservices auszuschöpfen, ist die Kenntnis dieser zugrundeliegenden Techniken notwendig.