Merge pull request #71 from Bonitasoft-Community/2023-update

Updating to version 2023.2

README.md

@@ -5,38 +5,35 @@ The main objective of this training is to familiarize yourself with concepts and
 Bonita Camp include both theoretical knowledge and hands on with exercises that let you build your first Bonita application.
 Bonita Camp comes with:
 
-- A set of slides commented in a [series of videos](https://www.youtube.com/playlist?list=PLvvoQatxaHOMHRiP7hFayNXTJNdxIEiYp) (also available in [French](https://www.youtube.com/playlist?list=PLvvoQatxaHOPSATzZe-zPh-LrSNGfpQEf) and [Spanish](https://www.youtube.com/playlist?list=PLvvoQatxaHOOgWEMHZjk5rjc9qsCnh7bi)) or during live sessions
 - A set of exercises described on a [dedicated web site](http://bonitasoft-community.github.io/bonita-camp/)
 - [Exercises solutions](https://github.com/Bonitasoft-Community/bonita-camp/releases/latest)
+-  [Outdated - based on Bonita 2021.2] A set of slides commented in a [series of videos](https://www.youtube.com/playlist?list=PLvvoQatxaHOMHRiP7hFayNXTJNdxIEiYp) (also available in [French](https://www.youtube.com/playlist?list=PLvvoQatxaHOPSATzZe-zPh-LrSNGfpQEf) and [Spanish](https://www.youtube.com/playlist?list=PLvvoQatxaHOOgWEMHZjk5rjc9qsCnh7bi)) or during live sessions
 
 If you need assistance you can:
 
-- Ask your question on our dedicated **Bonita Camp Discord channel** if you have attended a live session
 - Ask your question on **[Bonitasoft Community forum](https://community.bonitasoft.com/questions-and-answers)**
 - [Get in touch with Bonitasoft](https://www.bonitasoft.com/contact-us) to get more information about [support offering](https://www.bonitasoft.com/support) and additional features of Enterprise Edition
 
 Content is currently available in:
-- English (Bonita Camp 2021.2)
-- Français (Bonita Camp 2021.2)
-- Español (Bonita BPM 2021.2)
+- English 
+- Français 
+- Español
 
-
-## For Bonita Camp contributors
+## For Bonita Camp Contributors
 
 ### Sources
 
 All sources are available on [Bonita Camp GitHub repository](https://github.com/Bonitasoft-Community/bonita-camp/):
-
-- Slides are created using reveal.js and are located in the [slides](https://github.com/Bonitasoft-Community/bonita-camp/tree/master/slides) folder
+- Source files of slides based on h5p and generated htmls are located in the [h5p](https://github.com/Bonitasoft-Community/bonita-camp/tree/master/h5p) folder
 - Exercises are hosted using GitHub Pages. Source are located in the [docs](https://github.com/Bonitasoft-Community/bonita-camp/tree/master/docs) folder and content is available for users at **[http://bonitasoft-community.github.io/bonita-camp/](http://bonitasoft-community.github.io/bonita-camp/)**
 
 ### Build instructions for slides
+Refer to h5p documentation at **[https://h5p.org/](https://h5p.org//)**
+
+### Archive 
+- Previous versions of slides are located in the [slides](https://github.com/Bonitasoft-Community/bonita-camp/tree/master/slides) folder
+
+
+
 
-1. Download and unzip [reveal.js](https://github.com/hakimel/reveal.js/archive/master.zip)
-1. Paste the content of the `slides/THE_LANGUAGE/` folder into your `reveal.js` directory
-1. Paste the content of the `slides/theme` folder in your `reveal.js/css/theme/source` folder
-1. Run `npm install`
-1. Run `npm install -g grunt-cli`
-1. Run `grunt package`
-1. Use the built zip package to share and run the presentation
 

docs/es/00-introduction.md

@@ -5,15 +5,15 @@ title: Introducción
 El objetivo de los ejercicios es lograr producir un proceso básico de solicitud de vacaciones.
 
 El proceso será el siguiente:
-1. Un empleado presenta una solicitud de licencia
-1. El gerente del empleado decide si aprueba o no la solicitud.
+1. Un empleado presenta una solicitud de vacaciones
+1. El responsable directo del empleado decide si aprueba o no la solicitud.
 
 Para ello, tomaremos un enfoque iterativo alternando contenido teórico y ejercicios prácticos.
 Cada ejercicio proporciona una versión ejecutable cada vez más completa del proceso.
 
 Cada ejercicio se divide en 3 secciones:
 1. **Objetivo**: presenta los conceptos claves a los que se dirige el ejercicio
-1. **Resumen de instrucciones**: contiene los pasos principales para llevar a cabo el ejercicio
-1. **Instrucciones paso a paso**: proporciona una descripción detallada paso a paso de los pasos para realizar el ejercicio
+1. **Instrucciones resumidas**: contiene los pasos principales para llevar a cabo el ejercicio
+1. **Instrucciones paso a paso**: proporciona una descripción detallada paso a paso de los pasos a seguir para realizar el ejercicio
 
 [Empezar el primer ejercicio](01-bpmn-design.md)

docs/es/01-bpmn-design.md

@@ -1,21 +1,21 @@
 ---
-title: Ejercicio 1 - Modelado de procesos BPMN
+title: Ejercicio 1 - Modelización de un proceso simple
 ---
 
 ## Objetivo
 
 El objetivo de este ejercicio es crear una primera versión "básica" del diagrama del proceso de solicitud de vacaciones.
 
 En esta etapa, el proceso es ejecutable pero aún no presenta interés funcional porque no tiene formularios ni datos.
-Lo completaremos en los siguientes ejercicios.
+Los completaremos en los siguientes ejercicios.
 
-Nota: la validación de los diagramas en Bonita Studio debe activarse manualmente. Si corrigas un error o un mensaje de advertencia, debes ir a la pestaña **Estado de validación** y hacer clic en el botón **Refrezcar** o ir al menú **Archivo** y hacer clic en el botón **Validar**.
+> Nota: la validación de los diagramas en Bonita Studio debe activarse manualmente. Si corriges un error o un mensaje de advertencia, debes ir a la pestaña **Estado de validación** y hacer clic en el botón **Refrescar** o ir al menú **Archivo**.
 
-## Resumen de las instrucciones
+## Instrucciones resumidas
 
-Para hacer el ejercicio, crea un diagrama *DiagramaSolicitudVacaciones* que contenga un proceso *SolicitudVacaciones* en la versión *1.0.0*.
+1. Crea un diagrama *DiagramaSolicitudVacaciones* que contenga un proceso *SolicitudVacaciones* en la versión *1.0.0*.
 
-El grupo de procesos debe incluir los siguientes elementos BPMN:
+1. Agrega a la definición de dicho proceso los siguientes elementos BPMN:
 * Un evento de inicio *Ingresar solicitud*
 * Una tarea humana *Validar solicitud*
 * Una puerta exclusiva *¿Solicitud aprobada?*
@@ -29,63 +29,96 @@ El grupo de procesos debe incluir los siguientes elementos BPMN:
 ## Instrucciones paso a paso
 
 1. Inicia Bonita Studio
-1. En la página de inicio de Studio, haz clic en **Nuevo proyecto** en el menú Diseño.
-1. Ingrese el nombre del proyecto _"SolicitudVacaciones"_.
-1. Crea un nuevo diagrama de procesos
+1. En la página de inicio de Studio o desde el menú **Archivo**, haz clic en **Nuevo proyecto**.
+1. Ingresa el nombre del proyecto _"SolicitudVacaciones"_.
+1. Deja los valores de los otros campos vacíos o los que vienen por defecto 
+1. Haz clic en **Crear**
+
+> Nota: Tienes la posbilidad de elegir de agregar *Extensiones* desde la creación del rpoyecto. Esto puede ser útil en un proyecto real pero en nuestro ejemplo, las extensiones las abordaremos más tarde.
+
+### Crea un diagrama *DiagramaSolicitudVacaciones* que contenga un proceso *SolicitudVacaciones* en la versión *1.0.0*
+
+1. Crea un nuevo diagrama de procesos. 
+    - Ya sea desde la vista general del proyecto, sección _Diagrama de procesos_, haciendo clic en **Crear**, y después en **Crear un nuevo diagrama de procesos**
+
+    ![Nouveau diagramme](images/ex01/ex1_11.png)
+    - O ya sea desde la barra de herramientas, haciendo clic en **Nuevo** y seleccionando **Diagrama de proceso**:
     ![nuevo diagrama de proceso](images/ex01/ex1_10.png)
 
 1. Especifica el nombre del diagrama y el del proceso:
-    - Haz clic en el menú **Archivo / Renombrar Diagrama...** en la parte superior del Studio
-    - Ingresa *DiagramaSolicitudVacaciones* para el nombre del diagrama y *SolicitudVacaciones* para el del pool y *1.0.0* para la versión del diagrama y del pool
+    - En el **Explorador de proyectos**, selecciona el diagrama, da clic derecho con tu ratón y selecciona **Renombrar...**
+    - Ingresa *DiagramaSolicitudVacaciones* para el nombre del diagrama y *SolicitudVacaciones* para el de la *Pool* y *1.0.0* para la versión del diagrama y de la *Pool*
    ![ventana emergente para cambiar el nombre y la versión del diagrama y del pool](images/ex01/ex1_01.png)
-1. Cambia el nombre del evento de inicio a *Ingresar solicitud*:
+
+### Agrega a la definición de dicho proceso los elementos BPMN
+
+1. Cambia el nombre del evento de inicio :
     - Selecciona el evento de inicio presente en el diagrama
-    - Navega a la pestaña **General / General** y luego ingrese el nuevo nombre
-1. Cambia el nombre de la tarea humana a *Validar solicitud*
+    - Navega a la pestaña **General / General** e ingresa el nuevo nombre: *Ingresar solicitud*
+
+1. Siguiendo los mismos pasos, cambia el nombre de la tarea humana a *Validar solicitud*
+
 1. Agrega una puerta exclusiva *¿Solicitud aprobada?* Después de la tarea *Validar solicitud*:
     - Selecciona la tarea *Validar solicitud*, arrastra y suelta desde el icono contextual de la puerta lógica
-   ![creación de puerta lógica desde una tarea](images/ex01/ex1_02.png)
+
+        ![creación de puerta lógica desde una tarea](images/ex01/ex1_02.png)
     - Una vez que se ha creado la puerta, usa el ícono contextual **caja de herramientas** (1) para cambiar su tipo a **Exclusivo** (2)
-   ![Modificación del tipo de puerta lógica](images/ex01/ex1_03.png)
-   - Cambia el nombre de la puerta a *¿Solicitud aprobada?*
+
+        ![Modificación del tipo de puerta lógica](images/ex01/ex1_03.png)
+    - Cambia el nombre de la puerta a *¿Solicitud aprobada?*
+
 1. Crea una tarea automática *Notificar aprobación* desde la puerta lógica:
     - Selecciona la puerta lógica, arrastra y suelta desde el icono de tarea contextual (A)
-   ![creación de una tarea desde una puerta lógica](images/ex01/ex1_04.png)
-   - Una vez que se ha creado la tarea automática, cambiala el nombre
+        ![creación de una tarea desde una puerta lógica](images/ex01/ex1_04.png)
+    - Una vez creada la tarea automática, cámbiale el nombre a *Notificar aprobación*
+
 1. Crea una tarea automática *Notificar rechazo* desde la puerta lógica
+
 1. Agrega un evento de terminación *Fin - Solicitud aprobada* después de la tarea automática *Notificar aprobación*:
     - Selecciona la tarea automática *Notificar aprobación*
     - Arrastra y suelta desde el ícono de evento contextual (A) y selecciona el evento final (B)
-   ![creación de un evento final](images/ex01/ex1_05.png)
-   - Una vez que se ha creado el evento, cámbiale el nombre
+        ![creación de un evento final](images/ex01/ex1_05.png)
+    - Una vez el evento creado, cámbiale el nombre
+
 1. Agrega un evento de finalización *Fin - Solicitud rechazada* después de la tarea automática *Notificar rechazo*
+
 1. Nombra las 2 transiciones entre la puerta lógica y los pasos automáticos:
-    - Selecciona la transición
-    - Navega a la pestaña **General / General** luego ingresa el nombre
-    - La transición que conduce al paso *Notificar aprobación* se llamará *Sí* y la otra *No*
+    - Selecciona la transición a la etapa *Notificar aprobación*
+    - Navega a la pestaña **General / General** e ingresa *Sí* como nombre
+    - Repite la operación para la otra transición que se llamará *No*, para responder a la pregunta de la puerta lógica "¿Solicitud aprobada?"
+    - La validación es automática. Da clic en cualquier otro lado y el nuevo valor será guardado. 
+
 1. Configura la condición en la transición *Sí* para que el flujo siga esta rama:
     - Selecciona la transición
     - Ingresa el valor `true` en el campo **Condición** (pestaña **General / General**). Si no ves el campo **Condición**, probablemente sea porque agregaste una puerta lógica paralela en lugar de una exclusiva.
-   ![definición de condición en una transición](images/ex01/ex1_06.png)
+    ![definición de condición en una transición](images/ex01/ex1_06.png)
+
 1. Configura la transición *No* como el flujo por defecto:
     - Selecciona la transición *No*
     - Marca la casilla **Flujo por defecto**
+
 1. Actualiza la validación del diagrama:
     - Navega en la pestaña **Estado de validación**
     - Haz clic en el botón **Actualizar**
-    - Ignora las 3 advertencias sobre los formularios
+    - Por el momento, ignora las 3 advertencias sobre los formularios
+
+1. Si lo deseas, puedes reajustar la posición de los elementos y la froma de las transiciones para mejorar la estética y legibilidad del diagrama
+
 1. Verifica que el diagrama se vea así:
    ![resultado final del diagrama](images/ex01/ex1_07.png)
+
 1. Guarda el proceso:
-    - Haz clic en el botón **Guardar** en la barra de menú superior de Bonita Studio
+    - Haz clic en el botón **Guardar** en la barra de herramientas de Bonita Studio
+
 1. Ejecuta el proceso para probarlo:
-    - Selecciona el pool de procesos (la forma rectangular que contiene las tareas y eventos)
-    - Haz clic en el botón ![Botón de inicio](images/ex01/ex1_08.png) en la barra de menú superior del Studio (si el botón está desactivado, asegúrate de que el grupo esté seleccionado)
-    - Tu navegador debe abrir y presentar un formulario de creación de instancias generado automáticamente
-    - Envía el formulario
-    - Deberías ser redirigido a la bandeja de entrada de tareas del Portal Bonita
+    - Selecciona la *Pool* del proceso (el área rectangular que contiene las tareas y eventos)
+    - Haz clic en el botón **Ejecutar** ![Botón de inicio](images/ex01/ex1_08.png) en la barra de herramientas del Studio (si el botón está desactivado, asegúrate de que el diagrama esté seleccionado)
+    - Tu navegador debe abrir y presentar un formulario de creación de instancias (generado automáticamente para pruebas)
+    - Envía el formulario. Esta acción creará una nueva instancia del proceso.
+    - Debes ser redirigido a la bandeja de entrada de tareas de la aplicación **Bonita User Application**
     - Selecciona la tarea *Validar solicitud*
-    - Haz clic en **Tomar** en la parte superior derecha de la pantalla ![asignar una tarea](images/ex01/ex1_09.png)
+    - Haz clic en **Tomar** en la parte superior derecha de la pantalla
+    ![asignar una tarea](images/ex01/ex1_09.png)
     - Envía el formulario para el paso *Validar solicitud* haciendo clic en el botón **Ejecutar** para completar el caso
 
 [Ejercicio siguiente: creación de datos y definición de contratos](02-data-contract.md)