Manual de usuario de WebSphere Portlet de Dashboards

SAP BusinessObjectsVersión del documento: 4.2 – 2015-11-12

Manual de usuario de WebSphere Portlet de Dashboards

Contenido

1 Historial de documentos. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

2 Acerca de este manual. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4

3 Introducción. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53.1 Conceptos clave. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5

Portlet de WebSphere de Dashboards. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Conexiones de datos de Dashboards. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5Datos de Dashboards en el portlet de WebSphere de Dashboards. . . . . . . . . . . . . . . . . . . . . . . . . . .8

3.2 Herramientas clave. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9Utilidad de generación de portlet de Dashboards. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9

3.3 Convenciones de nomenclatura. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10Variables. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10

4 Crear un WebSphere Portlet de Dashboards. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .114.1 Para crear un portlet de WebSphere de Dashboards. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114.2 Para configurar la utilidad de generación de portlet de Dashboards. . . . . . . . . . . . . . . . . . . . . . . . . . . . 11

5 Utilizar WebSphere Portlet de Dashboards. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 145.1 Modificar los parámetros de portlet de WebSphere de Dashboards. . . . . . . . . . . . . . . . . . . . . . . . . . . 145.2 Para configurar la configuración entre portlets de WebSphere de Dashboards. . . . . . . . . . . . . . . . . . . .14

2© 2015 SAP SE o una empresa filial de SAP. Reservados todos los derechos.

Manual de usuario de WebSphere Portlet de DashboardsContenido

1 Historial de documentos

En la siguiente tabla se ofrece información general sobre los cambios más importantes del documento.

Versión Fecha Descripción

SAP BusinessObjects Dashboards 4.1 Agosto de 2012 Versión inicial.

SAP BusinessObjects Dashboards 4.2 Noviembre de 2015 Se ha actualizado la guía con modificaciones de marca.

Manual de usuario de WebSphere Portlet de DashboardsHistorial de documentos

© 2015 SAP SE o una empresa filial de SAP. Reservados todos los derechos. 3

2 Acerca de este manual

Esta guía está pensada para usuarios de Business Intelligence que necesitan crear portlets de WebSphere de Dashboards a partir de una variedad de modelos de Dashboards en un entorno empresarial.

Para obtener más información sobre las funciones y las características, consulte el Manual del usuario de Dashboards y Presentation Design.


Manual de usuario de WebSphere Portlet de DashboardsAcerca de este manual

3 Introducción

3.1 Conceptos clave

3.1.1 Portlet de WebSphere de Dashboards

Un portlet de WebSphere de Dashboards le permite integrar un modelo de Dashboards (en formato .swf) con un servidor de portal. Puede modificar los parámetros predeterminados del portlet y permitir que múltiples portlets se comuniquen entre ellos.

Debe crear un portlet nuevo para cada modelo que publique en un portal. Entonces, puede utilizar una cuenta con credenciales de administrador para instalar su portlet.

NotaEl portlet analizado en esta guía es un modelo que puede utilizar para crear portlets nuevos.

3.1.1.1 Integración

El portlet de WebSphere de Dashboards cumple con el estándar JSR 168. Sin embargo, aunque se puede desplegar en cualquier servidor de portal, solo los portales de IBM WebSphere admiten comunicación entre portlets.

NotaPara un mejor rendimiento, desplegue el portlet en IBM WebSphere Portal 5.1.

Para obtener más información, consulte la documentación siguiente:

● Información y documentación de producto de WebSphere Portal en el portal de soporte técnico de IBM

● Documentación de kits de integración de portal en el SAP Support Portal (haga clic en Release & Upgrade Info Installation & Upgrade Guides SAP BusinessObjects SAP BusinessObjects Business Intelligence (BI)

Portal Integration Kits )● Java™ Authentication and Authorization Service (JAAS) Reference Guide for the Java™ 2 SDK, Standard Edition,

v 1.4

3.1.2 Conexiones de datos de Dashboards

Cuando crea un modelo de Dashboards, puede establecer una conexión de datos de portal o una conexión de servicio web. Puede acceder a estas conexiones en el administrador de datos de Dashboards.

Manual de usuario de WebSphere Portlet de DashboardsIntroducción


