Tipos de Web parts y parámetros

<< Clic para mostrar Tabla de Contenidos >>

Navegación:  Bizagi Studio > Bizagi desde aplicaciones externas > Integración con portales > Uso de Web parts desde portales >

Tipos de Web parts y parámetros

Introducción

Bizagi ofrece muchos tipos de Web parts para permitirle seleccionar el que mejor cumple con sus requerimientos de cómo se mostrará su Portal de Trabajo de Bizagi.

 

Como se mencionó en Uso de Web parts desde portales, le sugerimos usar el web part "Workportal" ya que requiere una configuración mínima.

Observe que al usar otro, se pueden usar web parts más específicos, se requiere mayor esfuerzo para ajustar su estilo e interacción.

 

¿Cómo utilizar web parts?

Recuerde que como se describió en el enlace anterior, para poder utilizar estos web parts necesitará primero asegurarse de implementar un método de autenticación en su portal para que este comparta la autenticación en Bizagi y provea una experiencia SSO.

Esta sección parte de conocer la explicación del mismo enlace, respecto a cómo utilizar http://[BIZAGI_SERVER]/[BIZAGI_PROJECT]/jquery/webparts/desktop/portal/pages/webpart.htm, que cuenta con los web parts.

 

Lista de estos Web parts específicos

Para este enfoque, seleccione incluir por separado cada pieza de información y vistas que presenta Bizagi de su Portal de Trabajo. Los web parts disponibles son:

 

1. Mi Bandeja de entrada

Nombre técnico: cases

Este Web part muestra la lista de trabajo pendiente de un usuario (su Bandeja de entrada).

En este Web part, el usuario observa una lista filtrada de su lista de pendientes (de acuerdo a la fecha de vencimiento de las actividades o a un proceso específico).

 

07MyInbox

Observe que la Bandeja de entrada de Bizagi se presenta en dos vistas diferentes: tabla o detalles y la cual puede cambiarse:

 

07MyInbox2

 

Cuando haga clic en una tarea pendiente, se lanzará el Web part Resumen del caso.

 

2. Forma de la Actividad

Nombre técnico: activityform

Este Web part le permite a los usuarios trabajar en una actividad pendiente (inclusive cuando se ha iniciado una instancia del proceso).

Este Web part se mostrará cuando el usuario le da clic directamente en una tarea pendiente o crea un nuevo caso (lanzado por los web parts Resumen del caso, Botón de Inicio de Proceso y Lista de Inicio de Proceso). A través de éste, el usuario puede llenar cualquier información para completar su trabajo (dé clic en Guardar o Siguiente).

Este Web part puede ser configurado para que se muestre en un pop-up, en una página totalmente diferente (es útil cuando tiene que llenar mucha información) o en otro lugar justo en la misma página.

 

08ActivityForm

 

Tenga en cuenta que este Web part tiene algunas características que requieren ser configuradas (como se describe en la siguiente sección: Configuración de Web parts).

 

3. Resumen del caso

Nombre técnico: casesummary

Este Web part muestra la forma de resumen de un caso y le permite al usuario decidir si desea trabajar en él (dando clic en el botón Trabajar aquí).

Es realmente útil cuando un usuario necesita ver primero un resumen del caso e información importante relacionada al proceso, para así empezar a trabajar en él.

Se muestra por defecto en la parte derecha de la bandeja de entrada, en la vista de detalles (o también, se muestra al hacer clic en el botón ver Resumen en la vista de cuadrícula).

 

15Summary

 

Al hacer clic en Trabajar aquí, se abrirá el web part Forma de la Actividad.

 

Tenga en cuenta que este Web part tiene algunas características que requieren ser configuradas (como se describe en la siguiente sección: Configuración de Web parts).

 

4. Lista de Inicio de Proceso

Nombre técnico: newcaselist

Este Web part le permite al usuario iniciar instancias de Procesos (crear nuevos casos).

Mostrará la lista de procesos disponibles, con la opción para buscar o filtrar de acuerdo a los procesos más recientes.

Es útil cuando un usuario tiene muchos posibles procesos para iniciar, de lo contrario, puede ser mejor usar el Web part Botón de Inicio de Proceso.

 

Una vez se seleccione y se dé clic en el proceso que se desea iniciar, se lanzará el Web part Forma de la Actividad para mostrar la primera forma de dicho Proceso.

 

09Startprocesslist

 

Tenga en cuenta que este Web part tiene algunas características que requieren ser configuradas (como se describe en la siguiente sección: Configuración de Web parts).

 

5. Botón de Inicio de Proceso

Nombre técnico: newcasebutton

Este Web part le permite al usuario crear instancias de Procesos (crear un caso nuevo) con tan solo un clic.

Mostrará un botón con una etiqueta opcional para dar un atajo a la creación, lo cual es bastante útil cuando el un usuario quiera iniciar unos pocos tipos de Procesos (usted puede tener 1 o más de estos Web parts).

 

