SAM - Administración y monitoreo del sistema

Introducción

Este manual describe la herramienta web que permite administrar y monitorear distintos aspectos del sistema, tales como servicios y sitios, propiedades extendidas, licencias, servicios de notificación, instancias y parámetros de sistema.

El manual describe las funcionalidades para las dos versiones disponibles de Q-flow, Cloud y OnPremise. Estas versiones tienen diferencias entre ellas, ya que la versión Cloud no tiene disponibles las funcionalidades de la instancia principal y tiene un sistema de licenciamiento diferente. Para poder marcar mejor las diferencias entre éstas se va hacer uso de íconos para representar en qué versión está disponible cada funcionalidad:

Funcionalidad disponible en Q-flow Cloud
Funcionalidad disponible en Q-flow OnPremise

En las funcionalidades disponibles para las dos versiones, pero con alguna diferencia, se aclarará la diferencia mediante el uso de notas.

Descripción general de la interfaz de usuario

La Figura 648 muestra la pantalla principal del administrador de sistema. Los principales elementos de la interfaz son:

Pantalla principal: presenta y permite ir a los diferentes accesos directos, así como también una vista rápida de las licencias.
Menú superior: presenta opciones para acceder a la pantalla de configuración, auditar los elementos de la herramienta, cambiar la zona horaria de preferencia y cerrar la sesión.
Menú lateral: permite ir a la página de inicio y contiene las opciones de elementos con los que se puede interactuar en el sitio, a saber: uso de licencia, servicios, parámetros de sistema, propiedades extendidas de usuario, grupo y nodo, licencias, servicios de notificación e instancias. Cada una de estas opciones se describe en detalle en su sección correspondiente.

Figura 648 Pantalla principal del administrador y monitor del sistema

Visor de licencias 

El visor de licencias, el cual se puede visualizar siempre en la pantalla principal, muestra el uso de la licencia actual. El visor se divide en 3 indicadores:

Almacenamiento utilizado: indica cantidad en Gigabytes de almacenamiento utilizado de la licencia actual. Para más información sobre el almacenamiento de licencias ir a la sección Licencias.
Q-points utilizados: indica la cantidad de Q-points consumidos por los procesos de la licencia actual. Para más información sobre Q-points ir a la sección Licencias.
Usuarios habilitados: indica la cantidad de usuarios que se encuentran habilitados actualmente en la organización.

Figura 649 Visor de licencias de Q-flow Cloud

Diferencia de versiones

Estos 3 indicadores se encuentran disponibles en la versión Cloud del producto. Para la versión OnPremise sólo se encuentra el indicador de usuarios habilitados actualmente.

Figura 650 Visor de licencias de Q-flow OnPremise

Menú superior

La Figura 651 muestra el menú superior. A continuación, se explica cada una de las funciones disponibles a través de él.

Al presionar el botón de información se muestra la versión actual del producto, así como un link hacia las novedades de la versión y un manual del producto. Se pueden ver estas opciones en la Figura 652.

Al abrir la opción de configuración, el sistema despliega un menú de opciones como muestra la Figura 653. Más detalles en Administrar permisos .

Al abrir la opción de auditorías, el sistema despliega un menú de opciones como muestra la Figura 654. Más detalles en la sección de Auditoría .

Al abrir la opción “Usuario actual”, el sistema despliega la zona horaria de preferencia del usuario. Esta zona horaria es la utilizada en todas las fechas y horas de Q-flow para el usuario actual. La preferencia se comparte con todas las herramientas del producto, por lo que su modificación en una de ellas afecta a las otras.

Para la edición de la zona horaria se debe seleccionar la opción “Usuario actual” del menú. Esto abrirá un panel derecho con la lista de zonas horarias disponibles. Luego de seleccionada la zona horaria, al guardar el panel, la página se refrescará automáticamente para que el cambio tenga efecto. Se debe tener en cuenta que si se tiene más ventanas abiertas de alguna de las herramientas de Q-flow, deben ser refrescadas manualmente para que el cambio tenga efecto.

Menú lateral

La Figura 655 muestra el menú lateral, y cuáles son las opciones que contiene. Con la excepción de la página de inicio, cada opción corresponde a una funcionalidad de la herramienta, y éstas se explican en las siguientes secciones.

Diferencia entre versiones

El menú lateral de la Figura 655 se refiere al menú de la instancia principal. La versión Cloud al no tener acceso a la instancia principal, no contará con las opciones de estado de servicios e instancias.

Figura 656 Menú lateral de Q-flow Cloud

Estadísticas 

Q-flow cuenta con una funcionalidad que indica el uso de la licencia de la instancia actual. Consta de dos reportes, uno para el uso de la licencia en el mes actual (ver Uso de licencia) y otro para el histórico de consumo de licencias anteriores (ver Historial de uso de licencia). Cada reporte contiene distintas gráficas para el análisis de los distintos elementos de la licencia. Para poder acceder a las estadísticas, seleccione la opción correspondiente en el menú lateral (ver Figura 655).

