Migration - Smarthome-Components

SDK/Tools
Vorraussetzungen
Delphi 2007 + neusten Indy’s für SOAP Client
Hinweise
Das Empfangen von Variants über SOAP ist in Delphi fehlerbehaftet. Wer die Professional Version von Delphi besitzt,
kann im “source\win32\soap” Ordner die Quelldateien wie in den QC Reports beschrieben verändern. Damit die
Änderungen kompiliert werden, muss der Pfad “source\win32\soap” in den Suchpfad hinzufügt werden. Nach dem
Kompilieren sollten in den Dateien (z.B. OPToSOAPDomConv) die blauen Kreise (möglichen Breakpoints) im Editor
erscheinen.
Diese Maßnahme wird nur benötigt, wenn der MessageReader verwendet werden soll. Soll nur über die SOAP
Schnittstelle auf IP-Symcon zugegriffen werden, sind diese Änderungen nur in den seltensten Fällen notwendig.
Adressen zu den relevanten QC Reports:
QualityCentral: ConvertSoapToVariant does not convert Boolean
QualityCentral: Variant is converted with wrong Decimal Seperator
Die neusten Indy Komponenten gibt es hier: Download
Alternativ kann man diese auch direkt aus dem Indy Project SVN auschecken. (branches\Tiburon)
Für das Entwickeln normaler IP-Symcon Module, muss nichts gepatcht werden.
Wesentliche Änderungen von Version 1.0 nach Version 2.0
Das registrierte Interface (ModuleRegistry.RegisterModule(*)) wird automatisch nach PHP weitergereicht. Die Handle
PHP Funktion entfällt komplett.
Zurückgegebene Objekte müssen vom Typ TIPSRemotable sein (UIPSModuleTypes).
Zurückgegebene Objekte werden automatisch in Array’s in PHP umgewandelt
Versenden von Daten zwischen Modulen geschieht nun typsicher. Dazu muss jedes Modul bestimmte Interfaces
anbieten, auf die dann die anderen Module zugreifen können (siehe das Beispiel Modul, UIPSDataTypes).
Status Variablen werden direkt über die Hauptklasse TIPSModuleObject (UIPSTypes) verwaltet.
Wesentliche Änderungen von Version 2.0 nach Version 2.1
Konstantaten sind jetzt in 100er Schritten definiert.
Kategoriefunktionen vom ObjectManager in den CategoryManager verschoben
LinkManager für die symbolischen Links
Variablenprofile werden über Strings verknüpft und müssen vorher im VariableManager registriert werden.
Wesentliche Änderungen von Version 2.1 nach Version 2.2
PHP Engine kann nun partielle Daten (flush) direkt weiterleiten
Wesentliche Änderungen von Version 2.2 nach Version 2.3
PHP Engine kann nun mit $_POST und $_FILES umgehen
GetFunctionList gibt leserliche Namen für Enumerations zurück
Wesentliche Änderungen von Version 2.3 nach Version 2.4
Keine. Das SDK ist vollständig kompatibel zur 2.3
Wesentliche Änderungen von Version 2.4 nach Version 2.5
Aktuelle Kernel-Version: 2.60
Die Handling der StatusVariablen wurde umgebaut, so dass es nicht mehr so kompliziert ist. Eine StatusVariable kann
jetzt jederzeit über RegisterVariable bzw MaintainVariable erstellt/gelöscht werden. Ein ApplyChanges sollte somit nicht
mehr im Code ausgeführt werden, wenn zur Laufzeit Variablen erstellt werden mussten.
Die StatusVariable sind ab der 2.5 lose gekoppelt. Sie werden nur über den ObjectIdent gesucht und dann entsprechend
erstellt, modifiziert oder gelöscht.