INTEGRACIN DE APLICACIONES CON GXPORTAL 4.5.0.

0
GXportal proporciona un conjunto de herramientas para la integracin de aplicaciones al portal, las mismas pueden estar desarrolladas en cualquier tecnologa web. Tambin proporciona la posibilidad de realizar Single Sign On, esto significa que GXportal autentique a los usuarios del portal contra un repositorio externo, por ejemplo, un sistema legado, LDAP, Active Directory, etc., evitando as que sea necesario duplicar la informacin de los usuarios. Desde la versin 4.3 de GXportal se cuenta con un nuevo marco integrador de aplicaciones GeneXus, permitiendo esto separar el diseo esttico y de navegacin del portal respecto de la aplicacin (mens dinmicos con permisos), permitiendo esto mayor concentracin en el desarrollo su aplicacin, generando as aplicaciones ms flexibles y de mejor calidad. Este marco permite definir y configurar desde GXportal el rbol de mens de una aplicacin, con sus respectivos nombres de programas que debe ejecutar cada opcin, definicin de permisos de acceso a cada programa y todo lo necesario para definir una aplicacin. El presente documento pretende guiar como integrar una aplicacin web GeneXus a un portal realizado con GXportal.

Tabla de contenido
GENERAR UNA APLICACIN WEB INTEGRABLE A GXPORTAL ..................................................................................... 3 GeneXus 9.0 ............................................................................................................................................ 3 GeneXus X ............................................................................................................................................... 5 APIS ......................................................................................................................................................... 7
Consideraciones ................................................................................................................................................... 8 GXPCheckSecurity .............................................................................................................................................. 11 GXPValidSession ................................................................................................................................................ 13 GXPListActiveSessions ....................................................................................................................................... 13 GXPKillSession .................................................................................................................................................... 14 GXPAPIUser........................................................................................................................................................ 15 GXPAPIUserMemberRole ................................................................................................................................... 19 GXPUserRecoveryPassword ............................................................................................................................... 19 GXPListUsers ...................................................................................................................................................... 20 GXPListUserRoles ............................................................................................................................................... 22 GXPListRoles ...................................................................................................................................................... 23 GXPSetSharedData ............................................................................................................................................ 23 GXPGetSharedData ............................................................................................................................................ 24 GXPGetCatalogedPageURL ................................................................................................................................ 24 GXPGenerateAuditoryProductActivity ............................................................................................................... 25 GXPListAuditoryActivities .................................................................................................................................. 25

PASOS PARA INTEGRAR LA APLICACIN ............................................................................................................... 27 Definir el marco de la aplicacin en GXportal ...................................................................................... 27 Definir la aplicacin en GXportal .......................................................................................................... 29
Crear una aplicacin .......................................................................................................................................... 31 Configurar los ambientes de ejecucin.............................................................................................................. 34 Definir los mens ............................................................................................................................................... 35 Opciones de men ............................................................................................................................................. 36 Operaciones ....................................................................................................................................................... 40 Servicios ............................................................................................................................................................. 42 Actividades ........................................................................................................................................................ 45

Definir la seguridad de la aplicacin ..................................................................................................... 50

Administrar permisos de roles ........................................................................................................................... 51 Administrar permisos de aplicaciones ............................................................................................................... 53 Administrar permisos de mens de una aplicacin ........................................................................................... 53 Administrar permisos de actividades de una aplicacin .................................................................................... 54

OTROS TIPS .................................................................................................................................................. 55 Links a pginas del portal ..................................................................................................................... 55 Pasaje de parmetros a la aplicacin externa desde GXportal ............................................................ 56 Invocacin de pginas desde logout de GXportal ................................................................................. 57 Manejo de la navegacin desde la aplicacin externa ......................................................................... 58 Inicio de sesin en GXportal desde una aplicacin externa .................................................................. 58

Generar una aplicacin Web integrable a GXportal

La aplicacin a integrar debe poder ser ejecutada en un navegador (aplicacin web), la plataforma de la aplicacin puede ser diferente a la que est instalada GXportal. Por ejemplo puede usar GXportal en .Net e integrar una aplicacin en Java. GXportal provee objetos para integrar fcilmente la aplicacin y ejemplos de cmo usar los procedimientos provistos. Tambin se proveen APIs y Data Views para acceder a la base de datos de GXportal. Los siguientes pasos detallan el procedimiento para incorporar las APIs provistas por GXportal a una Base de Conocimiento GeneXus 9 y GeneXus X.

GeneXus 9.0
Lo primero que se debe realizar, es definir en su KB un DataStore con el nombre GXportal. El Data View debe ser definido en modo Prototipo, desde el men File Edit Model, se desplegar una ventana como la que muestra la figura que se despliega a continuacin, en la cual se debe seleccionar la pestaa Data Stores, dando clic en el botn Add se solicitar el nombre del Data Store a generar, el mismo deber tener el nombre GXportal, luego de creado se debe configurar la informacin de conexin a la base de datos de GXportal, para ello se debe seleccionar el Data Store GXportal y dar clic en el botn Properties.

Luego de definido el Data Store se debe consolidar el xpz incluido en zip de descarga. Para descargar con los objetos de conexin a GXportal de clic aqu (3 MB). Este link descarga es un archivo comprimido con el siguiente contenido: GXPortal4500_GXPAccess_GX90.xpz: es la lista de objetos para consolidar en la KB de GeneXus 9.0 jug-lgpl-2.0.0.zip: el mismo se debe utilizar si la aplicacin a ser generada en Java, ese contiene un JAR que se debe descomprimir y copiar a una ruta accesible desde la KB, tambin en el modelo Java, en las Propiedades de Ejecucin debe ser incluido en el Classpath la ruta completa donde fue copiado dicho archivo (Ejemplo: C:\Develop\Java\jug-lgpl-2.0.0.jar). Al consolidar el xpz se generar la carpeta GXportal como lo muestra la figura siguiente.

Si est integrando una aplicacin con GXflow, vea las recomendaciones dando clic aqu.

GeneXus X Ev. 1
En esta versin de GeneXus se debe consolidar el xpz incluido en zip de descarga. Para descargar con los objetos de conexin a GXportal de clic aqu (174 KB). Este link descarga es un archivo comprimido con el siguiente contenido: GXPortal4500_GXPAccess_GX_X.xpz: es la lista de objetos para consolidar en la KB de GeneXus X. Si desea generar en DotNet, en la carpeta DotNet hay un archivo: o GXportalRepository.dll: es para conectarse a GXportal y deber ser copiado en el /bin de su aplicacin. Si desea generar en Java, en la carpeta Java hay 2 archivos: o GXportalRepository.jar: es para conectarse a GXportal y deber ser copiado en el /lib de su aplicacin (ejemplo: \webapps\appexample\WEB-INF\lib). o jug-lgpl-2.0.0.jar: se debe copiar a una ruta accesible desde la KB, configurar en el modelo Java, en Preferencias >Java Environment -> Generators -> en las Propiedades del Generador, en la propiedad Classpath incluir la ruta completa donde fue copiado dicho archivo (Ejemplo: C:\Develop\Java\jug-lgpl-2.0.0.jar). Luego de consolidar el xpz deber configurar el DataStore GXportal, como lo muestra la figura siguiente:

Al consolidar se generar la carpeta GXportal como lo muestra la figura siguiente. Estos objetos no deben ser modificados pro el cliente, el modificar un objeto puede causar que la integracin con GXportal deje de funcionar.

APIS
GXportal provee un conjunto de APIs (Procedimientos) que le permitirn acceder a la base de datos de GXportal desde su aplicacin. La siguiente tabla detalla la lista de procedimientos provistos y describe su funcionalidad de cada uno de ellos: Procedimiento GXPCheckSecurity Descripcin Chequear la seguridad para acceder a un objeto de su aplicacin, verifica que el usuario autenticado tenga permisos de acceso al mismo. Validar el estado de la sesin actual, verifica que exista una sesin vlida para poder ejecutar un programa. Retorna la lista las sesiones activas en el portal. Permite matar una sesin activa de un usuario, da por finalizada la misma, dando por finalizada su autenticacin. Permite administrar la informacin de los usuarios del portal desde la aplicacin integrada, permitiendo agregar nuevos usuarios, actualizar datos y eliminar los mismos. Asignar y quita Roles a un usuario especfico. Recuperar la contrasea de un usuario, generndole una nueva contrasea en forma randmica. Retorna la lista de usuarios del portal. Retorna la lista de roles de un usuario. Retorna la lista de roles del portal. Grabar informacin a ser compartida entre las aplicaciones integradas al portal, la misma es por sesin de usuario y caduca al finalizar la sesin. Permite obtener la informacin compartida almacenada de la sesin activa. Retorna la URL de un link catalogado indicado por parmetro.

GXPValidSession

GXPListActiveSessions GXPKillSession

GXPAPIUser

GXPAPIUserMemberRole GXPUserRecoveryPassword

GXPListUsers GXPListUserRoles GXPListRoles GXPSetSharedData

GXPGetSharedData

GXPGetCatalogedPageUrl GXPGenerateAuditoryProductActivity

GXPListAuditoryActivities

CONSIDERACIONES
La mayora de las APIs de GXportal validan que exista una sesin vlida para ser ejecutada, por lo tanto el API GXPValidSession se ejecuta automticamente antes de ejecutarse cualquier accin sobre la base de datos. Las APIs que no utilizan dicha validacin estn documentadas explcitamente. El API GXPValidSession segn su parmetro GenerateAcytivityLog genera un log de auditora ejecutando GXPGenerateAuditoryProductActivity, pero de ser necesario se puede utilizar el API GXPGenerateAuditoryProductActivity en forma independiente para generar un log en particular.

