Guía para el desarrollo y administración de portales

Transcripción

1 Guía para el desarrollo y administración de portales

2 Información del documento Título Desarrollo y administración de portales Archivo Desarrolllo y Administración de portales.doc Au t o r José Miguel Anabalón Cristian Vera Fecha de creación Versión documento Versión plantilla Estado Vigente 2 1 Aprobación del documento Jefe de Proyectos y/o Ejecutivo de Negocios Jorge Ibarra G. Fecha

3 Índice 1. Etapa Desarrollo Creando portal Web weblogic Conectándolo con el Administrador de Contenidos Creando Look and Feel Etapa Producción Administración de portal Administración de Portales Creacion de Portales Crear Un Desktop Creación de Libros o Books Creación de páginas Incorporación de Portlets... 32

4 Objetivos y alcances. El presente documento tiene como objetivo ser una guía para el desarrollo y administración de portales bajo la plataforma corporativa. Las dos etapas tienen alcances diferentes pues la primera se enfoca en definir, especificar y diseñar estructuras que permitan responder las necesidades del solicitante, pero a su vez dar una visión que permita su reutilización a futuro. El público en el cual se enfoca son desarrolladores, arquitectos de información y diseñadores gráficos La segunda etapa tiene relación con la administración de los elementos definidos y construidos en la etapa anterior, mediante el uso de herramientas que provee el software en el cual se encuentra la plataforma. El público en el cual se enfoca son administradores y editores de portales.

5 1. Etapa Desarrollo 1.1 Creando portal Web weblogic 10 Recomendación: Antes de comenzar la instalación de weblogic10, se recomienda no tener instalado una versión anterior a este. Una vez instalado correctamente weblogic 10, se debe crear una aplicación de tipo Portal EAR Project (Figura 1.1), a la cual se le asociara posteriormente la aplicación Portal Web Project. Figura 1.1: Creación Portal EAR Project

6 Luego de crear el Portal EAR Project, se debe crear el Portal Web Project y asociarlo al Portal EAR Project, figura 1.2 Figura 1.2: Creación Portal Web Project

7 Luego de asociar estos proyectos se deberá realizar un clean al proyecto, esto es Project->clean figura 1.3 Figura 1.3: Clean

8 Una vez realizado correctamente Clean sobre el proyecto, se deberá asignar un servidor sobre el cual correrá el proyecto, tal como se muestra en la figura 1.4. Figura 1.4 Creando nuevo server.

9 Se debe tener en cuenta que el nuevo server debe ser de tipo portal por lo que debe obtenerse de la ruta bea\wlserver_10.0\samples\domain\portal figura (1.5). Figura 1.5 Creando nuevo server.

10 Luego se debe agregar el proyecto al server, esto se puede hacer tal como lo indica la figura 1.6 Figura 1.6: Agregando proyecto a server.

11 Una vez realizada todas las actividades anteriores, se puede levantar el proyecto, lo cual se debe hacer de la aplicación Web en WebContent->index.jsp clic derecho Run as->run on Server (figura 1.6) Figura 1.7 Levantando proyecto en Server.

12 1.2 Conectándolo con el Administrador de Contenidos Para conectarlo con el administrador de contenidos es muy simple, solamente se deben copiar algunas librerías, clases, archivos properties, archivos xml y los portlets correspondientes para ver el contenido. 1. Copiar las siguientes librerías (se pueden obtener de workspaceportaluchile/portaluchileweb/webcontent/web-inf/lib cuenta de weblogic102) WEB-INF/lib. a /WebContent /WEB-INF/lib del nuevo portal. a. axis.jar b. beehive-netui-core.jar c. commons-beanutils.jar d. commons-digester.jar e. hibernate2.jar f. jdom.jar g. netui-adapter.jar h. netui-pageflow.jar i. netui-scoping.jar j. oscache jan04.jar k. persona.jar l. render_taglib.jar m. struts-bean.tld n. struts-html.tld o. struts-logic.tld p. um_taglib.jar q. velocity-1.4.jar r. xerces.jar s. xml4j_1_1_9.jar t. yahoo_servlet.jar u. netuix_servlet.jar v. struts-adapter-html.tld w. struts-adapter.jar x. struts.jar 2. Copiar las clases compiladas que se encuentran en /WebContent/WEB-INF/classes a /WebContent/WEB-INF/classes del nuevo proyecto portal 3. Copiar los siguientes archivos tld desde /WebContent/WEB-INF a /WebContent/WEB-INF del nuevo portal. a. exesite.tld b. netui-tags-databinding.tld c. netui-tags-html.tld d. netui-tags-template.tld 4. Copiar la carpeta properties que se encuentra en WebContent a WebContent del nuevo portal. 5. Verificar que en el archivo exesite.properties que se encuentra dentro de properties de la carpeta copiada en el punto anterior, se encuentre direccionado al datasource de test o producción, esto es si esta descomentada la línea a. system.server.datasource=jdbc/dsportaluchiletest, significa conectado a Test b. system.server.datasource=jdbc/dsportaluchileprod, significa conectado a Producción. 6. Copiar desde src/ que se encuentra fuera de WebContent a src fuera de WebContent la carpeta cl, que contiene algunas clases fuente.