Existen tres tipos de conexión de datos de portal: proveedor, consumidor y ningún (parámetro)

NotaUn modelo individual puede contener un número ilimitado de ningún (parámetro) y conexiones de servicio web, porque estas conexiones son independientes de los consumidores y proveedores. Sin embargo, un modelo puede contener una conexión de datos de proveedor, una conexión de datos de consumidor o ninguna. Además, un modelo debe tener como mínimo una conexión de datos de portal.

3.1.2.1 Conexiones de datos del portal

3.1.2.1.1 Conexiones de datos del proveedor

Existen tres conexiones de datos del proveedor:

● Los proveedores de celdas transmiten los valores de una celda individual.● Los proveedores de filas transmiten los valores de un grupo de celdas de una dimensión.● Los proveedores de tablas transmiten los valores de un grupo de celdas de dos dimensiones.

3.1.2.1.2 Conexiones de datos del cliente

Existen tres conexiones de datos del consumidor:

● Los consumidores de celdas asignan datos a una celda individual.● Los consumidores de filas asignan datos a un grupo de celdas de una dimensión (horizontal o vertical).● Los consumidores de tablas asignan datos a un grupo de celdas de dos dimensiones.

Este es un ejemplo de rangos para un consumidor de celdas (a), un consumidor de filas (b) y un consumidor de tablas (c).

NotaEn el caso de los consumidores de filas, el rango puede ser horizontal (b) o vertical (d).



Figura 1:Rangos para conexiones de datos del consumidor

3.1.2.1.3 Conexiones de datos de ningún (parámetro)

Para modificar los valores de su modelo Dashboards, puede introducir Modo de edición en el portlet de WebSphere de Dashboards e introducir parámetros.

NotaLos parámetros se deben enlazar con una celda de una hoja de cálculo. Cuando enlaza un parámetro a una celda, el parámetro recibe un valor predeterminado. Si la celda está vacía, el valor predeterminado del parámetro es cero.

Hay varios tipos distintos de parámetros.

● text● number● check box● date● list box

El valor esperado para check box es (-1) para seleccionado y (null) para no seleccionado. Aunque cada parámetro tiene un valor esperado, puede asignar distintos valores a los parámetros.

Información relacionada

Modificar los parámetros de portlet de WebSphere de Dashboards [página 14]



3.1.2.1.3.1 Información de usuario en conexiones de datos de ningún (parámetro)

Si un parámetro text incluye un valor especial, el parámetro se sustituye por información sobre el usuario de portal que utiliza el portlet de WebSphere de Dashboards. Esta funcionalidad le permite personalizar un modelo de Dashboards (por ejemplo, insertando un nombre de usuario en un mensaje de bienvenida).

NotaLos parámetros con nombres que empiezan con USER_INFO no aparecen cuando el portlet de WebSphere de Dashboards se encuentra en modo edición. Para evitar sustituir un parámetro con datos de usuario, evite incluir USER_INFO en el nombre de parámetro.

El portlet admite los siguientes valores especiales:

● USER_INFO.user.name.given● USER_INFO.user.name.family● USER_INFO.user.name.prefix● USER_INFO.user.name.middle● USER_INFO.user.name.employer● USER_INFO.user.name.department

RestricciónAlgunos portales tienen campos que no contienen valores especiales. Para obtener más información sobre los valores especiales admitidos por el registro de usuario en su portal, póngase en contacto con su administrador de portal.

3.1.2.2 Conexiones de servicio

Su modelo de Dashboards puede recibir datos de servicios web. Si el servicio web es una conexión de consulta de servicio web (consulta como un servicio web), su modelo conectará con el servidor plataforma SAP BusinessObjects Business Intelligence especificado en el URL de la conexión de consulta de servicio web.

3.1.3 Datos de Dashboards en el portlet de WebSphere de Dashboards

Los datos en su modelo de Dashboards se ponen en contacto con el portlet de WebSphere de Dashboards de los siguientes modos:

● Se transmiten entre portlets conectados físicamente.

NotaEl portlet no modificar los datos transmitidos.



● El usuario establece los datos para parámetros en el modo de edición del portlet.

Los proveedores y consumidores de datos del portal intercambian datos en formato XML.

EjemploDatos en formato XML

<data> <row> <column> DATA </column> </row> </data>

