Versión: 20 R7 BETA

Session

Session objects are returned by the Session command. Estos objetos ofrecen al desarrollador una interfaz que permite gestionar la sesión de usuario actual y ejecutar acciones como almacenar datos contextuales, compartir información entre procesos de sesión, lanzar procesos preferentes relacionados con la sesión o (sólo web) gestionar privilegios.

Tipos de sesiones

Esta clase admite tres tipos de sesiones:

Sesiones usuario web: las sesiones usuario web están disponibles cuando las sesiones escalables están activas en su proyecto. Se utilizan para conexiones Web y REST, y se les pueden asignar privilegios.
Sesiones usuario cliente remoto**: en las aplicaciones cliente/servidor, los usuarios remotos tienen sus propias sesiones gestionadas en el servidor.
Sesión de procedimientos almacenados: todos los procedimientos almacenados ejecutados en el servidor comparten la misma sesión usuario virtual.

nota

La disponibilidad de las propiedades y funciones del objeto Session depende del tipo de sesión.

Resumen


.clearPrivileges() : Boolean elimina todos los privilegios asociados a la sesión y devuelve True si la ejecución se ha realizado correctamente
.expirationDate : Text la fecha y hora de expiración de la cookie de sesión
.getPrivileges() : Collection devuelve una colección de todos los nombres de privilegios asociados a la sesión
.hasPrivilege( privilege : Text ) : Boolean devuelve True si privilege está asociado a la sesión, y False en caso contrario
.id : Text el identificador único (UUID) de la sesión en el servidor
.idleTimeout : Integer el tiempo de inactividad de la sesión (en minutos), después del cual la sesión es cerrada automáticamente por 4D
.info : Object describe la sesión del cliente remoto o del procedimiento almacenado en el servidor
.isGuest() : Boolean devuelve True si la sesión es una sesión Guest (es decir, no tiene privilegios)
.setPrivileges( privilege : Text ) : Boolean .setPrivileges( privileges : Collection ) .setPrivileges( settings : Object ) : Boolean asocia a la sesión los privilegios y/o roles definidos en el parámetro y devuelve True si la ejecución se ha realizado correctamente
.storage : Object un objeto compartido que puede utilizarse para almacenar información disponible para todos los procesos de la sesión
.userName : Text el nombre de usuario asociado a la sesión

.clearPrivileges()

Historia

Lanzamiento	Modificaciones
18 R6	Añadidos

.clearPrivileges() : Boolean

Parámetros	Tipo		Descripción
Result	Boolean	<-	True si la ejecución se ha realizado correctamente

Descripción

nota

This function does nothing and always returns True with remote client and stored procedure sessions.

La función .clearPrivileges() elimina todos los privilegios asociados a la sesión y devuelve True si la ejecución se ha realizado correctamente. Como resultado, la sesión se convierte automáticamente en una sesión de invitado.

Ejemplo

//Invalidar una sesión usuario web
var $isGuest : Boolean
var $isOK : Boolean

$isOK:=Session.clearPrivileges()
$isGuest:=Session.isGuest() //$isGuest es True

.expirationDate

Historia

Lanzamiento	Modificaciones
18 R6	Añadidos

.expirationDate : Text

Descripción

nota

Esta propiedad sólo está disponible con sesiones de usuario web.

La propiedad .expirationDate contiene la fecha y hora de expiración de la cookie de sesión. El valor se expresa como texto en el formato ISO 8601: YYYY-MM-DDTHH:MM:SS.mmmZ.

Esta propiedad es de solo lectura. Se recalcula automáticamente si se modifica el valor de la propiedad .idleTimeout.

Ejemplo

var $expiration : Text
$expiration:=Session.expirationDate //eg "2021-11-05T17:10:42Z"

.getPrivileges()

Historia

Lanzamiento	Modificaciones
20 R6	Añadidos

.getPrivileges() : Collection

Parámetros	Tipo		Descripción
Result	Collection	<-	Colección de nombres de privilegios (cadenas)

Descripción

La función .getPrivileges() devuelve una colección de todos los nombres de privilegios asociados a la sesión.

Con sesiones de cliente remoto y procedimiento almacenado, esta función devuelve una colección que sólo contiene "WebAdmin".

info

Los privilegios se asignan a una Sesión utilizando la función setPrivileges().

Ejemplo

Se ha definido el siguiente archivo roles.json:

{
   "privileges":[
      {
         "privilege":"simple",
         "includes":[

         ]
      },
      {
         "privilege":"medium",
         "includes":[
            "simple"
         ]
      }
   ],
   "roles":[
      {
         "role":"Medium",
         "privileges":[
            "medium"
         ]
      }
   ],
   "permissions":{
      "allowed":[

      ]
   }
}

El rol de sesión se asigna en una función datastore authentify():

  //Clase Datastore

exposed Function authentify($role : Text) : Text
	Session.clearPrivileges()
	Session.setPrivileges({roles: $role})

Asumiendo que la función authentify() es llamada con el rol "Medium":