Para ver ejemplos de utilizacin de estas APIs se provee un archivo comprimido con un xpz mostrando el uso de alguno de los procedimientos detallados anteriormente, para obtener los ejemplos para GeneXus 9.0 dar clic aqu, para obtener los ejemplos para GeneXus X dar clic aqu. Junto con los ejemplos se provee un Export de una Aplicacin integrada a GXportal Todos los procedimientos consolidados reciben el parmetro &GXPConnInf y retornan el parmetro &GXPStatus. El parmetro &GXPConnInf es un parmetro de entrada/salida, en el mismo se deber especificar como conecta la aplicacin con GXportal y que mtodo utiliza para identificar la sesin, tambin el mismo retorna informacin de la sesin del usuario y de GXportal. ste parmetro es una variable de tipo SDT con la siguiente estructura:

Authentication

Type

Es el tipo de verificacin de la autenticacin. El mismo puede ser: GXPAuthenticationType.UserKey: Clave de seguridad que provee GXportal, dependiente de la sesin del usuario. GXPAuthenticationType.Cookie: Clave de seguridad se lee desde una cookie, para esto GXportal y la aplicacin deben estar bajo el mismo dominio y mismo puerto. GXPAuthenticationType.ExternalLo gin: No implementado en esta versin.

UserKey ExternalLogin DBConnection

Key

Clave de seguridad brindada por GXportal. No implementado en esta versin.

Type

Es el tipo de conexin a GXportal, por el momento el nico tipo implementado es GXPDBConnectionType.LAN, configurado a travs del

DataStore. UserKey ExternaKey GXportalData LanguageId Datos de GXportal Retorna la clave de seguridad el usuario autenticado. Retorna la clave de seguridad externa. Idioma del portal.

PortalId ChannelId PageId SectorId Status RepositoryData Id AuthenticationType UserIdentification ActivationAutomatic

Identificador del portal. Identificador del canal. Identificador de pgina. Identificador del sector de la aplicacin externa . Estado de la pgina visualizada Datos del Identificador del Repositorio del repositorio Portal. Identificador de la sesin. Indica si es identificador de usuario es el Nick name o el Email Indica si al crearse un usuario el mismo queda activado en el portal o requiere de una activacin del usuario (dominio GAMRepUsrAutAct). Tiempo mximo aceptable para Activar una cuenta de usuario definida previamente. Nmero mximo de reintentos de autenticacin para no bloquear el login. Identificador de la poltica de seguridad. Indica si el repositorio genera auditora (Dominio GAMRepAud). Clave de encriptacin de datos. Datos de la sesin leda Fecha de la sesin.

ActivationTimeOut

UserLoginAttempts

SecurityPolicyId GenerateAuditory Key SessionData Date

Id InitialURL IPAddress

Identificador de la sesin URL desde donde se inici la sesin del usuario. Direccin IP desde donde inici la sesin del usuario.

BrowserId OperationSystemId

Identificador del Browser desde donde inici la sesin del usuario. Identificador del Sistema Operativo desde donde inici la sesin del usuario. Fecha y hora de inicio de sesin. Identificador del usuario autenticado. Datos compartidos en la sesin del usuario. Tiempo de expiracin de la sesin de usuario. Booleano que indica si la sesin de usuario annimo. Fecha y hora del ltimo acceso a una pgina de GXportal. Flag (Dominio GXpBoolean) indicando si se desea grabar el LOG de la actividad a ejecutar.

LoginDate UserId SharedData TimeOut AnonymouseUser LastAccess GenerateActivityLog

El parmetro &GXPStatus es un parmetro de salida, en el mismo retorna informacin sobre la utilizacin del procedimiento. Este parmetro es una variable de tipo SDT con la siguiente estructura:

Mdulo Id

Message

Identificador del mdulo donde fue generado el error. Identificador del error, si el procedimiento retorna nulo, la ejecucin de fue exitosa. Descripcin del mensaje del error.

GXPCHECKSECURITY
Este procedimiento debe ser utilizado para verificar la seguridad de acceso a un objeto de su aplicacin.

Los parmetros que utiliza son: Parmetros: ( inout:&GXPChkSec, inout:&GXPConnInf, out:&GXPStatus ) &GXPConnInf y &GXPStatus fueron explicados en la parte superior de este documento, para acceder al mismo de clic aqu. &GXPChkSec es un parmetro de entrada/salida, en el mismo se debe enviar el nombre de las actividades a verificar su acceso y retorna si se tiene acceso o no, cdigo de error, datos del usuario. Este parmetro es una variable de tipo SDT con la siguiente estructura:

Name

Nombre de la actividad a validar, el mismo puede ser nulo si en la aplicacin tiene configurado que el nombre del programa es nico por actividad. Nombre del programa, el mismo solo puede ser utilizado cuando la aplicacin tiene configurado que el nombre del programa es nico por actividad. Retorna GAMBoolean.True si la sesin actual tiene acceso a la actividad, si retorna GAMBoolean.False se puede ver el error en Status. Status.Id contiene el Identificador del error, Status.Module contiene el mdulo de GXportal al cual pertenece ese error y en Status.Message se retorna una descripcin del error en el idioma del portal. No implementado.

ProgramName

Access

Status

Controls

Ver ejemplo de uso en el objeto de ejemplo: HTestCheckSecurity.

GXPVALIDSESSION
Este procedimiento debe ser utilizado para verificar que la sesin del usuario activo sea vlida y est vigente. Los parmetros que utiliza son: ( inout:&GXPConnInf, out:&GXPStatus ) &GXPConnInf y &GXPStatus fueron explicados en la parte superior de este documento, para acceder al mismo de clic aqu. Todos los procedimientos provistos por GXportal ya utilizan a ste, as que en su programa si utiliza por ejemplo el GXPCheckSecurity no es necesario adicionarle ste.

GXPLISTACTIVESESSIONS
Este procedimiento permite obtener una lista de sesiones activas para un portal. Los parmetros que utiliza son: (out:&GXPListActiveSessions, inout:&GXPConnInf, out:&GXPStatus) &GXPConnInf y &GXPStatus fueron explicados en la parte superior de este documento, para acceder al mismo de clic aqu.

&GXPListActiveSessions es un parmetro de salida, en el mismo se recibe informacin de la lista de sesiones activas del portal. Este parmetro es una variable de tipo SDT con la siguiente estructura: Date Id Status InitialURL IPAddress BrowserId Fecha y hora en la cual se gener la sesin. Identificador de la sesin, el mismo es dependiente del valor de Date anterior. Estado de la sesin, el mismo puede ser nicamente GAMUsrSesSts.Active = Sesin Activa URL desde donde fue solicitado el inicio de sesin. Direccin IP desde donde fue solicitado el inicio de sesin. Identificador del navegador desde donde fue solicitado el inicio de sesin, donde: 0 = Cliente desconocido 1 = Internet Explorer 2 = Netscape 3 = Opera OperatingSystemId LoginDate LastAccess LoginAttempts User Sistema operativo desde donde fue solicitado el inicio de sesin. (No implementado). Fecha y hora que un usuario se autentic con esta sesin Fecha y hora del ltimo acceso del usuario al portal (ltimo clic). Intento de autenticaciones del usuario, antes de que el mimo sea exitoso. Se retorna informacin del usuario de la sesin.

Ver ejemplo de uso en el objeto de ejemplo: HTestListActiveSessions.

GXPKILLSESSION
Este procedimiento permite matar una sesin activa de un usuario, da por finalizada la misma, dando por finalizada su autenticacin. Los parmetros que utiliza son: (&GAMUsrSesDate, &GAMUsrSesId, inout:&GXPConnInf, out:&GXPStatus ) &GXPConnInf y &GXPStatus fueron explicados en la parte superior de este documento, para acceder al mismo de clic aqu. &GAMUsrSesDate es la fecha-hora de la sesin que se desea dar por finalizada. &GAMUsrSesId es el Identificador de la sesin que se desea dar por finalizada.

Ambos valores deben ser obtenidos utilizando el procedimiento GXPListActiveSessions.

GXPAPIUSER
Este procedimiento permite administrar la informacin de los usuarios del portal, tanto agregar un nuevo usuario, obtener informacin de un usuario, actualizar sus datos o bien eliminarlo. Los parmetros que utiliza son: (inout:&GXPUser, inout:&GAMApiParm, inout:&GXPConnInf, out:&GXPStatus ) &GXPConnInf y &GXPStatus fueron explicados en la parte superior de este documento, para acceder al mismo de clic aqu. &GXPUser es un parmetro de entrada/salida, el mismo mantiene la informacin del usuario con el cual se desea trabajar. Este parmetro es una variable de tipo SDT con la siguiente estructura:

Id Delete

Identificador de usuario. Booleano que indica GAMBoolean.True que el usuario est eliminado o GAMBoolean.False indica que no est eliminado. Nombre para autenticar un usuario (posible login). Correo electrnico del usuario (posible login). String por el cual se est autenticando el usuario (Name o Email).

Name EMail Login

FirstName LastName Gender

Nombres del usuario. Apellidos del usuario. Sexo, el mismo puede ser: GAMUsrGen.Not_Specified = No especificado GAMUsrGen.Female = Femenino GAMUsrGen.Male = Masculino

BirthDate CountryId NotReciveInformation

Fecha de nacimiento Identificador del Pas donde reside Booleano que indica si GAMBoolean.True que el usuario no desea recibir informacin adicional, no recibir correos electrnicos desde la lista de noticias. Contrasea del usuario. Confirmacin de la contrasea del usuario. Fecha en la cual el usuario realiz el ltimo cambio de contrasea. Booleano que indica si el usuario est o no activo para autenticarse en el portal, los valores posibles son: GAMUsrAct.YES y GAMUsrAct.NO. Clave que permitir al usuario activar su cuenta desde la pgina con el portlet de activacin de cuentas de usuario. Booleano GAMUsrChgPwdNexLog.CHG_PWD_NL = Cambiar la contrasea en su prxima autenticacin. GAMUsrChgPwdNexLog.NOT_CHG_PWD_NL = No cambiar la contrasea en su prxima autenticacin.