Uso de licencia

En este reporte se encuentran dos gráficas, las dos relacionadas con el consumo de Q-points en el mes actual. En la primera gráfica se muestra el uso de Q-points a lo largo del mes actual. Por otro lado, la segunda gráfica indica lo mismo que la anterior pero agrupando los Q-points por plantilla de proceso. En esta última gráfica si el sistema no logra obtener el nombre de la plantilla (debido a que fue eliminada), se mostrará el identificador de ésta.

Figura 658 Estadística de uso total de Q-points

Figura 659 Estadística de uso de Q-points por plantilla

En la esquina superior izquierda se encuentran dos botones para cambiar la agrupación de los datos de las gráficas (ver Figura 660). Con estos botones se puede indicar si se desea ver los datos sólo para el día actual o para todo el mes.

Figura 660 Botones de agrupación de datos de gráficas

Diferencia de versiones

Este reporte por defecto no está disponible en la versión OnPremise del producto. Para desbloquear la función se debe cambiar el parámetro de sistema “ProcessExecutionPoints” a “true”, el cual se encuentra en el archivo “System.config” y en el archivo “Web.config” del administrador y monitor del sistema.

En la esquina superior derecha de la ventana se encuentra un botón para poder acceder al reporte de historial de uso de licencia, el cual se detalla en la siguiente sección.

Historial de uso de licencia

Al seleccionar dicha opción, se desplegarán cinco gráficas. Las dos primeras indican la cantidad de tareas respondidas y procesos iniciados en un periodo de tiempo. Las gráficas restantes muestran el historial de consumo de Q-points, usuarios habilitados y uso de almacenamiento en el último año agrupadas por mes.

Figura 661 Estadísticas de tareas respondidas y procesos iniciados

Figura 662 Estadísticas de Q-points utilizados y usuarios habilitados

Figura 663 Estadística de almacenamiento utilizado

Las dos primeras gráficas cuentan con filtros, entre ellos está la opción de agrupar por mes o por día (por defecto se agrupan por día), y también se puede establecer un período personalizado (por defecto el mes actual).

Diferencia de versiones

Las gráficas de Q-points utilizados por mes, usuarios habilitados por mes y almacenamiento utilizado por mes no se encuentran disponibles en la versión OnPremise de Q-flow.

Estado de servicios 

El sistema está compuesto de varios servicios y sitios que interactúan entre sí. Como tal, resulta de interés saber si están funcionando normalmente. Para esto se brinda un listado que envía una consulta a cada uno de los servicios que componen al sistema.

Para acceder a dicho listado, seleccione la opción correspondiente en el menú lateral (ver Figura 655). Se desplegará un listado mostrando todos los servicios y sitios que estén configurados en Q-flow. Se puede ver el nombre del servicio y la URI donde está ubicado (es decir, a dónde se enviará la solicitud). Para obtener el estado de uno o varios servicios, selecciónelos haciendo clic en el ícono que se encuentra a la izquierda del nombre del servicio (), y luego haga clic en el botón de “Refrescar” indicado en la Figura 665. Tenga en cuenta que la respuesta del servicio demorará unos segundos; durante ese tiempo, la columna “Estado” mostrará el ícono correspondiente ().

Figura 665 Listado de estado de servicios

Una vez obtenida la respuesta, el estado se actualizará y mostrará un círculo cuyo color indica si el resultado fue correcto (verde) o hubo un error (rojo). Las posibles respuestas son:

Ok: el servicio respondió a la solicitud correctamente, lo cual significa que está funcionando con normalidad.
Error: el servicio no respondió correctamente. Puede que no haya respondido, o que se haya enviado un mensaje de error. Para obtener más información, en la columna a la derecha de la respuesta aparecerá el ícono . Pase el cursor por encima del icono y se mostrará un cartel con el mensaje de error específico que retorna el servidor.
No encontrado: el servicio no se encontró en la ubicación especificada (la misma se puede ver en la columna “Ubicación”).
No autorizado: el servicio fue encontrado, pero el usuario actual (con el cual ingresó al sitio) no tiene permiso para realizar la solicitud.
Tiempo de espera agotado: el servicio no contestó dentro del período de tiempo esperado. Este límite de tiempo puede configurarse en esta herramienta (ver la sección Parámetros de sistema ).
Servicio no disponible: el servicio existe, pero no está disponible para contestar la solicitud.

En todos los casos, a continuación de la respuesta verá un número que indica el tiempo en milisegundos que se demoró en obtener esa respuesta.

Si en cualquier momento desea volver a consultar el estado de algún servicio, vuelva a refrescarlo de la manera ya indicada.

Parámetros de sistema 

