Creación y uso de widgets › Incrustación de widgets para solicitar servicios y gestionar solicitudes › Uso del widget Estado y de otros widgets para permitir que los usuarios accedan a las solicitudes › Uso de los widgets Estado y Lista de solicitudes para permitir que los gestores aprueben y rechacen solicitudes › Llamada del widget Estado mediante código fuente

Llamada del widget Estado mediante código fuente

En Liferay, se puede llamar al widget Estado creando el portlet y especificando el código fuente. Revise los pasos siguientes para producir el anterior ejemplo del widget Estado. Sígalos como modelo para configurar la visualización y el comportamiento del widget Estado en su implementación.

Siga estos pasos:

1. En la página del portal, realice estas acciones para crear el portlet:
   1. Haga clic en Add, Web Content Display.
   2. Haga clic en el icono del signo más (Add, Web Content).

      Aparecerá ventana New Web Content.

   3. Especifique los campos obligatorios y cierre la ventana.

   El portlet nuevo se agrega a Liferay.

2. Haga clic en Edit Controls en la parte superior de la página.
3. Pase el ratón sobre el portlet, y haga clic en el icono de lápiz (Edit Web Content).

   Aparecerá la configuración del portlet.

4. En la ventana Contenido, haga clic en Fuente.

   El contenedor Fuente se abre para editarlo.

5. Revise los parámetros clave y la fuente siguientes del anterior ejemplo del widget Estado. Utilícelos como modelo para especificar la fuente.
6. Realice las siguientes acciones:
   • Cierre el contenedor Fuente.
   • Publique y revise el portlet actualizado.
   • Si es necesario, cambie las especificaciones para que el widget se adecue a sus requisitos.

Parámetros clave y fuente

La fuente del ejemplo de widget Estado es la siguiente:

<script type="text/javascript" src="http://hostname:portnumber/usm/explorer/scripts/status.widget.js"></script>

<script> CA_Catalog.buildWidget({type: 'status', login credentials, renderTo: 'status1', businessUnit:"London222",  layout:'layout-2', openIn: '_widget', hideCart: true} ); </script>

<div align="center" id="status1" style="width: 400px; margin-bottom: 10px; height: 100px">

	&nbsp;</div>

La primera línea hace referencia el archivo de JavaScript del widget Estado.

La segunda línea especifica el JavaScript con los parámetros de configuración del widget Estado.

Nota: Separe los parámetros con una coma, pero no incluya una coma después del último parámetro.

La tercera línea especifica el elemento DOM en el que se presenta el widget Estado.

Los parámetros clave y las explicaciones siguientes son para la función llamada CA_Catalog.buildWidget del widget Estado de ejemplo.

Credenciales de inicio de sesión

Se recomienda el inicio de sesión de individuo para los widgets. Sin embargo, si se requieren credenciales de inicio de sesión para este widget, especifíquelas en esta llamada de función. Utilice el siguiente formato:

nombre de usuario: 'username', contraseña: 'password'

type:"status"

Especifica que el widget es un widget Estado.

renderTo:"status1"

Especifica que el widget se presenta en el elemento de DOM cuyo ID es status1.

businessUnit:"London222"

Especifica la unidad de negocio a la cual los usuarios del catálogo pueden acceder mientras utilizan el widget Estado. Para esta unidad de negocio y las unidades de negocio que se encuentran debajo de la misma, los usuarios pueden consultar el estado de las solicitudes a las que tienen permiso:

• Los usuarios que no son gestores de solicitudes solamente pueden consultar el estado de sus propias solicitudes.
• Los gestores de solicitudes pueden consultar el estado tanto de sus propias solicitudes como el de las solicitudes con acciones pendientes asignadas a ellos.

Si se especifica la unidad de negocio raíz, los usuarios pueden consultar el estado de las solicitudes en todas las unidades de negocio, incluyendo la unidad de negocio raíz. Contrariamente, si se especifica el nombre de la unidad de negocio de nivel más bajo, los usuarios del catálogo solo pueden consultar el estado de las solicitudes de esa unidad de negocio.

Si no se especifica un valor, el sistema del catálogo utiliza la unidad de negocio predeterminada del usuario que accede al widget.

layout:'layout-2'

Muestra las opciones del widget Estado como botones en una sola fila. Las opciones son Cesta de la compra, Abierto, Cerrado y a Pendiente.

También, se puede especificar 'layout-1' para mostrar las opciones de forma vertical. Cada opción aparece en su propia fila en una tabla.

openIn:"_widget"

Especifica que otros widgets de la misma página escuchan eventos del widget Estado y responde a ellos. En este escenario, cuando un usuario hace clic en una opción del widget Estado, otro widget responde abriendo el destino. Los destinos son los siguientes:

Para que estas funciones de destino se completen correctamente cuando los usuarios hagan clic en la opción de cesta de la compra, agregue los widgets siguientes a la página:

• Widget Editar solicitud
• Widget Lista de solicitudes

openIn especifica cómo un destino se abre cuando el usuario hace clic en el widget Estado. Otros posibles valores para este parámetro son los siguientes:

_self

Abre el destino del catálogo en la misma página.

_top

Desempeña la misma función que _self, excepto que el destino se abre en el marco superior del explorador. Si el destino es un marco, el primer marco asociado del elemento de opción de servicio se selecciona.

_blank

Abre el objetivo en una página nueva.

_url

Abre el destino mediante una dirección URL personalizada. Las direcciones URL pueden incluir un marcador de posición para el ID del objeto del servicio del contexto de fuente, por ejemplo, el servicio.

Observe el ejemplo a continuación:

http://www.google.com?id={id}

Nota: Se pueden especificar también los valores de configuración siguientes, tal y como se muestra en el código fuente: frecuencia de actualización en minutos y ocultar la cesta de la compra.