VUserGroup

Representa a un grupo de usuarios declarado en el servidor de aplicaciones.

Esta clase se ha incorporado al API en la versión 7.16.

Funciones

Constructor

Función
VUserGroup()

Generales

Retorno	Función
Number	id()
String	name()
void	setName( String name )

De estilos

Retorno	Función
Boolean	canCreateSolutions()
Boolean	canDeleteSolutions()
Boolean	canRunDataClient()
void	setCanCreateSolutions( Boolean set )
void	setCanDeleteSolutions( Boolean set )
void	setCanRunDataClient( Boolean set )

De permisos de soluciones

Retorno	Función
Number	editPermission( String solutionName )
StringArray	editPermissionList()
Boolean	hasEditPermission( String solutionName )
void	removeAllEditPermission()
void	removeEditPermission( String solutionName )
void	setEditPermission( String solutionName, Number flags )

De permisos de instancias de datos

Retorno	Función
void	addDataPermission( Number dataInstanceCode )
NumberArray	dataPermissionList()
Boolean	hasDataPermission( Number dataInstanceCode )
void	removeAllDataPermission()
void	removeDataPermission( Number dataInstanceCode )

De permisos de instancias de aplicación

Retorno	Función
void	addAppPermission( Number appInstanceCode )
NumberArray	appPermissionList()
Boolean	hasAppPermission( Number appInstanceCode )
void	removeAllAppPermission()
void	removeAppPermission( Number appInstanceCode )

De permisos de carpetas compartidas

Retorno	Función
void	addAuthorizedSharedFolder( String folderName )
StringArray	authorizedSharedFolders()
Boolean	isAuthorizedSharedFolder( String folderName )
void	removeAuthorizedSharedFolder( String folderName )

Enumeraciones

Flags de permisos de soluciones

• SolutionFlagView = 0x01

• SolutionFlagEdit = 0x02

• SolutionFlagTranslate = 0x04

• SolutionFlagCreate = 0x08

• SolutionFlagDelete = 0x10

• SolutionFlagAll = (SolutionFlagView|SolutionFlagEdit|SolutionFlagTranslate|SolutionFlagCreate|SolutionFlagDelete)

Documentación de funciones

Constructor

VUserGroup()

Constructor. Crea una instancia de objeto de la clase VUserGroup.

Funciones generales

Number id()

Devuelve el código numérico del grupo de usuario.

String name()

Devuelve el nombre del grupo de usuario.

void setName( String name )

Modifica el nombre del grupo de usuarios.

Parámetros:

• name: Texto con el nombre del usuario a grabar.

Este comando solo funcionará en la creación de un nuevo usuario, es decir, mientras no tenga asignado el id, una vez que usuario ha sido creado y tiene asignado un id esta función no será funcional y no modificará el nombre del usuario. Este control se realiza para asegurar que un usuario no puede modificar su nombre una vez creado.

Funciones de estilos

Boolean canCreateSolutions()

Devuelve true si el grupo de usuario tiene activado el check "Puede crear soluciones", devuelve false en caso contrario.

Boolean canDeleteSolutions()

Devuelve true si el grupo de usuario tiene activado el check "Puede borrar soluciones", devuelve false en caso contrario.

Boolean canRunDataClient()

Devuelve true si el grupo de usuario tiene activado el check "Puede ejecutar proyectos de datos con vDataClient", devuelve false en caso contrario.

void setCanCreateSolutions( Boolean set )

Activa o desactiva el check "Puede crear soluciones" en función del parámetro.

Parámetros:

• set: True para activar el check "Puede crear soluciones", false para desactivarlo.

void setCanDeleteSolutions( Boolean set )

Activa o desactiva el check "Puede borrar soluciones" en función del parámetro.

Parámetros:

• set: True para activar el check "Puede borrar soluciones", false para desactivarlo.

void setCanRunDataClient( Boolean set )

Activa o desactiva el check "Puede ejecutar proyectos de datos con vDataClient" en función del parámetro.

Parámetros:

• set: True para activar el check "Puede ejecutar proyectos de datos con vDataClient", false para desactivarlo.

Funciones de permisos de soluciones

Number editPermission( String solutionName )

Devuelve un valor numérico que representa los permisos de edición del grupo de usuario para la solución especificada en el parámetro.