Los parámetros del sistema son parámetros predefinidos que controlan varios aspectos del funcionamiento del producto. Pueden ser de tipo numérico, verdadero/falso (booleano), texto o imagen. Tienen un valor, y también un valor por defecto, que es el que se usa cuando no tienen un valor definido. Para ver el listado completo, ir a la sección Listado de parámetros de sistema.

Los parámetros pueden estar definidos en un archivo (“System.config”) o en una base de datos. La herramienta revisará primero los parámetros en la base de datos, y tomará de allí los parámetros con los valores que encuentre. Luego, en el archivo mencionado anteriormente, buscará más parámetros que no estén definidos en la base de datos. En caso de que exista un parámetro tanto en base datos como en el archivo de configuración con el mismo nombre y distinto valor, se tomará el valor de la base de datos.

Para acceder al listado de parámetros de sistema, seleccione la opción correspondiente en el menú lateral (ver Figura 655). Al seleccionar dicha opción, se desplegará un listado con todos los parámetros de sistema.

Mediante los botones que se encuentran arriba de la tabla, se puede editar o ver el historial de un parámetro de sistema.

Figura 667 Botones de parámetros de sistema

Algunas aclaraciones sobre el listado:

La columna “Fuente” hace referencia a si el parámetro fue tomado de una base de datos () o de un archivo ().
Si la fila con la información del parámetro está en color gris, eso significa que el parámetro es de sólo lectura y no puede ser editado.
Si el valor aparece en negrita y color gris, es el valor por defecto.
Al hacer clic sobre el ícono de información (), se mostrará una descripción del objetivo del parámetro. Haga clic sobre cualquier parte del listado para cerrarla.

Para editar cualquier parámetro que lo permita, haga clic sobre este y luego en el botón de editar. Se abrirá un panel como muestra la Figura 668. En caso de hacer clic en el botón de Ver, se abrirá el mismo panel de edición, pero en modo solo lectura.

Figura 668 Panel de edición de parámetro de sistema

Puede seleccionar usar el valor por defecto, o ingresar un valor personalizado. Este valor puede ser vacío. Al modificar un parámetro, es necesario reiniciar el servicio para ver el cambio.

Al hacer clic en el botón de “Ver historial” se abrirá un panel derecho con el historial de cambios del parámetro de sistema seleccionado. En este panel se puede ver el nombre de la acción realizada, el nuevo valor seleccionado para el parámetro de sistema, el usuario que ejecutó la acción y la hora de esta.

Figura 669 Historial de un parámetro de sistema

Propiedades extendidas 

Las propiedades extendidas son definidas por la organización y son mostradas en el panel de propiedades de cada miembro del modelo organizacional (usuario, grupo y nodo), en el administrador de dicho modelo. Para ver su utilización, consulte el manual del Administrador del Modelo Organizacional.

Una propiedad extendida tiene una clave y un texto. Además, puede tener uno de los siguientes tipos: texto, número, fecha, verdadero/falso (booleano), miembro o lista de ítems. En este último caso, se crea una lista de elementos que tienen una clave y un valor, ambos de tipo texto.

Propiedades extendidas de usuario

Puede agregar, ver, editar y eliminar las propiedades extendidas del usuario desde la opción correspondiente en el menú lateral (ver Figura 655). Al seleccionar dicha opción, se desplegará un listado con las propiedades extendidas definidas.

Mediante los botones que se encuentran arriba de la tabla, se puede agregar, editar o eliminar una propiedad.

Figura 671 Botones de propiedades extendidas

Si hace clic sobre el botón de agregar, se abrirá un panel para crear la nueva propiedad.

Figura 672 Agregar propiedad extendida de usuario

Deberá ingresar una clave y un texto. Tenga en cuenta que, una vez creada una propiedad extendida, su clave no podrá ser cambiada. Si desea que la propiedad tenga un tipo diferente de Texto, haciendo clic en el botón con la flecha en el campo Tipo, se desplegará un listado con los tipos mencionados en la sección Propiedades extendidas . En caso de que seleccione Lista de ítems, se abrirá una tabla como muestra la Figura 673. Puede agregar o quitar ítems, moverlos de lugar y editar el valor del texto o la clave.

Es obligatorio que exista al menos un ítem en la lista. Además, no puede haber claves repetidas, ni ningún valor (clave o texto) vacío.

Cuando haga clic en el botón de guardar (ícono de tic en la esquina superior derecha), se cerrará el panel y aparecerá la nueva propiedad en el listado.

Figura 674 Nueva propiedad en el listado

Si selecciona la propiedad y hace clic en el botón de Editar, se abrirá el panel de edición.

Figura 675 Panel de edición de propiedad extendida de usuario

Note que la clave está deshabilitada para edición, y sólo puede cambiar los otros campos.

En el listado, también puede seleccionar tantas propiedades como desee para eliminarlas. Si hace clic en el botón de Eliminar, se mostrará un cartel de advertencia.

Figura 676 Confirmar eliminación de propiedades extendidas

Seleccione Sí para confirmar.

