Updated ES content for Bonita BPM 7.1.2

exercices/source/es/chapters/ex2.xml

@@ -36,7 +36,7 @@
 					<row>
 						<entry>solicitanteId</entry>
 						<entry>Long</entry>
-						<entry>Sí</entry>
+						<entry>No</entry>
 					</row>
 					<row>
 						<entry>diaInicio</entry>
@@ -57,10 +57,10 @@
 			</tgroup>
 		</informaltable>
 		<para>Declara una variable "solicitud" de tipo "SolicitudVacaciones" en tu pool.</para>
-		<para>Añade un contrato a la instanciación del proceso con una nueva entrada "solicitudContrato" de tipo "complex" que contenga los siguientes elementos:</para>
+		<para>Genera un contrato en la instanciación del proceso desde la variable "solicitud" y que contenga los siguientes elementos:</para>
 		<itemizedlist mark='bullet'>
-			<listitem><para>diaInicio (Date)</para></listitem>
-			<listitem><para>numDias (Integer)</para></listitem>
+			<listitem><para>diaInicio</para></listitem>
+			<listitem><para>numDias</para></listitem>
 		</itemizedlist>
 		<para>Añade estas dos restricciones en el contrato:</para>
 		<itemizedlist mark='bullet'>
@@ -107,7 +107,7 @@
 							<row>
 								<entry>solicitanteId</entry>
 								<entry>Long</entry>
-								<entry>Sí</entry>
+								<entry>No</entry>
 							</row>
 							<row>
 								<entry>diaInicio</entry>
@@ -155,15 +155,15 @@
 				<para>Selecciona la Pool del proceso y navega hasta la pestaña "Ejecución / Contrato / Entradas".</para>
 				<para>Haz click en "Añadir desde datos...".</para>
 				<para>Selecciona el BDM "solicitud" y haz click en "Siguiente".</para>
-				<para>Renombra la entrada a "solicitudContrato", luego deselecciona los atributos "solicitanteId" y "aprobado".</para>
+				<para>Deselecciona los atributos "solicitanteId" y "aprobado".</para>
 				<para>
 					<mediaobject>
 						<imageobject>
 							<imagedata scalefit="1" width="100%" contentdepth="100%" align="center" format="png" fileref="resources/ex2_03.png" />
 						</imageobject>
 					</mediaobject>
 				</para>
-				<para>Haz click en "Finalizar".</para>
+				<para>Haz click en "Finalizar" y obvia le mensaje de advertencia sobre la instanciación incompleta de la variable de negocio.</para>
 				<para>
 					<mediaobject>
 						<imageobject>
@@ -190,7 +190,7 @@
 							</row>
 							<row>
 								<entry>Expresión</entry>
-								<entry><programlisting language="java">return solicitudContrato.diaInicio.compareTo(new Date()) > 0;</programlisting></entry>
+								<entry><programlisting language="java">return solicitudInput.diaInicio.compareTo(new Date()) > 0;</programlisting></entry>
 							</row>
 							<row>
 								<entry>Mensaje de error</entry>
@@ -217,7 +217,7 @@
 							</row>
 							<row>
 								<entry>Expresión</entry>
-								<entry><programlisting language="java">return solicitudContrato.numDias > 0;</programlisting></entry>
+								<entry><programlisting language="java">return solicitudInput.numDias > 0;</programlisting></entry>
 							</row>
 							<row>
 								<entry>Mensaje de error</entry>
@@ -235,16 +235,15 @@
 				</para>
 			</listitem>
 			<listitem>
-				<para><emphasis role="bold">Inicializa el BDM "solicitud" con el contrato de instanciación de proceso</emphasis></para>
-				<para>Selecciona la Pool del proceso y navega hasta la pestaña "Datos / Variables de negocio".</para>
+				<para><emphasis role="bold">Actualiza la instanciación del BDM "solicitud"</emphasis></para>
+				<para>Selecciona la Pool del proceso y navega hasta la pestaña "Datos / Variables de proceso".</para>
 				<para>Selecciona la variable de negocio "solicitud" y haz click en "Editar".</para>
 				<para>Haz click en el icono del "Lápiz" junto al campo "Valor predeterminado" para abrir el editor de expresiones.</para>
-				<para>Asegúrate de que el tipo seleccionado para la expresión es "Script".</para>
-				<para>Nombra al script "initSolicitud".</para>
-				<para>Introduce el siguiente código:</para>
+				<para>Limpia todo el código generado y reemplázalo por el siguiente:</para>
 				<para>
 					<programlisting language="java"><xi:include parse="text" href="../resources/code/ex2_initRequest.java"><xi:fallback><para>XINCLUDE-ERROR</para></xi:fallback></xi:include></programlisting>
 				</para>
