Inhaltsverzeichnis
Werbung
myHomeControl
SOAP
Menu: Einstellungen/SOAP
Diese Einstellung aktiviert den SOAP Service.
SOAP (ursprünglich für Simple Object Access Protocol) ist ein Netzwerkprotokoll, mit dessen Hilfe
zwischen
Systemen
ausgetauscht und
ein industrieller Standard des
Die SOAP-Schnittstelle stellt Funktionen zur Verfügung um die Zustände der Objekte des Projekts
(Blöcke und Visualisierungselemente) abzufragen und zu steuern (Licht ein/aus).
Dies ist die ideale Schnittstelle um myHomeControl
Die SOAP-Schnittstelle kann über untenstehende URL angesprochen werden:
Fehler! Hyperlink-Referenz ungültig.:<Port>/soap.asmx
<Adresse>
Adresse unter welcher der Service zu erreichen sein wird.
Intranet:: IP Adresse des PC auf welchem myHomeControl
Internet: Public Domian bzw. über dynamisches DNS definierte Domain.
<Port>
zu verwendenden Port
Um die WSDL abzufragen kann die URL wie folgt aufgerufen werden:
Fehler! Hyperlink-Referenz ungültig.:<Port>/soap.asmx?WSDL
Objekt-Dienste:
Für viele der Objekttypen stehen entsprechende Dienste um Zustände oder Messwerte abzufragen und
um Zustände umzuschalten zur Verfügung.
Jedes Objekt (im Baum
GUID identifiziert. Diese GUID ist beim Aufruf des Dienstes jeweils anzugeben. Die Liste aller Objekte mit
deren GUIDs und Objekttypen kann über den Dienst „getProjectStructure()" abgefragt werden
(siehe unten).
Spezielle Dienste
:
Projektmodel
Beim Aufruf einer Funktion eines bestimmten Objekts (Blocks) muss jeweils die Identifikation des Objekts
(GUID) angegeben werden. Die Identifikationen aller Objekte kann mit der Funktion
„getProjectStructure()" abgefragt werden. Diese Funktion liefert einen Xml-String, welcher die
Projektstruktur mit Geschossen und Räumen sowie die gesamten Objekte listet.
Zusätzlich liefert die Funktion auch eine Checksumme für die Projektstruktur.
Die Funktion „getProjectStructureCKS()" liefert die Checksumme der Projektstruktur.
Sinn der Checksumme ist es die Zeit für den Verbindungsaufbau zwischen einem Konsumenten des
Dienstes und myHomeControl
neu einlesen und verarbeiten, wenn sich die Checksumme geändert hat. Dies ändert sich, wenn
Projektobjekte ergänzt oder gelöscht oder wenn Geschosse/Räume umorganisiert wurden.
Zustandsbeobachter
Dieser Dienst ermöglicht eine effiziente Überwachung der verschiedenen Projektobjekte nach geänderten
Zuständen.
Statt, dass der Konsument zyklisch alle Projektobjekte nach deren aktuellem Zustand abfragt, kann der
Zustandsbeobachterdienst verwendet werden. Der Konsument ruft diesen Dienst ist regelmässig auf. Der
Dienst liefert eine Liste der Projektobjekte bei welchen sich der Zustand geändert hat.
„SCMS_attachBlock(Guid[] BlockGuids)"
„SCMS_detachBlock(Guid[] BlockGuids)"
®
Version 1.2.21 SP25
Remote Procedure Calls
World Wide Web Consortiums
„Benutzte Geschosse, Räume und
®
zu optimieren. So muss der Konsument die Projektstruktur nur dann
durchgeführt werden können. SOAP ist
(W3C).
®
durch Fremdsysteme oder Apps zu steuern.
Geräte" angezeigte Elemente) wird durch eine
Die übergebenen Objekte werden auf
Zustandsänderungen überwacht. Diese Funktion
kann mehrfach aufgerufen werden um Objekte der
Liste hinzuzufügen.
Die übergebenen Objekte werden nicht mehr auf
Zustandsänderungen überwacht.
Daten
®
läuft
Seite 456/587
Werbung
Inhaltsverzeichnis