<data> <row> <column> DATA </column> <column> DATA </column> <column> DATA </column> </row> </data>

<data> <row> <column> DATA </column> <column> DATA </column> </row> <row> <column> DATA </column> </row> </data>

Los datos que recibe su modelo están establecidos como una variable .swf.

Para consumidores, el portlet no impone restricciones en el emisor de datos. Sin embargo, para transmitir datos entre un portlet de WebSphere de Dashboards y otro tipo de portlet, debe ajustar sus datos al mismo formato XML. La comunicación entre distintos tipos de portlet se debe establecer de forma similar a la comunicación entre portlets de WebSphere de Dashboards.


Conexiones de datos de ningún (parámetro) [página 7]Para configurar la configuración entre portlets de WebSphere de Dashboards [página 14]

3.2 Herramientas clave

3.2.1 Utilidad de generación de portlet de DashboardsLa utilidad de generación de portlet de Dashboards puede crear portlets de WebSphere de Dashboards para su modelo de Dashboards. La utilidad empaqueta los portlets en ficheros (.war) de archivo de aplicación web. Puede instalar los archivos .war en un servidor de portal.

La utilidad se encuentra en <PIKPORTALDIR>\XCelsiusPortletGenerationUtility_win32.zip

NotaNecesita Java Runtime Environment 1.4.2 (o posterior) para ejecutar la utilidad.




Variables [página 10]Para crear un portlet de WebSphere de Dashboards [página 11]Para configurar la utilidad de generación de portlet de Dashboards [página 11]

3.3 Convenciones de nomenclatura

3.3.1 Variables

Este manual usa las siguientes variables:

Variable Descripción

<PIKPORTALDIR> El directorio en el que se encuentran los archivos necesarios en los medios de Dashboards.

D:\Portal Integration Kits\WebSphere Portal



4 Crear un WebSphere Portlet de Dashboards

4.1 Para crear un portlet de WebSphere de Dashboards

1. Extraiga los contenidos de <PIKPORTALDIR>XCelsiusPortletGenerationUtility_win32.zip2. Ejecute XcelsiusPortletCreationUtility.bat.

Aparece la página Utilidad de generación de portlet de Dashboards - Paso 1 de 23. Haga clic en Navegar al lado del campo Archivo SWF y seleccione su modelo de Dashboards (.swf).

NotaAsegúrese de que modelo contiene conexiones de datos de portal.

4. Haga clic en Navegar al lado del campo Carpeta de destino y seleccione la ubicación para su fichero (.war) de archivo de aplicación web y después haga clic en Siguiente.Aparece la página Utilidad de generación de portlet de Dashboards - Paso 2 de 2 que muestra los valores sugeridos para cada campo. Para obtener más información sobre los campos, consulte la sección «Para configurar la utilidad de generación de portlet de Dashboards».

5. Si es necesario, modifique los valores y haga clic en Finalizar.La utilidad empieza a generar el portlet. Cuando el proceso se ha completado, aparece la página Utilidad de creación de portlet de Dashboards - FINALIZADO.

6. Anote la ubicación del nuevo portlet y haga clic en Aceptar.


Variables [página 10]Conexiones de datos de Dashboards [página 5]

4.2 Para configurar la utilidad de generación de portlet de Dashboards

Puede configurar los ajustes predeterminados de la utilidad de generación de portlet de Dashboards.

1. Extraiga XcelsiusPortletCreationUtility.properties del archivo .jar incluido en el archivo <PIKPORTALDIR>\XCelsiusPortletGenerationUtility_win32.zip y abra el archivo .properties en un editor de texto.

Manual de usuario de WebSphere Portlet de DashboardsCrear un WebSphere Portlet de Dashboards


2. Edite los valores para los campos (son los mismos valores que aparecen en la página Utilidad de generación de portlet de Dashboards - Paso 2 de 2).

Tabla 1:

Campo Descripción Muestra

Portlet Id La cadena de identificación interna utilizada por el portal IBM WebSphere. Puede introducir letras, números, períodos (.) y caracteres de subrayado (_).

xcelsiusportlet.RowProvider.1197315029777

Portlet Name El nombre de portlet. Este nombre también determina el nombre de la aplicación web que genera la utilidad. Puede introducir letras, números, períodos (.) y caracteres de subrayado (_).

