PREVIEW

Trabajar con tareas de la aplicación

Este tutorial te guía a través del proceso de creación de una tarea de aplicación, que implica las siguientes fases:

• Crear una definición de acción y cargarla en Action Center.
• Desarrollar una aplicación de acción dentro de Apps y configurar campos para cada propiedad definida en la definición de acción.
• Publicar la aplicación y crear un flujo de trabajo en Studio Web o Studio Desktop utilizando la actividad Crear tarea de aplicación .

1. Crea y carga la definición de la acción

Para vincular campos de acción con una aplicación, debes crear un esquema JSON, debes crear un esquema JSON, llamado definición de acción. Esta definición describe los campos de acción necesarios y especifica las acciones permitidas disponibles al completar la acción.

1. Prepara la definición de la acción:
   1. Comience agregando una llave abierta para indicar el inicio del objeto JSON.
   2. Dentro del objeto JSON, define las propiedades Name y Description como cadenas, junto con sus valores.

      "Name": "Validate Document",
          "Description": "Validate and approve invoice",

   3. Añade una propiedad Allowed Actions como una matriz de cadenas para especificar las acciones permitidas que puedes realizar al final de la acción. Los valores deben ser el equivalente a Completar o Rechazar.

      "AllowedActions": [
              "Yes",
              "No"
          ],

   4. Añade una propiedad Schema y asígnale un objeto que se adhiera al estándar del esquema JSON: http://json-schema.org/draft-07/schema#.

      "Schema": {
              "$schema": "http://json-schema.org/draft-07/schema#",
              "type": "object",

   5. Dentro del objeto properties , define cada propiedad que quieras incluir en el esquema. Para cada propiedad, especifica su type y description.
      Cada propiedad en Schema es el equivalente a los campos de entrada que añadirás en la acción Aplicación.

      "properties": {
                  "Description": {
                      "type": "string",
                      "direction": "in",
                      "description": "Validation message"
                  },
                  "invoice_document": {
                      "type": "string",
                      "direction": "in",
                      "description": "Document file."
                  },
                  "Comments": {
                      "type": "string",
                      "direction": "inout",
                      "description": "Approval or rejection comments"
                  }
              }

      Nota: si la propiedad direction no está definida, su valor predeterminado es inout (In/Out).
   6. Si se requieren ciertas propiedades, incluye una matriz required , donde se enumeran las propiedades que deseas marcar como necesarias en la acción.
   7. Cierra el objeto JSON añadiendo una llave de cierre.
2. Carga la definición de la acción en Action Center:
   1. Abre Action Center, ve a Configuración de administrador y selecciona Tenant.
   2. En la pestaña Definiciones de acción , selecciona Añadir definición de acción.
   3. Selecciona Descargar muestra de definición de acción para descargar un esquema JSON de muestra que te ayude a preparar la definición de acción.
   4. Selecciona Importar desde archivo y selecciona el archivo JSON que has preparado anteriormente.
   5. Introduce un nombre y una descripción adecuados para la definición de la acción y, a continuación, selecciona Crear.

2. Crea la aplicación Action

Las aplicaciones creadas mediante una integración para acciones están diseñadas para utilizarse en flujos de trabajo de larga duración, y los usuarios finales pueden acceder a estas aplicaciones solo a través de la interacción con las acciones generadas.

1. Abre Apps dentro de la organización donde has cargado las definiciones de acción.
2. Crea una nueva aplicación desde cero o elige una plantilla prefabricada que se adapte a tus necesidades.
3. Junto a Añadir control, selecciona Añadir cualquiera y luego selecciona Acción.
   Este paso te permite especificar la definición de acción para esta aplicación. Para este ejemplo, estamos utilizando la definición de acción Validate Document .
4. Selecciona el tenant en el que has cargado previamente la definición de acción y selecciona Siguiente.
5. En la parte izquierda del cuadro de diálogo Añadir acción , selecciona la definición de acción que has creado y haz clic en Añadir.
   
   

   

   
   

   Visita Referenciar una definición de acción dentro de tu aplicación para obtener más información sobre el uso de definiciones de acción con tus Action Apps.

6. Ahora puedes empezar a añadir controles a tu aplicación.
   Asegúrate de que los nombres de los controles de la aplicación se alinean con precisión con los nombres utilizados en el esquema JSON de la definición de la acción. Por ejemplo, si incluyes un control de visor de documentos para mostrar la propiedad invoice_document de la definición de la acción, nombra el control invoice_document.
   Los parámetros de entrada o salida de una acción pueden vincularse a cualquier control de la aplicación, utilizando la siguiente sintaxis: Actions.<referenced_action_name>.<action_parameter_name>
   1. Crea una página en blanco y añádele un diseño .
   2. Dentro del Diseño, añade un Contenedor, donde puedes añadir cuadros de texto y controles de imagen, para mostrar el nombre del cliente y el logotipo de la empresa que está validando el documento.
   3. Dentro del Diseño, añade un Contenedor, donde coloques el control Visor de documentos .
   4. Crea una variable llamada var_invoice_file y añádela como Origen del control Visor de documentos .
   5. Añade otro contenedor dentro del Diseño, donde puedes añadir un Área de texto a la izquierda. Como texto predeterminado, escribe la siguiente expresión: Actions.Validate_Document.Comments.
   6. Añade dos controles de botón responsables de completar la acción y configura una regla para enviar la acción, correspondiente al Allowed Actions especificado en la definición de la acción:
      1. Ve a Eventos y selecciona Crear regla.
      2. En el menú de la lista desplegable, selecciona Enviar acción.
      3. En Resultado de la acción, selecciona la acción permitida que quieres que el botón desencadene al hacer clic: Yes o No.

      Visita Regla: Enviar acción para obtener más información sobre esta regla específica.

7. Establece un enlace a un depósito de almacenamiento donde cargarás el documento antes de reenviarlo como parte de la acción.
8. Publica la aplicación, haciéndola accesible para su uso dentro de tus flujos de trabajo de Studio.

   Visita Publicar una aplicación de acción para obtener más información sobre el proceso de publicación de una aplicación de acción.

Nota: Opcionalmente, si quieres reemplazar la acción que estás utilizando para tu aplicación, visita Reemplazar una acción.

3. Crea una tarea de aplicación dentro de un flujo de trabajo

Crea un flujo de trabajo en Studio Web o Studio Desktop para descargar un documento de factura desde una cuenta de Google Drive. Carga el documento descargado en el depósito de almacenamiento vinculado a tu aplicación Action. A continuación, añade una actividad Acción de usuario/acción de aplicación para mostrar el documento específico para su aprobación o rechazo por parte del usuario. Asigna la tarea a un usuario, espera a que se complete la acción y reanuda el flujo de trabajo. Registra un mensaje que detalla la decisión de validación del usuario para el documento.

1. Crea un nuevo proyecto en Studio.
2. Añade una actividad Descargar archivo .
   1. Establece una conexión a Google Drive dentro de la actividad.
   2. En el campo Archivo a descargar , especifica el nombre del archivo que quieres descargar.
   3. En la sección Salida , crea una variable para almacenar el archivo descargado.
      Para este ejemplo, nombra la variable downloadFile.
3. Añade una actividad Cargar archivo de almacenamiento para cargar el archivo en el depósito de almacenamiento asociado a tu aplicación de acción.
   1. En Ruta de la carpeta de Orchestrator y Nombre del depósito de almacenamiento, elige la ruta de la carpeta de Orchestrator y el depósito de almacenamiento donde quieres cargar el archivo.
   2. En el campo Archivo , introduce la variable donde almacenaste el archivo que descargaste.
      Para este ejemplo, introduce downloadFile.
   3. En el campo Dónde cargar/Ruta , introduce la expresión downloadFile.FullName.toString para guardar el archivo en el depósito de almacenamiento.
      Consejo: Puedes almacenar esta expresión en una variable.
   
   

   

   
   
4. Añade una actividad Crear tarea de aplicación para crear la acción.
   1. Establece el Título y la Prioridad en consecuencia.
   2. Para Aplicaciones, selecciona la aplicación Acción creada anteriormente en el tutorial.
   3. Rellene los campos generados con las variables adecuadas.
   4. En la sección Salida , crea una variable UserActionData para almacenar los datos relacionados con la acción generada.
      En este ejemplo, nombra la variable como taskID.
5. Añade una actividad Asignar tareas para asignar la tarea a un usuario dentro de la organización.
   1. En el campo ID de la tarea , introduce una expresión que recupere el ID de la tarea de la variable de salida creada en el paso 4, subpaso d.
      En este ejemplo, introduce la siguiente expresión: taskID.Id.Value.
   2. En el campo Nombre de usuario o correo electrónico , introduce el nombre de usuario o la dirección de correo electrónico del usuario al que quieres asignar esta acción.
   
   

   

   
   
6. Añade una actividad Esperar tarea de aplicación y reanudar para esperar a que el usuario complete la acción y luego reanudar el flujo de trabajo.
   1. En el campo Tarea de aplicación creada , introduce la variable de salida creada en el paso 4, subpaso d.
   2. En el campo Acción realizada , crea una variable (ejemplo: userActionTaken) para almacenar el tipo de acción que el usuario realizó para completar la tarea.
7. Añade una actividad Mensaje de registro para imprimir el tipo de acción que el usuario realizó para completar la tarea. Utilice una expresión como "The action that user used to complete the Validate Invoice action was " + userActionTaken.ToString
   
   

   

   
   

Ejemplo de flujo de trabajo

Para seguir los pasos y probar el tutorial, descarga el proyecto de Studio Desktop de muestra aquí. Para abrirlo en Studio Web, guarda el proyecto en Cloud y luego comprueba tu Studio Web para que el proyecto se abra allí.