+				<para>Esto iniciará el BDM desde las variables del contrato y establecerá al iniciador del proceso como el autor de la solicitud.</para>
 			</listitem>
 			<listitem>
 				<para><emphasis role="bold">Establece el contrato de la tarea "Validar solicitud"</emphasis></para>
@@ -277,7 +276,7 @@
 				<para><emphasis role="bold">Consejos:</emphasis></para>
 				<itemizedlist mark='bullet'>
 					<listitem><para>para la entrada "diaInicio", introduce una fecha en el formato YYYY-MM-DD.</para></listitem>
-					<listitem><para>para la entrada "aprobado", introduce un valor booleano: "true" ó "false" (cualquier otro valor será resuelto como "false").</para></listitem>
+					<listitem><para>para la entrada "aprobado", introduce un valor booleano: "true" ó "false".</para></listitem>
 				</itemizedlist>
 				<para>
 					<mediaobject>

exercices/source/es/chapters/ex3.xml

@@ -63,6 +63,13 @@
 				<para><emphasis role="bold">Configura la condicion en la transicion "Si" usando el atributo "aprobado" del BDM "solicitud".</emphasis></para>
 				<para>Selecciona el flujo y haz click en el icono del "lápiz" junto al selector de "Condición" para abrir el editor de expresiones.</para>
 				<para>En el editor de expresiones, selecciona "Java" como tipo de expresión, selecciona la variable "solicitud" y el método "isAprobado".</para>
+				<para>
+					<mediaobject>
+						<imageobject>
+							<imagedata scalefit="1" width="100%" contentdepth="100%" align="center" format="png" fileref="resources/ex3_03.png" />
+						</imageobject>
+					</mediaobject>
+				</para>
 			</listitem>
 			<listitem>
 				<para><emphasis role="bold">Define el flujo "No", como flujo por defecto.</emphasis></para>
@@ -71,7 +78,8 @@
 			<listitem>
 				<para><emphasis role="bold">Valida el diagrama.</emphasis></para>
 				<para>Cuando las condiciones de los flujos estén definidas, podrás validar el diagrama.
-				Para ello, navega hasta la pestaña "Estado de validación" y haz click en "Refrescar".</para>
+				Para ello, navega hasta la pestaña "Estado de validación" y haz click en "Refrescar".
+				Puedes ignorar con seguridad las 3 advertencias relacionadas con el UI Designer.</para>
 			</listitem>
 			<listitem>
 				<para><emphasis role="bold">Asegúrate de que el diagrama coincide con éste:</emphasis></para>
@@ -87,15 +95,7 @@
 				<para><emphasis role="bold">Ejecuta varias veces el proceso para comprobar los distintos caminos.</emphasis></para>
 				<para>Aviso: no hagas click varias veces en el botón "Ejecutar", esto redesplegará el proceso y limpiará el historico.
 				Para crear una segunda instancia de proceso, deberás navegar por el Bonita Portal.</para>
-				<para>Abre el Portal con el botón con dicho nombre en la barra de iconos superior o desde el link de la esquina superior derecha del entorno web:</para>
-				<para>
-					<mediaobject>
-						<imageobject>
-							<imagedata scalefit="1" width="100%" contentdepth="100%" align="center" format="png" fileref="resources/ex3_05.png" />
-						</imageobject>
-					</mediaobject>
-				</para>
-				<para>Después, navega al menú "Procesos" y selecciona la definición de proceso "Solicitud de Vacaciones" con versión 3.0 y haz click en "Iniciar".</para>
+				<para>Para ello, navega hasta el menú "Procesos" y selecciona el proceso "Solicitud de vacaciones" definido en la versión 3.0 y haz click en "Inicio".</para>
 			</listitem>			
 			<listitem>
 				<para><emphasis role="bold">Comprueba que el proceso se ha ejecutado correctamente desde la interfaz de administración del Portal.</emphasis></para>

exercices/source/es/chapters/ex4.xml

@@ -14,7 +14,7 @@
 		<para>Crea los siguientes formularios:</para>
 		<itemizedlist mark='bullet'>
 			<listitem><para>Un formulario de instanciación "rellenarSolicitud" donde agregar las variables "diaInicio" y "numDias".</para></listitem>
