Ejemplo: Implementación de alertas de BPM

• categoryFilter(String)(List)

El servicio acepta esta entrada para determinar qué tipo de definiciones de alertas debe recuperar.

• alertDefinitionsStatus(BPMAlertDefinitionStatus)(List)

La variable de salida contiene la lista de definiciones de alertas que el servicio ha recuperado en función del tipo de alertas que el usuario desea ver. El tipo BPMAlertDefinitionStatus se encuentra en el kit de herramientas Datos del sistema para dar soporte a alertas de BPM.

• Determinar el filtro que debe aplicarse.
• Recuperar las definiciones de alertas que coinciden con el filtro de tipo y colocarlas en una lista.
• Recuperar las definiciones de alerta que han desencadenado una alerta.

var ids = null;

// si se ha establecido categoryFilter, utilizarlo para obtener las definiciones de alerta
if(tw.local.categoryFilter != null) {
	var alertDefinitions = tw.system.getAlertDefinitions(tw.local.categoryFilter, true);
	ids = new tw.object.listOf.String();
	for (var i=0; i<alertDefinitions.length; i++) {
		ids.insertIntoList(i, alertDefinitions[i].id);
}}

// obtener el estado de las definiciones de alerta recuperadas
if(ids == null || ids.length > 0) {
	var alertStatusResponse = tw.system.getAlertDefinitionsStatus(ids, true);
	tw.local.alertDefinitionsStatus = alertStatusResponse.alertDefinitionStatus;
}

1. En sus propiedades de implementación, añada el Servicio de recuperación de estado de definiciones de alertas que ha creado en la sección anterior.
2. En la correlación de entrada de las propiedades de correlación de datos, correlacione la variable categoryFilter del servicio de usuario con la variable categoryFilter del Servicio de recuperación de estado de definiciones de alertas.
3. De forma similar, en la correlación de salida, correlacione la variable alertDefinitionsStatus del Servicio de recuperación de estado de definiciones de alertas con la variable alertDefinitionsStatus del servicio de usuario.

tw.local.alertStatusSummaries = new tw.object.listOf.AlertStatusSummary();
var alerts = tw.local.alertDefinitionsStatus;

// correlacionar el estado con alertStatusSummaries
var num = 0;
var numOfAlerts = 0;
if(alerts != null) {
    for(var i=0; i<alerts.listLength; i++) {
        var status = alerts[i];
        
        // correlacionar sólo si el resumen de estado de alerta es necesario
        if(status.conditionMet || tw.local.selectedTriggeredFilter == "true") {
            
            // crear AlertSummary
            var alertSummary = new tw.object.AlertStatusSummary();
            alertSummary.currentValue = status.actualValue;
            alertSummary.displayName = status.definition.displayName;
            alertSummary.thresholdValue = status.definition.thresholdValue;
            
            // buscar el nombre de proyecto correcto
            var project = null;
            var invalid = false;
            if(status.definition.projectId != null) {
                project = tw.system.model.findProcessAppByID(status.definition.projectId);
                if(project != null) {
                    alertSummary.projectDisplayName = project.name;
                } else {
                    alertSummary.projectDisplayName = status.definition.projectId;
                    invalid = true;
                }
            }
            // buscar el nombre de instantánea correcto
            if(status.definition.snapshotId != null && project != null) {
                var snapshot = project.findSnapshotByID(status.definition.snapshotId);
                if(snapshot != null) {
                    alertSummary.snapshotDisplayName = snapshot.name;
                } else {
                    alertSummary.snapshotDisplayName = status.definition.snapshotId;
                    invalid = true;
                }
            }
            
            // concatenar resumen de condiciones
            if(status.definition.thresholdOperator == "GREATER") {
                alertSummary.condition = "More than ";
                alertSummary.thresholdOperator = ">"
            } else if (status.definition.thresholdOperator == "LESS") {
                alertSummary.condition = "Less than ";
                alertSummary.thresholdOperator = "<"
            } else {
                alertSummary.condition = "Exactly ";
                alertSummary.thresholdOperator = "=";
            }
            
            if(!invalid) {
                alertSummary.condition += status.definition.thresholdValue;
                alertSummary.condition += " " + status.definition.category.toLowerCase() + "(s)";
                if(alertSummary.projectDisplayName != null) {
                    alertSummary.condition += " in project '" + alertSummary.projectDisplayName + "'";
                }
                if(alertSummary.snapshotDisplayName != null) {
                    alertSummary.condition += " and snapshot '" + alertSummary.snapshotDisplayName + "'";
                }
            }            
            // si la alerta está activa o para visualizar alertas no activas, añadirlas a la lista
            if(status.conditionMet) {
                alertSummary.status = "Triggered";
                tw.local.alertStatusSummaries.insertIntoList(0, alertSummary);
                num++;
                numOfAlerts++;
            } else if (invalid) {
                alertSummary.condition = "Esta definición de alerta hace referencia a una aplicación de proceso o instantánea que ya no está disponible en el sistema.";
                alertSummary.status = "Invalid";
                tw.local.alertStatusSummaries.insertIntoList(numOfAlerts, alertSummary);
                num++;
                numOfAlerts++;
            } else if (tw.local.selectedTriggeredFilter == "true") {
                tw.local.alertStatusSummaries.insertIntoList(num, alertSummary);
                num++;
            }
        }
    }
}

