Konfigurieren von Skript-Buttons im AdminClient
Die Vorgehensweise zur Konfiguration eines Skript-Buttons wird beispielhaft Schritt für Schritt dargestellt.
Voraussetzung ist, dass Scripting aktiviert ist.
Gehen Sie dazu folgendermaßen vor:
Skript aktivieren
Voraussetzung für diesen Teilschritt ist mindestens ein Skript mit dem Namen ScriptButton1 im Format *.bat oder *.exe (z.B. ScriptButton1.bat oder ScriptButton1.exe).
- Öffnen Sie das Modul Skriptmanagement im AdminClient.
- Navigieren Sie im Bereich Quelldateien zu einer der Dateien ScriptButton1.bat oder ScriptButton1.exe und kopieren diese in die Registerkarte Server-Skriptverzeichnis zur automatischen Client-Aktualisierung.
- Klicken Sie auf die Schaltfläche Vorschau unter dem Reiter Start in der Gruppe Buttonskripte, um den Dialog Vorschau anzuzeigen.
- Klicken Sie auf die Schaltfläche im Dialog Vorschau, um den Dialog Test anzuzeigen.
- Im Dialog Test im Feld Test wird der Text Button 1 gedrückt angezeigt.
- Bestätigen Sie mit Ok und schließen Sie die Vorschau.
- Klicken Sie nun auf die Schaltfläche Übernehmen, um das Skript zu aktivieren.
Öffnen Sie nun den UserClient und klicken auf den Reiter Extras. In der Menüleiste ganz rechts wird die Schaltfläche Skript1 unter der Anwendung Skripte angezeigt. Testen Sie das Skript, indem Sie auf die Schaltfläche klicken. Die Meldung Ausführen des Skripts1 wird angezeigt und das Skript wird ein Mal ausgeführt.
Icon konfigurieren
Voraussetzung für diesen Teilschritt ist eine Bilddatei mit dem Namen ScriptButton1 im Format PNG, BMP oder JPG (z.B. ScriptButton1.png).
- Öffnen Sie das Modul Skriptmanagement im AdminClient.
- Kopieren Sie die Bilddatei in die Registerkarte Server-Skriptverzeichnis zur automatischen Client-Aktualisierung, um diese Datei als Icon für die Schaltfläche zu verwenden.
- Klicken Sie auf die Schaltfläche Vorschau unter dem Reiter Start in der Gruppe Buttonskripte, um den Dialog Vorschau anzuzeigen.
- Das kopierte Bild wird im Dialog Vorschau für die Schaltfläche von Skript 1 angezeigt.
- Mit der Schaltfläche Übernehmen laden Sie das Bild in die Registerkarte Server-Skriptverzeichnis. Damit kann es im UserClient verwendet werden.
Wechseln Sie zum UserClient und klicken unter Extras auf die Schaltfläche Vom Server aktualisieren. Das Symbol/Bild wird für die Schaltfläche von Skript1 angezeigt.
Beschriftung und Tooltip konfigurieren
Voraussetzung für diesen Teilschritt ist eine Initialisierungsdatei ScriptButton1.ini mit folgenden Einträgen in der Sektion [ButtonProperties]:
| INI-Schlüssel | I/O | Erklärung |
|---|---|---|
| Text | I | Beschriftung des Buttons |
| Tooltip | I |
Tooltip des Buttons in der GUI |
| Text_<Sprache> | I |
Übersetzung der Beschriftung des Buttons in der GUI (_DE / _EN …) |
| Tooltip_<Sprache> | I |
Übersetzung des Tooltips des Buttons in der GUI (_DE / _EN …) |
- Öffnen Sie das Modul Skriptmanagement im AdminClient.
- Kopieren Sie die Datei ScriptButton1.ini in das Server-Skriptverzeichnis zur automatischen Client-Aktualisierung.
- Klicken Sie auf Übernehmen, um die INI-Datei ins Server-Skriptverzeichnis zur automatischen Client-Aktualisierung zu laden.
Wechseln Sie zum UserClient, klicken auf die Schaltfläche Vom Server aktualisieren und prüfen Sie Ihre deutschen und englischen Namen und Tooltips. Den englischen Text sehen Sie, wenn Sie unter Extras die Sprache in Englisch ändern und der UserClient neu gestartet wurde.
Festlegen, dass das Skript komponentenabhängig ausgeführt werden soll
- Fügen Sie in der Datei ScriptButton.ini unter [ButtonProperties] die Zeile ComponentSpecific=Y ein.
- Führen Sie die Schritten 5. - 8. im AdminClient im Modul Skriptmanagement durch.
Wechseln Sie zum UserClient und klicken Sie auf die Schaltfläche Vom Server aktualisieren. Markieren Sie mindestens eine Komponente und klicken Sie auf den Skript-Button. Die Meldung Skript "Name des Buttons" wird für n Komponenten ausgeführt. wird angezeigt.
Beispiel für die INI-Datei ScriptButton1.ini
| [ButtonProperties] Text=S7-Abzug Tooltip="This button starts S7 upload job" Text_de="S7 Start" Tooltip_de="Dieser Button startet den S7 Upload-Job" ComponentSpecific=Y |