-			<listitem><para>Un formulario de tarea "Validar Solicitud de vacaciones" que muestre las variables "diaInicio" y "numDias" en solo lectura y permita definir la variable "aprobado".</para></listitem>
+			<listitem><para>Un formulario de tarea "Validar Solicitud de vacaciones" que muestre los detalles del usuario "solicitante", las variables "diaInicio" y "numDias" en solo lectura y permita definir la variable "aprobado".</para></listitem>
 		</itemizedlist>
 	</section>
 
@@ -55,7 +55,7 @@
 			</listitem>
 			<listitem>
 				<para><emphasis role="bold">Mueve los widgets ya existentes dentro del Contenedor de formulario</emphasis></para>
-				<para>Selecciona el widget "Día inicio", arrastra y suéltalo dentro del widget ""Form container".</para>
+				<para>Selecciona el widget "Día inicio", arrastra y suéltalo dentro del widget "Form container".</para>
 				<para>Repite la operación para los widgets "Num días" y "Submit", añadiendo nuevas filas.</para>
 				<para>Una vez los widgets estén agrupados dentro del Contenedor de formularios, selecciona y elimina las filas vacías.</para>
 				<para><emphasis role="bold">Consejo:</emphasis> Mantén el ratón en la barra gris situada a la izquierda de una fila (A) para mostrar las acciones incluyendo la de eliminar (B).</para>
@@ -70,7 +70,7 @@
 			</listitem>
 			<listitem>
 				<para><emphasis role="bold">Actualiza el título del formulario.</emphasis></para>
-				<para>Selecciona el widget "Title" con texto "Solicitud Contrato" y edita las siguientes propiedades:</para>
+				<para>Selecciona el widget "Title" con texto "Solicitud Input" y edita las siguientes propiedades:</para>
 				<informaltable frame="all">
 					<tgroup cols="2" align="left" colsep="1" rowsep="1">
 						<colspec colname='c1' colwidth="1*"/>
@@ -178,34 +178,18 @@
 			</listitem>
 			<listitem>
 				<para><emphasis role="bold">Actualiza el widget "Submit"</emphasis></para>
-				<para>Selecciona el widget "Submit" y edita las siguientes propiedades:</para>
-				<informaltable frame="all">
-					<tgroup cols="2" align="left" colsep="1" rowsep="1">
-						<colspec colname='c1' colwidth="1*"/>
-						<colspec colname='c2' colwidth="4*"/>
-						<thead>
-							<row>
-								<entry>Propiedad</entry>
-								<entry>Valor</entry>
-							</row>
-						</thead>
-						<tbody>
-							<row>
-								<entry>Etiqueta</entry>
-								<entry>Enviar</entry>
-							</row>
-							<row>
-								<entry>Valor de la respuesta fallida</entry>
-								<entry>error</entry>
-							</row>
-						</tbody>
-					</tgroup>
-				</informaltable>
-				<para>Asignando a la propiedad "Valor de la respuesta fallida" la variable "error" permitirá recibir los detalles del error (si los hubiera).</para>
-			</listitem>
+				<para>Selecciona el widget "Submit".</para>
+				<para>Haz click en el icono de "enlazar" <guiicon><inlinegraphic fileref="resources/ex4_04.png"/></guiicon> junto a la propiedad "Desactivado".</para>
+				<para>Introduce el siguiente contenido en el campo de texto que acaba de aparecer (esto deshabilitará el botón cuando el formulario no pueda ser validado):</para>
+				<para>
+					<programlisting language="javascript">$form.$invalid</programlisting>
+				</para>
+				<para>Reemplaza la propiedad "Valor de la respuesta fallida" con "error" (esto nos permitirá recoger los detalles del error al envío del formulario si es que hubiera alguno).</para>
+				</listitem>
 			<listitem>
 				<para><emphasis role="bold">Muestra el error dinámicamente</emphasis></para>
 				<para>Arrastra un widget de "Texto" de la paleta y suéltalo debajo del botón "Enviar".</para>
+				<para>Rellena la propiedad "Clases CSS" con "text-danger".</para>
 				<para>Haz click en el icono de "enlazar" <guiicon><inlinegraphic fileref="resources/ex4_04.png"/></guiicon> junto a la propiedad "Oculto".</para>
 				<para>Introduce el siguiente contenido en el campo de texto que acaba de aparecer (esto muestra el widget sólo cuando haya un error):</para>
 				<para>
@@ -237,11 +221,10 @@
 				</para>
 				<para>Revisa los siguientes puntos:</para>
 				<itemizedlist>
