Webservice ido

Aus infra-struktur AdminWiki 2.10
Zur Navigation springenZur Suche springen
  • WSDL Datei

Die zur Nutzung der infra-struktur IDO Webservices notwendige WSDL-Datei finden Sie unter:

http://instanzname.infra-struktur.de/webservice/wsdl/wsdl.php?ido

Beachten Sie, dass der Webserver für die Verwendung der Webservices Schreibrechte auf das Verzeichnis „WEBROOT/webservice/wsdl“ benötigt.

  • Example

Diese in PHP geschrieben Beispielapplikation dient als leichter Einstieg in die infra-struktur Webservices

  <?php
  //Einen neuen SoapClient erstellen und Verbindung mit der infra-struktur WSDL Datei aufnehmen
  $client = new SoapClient("http://instanzname.infra-struktur.de/webservice/wsdl/wsdl.php?ido",array('exceptions'=>false));
  
  //Authentifizierung am Webservice mit den infra-struktur Benutzerdaten
  $token = $client->__soapCall("authenticate",array("http://instanzname.infra-struktur.de","benutzername","passwort"));
  
  //In der IDO Instanz mit der ID 1, im Datensatz mit der ID 2, das Textfeld mit der ID 3 auf den Wert "vier" setzen
  $client->__soapCall("setTextfieldValue",array(1,2,3,"vier",$token));
  
  //Alle Textfelder der Instanz mit der ID 1 ermitteln und die dazugehörigen Werte ausgeben
  foreach($client->__soapCall("getTextfieldsByInstanceID",array(1,$token)) as $feldID => $feldName)
  {
      //Den Namen des ermittelten Felds in den UTF-8 Zeichensatz konvertieren und ausgeben
      echo "Name des Feldes: ".utf8_decode($feldName);
  }
  ?>
  • Funktionsübersicht

Authenticate

Authentifiziert einen Benutzer am Webservice

Parameter

instanceName  ! Datentyp  ! Beschreibung
instanceName String Vollständiger Pfad der Instanz
userName String infra-struktur Benutzername

instanceName String Vollständiger Pfad der Instanz

                                       (instanzname.infra-struktur.de)

userName String Infra-struktur Benutzername password String Infra-struktur Passwort Rückgabewert token String Authentifizierungstoken für

                                       weitere Anfragen am Webservice

GetTextfieldsByInstanceID

Liefert sämtliche Textfelder zur gewählten Instanz

Parameter instanceID Integer ID der IDO Instanz token String Validierungstoken Rückgabewert idoTextFields Array Array mit den verfügbaren

                                      Textfeldern (FeldID,Feldname)