RowProvider

Display Name El nombre aparece cuando el portlet se visualiza.

RowProvider

Portlet Title El título del portlet se visualiza en la barra de título del portlet.

RowProvider Portlet

Portlet Short Title Se debe utilizar el título breve del portlet en vez del título de portlet. Se puede utilizar en lugar del Portlet Title.

RowProvider

Portlet Description La descripción del portal se muestra en la página Administración de portal

NotaMantenga esta descripción lo más breve posible.

Portlet wrapping Dashboards file RowProvider.swf

Portlet Keywords Las palabras clave que describen el portlet.

swf, Dashboards, RowProvider, RowProvider.swf

NotaPortlet Title, Portlet Short Title y Portlet Keywords dependen de la configuración regional.

3. (Opcional) Edite el valor del nombre de archivo de aplicación web de plantilla.

PrecauciónNo edite las reservas-espacio de la aplicación web de plantilla para valores especiales. Puede ser que la aplicación no pueda crear portlets si la aplicación web de plantilla se daña.

4. Guarde los cambios en XcelsiusPortletCreationUtility.properties.

Si necesita una aplicación web de plantilla diferente (para editar el texto o la disposición de sus páginas JavaServer (JSP) del portlet de WebSphere de Dashboards o añadir idiomas admitidos), debe hacer una copia de template.war incluido en el fichero .jar.




Variables [página 10]



5 Utilizar WebSphere Portlet de Dashboards

5.1 Modificar los parámetros de portlet de WebSphere de Dashboards

Varios parámetros de su portlet de WebSphere de Dashboards aparecen como campos de entrada HTML cuando el portlet está en modo de edición.

Tipo de parámetro Control HTML

Text Campo de entrada

Number Campo de entrada

Date Campo de entrada

Check Box Casilla de verificación

List Box Cuadro desplegable

NotaLos portlets tienen el alto y el ancho predeterminados de los modelos Dashboards (archivos .swf) que contienen. El complemento de Adobe Flash Player permite que su explorador web muestre estos archivos.

5.2 Para configurar la configuración entre portlets de WebSphere de Dashboards

Tiene que configurar su portlet de WebSphere de Dashboards solo si tiene que activar la comunicación entre portlets.

NotaAsegúrese de que la conexión de su proveedor y consumidor sea correcta: permita que los proveedores de celdas se comuniquen con los consumidores de celdas; permita que los proveedores de filas se comuniquen con los consumidores de filas; permita que los proveedores de tablas se comuniquen con los consumidores de tablas.

1. Inicie sesión en su portal de IBM WebSphere con una cuenta que tenga permiso para editar páginas y haga clic en Administración.Aparece la página Administrar páginas.

2. Seleccione la página en la que ha publicado sus portlets y haga clic en Editar.Aparecerá la página Edición.


Manual de usuario de WebSphere Portlet de DashboardsUtilizar WebSphere Portlet de Dashboards

3. Haga clic en Conexiones y seleccione las conexiones de las siguientes listas:

Conexión Descripción

Portlet de origen El portlet que contiene el proveedor.

Enviar El campo que desea enviar.

Página destino La página donde se publica su portlet de consumidor.

Portlet de destino El portlet que contiene los consumidores.

Recibir El campo que desea recibir.

Tipo de conexión El tipo de conexión que desea utilizar.

NotaLos portlets de WebSphere de Dashboards solo tienen una opción disponible para las conexiones Enviar y Recibir.

4. Haga clic en Añadir.El portal crea las conexiones. Ahora sus portales pueden comunicarse entre ellos.

5. Haga clic en Listo.

RecuerdeWebSphere no distingue entre portlets de proveedor y de consumidor. Los portlets que contienen solo consumidores pueden aparecer en la lista Portlet de origen y los portlets que contienen solo proveedores pueden aparecer en la lista Portlet de destino.


Conexiones de datos de Dashboards [página 5]Conexiones de datos del proveedor [página 6]Conexiones de datos del cliente [página 6]

Manual de usuario de WebSphere Portlet de DashboardsUtilizar WebSphere Portlet de Dashboards


Limitaciones de responsabilidad y aspectos legales