var $privileges : Collection
$privileges := Session.getPrivileges()
//$privileges: ["simple","medium"]

Ver también

.setPrivileges()
Permisos - Inspeccionar los privilegios en la sesión para una fácil depuración (entrada de blog)

.hasPrivilege()

Historia

Lanzamiento	Modificaciones
18 R6	Añadidos

.hasPrivilege( privilege : Text ) : Boolean

Parámetros	Tipo		Descripción
privilege	Text	->	Nombre del privilegio a verificar
Result	Boolean	<-	True si la sesión tiene privilege, False en caso contrario

Descripción

La función .hasPrivilege() devuelve True si privilege está asociado a la sesión, y False en caso contrario.

Con sesiones de cliente remoto y de procedimientos almacenados, esta función siempre devuelve True, sea cual sea el privilege.

Ejemplo

Quiere comprobar si el privilegio "WebAdmin" está asociado a la sesión usuario web:

If (Session.hasPrivilege("WebAdmin"))
	//Acceso concedido, no hacer nada
Else
	//Mostrar una página de autenticación

End if

.id

Historia

Lanzamiento	Modificaciones
20 R5	Añadidos

.id : Text

Descripción

La propiedad .id contiene el identificador único (UUID) de la sesión en el servidor. Esta cadena única es asignada automáticamente por el servidor para cada sesión y permite identificar sus procesos.

tip

You can use this property to get the .storage object of a session thanks to the Session storage command.

.idleTimeout

Historia

Lanzamiento	Modificaciones

|18 R6|Añadido|

.idleTimeout : Integer

Descripción

nota

Esta propiedad sólo está disponible con sesiones de usuario web.

La propiedad .idleTimeout contiene el tiempo de inactividad de la sesión (en minutos), después del cual la sesión es cerrada automáticamente por 4D.

Si no se define esta propiedad, el valor por defecto es 60 (1h).

Cuando se define esta propiedad, la propiedad expirationDate se actualiza en consecuencia.

El valor no puede ser inferior a 60: si se define un valor inferior, el tiempo de espera se eleva hasta 60.

Esta propiedad está en lectura escritura.

Ejemplo

If (Session.isGuest())
		// Una sesión de invitado se cerrará tras 60 minutos de inactividad
	Session.idleTimeout:=60
Else
		// Otras sesiones se cerrarán tras 120 minutos de inactividad
	Session.idleTimeout:=120
End if

.info

Historia

Lanzamiento	Modificaciones
20 R5	Añadidos

.info : Object

Descripción

nota

Esta propiedad sólo está disponible con sesiones de cliente remoto y procedimientos almacenados.

La propiedad .info describe la sesión del cliente remoto o del procedimiento almacenado en el servidor.

The .info object is the same object as the one returned by the Process activity command for remote client and stored procedure sessions.

El objeto .info contiene las siguientes propiedades:

Propiedad	Tipo	Descripción
type	Text	Tipo de sesión: "remote" o "storedProcedure"
userName	Text	Nombre de usuario 4D (mismo valor que `.userName`)
machineName	Text	Sesiones remotas: nombre de la máquina remota. Sesión de procedimientos almacenados: nombre del equipo servidor
systemUserName	Text	Sesiones remotas: nombre de la sesión del sistema abierta en la máquina remota.
IPAddress	Text	Dirección IP de la máquina remota
hostType	Text	Tipo de host: "windows" o "mac"
creationDateTime	Date ISO 8601	Fecha y hora de creación de la sesión
state	Text	Estado de la sesión: "active", "postponed", "sleeping"
ID	Text	UUID de sesión (el mismo valor que `.id`)
persistentID	Text	Remote sessions: Session's persistent ID

nota

Dado que .info es una propiedad calculada, se recomienda llamarla una vez y luego almacenarla en una variable local si se desea realizar algún procesamiento sobre sus propiedades.

.isGuest()

Historia

Lanzamiento	Modificaciones
18 R6	Añadidos

.isGuest() : Boolean

Parámetros	Tipo		Descripción
Result	Boolean	<-	True si la sesión es una sesión Guest, False en caso contrario

Descripción

nota

Esta función siempre devuelve False con sesiones de cliente remoto y procedimientos almacenados.

La función .isGuest() devuelve True si la sesión es una sesión Guest (es decir, no tiene privilegios).

Ejemplo

En el método base On Web Connection:

If (Session.isGuest())
	//Hacer algo para el usuario invitado
End if

.setPrivileges()

Historia

Lanzamiento	Modificaciones
19 R8	Compatibilidad con la propiedad "roles" en Settings
18 R6	Añadidos

.setPrivileges( privilege : Text ) : Boolean
.setPrivileges( privileges : Collection )
.setPrivileges( settings : Object ) : Boolean

Parámetros	Tipo		Descripción
privilege	Text	->	Nombre del privilegio
privileges	Collection	->	Colección de nombres de privilegios
settings	Object	->	Objeto con una propiedad "privilegios" (cadena o colección)
Result	Boolean	<-	True si la ejecución se ha realizado correctamente