13 7. Modificar el archivo web.xml que se encuentra en /WebContent/WEB-INF agregando lo siguiente. <servlet> <servlet-name>initservlet</servlet-name> <servlet-class>cl.exe.util.initservlet</servlet-class> <init-param> <param-name>resourceclass</param-name> <param-value>/properties/resourceclass.properties</param-value> </init-param> <init-param> <param-name>logfile</param-name> <param-value>/properties/log.properties</param-value> </init-param> <init-param> <param-name>securityfile</param-name> <param-value>/properties/security.xml</param-value> </init-param> <init-param> <param-name>propertyfile</param-name> <param-value>/properties/exesite.properties</param-value> </init-param> <init-param> <param-name>cleanobject</param-name> <param-value>/properties/cleanobject.xml</param-value> </init-param> <init-param> <param-name>resourceprestaciones</param-name> <param-value>/properties/resourceprestaciones.properties</param-value> </init-param> <init-param> <param-name>hibernataconfig</param-name> <param-value>/properties/hibernate.cfg.xml</param-value> </init-param> <init-param> <param-name>applicationresource</param-name> <param-value>/properties/applicationresource.properties</param-value> </init-param> <load-on-startup>1</load-on-startup> </servlet> <servlet-mapping> <servlet-name>initservlet</servlet-name> <url-pattern>/initservlet</url-pattern> </servlet-mapping> <jsp-config> <taglib> <taglib-uri>/w EB-INF/exesite.tld</taglib-uri> <taglib-location>/web-inf/exesite.tld</taglib-location> </taglib> <taglib> <taglib-uri>netui-tags-template.tld</taglib-uri> <taglib-location>/web-inf/netui-tags-template.tld</taglib-location> </taglib> <taglib> <taglib-uri>netui-tags-databinding.tld</taglib-uri> <taglib-location>/web-inf/netui-tags-databinding.tld</taglib-location> </taglib> <taglib> <taglib-uri>netui-tags-html.tld</taglib-uri>

14 <taglib-location>/web-inf/netui-tags-html.tld</taglib-location> </taglib> <taglib> <taglib-uri>/w EB-INF/struts-bean.tld</taglib-uri> <taglib-location>/web-inf/lib/struts-bean.tld</taglib-location> </taglib> <taglib> <taglib-uri>/w EB-INF/struts-html.tld</taglib-uri> <taglib-location>/web-inf/lib/struts-html.tld</taglib-location> </taglib> <taglib> <taglib-uri>/w EB-INF/struts-logic.tld</taglib-uri> <taglib-location>/web-inf/lib/struts-logic.tld</taglib-location> </taglib> <taglib> <taglib-uri>um.tld</taglib-uri> <taglib-location>/web-inf/lib/um_taglib.jar</taglib-location> </taglib> <taglib> <taglib-uri>render.tld</taglib-uri> <taglib-location>/web-inf/lib/render_taglib.jar</taglib-location> </taglib> </jsp-config> 8. En la consola de administración del dominio se deberá crear un datasource el cual deberá ser según sea el ambiente de test o producción, como hacerlo se detalla a continuación a. Creación de los Data Source Figura. 1.8 Creación de Data Source

15 En los parámetros del Data Source se debe incorporar lo siguiente Name JNDI Name Database Type Database Driver TEST jdbc/dsportaluchiletest jdbc/dsportaluchiletest Oracle Oracle Presionar Next. Figura 1.9: Creación de Data Source

16 Fig. 1.10: Creación de Data Source Ingresar los siguientes valores: TEST Database name orcl Database host Ip server DBMS port 1521 User name usuario Password Luego presionar next, realizar el Test de Conection, presionar next hasta vincularlo al adminserver.

