Dokumentation
Snapshots
Ein Snapshot ist der vollständige Zustand von IP-Symcon zu einem bestimmten Zeitpunkt. Er enthält alle Objekte mit ihren Eigenschaften (z.B. Variablen mit Wert und Darstellung, Instanzen mit Konfiguration und Status, Skripte, Ereignisse, Medien und Links), alle Variablenprofile und Vorlagen sowie Informationen zu Server, Lizenz, Spezialschaltern, Sprache und Zeitzone.
Clients wie die Konsole, die Visualisierungen, die Apps oder IPSView laden den Snapshot einmalig, um sich zu initialisieren. Anschließend verfolgen sie alle Änderungen über die Nachrichten von IP-Symcon und wenden diese auf ihren lokalen Stand an. Die Nachrichten erhalten sie über die WebSocket Schnittstelle (siehe Datenaustausch) oder durch Abfrage mit IPS_GetSnapshotChanges. Jede Nachricht trägt dazu eine fortlaufende Nummer, der Snapshot enthält unter timestamp die Nummer der letzten Nachricht, die bereits in ihm berücksichtigt ist. Visualisierungen verwenden einen auf ihre Inhalte gefilterten Snapshot.
Mit IPS_GetSnapshotDiff kann ein Client, der bereits einen Snapshot besitzt, statt des vollständigen Snapshots nur die Unterschiede abrufen.
| IPS_GetSnapshot | liefert den vollständigen Zustand von IP-Symcon |
| IPS_GetSnapshotChanges | liefert die Änderungen seit einer bestimmten Nachricht |
| IPS_GetSnapshotDiff | liefert die Unterschiede zu einem früheren Snapshot |