Descripción

nota

Esta función no hace nada y siempre devuelve False con las sesiones de clientes remotos y de los procedimientos almacenados.

La función .setPrivileges() asocia a la sesión los privilegios y/o roles definidos en el parámetro y devuelve True si la ejecución se ha realizado correctamente.

En el parámetro privilege, pase una cadena que contenga un nombre de privilegio (o varios nombres de privilegio separados por comas).
En el parámetro privileges, pase una colección de cadenas que contengan nombres de privilegios.
En el parámetro settings, pase un objeto que contenga las siguientes propiedades:

Propiedad	Tipo	Descripción
privileges	Text o Collection	Cadena que contiene un nombre de privilegio, o Colección de cadenas que contienen nombres de privilegios
roles	Text o Collection	Cadena que contiene un rol, o Colección de cadenas que contienen roles
userName	Text	Nombre de usuario para asociar a la sesión (opcional)

nota

Los privilegios y los roles se definen en el archivo roles.json del proyecto. Para más información, consulte la sección Privilegios.

Si la propiedad privileges o roles contiene un nombre que no está declarado en el archivo roles.json, se ignora.

Por defecto, cuando no hay ningún privilegio o rol asociado a la sesión, la sesión es una sesión de invitado.

La propiedad userName está disponible a nivel de objeto de sesión (sólo lectura).

Ejemplo

En un método de autenticación personalizado, se establece el privilegio "WebAdmin" para el usuario:

var $userOK : Boolean

... //Autenticar al usuario

If ($userOK) //El usuario ha sido aprobado
  var $info : Object
  $info:=New object()
  $info.privileges:=New collection("WebAdmin")
  Session.setPrivileges($info)
End if

Ver también

.getPrivileges()

.storage

Historia

Lanzamiento	Modificaciones
20 R5	Soporte de cliente remoto y sesiones de procedimientos almacenados
18 R6	Añadidos

.storage : Object

Descripción

La propiedad .storage contiene un objeto compartido que puede utilizarse para almacenar información disponible para todos los procesos de la sesión.

Cuando se crea un objeto Session, la propiedad .storage está vacía. Al ser un objeto compartido, esta propiedad estará disponible en el objeto Storage del servidor.

Al igual que el objeto Storage del servidor, la propiedad .storage es siempre "single": añadir un objeto compartido o una colección compartida a .storage no crea un grupo compartido.

Esta propiedad es sólo lectura en sí misma pero devuelve un objeto de lectura-escritura.

tip

You can get the .storage property of a session using the Session storage command.

Ejemplo de sesión web

Desea almacenar la IP del cliente en la propiedad .storage. Puede escribir en el método base On Web Authentication:

If (Session.storage.clientIP=Null) //first access
    Use (Session.storage)
        Session.storage.clientIP:=New shared object("value"; $clientIP)
    End use
End if

Ejemplo de sesión remota

Desea compartir datos entre procesos de la misma sesión:

Use (Session.storage)
 Session.storage.settings:=New shared object("property"; $value; "property2"; $value2)
End use

.userName

Historia

Lanzamiento	Modificaciones
20 R5	Soporte de cliente remoto y sesiones de procedimientos almacenados
18 R6	Añadidos

.userName : Text

Descripción

La propiedad .userName contiene el nombre de usuario asociado a la sesión. Puede utilizarlo para identificar al usuario dentro de su código.

Con las sesiones web, esta propiedad es una cadena vacía por defecto. Puede definirse mediante la propiedad privileges de la función setPrivileges().
With remote and stored procedure sessions, this property returns the same user name as the Current user command.

Esta propiedad es solo lectura.

Tipos de sesiones​

Resumen​

.clearPrivileges()​

Descripción​

Ejemplo​

.expirationDate​

Descripción​

Ejemplo​

.getPrivileges()​

Descripción​

Ejemplo​

Ver también​

.hasPrivilege()​

Descripción​

Ejemplo​

.id​

Descripción​

.idleTimeout​

Descripción​

Ejemplo​

.info​

Descripción​

.isGuest()​

Descripción​

Ejemplo​

.setPrivileges()​

Descripción​

Ejemplo​

Ver también​

.storage​

Descripción​

Ejemplo de sesión web​

Ejemplo de sesión remota​

.userName​

Descripción​

Tipos de sesiones

Resumen

.clearPrivileges()

Descripción

Ejemplo

.expirationDate

Descripción

Ejemplo

.getPrivileges()

Descripción

Ejemplo

Ver también

.hasPrivilege()

Descripción

Ejemplo

.id

Descripción

.idleTimeout

Descripción

Ejemplo

.info

Descripción

.isGuest()

Descripción

Ejemplo

.setPrivileges()

Descripción

Ejemplo

Ver también

.storage

Descripción

Ejemplo de sesión web

Ejemplo de sesión remota

.userName

Descripción