update_data_flags

La función update_data_flags se usa para agregar y eliminar objetos de una sesión. Los objetos se agregan a una sesión para recibir eventos de estos.

Copied!

svc=core/update_data_flags&params={"spec":[
					{
						"type":"<text>",
						"data":<long|text|[long]>,
						"flags":<long>,	
						"mode":<uint>,
						"max_items":<uint>
					}
				   ]}

Parámetros

Nombre	Descripción
spec	Matriz de unidades que tienen una configuración para solicitar modificación de objetos que están en la sesión.
type	Método de transferencia de objetos a la sesión: id: por ID. Si está elegido este método, es necesario indicar el ID del objeto en el parámetro data. type: por tipo. Si está elegido este método, es necesario indicar el tipo del objeto en el parámetro data (vea search_items). col: por lista de ID. Si está elegido este método, es necesario indicar la matriz de ID de los objetos que le interesan. access: suscripción a los eventos sobre creación/eliminación, recepción/anulación de derechos de acceso de objetos; en el parámetro data: 1, activar; 0, desactivar.
data	Datos. Este parámetro depende del anterior.
flags	Marcas que determinan qué información sobre objetos debe ser agregada a la sesión. Las marcas de objetos de cada tipo se describen en la sección format.
mode	Modo de aplicación de marcas: 0: determinar de nuevo las marcas para objetos indicados. 1: agregar marcas indicadas a las que ya están en la sesión. 2: eliminar marcas indicadas de la sesión (al eliminar la marca básica el objeto se elimina de la sesión). Las marcas se establecen para seguir los cambios de propiedades específicas de un objeto. La cantidad de marcas establecidas depende de sus necesidades. Si quiere recibir todos los eventos, todas las marcas deben ser establecidas. Para recibir los eventos, use la solicitud avl_evts.
max_items	Cantidad máxima de objetos suscritos. Disponible solo cuando type='type'.

Resultado devuelto

Copied!

[		/* matriz de objetos*/
	{
		"i":<long>,	/* ID */
		"d":{		/* otros campos */
			...
		},
		"f":<long>	/* marcas aplicadas con propiedades */
	},
	...
]

El formato del campo “d” depende del tipo del objeto devuelto. Si al enviar esta solicitud está indicado el modo de aplicación de marcas “2”, se devuelve el valor null en el campo “d”. Los formatos de todos los tipos de objetos se describen en la sección format.

Los códigos de errores posibles son:

Código	Descripción
4	Parámetros de entrada incorrectos o error al actualizar marcas.

update_data_flags

Parámetros

Resultado devuelto

Ver también