Introducción

El BackEnd de simpleBPM, posee una serie de funcionalidades, las cuales se enumeran a continuación:

1. Inicio/Widgets
2. Modelamiento de Procesos
3. Seguimiento
4. Gestión y Reporte de los procesos
5. Utilización API de simpleBPM
6. Configuración del Sitio
7. Ayuda

Cada una de estas secciones se visualizarán en el presente manual.

Antes que todo, tenga en cuenta que el acceso al BackEnd está restringido a los usuarios finales. Se requiere de accesos/perfiles especiales para el ingreso a este módulo de simpleBPM.

Ingreso

Para ingresar al BackEnd de simpleBPM es necesario que el usuario gestione sus permisos de acceso al portal junto al administrador del portal, quien le deberá proporcionar una credencial y dirección (URL) de acceso a simpleBPM para la Institución que representa. Una vez que tenga esta información podrá realizar el ingreso al portal.

En este caso y a modo de ejemplo se ingresará a la dirección desde el navegador (browser) de preferencia: http://institucion.simplebpm.cl/backend, una vez realizado se desplegará una imagen como la siguiente:

Ingreso al Sistema:

Luego deberá ingresar sus credenciales (Usuario y Contraseña) en los campos indicados.

---

TIP: Tenga presente haber gestionado sus credenciales previamente, para la generación o edición de nuevos procesos.

---

Al presionar el botón Ingresar, será desplegada la pantalla de inicio de simpleBPM, siendo la pestaña de Inicio la pestaña inicial. Como se visualiza en la imagen siguiente:

Pantalla de principal del BackEnd:

El espacio de trabajo se encuentra estructurada de la siguiente forma:

Marco de Trabajo para el BackEnd de simpleBPM:

Cada uno de los recuadros demarcados en rojo representa:

1. Sección 1: El recuadro superior indica el usuario que ha ingresado al Sistema. Si hace clic sobre nombre de usuario se dará la opción de Cerrar Sesión.
2. Sección 2: En recuadro se visualiza las opciones para la generación de widgets, el modelamiento de procesos, seguimiento, gestión, API y configuración de Procesos de simpleBPM. Cada uno de estos puntos serán revisados en las secciones posteriores.
3. Sección 3: El recuadro corresponde al área de trabajo de simpleBPM, en este caso la imagen representa el espacio de trabajo o llamado masivamente como workspace.

Configuración

La sección de configuración en simpleBPM se refiere a la gestión de usuarios, grupos y configuración general del portal. Para iniciar la configuración debe dirigirse hacia el menú de Configuración dentro del menú principal de simpleBPM.

La siguiente imagen despliega como se visualiza el área de trabajo para la sección de configuración, puntos tratados a continuación:

Como se ve en el panel izquierdo, el panel se encuentra dividido de las siguiente manera:

• General: Permitirá configurar el logo del portal, mensaje de bienvenida y otros.
• Accesos FrontEnd: permitirá gestionar usuarios y grupos, que participarán durante las tareas de los procesos. Tenga presente que estos usuarios, independiente que sea internos (hagan acciones sobre las tareas), también estas cuentas pueden operar como usuario externo.
• Accesos Backend: permitiendo gestionar los usuarios que realizarán gestión sobre los procesos diseñados, y/o modelar procesos.

Conf. - General

En el panel izquierdo existe la sección GENERAL con la cual podrá realizar la siguiente parametría de su sitio.

Sección 'Mi Sitio'

Al acceder a la sección GENERAL podrá ver la opción 'Mi Sitio' dentro del menú izquierdo, tal como se ve en la siguiente imagen:

En donde podrá realizar las siguientes acciones:

• Nombre: Indicará el nombre del subdominio de su sitio en portal. Este valor no es modificable.
• Nombre Largo: Corresponderá al nombre de la Institución en que se implementará simpleBPM.
• Mensaje de bienvenida: Es un mensaje que se desplegará al ingresar a la pantalla principal de simpleBPM para la Institución. En este recuadro podrá añadir código HTML para que sea más amigable su mensaje inicial.
• Logo: Permitirá adjuntar un archivo al presionar el botón Subir archivo.
• Botón Guardar: Permitirá almacenar la información ingresada en los campos, exceptuando el Logo, ya que este se almacena inmediatamente después de ser subido.

Conf. - Accesos FrontEnd

En el panel izquierdo existe la sección ACCESOS FRONTEND, con el cual podrá realizar las siguientes configuraciones:

1. Usuarios
2. Grupos de Usuarios

En la siguiente imagen se puede visualizar el panel ACCESOS FRONTEND:

Ambas opciones serán explicadas a continuación.

Sección 'Usuarios'

Un usuario de acceso frontend corresponde a quien interactuará con el modelo de procesos de diversas formas, habitualmente un usuario puede pertenecer a un uno o más grupos para la correcta gestión del proceso realizando las tareas involucradas.

Para ingresar a la sección para la Gestión de Usuarios del FrontEnd, es necesario hacer clic sobre Configuración y luego Usuarios del menú Acceso Frontend, con lo cual se desplegará una serie de opciones como se ve en la imagen siguiente:

Siendo las opciones del mantenedor de Usuarios las siguientes:

• Botón Nuevo : Permite añadir un nuevo usuario a simpleBPM. Para esto, sólo debe hacer clic sobre el botón Nuevo y completar el formulario que se desplegará, con se ve en la imagen siguiente:

Tendrá que completar todos los campos solicitados, con los siguientes campos tenga especial atención:

• Nombre de Usuario: No podrá estar duplicado en todo el portal de simple, este usuario NO es por proceso es a nivel de portal.
• Correo Electrónico: Es único asociado al usuario dentro del portal.
• Check Fuera de la Oficina: permitirá indicar que el usuario no se encuentra disponible para la realización de tareas dentro de los procesos, por ende en las asignaciones automáticas de tareas el sistema no lo considerará, al igual que en las asignaciones manuales las este usuario no saldrá desplegado para derivar tareas.
• Grupos de Usuarios: Considere que un usuario puede pertenecer a más de un grupo, simpleBPM desplegará una lista con los grupos existentes, pero usted podrá añadirlos manualmente si así lo desea.

Luego simplemente presione el botón Guardar para almacenar el usuario o Cancelar si no lo desea añadir al portal.

---

TIP: El ingreso de usuarios se puede realizar en el cualquier momento en que se requiera diseñar el modelo de proceso, pero es recomendable definirlos con anterioridad, esto permitirá que en momento del diseño del modelo de procesos, los usuarios o grupos sean asignados inmediatamente a las tareas que correspondan.

---

A medida que vaya generando los usuarios, dentro de la sección 'Usuarios' de los Accesos FrontEnd, se irá desplegando los usuarios generados, como se ve en la siguiente imagen:

Como se puede visualizar al costado derecho de cada usuario del sistema, se desplegarán los siguientes botones:

• Botón Editar: Permite editar los datos de un usuario en particular existente en simpleBPM. Para esto sólo debe presionar el botón Editar dentro de la misma fila en que se encuentre el usuario a editar. Con esto se abrirá el formulario que se ha completado al momento de añadir un nuevo usuario, sólo que en esta oportunidad los datos aparecerán precargados, para poder ser editados, como se ve en la siguiente imagen:

Como se puede visualizar, el campo Contraseña no tendrá información precargada, si desea cambiar la contraseña deberá escribir directamente sobre los campos contraseña y confirmar contraseña, de lo contrario, lo debe dejar en blanco para mantener la contraseña actual del usuario.

• Botón Eliminar: Permite eliminar un usuario del Sistema. Para eliminar un usuario simplemente haga clic sobre el botón Eliminar en la fila del usuario que desee eliminar. A modo de ejemplo en la imagen de a continuación se eliminará el usuario sbmsbm:

Se desplegará un PopUp de confirmación previa eliminación del usuario, confirmando esto el usuario será eliminado definitivamente, tal como se ve a continuación:

Sección 'Grupos'

El concepto de Grupo de Usuarios corresponde a la agrupación de usuarios que tengan un mismo rol o función dentro del modelo de procesos definido, esto permitirá asociar a un conjunto de usuario para la ejecución de las diferentes tareas que se realicen dentro del proceso de simpleBPM.

Para definir los accesos a los Grupos de Usuarios, es necesario hacer clic sobre Configuración y luego Grupos de Usuarios, con lo cual se desplegará una imagen como la siguiente:

Se pueden ver la opción:

• Botón Nuevo: Permite generar un nuevo Grupo de Usuarios en simpleBPM. Para esto, sólo debe hacer clic sobre el botón Nuevo y completar los datos del formulario que se desplegará, como se ve a continuación:

Tenga en cuenta que puede asignar usuarios al nuevo grupo inmediatamente, siempre y cuando los usuarios ya los haya añadido a simpleBPM.

A medida que vaya generando los Grupos, dentro de la sección 'Grupos de Usuarios' de los Accesos FrontEnd, se irán desplegando los Grupos generados, como se ve en la siguiente imagen:

Como se puede visualizar al costado derecho de cada Grupo del sistema, se desplegarán los siguientes botones:

• Botón Editar: Permite editar los datos de un Grupo en particular existente en simpleBPM. Para esto sólo debe presionar el botón Editar dentro de la misma fila en que se encuentre el grupo a editar. Con esto se abrirá el formulario que se ha completado al momento de añadir un nuevo grupo, sólo que en esta oportunidad los datos aparecerán precargados, podrá añadir nuevos usuarios al grupo o cambiarle el nombre al grupo, como se ve en la siguiente imagen:

• Botón Eliminar: Permite eliminar un grupo de simpleBPM. Para eliminar un grupo simplemente haga clic sobre el botón Eliminar en la fila del grupo que desee eliminar. A modo de ejemplo en la imagen de a continuación se eliminará el usuario testGRP:

Se desplegará un PopUp de confirmación previa eliminación del Grupo, confirmando que el Grupo será eliminado definitivamente, tal como se ve a continuación:

---

TIP: debe tener especial cuidado al utilizar esta opción, ya que eliminar un grupo asignado a un proceso, el proceso quedará sin asignación.

---

Conf. - Accesos BackEnd

Los usuarios de acceso BackEnd corresponden a usuarios de administración del sitio simpleBPM. La gestión y administración de usuarios BackEnd se realiza de la misma forma que los usuarios del Frontend.

Para ingresar a esta sección deberá ir al panel izquierdo y luego seleccionar 'Accesos BackEnd'. Tal como muestra la siguiente imagen:

Sección 'Usuarios'

