Inhalt

Konfigurationsseite öffnen

Um das Patami Framework zu konfigurieren, doppelklicke in der IP Symcon Management Console auf die Patami Framework Instanz bei den Kern Instanzen:

Ein neues Tab öffnet sich:

Aktualisierungsintervall der Statusvariablen

Über diese drei Konfigurationseinstellungen kann das Intervall, mit dem die verschiedenen Statusvariablen des Frameworks aktualisiert werden, festgelegt werden.

Die Aktualisierungsintervalle müssen zwischen 0 und 3600 Sekunden liegen. Bei ungültigen Werten wird die Instanz als Fehlerhaft markiert und eine entsprechende Fehlermeldung angezeigt.

Wird 0 als Intervall konfiguriert, dann werden die entsprechenden Statusvariablen nicht automatisch aktualisiert.

Die zu den jeweiligen Intervallen gehörenden Statusvariablen können der Tabelle der Statusvariablen entnommen werden.

Automatisches Laden

Das Framework automatisch laden

Über die Checkbox Das Framework automatisch in allen Skripten laden kannst Du dafür sorgen, dass das Framework in allen IPS Skripten zur Verfügung steht.

Das Framework trägt dazu einige Befehle in das IPS Autoload-Skript ein:

<?php
// Patami Framework
// The next four lines are auto-generated, don't touch them!
$fileName = 'C:\IP-Symcon\modules\ipspatami\bootstrap.php';
if (file_exists($fileName)) {
    @require_once($fileName);
}

Das Autoload-Skript heisst __autoload.php und befindet sich im scripts-Unterverzeichnis des IPS Programmordners.

Der in der Variable $fileName enthaltene Dateiname des Bootstrap-Skripts kann sich bei Dir vom Beispiel unterscheiden und wird automatisch vom Framework auf den Pfad Deiner IP Symcon-Installation angepasst.

Sobald Du den Haken der Checkbox wieder entfernst, wird das Autoload-Skript wieder auf den Ursprungszustand zurückgesetzt. Andere Einträge in der Datei werden vom Framework nicht verändert.

Das Laden des Frameworks in allen PHP Skripten führt zu einem erhöhten Resourcenverbrauch und wird die Laufzeiten Deiner Skripte erhöhen. Bei den Tests wurden hierdurch keine Probleme verursacht.

Behalte diesen Hinweis jedoch im Hinterkopf, falls in Deiner IP Symcon-Installation Performance-Probleme bzw. Verzögerungen auftreten sollten. Sollte das passieren, dann öffne bitte ein Issue und melde den Fehler.

Ein eigenes Skript automatisch laden

Über der Checkbox findest Du ein Auswahlfeld für ein Skript.

Hier kannst Du ein eigenes IPS Skript auswählen, das vom Framework beim Ladevorgang ebenfalls geladen wird.

Fehlerbehandlung

Über die Checkbox Unbehandelte Fehler und Ausnahmen protokollieren kannst Du eine erweitere Fehlerbehandlung für PHP Skripte aktivieren.

Beim Ladevorgang des Frameworks werden hierbei Funktionen registriert, die unbehandelte Fehler und Ausnahmen (Exceptions) abfangen und im IPS Log protokollieren.

Aktivierst Du das automatische Laden des Frameworks, dann profitierst Du auch bei eigenen Skripten und Modulen, die nicht speziell für das Patami Framework angepasst worden sind, von der Protokollierung von eventuell auftretenden Fehlern.

Aktionen

In der Testumgebung am Ende des Konfigurationsformular wird die aktuelle Version des Patami Frameworks anzeigt.

Außerdem stehen einige Buttons zur Verfügung.

Statusvariablen aktualisieren

Mit diesem Button kannst Du die Statusvariablen des Frameworks aktualisieren.

Skripte

In eigenen PHP Skripten kannst Du den Status wie folgt aktualisieren:

<?php
$id = 31698 /*[Patami Framework]*/; // Hier die ID der Framework-Instanz eintragen
Patami_UpdateStatus($id);

Bibliothek aktualisieren

Mit diesem Button kannst Du verfügbare Updates für das Framework herunterladen.

Sollte es Updates gegeben haben, dann zeigt das Framework nach dem Update diese Meldung an:

Falls das Framework bereits auf dem aktuellsten Stand sein sollte, erhältst Du diese Meldung:

Debugging

Weitere Details zum Update findest Du, wenn Du das Debugging der Framework Instanz aktivierst, während Du die Bibliothek aktualisierst:

Skripte

In eigenen PHP Skripten kannst Du die Bibliothek wie folgt aktualisieren:

<?php
$id = 31698 /*[Patami Framework]*/; // Hier die ID der Framework-Instanz eintragen
Patami_UpdateLibrary($id);

Issue erstellen

Beim Klick auf den Button wird ein neues Issue im Issue Tracker des Patami Frameworks geöffnet. Hier kannst Du Fehler melden oder ein neues Feature vorschlagen.

Lizenz anzeigen

Beim Klick auf den Button wird die Lizenz des Frameworks geöffnet.

Dokumentation anzeigen

Beim Klick auf den Button wird die Dokumentation des Frameworks geöffnet.

Versionhinweise anzeigen

Beim Klick auf den Button werden die Versionshinweise des Frameworks geöffnet.

  • Keine Stichwörter