Descripción de la estructura de un manifiesto del esquema de JSON
Puedes usar un editor de texto para crear el manifiesto del esquema de JSON de tu app y utilizar una herramienta de validación de terceros, como https://jsonlint.com, para validar el formato.
El formato general del manifiesto de una app tiene un aspecto similar al manifiesto del esquema de JSON que aparece en el siguiente sitio web:
https://support.google.com/chrome/a/answer/9771882
Si quieres ver la documentación oficial y más información sobre el esquema de JSON, consulta el siguiente sitio web:
https://json-schema.org
Propiedades de aplicación
El manifiesto de una app contiene un encabezado seguido de una lista de propiedades de aplicación. Cada propiedad contiene un par de clave y valor. Cuando se definen estos pares de clave y valor y se añade el manifiesto, Jamf Pro genera automáticamente una vista descriptiva de la lista de propiedades en la interfaz de Jamf Pro que te permitirá personalizar la app.
Cada propiedad definida en el manifiesto del esquema de JSON contiene los siguientes elementos:
-
Key Name: nombre de la propiedad.
-
title: este elemento define el nombre de la propiedad.
-
description: descripción de la propiedad.
-
property_order: este elemento define el orden numérico de la propiedad en la lista empezando por arriba. Los números más bajos aparecen en la parte superior.
-
type: este elemento define el tipo de valor de la propiedad (p. ej., «entero»).
Si quieres ver una lista de los tipos de valores y su implantación en Jamf Pro, consulta Apéndice: Ajustes configurables.
La siguiente tabla contiene un manifiesto del esquema de JSON de muestra para la app de ejemplo «Disk Manager» (Gestor de discos), que consta de un encabezado y de varias propiedades de aplicación. En cada una de las filas de la tabla se muestra cómo generar el formulario y se presenta el formulario tal y como aparece en Jamf Pro.
|
Propiedad de aplicación |
Par de clave y valor |
Ajuste generado por Jamf Pro |
|
Encabezado |
{ "title": "Disk Manager (net.talkingmoose.diskmanager)", "description": "Preference settings for the Disk Manager application", "properties": { |
El encabezado incluye el título del manifiesto y una descripción. También puede incluir información útil como el dominio de la app (identificador del paquete). |
|
Propiedad 1 |
"askForPasswordDelay": { "title": "Ask For Password Delay", "description": "Disk Manager will wait the selected amount of time before requiring a password.", "property_order": 5, "type": "integer", "options": { "enum_titles": ["immediately", "5 seconds", "1 Minute", "5 Minutes", "15 Minutes", "1 Hour", "4 hours", "8 hours"] }, "enum": [0,5,60,300,900,3600,14400,28800] }, |
En esta propiedad, type define el valor como integer e incluye opciones predefinidas para la propiedad (que se definen en el par de clave y valor enum_titles). La definición de valores de enum_type permite a Jamf Pro generar este ajuste como un menú emergente con opciones basadas en esos valores. |
|
Propiedad 2 |
"diskCacheSize": { "title": "Disk Cache Size", "description": "Set disk cache size, in bytes.", "property_order": 10, "type": "integer" }, |
En esta propiedad, type define el valor como integer (entero), pero no incluye un grupo de opciones predefinidas. Jamf Pro genera este ajuste como un campo de texto en el que puedes introducir un número entero. |
|
Propiedad 3 |
"primaryServer": { "title": "Primary Server", "description": "Disk Manager will default to this server.", "property_order": 15, "type": "string", "options": { "enum_titles": ["Server 1", "Server 2", "Server 3"] }, "enum": ["https://server1.talkingmoose.net/", "https://server2.talkingmoose.net/", "https://server3.talkingmoose.net"/] }, |
En esta propiedad, type define el valor como string e incluye opciones predefinidas como valores de la propiedad (que se definen en el par de clave y valor enum_titles). La definición de valores de enum_type permite a Jamf Pro generar este ajuste como un menú emergente con opciones basadas en esos valores. |
|
Propiedad 4 |
"downloadDirectory": { "title": "Download Directory", "description": "Choose the default location for downloading working files.", "property_order": 20, "type": "string" }, |
En esta propiedad, type define el valor como string, pero no incluye un grupo de opciones predefinidas. Jamf Pro genera este ajuste como un campo de texto en el que puedes introducir texto. |
|
Propiedad 5 |
"askForPassword": { "title": "Ask For Password", "description": "Set Disk Manager application to require a password.", "property_order": 25, "type": "boolean" }, |
En esta propiedad, type define el valor como boolean (booleano). Jamf Pro genera este ajuste como un menú desplegable con las opciones de verdadero o falso. |
|
Propiedad 6 |
"domainSafeList": { "title": "Domain Safelist", "description": "Disk Manager will not filter these domains.", "property_order": 30, "type": "array", "items": { "type": "string", "title": "Domain" } }, |
En esta propiedad, type define el valor como array con los elementos de la matriz definidos como string. Jamf Pro genera este ajuste como una lista de uno o varios campos de texto en los que puedes introducir datos. |
|
Propiedad 7 |
"serverList": { "title": "Server List", "description": "Add servers to management list.", "property_order": 35, "type": "array", "items": { "type": "object", "properties": { "serverAddress": { "title": "Hostname", "type": "string" }, "macAddress": { "title": "MAC Address", "type": "string" }, "ipAddress": { "title": "IP Address", "type": "string" } } } } |
En esta propiedad, type define el valor como array (matriz) con uno o varios diccionarios, cada uno de ellos con subpropiedades definidas como string. Jamf Pro genera este ajuste como una lista de campos de texto en los que puedes proporcionar información para varios elementos de la lista. El número de campos adicionales de la lista depende del número de subpropiedades adicionales que se definan. Nota: En la última propiedad definida en el manifiesto no debe incluirse una coma de separación después de la última llave (“}”). |
Interfaz de Jamf Pro
Después de añadir el manifiesto del esquema de JSON, Jamf Pro genera automáticamente una vista descriptiva de la lista de propiedades en la interfaz de Jamf Pro que te permitirá personalizar la app de un modo similar al siguiente:
