starcontrol.appDocs
Erste Schritte

Erste Anlage verbinden

Kunde anlegen, Zugangsdaten prüfen und die erste STARFACE-Anlage synchronisieren.

Eine Anlage muss in STARcontrol immer einem Kunden zugeordnet sein. Lege deshalb zuerst einen Kunden an oder erstelle ihn direkt im Anlagen-Assistenten.

Vorher bereitlegen

  • Die vollständige Host-URL inklusive https:// und gegebenenfalls Port, ohne abschließenden Schrägstrich.
  • Die Login-ID und das Passwort eines geeigneten STARFACE-Benutzers.
  • Den Module-Key des Management-Moduls. Er wird für Synchronisierung und Updates benötigt.
  • Für erweiterte STARFACE-10-Funktionen optional das Client Secret von rest-client-headless.

Produktivsysteme bewusst anbinden

STARcontrol liest nicht nur Zustände. Abhängig von deinen Berechtigungen können über die Anlagenansicht auch Änderungen ausgelöst werden. Prüfe Zugang und Zuordnung vor dem Speichern.

Anlage anlegen

  1. Öffne Anlagen und wähle Neue Anlage.
  2. Ordne die Anlage einem Kunden zu. Vergib einen eindeutigen Anzeigenamen und wähle Typ sowie Update-Level.
  3. Trage Host-URL, Login-ID, Passwort und Module-Key ein.
  4. Aktiviere den STARFACE-10-REST-Zugriff nur, wenn das Client Secret vorhanden ist.
  5. Prüfe die Zusammenfassung und führe den Verbindungstest aus.
  6. Speichere die Anlage.
Schritt Verbindung im Assistenten mit Host-URL, Zugangsdaten, Module-Key und optionalem REST-Zugriff.

Nach dem Speichern

STARcontrol nimmt die Anlage in die Überwachung auf. Der Verfügbarkeitsstatus erscheint zuerst, umfangreichere Bestandsdaten folgen mit der nächsten Synchronisierung. Unter Anlagen erkennst du am Zeitstempel, wie aktuell die Daten sind.

Wenn der Verbindungstest fehlschlägt

Prüfe in dieser Reihenfolge:

  1. Ist die Host-URL vollständig und ohne abschließenden Schrägstrich eingetragen?
  2. Sind Login-ID, Passwort und Module-Key für dieselbe Anlage gültig?
  3. Ist die Anlage von der STARcontrol-Umgebung aus erreichbar?
  4. Bei aktiviertem REST-Zugriff: Gehört das Client Secret zu rest-client-headless?

Du kannst eine Anlage trotz fehlgeschlagenem Test speichern und die Verbindung später korrigieren. Für einen sauberen Start sollte der Test jedoch erfolgreich sein.