La particularidad de estos usuarios, es que pueden crearse con distintos roles los cuales permiten acceso restringido a funcionalidades u opciones que se desee, a continuación se detallan los distintos tipos de roles de usuarios BackEnd:

• Súper: El usuario tendrá todos los privilegios del sistema.
• Modelamiento: El usuario podrá modelar y/o editar procesos.
• Seguimiento: El usuario podrá hacer seguimiento de los procesos.
• Operación: El usuario podrá realizar seguimiento y gestión sobre los procesos modelados, incluyendo la edición y eliminación.
• Gestión: El usuario podrá acceder a los reportes de gestión.
• Desarrollo: El usuario podrá acceder a la API de desarrollo, para la integración con plataformas externas.
• Configuración: Permite configurar los usuarios y grupos de usuarios que tienen acceso al sistema, además de la parametría básica del portal.

---

IMPORTANTE: Los usuarios definidos en esta sección NO son compartidos para el uso el los procesos.

---

Modelamiento del Proceso

En esta sección veremos todas las características que simpleBPM ofrece para el Modelamiento de Procesos, las cuales serán explicadas en detalle a continuación, mediante la generación de un proceso para la Solicitud de Vacaciones.

---

TIP: Tenga presente que usted podrá realizar su proceso en el orden y de la forma que desee, pero para realizar de manera secuencial el Modelamiento de Procesos en simpleBPM es recomendable seguir el orden que se detalla a continuación.

---

MP - 1 - Modelar y exportar un nuevo Proceso

Para generar un Nuevo proceso o importarlo dentro de simpleBPM debe ingresar al menú principal y seleccionar la opción Modelador de Proceso en donde se desplegará la siguiente ventana:

En esta ventana, usted podrá realizar las siguientes acciones:

• Botón Nuevo: generará un nuevo proceso en simpleBPM, para esto lo redirigirá automáticamente al modelamiento de procesos de simpleBPM en donde deberá ingresar el nombre del proceso.
• Botón Importar: este botón permitirá importar un documento anteriormente guardado en simpleBPM, sirve a modo de ejemplo para duplicar procesos o traspasarlos de una Institución a otra.
• Botón Editar: esto lo redirigirá al modelamiento de procesos de simpleBPM.
• Botón Exportar: con este botón podrá exportar el proceso de simpleBPM, con el cual podrá luego hacer replicas de el proceso generado.
• Botón Eliminar: botón para eliminar un proceso generado. Tenga presente que una vez eliminado no podrá restaurarlo, salvo que haya hecho una copia de seguridad con el botón Exportar.

MP - 2 - Generación y edición de Documentos y/o Certificados

simpleBPM tiene la capacidad de generar documentos/certificados para la entrega de información de las siguientes maneras:

1. Documento en blanco: documento sin formato establecido, en donde deberá añadir texto sin formato en en HTML para realizar su formato.
2. Documento de tipo certificado: este cuenta con un formato preestablecido permitiendo ademas el uso de firma electrónica avanzada.

Ambos se verán con más detalle a continuación, para lo cual deberá ingresar al menú principal y seleccionar la pestaña Documentos.

Documento en blanco

Tipo de documento básico, el cual posee un único campo de edición, destacando entre sus cualidades el uso de variables y aplicar formato al documento con código HTML. Si su Modelo de Procesos requiere del diseño de documentos sin firma electrónica avanzada, o con un diseño propio es recomendable utilizar este tipo de documentos. Tenga en cuenta que cada documento deberá ser asociado a un formulario posteriormente.

Para ingresar al menú de generación y gestión de documentos, deberá presionar sobre el botón Documentos, indicado en el recuadro en rojo siguiente:

El marco de trabajo para gestionar los documentos, permitirá realizar las opciones típicas de un mantenedor, siendo las siguientes:

• Botón Nuevo: Permite generar un nuevo documento en simpleBPM. Al presionar sobre el botón ingresará a la ventana para generar documentos dentro de simpleBPM como se visualiza en la siguiente imagen:

En donde:

• Nombre: Corresponde al nombre del documento a generar.
• Tipo de documento: Corresponde al tipo de documento a crear, existiendo en blanco y certificado.
• Tamaño de la Página: Podrá indicar si desea que el documento generado sea emitido para ser impreso en formato Carta u Oficio. Esto afectará el área de diseño del documento, Siendo más pequeño para Carta y más grande para Oficio.
• Contenido: es el contenido que desea que desea tenga el documento, recordar que en esta sección podrá utilizar variables, como también formatear el documento codificando en HTML.

---

TIP: La codificación en HTML va más allá del presente manual, por lo que se recomienda alguna guía práctica en Internet.

---

Veremos con un ejemplo un documento de entrega de resultado de petición de vacaciones. La estructura del documento básico sería el siguiente:

Con eso sólo deberá presionar el botón Guardar y su documento será generado en simpleBPM. Luego automáticamente volverá a la pantalla de generación de documentos, con el listado de todos los documentos/certificados que se han generado, tal como se ve a continuación:

Documento Certificado

Corresponde a documentos con un formato preestablecido para elaboración de certificados, ya sea con firma electrónica simpleBPM o firma simple (una imagen de la firma para este caso). La creación, edición, previsualización y eliminación de este tipo de documentos se realiza de la misma manera que en los documentos en blanco, salvo que se solicitan campos extras como se puede ver en la imagen siguiente:

En donde:

• Título: nombre del certificado, se mostrará en la cabecera.
• SubTítulo: subtitulo del certificado, se mostrará con una fuente un poco menor bajo el Título.
• Servicio que emite el documento: Indica quien es el emisor del documento.
• URL al sitio web del servicio: URL del emisor.
• Logo del Servicio (Opcional): podrá adjuntar un logo personalizado del emisor de modo de personalizar el certificado.
• Imagen del timbre (Opcional): podrá adjuntar un timbre personalizado del emisor de modo de personalizar el certificado.
• Nombre de la persona que firma (Opcional): nombre del responsable de la emisión del certificado.
• Cargo de la persona que firma (Opcional): cargo de la persona responsable.
• Servicio al que pertenece la persona que firma (Opcional): servicio al que pertenece la persona responsable.
• Imagen de la firma: imagen de la firma del emisor.
• Numero de días de validez (Dejar en blanco para periodo ilimitado): podrá indicar si el certificado tiene caducidad. También podrá seleccionar el check Hábiles para sólo considerar días hábiles del calendario.

Opciones Generales sobre el listado de Documentos/Certificados

Cada uno de los documentos/certificados generados, tendrán 3 opciones fundamentales, como se ve y explica a continuación:

• Botón Editar: Permite modificar un documento/certificado existente, con esta opción podrá cambiar el nombre del reporte, editar el contenido del documento e inclusive cambiar el tipo de documento pasándolo de un formato en blanco a certificado y viceversa. Se desplegará el asistente de reporte, con la información original precargada:

Una vez modificados los campos, simplemente presione el botón Guardar y el documento habrá quedado correctamente almacenado y disponibilizado para su uso en las tareas del modelo de procesos.

• Botón Eliminar: Permite eliminar un documento existente en simpleBPM, para esto haga clic sobre la fila con el documento a eliminar y pulse el botón Eliminar, luego tendrá que confirmar la acción, tenga precaución ya que esta operación NO es reversible.

• Botón Previsualizar: Permite visualizar un Documento realizado en el sistema, esta funcionalidad es para revisar si el formato del documento y la estructura, está de acuerdo a lo que se espera a medida que se va diseñando o para obtener el resultado final.

• Imagen de Formato Básico:

• Imagen de Certificado:

MP - 3 - Generación y edición de Formularios

Los formularios permiten ingresar datos de una forma amigable y estructurada dentro de simpleBPM por parte de los diversos involucrados del modelo de proceso, dada su relevancia es importante definir la estructura que tendrá cada uno de los formularios a utilizar antes de diagramar el modelo de procesos. Para gestionar los formularios haga clic en Formularios dentro del menú de Modelador de Proceso, tal como se visualiza en la imagen siguiente:

En donde:

• Botón Nuevo: Permite generar un nuevo formulario para el modelo de procesos que se está trabajando dentro de simpleBPM. Al presionar sobre el botón ingresará a la ventana de trabajo para la generación y diseño de formularios.
• Botón Editar: Permite modificar un formulario existente en simpleBPM, al ingresar a esta opción ingresará a la ventana de trabajo para diseñar formularios.
• Botón Eliminar: Permite eliminar un formulario existente en simpleBPM, para esto haga clic sobre la fila con el formulario a eliminar y pulse el botón Eliminar, con esto el formulario quedará eliminado del sistema. Tenga en cuenta que esta operación no es reversible y recuerde validar el modelo de procesos que no se encuentre utilizando el formulario a eliminar.

Diseño de Formularios

Al momento de generar un nuevo o editar un formulario existente, ingresará a la ventana de trabajo para diseñar formularios, la cual se visualiza a continuación:

Para diseñar el formulario, existen innumerables botones funcionales que se adecuarán a sus necesidades. A medida que se vayan incorporando los nuevos componentes los cambios se irán reflejando en tiempo real dentro del diseñador de formularios, cada uno de estos objetos y su uso se detalla a continuación.

Título

• Botón Título: Permite ingresar uno o varios títulos al formulario. Para esto simplemente haga clic sobre el botón título y se desplegará una ventana como la siguiente:

En donde:

• Campo Etiqueta: deberá ingresar el texto para el título.
• Campo Visible solo si: permite aplicar una regla básica de negocio al presionar sobre el botón String, o si presiona el botón RegEx podrá ingresar una expresión regular para su validación.

Una vez ingresado estos campos, el campo Título será reflejado inmediatamente en el diseñador de formulario, dado que se para este manual nos estamos basando la Solicitud de Vacaciones, nuestro título quedará como sigue:

Subtítulo

• Botón Subtítulo: Permite ingresar uno o varios Subtítulos al formulario. Para esto sólo debe hacer clic sobre el botón subtítulo y una ventana similar a la siguiente se abrirá:

En donde:

• Campo Etiqueta: deberá ingresar el texto para el subtítulo.
• Campo Visible solo si: permite aplicar una regla básica de negocio al presionar sobre el botón String, o si presiona el botón RegEx podrá ingresar una expresión regular para su validación.

Una vez ingresado los campos indicados, el Subtítulo será reflejado inmediatamente en el diseñador de formulario. Dado que este manual ejemplifica mediante el proceso Solicitud de Vacaciones, nuestro Subtítulo se visualizará de la siguiente manera:

Párrafo

• Botón Párrafo: Permite escribir un párrafo de texto libre dentro del formulario, habitualmente este texto es informativo, sólo debe hacer clic sobre el botón Párrafo y una ventana como la siguiente se abrirá:

En donde:

• Campo Etiqueta: deberá ingresar el texto para el párrafo. Usted podrá utilizar código HTML en este campo, para añadir diseño a su texto.
• Campo Visible solo si: permite aplicar una regla básica de negocio al presionar sobre el botón String, o si presiona el botón RegEx podrá ingresar una expresión regular para su validación.

Una vez ingresado los campos indicados, el párrafo (texto) escrito será reflejado inmediatamente en el diseñador de formulario. Dado que este manual ejemplifica mediante el proceso Solicitud de Vacaciones, nuestro Párrafo quedará reflejado de la siguiente manera:

Documento

• Botón Documento: Permite enlazar un documento previamente establecido en simpleBPM, de tal forma de disponibilidad un link para su acceso, para esto sólo debe hacer clic sobre el botón Documento y una ventana como la siguiente se abrirá:

En donde:

• Campo Etiqueta: deberá ingresar el texto del link para bajar el documento.
• Campo Visible solo si: puede aplicar una regla básica de negocio al presionar sobre el botón String (comparar dos valores), o si presiona el botón RegEx podrá ingresar una expresión regular, para validar el campo y definir su visibilidad.
• Campo Documento: se debe seleccionar un documento previamente diseñado en simpleBPM, el cual será descargado al hacer clic sobre el link indicado.
• Radio de selección: "El documento se genera solo la primera vez que se visualiza este campo" indicará que el documento es único y que se genera sólo la primera vez en que se visualiza el campo, mientras que "El documento se regenera cada vez que se visualiza este campo." indica que cada vez que se muestra el documento a lo largo del proceso es generado una nueva instancia. Esto permitirá ir generando el certificado entre los distintos grupos resolutores hasta llegar a un certificado final.

Para el caso del campo Documento, la selección del documento se debe realizar de la siguiente forma:

• Deseo firmar con token en este paso: check que indica si es un documento del tipo certificado que requiere firma electrónica avanzada en esta etapa del proceso.

Para confirmar, presione el botón Guardar.

Una vez ingresado los campos indicados, el link para la descarga del documento será reflejado inmediatamente en el diseñador de formulario. Dado que este manual ejemplifica mediante el proceso Solicitud de Vacaciones, nuestro Documento quedará reflejado de la siguiente manera:

Una buena práctica para mejorar la usabilidad de las descargas de documentos, es añadir un párrafo antes del link del documento, indicando “El link siguiente podrá descargar su Documento de Vacaciones”.

Textbox

• Botón Textbox: Permite generar un campo de texto estándar, para el ingreso de información por parte del usuario. Para añadir el Textbox, simplemente haga clic sobre el botón Textbox, y una ventana como la imagen siguiente se abrirá:

En donde:

• Campo Etiqueta: deberá ingresar el texto que identificará el texto. Por ejemplo: Número de Meses.
• Campo Nombre: identifica la variable identificadora única para referencia el campo, para poder realizar validaciones sobre el campo, este campo debe estar en minúscula y sin espacios. Por ejemplo: numero_de_meses, con esto se generará una variable @@numero_de_meses la cual se podrá referenciar más adelante.
• Campo Ayuda contextual: texto de ayuda para describir mejor el campo que será desplegado en la parte inferior de éste, es de caracter opcional.
• Check Sólo lectura: indica que el campo es sólo de lectura y el usuario no podrá realizar ninguna acción sobre él.
• Campo Reglas de validación: permite aplicar reglas de validación predefinidas sobre el campo, cada una de las reglas debe estar separado por carácter | (tubo). El listado de reglas de validación lo puede encontrar en la sección: Reglas de Negocio y Validación.
• Campo Valor por defecto: Es el texto que tendrá el campo automáticamente, habitualmente debiese estar vacío a fin que el usuario ingrese la información.
• Campo Visible solo si: puede aplicar una regla básica de negocio al presionar sobre el botón String (comparar dos valores), o si presiona el botón RegEx podrá ingresar una expresión regular, para validar el campo y definir su visibilidad.

Una vez ingresado los campos indicados, el Textbox será reflejado inmediatamente en el diseñador de formulario. Dado que este manual ejemplifica mediante el proceso Solicitud de Vacaciones, se deberá generar una serie de Textbox (Rut, Nombre, Apellido, Número de Meses, etc) para nuestro formulario, el cual quedará reflejado de la siguiente manera:

Como se puede visualizar se han añadido los campos de textos uno a uno, es recomendable NO incluir campos opcionales dentro del formulario para facilitar los proceso a los usuarios.

Se recomienda ensayar, añadiendo reglas de validación a los campos Textbox al realizar el ejemplo.

Textarea

• Botón Textarea: Permite generar un campo de texto amplio y libre, para que el usuario ingrese libremente información, habitualmente es utilizado para solicitar comentarios y/u observaciones adicionales.

En donde:

• Campo Etiqueta: deberá ingresar el texto que identificará el área de texto. Por ejemplo: Observaciones.
• Campo Nombre: identifica la variable identificadora única para referencia el campo, para poder realizar validaciones sobre el campo, este campo debe estar en minúscula y sin espacios. Por ejemplo: observaciones, con esto se generará una variable @@observaciones la cual se podrá referenciar más adelante.
• Campo Ayuda contextual: texto de ayuda para describir mejor el campo que será desplegado en la parte inferior de éste, es de caracter opcional.
• Check Sólo lectura: indica que el campo es sólo de lectura y el usuario no podrá realizar ninguna acción sobre él.
• Campo Reglas de validación: permite aplicar reglas de validación predefinidas sobre el campo, cada una de las reglas debe estar separado por carácter | (tubo). El listado de reglas de validación lo puede encontrar en la sección: Reglas de Negocio y Validación.
• Campo Valor por defecto: Es el texto que tendrá el campo automáticamente, habitualmente debiese estar vacío a fin que el usuario ingrese la información.
• Campo Visible solo si: puede aplicar una regla básica de negocio al presionar sobre el botón String (comparar dos valores), o si presiona el botón RegEx podrá ingresar una expresión regular, para validar el campo y definir su visibilidad.

Una vez ingresado los campos indicados, el Textarea será reflejado inmediatamente en el diseñador de formulario. En este caso es un campo de observaciones, tal como se ve a continuación:

Select

• Botón Select: Genera un campo de selección en el cual es posible seleccionar una única opción dentro de su listado, también es conocido como combobox. La pantalla de configuración es la siguiente:

En donde:

• Campo Etiqueta: deberá ingresar el texto que identificará el campo Select. Por ejemplo: Selección de Genero.
• Campo Nombre: indica la variable identificadora única para referencia el campo, para poder realizar validaciones sobre el campo, este campo debe estar en minúscula y sin espacios. Por ejemplo: genero, con esto se generará una variable @@genero la cual se podrá referenciar más adelante.
• Campo Ayuda contextual: texto de ayuda para describir mejor el campo que será desplegado en la parte inferior de éste, es de caracter opcional.
• Check Sólo lectura: indica que el campo es sólo de lectura y el usuario no podrá realizar ninguna acción sobre él.
• Campo Reglas de validación: permite aplicar reglas de validación predefinidas sobre el campo, cada una de las reglas debe estar separado por carácter | (tubo). El listado de reglas de validación lo puede encontrar en la sección: Reglas de Negocio y Validación.
• Valor por defecto: Es el texto que tendrá el campo automáticamente, habitualmente debiese estar vacío a fin que el usuario ingrese la información.
• Campo Visible solo si: puede aplicar una regla básica de negocio al presionar sobre el botón String (comparar dos valores), o si presiona el botón RegEx podrá ingresar una expresión regular, para validar el campo y definir su visibilidad.
• Botón Nuevo: dado que este es un campo con un listado predefinido para su selección, es necesario generar el listado, para añadir una fila presione el botón nuevo e indique los valores que tendrá la selección, de la siguiente, por ejemplo:

Otra forma de añadir un listado de opciones es mediante la consulta a un WebService, este WS debe ser REST JSONP y tener la siguiente estructura de modo de cargar automáticamente el listado:

callback([
    {
        "etiqueta": "Etiqueta 1",
        "valor": "Valor 1"
    },
    {
        "etiqueta": "Etiqueta 2",
        "valor": "Valor 2"
    },
])

Para finalizar simplemente presione el botón guardar.

El formulario el campo quedará reflejado de la siguiente manera:

Radio

• Botón Radio: Genera un listado de campos visible dentro de los cuales se podrá seleccionar sólo uno para su uso, es similar al campo Select, salvo que el botón Radio despliega todas las opciones disponibles en la ventana del formulario.

En donde:

• Campo Etiqueta: deberá ingresar el texto que identificará el campo Radio. Por ejemplo: Selección de Genero.
• Campo Nombre: identifica la variable identificadora única para referencia el campo, para poder realizar validaciones sobre el campo, este campo debe estar en minúscula y sin espacios. Por ejemplo: genero, con esto se generará una variable @@genero la cual se podrá referenciar más adelante.
• Campo Ayuda contextual: texto de ayuda para describir mejor el campo que será desplegado en la parte inferior de éste, es de caracter opcional.
• Check Sólo lectura: indica que el campo es sólo de lectura y el usuario no podrá realizar ninguna acción sobre él.
• Campo Reglas de validación: permite aplicar reglas de validación predefinidas sobre el campo, cada una de las reglas debe estar separado por carácter | (tubo). El listado de reglas de validación lo puede encontrar en la sección: Reglas de Negocio y Validación.
• Campo Valor por defecto: Es el texto que tendrá el campo automáticamente, habitualmente debiese estar vacío a fin que el usuario ingrese la información.
• Campo Visible solo si: puede aplicar una regla básica de negocio al presionar sobre el botón String (comparar dos valores), o si presiona el Botón RegEx podrá ingresar una expresión regular, para validar el campo y definir su visibilidad.
• Botón Nuevo: dado que este es un campo con un listado predefinido para su selección, es necesario generar el listado, para añadir una fila presione el botón nuevo e indique los valores que tendrá la selección, de la siguiente, por ejemplo:

Para finalizar simplemente presione el Botón guardar.

El formulario el campo quedará reflejado de la siguiente manera:

Checkbox

• Botón Checkbox: Genera una lista de opciones visibles en el formulario, dentro de las cuales el usuario podrá seleccionar ninguna, una o varias opciones disponibles.

En donde:

• Campo Etiqueta: deberá ingresar el texto que identificará el campo Checkbox. Por ejemplo: Que otras Instituciones le gustaría que se digitalizaran.
• Campo Nombre: identifica la variable identificadora única para referencia el campo, para poder realizar validaciones sobre el campo, este campo debe estar en minúscula y sin espacios. Por ejemplo: genero, con esto se generará una variable @@genero la cual se podrá referenciar más adelante.
• Campo Ayuda contextual: texto de ayuda para describir mejor el campo que será desplegado en la parte inferior de éste, es de carácter opcional.
• Check Sólo lectura: indica que el campo es sólo de lectura y el usuario no podrá realizar ninguna acción sobre él.
• Campo Reglas de validación: permite aplicar reglas de validación predefinidas sobre el campo, cada una de las reglas debe estar separado por carácter | (tubo). El listado de reglas de validación lo puede encontrar en la sección: Reglas de Negocio y Validación.
• Campo Valor por defecto: Es el texto que tendrá el campo automáticamente, habitualmente debiese estar vacío a fin que el usuario ingrese la información.
• Campo Visible solo si: puede aplicar una regla básica de negocio al presionar sobre el botón String (comparar dos valores), o si presiona el botón RegEx podrá ingresar una expresión regular, para validar el campo y definir su visibilidad.
• Botón Nuevo: dado que este es un campo con un listado predefinido para su selección, es necesario generar el listado, para añadir una fila presione el botón nuevo e indique los valores que tendrá la selección, de la siguiente, por ejemplo:

Para finalizar simplemente presione el Botón Guardar.

El campo se visualizará de la siguiente manera en el formulario, dentro de las cuales el usuario podrá seleccionar varias opciones:

File

• Botón File: Permite generar un botón dentro del formulario para subir un archivo al sistema simpleBPM. El tamaño máximo del archivo a subir por defecto es de 20 MB, sin embargo este valor puede variar por lo que es recomentable que valide el máximo tamaño del archivo adjunto con su administrador de sistema.

En donde:

• Campo Etiqueta: deberá ingresar el texto que identificará el campo File. Por ejemplo: Subir Archivo con documentación adicional.
• Campo Nombre: identifica la variable identificadora única para referencia el campo, para poder realizar validaciones sobre el campo, este campo debe estar en minúscula y sin espacios. Por ejemplo: genero, con esto se generará una variable @@archivo la cual se podrá referenciar más adelante.
• Campo Ayuda contextual: texto de ayuda para describir mejor el campo que será desplegado en la parte inferior de éste, es de carácter opcional.
• Check Sólo lectura: indica que el campo es sólo de lectura y el usuario no podrá realizar ninguna acción sobre él.
• Campo Reglas de validación: permite aplicar reglas de validación predefinidas sobre el campo, cada una de las reglas debe estar separado por carácter | (tubo). El listado de reglas de validación lo puede encontrar en la sección: Reglas de Negocio y Validación.
• Campo Valor por defecto: Es el texto que tendrá el campo automáticamente, habitualmente debiese estar vacío a fin que el usuario ingrese la información.
• Campo Visible solo si: puede aplicar una regla básica de negocio al presionar sobre el botón String (comparar dos valores), o si presiona el botón RegEx podrá ingresar una expresión regular, para validar el campo y definir su visibilidad.
• Además dispone de un listado de extensiones de archivos para indicar que tipo de archivos que serán permitidos, pudiendo seleccionar una o varias extensiones.

El campo se visualizará de la siguiente manera en el formulario:

Date

• Botón Date: Permite ingresar un campo de tipo fecha. La ventaja de este campo a diferencia de utilizar un Textbox, es que al pulsar sobre el botón se desplegará un calendario.

En donde:

• Campo Etiqueta: deberá ingresar el texto que identificará el campo Date. Por ejemplo: Fecha de Nacimiento.
• Campo Nombre: identifica la variable identificadora única para referencia el campo, para poder realizar validaciones sobre el campo, este campo debe estar en minúscula y sin espacios. Por ejemplo: genero, con esto se generará una variable @@fecha_nacimiento la cual se podrá referenciar más adelante.
• Campo Ayuda contextual: texto de ayuda para describir mejor el campo que será desplegado en la parte inferior de éste, es de carácter opcional.
• Check Sólo lectura: indica que el campo es sólo de lectura y el usuario no podrá realizar ninguna acción sobre él.
• Campo Reglas de validación: permite aplicar reglas de validación predefinidas sobre el campo, cada una de las reglas debe estar separado por carácter | (tubo). El listado de reglas de validación lo puede encontrar en la sección: Reglas de Negocio y Validación.
• Campo Valor por defecto: Es el texto que tendrá el campo automáticamente, habitualmente debiese estar vacío a fin que el usuario ingrese la información.
• Campo Visible solo si: puede aplicar una regla básica de negocio al presionar sobre el botón String (comparar dos valores), o si presiona el botón RegEx podrá ingresar una expresión regular, para validar el campo y definir su visibilidad.

El campo se visualizará de la siguiente manera en el formulario:

Grilla

• Botón Grilla: permite utilizar grillas o también llamadas tablas dentro del formulario, de modo de ingresar serie de información, por ejemplo listado de integrantes familiares, listado de beneficios solicitados.

En donde:

• Campo Etiqueta: deberá ingresar el texto que identificará el campo Grilla. Por ejemplo: Listado de Hijos.
• Campo Nombre: identifica la variable identificadora única para referencia el campo, para poder realizar validaciones sobre el campo, este campo debe estar en minúscula y sin espacios. Por ejemplo: genero, con esto se generará una variable @@listado_hijos la cual se podrá referenciar más adelante.
• Campo Ayuda contextual: texto de ayuda para describir mejor el campo que será desplegado en la parte inferior de éste, es de carácter opcional.
• Check Sólo lectura: indica que el campo es sólo de lectura y el usuario no podrá realizar ninguna acción sobre él.
• Campo Reglas de validación: permite aplicar reglas de validación predefinidas sobre el campo, cada una de las reglas debe estar separado por carácter | (tubo). El listado de reglas de validación lo puede encontrar en la sección: Reglas de Negocio y Validación.
• Campo Valor por defecto: Es el texto que tendrá el campo automáticamente, habitualmente debiese estar vacío a fin que el usuario ingrese la información.
• Campo Visible solo si: puede aplicar una regla básica de negocio al presionar sobre el botón String (comparar dos valores), o si presiona el botón RegEx podrá ingresar una expresión regular, para validar el campo y definir su visibilidad.
• Botón Nuevo: dado que este es un campo con un listado predefinido para su selección, es necesario generar el listado, para añadir una fila presione el botón nuevo e indique los valores de las columnas y el tipo de datos que tendrá, si es númerico (numeric) o si es texto libre (text), que tendrá la selección, de la siguiente, por ejemplo:

El campo se visualizará de la siguiente manera en el formulario:

Instituciones

• Botón Instituciones: Realiza un llamado a un WebService externo, el cual provee dos campos automáticamente de tipo select con la relación entre instituciones.

En donde:

• Campo Etiqueta: deberá ingresar el texto que identificará el campo Instituciones. Por ejemplo: Institución.
• Campo Nombre: identifica la variable identificadora única para referencia el campo, para poder realizar validaciones sobre el campo, este campo debe estar en minúscula y sin espacios. Por ejemplo: institucion, con esto se generará una variable @@institucion la cual se podrá referenciar más adelante.
• Campo Ayuda contextual: texto de ayuda para describir mejor el campo que será desplegado en la parte inferior de éste, es de caracter opcional.
• Check Sólo lectura: indica que el campo es sólo de lectura y el usuario no podrá realizar ninguna acción sobre él.
• Campo Reglas de validación: permite aplicar reglas de validación predefinidas sobre el campo, cada una de las reglas debe estar separado por carácter | (tubo). El listado de reglas de validación lo puede encontrar en la sección: Reglas de Negocio y Validación.
• Campo Valor por defecto: Es el texto que tendrá el campo automáticamente, habitualmente debiese estar vacío a fin que el usuario ingrese la información.
• Campo Visible solo si: puede aplicar una regla básica de negocio al presionar sobre el botón String (comparar dos valores), o si presiona el botón RegEx podrá ingresar una expresión regular, para validar el campo y definir su visibilidad.

El campo se visualizará de la siguiente manera en el formulario:

Países

• Botón Países: Realiza un llamado a un WebService externo, el cual provee de un campo automáticamente de tipo select con el listado de países.

En donde:

• Campo Etiqueta: deberá ingresar el texto que identificará el campo Instituciones. Por ejemplo: Países.
• Campo Nombre: identifica la variable identificadora única para referencia el campo, para poder realizar validaciones sobre el campo, este campo debe estar en minúscula y sin espacios. Por ejemplo: paises, con esto se generará una variable @@paises la cual se podrá referenciar más adelante.
• Campo Ayuda contextual: texto de ayuda para describir mejor el campo que será desplegado en la parte inferior de éste, es de carácter opcional.
• Check Sólo lectura: indica que el campo es sólo de lectura y el usuario no podrá realizar ninguna acción sobre él.
• Campo Reglas de validación: permite aplicar reglas de validación predefinidas sobre el campo, cada una de las reglas debe estar separado por carácter | (tubo). El listado de reglas de validación lo puede encontrar en la sección: Reglas de Negocio y Validación.
• Campo Valor por defecto: Es el texto que tendrá el campo automáticamente, habitualmente debiese estar vacío a fin que el usuario ingrese la información.
• Campo Visible solo si: puede aplicar una regla básica de negocio al presionar sobre el botón String (comparar dos valores), o si presiona el botón RegEx podrá ingresar una expresión regular, para validar el campo y definir su visibilidad.

El campo se visualizará de la siguiente manera en el formulario:

Comunas

• Botón Comunas: Realiza un llamado a un WebService externo, el cual provee dos campos automáticamente de tipo select con la relación entre Región y Comunas de Chile.

En donde:

• Campo Etiqueta: deberá ingresar el texto que identificará el campo Instituciones. Por ejemplo: Comunas.
• Campo Nombre: identifica la variable identificadora única para referencia el campo, para poder realizar validaciones sobre el campo, este campo debe estar en minúscula y sin espacios. Por ejemplo: comunas, con esto se generará una variable @@comunas la cual se podrá referenciar más adelante.
• Campo Ayuda contextual: texto de ayuda para describir mejor el campo que será desplegado en la parte inferior de éste, es de carácter opcional.
• Check Sólo lectura: indica que el campo es sólo de lectura y el usuario no podrá realizar ninguna acción sobre él.
• Campo Reglas de validación: permite aplicar reglas de validación predefinidas sobre el campo, cada una de las reglas debe estar separado por carácter | (tubo). El listado de reglas de validación lo puede encontrar en la sección: Reglas de Negocio y Validación.
• Campo Valor por defecto: Es el texto que tendrá el campo automáticamente, habitualmente debiese estar vacío a fin que el usuario ingrese la información.
• Campo Visible solo si: puede aplicar una regla básica de negocio al presionar sobre el botón String (comparar dos valores), o si presiona el botón RegEx podrá ingresar una expresión regular, para validar el campo y definir su visibilidad.