Ejemplos de codificaciónCualquier codificación de software y/o líneas de códigos / cadenas ("Código") incluidas en esta documentación son solo ejemplos y no se prevé que se utilicen en un entorno de sistema productivo. El Código tiene el único propósito de explicar y permitir la visualización de las reglas de sintaxis y de asignación de frases de cierta codificación. SAP no ofrece garantías respecto a la exactitud y la integridad del Código disponibilizado en este documento y no será responsable de errores o daños causados por el uso del Código, a menos que los daños sean causados por SAP de forma intencional o por una imprudencia grave por parte de SAP.

AccesibilidadLa información contenida en la documentación de SAP representa la visión actual de SAP de los criterios de accesibilidad a partir de la fecha de publicación. No se prevé que sea una directriz vinculante sobre cómo garantizar la accesibilidad de los productos de software. SAP renuncia a cualquier responsabilidad en relación con este documento. Sin embargo, este documento no se aplica en casos de un error deliberado o una negligencia grave por parte de SAP. Además, este documento no supone ningún compromiso u obligación contractual directos o indirectos.

Lenguaje neutro respecto al géneroSiempre que sea posible, la documentación de SAP es neutra respecto al género. Dependiendo del contexto, se trata al lector directamente de "usted" o se utiliza un nombre neutro respecto al género (como "vendedor/a" o "días laborables"). Sin embargo, si al referirse a los miembros de ambos sexos, no se puede evitar el uso de la tercera persona del singular o no existe un nombre neutro respecto al género, SAP se reserva los derechos para utilizar la forma masculina del nombre o pronombre. Esto es para garantizar que la documentación sea comprensible.

Hipervínculos de InternetLa documentación de SAP puede contener hipervínculos a Internet. Se prevé que estos hipervínculos sirvan como un consejo acerca de dónde encontrar la información relacionada. SAP no garantiza la disponibilidad y la exactitud de esta información relacionada o la capacidad que esta información sirva un objetivo en particular. SAP no es responsable de ningún daño causado por el uso de la información relacionada a menos que los daños se hayan causado por una imprudencia grave o por una conducta fraudulenta dolosa por parte de SAP. Todos los enlaces están categorizados para su transparencia (consulte: http://help.sap.com/disclaimer).


Manual de usuario de WebSphere Portlet de DashboardsLimitaciones de responsabilidad y aspectos legales

http://help.sap.com/disclaimer/

Manual de usuario de WebSphere Portlet de DashboardsLimitaciones de responsabilidad y aspectos legales


www.sap.com/contactsap

© 2015 SAP SE o una empresa filial de SAP. Reservados todos los derechos.Queda prohibida la reproducción o transmisión de cualquier parte de esta publicación, en cualquier forma o para cualquier fin, sin el permiso expreso de SAP SE o de una empresa filial de SAP. La información que aquí se incluye puede modificarse sin previo aviso.Algunos productos de software comercializados por SAP SE y sus distribuidores contienen componentes de software con derechos de autor de otros proveedores de software. Las especificaciones de productos en cada país pueden ser diferentes.SAP SE o una empresa filial de SAP SE proporcionan estos materiales con fines meramente informativos, sin manifestación ni garantía de ningún tipo. Ni SAP SE ni sus empresas filiales se hacen responsables de los errores u omisiones en relación con los materiales. Las únicas garantías para los productos y servicios de SAP SE o de sus empresas filiales son aquellas especificadas en las cláusulas expresas de garantía que acompañan a dichos productos y servicios, si las hubiera. Nada de lo que se incluye en este documento debe interpretarse como garantía adicional.SAP y los productos y servicios de SAP mencionados, así como sus respectivos logotipos, son marcas comerciales o marcas registradas de SAP SE (o de una empresa filial de SAP) en Alemania y en otros países. Todos los nombres y servicios de productos son las marcas comerciales de sus respectivas empresas.Consulte http://www.sap.com/corporate-en/legal/copyright/index.epx para obtener información y avisos adicionales sobre marcas comerciales.

http://www.sap.com/contactsap

http://www.sap.com/corporate-en/legal/copyright/index.epx

http://www.sap.com/corporate-en/legal/copyright/index.epx

Documents

Manual de usuario de WebSphere Portlet de Dashboards