-					<listitem><para>el widget responsable de mostrar el error no debería ser visible</para></listitem>
-					<listitem><para>el botón "Enviar" debería estar desactivado (esto se debe a la validación proporcionada por el widget "form container")</para></listitem>
+					<listitem><para>el widget responsable de mostrar el error no es visible</para></listitem>
+					<listitem><para>el botón "Enviar" está desactivado por defecto (esto se debe a la validación proporcionada por el widget "form container")</para></listitem>
+					<listitem><para>el botón "Enviar" está habilitado cuando el formulario es válido</para></listitem>
 				</itemizedlist>
-				<para>Usa la vista previa para comprobar la validación de los campos del formulario.</para>
-				<para>Una vez sea válido el formulario, el botón "Enviar" debería activarse.</para>
 				<para><emphasis role="bold">Nota:</emphasis> el formulario no se puede enviar desde el modo de vista previa aunque sea válido.</para>
 			</listitem>
 			<listitem>
@@ -258,10 +241,17 @@
 				<para><emphasis role="bold">Renombra el formulario</emphasis></para>
 				<para>En el UI Designer, renombra el formulario por "validarSolicitud" y haz click en el botón "Guardar".</para>
 			</listitem>
+			<listitem>
+				<para><emphasis role="bold">Elimina variables innecesarias</emphasis></para>
+				<para>En la sección "variables", el panel inferior situado en la pantalla, elimina la siguientes variables:</para>
+				<itemizedlist>
+					<listitem><para>formInput</para></listitem>
+					<listitem><para>formOutput</para></listitem>
+				</itemizedlist>
+			</listitem>
 			<listitem>
 				<para><emphasis role="bold">Recibe variables de negocio de la petición en curso</emphasis></para>
-				<para>Haz click en el botón "Crear una nueva vairable" en la sección inferior de "Variables" en la pantalla.</para>
-				<para>Configura la variable con las siguientes propiedades:</para>
+				<para>Haz click en el botón "Crear una nueva vairable" y configura la variable con las siguientes propiedades:</para>
 				<informaltable frame="all">
 					<tgroup cols="2" align="left" colsep="1" rowsep="1">
 						<colspec colname='c1' colwidth="1*"/>
@@ -293,13 +283,39 @@
 				Podemos recuperar la solicitud gracias al atributo "link" que nos proporciona la URL necesaria para recuperar el objeto.</para>
 			</listitem>
 			<listitem>
+				<para><emphasis role="bold">Recupera la información del usuario solicitante</emphasis></para>
+				<para>Crea una nueva variable con las siguientes propiedades:</para>
+				<informaltable frame="all">
+					<tgroup cols="2" align="left" colsep="1" rowsep="1">
+						<colspec colname='c1' colwidth="1*"/>
+						<colspec colname='c2' colwidth="4*"/>
+						<thead>
+							<row>
+								<entry>Propiedad</entry>
+								<entry>Valor</entry>
+							</row>
+						</thead>
+						<tbody>
+							<row>
+								<entry>Nombre</entry>
+								<entry>solicitante</entry>
+							</row>
+							<row>
+								<entry>Tipo</entry>
+								<entry>External API</entry>
+							</row>
+							<row>
+								<entry>API URL</entry>
+								<entry>../API/identity/user/{{solicitud.solicitanteId}}</entry>
+							</row>
+						</tbody>
+					</tgroup>
+				</informaltable>
+			</listitem>
+			<listitem>			
 				<para><emphasis role="bold">Añade una variable para el manejo de errores</emphasis></para>
 				<para>Crea una nueva variable llamada "error", deja su tipo como "String" y su valor vacío. Haz click en "Guardar".</para>
 			</listitem>
-			<listitem>
-				<para><emphasis role="bold">Elimina las variables "formInput" y "formOutput"</emphasis></para>
-				<para>Usa el icono "papelera" para eliminar las variables "formInput" y "formOutput".</para>
-			</listitem>
 			<listitem>
 				<para><emphasis role="bold">Elimina el checkbox "Aprobado" </emphasis></para>
 				<para>Selecciona el widget checkbox "Aprobado" y bórralo con el icono "x" que aparece al seleccionar el widget.</para>
@@ -346,7 +362,7 @@
 				</informaltable>
 			</listitem>
 			<listitem>
-				<para><emphasis role="bold">Añade un widget para mostrar la fecha de inicio</emphasis></para>
+				<para><emphasis role="bold">Añade un widget para mostrar al solicitante</emphasis></para>
 				<para>Arrastra un widget "Input" desde la paleta y suéltalo en una nueva fila debajo del título del formulario.</para>
 				<para>Configura el widget como sigue:</para>
 				<informaltable frame="all">