17 Fig. 1.11: Creación de Data Source 9. Para la instalación del portlet login, se puede descargar el archivo desde 275/nbrresults/47 y realizar los siguientes pasos desde el worskpacestudio. a. Right-click on the Portal Web Project b. Select Import > Import. c. Expand General. d. Select Archive File. e. Click Next. f. Click Browse. g. Select the Login portlet downloaded above. h. Click Open. i. Click Finish.

18 1.3 Creando Look and Feel Para crear un nuevo Look and Feel tomaremos como base uno ya existente, que es lo recomendado por BEA y en este caso será el Look and Feel bighorn, para esto se debe ir dentro del WorkSpace Studio en Merged Projects a las siguientes rutas 1. Proyecto Web->frameworks->skeletons y copiar las carpetas bighorn y bighorn-templates, esto es click derecho sobre las carpetas y marcar la opcion copy to Project, figura 1.1 Figura 1.12 Copiando skeletons bighorns a proyecto. 2. Proyecto Web->frameworks->skins y copiar las carpetas bighorn y bighorn-templates, esto es click derecho sobre las carpetas y marcar la opcion copy to Project, figura 1.2 Figura 1.13 Copiando skins bighorns a proyecto.

19 3. Ahora volviendo a las vista de Project Explorer, dentro de ProyectoWeb->WebContent->framework, se puede apreciar el skeletons y el skins que se ha copiado, ahora crearemos un look and feel, para esto se deberán hacer los siguientes pasos. a. En ProyectoWeb->New->lookandfeel, y ingresar datos de titulo y descripción de este, también nos dice donde quedaran los archivos asociados de skin y skeletons, como estamos trabajando en base al look and feel bighorn, es que dejaremos la que trae por defecto, y luego renombraremos las carpetas. Figura 1.14: Creación de look and feel. b. Renombras las carpetas bighorn y bighorn-tempate que se encuentran dentro de skins y de skeletons, por un nombre acorde al proyecto, ejemplo prueba y prueba-template c. Editar el archivo de lookandfeel creado en el punto a y cambiar el nombre de las carpetas bighorntemplates del archivo, por la de nuestro look and feel, ejemplo prueba-template Así esta skin="bighorn-template" skinpath="/framework/skins/" skeleton="bighorn-template" skeletonpath="/framework/skeletons/" debe quedar skin="prueba-template" skinpath="/framework/skins/" skeleton="prueba-template" skeletonpath="/framework/skeletons/"

20 Para editar el archivo.laf ir a la opción Open With->XML Editor, figura 1.4 Figura 1.15 Editando archivo.laf. d. Cambiar el nombre fisico de las carpetas bighorn y bighorn-tempate que se encuentran dentro de las carpetas skeletons y skins, es decir para nuestro look and feel quedaria lo siguiente. bighorn por prueba bighorn-template por prueba-template Esto es tanto para las carpetas de skeletons y skins. e. En WorkSpace Studio actualizar el proyecto web. 4. Para agregar una nueva hoja de estilos al proyecto se deben seguir los siguientes pasos. a. Copiar la hoja de estilos dentro de ProyectoWeb->WebContent->framework->skins->prueba->CSS, en este caso será prueba.css b. Dentro de ProyectoWeb->WebContent->framework->skins->prueba-template, editar los archivos skins.xml, que se encuentra en la raíz de prueba-template y dentro de la carpeta msie (Microsoft Internet Explorer), reemplazando donde dice bighorn por prueba(para efectos de este ejemplo),de manera de cambiar la ruta hacia nuestras carpetas y agregar la hoja de estilos dentro del tags links, esto es.. <links>.. <link href="prueba.css" rel="stylesheet" type="text/css" /> </links>..

21 5. Por ultimo se debe vincular el Nuevo look and feel al portal, esto es en las propiedades del portal, figura 1.5 Figura 1.16: Asignando nuevo look andfeel 6. Para agregar un archivo javascript, seguir los siguientes pasos a. Copiar el archivo js dentro de ProyectoWeb->WebContent->framework->skeletons->prueba->js, en este caso será prueba.js b. Dentro de ProyectoWeb->WebContent->framework->skeletons->prueba-template, editar los archivos skins.xml, que se encuentra en la raíz de prueba-template y dentro de la carpeta msie (Microsoft Internet Explorer), reemplazando donde dice bighorn por prueba(para efectos de este ejemplo),de manera de cambiar la ruta hacia nuestras carpetas y agregar el archivo js dentro del tags scripts, esto es..... <scripts> <script src="prueba.js" type="text/javascript"/>.. </scripts>