El valor devuelto será la combinación de los flags de permisos de soluciones (ver enumeración). Los valores con combinables mediante el uso del operador bitwise or booleano "|".

Parámetros:

• solutionName: Nombre de la solución.

StringArray editPermissionList()

Devuelve un array con los nombres de las soluciones a las que tiene permiso el grupo de usuario.

Boolean hasEditPermission( String solutionName )

Devuelve true si el grupo de usuario tiene permisos de edición para la solución especificada en el parámetro.

Parámetros:

• solutionName: Nombre de la solución.

void removeAllEditPermission()

Elimina los permisos de edición del grupo de usuario para todas las soluciones.

void removeEditPermission( String solutionName )

Elimina los permisos de edición del grupo de usuario para la solución especificada en el parámetro.

Parámetros:

• solutionName: Nombre de la solución.

void setEditPermission( String solutionName, Number flags )

Cambia los permisos de edición del grupo de usuario para la solución especificada en el parámetro. Los flags de configuración de los permisos son combinables y permiten activar y desactivar múltiples estilos a la vez.

Parámetros:

• solutionName: Nombre de la solución.

• flags: Sus valores con combinables mediante el operador bitwise or booleano "|". Ver enumeración de flag de permisos de soluciones.

Funciones de permisos de instancias de datos

void addDataPermission( Number dataInstanceCode )

Añade el permiso al grupo de usuario para el proyecto de datos especificado en el parámetro.

Parámetros:

• dataInstanceCode: Código numérico de la instancia del proyecto de datos.

NumberArray dataPermissionList()

Devuelve un array con los código de instancia de los proyectos de datos a los que tiene permiso el grupo de usuario.

Boolean hasDataPermission( Number dataInstanceCode )

Devuelve true si el grupo de usuario tiene permiso para el proyecto de datos especificado en el parámetro, y devuelve false en caso contrario.

Parámetros:

• dataInstanceCode: Código numérico de la instancia del proyecto de datos.

void removeAllDataPermission()

Elimina todos los permisos de instancias de proyectos de datos del grupo de usuario.

void removeDataPermission( Number dataInstanceCode )

Elimina el permiso del grupo de usuario para el proyecto de datos especificado en el parámetro.

Parámetros:

• dataInstanceCode: Código numérico de la instancia del proyecto de datos.

Funciones de permisos de instancias de aplicación

void addAppPermission( Number appInstanceCode )

Añade el permiso al grupo de usuario para el proyecto de aplicación especificado en el parámetro.

Parámetros:

• appInstanceCode: Código numérico de la instancia del proyecto de aplicación.

NumberArray appPermissionList()

Devuelve un array con los código de instancia de los proyectos de aplicación a los que tiene permiso el grupo de usuario.

Boolean hasAppPermission( Number appInstanceCode )

Devuelve true si el grupo de usuario tiene permiso para el proyecto de aplicación especificado en el parámetro, y devuelve false en caso contrario.

Parámetros:

• appInstanceCode: Código numérico de la instancia del proyecto de aplicación.

void removeAllAppPermission()

Elimina todos los permisos de instancias de proyectos de aplicación del grupo de usuario.

void removeAppPermission( Number appInstanceCode )

Elimina el permiso del grupo de usuario para el proyecto de aplicación especificado en el parámetro.

Parámetros:

• appInstanceCode: Código numérico de la instancia del proyecto de aplicación.

Funciones de permisos de carpetas compartidas

void addAuthorizedSharedFolder( String folderName )

Añade el permiso al grupo de usuario para usar la carpeta compartida especificada en el parámetro.

Parámetros:

• folderName: Nombre de la carpeta compartida.

StringArray authorizedSharedFolders()

Devuelve un array con los nombres de las carpetas compartidas a las que tiene permiso el grupo de usuario.

Boolean isAuthorizedSharedFolder( String folderName )

Devuelve true si el grupo de usuario tiene permiso para utilizar la carpeta compartida especificada en el parámetro.

Parámetros:

• folderName: Nombre de la carpeta compartida.

void removeAuthorizedSharedFolder( String folderName )

Elimina el permiso al grupo de usuario para usar la carpeta compartida especificada en el parámetro.

Parámetros:

• folderName: Nombre de la carpeta compartida.