VUserGroup

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

Indice de funciones

Constructor

VUserGroup()

Generales

Number id()

String name()

void setName( String name )

De estilos

Boolean canCreateSolutions()

Boolean canDeleteSolutions()

Boolean canRunDataClient()

void setCanCreateSolutions( Boolean set )

void setCanDeleteSolutions( Boolean set )

void setCanRunDataClient( Boolean set )

De permisos de soluciones

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

void addDataPermission( Number dataInstanceCode )

NumberArray dataPermissionList()

Boolean hasDataPermission( Number dataInstanceCode )

void removeAllDataPermission()

void removeDataPermission( Number dataInstanceCode )

De permisos de instancias de aplicación

void addAppPermission( Number appInstanceCode )

NumberArray appPermissionList()

Boolean hasAppPermission( Number appInstanceCode )

void removeAllAppPermission()

void removeAppPermission( Number appInstanceCode )

De permisos de carpetas compartidas

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

• SolutionFlagExport = 0x20

• SolutionFlagInstall = 0x40

• SolutionFlagAll =

  (SolutionFlagView|SolutionFlagEdit|SolutionFlagTranslate|SolutionFlagCreate|SolutionFlagDelete|SolutionFlagExport|SolutionFlagInstall)

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.

Ejemplos

Pedir al usuario que indique un nombre de grupo de usuarios y devolver si existe o no

importApi("AdminApi");

var grupo =  new VUserGroup();

var nombreGrupo = prompt("Escribe el nombre del grupo a comprobar");

var resultado = theServerAdmin.getUserGroupByName(nombreGrupo, grupo);

if (resultado == false) {
	alert("El grupo " + nombreGrupo + " no existe. Código de error: " + theServerAdmin.getLastErrorCode());
}
else {
	alert("El grupo " + nombreGrupo + " existe");
}javajava