22 2.- Etapa Producción Administración de portal Una vez que el usuario se haya logeado se mostrará la siguiente página de inicio: (ver Figura 2.1) Figura 2.1: Página de administración del portal. En esta página se encuentra un menú donde aparecen diversas opciones entre ellas: 1. Administración de Portales. 2. Administración de Usuarios. 3. Administración de Grupos. 4. Delegar Administración. 5. Privilegios de Usuario. 6. Proveedores de Seguridad. 7. Administrador de Contenidos 8. Campañas. 9. Placeholders. 10. Segmentos. 11. Selectores de contenido.

23 2.1.1 Administración de Portales Los ítems para llevar a cabo la administración de portales son los siguientes: Nombre Item Crear Portal. Crear Desktop. Crear Libro. Crear Página. Incorporación de Portlets. Nota Componente que permite agregar desktop s. Si el Portal ya esta creado pasar a Crear Desktops Componente que permite incorporar Libros, Páginas. Si el Desktop esta creado pasar a Crear Libro Componente que permite agregar páginas. Si el libro ya esta creado pasar a Crear Página Componente que permite agregar Portlets. Si la página ya esta creada pasar a Incorporación de Portlet Componentes reutilizables para incorporar en páginas Creación de Portales Los siguientes pasos, son necesarios para las creaciones y modificacion de Desktops. 1.- Hacer clic en el menú Portal Management de la Consola de Administración. -La página asociada al menú Portal Management mostrará un explorador de recursos en el lado izquierdo (ver figura 2.2). Figura 2.2: Explorador de recursos. Se debe tener en cuenta que lo mostrado en la pantalla se basa en lo que se desarrollo anteriormente. Si se amplia Library se mostrarán los portlets que se hayan creado o agregado en desarrollo. 2.- Hacer clic en Portals ubicado en el explorador de recursos. - Como no existe ningún Portal creado, la tabla que contiene los portales esta vacía.

24 3.- Hacer clic en Create New Portal, se abrirá un cuadro de dialogo (ver figura 2.3). Figura 2.3: Create a New Portal. 4.- Ingresar los valores para el portal, usar la siguiente tabla como referencia: Campo Valor Portal Name mybeaportal (nombre del portal) Description general BEA Portal ( Descripción del portal) Partial URL mybeaportal (Url parcial ) URI (default resource) (dejar en blanco) 5. - Hacer clic en Create New Portal. Cuando la pagina de Portals se muestre de nuevo, la tabla que contiene los Portals incluirá el portal que se haya creado, y el explorador de recursos de portal incluirá el nuevo portal. 6.- Hacer clic en mybeaportal para ver en detalle el portal. Como no existe ningún Desktop creado, la tabla que contiene los Desktop esta vacía.

25 Crear Un Desktop 1. - Hacer clic en Create New Desktop. El asistente de creador de Desktop se mostrara de la siguiente forma (ver figura 2.4): Figura 2.4: Asistente de creación de Desktop.

26 2.- Ingresar los valores para el desktop en el asistente de creación de desktops. Para esto usar la siguiente tabla como guía: Campo o selección Valor/Descripción Paso 1: Seleccionar como se desea crear el Desktop 1. Seleccionar la opción.portal 2. Hacer clic en Next Paso 2: Seleccionar un archivo.portal 1. Hacer clic en Show All 2. Seleccione el archivo.portal de la aplicación base con el que se trabajará. 3. Hacer clic en Next. Paso 3: Ingrese las propiedades del Desktop Title El tiltulo que desee ingresar en este caso mydesktop. Description Una descripción general del desktop. Partial URL Url parcial con la que se conocerá el desktop, en este caso desktop1. Default Shell (dejar como está) Look and Feel Seleccionar el que se creo en la etapa de desarrollo para el nuevo portal. 3.- Hacer clic en Finish para retornar a la página principal donde se encuentra la consola de administración. La tabla de navegador de desktops incluirá el desktop creado, y el explorador de recursos del portal incluirá el nuevo desktop (ver Figura 2.5). Figura 2.5: Nuevo Desktop en el explorador de recursos.