El campo se visualizará de la siguiente manera en el formulario:

Moneda

• Botón Moneda: Realiza un llamado a un WebService externo, el cual provee de un campo de tipo select con un listado de monedas.

En donde:

• Campo Etiqueta: deberá ingresar el texto que identificará el campo Instituciones. Por ejemplo: Moneda.
• Campo Nombre: identifica la variable identificadora única para referencia el campo, para poder realizar validaciones sobre el campo, este campo debe estar en minúscula y sin espacios. Por ejemplo: moneda, con esto se generará una variable @@moneda la cual se podrá referenciar más adelante.
• Campo Ayuda contextual: texto de ayuda para describir mejor el campo que será desplegado en la parte inferior de éste, es de carácter opcional.
• Check Sólo lectura: indica que el campo es sólo de lectura y el usuario no podrá realizar ninguna acción sobre él.
• Campo Reglas de validación: permite aplicar reglas de validación predefinidas sobre el campo, cada una de las reglas debe estar separado por carácter | (tubo). El listado de reglas de validación lo puede encontrar en la sección: Reglas de Negocio y Validación.
• Campo Valor por defecto: Es el texto que tendrá el campo automáticamente, habitualmente debiese estar vacío a fin que el usuario ingrese la información.
• Campo Visible solo si: puede aplicar una regla básica de negocio al presionar sobre el botón String (comparar dos valores), o si presiona el botón RegEx podrá ingresar una expresión regular, para validar el campo y definir su visibilidad.

El campo se visualizará de la siguiente manera en el formulario:

JavaScript

• Botón JavaScript: permite integrar código javascript dentro del diseño de los formularios, es muy útil por ejemplo para el calculo de resultados, y diversas validaciones que se deben realizan en el momento.

En donde:

• Campo Etiqueta: en esta sección usted podrá integrar su código en javascript funciones, llamadas a métodos u otros. Tenga cuidado dado que este código se ejecutará tanto en el FrontEnd como en el Backend.
• Campo Visible solo si: puede aplicar una regla básica de negocio al presionar sobre el botón String (comparar dos valores), o si presiona el botón RegEx podrá ingresar una expresión regular, para validar el campo y definir su visibilidad.

El campo se visualizará de la siguiente manera en el formulario, sólo se puede ver los iconos de editar y eliminar, sin texto de por medio:

Reubicar componentes

Si requiere cambiar el orden de los campos no es necesario eliminar y luego reinsertar, simplemente haga clic con el mouse sobre sobre el componente que desea mover y sin soltar el botón del mouse arrástrelo a la posición deseada, con la acción anterior podrá mover los componentes de los formularios a su antojo.

Consejo general para formularios y campos.

Tenga presente que si un campo no es requerido, el campo no debiese añadirse al formulario, aun así si decide añadir el campo y no lo marca como campo requerido por defecto el campo aparecerá marcado con en el nombre dado más la observación (opcional).

MP - 4 - Acciones del Proceso

Las acciones permiten realizar eventos especiales al iniciar o finalizar una tarea del modelo de procesos, en la actualidad existen dos acciones predefinidas que se pueden utilizar al modelar el proceso, siendo el envío de correos y la consulta hacia un WebService.

Para ingresar al menú de acciones simplemente haga clic sobre la pestaña Acciones. Como se indica en la imagen siguiente:

Con lo anterior se abrirá el marco de trabajo para gestionar las acciones, permitiendo realizar las opciones típicas de un mantenedor, siendo las siguientes:

• Botón Nuevo: Permite añadir una acción al modelo de proceso que se encuentra trabajando, en la actualidad existen tres acciones disponibles: envío de correos, llamada hacia un WebService y generación de variables, las cuales se definirán a continuación. Al presionar sobre el botón se abrirá una ventana que le permitirá indicar que acción desea realizar, como se ve en la imagen siguiente:

• Botón Editar: Permite modificar las propiedades de la acción seleccionada, no es posible modificar el tipo de acción seleccionada.

• Botón Eliminar: Permite eliminar una acción definida. Recuerde que la acción de eliminar no es reversible, además siempre debe revisar que su modelo no esté utilizando la acción a eliminar antes de eliminarla.

Acción: "Enviar Correo"

Si selecciona correo electrónico, se desplegará la siguiente ventana, en la cual simplemente debe completar los datos requeridos:

En donde:

• Campo Nombre: Corresponde al nombre de la acción a generar.
• Campo Tipo: es informativo, para que el usuario que tipo de acción está generando.
• Campo Para: indica el destinatario del correo electrónico, pude ser más de uno separado por coma “,” o indicar una variable por parámetro.
• Campo tema: corresponde al asunto del correo electrónico.
• Campo Contenido: es el contenido del correo electrónico.

Para finalizar simplemente presione el botón Guardar.

Acción: "Consultar WebService"

Al seleccionar Consultar WebService podrá realizar un llamado al WS directamente desde simpleBPM, se desplegará la siguiente imagen:

En donde:

• Campo Nombre: Corresponde al nombre de la acción a generar.

• Campo URL: Corresponde a la dirección del WebService que se desea consultar/ejecutar. Considere que mediante la URL indicada también podrá le podrá pasar valores por parámetro al WebService. Por ejemplo, si usted desea pasar la variable Rut como parámetro, debe escribir la URL de la siguiente forma:

  http://servidorweb/webservice/webservice.php?rut=@@rut

Tenga presente, que el WebService DEBE OBLIGATORIAMENTE responder con formato JSON y aceptar consultas vía REST, siendo la salida obligatoria, con la siguiente estructura:

{
    "variable1": "valor1",
    "variable2": "valor2",
    ...
}

Las variables de respuesta, podrán ser utilizadas anteponiendo @@, por ejemplo, al utilizar la variable @@variable2 informará lo que se devuelva como valor2.

---

TIP: Para mayor información sobre el WebService que desea utilizar, acérquese al área de IT a consultar.

---

Dado que nos encontramos realizando un ejemplo para la aprobación o rechazo de solicitud de vacaciones, uno de los WebService a requerir es para Validar la cantidad de días disponibles que tenga ese usuario, de modo que nos retorne mediante el Rut cuantos días disponibles de vacaciones tiene a la fecha. Por lo que la llamada al WebService quedaría de la siguiente forma:

Para finalizar simplemente presione el botón Guardar.

Acción: "Generar Variable"

Si selecciona generar variable podrá generar variables de validación o de cálculos, se desplegará la siguiente ventana, en la cual simplemente debe completar los datos requeridos:

En donde:

• Campo Nombre de la acción: Corresponde al nombre de la acción a generar.
• Campo Tipo: es informativo, para que el usuario que tipo de acción está generando.
• Campo Variable: Corresponde al nombre de la variable.
• Campo Expresión a Evaluar: Corresponde a la expresión regular a evaluar, como por ejemplo se pueden obtener la id del cliente, o realizar cálculos entre distintos datos.

Para finalizar simplemente presione el botón Guardar.

MP - 5 - Diseñador del Proceso

El diseñador del proceso brinda diversas herramientas para el modelamiento de procesos del trámite a digitalizar, aplicar reglas de negocio entre las tareas de los procesos. Para ingresar deberá presionar sobre la pestaña Diseñador, con esto se abrirá la hoja de trabajo del modelo de procesos, con el respectivo nombre del proceso y a su lado derecho una barra de herramientas, tal como se ve a continuación:

Al hacer clic sobre el icono , se desplegará una ventana en la cual podrá modificar el nombre del modelo de proceso, como nos encontramos ejemplificando una solicitud de vacaciones, al proceso lo llamaremos Solicitud de Vacaciones, como se ve en la siguiente imagen:

Luego simplemente presione el botón Guardar y el nuevo nombre del modelo de proceso habrá sido asignado. En esta ventana también podrá seleccionar de manera adicional el tamaño de la grilla que es el tamaño del área de trabajo.

Dentro de la Barra de Herramientas existen diversos iconos funcionales, los cuales se detallan a continuación.

Tarea

Permite generar una nueva tarea en el modelo de proceso. Por ejemplo: Inscripción del Postulante, Evaluación de Beca, solicitud de cupón, etc.

Es importante destacar que todo modelo de procesos debe tener asociada de manera obligatoria una tarea de inicio, y a su vez puede tener una o varias tareas de termino.

Forma de asignación:

Haga clic sobre el icono Tarea , y luego pulse en cualquier lugar de la hoja de trabajo.

Forma de configuración y parametrización:

Haga doble clic sobre la tarea que desea configurar existente en hoja de trabajo. Al hacer esto se abrirá una pantalla que permitirá editar las propiedades de la Tarea, tal como se ve en la siguiente imagen:

Como se visualiza posee la edición de tareas se encuentra subdividida en 6 pestañas, explicadas a continuación.

Tarea - Pestaña Definición

En esta pestaña podrá definir el nombre de la tarea, y si corresponde a una tarea inicial y/o final. Considere que siempre debe existir al menos una tarea inicial en su modelo de procesos, mientras que pude definir una o múltiples tareas de fin, una vez realizado los cambios haga clic en Guardar. A continuación un ejemplo de la visualización de la Pestaña Definición:

Existen 3 formas de activar o desactivar tareas, siendo las siguiente:

• Tarea activada: permite tener activa la tarea perdiendo su ejecución.
• Tarea activa entre fechas: Permite activar la tarea unicamente entre los periodos de tiempo seleccionados, fecha inicial y fecha final.
• Tarea desactivada: Permite tener desactivada la tarea impidiendo su ejecución, las tareas que están desactivadas no son visibles en el tramitador.

También podrá indicar una ayuda contextual a la tarea en el bloque Información para previsualización, la cual será desplegada al momento de pasar el cursor del mouse encima.

Tarea - Pestaña Asignación

En esta pestaña, podrá definir la forma de asignar responsables a la tarea e indicar si requiere notificar mediante correo electrónico al o los responsables asignados, pudiendo ser un usuario en particular o un grupo de usuarios. La ventana de asignación se visualiza como sigue:

Existen 4 formas de asignación de tareas, siendo las siguiente:

