HSL2.0 - Veröffentlichung eigener Module
Inhalt
1.
Eigenes Logikmodul erstellen
2.
Zuweisen eines Dateinamens
3.
Baustein-ID
4.
Nummernkreise
5.
Hilfe-Datei Mustervorlage
6.
HSLZ-Container
7.
Support

## 1.Eigenes Logikmodul erstellen

Jedes Logikmodul kann genau einen Baustein enthalten. Die Module werden als einzelne Dateien mit der Dateiendung HSL im HS/FS-Experte Unterverzeichnis `\logic` abgelegt.

## 2.Zuweisen eines Dateinamens

Der Dateiname eines Logikmoduls besteht aus der Baustein-ID und einer Kurzbeschreibung und besitzt die Dateiendung "`.hsl`". ID und Kurzbeschreibung werden durch einen Unterstrich getrennt. Die Baustein-ID muss eine fünfstellige Nummer aus dem Nummernkreis 10.000-19.999 sein.

## 3.Baustein-ID

Die Nummern 10.000 bis 10.999 werden nicht öffentlich verwendet, d.h. jeder Entwickler kann während der Entwicklungszeit (oder für Bausteine, die er nicht veröffentlichen will) diesen Nummernkreis beliebig verwenden, da diese Nummern niemals von anderen veröffentlichten Bausteinen verwendet werden.

## 4.Nummernkreise

Um möglichst doppelte Baustein-IDs zu vermeiden, gibt es auf unserer Internet-Seite (http://www.dacom-homeautomation.de/) die Möglichkeit, einen bestimmten Nummernkreis für sich zu reservieren. So kann verhindert werden, dass mehrere Benutzer die gleichen Nummern verwenden.
Hinweis
Ein Nummernkreis, den Sie von uns erhalten, liegt immer im Bereich von 11.000 bis 19.999.
Damit ist sichergestellt, dass veröffentlichte Baustein-IDs sich nicht mit privaten (Nummernkreise von 10.000 bis 10.999) überschneiden.
Achtung
Die Baustein-ID muss eindeutig sein.
Das heißt, die Baustein-ID darf im Verzeichnis `\logic` nicht doppelt verwendet werden. Sobald ein Baustein verwendet wird, darf die Baustein-ID nicht mehr geändert werden. Die Baustein-ID kann also nur vor einer Verwendung im Projekt beliebig geändert werden!

## 5.Hilfe-Datei Mustervorlage

Es gibt eine Mustervorlage für die Erstellung einer HTML-Hilfe-Datei für Logikbausteine. Diese finden Sie unter dem Namen `log55555.html`, zusammen mit einem Style-Sheet, im Unterordner `/HSL SDK/Help Template/` der ZIP-Datei, in der auch diese Dokumentation enthalten ist (Schnittstelleninormationen.zip).

## 6.HSLZ-Container

Um die Veröffentlichung und/oder Weitergabe zu vereinfachen, gibt es die Möglichkeit, den Baustein zusammen mit weiteren Zusatzdateien und Hilfe-Dateien in einen Container zu verpacken, der im HS/FS-Experte importiert werden kann.
Näheres dazu siehe `hslz_structure.html` im Unterordner `/HSL SDK/HSLZ/` der ZIP-Datei, in der auch diese Dokumentation enthalten ist (Schnittstelleninormationen.zip).

## 7.Support

Für selbst erstellte Logikmodule gibt es keinen Support. Anregungen können Sie jederzeit per E-Mail an uns senden: logik [at] dacom-ha.de