Al hacer clic en el botón de “Ver historial” se abrirá un panel derecho con el historial de cambios de la propiedad extendida seleccionada. En este panel se puede ver el nombre de la acción realizada, el usuario que ejecutó la acción y la hora de esta. Si se hace clic en el botón de “+” se despliegan detalles sobre la propiedad extendida tales como tipo y etiqueta. También se muestran datos sobre el IP y el MAC del usuario que realizó los cambios.

Figura 677 Historial de una propiedad extendida

Propiedades extendidas de grupo

Puede agregar, editar y eliminar las propiedades extendidas del grupo desde la opción correspondiente en el menú lateral (ver Figura 655). Al seleccionar dicha opción, se desplegará un listado con las propiedades extendidas definidas.

Las operaciones sobre los elementos de este listado son análogas a las que se explican en la sección Propiedades extendidas de usuario.

Propiedades extendidas de nodo

Si desconoce el concepto de nodo, consulte el manual del Administrador del Modelo Organizacional.

Puede agregar, editar y eliminar las propiedades extendidas de un nodo desde la opción correspondiente en el menú lateral (ver Figura 655). Al seleccionar dicha opción, se desplegará un listado con las propiedades extendidas definidas.

Figura 679 Listado de propiedades extendidas de nodo

Las operaciones sobre los elementos de este listado son análogas a las que se explican en la sección Propiedades extendidas de usuario.

Licencias

En esta sección podremos ver todas las licencias que existen en el sistema. Para acceder al listado, seleccione la opción correspondiente en el menú lateral (ver Figura 655).

Se desplegará un listado mostrando todas las licencias que se encuentran cargadas en el sistema. Además, se muestra, encima del listado, el producto para el cual se están visualizando las licencias, así como la organización actual.

El listado de licencia contendrá distintos campos dependiendo de si se está utilizando la versión OnPremise o Cloud. A continuación, se detallan los campos comunes entre las dos versiones:

Tipo: indica el tipo de licencia.
Nombre de la organización: indica la organización para la cual esa licencia fue expedida. Si no coincide con el nombre de organización configurado, la licencia no será considerada válida.
Cantidad de usuarios: indica la cantidad de usuarios que se habilitan con esa licencia.
Fecha de expiración
Estado: muestra un ícono que indica si la licencia es válida o si hay algún problema. Los posibles estados son:
- La licencia es válida
- La licencia ha expirado
- La licencia no aplica a la organización
En cualquier caso, al pasar el cursor sobre el ícono, se mostrará un cartel con la descripción del estado.

También se puede cargar una nueva licencia, haciendo clic en el botón “+” sobre el listado. Se abrirá un cuadro de diálogo para que usted seleccione el archivo de licencia almacenado en su equipo. Los tipos de archivo soportados son xml y qlic. Una vez cargada, la licencia se mostrará en el listado.

Figura 680 Cuadro de diálogo de licencias

Licencias de Q-flow Cloud 

El modelo de licenciamiento de Q-flow Cloud consiste en un modelo de consumo por puntos denominados Q-points.

Los Q-points son puntos que se consumen al ejecutar procesos. Por lo tanto, cada paso de un proceso tiene asignado una cantidad de Q-points. Existen pasos (por ejemplo un evento de inicio) que tienen una cantidad de Q-points fija ya que el esfuerzo de la herramienta para procesarlo siempre es el mismo. Por otro lado, algunos pasos pueden tener una cantidad dinámica (por ejemplo un paso de código), esto quiere decir que mientras el paso se esté ejecutando, va a estar consumiendo una cantidad de Q-points. Significa que el esfuerzo para ejecutarlo puede variar según la operación que se realice dentro del paso.

Para ver la cantidad de Q-points que consume cada paso disponible en Q-flow, puede ver el manual de consumo de Q-points, en la versión Cloud de la documentación.

Además de los Q-points, a la licencia se le especifica una cantidad de almacenamiento disponible en la instancia, un número de usuarios que van a poder utilizar la herramienta y un tiempo de validez.

La información que se puede ver en el listado es la siguiente:

Almacenamiento máximo disponible: indica la cantidad máxima de almacenamiento en Gigabytes que tiene disponible la licencia.
Cantidad máxima de puntos de ejecución: indica la cantidad máxima de Q-points que tiene disponible la licencia.

Licencias de Q-flow OnPremise 

Una licencia habilita a un cierto número de usuarios a usar distintos componentes de Q-flow. Cada licencia es expedida para una cierta organización, tiempo de validez, una instancia específica y un servidor específico o grupo de servidores.

Figura 682 Listado de licencias OnPremise

La información que se puede ver es la siguiente:

Nombre del servidor: indica los servidores que tienen permitido ejecutar los servicios de Q-flow.
Nombre de la instancia: indica el nombre de la instancia a la que corresponde la licencia
Puerto: indica el puerto del backend correspondiente a la licencia
Directorio virtual: indica el nombre del directorio virtual en el que se encuentra el backend correspondiente a la licencia