• Cíclica: indica que a medida que la tarea esta operativa, es asignada a los miembros del grupo uno tras otro, por ejemplo: si el grupo resolutores tiene a: Pedro y Juan, la primera vez que llegue a la tarea, ésta quedará asignada a Pedro, y la segunda vez a Juan, luego a Pedro y luego a Juan, y así cíclicamente.
• Manual: la asignación de la próxima tarea es consultada al finalizar la tarea actual.
• Auto Servicio: la asignación de la tarea en curso, es autoasignada por un usuario perteneciente al grupo de trabajo, esta asignación la realiza el usuario directamente desde su bandeja de entrada (FrontEnd).
• Usuario: Es asignada directamente a un usuario.

En caso de presionar el check Notificar vía correo electrónico al usuario asignado. simpleBPM automáticamente le enviará un correo electrónico al responsable de la ejecución de la tarea.

Tarea - Pestaña Usuarios

En esta pestaña podrá definir el nivel de acceso hacia la tarea. La ventana de Usuarios se visualiza como sigue:

Son cuatro opciones de configuración:

• Cualquier persona puede acceder: quiere decir que cualquier persona podría acceder a la tarea sin siquiera haber puesto sus credenciales en el sitio, esto es util para dar inicio a un trámite que no requiere registro previo.
• Sólo los usuarios registrados: quiere decir que cualquier persona con acceso mediante registro o ClaveÚnica, podrá visualizar la tarea, por ejemplo iniciar una postulación a beca.
• Sólo los usuarios registrados con ClaveUnica: quiere decir que únicamente las personas que posean su ClaveÚnica podrán ingresar al sistema. Esto es sólo valido para Chile.
• Sólo los siguientes grupos de usuarios pueden acceder: permite seleccionar que tipos de usuarios (habitualmente grupos de usuario) puede acceder a la tarea, por ejemplo: un usuario es del grupo validador de información. Tenga presente que en este campo usted podrá utilizar varibles para la asingación de grupos, por ejemplo: @@grupoResolutor.

Tarea - Pestaña Pasos

Permite asignar formularios de trabajo a la tarea con su respectivo orden, condiciones de despliegue y modo despliegue. Considere que para asignar los formularios, deben estar previamente elaborados.

Tal como se desarrollo en el manual el formulario principal (Sección Generación y edición de Formularios), utilizaremos seleccionaremos este formulario y presionaremos el botón para añadirlo dentro del paso, si se requieren formularios adicionales sólo se debe seleccionar del listado otro formulario y repetir la acción con el botón .

Es posible aplicar reglas de negocio para diferenciar el despliegue del formulario si es para visualizar o editar. Puede ver su utilización en la sección Reglas de negocio y validación.

Tarea - Pestaña Eventos

Permite ejecutar acciones como el envío de un correo electrónico o la ejecución de un WebService, antes (al iniciar la tarea) o después (al finalizar la tarea) de ejecutar la tarea. Recuerde, que las acciones a asignar deben estar previamente establecidas.

En la sección se han definido se ha definido enviar un correo electrónico una vez que la tarea finalice. En este caso se debe seleccionar "Correo al Solicitante" y añadir el Envío de correo después de ejecutar la tarea presionando el botón .

Para finalizar sólo presionar el botón Guardar.

Recuerde que es permitido la aplicación de reglas de negocio, puede ver su utilización en la sección Reglas de negocio y validación.

Tarea - Pestaña Vencimiento

La funcionalidad de la pestaña vencimiento, permite definir la duración de la tarea en días meses o años, ademas permite definir el o los correos de notificación cuando falte una cantidad de días definido antes del vencimiento de dicha tarea. Esta pestaña tiene la siguiente estructura:

Pestaña Otros

La funcionalidad de la pestaña otros, es permitir almacenar con un identificador único al usuario que inició la tarea en una variable, esta opción es útil cuando al finalizar el proceso se debe contactar y/o entregar algún certificado al usuario que solicito la información.

Conexión Secuencial

Permite unir dos tareas del modelo de procesos de forma secuencial.

Forma para relacionar tareas:

Para relacionar dos tareas, haga clic sobre el icono Conexión Secuencial , y luego haga clic sobre dos tareas que desee conectar. Si requiere realizar más conexiones, repita el procedimiento entre otras tareas, siempre uno a uno.

---

Consideración Importante: por restricciones del aplicativo, independiente que si usted selecciona más de un origen-destino, para el caso de la conexión secuencial, siempre se ejecutará la primera selección del listado.

---

Modo de edición y configuración de la conexión:

Haga doble clic sobre la conexión que desea configurar existente en hoja de trabajo. Al hacer esto se abrirá una pantalla que permitirá Editar la conexión, tal como se ve en la siguiente imagen:

En esta clase de conexión no es posible aplicar reglas de negocio.

Para finalizar la edición presione el botón Guardar.

Eliminar conexión:

Para eliminar una conexión, simplemente ingrese en modo de edición de conexión y haga clic sobre el botón Eliminar.

Conexión por Evaluación

Permite unir dos o más tareas del modelo de procesos, mediante una evaluación de lógica de negocio. Por ejemplo: Validar que la edad de un postulante sea menor a 18 años.

Forma para relacionar tareas:

Para relacionar tareas haga clic sobre el icono Conexión por Evaluación, y luego haga clic sobre dos tareas para realizar la unión. Si requiere realizar más conexiones, repita el procedimiento.

Modo de edición y configuración de la conexión:

Haga doble clic sobre la conexión que desea configurar existente en hoja de trabajo. Al hacer esto se abrirá una pantalla que permitirá editar la conexión, tal como se ve en la siguiente imagen:

Este tipo de conexión permite la aplicación de reglas de negocio, puede ver su utilización en la sección Reglas de negocio y validación.

Para finalizar la edición presione el botón Guardar.

Eliminar conexión:

Para eliminar una conexión, simplemente ingrese en modo de edición de conexión y haga clic sobre el botón Eliminar.

Conexión Paralela

Permite realizar dos o más tareas de forma paralela luego de la ejecución de una tarea en particular. Un ejemplo de ello, es validar por dos o más áreas el otorgamiento de una beca.

Forma de relación entre tareas:

Haga clic sobre el icono Conexión Paralela, y luego haga clic sobre dos tareas para realizar la unión. Si requiere realizar más conexiones, repita el procedimiento.

Modo de edición y configuración de la conexión:

Haga doble clic sobre conexión que desea configurar existente en hoja de trabajo. Al hacer esto se abrirá una pantalla que permitirá Editar la Conexión, tal como se ve en la siguiente imagen:

Este tipo de conexión no permite la aplicación de reglas de negocio, sólo deriva desde una tarea principal el flujo hacia dos tareas independientes.

Para finalizar la edición simplemente presione el botón Guardar.

Eliminar conexión:

Para eliminar una conexión, simplemente ingrese en modo de edición de conexión y haga clic sobre el botón Eliminar.

Conexión Paralela con Evaluación

Permite realizar dos o más tareas de forma paralela luego de la ejecución y evaluación de una regla de negocio de una o varias tareas. Un ejemplo de ello, es validar por dos o más áreas el otorgamiento de una beca, sólo cuando el ciudadano tenga menos de 24 años.

Forma de relacionar tareas:

Haga clic sobre el icono Conexión Paralela con Evaluación, y luego haga clic sobre dos tareas para realizar la unión. Si requiere realizar más conexiones, repita el procedimiento.

Forma de configuración y parametrización:

Haga doble clic sobre la conexión que desea configurar existente en hoja de trabajo. Al hacer esto se abrirá una pantalla que permitirá editar la conexión, tal como se ve en la siguiente imagen:

Este tipo de conexión permite la aplicación de reglas de negocio.

Para finalizar la edición simplemente presione el botón Guardar.

Eliminar conexión:

Para eliminar una conexión, simplemente ingrese en modo de edición de conexión y haga clic sobre el botón Eliminar.

Conexión de Unión

Permite unir dos o más tareas realizadas de forma paralela, para asociarlas de tal forma que el flujo siga de forma lineal.

Forma de asignación entre tareas:

Haga clic sobre el icono Conexión de Unión , y luego haga clic sobre dos tareas para realizar la unión. Si requiere realizar más conexiones, repita el procedimiento.

Forma de configuración y parametrización:

Haga doble clic sobre la conexión que desea configurar existente en hoja de trabajo. Al hacer esto se abrirá una pantalla que permitirá Editar la Tarea, tal como se ve en la siguiente imagen:

Este tipo de conexión no permite la aplicación de reglas de negocio, sólo une una serie de tareas para asociarlas sólo a una final.

Para finalizar la edición simplemente presione el botón Guardar.

Eliminar conexión:

Para eliminar una conexión, simplemente ingrese en modo de edición de conexión y haga clic sobre el botón Eliminar.

Proceso General de Solicitud de Vacaciones

Para nuestro caso de solicitud de vacaciones (el cual podrá revisar en la sección Vídeos), el proceso quedaría Modelado para simpleBPM de la siguiente forma:

MP - Reglas de Negocio y Validación

Sintaxis para la correcta aplicación de reglas de negocio y reglas de validación

Para aplicar reglas de negocio sobre tareas, conectores y/o formularios, es necesario conocer la sintaxis, por este motivo en esta sección se indican los distintos objetos disponibles para aplicar regla de negocio y de validación de campos.

Reglas de Negocio

• Variables: mantienen el valor de un campo en memoria, simpleBPM admite cuatro tipos de variables, para utilizar cada una de estas debe utilizarlas de la siguiente manera:

• Variable de Formulario: tal como se indicó en la sección de Generación de Formularios, cada campo que se han añadido en los diversos formularios del modelo de proceso se encuentran identificados por su nombre, para hacer uso del campo, se debe llamar por su variable y esto se realiza anteponiendo dos arrobas (@@) antes del nombre del campo, su uso general es: @@variable_de_formulario, por ejemplo: @@direccion_usuario.

Las variables no pueden tener espacios entre las palabras, los espacios se sustituyen con el símbolo _ automáticamente

• Variables de Sesión: las variables de sesión son variables especiales de simpleBPM, que completan la información de acuerdo al usuario que se encuentra registrado (logeado) realizando la etapa del trámite, su uso es de la siguiente manera: @!variable_de_sesion, las palabras claves admitidas en simpleBPM son las siguientes: @!rut, @!nombres, @!apellido_paterno, @apellido_materno, @!email, @!tramite_id (este último campo otorga el ID de trámite que se está cursando).