// si se ha seleccionado la categoría "All"
if (tw.local.selectedCategoryFilter == "") {
    tw.local.categoryFilter = null;
    
// si se ha seleccionado otra categoría, crear el categoryFilter correcto
} else {
    tw.local.categoryFilter = new tw.object.listOf.String();
    tw.local.categoryFilter.insertIntoList(0, tw.local.selectedCategoryFilter);

1. Cree una vista de coach denominada Filtro de alertas. Se abrirá el diseñador de procesos Web para que pueda editarlo.
2. En la página de visión general, seleccione Se puede disparar el suceso de límite.
3. En la página Comportamiento, seleccione el manejador de sucesos de cambio y añádale el código siguiente:

   this.context.trigger();

4. En la página Variables añada selected(String) como datos de negocio, selectionList(NameValuePair)(List) como opción de configuración y Dashboards como recurso de localización. El objeto NameValuePair se encuentra en el kit de herramientas TWSYS y el recurso de localización Dashboards se encuentra en el kit de herramientas SYSD.
   
5. En la página Diseño, suelte un control Selección de categoría de la paleta en el lienzo.
6. Enlace el control Selección de categorías a los datos de negocio selected.
7. Vuelva al servicio de usuario de herencia Panel de control Mis alertas en el Process Designer de escritorio. Abra la página Coaches y seleccione el coach Panel de control Mis alertas.
8. En el panel de control Mis alertas, añada una sección horizontal y cambie su nombre por Filtro.
9. En la sección horizontal, añada dos instancias de las vistas de coach Filtro de alertas. Añada un elemento HTML personalizado entre ellas.
   
10. Seleccione la primera instancia de Filtro de alertas. En sus propiedades Generales, enlace la instancia a la variable selectedTriggeredFilter. Para distinguir entre los sucesos de límite transmitidos por las instancias de Filtro de alertas, añada triggeredFilter a la etiqueta.
11. En sus propiedades de Configuración, expanda Lista de selección. Añada los siguientes pares nombre-valor:

    Nombre	Valor
    Alertas desencadenadas	false
    Todas	true

    
    Los nombres son los que el filtro visualiza en tiempo de ejecución.
12. Seleccione la segunda instancia de Filtro de alertas. Enlácela a la variable selectedCategoryFilter. Añada categoryFilter a su etiqueta. Añada los siguientes pares nombre-valor:

    Nombre	Valor
    Alertas de instancia de proceso	INSTANCE
    Alertas de tarea	TASK
    Todas

13. Seleccione el elemento HTML personalizado. Añada el siguiente código HTML:

    <div id="spacer">&nbsp;</div>

    El objetivo de este control es añadir algún espacio entre los dos filtros.

1. En la paleta, abra el área Variables. Arrastre la variable alertStatusSummaries al diagrama. El diagrama muestra una tabla que contiene una columna para cada parámetro de la variable.
2. Para abreviar las cabeceras de la tabla del panel de control, cambie las etiquetas de los controles siguientes:

   Etiqueta de control predeterminada	Nueva etiqueta
   Nombre de visualización	Nombre
   Operador de umbral
   Valor del umbral	Umbral
   Nombre de visualización de proyecto	Aplicación de proceso
   Nombre de visualización de instantánea	Instantánea
   Nombre de visualización de Bpd	Proceso

3. Para el control de operador Umbral, establezca su visibilidad de etiqueta en Ocultar.