Por otro lado, si el usuario puede escoger entre varios procesos, es mejor usar el Web part Lista de Inicio de Proceso.

 

Al dar clic en el proceso que se desea iniciar, se lanzará el Web part Forma de la Actividad para mostrar la primera forma de dicho Proceso.

 

10Startprocesbutton

 

6. Ver consulta gráfica

Nombre técnico: graphicquery

Este Web part le permite a los usuarios ver en forma gráfica, la ruta que ha seguido un caso, los usuarios involucrados y su estado.

Para más información sobre este tipo de Web part, diríjase a Consulta Gráfica.

 

16GraphicQuery

 

7. Área de casos

Nombre técnico: processes

El Área de casos permite al usuario final ver la distribución de los casos en su Bandeja de entrada ordenados por su estado: a tiempo, en riesgo y expirados.

Esta zona es muy útil para identificar qué procesos y actividades que requieren ser priorizados y permite un fácil acceso a ellos.

 

17CasesArea

 

8. Forma global

Nombre técnico: globalform

Este Web part muestra la forma global de un caso. Le permite al usuario traer la información principal de un caso en el que el usuario no tiene actividades pendientes y cuya información principal ha sido cerrada.

Las formas globales eran relacionadas a una versión de proceso específica. Si un proceso tiene muchas versiones, cada una debe tener una forma Global.

 

20GlobalForm

 

9. Iniciar procesos

Nombre técnico: newcase

Este Web part le permite iniciar instancias de procesos (crear casos nuevos) una vez la página fue cargada.

Mostrará la primera actividad del proceso seleccionado para permitirle al usuario trabajar en el proceso inmediatamente.

 

18NewCase

 

 

Tenga en cuenta que este Web part tiene algunas características que requieren ser configuradas (como se describe en la siguiente sección: Configuración de Web parts).

 

note_pin

Para configurar este Web part, se recomienda iniciar sesión con un usuario que tenga los permisos requeridos para acceder a los procesos.

 

Detalle de los parámetros para cada Web Part específico

La siguiente tabla muestra el tipo de Web Part, sus parámetros, sus posibles valores y un ejemplo de cómo enviarlos al Web Part.

 

Web part

Descripción

Parámetros

Posibles valores

Ejemplo

casesummary

Muestra la forma de resumen del caso seleccionado.

renderBehavior: define si los enlaces/botones serán mostrados en un Pop up o en una nueva página (valor OtherPage), el valor por defecto es popup.

PopUp

OtherPage

?type=casesummary&idCase=101&idWorkitem=2

graphicQueryBehavior: define si la consulta gráfica será mostrada en un Pop up o en una nueva página (valor OtherPage), el valor por defecto es PopUp.

PopUp

OtherPage

renderPageUrl: define la URL donde se mostrará la acción de los enlaces/botones cuando renderBehavior es OtherPage.

URL válida

idCase: Identificador del caso seleccionado para que muestre su forma de resumen.

Valor Entero

idWorkitem: Identificador del elemento de proceso seleccionado para que muestre su forma de resumen.

Valor Entero

graphicquery

Muestra de forma gráfica la ruta que ha seguido un caso, los usuarios involucrados y su estado.

idCase: Identificador del caso seleccionado para que muestre la consulta gráfica.

Valor Entero

?type=graphicquery&idCase=101&idWorkflow=2&caseNumber=101

idWorkflow: Identificador del proceso seleccionado para que muestre la consulta gráfica.

Valor Entero

caseNumber: es el número que se muestra al usuario final en el Portal de Trabajo. Si no ha personalizado sus números de casos, use el mismo valor para idCase.

Cadena de texto

newcasebutton

Crea un botón para permitirle al usuario iniciar un caso nuevo del proceso seleccionado.

idWfClass: define el identificador de proceso al que se le creará un caso.

Valor Entero

?type=newcasebutton&idWfClass=1&buttonName=New%20Case

buttonName: define el nombre que será mostrado en el botón. Los caracteres no alfanuméricos deben estar en código ASCII. Consulte http://www.w3schools.com/tags/ref_urlencode.asp para mayor información

Cadena de texto

renderPageUrl: define la URL donde se mostrará la acción de los enlaces/botones cuando renderBehavior es OtherPage.

URL válida

renderBehavior: define si los enlaces/botones serán mostrados en un Pop up o en una nueva página (valor OtherPage), el valor por defecto es PopUp.

PopUp

OtherPage

newcaselist

Muestra una lista de los procesos creados en su Proyecto de Bizagi para crear un nuevo caso del proceso seleccionado.

renderBehavior: define si los enlaces/botones serán mostrados en un Pop up o en una nueva página (valor OtherPage), el valor por defecto es PopUp.

PopUp

OtherPage

?type=newcaselist

renderPageUrl: define la URL donde se mostrará la acción de los enlaces/botones cuando renderBehavior es OtherPage.