• Variables Globales del trámite: estas variables obtienen el conjunto de toda la información que una variable tenga en TODOS los procesos/trámites generados, la forma de identificarlo es con un @#variable, un ejemplo útil del uso de esta variable es permitir identificar si una solicitud de trámite ya ha sido solicitada, o si un ciudadano ya solicitó un trámite en particular, esto se realizaría leyendo la variable @#ciudadano y luego buscando dentro del arreglo que entrega in_array(@#ciudadano) con esto último se validará si el ciudadano está en el arreglo.

• Variables Listados Especiales: estas variables son las generadas al momento de utilizar los botones de Instituciones, Países, Comunas y Monedas, las cuales para acceder se deberá utilizar la siguiente nomenclatura: @@comunas->region con esto se obtendrá la región del campo comuna que usted ha generado, tenga presente que el nombre comuna es el que usted le dio. Otro ejemplo sería @@moneda->moneda para obtener la moneda seleccionada del campo moneda que usted seleccionó.

Operadores Lógicos, relacionales y de igualdad

Son operadores que permiten realizar comparativas entre un valor u otro.

• Menor ‘<’: indica que el campo de la izquierda es menor al campo de la derecha, de ser así la sintaxis sería verdadera. Ejemplo: @@edad < 35, si un usuario ingresa la edad en un formulario menor a 35 entonces esta sintaxis sería verdadera.

• Mayor ‘>’: indica que el campo de la izquierda es mayor al campo de la derecha, de ser así la sintaxis sería verdadera. Ejemplo: @@edad > 35, si un usuario ingresa la edad en un formulario mayor a 35 entonces esta sintaxis sería verdadera. De lo contrario la sintaxis es falsa.

• Menor o igual ‘<=’: indica que el campo de la izquierda es menor o igual al campo de la derecha, de ser así la sintaxis sería verdadera. Ejemplo: @@edad =< 35, si un usuario ingresa la edad en un formulario menor a 35 o igual a 35 entonces esta sintaxis sería verdadera.

• Mayor o igual ‘>=’: indica que el campo de la izquierda es mayor o igual al campo de la derecha, de ser así la sintaxis sería verdadera. Ejemplo: @@edad =< 35, si un usuario ingresa la edad en un formulario mayor a 35 o igual a 35 entonces esta sintaxis sería verdadera.

• Igual a… ‘==’: indica que el campo de la izquierda es igual al campo de la derecha. Por ejemplo: @@edad_ingreso == @@edad_egreso, se compara el valor de ambas variables y si son iguales entonces la regla es verdadera.

• Y ‘&&’: evalúa dos expresiones, si ambas son verdaderas entonces el resultado es verdadero, por ejemplo: @@nombre == ‘pedro’ && @@edad <= ‘35’, si la instrucción anterior se cumple entonces la regla es verdadera.

• O ‘||’: evalúa dos expresiones, si una de ellas es verdadera, entonces el resultado es verdadero, por ejemplo: @@nombre == ‘pedro’ || @@edad <= ‘35’, si la variable @@nombre es diego, pero la variable @@edad es 30, entonces la instrucción se cumple por lo tanto la regla es verdadera.

Funciones matemática

Es posible aplicar una serie de funciones matemáticas a las reglas de validación, están son basadas en el lenguaje de programación PHP, entre las cuales se destacan:

• Sqrt: obtiene la raíz cuadrada de un elemento.
• Pow: eleva un número, base con exponente.
• Abs: obtiene el valor absoluto de un número.
• Log: obtiene el logaritmo de un número.

---

TIP: Dado que son una infinidad de funciones matemáticas incluidas, las cuales están fuera del alcance del manual, puede dirigirse al enlace siguiente, a fin de obtener mayor información: http://php.net/manual/en/book.math.php (sitio en inglés).

---

Ejemplos de aplicación de Regla de Negocio:

En el siguiente caso, el formulario se desplegará en modo de visualización únicamente si el Rut (identificador nacional de Chile) es distinto a vacío:

El ejemplo siguiente, para el mismo formulario, si el Rut (identificador nacional de Chile) está vacío y la edad es menor o igual a 18, el formulario será visible en modo de edición

Reglas de validación automática

Estas reglas deben ser separadas mediante el símbolo | (tubo) en el campo a validar al momento de integrarlas a los formularios, el listado básico es el siguiente:

Regla	Parám. de Entrada	Descripción	Ejemplo de Uso
Rut	No	Valida campo Rut con su lógica.	-
Required	No	Señala que el campo debe ser requerido. Retorna Falso si el campo está vacío.	-
Matches	Si	Compara el campo actual con un campo del formulario que debe ser pasado por parámetro. Si son negativos retorna Falso.	matches[form_item]
min_length	Si	Retorna Falso si el largo del campo es menor a lo indicado por parámetro.	min_length[6]
max_length	Si	Retorna Falso si el largo del campo es mayor a lo indicado por parámetro.	max_length[12]
exact_length	Si	Retorna Falso si el largo del campo no es exacto al valor indicado por parámetro.	exact_length[8]
greater_than	Si	Retorna Falso si el largo del campo es menor al indicado por parámetro.	greater_than[8]
less_than	Si	Retorna Falso si el largo del campo es mayor al indicado por parámetro.	less_than[8]
Alpha	No	Retorna Falso si el campo contiene cualquier carácter distinto al abecedario.	-
alpha_numeric	No	Retorna Falso si el campo contiene cualquier carácter distinto a alfanumérico.	-
alpha_dash	No	Retorna Falso si el campo contiene cualquier carácter distinto a alfanumérico, caracteres numéricos, barras.	-
numeric	No	Retorna Falso si el campo no es numérico.	-
integer	No	Retorna Falso si el campo no es un valor entero.	-
is_natural	No	Retorna Falso si el campo no es un número natural.	-
is_natural_no_zero	No	Retorna Falso si el campo no es un número natural excluyendo el cero.	-
valid_email	No	Retorna Falso si el campo no es un correo electrónico válido.	-
valid_emails	No	Retorna Falso si los correos electrónicos indicados en el campo no son correos electrónicos válidos.	-

Ejemplos Generales de validación de campos

Para el campo Rut del formulario generado, se validará que se ingrese sea un Rut válido además que el campo sea obligatorio, como se puede visualizar ambas instrucciones se encuentran separadas por | (tubo):

El siguiente ejemplo, solicita la edad con la restricción que sea un número natural distinto a cero:

Seguimiento de Procesos

A medida que los Procesos implementados en simpleBPM se vayan utilizando, éstos empezarán a pasar por las diversas tareas definidas en el Proceso en las cuales internamente se irá registrando su etapa actual, el responsable, fecha de asignación, y diversos datos informativos del Proceso.

---

Esta opción se encuentra disponible únicamente para usuario con acceso a BackEnd, no para el usuario quien ha generado el trámite.

---

Para revisar el seguimiento, debe dirigirse hacia el menú de Seguimiento dentro del menú principal de BackEnd con esto ingresará al seguimiento de trámites de simpleBPM.

La siguiente imagen representa la pantalla de trabajo para la realización de seguimientos en donde se desplegarán todos los procesos disponibles:

Deberá seleccionar un proceso para realizar su seguimiento haciendo clic en el botón Ver Seguimiento, luego de esto se desplegarán todas las instancias del proceso iniciadas en simpleBPM, de la siguiente forma:

Como se visualiza en la imagen anterior desplegarán todos los trámites iniciados en simpleBPM sin filtros, indicando:

• ID
• Estado
• Etapa actual en que se encuentra el trámite
• Fecha de creación
• Fecha con la última fecha realizada sobre el trámite.

Para revisar el detalle de un trámite en particular deberá hacer clic sobre el botón Seguimiento del costado derecho del trámite a visualizar, con esto se abrirá la ventana de detalle para un seguimiento de simpleBPM, tal como se puede visualizar en la siguiente imagen:

Se puede apreciar en la imagen el despliegue de las tareas del proceso correspondiente a "Certificado de Nacimiento" cada color de caja representa el estado actual de la tarea, siendo los siguientes:

• Caja Verde : Indica que la tarea del proceso se ha realizado, por lo que el proceso avanzó a la siguiente tarea.
• Caja Amarillo : Indica que la tarea esta seleccionada pero aún no ha sido gestionado su procesamiento, el proceso se encuentra en este estado, a la espera de ser procesado.
• Caja Azul : Indica una tarea en la cual el flujo del proceso aún no llega a su ejecución, o el flujo del proceso por su lógica interna no pasó por esta tarea.

En el costado derecho del a ventana, podrá visualizar el registro de eventos completo del proceso, el cual le indicará el estado de la tarea, fecha de inicio, fecha de termino, cual fue el usuario asignado, puede ver aún más detalles presionando sobre el link Revisar detalle con el cual usted podrá ver todo el detalle de la etapa del proceso e incluso reasignar las tareas asociadas, como se ve a continuación:

En donde:

• Bloque Izquierdo: Podrá revisar quien a efectuado la tarea y reasignarla si así lo requiere.
• Bloque Derecho: Podrá revisar todas las acciones y respuestas efectuadas en los formularios asociados a la tarea.

Gestión

El menú Gestión permitirá generar reportes básicos en formato XLS (Microsoft Excel) de los procesos de simpleBPM, mediante la selección de columnas de cualquier campo generado en los formularios de un Proceso en particular, la siguiente imagen despliega el listado de proceso de los cuales se desee obtener el reporte:

Para generar su reporte, simplemente debe hacer clic sobre el botón Ver Reportes correspondiente al Proceso, con lo cual se desplegará la siguiente pantalla relacionada al Proceso que ha seleccionado, será desplegado un nuevo marco de trabajo para gestionar los reportes, lo cual le permitirá al igual que todo mantenedor, realizar las acciones de generación, visualización, edición y eliminación de un reporte, como se ve a continuación:

Cada una de los distintos botones de acción, son explicados a continuación:

• Botón Nuevo: Permite generar un nuevo reporte en dentro de simpleBPM. Al presionar sobre el botón ingresará al asistente para generar reportes simpleBPM, como se ve en la siguiente imagen:

En donde:

• Campo Nombre: Corresponde al nombre del reporte a generar.
• Campo Campos: permite seleccionar del listado de campos disponibles, cuales serán visibles en el reporte. Para seleccionar más de un campo mantenga presionado la tecla Ctrl de su teclado y haga clic sobre los campos que desea integrar a su reporte.

Cabe destacar que adicional a los campos definidos para el reporte, el sistema incluye de forma automática los campos id del proceso y estado del proceso.

Tenga presente que los reportes son visibles únicamente desde BackEnd, no es posible visualizarlos de manera directa mediante una cuenta de usuario estándar. Además los reportes generados tienen formato Microsoft Excel e incluyen todos los procesos iniciados hasta el momento de la visualización del reporte.

