Referencia de claves de preferencias de acción

Documentación de Jamf Connect

Solution

Application

Jamf Connect

Content Type

Documentación técnica

Utilities & Services

ft:locale

es-ES

En el dominio com.jamf.connect.actions, las siguientes claves de preferencias determinan el comportamiento del menú. El único elemento obligatorio de cada ítem es el nombre; el resto son opcionales. Tenga en cuenta lo siguiente al crear ítems de barra de menús:

El resultado de cualquier comando se puede pasar al siguiente. Al usar <<result>> como opción de comando, se sustituirá por el resultado del comando anterior.
Los resultados true o false no pasan al siguiente comando.
Si añade true o false al final del comando, ese comando solo se ejecutará si el comando ejecutado anteriormente devuelve el resultado correspondiente. Por ejemplo, si usa alertTrue como nombre del comando, solo se ejecutará el comando alert si el comando ejecutado anteriormente ha devuelto el resultado true.

Nota:

El estado del resultado es persistente, lo que permite designar múltiples comandos para que se ejecuten o no en función de un único resultado. Por ejemplo, si se pasara un resultado de true a unos comandos de secuencia con los modificadores false adjuntos a sus nombres de comando, no se ejecutaría ninguno de esos comandos.

Preferencias globales

La siguiente tabla incluye las preferencias globales para un perfil de configuración de acción de barra de menús personalizada.


Ajuste	Descripción	Tipo
`MenuIcon`	Determina si el menú de acción mostrará un icono de estado (verde, amarillo o rojo). Nota: `MenuIcon` mostrará un icono verde, amarillo o rojo junto al menú Acción principal basado según el máximo grado de alerta de todos los ítems del submenú. Por ejemplo, si tiene alguna acción de submenú visible que muestre un icono rojo, el menú principal mostrará un icono rojo. Si una acción de submenú muestra un icono amarillo y ninguna muestra un icono rojo, el ítem de menú principal mostrará un icono amarillo.	Booleano
`MenuText`	Cuando se define como verdadero, Self Service+ usará el resultado del comando como el texto del ítem de menú. Nota: `MenuText` requiere un comando para devolver un resultado de `<<menu>>` seguido de su menú. El último comando en devolver un resultado que contenga `<<menu>>` determinará el título del menú.	Booleano

Contenido de una acción


Ajuste	Descripción	Tipo
`Name`	(Obligatorio) El nombre de la acción	Cadena
`Title`	El texto usado para mostrar el ítem en la barra de menús Nota: Si no se especifica, se usará el Name como título.	Diccionario
`Show`	Determina si el ítem se muestra en el menú o no. Nota: Todos los comandos del comando Show deben devolver el valor «true» para que se muestre el ítem de menú.	Matriz
`Action`	Contiene la acción.	Matriz
`Post`	Determina qué ocurre después de que se ejecute la acción.	Matriz
`GUID`	El ID exclusivo de la acción	Cadena
`Connected`	Determina si la acción debe ejecutarse solo cuando haya conexión con un dominio de Active Directory.	Booleano
`Timer`	Tiempo en minutos antes de ejecutar la acción.	Entero
`ToolTip`	El texto mostrado al pasar el puntero sobre un ítem de menú	Cadena
`Separator`	Crea una barra de separación visual en la barra de menús.

Comandos

Self Service+ tiene comandos integrados que se pueden usar para ejecutar ítems de acción. Tenga en cuenta lo siguiente en relación con los comandos:

Todas las opciones son cadenas.
Todos los comandos devuelven resultados.
Los resultados no persisten entre comandos.
CommandOptions admite las variables de Self Service+ estándar, como <<domain>>, <<user>> e <<email>>.
Los comandos distinguen entre mayúsculas y minúsculas.


Comando	Función	Opciones de comandos
`path`	Ejecuta un binario en una ruta de archivo específica.	La ruta que ejecutar.
`app`	Abre una aplicación en una ruta de archivo específica.	La ruta a la aplicación que abrir.
`url`	Abre una URL en el navegador por omisión del usuario.	La URL que abrir.
`ping`	Envía un ping a un host.	El host al que enviar el ping.
`adgroup`	Determine si el usuario actual es un miembro de un grupo de Active Directory.	El grupo que probar.
`alert`	Muestra un diálogo modal al usuario.	El texto de la alerta. Nota: Si las opciones del comando están en blanco o son «true» (verdadero) o «false» (falso), no se muestra ninguna alerta. Puede usar esto para mostrar solo los errores.
`notify`	Muestra una notificación en el centro de notificaciones.	El texto de la notificación. Nota: Si las opciones del comando están en blanco o son «true» (verdadero) o «false» (falso), no se muestra ninguna notificación. Puede usar esto para mostrar solo los errores.
`false`	Un comando que siempre devuelve el valor falso. Esto se podría usar para borrar resultados anteriores de un conjunto de comandos.	Texto
`true`	Un comando que siempre devuelve el valor verdadero. Esto se podría usar para borrar resultados anteriores de un conjunto de comandos.	Texto