Referenz zu Einstellungsschlüsseln für Aktionen

Jamf Connect Dokumentation

Solution

Application

Jamf Connect

Content Type

Technische Dokumentation

Utilities & Services

ft:locale

de-DE

Das Verhalten des Menüs wird über die folgenden Einstellungsschlüssel innerhalb der Domäne com.jamf.connect.actions festgelegt. Für jedes Element ist ausschließlich der Name zwingend erforderlich, alle anderen Teile sind optional. Beachten Sie beim Erstellen von Menüleistenelementen Folgendes:

Das Ergebnis jedes Befehls kann an jeden anderen Befehl weitergegeben werden. Wenn Sie als Befehlsoption <<result>> verwenden, wird diese Variable durch das Ergebnis des vorherigen Befehls ersetzt.
Die Ergebnisse der Befehle true oder false werden nicht an den nächsten Befehl weitergegeben.
Wird true oder false am Ende des Befehls hinzugefügt, wird dieser Befehl nur ausgeführt, wenn der zuvor ausgeführte Befehl das entsprechende Ergebnis zurückgibt. Wenn Sie beispielsweise als Befehlsnamen alertTrue verwenden, wird der Befehl alert nur dann ausgeführt, wenn der zuvor ausgeführte Befehl das Ergebnis true zurückgibt.

Note:

Der Ergebnisstatus ist persistent, sodass mehrere Befehle in Abhängigkeit von einem einzigen Ergebnis ausgeführt bzw. nicht ausgeführt werden können. Wenn z. B. das Ergebnis true an eine Folge von Befehlen übergeben wird, bei denen false-Modifikatoren an die Befehlsnamen angehängt sind, wird keiner dieser Befehle ausgeführt.

Globale Einstellungen

Die folgende Tabelle enthält die globalen Einstellungen für ein benutzerdefiniertes Menüleisten-Aktionskonfigurationsprofil.


Einstellung	Beschreibung	Typ
`MenuIcon`	Gibt an, ob für das Aktionsmenü ein (grünes, gelbes oder rotes) Statussymbol angezeigt wird. Note: Durch den Schlüssel `MenuIcon` wird je nach der höchsten Meldungsstufe aller Elemente im Untermenü ein grünes, gelbes oder rotes Symbol neben dem Aktionsmenü angezeigt. Wenn beispielsweise in einem Untermenü sichtbare Aktionen vorhanden sind, die ein rotes Symbol anzeigen, wird auch für das Hauptmenü ein rotes Symbol angezeigt. Wenn in einem Untermenü sichtbare Aktionen vorhanden sind, die ein gelbes Symbol anzeigen, aber keine mit einem roten Symbol, wird für das Hauptmenüelement ein gelbes Symbol angezeigt.	Boolescher Wert
`MenuText`	Wenn diese Option auf den Wert „true“ gesetzt ist, verwendet Self Service das Ergebnis des Befehls als Text des Menüelements. Note: Um den Schlüssel `MenuText` nutzen zu können, muss der jeweilige Befehl als Ergebnis `<<menu>>` gefolgt von Ihrem Menü ausgeben. Der Titel des Menüs wird von dem jeweils letzten Befehl bestimmt, dessen Ergebnis die Ausgabe „`<<menu>>`“ enthält.	Boolescher Wert

Inhalt der Aktion


Einstellung	Beschreibung	Typ
`Name`	(Erforderlich) Der Name der Aktion	Zeichenfolge
`Title`	Der Text, der zur Anzeige des Elements in der Menüleiste verwendet wird. Note: Wenn dieser Schlüssel nicht konfiguriert ist, wird als Titel der Inhalt des Schlüssels Name verwendet.	Lexikon
`Show`	Legt fest, ob das Element im Menü angezeigt wird oder nicht. Note: Alle Befehle im Befehl Show müssen den Wert „true“ zurückgeben, damit das Menüelement angezeigt wird.	Array
`Action`	Enthält die Aktion.	Array
`Post`	Legt fest, was geschieht, nachdem die Aktion ausgeführt wurde.	Array
`GUID`	Die eindeutige Kennung der Aktion.	Zeichenfolge
`Connected`	Gibt an, ob die festgelegte Aktion nur dann ausgeführt werden soll, wenn eine Verbindung zu einer Active Directory Domäne besteht.	Boolescher Wert
`Timer`	Die Dauer in Minuten bis zum Ausführen der Aktion.	Ganzzahl
`ToolTip`	Der Text, der bei Halten des Mauszeigers über ein Menüelement angezeigt wird	Zeichenfolge
`Separator`	Erstellt eine optische Trennlinie in der Menüleiste.

Befehle

Self Service enthält integrierte Befehle, die zur Ausführung von Aktionselementen verwendet werden können. Beachten Sie in Bezug auf Befehle Folgendes:

Alle Optionen sind Zeichenketten.
Von allen Befehlen können Ergebnisse ausgegeben werden.
Ergebnisse sind zwischen verschiedenen Befehlen nicht persistent.
CommandOptions Self Service unterstützt die standardmäßigen Variablen wie <<domain>>, <<user>> und <<email>>.
Bei Befehlen wird zwischen Groß- und Kleinschreibung unterschieden.


Befehl	Funktion	Befehlsoptionen
`path`	Führt ein Binärprogramm unter einem bestimmten Pfad aus.	Pfad, in dem das Programm ausgeführt werden soll
`app`	Öffnet ein Programm in einem bestimmten Dateipfad.	Pfad des zu öffnenden Programms
`url`	Öffnet eine URL im Standardbrowser des Benutzers.	Zu öffnende URL
`ping`	Überprüft einen Host mit „ping“.	Mit „ping“ zu überprüfender Host
`adgroup`	Ermittelt, ob der aktuelle Benutzer Mitglied einer Active Directory Gruppe ist.	Zu prüfende Gruppe
`alert`	Zeigt dem Benutzer ein modales Dialogfeld an.	Meldungstext Note: Wenn keine Befehlsoptionen angegeben werden oder diese den Wert „true“ oder „false“ aufweisen, wird keine Meldung angezeigt. Sie können dies nutzen, um nur Fehler anzuzeigen.
`notify`	Zeigt eine Mitteilung in der Mitteilungszentrale an.	Mitteilungstext Note: Wenn keine Befehlsoptionen angegeben werden oder diese den Wert „true“ oder „false“ aufweisen, wird keine Mitteilung angezeigt. Sie können dies nutzen, um nur Fehler anzuzeigen.
`false`	Ein Befehl, der immer den Wert „false“ zurückgibt. Dies könnte verwendet werden, um vorherige Ergebnisse in einem Befehlssatz zu löschen.	Text
`true`	Ein Befehl, der immer den Wert „true“ zurückgibt. Dies könnte verwendet werden, um vorherige Ergebnisse in einem Befehlssatz zu löschen.	Text