Benutzer-Werkzeuge

Webseiten-Werkzeuge


develop:xmlrpc

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
Nächste Überarbeitung
Vorhergehende Überarbeitung
Nächste ÜberarbeitungBeide Seiten der Revision
develop:xmlrpc [d.m.Y H:i] willuhndevelop:xmlrpc [d.m.Y H:i] – Typo mathisdt
Zeile 14: Zeile 14:
 ==== Java ==== ==== Java ====
  
-Du benötigst [[http://www.java.com/de/|SUN Java]] in Version 6 (oft auch "1.6" bezeichnet) oder höher. Die Verwendung von Java-Versionen anderer Hersteller (z.Bsp. IBM Java, GNU GCJ/Classpath, OpenJDK, usw.) wird nicht empfohlen, da auf diesen Plattformen keine Tests durchgeführt wurden.+Du benötigst [[http://www.java.com/de/|Java]] in Version 6 (oft auch "1.6" bezeichnet) oder höher von Oracle oder OpenJDK. Die Verwendung von Java-Versionen anderer Hersteller (z.Bsp. IBM Java, GNU GCJ/Classpath usw.) wird nicht empfohlen, da auf diesen Plattformen keine Tests durchgeführt wurden.
  
  
Zeile 21: Zeile 21:
 Folgende Komponenten werden benötigt: Folgende Komponenten werden benötigt:
  
-^ Name             ^ Version ^ Download ^ +^ Name             ^ Download ^ 
-| jameica          | 1.10 oder höher | [[http://www.willuhn.de/products/jameica/download.php]] | +| jameica          | [[http://www.willuhn.de/products/jameica/download.php]] | 
-| jameica.webadmin | 1.2 oder höher  | [[http://www.willuhn.de/products/jameica/download_ext.php]] | +| jameica.webadmin | [[http://www.willuhn.de/products/jameica/download_ext.php]] | 
-| jameica.xmprpc   | 1.1 oder höher  | [[http://www.willuhn.de/products/jameica/download_ext.php]] | +| jameica.xmlrpc   | [[http://www.willuhn.de/products/jameica/download_ext.php]] | 
-| hibiscus         | 1.12 oder höher | [[http://www.willuhn.de/products/hibiscus/download.php]] | +| hibiscus         | [[http://www.willuhn.de/products/hibiscus/download.php]] | 
-| hibiscus.xmlrpc  | 1.2 oder höher  | [[http://www.willuhn.de/products/hibiscus/download_ext.php]] |+| hibiscus.xmlrpc  | [[http://www.willuhn.de/products/hibiscus/download_ext.php]] |
  
 Das Plugin "jameica.webadmin" erweitert Jameica um Webfunktionalität mithilfe eines embedded Webservers ([[http://jetty.mortbay.org/jetty/index.html|Jetty]]). "jameica.xmlrpc" setzt auf diesen Webserver auf und erweitert ihn um XML-RPC-Fähigkeiten. Neben Hibiscus selbst wird nun noch "hibiscus.xmlrpc" benötigt, welches die Hibiscus-Daten via XML-RPC bereitstellt. Das Plugin "jameica.webadmin" erweitert Jameica um Webfunktionalität mithilfe eines embedded Webservers ([[http://jetty.mortbay.org/jetty/index.html|Jetty]]). "jameica.xmlrpc" setzt auf diesen Webserver auf und erweitert ihn um XML-RPC-Fähigkeiten. Neben Hibiscus selbst wird nun noch "hibiscus.xmlrpc" benötigt, welches die Hibiscus-Daten via XML-RPC bereitstellt.
Zeile 61: Zeile 61:
 | hibiscus.xmlrpc | sammellastschrift  | Abrufen, Erstellen und Löschen von Sammel-Lastschriften | | hibiscus.xmlrpc | sammellastschrift  | Abrufen, Erstellen und Löschen von Sammel-Lastschriften |
 | hibiscus.xmlrpc | sepaueberweisung   | Abrufen, Erstellen und Löschen von SEPA-Überweisungen | | hibiscus.xmlrpc | sepaueberweisung   | Abrufen, Erstellen und Löschen von SEPA-Überweisungen |
 +| hibiscus.xmlrpc | sepalastschrift    | Abrufen, Erstellen und Löschen von SEPA-Lastschriften |
  
 Alternativ können die XML-RPC-Services auch manuell in der Konfigurations-Datei cfg/de.willuhn.jameica.xmlrpc.Plugin.properties (im [[support:backup#benutzerverzeichnis|Benutzerverzeichnis]]) durch Hinzufügen folgender Zeilen aktiviert werden: Alternativ können die XML-RPC-Services auch manuell in der Konfigurations-Datei cfg/de.willuhn.jameica.xmlrpc.Plugin.properties (im [[support:backup#benutzerverzeichnis|Benutzerverzeichnis]]) durch Hinzufügen folgender Zeilen aktiviert werden:
Zeile 72: Zeile 73:
   hibiscus.xmlrpc.sammelueberweisung.shared=true   hibiscus.xmlrpc.sammelueberweisung.shared=true
   hibiscus.xmlrpc.sepaueberweisung.shared=true   hibiscus.xmlrpc.sepaueberweisung.shared=true
 +  hibiscus.xmlrpc.sepalastschrift.shared=true
 +  hibiscus.xmlrpc.sepasammelueberweisung.shared=true
 +  hibiscus.xmlrpc.sepasammellastschrift.shared=true
  
 ===== Konfiguration prüfen ===== ===== Konfiguration prüfen =====
Zeile 86: Zeile 90:
   [...Datum/Zeit...][INFO][de.....ServiceNotify.handleMessage]    * https://<hostname>:8080/xmlrpc/hibiscus.xmlrpc.sammelueberweisung   [...Datum/Zeit...][INFO][de.....ServiceNotify.handleMessage]    * https://<hostname>:8080/xmlrpc/hibiscus.xmlrpc.sammelueberweisung
   [...Datum/Zeit...][INFO][de.....ServiceNotify.handleMessage]    * https://<hostname>:8080/xmlrpc/hibiscus.xmlrpc.sepaueberweisung   [...Datum/Zeit...][INFO][de.....ServiceNotify.handleMessage]    * https://<hostname>:8080/xmlrpc/hibiscus.xmlrpc.sepaueberweisung
 +  [...Datum/Zeit...][INFO][de.....ServiceNotify.handleMessage]    * https://<hostname>:8080/xmlrpc/hibiscus.xmlrpc.sepalastschrift
  
  
Zeile 116: Zeile 121:
   * [[develop:xmlrpc:sammelauftrag|Sammel-Überweisungen und -Lastschriften]]   * [[develop:xmlrpc:sammelauftrag|Sammel-Überweisungen und -Lastschriften]]
  
 +**Tipp**: Für PHP gibt es unter https://github.com/willuhn/hibiscus.php bereits "gebrauchsfertigen" Code.\\ 
 +**Tipp**: Ein Java-Beispiel findet sich unter http://www.zephyrsoft.org/hibiscus-watcher (Maven-Projekt).
 ===== Verhalten der Services anpassen ===== ===== Verhalten der Services anpassen =====
  
Zeile 149: Zeile 155:
 Der XML-RPC-Standard unterstützt eigentlich keinen [[http://de.wikipedia.org/wiki/XML-RPC#Null-Datentyp|NULL-Datentyp]]. Es existiert jedoch eine [[http://ontosys.com/xml-rpc/extensions.php|Protokoll-Erweiterung]], die NULL-Werte in Form des Elementes "<nil/>" bzw. "<ex:nil/>" zulässt. Die [[http://ws.apache.org/xmlrpc/types.html|Apache-Implementierung]] unterstützt dies beispielsweise. Da NULL-/NUL- bzw. NIL-Werte in verschiedenen Programmiersprachen jedoch Probleme verursachen können, kann das Verhalten des Plugins "hibiscus.xmlrpc" mit diesem Parameter beeinflusst werden.  Der XML-RPC-Standard unterstützt eigentlich keinen [[http://de.wikipedia.org/wiki/XML-RPC#Null-Datentyp|NULL-Datentyp]]. Es existiert jedoch eine [[http://ontosys.com/xml-rpc/extensions.php|Protokoll-Erweiterung]], die NULL-Werte in Form des Elementes "<nil/>" bzw. "<ex:nil/>" zulässt. Die [[http://ws.apache.org/xmlrpc/types.html|Apache-Implementierung]] unterstützt dies beispielsweise. Da NULL-/NUL- bzw. NIL-Werte in verschiedenen Programmiersprachen jedoch Probleme verursachen können, kann das Verhalten des Plugins "hibiscus.xmlrpc" mit diesem Parameter beeinflusst werden. 
  
-Einige Funktionen des Plugins (insb. Funktionen zum Erstellen neuer Adressen oder Aufträge) liefern per Default im Erfolgsfall NULL zurück und im Fehlerfall einen String mit dem Fehlertext. Falls jedoch die ID des erstellten Datensatzes benötigt wird oder die verwendete Programmiersprache auf Client-Seite keine NULL-Werte unterstützt, kann in die o.g. Datei eine Zeile "xmlrpc.supports.null=false" eingetragen werden. Die betreffenden Funktionen ändern dabei ihr Verhalten. Im Erfolgsfall liefern Sie die ID des erstellten/geänderten/gelöschten Datensatzes zurück. Im Fehlerfall werden sie eine Exception (Fault).+Einige Funktionen des Plugins (insb. Funktionen zum Erstellen neuer Adressen oder Aufträge) liefern per Default im Erfolgsfall NULL zurück und im Fehlerfall einen String mit dem Fehlertext. Falls jedoch die ID des erstellten Datensatzes benötigt wird oder die verwendete Programmiersprache auf Client-Seite keine NULL-Werte unterstützt, kann in die o.g. Datei eine Zeile "xmlrpc.supports.null=false" eingetragen werden. Die betreffenden Funktionen ändern dabei ihr Verhalten. Im Erfolgsfall liefern Sie die ID des erstellten/geänderten/gelöschten Datensatzes zurück. Im Fehlerfall werfen sie eine Exception (Fault).
  
 ^ Parameter-Wert             ^ Verhalten im Erfolgsfall ^ Verhalten im Fehlerfall ^ ^ Parameter-Wert             ^ Verhalten im Erfolgsfall ^ Verhalten im Fehlerfall ^


Impressum | Datenschutz
develop/xmlrpc.txt · Zuletzt geändert: d.m.Y H:i von mathisdt