Scripts de Clic: Menú de clic derecho del Usuario

Los scripts de clic se pueden ejecutar desde el menú contextual del Usuario. Puedes combinar múltiples acciones comúnmente usadas juntas en una sola, por ejemplo, agregar un usuario a una etiqueta mientras se elimina de otras etiquetas.

Habilitar y crear Scripts de Clic

Los detalles sobre cómo habilitar y crear scripts de clic se pueden encontrar aquí.

Crea un nuevo script de clic eligiendo Menú Principal > Admin > Desarrollo > Constructor de Apps > Agregar nuevo Script de Clic (en la sección de Scripts de Clic).

Para crear scripts de clic que se muestran en el menú contextual del usuario, selecciona el tipo UserRightClickMenu en el formulario Editar Script de Clic. En este caso, la opción Habilitado determina si el script se listará en el menú contextual para los usuarios elegibles.

Aparte de esto, puedes controlar qué roles pueden usar qué scripts restringiendo el acceso a los scripts listados bajo el privilegio _UseClickScript para ese rol. Para poder ver inmediatamente los cambios en la interfaz después de crear un script, asegúrate de que este privilegio esté habilitado para el rol con el privilegio de edición.

Ejemplo: mover un usuario entre etiquetas

Crea tres etiquetas nombradas, por ejemplo, Primera, Segunda, y Tercera. Supongamos que solo una de estas etiquetas debe asignarse a un usuario a la vez. Cuando el operador quiera mover un usuario de una etiqueta a otra, necesitaría abrir el usuario o las etiquetas, desmarcar la antigua y marcar la nueva etiqueta/usuario, y guardar los cambios.

En su lugar, podemos crear un script de clic UserRightClickMenu con el siguiente script:

 
var tag1 = tags.getTagByName('First'); // obtener la etiqueta 'First' por nombre
var tag2 = tags.getTagByName('Second'); // obtener la etiqueta 'Second' por nombre
var tag3 = tags.getTagByName('Third'); // obtener la etiqueta 'Third' por nombre
 
// añadir usuario actual a First, no eliminar nada de First
// no añadir nada a Second, eliminar usuario actual de Second
// no añadir nada a Third, eliminar usuario actual de Third
tags.updateUsers(tag1.id, [user.id], [])
tags.updateUsers(tag2.id, [], [user.id])
tags.updateUsers(tag3.id, [], [user.id])

Habilita y guarda el script, nombrándolo Mover a First como se muestra a continuación.

Y, cuando haces clic en un usuario en el mapa o en la lista de activos, verás que una nueva opción está disponible como se muestra a continuación.

Abre nuevamente el script de clic creado. Con el botón Crear Copia, puedes crear rápidamente una copia de él y crear rápidamente scripts análogos para mover al usuario a la segunda y tercera etiqueta.

Nombre el segundo script Mover a Second, cambia las últimas tres líneas a lo siguiente, luego guarda:

 
tags.updateUsers(tag2.id, [user.id], [])
tags.updateUsers(tag1.id, [], [user.id])
tags.updateUsers(tag3.id, [], [user.id])

Nombre el tercer script Mover a Third, cambia las últimas tres líneas a lo siguiente, luego guarda:

 
tags.updateUsers(tag3.id, [user.id], [])
tags.updateUsers(tag1.id, [], [user.id])
tags.updateUsers(tag2.id, [], [user.id])

Después de guardar los otros dos scripts, el menú de clic derecho del usuario debería tener las tres opciones disponibles. Al hacer clic en cualquiera de ellas se ejecutará el script, añadiendo al usuario a la etiqueta correspondiente mientras se elimina de las otras dos. Reabre una ventana de edición de usuario o etiqueta para ver los cambios.

Notas

  • Al igual que con los scripts de clic de geocerca, también puedes generar solicitudes HTTP con estos scripts. Lee más sobre los scripts de clic de geocerca para obtener instrucciones sobre cómo habilitar el registro desde un script a un archivo de registro.
  • Ten en cuenta que al hacer clic en Ejecutar Script mientras editas scripts de clic, realmente se ejecuta el script para el usuario seleccionado, ejecutando cualquiera de las acciones especificadas (por ejemplo, añadir/eliminar etiquetas como en el ejemplo anterior).
  • Al editar el script, haz clic en los elementos en el árbol de objetos del editor de scripts para ver información más detallada sobre otros parámetros y métodos disponibles para este tipo de script.