Instancias 

A partir de la versión 5.0 de Q-flow se agrega soporte a instalaciones multi-instancias o multi-tenancy. Esto agrega un nuevo nivel de organización en el sistema, por el cual un mismo servidor y una misma base de datos pueden albergar distintos ambientes con datos propios, solo compartiendo configuraciones globales.

En este nuevo sistema, existe una instancia principal y un número de instancias secundarias. La mayor diferencia entre la instancia principal y el resto es que la principal es la única que puede crear instancias secundarias y es la que administra las configuraciones globales.

Las configuraciones que administra la instancia principal son:

Parámetros de sistema globales: Algunos parámetros de sistema solo son editables por la instancia principal, por lo que no serán visibles desde las instancias secundarias. Por más detalles sobre cuales son estos parámetros de sistema ir a la sección Listado de parámetros de sistema.
Estado de los servicios: El estado de los servicios solo será visible desde la instancia principal
Servicios de notificación por defecto: Las particularidades de los servicios de notificación serán explicadas en la sección Servicios de notificación en múltiples instancias .

También es posible agregar, ver, editar y eliminar las instancias desde la opción correspondiente en el menú lateral (ver Figura 655). Al seleccionar dicha opción, se desplegará un listado con las instancias definidas.

Mediante los botones que se encuentran arriba de la tabla, se puede agregar, ver, editar, eliminar, habilitar y deshabilitar una instancia.

Figura 684 Botones del listado de instancias

Al presionar el botón de agregar se despliega un panel derecho como muestra la Figura 685 en el cual se deben ingresar los siguientes datos:

Nombre: nombre de la nueva instancia
Dominio URL: URL por el cual se puede acceder a la nueva instancia
Nombre de la organización
Idioma: idioma en el que se crearán los paquetes roles, vistas, etc.
Zona horaria: zona horaria del calendario por defecto.
Nombre de usuario administrador: nombre del usuario administrador que se crea por defecto.
Login de usuario administrador: login del usuario administrador que se crea por defecto.
Proveedor de seguridad: proveedor por defecto por el cual se autenticará el usuario administrador, puede ser un dominio NT o en su defecto OAuth, en caso de dominio NT se requerirá un nombre de NetBios.
Servidor web: nombre del servidor web en el que se encuentran alojados los sitios
Directorio virtual: directorio virtual en el que se encuentra alojado el sitio web de Q-flow.

Si se aceptan los cambios se procede a crear la nueva instancia en la base de datos, puede tardar unos segundos. Una vez terminada la creación queda disponible la nueva instancia para ser utilizada.

Una vez creada una nueva instancia se la puede eliminar o editar, en este último caso solo se puede cambiar el nombre, URL y si está o no activa (Figura 686). Una instancia no activa, es decir una deshabilitada no permitirá a sus usuarios autenticarse ni ejecutará sus procesos activos.

Servicios de notificación

Los servicios de notificación son los servicios de correo y notificaciones push de Q-flow. Para visualizarlos, seleccione la opción correspondiente en el menú lateral (ver Figura 655). Al seleccionar dicha opción, se desplegará el listado de servicios de notificación.

Mediante los botones que se encuentran arriba de la tabla, se puede agregar, editar, ver, eliminar, habilitar y deshabilitar un servicio.

Figura 688 Opciones del listado de servicios de notificación

Creación de servicio de notificación 

Si hace clic sobre el botón de agregar, se abrirá un panel para crear un nuevo servicio de notificación. En este se podrá ingresar el nombre, tipo y formatos de correo. Además de poder configurar la ubicación del servidor, el protocolo que va a utilizar, su puerto y un vencimiento en segundos para conectarse.

Servicios de notificación en múltiples instancias 

La creación de nuevos servicios de notificación está limitada únicamente a la instancia principal. Los servicios creados y activos en este aparecerán en los listados de las instancias secundarias. Desde estos listados se podrán deshabilitar, habilitar y configurar, estas opciones aplican para la instancia actual únicamente.

La opción “Configurar” abre un nuevo panel en el cual se puede decidir si usar la configuración de la instancia principal o personalizarla. Si se elige usar una configuración personalizada, los cambios impactarán únicamente en la instancia actual, las distintas instancias secundarias seguirán utilizando sus propias configuraciones.

Figura 690 Configuración de un servicio de notificación en una instancia secundaria

Configuración de servicios de notificación 

Existen 4 tipos de servicios de notificación: SMTP, Extended MAPI, Servicio web Exchange y Firebase cloud messaging. A continuación, se detalla la configuración necesaria para el correcto funcionamiento de los servicios.

Diferencia entre versiones

En la versión Cloud la configuración del servicio de notificación se verá en un panel como el de la Figura 690, donde podrá además indicar que desea utilizar la configuración que ya le ofrece la instancia principal.

SMTP

