Grupos de unidades
Dependiendo de los flags especificados, el formato de respuesta puede variar.
Este capítulo describe los flags que se pueden aplicar a los grupos de unidades y las partes correspondientes del JSON resultante que controlan. Si se especifican varios flags, sus respectivas partes se combinan en un solo JSON.
Indique los flags en formato DEC. Para obtener más información, consulte Formato de datos.
El contenido de la respuesta también depende de sus derechos de acceso al elemento. Para obtener más información, consulte Flags y derechos de acceso.
Flags de grupos de unidades
Los siguientes flags pueden aplicarse a los grupos de unidades:
| Valor HEX | Valor DEC | Descripción |
|---|---|---|
| 0x00000001 | 1 | Propiedades básicas (flag base) |
| 0x00000002 | 2 | Propiedades personalizadas |
| 0x00000004 | 4 | Información de facturación |
| 0x00000008 | 8 | Campos personalizados |
| 0x00000010 | 16 | Imagen |
| 0x00000040 | 64 | GUID |
| 0x00000080 | 128 | Campos administrativos |
| 0x3FFFFFFFFFFFFFFF | 4611686018427387903 | Establecer todos los flags de grupo de unidades |
Propiedades básicas
El flag de las propiedades básicas es 0x00000001 (1).
{
"nm":"<text>", /* Nombre */
"cls":<uint>, /* ID de superclase de avl_unit_group, normalmente 5 (consulte la clave classes en la respuesta de token/login) */
"id":<uint>, /* ID del grupo */
"mu":<uint>, /* Sistema de medida: 0 para métrico (SI), 1 para estadounidense, 2 para imperial, 3 para métrico con galones */
"u":[<long>], /* Matriz de ID de las unidades del grupo */
"uacl":<long> /* Derechos de acceso del usuario al grupo de unidades (valor de 64 bits) */
}
Propiedades personalizadas
El flag de las propiedades personalizadas es 0x00000002 (2).
Puede almacenar cualquier dato en las propiedades personalizadas.
{
"prp":{}, /* propiedades personalizadas */
"ftp": { /* Configuración FTP (solo se utiliza para cuentas) */
"hs": <text>, /* Host (solo si está configurado) */
"lg": <text>, /* Inicio de sesión (solo si está configurado) */
"pt": <text>, /* Ruta del directorio (solo si está configurada) */
"ch": <uint>, /* Validez de la configuración FTP: 1 para sí, 0 para no */
"tp": <uint>, /* Usar FTP de Wialon Hosting: 1 para sí, 0 para no */
"fl": <uint> /* Disponibilidad de FTP de Wialon Hosting: 1 para sí, 0 para no */
},
"ct": <uint> /* Hora de creación (marca de tiempo Unix) */
}
Facturación
El flag de la información de facturación es 0x00000004 (4).
{
"crt":<uint>, /* ID del creador */
"bact":<uint> /* ID de la cuenta */
}
Campos personalizados
El flag de los campos personalizados es 0x00000008 (8).
{
"flds":{
"<text>":{ /* ID del campo personalizado */
"id":<uint>, /* ID del campo personalizado */
"n":"<text>", /* nombre del campo personalizado */
"v":"<text>", /* valor del campo personalizado */
"ct":<uint>, /* hora de creación (marca de tiempo Unix) */
"mt":<uint> /* hora de la última modificación (marca de tiempo Unix) */
},
...
},
"fldsmax":<long> /* cantidad máxima de campos personalizados permitida por el plan de facturación de la cuenta (-1: no limitada). Puede ser 0 si el servicio no está incluido en el plan de facturación; los campos personalizados existentes se siguen devolviendo */
}
Imagen del grupo de unidades
El flag de la imagen del grupo de unidades es 0x00000010 (16).
{
"uri":"<text>", /* Ruta de la imagen del grupo de unidades en el servidor. Agréguela a la dirección del servidor de Wialon para obtener la imagen */
"ugi":<uint> /* Cantidad de cambios de imagen */
}
GUID
El flag del GUID es 0x00000040 (64).
{
"gd":"<text>" /* GUID del grupo */
}
Campos administrativos
El flag de los campos administrativos es 0x00000080 (128).
{
"aflds":{ /* campos administrativos */
"<text>":{ /* ID del campo administrativo */
"id":<uint>, /* ID */
"n":"<text>", /* nombre */
"v":"<text>", /* valor */
"ct":<uint>, /* hora de creación (marca de tiempo Unix) */
"mt":<uint> /* hora de la última modificación (marca de tiempo Unix) */
},
...
},
"afldsmax": <long> /* cantidad máxima de campos administrativos permitida por el plan de facturación de la cuenta (-1: no limitada). Puede ser 0 si el servicio no está incluido en el plan de facturación; los campos administrativos existentes se siguen devolviendo */
}