Formato de datos

En esta sección se describen los flags que se pueden utilizar en diferentes solicitudes. Los flags que se usan influyen en el resultado que se devuelve en JSON.

Si quiere obtener en el resultado devuelto los valores de varios flags a la vez, indique la suma de estos flags en la solicitud. Por ejemplo, si quiere obtener los valores de las propiedades básicas 0x00000001 (1) y de las propiedades personalizadas 0x00000002 (2) de un grupo de unidades, indique el valor 3 en la solicitud.

En las solicitudes, los flags se deben indicar en formato DEC. El formato HEX solo se admite como formato de texto, por ejemplo "flags":"0x101".

Los flags definen qué datos solicita. Sus derechos de acceso al objeto definen cuáles de esos datos recibe.

El sistema comprueba los derechos de acceso para cada clave por separado, no para el flag en conjunto, por lo que un mismo flag puede devolver solo algunas de sus claves. Una clave para la que no tiene el derecho de acceso no aparece en la respuesta, ni siquiera como un valor vacío.

Por ejemplo, el flag de las propiedades avanzadas 0x00000100 (256) de una unidad devuelve las claves uid, uid2, hw, ph, ph2 y psw a los usuarios con el derecho Ver propiedades de conexión, y las claves act, act_reason y dactt a los usuarios que solo tienen el derecho Ver objeto y sus propiedades básicas.

Las claves que contienen la cantidad máxima permitida de elementos por lo general requieren el derecho para modificar la colección y no el derecho para verla. Por ejemplo, el flag de las geocercas 0x00001000 (4096) de un recurso devuelve la clave zl a los usuarios con el derecho Ver geocercas, y la clave zlmax solo a los usuarios con el derecho Crear, modificar y eliminar geocercas.

Para comprobar qué derechos tiene, envíe el flag básico 0x00000001 (1) en una solicitud core/search_item o core/search_items y consulte el parámetro uacl de la respuesta. Este muestra sus derechos sobre el objeto, con las limitaciones del token ya aplicadas.

Una clave también puede faltar por las siguientes causas:

• El flag del token. Toda sesión se crea con un token, y su flag (fl) puede limitar aún más sus derechos de acceso. Un derecho de acceso que el flag del token no incluye no está disponible, aunque el usuario lo tenga. Para conocer los derechos que otorga cada flag de token, consulte Tokens.

• Los servicios y los límites del plan de facturación. Si el plan de facturación de la cuenta no incluye un servicio, o si el servicio alcanzó su límite, la respuesta no contiene datos de este servicio, incluso si tiene todos los derechos de acceso. Para comprobar los servicios y los derechos a la vez, utilice core/check_items_billing.

• Los flags de suscripción. Algunos flags no devuelven ningún dato. En su lugar, suscriben la sesión a los eventos. Esto se aplica, por ejemplo, a los flags Mensajes y Asuntos.