URL válida

workportal

Muestra el Portal de Trabajo completo.

DefaultView: define cómo se mostrarán los casos en la bandeja de entrada del Portal de trabajo. El valor por defecto es details (detalles).

details (detalles)

grid (cuadrícula)

?type=workportal&showViewToggler=false&DefaultView=details

showViewToggler: define si se muestra o no (true o false) la opción para mostrar los casos en cuadrícula o en detalles. El valor por defecto es true.

Valor booleano

pageSize: define el número de registros que se mostrarán en la bandeja de entrada cuando la vista es Grid. El valor por defecto es 10

Valor Entero

processes

Muestra el Área de casos que le permite al usuario final ver la distribución de los casos en su Bandeja de entrada ordenados por su estado: a tiempo, en riesgo y expirados.

No requerido

?type=processes

cases

En esta vista puede ver la Bandeja de entrada, es decir, la lista de tareas pendientes y su estado.

renderBehavior: define si los enlaces/botones serán mostrados en un Pop up o en una nueva página (valor OtherPage), el valor por defecto es PopUp.

PopUp

OtherPage

?type=cases&DefaultView=grid&pageSize=10&summaryBehavior=OtherPage&renderBehavior=OtherPage

renderPageUrl: define la URL donde se mostrará la acción de los enlaces/botones cuando renderBehavior es OtherPage.

URL válida

graphicQueryBehavior: define si la consulta gráfica será mostrada en un Pop up o en una nueva página (valor OtherPage), el valor por defecto es PopUp.

PopUp

OtherPage

summaryBehavior: define si los enlaces/botones serán mostrados en un Pop up o en una nueva página (valor OtherPage), el valor por defecto es PopUp.

PopUp

OtherPage

summaryPageUrl: define la URL donde se mostrará la acción de los enlaces/botones cuando summaryBehavior es OtherPage.

URL válida

DefaultView: define cómo se mostrarán los casos en la bandeja de entrada del Portal de trabajo. El valor por defecto es details (detalles).

details (detalles)

grid (cuadrícula)

showViewToggler: define si se muestra o no (true o false) la opción para mostrar los casos en cuadrícula o en detalles. El valor por defecto es true.

Valor booleano

pageSize: define el número de registros que se mostrarán en la bandeja de entrada cuando la vista es Grid.

Valor Entero

globalform

Muestra la forma global del caso seleccionado

idCase: Identificador del caso seleccionado para que muestre su forma global.

Valor Entero

?type=globalform&idCase=253

newcase

Crea un nuevo caso del proceso enviado al Web part a través de su identificador.

idWfClass: define el identificador de proceso al que se le creará un caso.

Valor Entero

?type=newcase&idWfClass=2

activityform

Muestra la tarea pendiente de un caso.

idCase: identificado del caso seleccionado para mostrar su tarea pendiente.

Valor Entero

?type=activityform&idCase=1&adjustButtonsToContent=true

idWorkitem: el elemento de proceso pendiente de un caso dado. Este parámetro es opcional.

No se requiere este atributo cuando el caso solo tiene un elemento pendiente y cuando no se ha puesto el atributo idTask.

Valor Entero

idTask: la tarea pendiente de un caso dado. Este parámetro es opcional.

No se requiere este atributo cuando el caso solo tiene una tarea pendiente y cuando no se ha puesto el atributo idWorkitem.

Valor Entero

adjustButtonsToContent: Si este valor es verdadero (true), los botones de la actividad se mostrarán en la parte inferior del Web part. en caso contrario, se mostrarán en la parte inferior de la forma creada. El valor por defecto es false.

Valor booleano

 

Ejemplo

Para crear sus Web parts, siga los pasos presentados en la sección Uso de Web parts desde portales.

 

Por ejemplo, si quiere mostrar la Bandeja de entrada del usuario, seleccione el Web part cases (variable [WEB_PART]). Después, agregue los parámetros para modificar la forma en que muestran sus acciones los enlaces/botones y cómo se mostrará la lista de casos. La siguiente imagen muestra la Bandeja de entrada en vista de cuadricula (grid) con 10 registros por página y las acciones se mostrarán en otra página.

 

19Inbox

 

Observe que solo se requiere usar los siguientes parámetros con sus valores apropiados para ver la Bandeja de entrada como se muestra arriba:

&DefaultView=grid&pageSize=10&summaryBehavior=OtherPage&renderBehavior=OtherPage

 

note_pin

Si desea ver un demo en vivo y explorar los resultados de este ejemplo de Bandeja de entrada mostrado arriba, puede probar y revisar los tipos de web parts y parámetros explicados anteriormente.

Para esto, ingrese a http://demo.bizagi.com/MySamplePortal/ y modifique la Bandeja de entrada alterando sus parámetros: solo necesita agregar a la URL dada el tipo de web part precedido por un signo de interrogación (?) y cada parámetro precedido del signo &.