@@ -366,7 +382,38 @@
 							</row>
 							<row>
 								<entry>Etiqueta</entry>
-								<entry>Fecha de Inicio</entry>
+								<entry>Solicitante</entry>
+							</row>
+							<row>
+								<entry>Valor</entry>
+								<entry>solicitante.firstname +" "+ solicitante.lastname</entry>
+							</row>
+						</tbody>
+					</tgroup>
+				</informaltable>
+			</listitem>
+			<listitem>
+				<para><emphasis role="bold">Añade un widget para mostrar la fecha de comienzo de las vacaciones</emphasis></para>
+				<para>Arrastra un widget "Input" desde la paleta y suéltalo en una nueva fila debajo del widget con el solicitante.</para>
+				<para>Configura el widget como sigue:</para>
+				<informaltable frame="all">
+					<tgroup cols="2" align="left" colsep="1" rowsep="1">
+						<colspec colname='c1' colwidth="1*"/>
+						<colspec colname='c2' colwidth="4*"/>
+						<thead>
+							<row>
+								<entry>Propiedad</entry>
+								<entry>Valor</entry>
+							</row>
+						</thead>
+						<tbody>
+							<row>
+								<entry>Sólo-lectura</entry>
+								<entry>sí</entry>
+							</row>
+							<row>
+								<entry>Etiqueta</entry>
+								<entry>Comienzo de la vacaciones</entry>
 							</row>
 							<row>
 								<entry>Valor</entry>
@@ -457,7 +504,7 @@
 			</listitem>
 			<listitem>
 				<para><emphasis role="bold">Añade un widget para aprobar la solicitud</emphasis></para>
-				<para>Arrastra un widget "Button" desde la paleta y suéltalo en la zona situada a la derecha del botón "Rechazar".</para>
+				<para>Arrastra un widget "Button" desde la paleta y suéltalo en la zona de "6 columnas" situada a la derecha del botón "Rechazar".</para>
 				<para>Configura el widget como sigue:</para>
 				<informaltable frame="all">
 					<tgroup cols="2" align="left" colsep="1" rowsep="1">
@@ -496,7 +543,8 @@
 			</listitem>
 			<listitem>
 				<para><emphasis role="bold">Muestra dinámicamente errores de envío potenciales</emphasis></para>
-				<para>Arrastra un widget "Text" desde la paleta y suéltalo en una nueva fila debajo del formulario.</para>
+				<para>Arrastra un widget "Text" desde la paleta y suéltalo debajo del botón "Enviar".</para>
+				<para>Rellena la propiedad "clases CSS" con "text-danger"</para>
 				<para>Haz click en el icono de "enlazar" <guiicon><inlinegraphic fileref="resources/ex4_04.png"/></guiicon> junto a la propiedad "Oculto".</para>
 				<para>Introduce el siguiente contenidos en el campo de texto que ha aparecido (esto mostrará el widget sólo cuando haya un error):</para>
 				<para>

exercices/source/es/chapters/ex6.xml

@@ -7,6 +7,9 @@
 		<title>Objetivo</title>
 		<para>El objetivo de este ejercicio es de demostrar la interación de Bonita BPM con un sistema externo mediante el uso de un conector.
 		En este contexto, vamos a notificar al solicitante de vacaciones sobre el estado de su solicitud con un conector de email.</para>
+		<warning>
+			<para>Dependiendo de tu configuración de red, de tu cortafuegos o de la configuración de seguridad de tu servidor de correo, puede que no puedas enviar un email desde Bonita BPM.</para>
+		</warning>
 	</section>
 
 	<section>

exercices/source/es/resources/code/ex2_initRequest.java

@@ -10,7 +10,7 @@
 // Inicializa nueva solicitud de vacaciones
 SolicitudVacaciones nuevaSol = new SolicitudVacaciones();
 nuevaSol.setSolicitanteId(processInstance.getStartedBy());
-nuevaSol.setNumDias(solicitudContrato.get("numDias"));
-nuevaSol.setDiaInicio(solicitudContrato.get("diaInicio"));
+nuevaSol.setNumDias(solicitudInput.get("numDias"));
+nuevaSol.setDiaInicio(solicitudInput.get("diaInicio"));
 
 return nuevaSol;

exercices/source/es/resources/code/ex4_initFormInputs.json

@@ -1,5 +1,5 @@
 {
-  "solicitudContrato" : {
+  "solicitudInput" : {
     "diaInicio" : null,
     "numDias" : null
   }