Los servicios del tipo SMTP tienen las siguientes propiedades:

Host: nombre del servidor SMTP
Puerto (Opcional): si el servidor no utiliza el puerto por defecto, esta propiedad permite especificar otro puerto.
Vencimiento (Opcional): permite especificar un valor de vencimiento en segundos.
Usuario SMTP: permite especificar un usuario para el servicio.
SSL: permite activar o desactivar SSL (conexión segura). Si la opción no se encuentra marcada, el SSL queda desactivado.
Usuario Remitente: nombre de usuario del sistema. Es el nombre que aparecerá como remitente de los mensajes enviados por Q-flow.
Correo de sistema: dirección de correo electrónico del sistema. Es la dirección desde la cual se enviarán los mensajes de Q-flow.

Figura 691 Servicio de notificación SMTP

Extended MAPI

Los servicios del tipo Extended MAPI tienen las siguientes propiedades:

Servidor: nombre del servidor de Exchange.
Mailbox: casilla de correo a ser utilizada por Q-flow.
Clase de mensaje: clase de los mensajes. Por defecto, IPM.Note.Qflow.
Perfil (Opcional): nombre del perfil a ser utilizado por Q-flow.
Contraseña (Opcional): contraseña del perfil.

Figura 692 Servicio de notificación Extended MAPI

Servicio web Exchange

Los servicios del tipo Exchange tienen las siguientes propiedades:

Url: Url de los web services de Exchange.
Versión de Exchange: versión de Exchange instalada en el servidor que se va a utilizar.
Clase de mensaje: clase de los mensajes. Por defecto, IPM.Note.Qflow.
Usuario (Opcional): cuenta de usuario que se debe utilizar.
Contraseña (Opcional): contraseña de la cuenta de usuario indicada en la propiedad Usuario.
Correo de sistema: casilla de correo electrónico del sistema.

Figura 693 Configuración de servicio web Exchange

Firebase Cloud Messaging

Los servicios de tipo Firebase, a diferencia de los descritos previamente, se trata de servicios de notificaciones push. Por lo tanto, no es necesario configurar los formatos de correo. Para poder configurar el servicio de Firebase se deberá acceder a la siguiente consola y crear un proyecto: https://console.firebase.google.com/

Dentro de la configuración del proyecto de Firebase se pueden tomar todos los datos necesarios para configurar el servicio de notificación en SAM.

La Figura 694 muestra la configuración general del proyecto desde donde se puede tomar la Id del proyecto y la clave de API de la web. En el caso que no vea la clave de API de la web debe habilitar el servicio de autenticación de Firebase desde la consola del proyecto.

Figura 694 Configuración general de Firebase

Los datos restantes corresponden a la aplicación web que se quiere utilizar, los datos pueden ser extraídos de la sección “Tus aplicaciones” seleccionando la opción configuración como muestra la Figura 695. Para más información sobre cómo crear una aplicación ir a la siguiente guía: https://firebase.google.com/docs/web/setup#register-app.

Figura 695 Configuración de aplicación de Firebase

Finalmente, el campo “Configuración de servidor” debe tener un json correspondiente al SDK de Firebase Admin, el cual puede ser obtenido siguiendo la siguiente guía: https://firebase.google.com/docs/admin/setup#initialize-sdk.

En la Figura 696 se puede ver el panel de configuración de Firebase, por más detalles sobre la configuración de un servidor Firebase dirigirse al siguiente manual: https://firebase.google.com/docs/web/setup

Figura 696 Servicio de notificación Firebase

Administrar permisos 

Al seleccionar la opción “Administrar permisos de la herramienta” en el menú de configuración, se abrirá un panel como muestra la Figura 697.

Para agregar un usuario, grupo o rol de seguridad al conjunto de entidades que tienen permisos sobre el nodo:

Haga clic en el botón “Agregar”. Eso hace que aparezca en la parte superior de dicho botón un texto que dice “Comience a escribir…”. Escriba parte del nombre del usuario, grupo o rol deseado.
Cuando se muestre en la lista desplegable, selecciónelo.

Una vez agregados los usuarios, roles y grupos, es posible definir qué permisos tienen cada uno de ellos. Esto se hace marcando los casilleros “Permitir” o “Denegar” al lado de cada permiso como se muestra en la Figura 698.

Los posibles permisos son:

Administrar seguridad: permite agregar y modificar los permisos de la herramienta.
Acceder a la herramienta: permite acceder a Q-flow SAM.
Administrar configuración: permite editar aquellos elementos de la herramienta que son editables (parámetros de sistema y propiedades extendidas).
Auditar: permite acceder a las auditorías de los distintos elementos de Q-flow SAM

Para una explicación detallada acerca del funcionamiento de los permisos de Q-flow, consulte la sección “Manejo de permisos en Q-flow” del manual del Administrador del Modelo Organizacional.

Para editar permisos de un usuario, grupo o rol:

Seleccione el elemento al que quiera editarle los permisos y haga clic en el botón “Editar”, o haga clic en el símbolo “+” que se encuentra al lado del elemento.
Se volverá a mostrar el formulario “Configuración de permisos”. Seleccione las acciones que quiera permitir o denegar en el nuevo permiso.

Para eliminar permisos a un usuario, grupo o rol:

Seleccione el elemento al que quiera eliminarle los permisos y posteriormente haga clic en el botón “Eliminar”.
Se mostrará un mensaje de advertencia. Haga clic en el botón “Sí” y se eliminarán todos los permisos para el elemento seleccionado.

Auditoría 

Si se disponen los permisos de auditar en SAM, se puede ver en el menú superior derecho la opción de auditorías, si se hace clic se despliega un panel de opciones. Esta funcionalidad brinda la capacidad de verificar los cambios realizados en propiedades extendidas, licencias y parámetros de sistema, indicando sus nuevos valores, el usuario que realizó el cambio además de su fecha y hora.

Historial de parámetros de sistema

Esta auditoría indica los cambios realizados sobre todos los parámetros de sistema. Si se desea saber los cambios sobre un parámetro en particular se debe utilizar la barra de búsqueda, o en su defecto acceder a la opción de “Ver historial” en el listado de parámetros de sistema.

Historial de licencias

Esta auditoría mantiene un registro de todas las licencias agregadas. En el listado se muestra el identificador de la licencia, junto con el usuario que la agregó y su correspondiente fecha y hora.

Historial de propiedades extendidas

Esta auditoría lista todos los cambios realizados en todas las propiedades extendidas, sin importar el tipo de propiedad. Cada entrada en la tabla contiene un logo correspondiente al tipo de propiedad y se puede ampliar mostrando más detalles sobre los cambios. Si se quiere filtrar por una propiedad en particular se puede utilizar el buscador o ir al listado de propiedades extendidas y acceder al historial particular de una propiedad.

Listado de parámetros de sistema

Parámetros de la instancia principal 

A continuación, se listan los parámetros de sistema que solo pueden ser configurados por la instancia principal y que afecta a todas las instancias existentes.

Nombre técnico	Nombre	Descripción
CodeExecutionTimeout	Tiempo límite de ejecución de código	Especifica el tiempo máximo en segundos que se espera por la ejecución de código de manejadores de eventos, pasos de código, de evaluación por código y de integración. El valor por defecto es 600.
CompileCodeInDebug	Compilar código en modo depuración	Si el valor de este parámetro es «verdadero», el código generado por el usuario para ser compilado por la aplicación, se compilará en modo debug.
EngineNewsDBPeekPeriod	Período de espera del motor para procesar nuevos eventos	Indica el período de espera en segundos del motor para procesar nuevos eventos.
IdentifyTenants ByBasePathUrl	Identificar las instancias por la URL base	Si es verdadero, Q-flow identificará las instancias a partir de la URL base. En caso de ser falso, en el login de los sitios se verá una opción que permite cambiar entre las instancias existentes.
LicenseCacheExpiration	Expiración del caché de licencias	Indica durante cuántos segundos las licencias son guardadas en caché.
MaxConcurrentRequests	Cantidad máxima de solicitudes concurrentes	Indica la cantidad máxima de solicitudes concurrentes que puede procesar el motor.
MaxDataSource ItemsPerQuery	Cantidad máxima de elementos por consulta a orígenes de datos	Permite limitar la cantidad de elementos que se despliegan en un dominio de tipo selector de ítems.
MaxLoopCount	Cantidad máxima de bucles en procesos	Si un proceso pasa por un paso una cantidad de veces superior a ese número, queda en estado de error.
PendingNotifications DBPeekPeriod	Período de espera del motor para el envío de notificaciones	Indica el período de espera en segundos para procesar el envío de notificaciones
ProductName	Nombre de producto	Nombre de producto
TenantBasePathTemplate	Plantilla para URL base de la instancia	Esta es la plantilla de la URL base al indicar el nombre de una instancia. Se reemplazará el «{0}» por el nombre de la instancia.
WebStatusRequestTimeout	Tiempo límite de espera en la solicitud de estado de los sitios	Indica el tiempo en segundos que el servidor espera que los distintos servicios y sitios respondan al pedido de estado.

Parámetros de las instancias secundarias 

A continuación, se listan los parámetros de sistemas editables también por las instancias secundarias:

Nombre técnico	Nombre	Descripción
ActionLink	Vínculo de acción	Es la URL que utilizan los vínculos a acciones en los mensajes enviados por correo electrónico.
DefaultDomainNetbiosName	Nombre de dominio predeterminado	Especifica un nombre de dominio por defecto al hacer login en las aplicaciones o en el sitio web.
EncryptAttachments	Encriptar archivos adjuntos	Si el valor de este parámetro es “verdadero”, Q-flow cifrará el contenido de los archivos adjuntos, de modo que la única forma de acceder a dicho contenido sea por medio de los permisos de Q-flow. Si este parámetro está activado, no es posible hacer búsquedas full-text utilizando el contenido de los archivos adjuntos.
EnforceIntegratedLogon	Forzar autenticación integrada	Si el valor de este parámetro es «verdadero», los usuarios solo podrán ingresar a la aplicación mediante autenticación integrada.
FlowDetailsLink	Vínculo a detalles del proceso	Es la url enviada por correo, la cual redirige hacia los detalles de un proceso.
FlowEditFormLink	Vínculo al formulario de edición del proceso	Es la url enviada por correo, la cual redirige hacia el panel de edición de un proceso.
HtmlLinkTemplate	Plantilla de mails de tipo HTML Link	Indica la ruta del archivo correspondiente a la plantilla de envío de correos html.
IsCheckInCommentRequired	Comentario de protección requerido	Si el valor de este parámetro es “verdadero”, en cada acción de protección en el árbol de paquetes deberá ingresarse un comentario obligatoriamente. Si el valor es “falso”, el comentario puede omitirse.
IsGoogleSignInEnabled	Habilitar el inicio de sesión con Google	Si el valor de este parámetro es “verdadero”, Q-flow permitirá que los usuarios se autentiquen con su cuenta de Google en los distintos sitios. De lo contrario, esta opción no se mostrará.
IsMicrosoftSignInEnabled	Habilitar el inicio de sesión con Microsoft	Si el valor de este parámetro es “verdadero”, Q-flow permitirá que los usuarios se autentiquen con su cuenta de Microsoft en los distintos sitios. De lo contrario, esta opción no se mostrará.
LicenseExpiration AlertThreshold	Alerta de vencimiento de licencia	Es un número entero que indica cuántos días antes del vencimiento de las licencias se notificará a los usuarios que las licencias están a punto de vencer. Por defecto, tiene un valor de 7, es decir, avisa una semana antes.
Logo	Logo	Imagen para el logo del sitio web. La relación debe ser 4:1 para que la imagen se muestre correctamente.
MailLogo	Logo de correos	Imagen para el logo que se mostrará en los correos. La imagen debe estar en formato png, jpg o jpeg para que se muestre correctamente.
MiniLogo	Mini logo	Imagen para el logo de la barra lateral colapsada del sitio web. La relación debe ser 1:1 para que la imagen se muestre correctamente.
OrganizationName	Nombre de la organización	Indica el nombre de la organización. Este nombre es utilizado por Q-flow para controlar las licencias del producto.
RenewSessionAutomatically	Renovar la sesión automáticamente	Indica si las herramientas de Q-flow, tanto de escritorio como el sitio web, deben renovar automáticamente la sesión del usuario cuando ésta se vence.
ResponseLink	Vínculo de respuesta	Es la URL que utilizarán los vínculos a los formularios de respuesta de los mensajes enviados por correo electrónico.
SessionLeaseTime	Duración de la sesión	Duración en segundos de la sesión de un usuario de Q-flow. Si no hay actividad durante ese tiempo, la sesión del usuario vence y éste debe volver a autenticarse.
StageLink	Vínculo de seguimiento de etapas	Es la url usada en los vínculos al seguimiento de etapas en los mensajes enviados por correo electrónico.
StrongWindowsSinchronization	Sincronización de usuarios Windows estricta	Si el valor de este parámetro es “verdadero”, al eliminar un usuario del Active Directory se cambiará el login de Q-flow para así permitir a otro usuario utilizar el login original.
Theme	Tema	Indica qué tema utilizar en el sitio web de Q-flow.
UndoChangesOnStepBack	Revertir cambios al retroceder	Indica si, al hacer retroceder un hilo de un proceso, se deshacen los cambios hechos a los datos de aplicación, roles y archivos adjuntos en los pasos cuya ejecución se está deshaciendo.

Parámetros del archivo de configuración 

Finalmente se listan los parámetros de sistema que se encuentran en el archivo de configuración (System.config):

Nombre técnico	Descripción
NonQueryCommandTimeout	Indica el tiempo en segundos en que se considera que una consulta a la base de datos, que no retorna valores, no responde. El valor es 60 por defecto.
QueryCommandTimeout	Indica el tiempo en segundos en que se considera que una consulta a la base de datos, que retorna valores, no responde. El valor es 60 por defecto.
MaxDBConnectionRetries	Intentos de conexión máximos a la base de datos antes de retornar un error
CacheType	Tipo de caché para almacenar parámetros de sistema, puede ser Redis o Default
FilterMultivalued	Si el valor de este parámetro es “true”, las búsquedas por datos de aplicación en el sitio web tienen en cuenta todos los valores de los datos multivaluados. Si el valor de este parámetro es “false” o no está definido, las búsquedas por datos de aplicación sólo tendrán en cuenta el primer valor de cada uno de los múltiples valores de cada dato.