• Botón Ver: Permite descargar un reporte existente en el sistema para su visualización, para esto debe hacer clic sobre el botón ver de la fila del reporte que desea visualizar que iniciará la descarga y luego abrir el archivo adjunto. Como se ven en las siguiente imágenes:

• Botón Editar: Permite modificar un reporte existente en simpleBPM abriendo el asistente de reportes de simpleBPM, con esta opción podrá cambiar el nombre del reporte, añadir o quitar campos del reporte seleccionado. Para esto debe seleccionar de la fila el reporte a editar, como se ve en la imagen siguiente:

Y posteriormente se desplegará el asistente de reporte, con la información original precargada:

Una vez modificados los campos, simplemente presione el botón Guardar y el reporte habrá quedado almacenado en simpleBPM.

• Botón Eliminar: Permite eliminar un reporte existente en simpleBPM, para esto haga clic sobre la fila con el reporte a eliminar y pulse el botón Eliminar, con esto el reporte quedará eliminado del sistema, esta operación NO es reversible.

API

API - Introducción

La API de SIMPLE permite generar tus propios reportes e informes, extrayendo la información de la plataforma en tiempo real.

Para acceder al menú API, haga clic sobre el menú principal y luego API, tal como se indica en la imagen siguiente:

---

TIP: Esta sección es para usuarios avanzados y con conocimientos de programación.

---

Autorización

Para hacer llamadas a esta API se requerirá un código de acceso (token) que se enviará como parámetro en cada request.

De no haber configurado un código de acceso, para poder acceder a la API deberá configurar un nuevo código de acceso.

Llamadas a la API

El diseño de la API de este portal sigue un modelo REST. Eso significa que se utilizan los métodos estándares HTTP para obtener la información. Por ejemplo, si deseas obtener una ficha en particular, deberías enviar un request HTTP como el siguiente:

GET http://demo.simplebpm.cl/backend/api/tramites/{tramiteId}?token={token}

Parámetros comunes

Los diferentes métodos de esta interfaz de programación requieren distintos atributos como parte de la URL, como parámetros de la consulta. Adicionalmente hay parámetros que son comunes para todos los métodos:

Nombre del parámetro	Valor	Descripción
token	string	Código de acceso para acceder a los métodos de esta API.

Formatos de los datos

Los recursos de la API de este portal vienen en formato JSON. Este es un ejemplo de cómo se vería un trámite.

{
    "tramite":{
        "id":496,
        "estado":"completado",
        "proceso_id":11,
        "fecha_inicio":"2013-07-12 11:13:56",
        "fecha_modificacion":"2013-07-12 11:14:00",
        "fecha_termino":"2013-07-12 11:14:00",
        "etapas":[
            {
                "id":704,
                "estado":"completado",
                "usuario_asignado":{
                    "usuario":"jperez",
                    "email":"jperez@ejemplo.com",
                    "nombres":"Juan",
                    "apellido_paterno":"Perez",
                    "apellido_materno":"Cotapo"
                },
                "fecha_inicio":"2013-07-12 11:13:56",
                "fecha_modificacion":"2013-07-12 11:14:00",
                "fecha_termino":"2013-07-12 11:14:00",
                "fecha_vencimiento":null
            }
        ],
        "datos":[
            {
                "511bb6183cea8":"51e021b44939e.pdf"
            },
            {
                "materno":"COTAPO"
            },
            {
                "nombres":"JUAN"
            },
            {
                "paterno":"PEREZ"
            },
            {
                "situacion":true
            }
        ]
    }
}

API - Autorización

API - Configurar Código de Acceso

Para poder acceder a la API deberás configurar un código de acceso (token). Si dejas en blanco el token no se podrá acceder a la API.

Para la configuración, vaya al panel izquierdo, seleccionado Código de Acceso y luego complete el campo token, como se indica a continuación:

---

TIP: Es recomendable especificar un código aleatorio de máximo 32 caracteres.

---

API - Trámites

API - Obtener

Obtiene información de un proceso desde simpleBPM.

Request HTTP

GET http://demo.simplebpm.cl/backend/api/tramites/{tramiteId}?token={token}

Parámetros

Nombre del Parámetro	Valor	Descripción
tramiteId	int	Identificador único de un trámite en SIMPLE.

Response HTTP

Si el request es correcto, se devuelve un recurso tramite, como el siguiente con estructura JSON:

{
    "tramite":{
        "id":496,
        "estado":"completado",
        "proceso_id":11,
        "fecha_inicio":"2013-07-12 11:13:56",
        "fecha_modificacion":"2013-07-12 11:14:00",
        "fecha_termino":"2013-07-12 11:14:00",
        "etapas":[
            {
                "id":704,
                "estado":"completado",
                "usuario_asignado":{
                    "usuario":"jperez",
                    "email":"jperez@ejemplo.com",
                    "nombres":"Juan",
                    "apellido_paterno":"Perez",
                    "apellido_materno":"Cotapo"
                },
                "fecha_inicio":"2013-07-12 11:13:56",
                "fecha_modificacion":"2013-07-12 11:14:00",
                "fecha_termino":"2013-07-12 11:14:00",
                "fecha_vencimiento":null
            }
        ],
        "datos":[
            {
                "511bb6183cea8":"51e021b44939e.pdf"
            },
            {
                "materno":"COTAPO"
            },
            {
                "nombres":"JUAN"
            },
            {
                "paterno":"PEREZ"
            },
            {
                "situacion":true
            }
        ]
    }
}

API - Listar

Lista todos los trámites.

Request HTTP

GET http://demo.simplebpm.cl/backend/api/tramites?token={token}

Parámetros (opcionales)

Nombre del Parámetro	Valor	Descripción
maxResults	int	El número máximo de resultados que debería contener la respuesta. Valores aceptables son del 1 al 20. Por defecto: 10.
pageToken	string	El token de continuación. Usado para la paginación entre varios sets de resultados. Para obtener la próxima página de resultados se debe setear este parámetro con el valor de "nextPageToken" entregado en la respuesta previa.

Response HTTP

Si el request es correcto, se devuelve la siguiente estructura:

{
    "tramites":{
        "titulo":"Listado de Tramites",
        "tipo":"#tramitesFeed",
        "nextPageToken":{string},
        "items":[
            recurso tramite
        ]
    }
}

Las propiedades que incorpora esta respuesta son:

Nombre del Parámetro	Valor	Descripción
titulo	string	El título de este listado de trámites.
tipo	string	Identifica el nombre de este recurso.
nextPageToken	string	El token de continuación. Usado para paginar entre varios sets de resultados. Proveer este valor en requests subsiguientes para obtener la próxima página de resultados.
items	array	El listado de trámites.

API - Listar por Proceso

Lista todos los trámites que han sido parte de un proceso en particular.

Request HTTP

GET http://demo.simplebpm.cl/backend/api/procesos/{procesoId}/tramites?token={token}

Parámetros

Nombre del Parámetro	Valor	Descripción
procesoId	int	Identificador de un proceso.

Parametros Opcionales

Nombre del Parámetro	Valor	Descripción
maxResults	int	El número máximo de resultados que debería contener la respuesta. Valores aceptables son del 1 al 20. Por defecto: 10.
pageToken	string	El token de continuación. Usado para la paginación entre varios sets de resultados. Para obtener la próxima página de resultados se debe setear este parámetro con el valor de "nextPageToken" entregado en la respuesta previa.

Response HTTP

Si el request es correcto, se devuelve la siguiente estructura:

{
    "tramites":{
        "titulo":"Listado de Tramites",
        "tipo":"#tramitesFeed",
        "nextPageToken":{string},
        "items":[
            recurso tramite
        ]
    }
}

Las propiedades que incorpora esta respuesta son:

Nombre del Parámetro	Valor	Descripción
titulo	string	El título de este listado de trámites.
tipo	string	Identifica el nombre de este recurso.
nextPageToken	string	El token de continuación. Usado para paginar entre varios sets de resultados. Proveer este valor en requests subsiguientes para obtener la próxima página de resultados.
items	array	El listado de trámites.

API - Procesos

API - Obtener

Obtiene un procesos desde simpleBPM.

Request HTTP

GET http://demo.simplebpm.cl/backend/api/procesos/{procesoId}?token={token}

Parámetros

Nombre del Parámetro	Valor	Descripción
procesoId	int	Identificador único de un proceso en simpleBPM.

Response HTTP

Si el request es correcto, se devuelve un recurso proceso.

API - Listar

Lista todos los procesos.

Request HTTP

GET http://demo.simplebpm.cl/backend/api/procesos?token={token}

Response HTTP

Si el request es correcto, se devuelve la siguiente estructura:

{
    "procesos":{
        "titulo":"Listado de Procesos",
        "tipo":"#procesosFeed",
        "items":[
            recurso proceso
        ]
    }
}

Las propiedades que incorpora esta respuesta son:

Nombre del Parámetro	Valor	Descripción
titulo	string	El título de este listado de procesos.
tipo	string	Identifica el nombre de este recurso.
items	array	El listado de procesos.

Widgets

Los Widgets en simpleBPM permiten entregar gráficos estadísticos ya sea por etapa actual del proceso, por el estado del trámite (completados/pendientes) o por la carga de trabajo de los usuarios, actualizados en tiempo real de acuerdo a los movimientos de los procesos.

Estos gráficos los puede ubicar en el menú de Inicio al haber ingresado a simpleBPM como usuario BackEnd, por lo que para acceder deberá hacer clic sobre la pestaña Inicio. Como se indica en la imagen siguiente:

Luego haga clic sobre el botón Nuevo Widget y seleccione el tipo de Widget que desea añadir al Menú de Inicio. Existen tres tipos de Widgets predefinidos:

• Trámites por etapas: desplegará la proporción en que etapas se encuentra un trámite seleccionado.
• Trámites realizados: desplegará cuantos trámites por proceso se encuentran pendientes y finalizados.
• Carga de Usuarios por Etapa: desplegará la carga por usuarios para una etapa en particular del proceso.

Como se ven en la imagen:

Una vez seleccionado el tipo de Widget seleccionado se deberá aplicar su parametrización, para ello haga clic sobre el icono demarcado en rojo de la siguiente imagen:

Finalmente, simplemente ingrese los datos requeridos por el Widget, seleccione el proceso asociado y pulse el botón ok. De la siguiente manera:

Como resultado usted verá inmediatamente el Widget operativo en el portal, en el menú de inicio:

Ayuda

La sección Menú 'Ayuda' corresponde a la documentación que se encuentra leyendo.