27 Creación de Libros o Books Para la creación de un libro es necesario seguir los siguientes pasos: 1.- Una vez creado el Desktop, en el explotador de recursos aparece el Main page book que se crea con todo dekstop, hacer clic en Main page book. Aparecerá un navegador para poder agregar libros o paginas según se desee. (Ver figura 2.6). Figura 2.6: Navegador para agregar libros o páginas. 2. Hacer clic en el botón Add New Book para agregar un nuevo libro, aparecerá un cuadro de dialogo para el ingreso de las propiedades (ver figura 2.7). Figura 2.7: Cuadro De dialogo para la creación de libros.

28 3. Ingresar los datos en los campos usando como Guía la siguiente tabla: Campo Title Description Menú Theme Hidden Valor newbook (Título del libro) Descripción newbook (Descripción del libro) None None (define estilos particulares) Sin seleccionar 4.- Una vez creado el nuevo libro, este aparecerá en el explorador de contenidos. (Ver figura 2.8). Figura 2.8: Explorador de recursos con el nuevo libro incluido.

29 Creación de páginas Para crear o modificar nuevas páginas para el desktop seguir los siguientes pasos: 1.- En el explorador de recursos del portal, expandir Library para mostrar las páginas. (Ver figura 2.9). Figura 2.9: Library expandida. 2.- Hacer clic en Pages para mostrar la pestaña asociada a las páginas (ver Figura 2.10) Figura 2.10: Pestaña asociada al navegador de páginas.

30 3.- Hacer clic en Create New Page. Aparecerá una cuadro de dialogo (ver Figura 2.11). Si la página a la cual se desean agregar elementos ya existe, ir al capitulo de Creación de Libros o Incorporación de Portlets a la página. Figura 2.11: Cuadro de dialogo para la creación de paginas. 4.- Ingresar los valores para la nueva página guiándose por la siguiente tabla: Campo Title Description Layout Theme Hidden Valor/Descripción Tutorial Page ( Nombre de la nueva página) new page for tutorial (Descripción de la pagina) (Forma en que se dispondrán los elementos en la página) None ( define estilos particulares) Sin seleccionar

31 5.- Hacer clic en Create. La nueva página es añadida, se puede ver actualizando el explorador de recursos. (Ver Figura 2.12). Figura 2.12: Página creada.

32 Incorporación de Portlets a) Para incorporar Portlets sin preferencias a una página se deben realizar los siguientes pasos: 1.- Seleccionar la página a la cual se incorporará el portlet (ver figura 2.13). Figura 2.13: Página a la cual se le incorporará el portlet. 2.- Hacer clic en el botón Add Page Contents para incorporar un portlet (ver Figura 2.14). Figura 2.14: Add page Contents.

33 3.- Hacer clic en Add Contents (en la posición que se desee) para incorporar el portlet que se desee (ver figura 2.15). Al seleccionar el portlet, presionar add y save el portlet estará incorporado en la página. Figura 2.15: A d d Contents. 4.- Una vez agregado el portlet a la pagina, presionar Save para que los cambios queden registrados en el portal (ver figura 2.16). Figura 2.16: Guardar los cambios en el portal.

34 5.- Para ver el portlet incorporado en la pagina, expanda Page 1 (ver figura 2.17). Figura 2.17: Portlet incorporado. b) Para incorporar Portlets con preferencias (ej. Portlet Noticias) realizar los siguientes pasos: 1.- Repetir los pasos del 1 al 5 de la incorporación de portlets sin preferencias. 2.- Hacer clic en el portlet, aparecerá una página donde se podrán editar las preferencias del portlet agregado en la etapa de desarrollo (En este caso Portlet Noticias). (Ver figura 2.18). Figura 2.18: Página de modificación de valores de preferencias.

35 3.- Hacer clic en Add Portlet Preferences (ver figura 2.19). Figura 2.19: Add Portlet Preferences. 4.- Usar la siguiente tabla como guía para ingresar o modificar las preferencias: Campo Name Description Values Is modifiable? Is multi-valued? Valor Categoría (nombre de la preferencia a la que se agregará el valor) Categoría de noticias (Descripción de la preferencia a agregar) Estudiantes Sin seleccionar (Definir si la preferencias será modificable o no) Sin seleccionar (Definir si la preferencias tendrá múltiples valores o no)

36 Glosario. Portal Frameworks Look and Feel Skin Layout Portal Libro Página Portlets Preferencias Desktop