Password PasswordConf DateLastChgPwd Active

ActiveKey

ChgPwdNexLog

NotChgPwd

Booleano que indica que el usuario puede o no cambiar la contrasea, los valores pueden ser: GAMUsrNotChgPwd.CHANGE_PWD = Que tiene permitido el cambio. GAMUsrNotChgPwd.NOT_CHANGE_PWD = Que no tiene permitido el cambio.

PwdNevExp

Booleano que indica que al usuario nunca se le expira la contrasea, el mismo puede ser: GAMUsrPwdNevExp.NEVER_EXPIRE = Nunca expira su contrasea. GAMUsrPwdNevExp.EXPIRE = La contrasea expira segn la poltica de seguridad correspondiente.

Disable

Booleano que indica que al usuario est bloqueado para autenticarse, se puede bloquear desde el backend o por reintentos de autenticacin fallidos. Puede tener los siguientes valores: GAMUsrDis.TRUE = Verdadero GAMUsrDis.FALSE = Falso

PortalLanguageId SecurityPolicyId

Idioma en el cual el usuario visualizar el portal en forma predeterminada al autenticase. Identificador de poltica de seguridad del usuario, si no tiene una poltica asignada seguir las preferencias del rol principal o del repositorio. Identificador externo del usuario, utilizado por el SSO o para cuando una aplicacin necesita contar con ms informacin en su base de datos. Fecha y hora de creacin del usuario. Fecha y hora de ltima modificacin del usuario. Atributos dinmicos de los usuarios, el mismo es una coleccin con los siguiente valores: Id = Identificador del atributo Encripted = Indica si el valor del atributo se almacena encriptado en la base de datos. IsMV = Booleano que indica si el mismo es Multi Valuado (debe ser GAMBoolean.False, ya que GAMBoolean.True no esta implementado. Value = Valor del atributo

ExternalId

CreDate ModDate AttDin

&GAMApiParm es un parmetro de entrada/salida, en el mismo informa a al procedimiento que funcin se desea cumplir y se retorna el estado del proceso realizado. Este parmetro es una variable de tipo SDT con la siguiente estructura:

Mode

SubMode

Modo en el cual indica al procedimiento su comportamiento, el mismo puede ser: &GXPApiParm.Mode = GAMMode.INI = Inicializar datos. &GXPApiParm.Mode = GAMMode.INS = Insertar usuario. &GXPApiParm.Mode = GAMMode.UPD = Actualizar usuario. &GXPApiParm.Mode = GAMMode.DLT = Eliminar usuario. &GXPApiParm.Mode = GAMMode.DSP = Obtener datos de un usuario. Parmetro que permite personalizar el comportamiento del procedimiento, el mismo puede ser: Nulo = No realiza ninguna funcin en particular

Commit ForceDlt LoadProperties

NOTPWD = No valida ni actualiza la contrasea del usuario Booleano que indica al procedimiento que realice commit al finalizar, para ello debe tener el valor GAMBoolean.True. No utilizado. No utilizado.

Para crear un nuevo usuario se deben inicializar todos los datos del SDT, el procedimiento debe ser llamado en Modo Insert. Para actualizar algn dato del usuario, primero se deben obtener la informacin del mismo, actualizar el valor deseado en el SDT y recin luego se debe llamar al API en Modo Update. Pata Obtener informacin del usuario, se debe llamar al API en Modo Display, para este caso el SDT del usuario debe tener uno de estos identificadores: Id, Name, Email o Login. No se retorna informacin de los usuarios eliminados. Para eliminar un usuario el API debe ser llamada solo en modo Delete y el SDT del usuario debe tener Id.

GXPAPIUSERMEMBERROLE
Permite asignar y quitar Roles a un usuario especfico. Los parmetros que utiliza son: (inout:&GAMUsrMemRol, inout:&GAMApiParm, inout:&GXPConnInf, out:&GXPStatus ) &GXPConnInf y &GXPStatus fueron explicados en la parte superior de este documento, para acceder al mismo de clic aqu. &GAMUsrMemRol es un parmetro de entrada/salida, el mismo mantiene la informacin del rol del usuario. Este parmetro es una variable de tipo SDT con la siguiente estructura:

GXPUSERRECOVERYPASSWORD
Permite recuperar la contrasea de un usuario.

Los parmetros que utiliza son: (inout:&GXPUserRecPwd, inout:&GXPConnInf, out:&GXPStatus ) &GXPConnInf y &GXPStatus fueron explicados en la parte superior de este documento, para acceder al mismo de clic aqu. & GXPUserRecPwd es un parmetro de entrada/salida, permite recuperar la contrasea del usuario. Este parmetro es una variable de tipo SDT con la siguiente estructura:

Type

Login Password Key

Tipo de recuperacin a realizar (Dominio GXPUserRecoveryPasswordType) por el momento el tipo de recuperacin implementada es NewRandomPassword. Login identificador del usuario. Retorna la nueva contrasea asignada al usuario. No implementado en esta versin.

Ver ejemplo de uso en el objeto de ejemplo: HTestRecoveryPassword.

GXPLISTUSERS
Este procedimiento permite obtener la lista de usuarios del portal. Los parmetros que utiliza son: (in:&GAMLstPar, in:&GAMLstUsrPar, out:&GAMLstUsr, inout:&GXPConnInf, out:&GXPStatus ) &GXPConnInf y &GXPStatus fueron explicados en la parte superior de este documento, para acceder al mismo de clic aqu. &GAMLstPar permite enviar filtros estndares a todos los procedimiento de tipo lista de, de forma que el mismo retorne la lista de elementos cumpliendo esas condiciones. Este parmetro es una variable de tipo SDT con la siguiente estructura:

&GAMLstUsrPar permite enviar filtros al procedimiento para la lista de usuarios que retorne cumpla con esas condiciones. Este parmetro es una variable de tipo SDT con la siguiente estructura:

&GAMLstUsr retorna la lista de usuarios resultantes, segn los parmetros recibidos. Este parmetro es una variable de tipo SDT con la siguiente estructura: (GAMUserSDT est descripto en el procedimiento GXPAPIUser.

Ver ejemplo de uso en el objeto de ejemplo: HTestWWUsers.

GXPLISTUSERROLES
Este procedimiento permite obtener la lista de roles de un usuario, segn los filtros indicados en los parmetros de entrada. Los parmetros que utiliza son: (&GAMLstPar, &GAMLstUsrRolPar, out:&GAMLstRol, inout:&GXPConnInf, out:&GXPStatus ) &GXPConnInf y &GXPStatus fueron explicados en la parte superior de este documento, para acceder al mismo de clic aqu. &GAMLstUsrRolPar permite enviar filtros al procedimiento para la lista de roles de un usuario. Este parmetro es una variable de tipo SDT con la siguiente estructura:

&GAMLstRol retorna la lista de roles resultantes, segn los parmetros recibidos. Este parmetro es una variable de tipo SDT con la siguiente estructura:

GXPLISTROLES
Este procedimiento permite obtener la lista de roles del portal, segn los filtros indicados en los parmetros de entrada. Los parmetros que utiliza son: (in:&GAMLstPar, in:&GAMLstRolPar, out:&GAMLstRol, inout:&GXPConnInf, out:&GXPStatus ) &GXPConnInf y &GXPStatus fueron explicados en la parte superior de este documento, para acceder al mismo de clic aqu. &GAMLstRolPar permite enviar filtros al procedimiento para la lista de roles. Este parmetro es una variable de tipo SDT con la siguiente estructura:

&GAMLstRol retorna la lista de roles resultantes segn los parmetros recibidos. Este parmetro es una variable de tipo SDT con la siguiente estructura: (GAMLstRol est descripto en el procedimiento GXPListUserRoles.

GXPSETSHAREDDATA
Este procedimiento permite guardar informacin en la sesin del usuario, esto brinda la posibilidad de compartir informacin dentro la misma aplicacin y entre

ms de una aplicacin. Esta informacin caducar al caducar (finalizar) la sesin del usuario en GXportal. Los parmetros que utiliza son: (in:&SharedData, inout:&GXPConnInf, out:&GXPStatus) &GXPConnInf y &GXPStatus fueron explicados en la parte superior de este documento, para acceder al mismo de clic aqu. &SharedData es la informacin a almacenar, es un string de hasta 64k, para almacenar ms de un valor es recomendable almacenar un XML dependiente de la estructura de un SDT de su aplicacin.

GXPGETSHAREDDATA
Este procedimiento permite obtener la informacin almacenada en la sesin del usuario. Esta informacin ser la almacenada en la sesin de usuario activa (la actual). Los parmetros que utiliza son: (out:&SharedData, inout:&GXPConnInf, out:&GXPStatus) &GXPConnInf y &GXPStatus fueron explicados en la parte superior de este documento, para acceder al mismo de clic aqu. &SharedData es la informacin a almacenar, es un string de hasta 64k, para almacenar ms de un valor es recomendable almacenar un XML dependiente de la estructura de un SDT de su aplicacin.

GXPGETCATALOGEDPAGEURL
Este procedimiento retorna la URL de un link catalogado solicitado por parmetro. El mismo NO valida el estado de la sesin del usuario, si se requiere lo debe realizar previamente. Los parmetros que utiliza son: (in:&CatalogId, inout:&GXPConnInf, out:&URL) &GXPConnInf fue explicado en la parte superior de este documento, para acceder al mismo de clic aqu. &CatalogId es el identificador del catlogo para el cual se desea obtener la URL. &URL es la URL para acceder a la pgina catalogada en el portal. Ver ejemplo de uso en el objeto de ejemplo: HTestCataloguedURL.

GXPGENERATEAUDITORYPRODUCTACTIVITY
Este procedimiento genera automticamente un log de ejecucin de una actividad (la actualmente ejecutada). El log contiene informacin de la actividad ejecutada e informacin de la sesin de portal. El mismo NO valida el estado de la sesin del usuario, de forma que siempre se pueda generar un log. Los parmetros que utiliza son: (out: inout:&GXPConnInf, out:&GXPStatus) &GXPConnInf y &GXPStatus fueron explicados en la parte superior de este documento, para acceder al mismo de clic aqu.

GXPLISTAUDITORYACTIVITIES
Este procedimiento permite obtener la lista de auditora de actividades de aplicaciones. Los parmetros que utiliza son: (in:&GXPListPar, &GXPListAuditoryActivityPar, out:&GXPListAuditoryActivity, inout:&GXPConnInf, out:&GXPStatus) &GXPConnInf y &GXPStatus fueron explicados en la parte superior de este documento, para acceder al mismo de clic aqu. &GXPListAuditoryActivityPar permite enviar filtros al procedimiento para la lista de auditora de actividades de aplicaciones. Este parmetro es una variable de tipo SDT con la siguiente estructura: En &GXPListAuditoryActivity se recibe la lista de registros de auditora de las actividades resultantes, segn los parmetros recibidos. Este parmetro es una variable de tipo SDT con la siguiente estructura:

Id Date ProgramName URL RemoteAddress Method Referrer ProductId ActivityId SessionData

Identificador del registro de auditora. Fecha y hora de generacin del log. Nombre del programa ejecutado. URL ejecutada Direccin IP desde donde se ejecut el programa que gener el log. Mtodo de ejecucin de la actividad (POST, GET, etc.). URL llamadora de la URL que gener el registro. Identificacin del Producto al cual pertenece la actividad ejecutada. Identificacin de la actividad ejecutada. Permite disponer de la informacin de la sesin quien gener el registro de auditora.

Ver ejemplo de uso en el objeto de ejemplo: HTestListAuditoryActivities.

Pasos para integrar la aplicacin

Definir el marco de la aplicacin en GXportal
Definir el marco significa crear la o las pginas en GXportal que soporten el diseo de la aplicacin, son las pgina que actuarn como marco de la aplicacin. Para esto GXportal proporciona GXportlets que permiten navegar y presentar las aplicaciones.

La lista de GXportlets disponibles es: Lista de aplicaciones: Este portlet despliega la lista de aplicaciones que tenga acceso (permisos de al menos un objeto) el usuario autenticado en el portal. Al dar clic en una aplicacin se desplegar la pgina principal de la aplicacin, desplegando el men principal y el objeto predeterminado de la misma.

Men de una aplicacin: Este portlet despliega un men de una aplicacin, si el usuario dio clic en el men de aplicaciones, este portlet despliega el men principal de la aplicacin. Si se accede a una pgina con este portlet desde un link catalogado a un men, dicho portlet desplegar el men configurado en el catlogo. Contenedor: Este portlet se encarga de desplegar la actividad seleccionada en el men de una aplicacin, para eso el Contenedor debe tener la propiedad Identificador del contenedor = 1. Si se accede a una pgina con este p ortlet desde un link catalogado a una actividad, dicho portlet desplegar la actividad configurada en el catlogo. La ubicacin, ancho y alto que ocupar en la pantalla dicha actividad deben ser configurados en el sector. Si se desea que la altura de la aplicacin sea dinmica (que ocupe en la pgina solo por la cantidad de informacin que despliegue), se debe configurar en el Sector la Altura en nulo. Actividad de una aplicacin: Este GXportlet permite desplegar una actividad de una aplicacin, la misma debe ser seleccionada en las propiedades del portlet. La alineacin, ancho y alto que ocupar en la pantalla dicha actividad debe ser configurada en el sector. Si se desea que la altura de la aplicacin sea dinmica (que ocupe en la pgina solo por la cantidad de informacin que despliega), se debe configurar en el Sector la Altura en nulo y seleccionar en el portlet la propiedad Altura dinmica.

Un ejemplo de marco de una aplicacin en modo diseo:

A continuacin se muestra en ejecucin la pgina y la aplicacin en vista previa, desplegando al pie de la columna izquierda la Lista de aplicaciones que el usuario tiene acceso, sobre dicha lista el men de la aplicacin seleccionada, con un submen desplegado y en la columna derecha la actividad seleccionada en el Contenedor 1:

Definir la aplicacin en GXportal

Para definir la aplicacin en GXportal se debe ir al men principal, dar clic en la opcin Configuracin del men principal de GXportal, seleccionar la opcin Aplicaciones y se despliega la pantalla siguiente.

En el campo a la derecha de Bsqueda, Ud. podr ingresar parte del nombre o descripcin de la aplicacin a buscar, luego dando clic sobre el botn Buscar se realizar la misma, quedando en la pantalla todas aquellas aplicaciones que cumplan esa condicin. Las acciones que se pueden realizar desde ac son las siguientes:

 Consultar: dando clic sobre el nombre de la aplicacin se pueden consultar los datos de la misma. Agregar: esta accin se debe utilizar para agregar una aplicacin. Al crear una aplicacin se crean automticamente dos ambiente de ejecucin: Desarrollo y Produccin, una aplicacin siempre deber tener como mnimo definidos dos ambientes. Actualizar: permite actualizar los datos de la aplicacin seleccionada. Borrar: permite eliminar una aplicacin, para que se pueda eliminar, ningn servicio de otra aplicacin debe apuntar a alguna actividad de esta aplicacin. Acerca de: permite consultar y actualizar los datos sobre la aplicacin (Nombre de Empresa, Nombre y Versin de la aplicacin, etc.). Vista previa: se presentarn los ambientes de ejecucin de la aplicacin, y al seleccionar un ambiente haciendo clic en su descripcin se desplegar la pgina de presentacin de la aplicacin, con el men de la misma, solo se mostrarn las opciones de men para el ambiente y segn los permisos definidos. En un ambiente se ver lo que est en su ambiente y en los ambientes siguiente, no en los ambientes anteriores. Si por ejemplo se define Desarrollo, Test y Produccin, en Desarrollo se vern las opciones de men que apuntan a actividades de cualquier ambiente, en Test se ver lo que est en Test y Produccin y en Produccin solamente lo que est en Produccin. Publicar: al pulsar esta accin se le solicitar la confirmacin de la publicacin de la aplicacin, esta accin pasa a la aplicacin y a cada una de sus actividades al siguiente ambiente de ejecucin. Subir: esta accin puede ser utilizada para ordenar las aplicaciones, la misma se encarga de subir la aplicacin. Bajar: esta accin puede ser utilizada para ordenar las aplicaciones, la misma se encarga de bajar la aplicacin. Este orden es utilizado por el GXportlet Lista de aplicaciones, es el orden en que se despliegan en la pgina las aplica ciones definidas. Las aplicaciones pueden ser: Pblicas o Privadas, sobre las aplicaciones Pblicas se tiene control total, mientras que sobre las aplicaciones Privadas existen restricciones para garantizar al propietario de la aplicacin su integridad. Por ejemplo sobre las mismas no se permiten actualizar los datos del Acerca de, del TAB General solo se podr personalizar el Ambiente actual y la pgina de presentacin. Del TAB Roles no se permite agregar ni quitar los mismos. En los TABs Mens y Operaciones no se pueden eliminar datos y en el TAB Actividades no se permite modificar informacin de la actividad. GXportal Provee una herramienta para exportar e importar aplicaciones, en el momento de exportar una aplicacin el usuario puede seleccionar si la desea exportar como aplicacin Privada o Pblica. Al momento de importar una aplicacin a un portal, se permite seleccionar como se desea realizar la misma, si creando una nueva aplicacin o bien realizando una actualizacin de una ya existente. En ambos casos GXportal generar una aplicacin nueva, de forma de no afectar la aplicacin actual, al seleccionar Actualizacin de una existente GXportal realiza una copia de los permisos configurados en la aplicacin actual sobre la nueva aplicacin, de forma de facilitar la puesta en produccin de las nuevas versiones de las aplicaciones.

CREAR UNA APLICACIN

Cuando se dispone a agregar una aplicacin se despliega la pantalla siguiente.

Aqu se ingresar el nombre y versin de la aplicacin, y luego el nombre de la misma en el Portal con su respectiva descripcin, estos ltimos en los idiomas del portal y al dar clic en Grabar se graban los datos y se presentarn los siguientes campos:

Nombre de programa nico por actividad: esta propiedad permite seleccionar si el nombre de programa existe nicamente en una actividad, si existe en ms

de una actividad luego la seguridad no se podr validar por nombre de programa y nicamente se podr validar por nombre de actividad. Ambiente de ejecucin actual: es el ambiente en que se encuentra la aplicacin. Se podr seleccionar cualquier ambiente definido para la misma puede estar Offline. Men principal: se selecciona el men del cual se mostrarn sus opciones de men en el GXportlet Men de una aplicacin (men principal de la aplicacin). Actividad predeterminada: se selecciona el nombre de la actividad predeterminada de la aplicacin, la misma es desplegada por GXportal en el GXportlet Contenedor con Identificador = 1 cuando un usuario ingresa a la aplicacin desde el men de aplicaciones. Pgina de presentacin: es la pgina en que se presentar la aplicacin, es la que se utiliza como marco de la aplicacin. Si da clic en el botn Avanzado puede configurarse mas informacin de la aplicacin, esta se ve en la pantalla siguiente.

Imagen vieta: esta imagen la utilizar el GXportlet Lista de aplicaciones, la misma se despliega no importando el Formato del mismo, siempre a la izquierda de la aplicacin. Imagen predeterminada: esta imagen la utilizar el GXportlet Lista de aplicaciones, si el mismo est configurado para que se despliegue con Formato Imgenes. Imagen al pasar el mouse: esta imagen la utilizar el GXportlet Lista de aplicaciones, si el mismo est configurado para que se despliegue con Formato Imgenes y el usuario pasa el mouse sobre la aplicacin. Imagen de observacin: esta imagen la utilizar el GXportlet Lista de aplicaciones, la misma se despliega no importando el Formato del mismo, siempre a la derecha de la aplicacin.

Adems se muestra a nivel informativo el usuario y fecha de creacin de la aplicacin y el usuario y fecha de la ltima modificacin de la misma. Roles

Para definir un rol como de la aplicacin se deber dar clic en la opcin Roles y se presentar la siguiente pantalla.

Seleccionar: esta opcin permite seleccionar roles definidos en el portal, los roles seleccionados quedan como privados de la aplicacin, stos son exportados con la aplicacin, junto a sus permisos definidos para esta aplicacin. Quitar: esta opcin permite quitar el rol como privado de la aplicacin. Ambientes de ejecucin

Para definir los ambientes de ejecucin de la aplicacin se deber dar clic en la opcin Ambientes y se presentar la siguiente pantalla. Los ambientes indican la ubicacin fsica de los programas de la aplicacin (Servidor, puerto, etc.). Tener la posibilidad de definir mltiples ambientes es muy til para poder as por ejemplo representar el ciclo de vida de mis objetos de la aplicacin (Desarrollo, Test y Produccin) o bien tambin son tiles para poder ejecutar la aplicacin en diferentes plataformas (Java, .Net, etc.)

Las acciones que se pueden realizar desde ac son las siguientes: Consultar: dando clic sobre el nombre del ambiente de ejecucin se pueden consultar los datos del mismo. Agregar: esta accin se debe utilizar para definir un nuevo ambiente de ejecucin.

Actualizar: permite actualizar los datos del ambiente de ejecucin seleccionado. Borrar: permite eliminar un ambiente de ejecucin. Una aplicacin deber tener definidos al menos dos ambientes de ejecucin. No se podr eliminar el ambiente de ejecucin en el que se encuentra la aplicacin y tampoco ningn ambiente en el que se encuentren las actividades definidas para la aplicacin. Subir: esta accin puede ser utilizada para ordenar los ambientes de ejecucin, la misma se encarga de subir el ambiente. Bajar: esta accin puede ser utilizada para ordenar los ambientes de ejecucin, la misma se encarga de bajar el ambiente. Este orden es utilizado para representar los ambientes por los que pasa una aplicacin y sus actividades.

CONFIGURAR LOS AMBIENTES DE EJECUCIN

Cuando se dispone a agregar un ambiente de ejecucin se despliega la pantalla siguiente.

Host: es el nombre del servidor donde est la aplicacin y sus actividades en el ambiente actual. Puerto: es el nmero de puerto del servidor para acceder a la aplicacin y sus actividades en el ambiente actual. Directorio virtual: es el directorio virtual a donde apunta la aplicacin y sus actividades para el ambiente actual. Ejecutar sobre protocolo seguro (https): indica si en el ambiente actual la aplicacin y las actividades (de tipo Programa) se ejecutarn sobre protocolo seguro.

Paquete de los programas: indica el prefijo de los programas del ambiente, es utilizado frecuentemente para aplicaciones Java, indicando el paquete al cual pertenece la clase, por ejemplo com.artech.gxportal. Extensin de los programas: indica la extensin de los programas que se ejecutan en este ambiente, por ejemplo: aspx, asp, etc. Descripcin: es la descripcin del ambiente en los idiomas del backend.

No se permite definir distintas aplicaciones con el mismo ambiente de ejecucin, el mismo debe variar al menos en el nombre del Host, nmero de puerto o nombre de directorio virtual. Al dar clic en el botn Avanzado se muestra a nivel informativo el usuario y fecha de creacin del ambiente de ejecucin y el usuario y fecha de la ltima modificacin del mismo.

DEFINIR LOS MENS

Para definir los mens y las opciones de men de la aplicacin se deber dar clic en la opcin Mens y se presentar la siguiente pantalla. Los Mens representan los mens de la aplicacin.

En el campo a la derecha de Bsqueda, Ud. podr ingresar parte del nombre o descripcin del men a buscar, luego dando clic sobre el botn Buscar se realizar la misma, quedando en la pantalla todos aquellos mens que cumplan esa condicin. Las acciones que se pueden realizar desde ac son las siguientes:

Consultar: dando clic sobre el nombre del men se pueden consultar los datos del mismo. Agregar: esta accin se debe utilizar para definir un nuevo men. Actualizar: permite actualizar los datos del men seleccionado. Borrar: permite eliminar el men seleccionado. No se podr borrar un men si alguna opcin de men apunta al mismo, y tampoco si es el men principal de la aplicacin. Opciones: permite administrar las opciones de men del men.

CREAR UN MEN
Cuando se dispone a agregar un men se despliega la pantalla siguiente.

Aqu se ingresar el nombre y descripcin del men en los idiomas del portal y al dar clic en Confirmar se graban los datos y se presentar una pantalla para definir sus opciones de men.

OPCIONES DE MEN
Para definir las opciones de men de un men se deber dar clic en la opcin Mens y para el men correspondiente se deber dar clic en la opcin Opciones y se presentar la siguiente pantalla. Las opciones de men representan las opciones de un men.

En el campo a la derecha de Bsqueda, Ud. podr ingresar parte del nombre o descripcin de la opcin de men a buscar, luego dando clic sobre el botn Buscar se realizar la misma, quedando en la pantalla todas aquellas opciones de men que cumplan esa condicin. Las acciones que se pueden realizar desde ac son las siguientes: Consultar: dando clic sobre el nombre de la opcin de men se pueden consultar los datos de la misma. Agregar: esta accin se debe utilizar para definir una nueva opcin de men. Actualizar: permite actualizar los datos de la opcin de men seleccionada. Borrar: permite eliminar la opcin de men seleccionada. Subir: esta accin puede ser utilizada para ordenar las opciones de men del men actual, la misma se encarga de subir la opcin de men. Bajar: esta accin puede ser utilizada para ordenar las opciones de men del men actual, la misma se encarga de bajar la opcin de men. Este orden es utilizado por el GXportlet Men de una aplicacin, es el orden en que se despliegan las opciones de men del men seleccionado en el men para la aplicacin seleccionada.

CREAR UNA OPCIN DE MEN

Cuando se dispone a agregar una opcin de men se despliega la pantalla siguiente.

Tipo de opcin de men: la opcin de men puede apuntar a una actividad o a otro men. Actividad: si la opcin de men apunta a una actividad, habr que indicar la actividad. Para ello se deber hacer clic en y se presentarn todos las actividades definidas para la aplicacin actual como se muestra en la siguiente pantalla.

En el campo a la derecha de Bsqueda, Ud. podr ingresar parte del nombre o descripcin de la actividad a buscar o tambin parte del nombre del programa, luego dando clic sobre el botn Buscar se realizar la misma, quedando en la pantalla todas aquellas actividades que cumplan esa condicin.

Para seleccionar una actividad existente se deber dar clic en su descripcin y se volver a la pantalla anterior quedando seleccionado el mismo. Para crear una nueva actividad se deber dar clic en , ingresar los datos de la actividad y al dar clic en el botn Confirmar, se volver a esta pantalla donde se agregar la actividad creada y para seleccionar esta actividad se deber proceder como en el caso anterior explicado. Parmetros: descripcin de los parmetros del programa, en caso que el programa definido los reciba, los mismos deben estar separados por coma (, ). stos son concatenados automticamente a los parmetros fijos que tenga configurado la actividad. Men: si la opcin de men apunta a un men, habr que indicar el grupo funcional. Para ello se deber hacer clic en y se presentarn todos los mens definidos para la aplicacin actual como se muestra en la siguiente pantalla.

En el campo a la derecha de Bsqueda, Ud. podr ingresar parte del nombre del men a buscar, luego dando clic sobre el botn Buscar se realizar la misma, quedando en la pantalla todos aquellos mens que cumplan esa condicin. Para seleccionar un men existente se deber dar clic en su nombre y se volver a la pantalla anterior quedando seleccionado el mismo. Para crear un nuevo men se deber dar clic en , ingresar los datos del men y al dar clic en el botn Confirmar, se volver a esta pantalla donde se agregar el men creado y para seleccionar este men se deber proceder como en el caso anterior explicado. Nombre y descripcin: es el nombre y la descripcin de la opcin de men en los idiomas del portal. Si la opcin de men apunta a una actividad y no se ingres el nombre de la opcin de men, se graba con el nombre de la

actividad al que apunta. Si la opcin de men apunta a un men y no se ingres el nombre de la opcin de men, se graba con el nombre del men al que apunta. Cuando se ejecuta la aplicacin, la descripcin podr ser desplegada como texto de ayuda de la opcin de men, esto debe ser configurado en el GXportlet correspondiente. Si da clic en el botn Avanzado puede configurarse mas in formacin de la opcin de men, esta se ve en la pantalla siguiente.

Imagen vieta: esta imagen la utilizar el GXportlet Men de una aplicacin, la misma se despliega no importando el Formato del mismo, siempre a la izquierda de la opcin de men. Imagen predeterminada: esta imagen la utilizar el GXportlet Men de una aplicacin para presentar la opcin de men, si el mismo est configurado para que se despliegue con Formato Imgenes. Imagen al pasar el mouse: esta imagen la utilizar el GXportlet Men de una aplicacin, si el mismo est configurado para que se despliegue con Formato Imgenes y el usuario pasa el mouse sobre la opcin de men. Imagen de observacin: esta imagen la utilizar el GXportlet Men de una aplicacin, la misma se despliega no importando el Formato del mismo, siempre a la derecha de la opcin de men.

Adems se muestra a nivel informativo el usuario y fecha de creacin de la opcin de men y el usuario y fecha de la ltima modificacin de la misma.

OPERACIONES
Para definir las operaciones y los servicios de la aplicacin se deber dar clic en la opcin Operaciones y se presentar la siguiente pantalla. La operacin contiene un conjunto de servicios que son brindados por opciones de men, una misma operacin puede ser utilizada por varias opciones de men.

En el campo a la derecha de Bsqueda, Ud. podr ingresar parte del nombre, descripcin o identificador de la operacin a buscar, luego dando clic sobre el botn Buscar se realizar la misma, quedando en la pantalla todas aquellas operaciones que cumplan esa condicin. Las acciones que se pueden realizar desde ac son las siguientes: Consultar: dando clic sobre el nombre de la operacin se pueden consultar los datos de la misma. Agregar: esta accin se debe utilizar para definir una nueva operacin. Actualizar: permite actualizar los datos de la operacin seleccionada. Borrar: permite eliminar la operacin seleccionada. Servicios: permite administrar los servicios de la operacin.

CREAR UNA OPERACIN

Cuando se dispone a agregar una operacin se despliega la pantalla siguiente.

Identificador: String identificador de la operacin, este string ser el medio por el cual una actividad comunica a GXportal la lista de servicios a desplegarse. El mismo es alfanumrico y usualmente se utiliza el nombre del programa (hnombre_web_panel). Nombre y descripcin: es el nombre y la descripcin de la operacin en los idiomas del portal.

Al dar clic en Confirmar se graban los datos y se presentar una pantalla para definir sus servicios.

SERVICIOS
Para definir los servicios de una operacin se deber dar clic en la opcin Operaciones y para la operacin correspondiente se deber dar clic en la opcin Servicios y se presentar la siguiente pantalla.

En el campo a la derecha de Bsqueda, Ud. podr ingresar parte del nombre o descripcin del servicio a buscar, luego dando clic sobre el botn Buscar se realizar la misma, quedando en la pantalla todos aquellos servicios que cumplan esa condicin. Las acciones que se pueden realizar desde ac son las siguientes: Consultar: dando clic sobre el nombre del servicio se pueden consultar los datos del mismo. Agregar: esta accin se debe utilizar para definir un nuevo servicio. Actualizar: permite actualizar los datos del servicio seleccionado. Borrar: permite eliminar el servicio seleccionado. Subir: esta accin puede ser utilizada para ordenar los servicios de la operacin actual, la misma se encarga de subir el servicio. Bajar: esta accin puede ser utilizada para ordenar los servicios de la operacin actual, la misma se encarga de bajar el servicio. Este orden es utilizado por el GXportlet Contenedor, es el orden en que se despliegan los servicios asociados a una operacin.

CREAR UN SERVICIO
Cuando se dispone a agregar un servicio se despliega la pantalla siguiente.

Aplicacin: se deber indicar la aplicacin a la que pertenece la actividad la que apunta el servicio actual. Para ello se deber dar clic en y se presentarn todas las aplicaciones definidas como se muestra en la siguiente pantalla.

En el campo a la derecha de Bsqueda, Ud. podr ingresar parte del nombre o descripcin de la aplicacin a buscar, luego dando clic sobre el botn Buscar se realizar la misma, quedando en la pantalla todas aquellas aplicaciones que cumplan esa condicin. Para seleccionar una aplicacin se deber dar clic en su nombre y se volver a la pantalla anterior quedando seleccionada la misma. Actividad: se deber indicar la actividad a la que apunta el servicio actual. Para ello se deber dar clic en y se presentarn todas las actividades de la aplicacin seleccionada como se muestra en la siguiente pantalla.

En el campo a la derecha de Bsqueda, Ud. podr ingresar parte del nombre o de la descripcin de la actividad o tambin parte del nombre del programa a buscar, luego dando clic sobre el botn Buscar se realizar la misma, quedando en la pantalla todas aquellas actividades que cumplan esa condicin. Para seleccionar una actividad existente se deber dar clic en su descripcin y se volver a la pantalla anterior quedando seleccionado el mismo. Para crear una nueva actividad se deber dar clic en , ingresar los datos de la actividad y al dar clic en el botn Confirmar, se volver a esta pantalla donde se agregar la actividad creada y para seleccionar esta actividad se deber proceder como en el caso anterior explicado. Parmetros: descripcin de los parmetros del programa, en caso que el programa definido los reciba, los mismos deben estar separados por coma (, ). stos son concatenados automticamente a los parmetros fijos que tenga configurada la actividad. Nombre y descripcin: es el nombre y la descripcin del servicio en los idiomas del portal. Si no se ingres el nombre del servicio, se graba con el nombre de la actividad a la que apunta. Cuando se ejecuta la aplicacin, la descripcin podr ser desplegada como texto de ayuda del servicio, esto debe ser configurado en el GXportlet correspondiente.

Si da clic en el botn Avanzado puede configurarse mas informacin del servicio, sta se ve en la pantalla siguiente.

Imagen vieta: esta imagen la utilizar el GXportlet Contenedor, la misma se despliega no importando el Formato del mismo, siempre a la izquierda del servicio. Imagen predeterminada: esta imagen la utilizar el GXportlet Contenedor para presentar el servicio, si el mismo est configurado para que se despliegue con Formato Imgenes. Imagen al pasar el mouse: esta imagen la utilizar el GXportlet Contenedor, si el mismo est configurado para que se despliegue con Formato Imgenes y el usuario pasa el mouse sobre el servicio. Imagen de observacin: esta imagen la utilizar el GXportlet Contenedor, la misma se despliega no importando el Formato del mismo, siempre a la derecha del servicio. Adems se muestra a nivel informativo el usuario y fecha de creacin del servicio y el usuario y fecha de la ltima modificacin del mismo.

ACTIVIDADES
Para definir las actividades de la aplicacin se deber dar clic en la opcin Actividades y se presentar la siguiente pantalla. Las actividades son los links a los programas web desarrollados por el usuario (si la aplicacin est desarrollada con GeneXus deber definir el nombre de los web panels y/o transacciones)

En el campo a la derecha de Bsqueda, Ud. podr ingresar parte de la descripcin de la actividad o parte del nombre de programa al que invoca la actividad a buscar, luego dando clic sobre el botn Buscar se realizar la misma, quedando en la pantalla todas aquellas actividades que cumplan esa condicin. A la derecha de Ambiente de ejecucin, podr seleccionar las actividades de qu ambiente quiere listar, si no quiere utilizar este filtro deber seleccionar el valor Todos. Inicialmente estar seleccionado el ambiente en que se encuentra la aplicacin. A la derecha de Filtrar por podr filtrar por Men o por Operacin. Si selecciona Men, a su derecha se cargarn todos los mens y al seleccionar un men se listarn todas las actividades que son llamados por las opciones de men del mismo, o que son llamados por las opciones de men de los mens que son llamados por las opciones de men del mismo. Si selecciona Operacin, a su derecha se cargarn todas las operaciones y al seleccionar una operacin se listarn todas las actividades que son llamadas por los servicios de la misma. Si no desea filtrar por Men ni por Operacin, deber seleccionar el valor (Seleccionar). Las acciones que se pueden realizar desde ac son las siguientes:

 Consultar: dando clic sobre la descripcin de la actividad se pueden consultar los datos del mismo. Agregar: esta accin se debe utilizar para definir una nueva actividad. Actualizar: permite actualizar los datos de la actividad seleccionada. Borrar: permite eliminar la actividad seleccionada. No se podr borrar una actividad si alguna opcin de men apunta al mismo o si es la actividad predeterminada de la aplicacin. Tampoco se podr borrar una actividad si algn servicio apunta a l. Publicar: esta accin pasa las actividades seleccionadas al siguiente ambiente de ejecucin. Para eso deber dar clic en la columna Publicar para las actividades correspondientes quedando la casilla seleccionada. Para quitar la seleccin, deber nuevamente hacer clic en la columna Publicar para las actividades correspondientes quedando la casilla no seleccionada. Para confirmar los cambios, haga clic en el botn Grabar ( ). Para seleccionar todos las actividades listadas, puede dar clic con el botn izquierdo del mouse en el botn y para quitar la seleccin de todas las actividades listadas, puede dar clic con el botn derecho del mouse en este botn.

CREAR UNA ACTIVIDAD

Cuando se dispone a agregar una actividad se despliega la pantalla siguiente.

Si da clic en el botn Avanzado se muestra a nivel informativo el usuario y fecha de creacin de la actividad y el usuario y fecha de la ltima modificacin del mismo. Nombre: es el nombre que identificar esta Actividad. Ambiente actual: es el ambiente en que se encuentra la actividad. Se podr seleccionar cualquier ambiente definido para la aplicacin puede estar Offline.

Tipo de actividad: puede seleccionar Nombre de programa GXflow. Descripcin: es la descripcin de la actividad en los idiomas del portal.

Si el Tipo de actividad es Nombre de programa se solicita: Nombre: nombre del programa (pgina web). Los mismos pueden estar desarrollados en cualquier tecnologa web. Se cuenta con un servicio el cual permite acceder a la sesin de usuario, obteniendo as los roles y permisos sobre las actividades indicadas en el mismo. No pueden haber dos actividades de una misma aplicacin con el mismo nombre de programa y los mismos parmetros. En el caso de desarrollar la aplicacin con GeneXus (www.genexus.com), las actividades seran el nombre de los web panels y transacciones. Para acceder a la sesin de usuario se cuenta con acceso a la base de datos de GXportal, a travs de APIs y Data Views. Para consolidar estos objetos en su KB descargue el archivo xpz que se encuentra en nuestro sitio en el rea de descargas, el mismo tambin cuenta con un ejemplo. Parmetros fijos: descripcin de los parmetros del programa, en caso que el programa definido los reciba, los mismos deben estar separados por coma (, ). Recibe parmetros de seguridad?: se debe marcar la casilla en caso que el programa reciba parmetros de seguridad que enva GXportal, el mismo permite validar la sesin del usuario.

Si el Tipo de actividad es GXflow (www.gxflow.com) se solicita: Funcionalidad: se deber seleccionar la funcionalidad de GXflow, en la lista se despliegan los posibles puntos de entrada de la aplicacin realizada utilizando GXflow como motor de Workflow, permitiendo esto incorporar fcilmente aplicaciones orientadas a procesos. Esta brinda integracin transparente entre GXportal y GXflow. Algunos ejemplo de las funcionalidades son: o Administrador de procesos o Consola de Administracin o Escritorio o Escritorio Bandeja de Entrada o Escritorio Bandeja de Salida o Tareas de Workflow Se desplegar una lista de procesos de la aplicacin, y al seleccionar uno se despliega una lista de tareas de ese proceso seleccionado. Esto permite iniciar un Proceso-Tarea de Workflow desde el men de la aplicacin (ejecutando en forma batch el motor de Workflow). Si se est integrando una aplicacin GeneXus con GXflow debe tener en cuenta las siguientes consideraciones: Descargar objetos para integracin GXflow GXportal, para descargar los objetos a consolidar para GXflow 8.0 de clic aqu, para GXflow 8.5 de clic aqu, para GXflow 9.0 de clic aqu.

 Verificar en la KB, que los SDTs WFSDTProcessDefinitions y WFSDTTasks tengan en sus propiedades, configurado la propiedad Exposed name = nula (vaco) y la propiedad Exposed namespace = "gxflow". Nominar los usuarios que van a participar en el workflow. Los usuarios deben ser definidos nicamente en GXportal. Los roles del usuario deben administrarse desde GXportal. Mapear los roles del portal con los roles de GXflow. Para esto se debe definir en GXportal un rol por cada rol de GXflow y en la propiedad Cdigo externo ingresar el identificador del rol en GXflow. Por ejem plo como muestra la figura siguiente, para el rol K2B est mapeado con el rol 10 de GXflow:

El nmero 10 se obtiene desde el backend de GXflow, accediendo con el usuario WFADMINISTRATOR, ir a Consola de Administracin, y luego el TAB Roles, se da clic sobre el rol correspondiente y luego sobre el botn con una lupa, de esa forma se acceder a la pantalla del rol como muestra la imagen siguiente.

De esta forma se centraliza la definicin de usuario en GXportal, al momento de ingresar a una actividad de tipo GXflow, GXflow toma los mismo roles que tenga ese usuario autenticado en GXportal. Esta sincronizacin de roles entre GXportal y GXflow se realiza una sola vez por sesin, por lo tanto si se cambian los roles de un usuario en la sesin, para que GXflow visualice ese cambio se debe cerrar y abrir el navegador nuevamente.

Definir la seguridad de la aplicacin

La seguridad en GXportal est basada en roles, por lo tanto la seguridad se configura a nivel de rol, y los roles son asignados a los usuarios. En base a los roles del usuario se calculan permisos del mismo. Para ello debe acceder desde el men de GXportal a la opcin Configuracin - Permisos.

En el campo a la derecha de Modificar permisos de, Ud. deber seleccionar sobre que elemento desea administrar los permisos, y segn lo seleccionado se habilitarn distintos campos.

ADMINISTRAR PERMISOS DE ROLES

Al seleccionar Modificar los permisos de Roles, se presentar la siguiente pantalla:

En el campo a la derecha de Rol, Ud. deber seleccionar el rol al que se le definirn sus permisos. Luego, se presentar Permitir o denegar acceso a y a la derecha deber seleccionar si va a definir los permisos sobre: Aplicaciones, Mens o Actividades. Si por ejemplo selecciona Aplicaciones, se listarn todas las aplicaciones sobre las que tiene permisos el rol seleccionado, ya sea que tiene permiso o que est denegada. Para afinar el resultado de la bsqueda, en el campo a la derecha de Bsqueda, Ud. podr ingresar parte de la descripcin de lo que se est listando, luego dando clic sobre el botn Buscar se realizar la misma. Para ver cmo funciona la lista, seguiremos con el ejemplo de aplicaciones. Las aplicaciones sobre las que tiene permiso el rol seleccionado, tienen 3 columnas Permitir, Denegar y Quitar. Si la columna Permitir est seleccionada, significa que el rol tiene permiso de acceso para esa aplicacin, si la columna Denegar est seleccionada significa que el rol no tiene acceso a esa aplicacin. Los usuarios que tengan un rol asignado el cual tiene determinadas aplicaciones con la columna Permitir seleccionada, significa que tendrn acceso a las mismas. Pero si estos usuarios tienen algn otro rol asignado el cual tiene determinadas aplicaciones con la columna Denegar seleccionada, entonces este permiso ser ms fuerte que el otro, por lo cual no podr acceder a cada una de estas aplicaciones que tenga denegada. Las acciones que se pueden realizar desde ac son las siguientes: Permitir: se utiliza para asignar permiso, haciendo clic se marca la casilla y queda asignado el permiso, y si se hace clic nuevamente se desmarca la casilla y no queda asignado el permiso. Denegar: se utiliza para denegar permiso, haciendo clic se marca la casilla y queda denegado el permiso, y si se hace clic nuevamente se desmarca la casilla y no queda denegado el permiso. Quitar: se utiliza para quitar el permiso, haciendo clic se marca la casilla para quitar el permiso, y si se hace clic nuevamente se desmarca la casilla para no quitar el permiso.

Permitir todos o ninguno: para asignar permiso a todos los elementos de la lista, haga clic con el botn izquierdo del mouse y quedar toda la columna Permitir seleccionada. Para que no quede asignado permiso a ningn elemento de la lista, haga clic con el botn derecho del mouse y quedar toda la columna Permitir no seleccionada. Denegar todos o ninguno: para denegar permiso a todos los elementos de la lista, haga clic con el botn izquierdo del mouse y quedar toda la columna Denegar seleccionada. Para que no quede denegado ningn elemento de la lista, haga clic con el botn derecho del mouse y quedar toda la columna Denegar no seleccionada. Quitar todos o ninguno: para quitar el permiso a todos los elementos de la lista, haga clic con el botn izquierdo del mouse y quedar toda la columna Quitar seleccionada. Para no quitar el permiso de ningn elemento de la lista, haga clic con el botn derecho del mouse y quedar toda la columna Quitar no seleccionada. Grabar: para grabar los cambios realizados, haga clic en este botn. De lo contrario, se perdern todos los cambios. Seleccionar: para agregar nuevos elementos a la lista para asignarle permiso, haga clic en este botn, y se presentar la siguiente pantalla:

Siguiendo con el ejemplo de aplicaciones, se listarn todas las aplicaciones que no tienen permiso definido para el rol seleccionado, y se seleccionar marcando Permitir o Denegar en la columna correspondiente.

Los botones Permitir todos o ninguno y Denegar todos o ninguno tienen la misma funcionalidad que se explic anteriormente. El botn Asignar asigna los permisos definidos y los agrega a la lista de aplicaciones que tienen definido permiso para el rol seleccionado, desapareciendo dichas aplicaciones de la lista actual. Esta ventana permanece abierta para continuar asignando permisos. El botn Confirmar hace lo mismo que el botn Asignar, la nica diferencia es que cierra esta ventana y se vuelve a la ventana anterior. Si en el campo a la derecha de Permitir o denegar acceso a seleccion Mens o Actividades, se presentar Aplicacin y a la derecha deber seleccionar la aplicacin a la que pertenecen los Mens o Actividades a los que se les definir el permiso para el rol seleccionado.

ADMINISTRAR PERMISOS DE APLICACIONES

Al seleccionar que se modificarn los permisos de aplicaciones, se presentar la etiqueta Aplicacin y en el campo a su derecha, deber seleccionar la aplicacin a la que se le definirn sus permisos. Una vez seleccionada la aplicacin, se listarn todos los roles que tienen definido permisos sobre la aplicacin seleccionada, ya sea que tiene permiso o que est denegado. Para afinar el resultado de la bsqueda, en el campo a la derecha de Bsqueda, Ud. podr ingresar parte de la descripcin del rol a buscar, luego dando clic sobre el botn Buscar se realizar la misma, quedando en la pantalla todos aquellos roles que cumplan esa condicin. En el campo a la derecha de Ver permisos podr seleccionar si se quieren ver todos los permisos, los permitidos o los denegados. Los permisos se podrn asignar, denegar o quitar del mismo modo que se explic para el caso anterior.

ADMINISTRAR PERMISOS DE MENS DE UNA APLICACIN

Al seleccionar que se modificarn los permisos de Aplicaciones - Men, se presentar la siguiente pantalla:

En el campo a la derecha de Aplicacin, Ud. deber seleccionar la aplicacin a la que pertenece el Men al que se le definirn sus permisos. Luego, se presentar Men y a la derecha se cargarn todos los Mens de la aplicacin seleccionada y deber seleccionar el men correspondiente. Una vez seleccionado el men, se listarn todos los roles que tienen definido permisos sobre el Men seleccionado, ya sea que tiene permiso o que est denegado. Para afinar el resultado de la bsqueda, en el campo a la derecha de Bsqueda, Ud. podr ingresar parte de la descripcin del rol a buscar, luego dando clic sobre el botn Buscar se realizar la misma, quedando en la pantalla todos aquellos roles que cumplan esa condicin. En el campo a la derecha de Ver permisos podr seleccionar si se quieren ver todos los permisos, los permitidos o los denegados. Los permisos se podrn asignar, denegar o quitar del mismo modo que se explic para el primer caso.

ADMINISTRAR PERMISOS DE ACTIVIDADES DE UNA APLICACIN

Al seleccionar que se modificarn los permisos de actividades, se presentar la siguiente pantalla:

En el campo a la derecha de Aplicacin, Ud. deber seleccionar la aplicacin a la que pertenece la actividad que se le definirn sus permisos. Luego, se presentar Actividad y a la derecha se cargarn todos las actividades de la aplicacin seleccionada y deber seleccionar la actividad correspondiente. Una vez seleccionada la actividad, se listarn todos los roles que tienen definido permisos sobre la actividad seleccionada, ya sea que tiene permiso o que est denegado. Para afinar el resultado de la bsqueda, en el campo a la derecha de Bsqueda, Ud. podr ingresar parte de la descripcin del rol a buscar, luego dando clic sobre el botn Buscar se realizar la misma, quedando en la pantalla todos aquellos r oles que cumplan esa condicin. En el campo a la derecha de Ver permisos podr seleccionar si se quieren ver todos los permisos, solo los permitidos o los denegados.

Los permisos se podrn asignar, denegar o quitar del mismo modo que se explic para el primer caso.

Otros Tips
En este captulo se pueden ver otras funcionalidades que brinda GXportal para facilitar la integracin de las aplicaciones: Links a pginas del portal Pasaje de parmetros a la aplicacin externa desde GXportal Invocacin de pginas desde logout de GXportal Manejo de la navegacin desde la aplicacin externa Inicio de sesin en GXportal desde una aplicacin externa

Links a pginas del portal

Al integrar aplicaciones externas a GXportal es muy probable que sea necesario hacer links desde la aplicacin externa a pginas de GXportal. Si los links a las pginas se hacen de la forma convencional, es decir, copiando la URL de la pgina, la tarea de mantenimiento de los links se vuelve engorrosa. Un ejemplo es cuando desde distintos puntos existen links hacia una determinada pgina del sitio, por ejemplo, la pgina principal. Si el administrador del sitio decide cambiar la pgina principal, todos esos links quedaran rotos. El catlogo de pginas soluciona este problema, permitiendo que se cataloguen las pginas con un identificador, de forma que quienes quieran hacer links a las pginas, slo necesiten saber el identificador. Si el administrador del sitio decide por ejemplo, que la pgina principal del sitio fuera otra, slo debera modificar la entrada en el catlogo correspondiente a la pgina principal, no se debe modificar nada en la aplicacin y los links siguen funcionando correctamente. Para hacer un link hacia una pgina catalogada, existen dos alternativas: 1) hgxppredirect*?<Sitio>,<Catlogo>,<NuevaVentana>,<NombreVentana>,, <Parmetros>

2)

hgxpp001*?<Sitio>,,,,<Idioma>,,PAG;CATA;<Catlogo>;<NuevaVentana>; <NombreVentana>;PAG;,<Parmetros>

Al nombre del programa se le deber adicionar la extensin de los mismos, dependiendo la plataforma en la cual est instalado GXportal, por ejemplo si la plataforma es .Net todos los programas son .aspx (hgxpp001.aspx o hgxppredirect.aspx) Donde: <Sitio> Es el identificador del sitio en la instalacin de GXportal. El mismo se obtiene desde el men principal de GXportal, Configuracin Configuracin del Portal, la primer columna desplegada (Id.). Es el idioma en el que se quiere mostrar la pgina del portal, GXportal codifica los idiomas con un nico carcter. Es el identificador de la entrada en el catlogo de links de GXportal. El mismo se obtiene desde el men principal de GXportal, Diseo Navegacin, la primer columna desplegada (Id.). Este parmetro puede tener dos valores, 1 o 0 (uno o cero) e indica si la pgina se abrir en una nueva ventana (1=Si, 0=No). Este parmetro debe especificarse si el valor del parmetro anterior es 1. Indica el nombre interno de la ventana nueva en el Sistema Operativo, no es un nombre que se le desplegar al usuario. Esto es utilizado, por ejemplo cuando se desea reutilizar una ventana popup, o sea si yo a 2 links les pongo el mismo nombre de ventana, el usuario solo ver una a la vez. Este parmetro permite especificar los parmetros para las aplicaciones externas que estn ubicadas en dicha pgina (esto se discute detalladamente ms adelante en Pasaje de parmetros a la aplicacin externa desde GXportal).

<Idioma> <Catlogo>

<NuevaVentana>

<NombreVentana>

<Parmetros>

Pasaje de parmetros a la aplicacin externa desde GXportal

En GXportal se brinda la posibilidad de envo de parmetros a las aplicaciones externas que ejecutan en los GXportlets de integracin de aplicaciones y el de Aplicaciones Externas. La forma consiste en pasarle como ltimo parmetro a la

pgina de GXportal en la que se encuentra la aplicacin (hgxpp001) los parmetros que requiere la aplicacin integrada. Los parmetros van dentro de un nico string por lo que es necesario utilizar un separador de campo distinto de la coma, por ejemplo punto y coma (;). Para poder especificar los parmetros para las aplicaciones externas se deben utilizar links externos hacia las propias pginas de GXportal por lo que es altamente recomendable que las pginas hacia las que se hagan links externos se cataloguen. Utilizando un link catalogado, redireccionando hacia una pgina con la aplicacin externa se debe realizar de la siguiente forma:

hgxpp001?<Sitio>,,,<Idioma>,,,PAG;CATA;<Catlogo>;PAG;,<Parmetros> Donde: <Sitio> Es el identificador del sitio en la instalacin de GXportal. El mismo se obtiene desde el men principal de GXportal, Configuracin --> Configuracin del Portal, la primer columna desplegada (Id.). Es el idioma en el que se quiere mostrar la pgina del portal, GXportal codifica los idiomas con un nico carcter. Es el identificador de la entrada en el catlogo de links de GXportal. El mismo se obtiene desde el men principal de GXportal, Diseo --> Navegacin, la primer columna desplegada (Id.). Este parmetro permite especificar los parmetros para las aplicaciones externas que estn ubicadas en dicha pgina.

<Idioma> <Catlogo>

<Parmetros>

Ejemplo: hgxpp001?1,,,,,,PAG;CATA;11;PAG;,6554;S En este ejemplo, el cdigo de sitio es 1, el cdigo de catlogo de la pgina es 11 y se le estn pasando por parmetro a la aplicacin externa que est en la pgina los valores 6554 y S separados por punto y coma.

Invocacin de pginas desde logout de GXportal

En ocasiones es necesario ejecutar una aplicacin externa cuando se efecta el logout desde GXportal para, por ejemplo, destruir una cookie o sesin web que se haya guardado para uso particular de la aplicacin. Para hacerlo, es necesario configurar el GXportlet de Acceso al Portal para que el botn de logout, luego de realizar el logout de GXportal, invoque a una pgina determinada. La pgina puede ser interna, de catlogo o externa. Por ejemplo, si se quisiera destruir una cookie o websession, podra invocarse a una aplicacin que lo realice y luego que esta redireccionar a una determinada pgina

de GXportal o se podra invocar directamente a una pgina de GXportal que tuviera una aplicacin externa en un GXportlet de Aplicaciones Externas que la destruyera.

Manejo de la navegacin desde la aplicacin externa

Existe la posibilidad de controlar la navegacin de GXportal de forma que, desde la aplicacin externa, pueda navegarse a una pgina distinta. Para hacerlo es necesario utilizar el siguiente cdigo Java Script en la aplicacin externa: parent.location.href = <URL>; Donde <URL> es la URL de la pgina a la que se quiere navegar. Si la URL es una pgina de GXportal, conviene que se utilice una pgina catalogada, con lo explicado en captulos anteriores.

Inicio de sesin en GXportal desde una aplicacin externa

El inicio de sesin en GXportal desde una aplicacin externa es til en aquellos casos en los que el usuario debe iniciar sesin en distintos sistemas y no se desea que el usuario deba proporcionar su login y contrasea por cada uno de los mismos. Este mecanismo consiste en permitir que la aplicacin externa autentique en el portal indicando el usuario, la contrasea y una pgina de GXportal que desea desplegar al usuario luego de iniciada la sesin. La invocacin se hace de la siguiente forma:

hgxpplogredir? <Sitio>,<Usuario>,<Contrasea>,<Catlogo>, <NuevaVentana>,<NombreVentana>,,<Parmetros>

Donde: <Sitio> Es el identificador del sitio en la instalacin de GXportal. El mismo se obtiene desde el men principal de GXportal, Configuracin --> Configuracin del Portal, la primer columna desplegada (Id.). Usuario que se desea autenticar en el portal (login). Contrasea del usuario a autenticar. Es el identificador de la entrada en el catlogo de links de GXportal. El mismo se obtiene desde el men principal de GXportal, Diseo --> Navegacin, la primer columna desplegada (Id.). Este parmetro puede tener dos valores, 1 o 0 (uno o cero) e indica si la pgina se abrir en una nueva ventana (1=Si, 0=No).

<Usuario> <Contrasea> <Catlogo>

<NuevaVentana>

<NombreVentana>

Este parmetro debe especificarse si el valor del parmetro anterior es 1. Indica el nombre interno de la ventana nueva en el Sistema Operativo, no es un nombre que se le desplegar al usuario. Esto es utilizado, por ejemplo cuando se desea reutilizar una ventana popup, o sea si yo a 2 links les pongo el mismo nombre de ventana, el usuario solo ver una a la vez. Este parmetro permite especificar los parmetros para las aplicaciones externas que estn ubicadas en dicha pgina (esto fue explicado en captulos anteriores.).

<Parmetros>