Campos personalizados
Añada sus propios campos a clientes, sitios y dispositivos, rellénelos en sus formularios y use sus valores en scripts.
Qué es y cuándo usarlo
Los campos personalizados añaden sus propios datos a clientes, sitios y dispositivos: un número de contrato en un cliente, un edificio en un sitio, una etiqueta de inventario o un centro de coste en un dispositivo. Una vez que un campo existe, aparece en los formularios de ese tipo de objeto, su valor se muestra en la pestaña Home del dispositivo y los scripts pueden leerlo.
Un script también puede escribir en un campo personalizado, así que un campo puede contener algo que informa el dispositivo, como un ajuste de la BIOS o la versión de un programa.
Antes de empezar
Un rol con View Core Settings para abrir Admin Center › Settings, View Custom Fields para ver los campos y Manage Custom Fields para añadirlos, editarlos o eliminarlos (Admin Center › Roles, grupo Settings).
Para rellenar los valores: Manage Clients, Manage Sites o Edit Agent, según el objeto.
Un nombre para el campo. Debe ser único entre los campos del mismo destino.
Pasos
Abra Admin Center › Settings y la pestaña Custom Fields.
Elija la pestaña del destino: Clients, Sites o Agents.
Haga clic en Add custom field. El formulario se abre con ese destino seleccionado.
Rellene Name y elija el Field Type.
Para Dropdown Single y Dropdown Multiple, escriba cada opción en Input Options y pulse Enter después de cada una.
Fije un Default Value si el campo debe tener uno.
Marque Required, Hide in Dashboard o Hide in Summary Tab según sea necesario; vea la referencia de campos.
Haga clic en Submit. La consola lo confirma con
Custom field added!.
Para cambiar un campo, haga doble clic en su fila, o haga clic con el botón derecho sobre ella y elija Edit. Target y Field Type no se pueden cambiar después de la creación. Para quitar un campo, haga clic con el botón derecho sobre él y elija Delete; los valores almacenados en él se eliminan con él.
Qué debe ver
El campo aparece en la pestaña de su destino con Name, Field Type, Hide in UI, Hide in Summary Tab, Default Value y Required. Una pestaña sin campos indica No custom fields defined for clients. (con sites o agents en lugar de clients).
Después, el campo aparece:
Clients: en el formulario del cliente (Create Client, Editing CLIENT-A), en Custom Fields. Vea Clientes y sitios.
Sites: en el formulario del sitio, en Custom Fields.
Agents: en el formulario Edit del dispositivo, en la pestaña Custom Fields, y en el recuadro Custom Fields de su pestaña Home en cuanto tiene un valor. Vea La lista de dispositivos.
Cada campo de entrada muestra el valor predeterminado como indicación, por ejemplo Default value: Unassigned.
Cómo verificar que funcionó
Abra el formulario de un objeto de ese destino: Edit en un dispositivo, o Edit en un cliente o un sitio. El campo aparece en Custom Fields.
Rellene un valor y guarde.
Para un campo de dispositivo, abra la pestaña Home del dispositivo: el valor aparece en el recuadro Custom Fields, salvo que el campo tenga activado Hide in Summary Tab.
Reports & Audits › Audits registra la creación del campo como una acción Add Object sobre el objeto Custom Field, y los cambios posteriores como Modify Object o Delete Object.
Usar campos personalizados en scripts
Los argumentos y las variables de entorno de un script pueden leer un campo personalizado por su nombre:
{{agent.Asset Tag}}
El valor del dispositivo en el campo de agente Asset Tag
{{site.Building}}
El valor del campo de sitio Building para el sitio del dispositivo
{{client.Contract Number}}
El valor del campo de cliente Contract Number para el cliente del dispositivo
Cuando el objeto no tiene valor, la variable toma el valor predeterminado del campo. Un valor Dropdown Multiple se pasa como una lista separada por comas, y un valor Checkbox como un booleano del shell del script. Escriba el nombre del campo exactamente como está escrito en Name. Vea Variables de script.
Para escribir en un campo, ejecute un script con la opción de salida Save results to Custom Field y elija el campo en Select custom field. Se almacena la última línea de la salida, o toda la salida con Save all output. Un campo de cliente o de sitio se escribe en el cliente o el sitio del dispositivo. Vea Ejecutar un comando o un script en un dispositivo.
Errores comunes
Failed to add custom field
Ya existe un campo con el mismo nombre para ese destino, o su rol no tiene Manage Custom Fields
Use otro nombre, o pida que se añada el permiso a su rol
Default Value needs to be set for required fields
Required está marcado y Default Value está vacío
Fije un valor predeterminado
Asset Tag is required bajo un campo de un formulario
El campo es obligatorio y no tiene valor
Rellene el campo
La pestaña Custom Fields del dispositivo indica que no hay campos personalizados de agente
No existe ningún campo en Agents, o todos tienen activado Hide in Dashboard
Añada un campo en Agents, o desmarque Hide in Dashboard
El valor no aparece en la pestaña Home
El campo tiene activado Hide in Summary Tab, o no tiene valor
Desmarque la opción, o rellene el valor
Referencia de campos
Target
A qué objetos pertenece el campo. No se puede cambiar después
Client, Site, Agent
La pestaña desde la que empezó
Name
Nombre que se muestra en los formularios y se usa en las variables de script
Hasta 100 caracteres, único dentro del destino
(sin valor)
Field Type
Tipo de entrada. No se puede cambiar después
Text, Number, Dropdown Single, Dropdown Multiple, DateTime, Checkbox
(sin valor)
Input Options
Las opciones de una lista desplegable. Solo para Dropdown Single y Dropdown Multiple
Cualquier texto, una entrada por opción
Vacío
Default Value / Default Value(s)
Valor usado cuando un objeto no tiene ninguno, como indicación en los formularios y en las variables de script
Acorde con el tipo de campo; una de las opciones en las listas desplegables
Vacío
Required
Marca el campo como obligatorio en los formularios, que muestran NAME is required mientras está vacío. Exige un Default Value. No disponible para Checkbox
Activado, desactivado
Desactivado
Hide in Dashboard
Mantiene el campo fuera de los formularios de cliente, sitio y dispositivo. Los scripts pueden seguir leyéndolo y escribiéndolo
Activado, desactivado
Desactivado
Hide in Summary Tab
Mantiene el valor fuera del recuadro Custom Fields de la pestaña Home del dispositivo
Activado, desactivado
Desactivado
Páginas relacionadas
Atualizado
Isto foi útil?