Tutorial: Crear extensión de flujo de trabajo

Este tutorial mostrará el proceso para ampliar el diseñador de flujos de trabajo para agregar actividades personalizadas y lógica mediante un ensamblado de flujo de trabajo, conocido a veces como actividad de flujo de trabajo. Las extensiones que cree de esta manera se pueden usar en un flujo de trabajo, una acción personalizada, o un diálogo.

Este tutorial usa un ejemplo muy sencillo para centrarse en los requisitos y el proceso para:

• Crear un proyecto de biblioteca de clases de Visual Studio
• Agregar una clase CodeActivity
• Definir parámetros de entrada y salida
• Adición de lógica de negocios
• Firmar y crear el ensamblado
• Registrar el ensamblado
• Probar el ensamblado
• Agregar el ensamblado a una solución

Requisitos previos

• Una instancia y privilegios de administrador de Microsoft Dataverse
• Descripción de cómo configurar flujos de trabajo. Más información: Flujos de trabajo de Dataverse clásico
• Una aplicación basada en modelos que le permite editar cuentas.

Objetivo

El siguiente ejemplo creará una actividad de flujo de trabajo personalizada simple que se puede usar en un flujo de trabajo, un diálogo, o un proceso de acción. Más información: Configurar fases y pasos del flujo de trabajo

Esta actividad de flujo de trabajo personalizada cumplirá los siguientes requisitos:

1. Aceptar un parámetro de entrada decimal
2. Generar un valor igual al parámetro de entrada más 10.

En un flujo de trabajo para la entidad Cuenta puede usarse de la forma siguiente para aumentar el valor de Límite de crédito mediante dos pasos:

El paso 1 usa la actividad de flujo de trabajo personalizada Ejemplo: Incrementar en 10 para aceptar el valor Límite de crédito de la cuenta e incrementarlo en 10. El Paso 2 usa la acción Actualizar registro para actualizar el valor de Límite de crédito de la cuenta con el valor incrementado.

Paso 1: Obtener Límite de crédito de la cuenta incrementado

Cuando se agrega el primer paso, la actividad de flujo de trabajo personalizada estará disponible en un grupo Ejemplo y tendrá el nombre Incrementar en 10.

Al configurar el primer paso haciendo clic en el botón Establecer propiedades, se requerirá la propiedad Decimal input y solo aceptará un valor decimal, como el atributo Límite de crédito de la entidad Cuenta.

Paso 2: Establecer nuevo límite de crédito de la cuenta

En el segundo, una acción Actualizar registro asignará la salida del paso Obtener Límite de crédito de la cuenta incrementado para actualizar el valor del límite del Crédito de la cuenta con el valor incrementado.

Crear un proyecto de biblioteca de clases de Visual Studio

Este proyecto creará un ensamblado de flujo de trabajo simple que aumentará un valor decimal por 10.

1. Iniciar Visual Studio.

2. En el menú Archivo, haga clic en Nuevo, y haga clic en Proyecto.

3. Busque Biblioteca de clases y seleccione Biblioteca de clases (.NET Framework).

   

4. Haga clic en Siguiente.

5. Especificar un nombre y ubicación para la solución

   

   Nota

   Elija el nombre del proyecto que tenga sentido para el proyecto. En este ejemplo usaremos SampleWorkflowActivity.

6. Haga clic en Crear.

7. En el Explorador de soluciones, haga clic con el botón secundario en el proyecto y seleccione Propiedades. En la pestaña Aplicación, compruebe que .NET Framework 4.6.2 se define como marco de trabajo de destino.

   

8. En el Explorador de soluciones, haga clic con el botón secundario en el proyecto y seleccione Administrar paquetes de NuGet. ,

   

9. Busque el paquete Microsoft.CrmSdk.Workflow NuGet e instálelo.

   

   Nota

   Asegúrese de que el paquete que instale es propiedad de crmsdk. Este paquete incluirá el Microsoft.Xrm.Workflow.dll e incluirá una dependencia en el paquete Microsoft.CrmSdk.CoreAssemblies para que también se incluya el ensamblado Microsoft.Xrm.Sdk.dll necesario.

10. Debe hacer clic en Acepto en el diálogo Aceptación de licencia.

    

Cambiar el nombre del archivo de clases

1. En el Explorador de soluciones, haga clic con el botón secundario en el archivo Class1.cs predeterminado y seleccione Cambiar nombre.

   

   Nota

   Elija un nombre de clase que tenga sentido para la actividad. En este ejemplo, llamaremos a la clase IncrementByTen.

2. Seleccione Sí en el cuadro de diálogo que le pregunta si desea cambiar el nombre de la clase también.

   

3. Abra el archivo IncrementByTen.cs y agregue lo siguiente usando directivas:

   using System.Activities;
   using Microsoft.Xrm.Sdk;
   using Microsoft.Xrm.Sdk.Workflow;
   

4. Haga que la clase herede de la clase CodeActivity y asígnela un modificador de acceso público como se indica a continuación:

   public class IncrementByTen: CodeActivity
       {
   
       }
   

5. Agregue el método Execute desde la clase CodeActivity mediante acciones rápidas de Visual Studio o manualmente:

   

6. La clase ahora tiene esta apariencia:

   public class IncrementByTen : CodeActivity
   {
       protected override void Execute(CodeActivityContext context)
       {
           throw new NotImplementedException();
       }
   }
   

Definir parámetros de entrada y salida

1. Agregue un conjunto de parámetros de entrada y de salida donde el valor el valor del parámetro de salida será el valor del parámetro de entrada incrementado en 10.

   public class IncrementByTen : CodeActivity
   {
       [RequiredArgument]
       [Input("Decimal input")]
       public InArgument<decimal> DecInput { get; set; }
   
       [Output("Decimal output")]
       public OutArgument<decimal> DecOutput { get; set; }
   
       protected override void Execute(CodeActivityContext context)
       {
   
       }
   }
   

   Nota

   Observe cómo se utilizan Atributos .NET para proporcionar metadatos sobre los parámetros en el ensamblado. Más información: Agregar parámetros

Adición de lógica de negocios

Agregue la lógica en el método Execute para aplicar la lógica para aumentar el valor de entrada en 10.

    protected override void Execute(CodeActivityContext context)
    {
      decimal input = DecInput.Get(context);
      DecOutput.Set(context, input + 10);
    }

Firmar y crear el ensamblado

1. Los ensamblados de actividad personalizada de flujo de trabajo (y los complementos) se deben firmar. En las propiedades del proyecto, en la pestaña Firma seleccione Firmar el ensamblado. En Elija un archivo de clave de alta seguridad:, seleccione la opción <Nuevo...>. No es necesario establecer una contraseña a los efectos de este tutorial. Para este ejemplo hemos creado un nuevo archivo de clave de alta seguridad denominado SampleWorkflowActivity.snk

   

2. Cree la solución en modo de depuración y compruebe que el ensamblado SampleWorkflowActivity.dll está en la carpeta /bin/Debug.

Nota

Mientras desarrolla un ensamblado es válido usar la configuración de compilación de Depuración. Al implementar el ensamblado en un servidor de producción o en una solución, debe usar la configuración de compilación de Versión.

Registrar el ensamblado

Los ensamblados personalizados de actividades de flujo de trabajo se registran mediante la herramienta de registro de complementos. La herramienta proporciona una interfaz gráfica de usuario y admite el registro de ensamblajes que contienen complementos o actividades de flujo de trabajo personalizadas. Para obtener la herramienta de registro de complementos, consulte Herramientas de desarrollo de Dataverse.

Conéctese usando la herramienta de registro de complementos

1. Una vez que haya descargado la herramienta de registro de complementos, haga clic en el PluginRegistration.exe para abrirla.

2. Haga clic en Crear nueva conexión para conectarse a su instancia.

3. Asegúrese de que Office 365 está seleccionado.

4. Si se está conectando usando una cuenta Microsoft diferente a la que está usando actualmente, haga clic en Mostrar opciones avanzadas e ingrese sus credenciales. De lo contrario, deje Iniciar sesión como el usuario actual seleccionado.

5. Si su cuenta Microsoft proporciona acceso a varios entornos, seleccione Mostrar la lista de organizaciones disponibles.

   

6. Haga clic en Iniciar sesión.

7. Si ha seleccionado Mostrar la lista de organizaciones disponibles, seleccione la organización con la que quiere conectarse y haga clic en Iniciar sesión.

8. Una vez que esté conectado, verá los complementos registrados existentes, las actividades de flujo de trabajo personalizadas y los proveedores de datos.

   

Registrar el ensamblado

1. Seleccione Registrar > Registrar nuevo ensamblado

   

2. En el cuadro de diálogo Registrar nuevo ensamblado, haga clic en el botón de puntos suspensivos (…) y vaya al SampleWorkflowActivity.dll en la carpeta /bin/Debug.

   

   Nota

   Nota: Con Dataverse se seleccionan las únicas opciones válidas para los pasos 3 y 4 y se deshabilitan las opciones no válidas.

3. Haga clic en Registrar complementos seleccionados. Debe ver un diálogo de confirmación.

   

4. Haga clic en Aceptar para cerrar el diálogo Registrar nuevo ensamblado.

Configuración de nombres de actividades

1. En la lista de Complementos registrados y actividades personalizadas del flujo de trabajo, busque (Assembly) SampleWorkflowActivity y expándalo para mostrar el (Workflow Activity) SampleWorkflow.Activity.IncrementByTen - Isolatable.

2. Seleccione la (Workflow Activity) SampleWorkflow.Activity.IncrementByTen - Isolatable y en el área Propiedades edite las Propiedades editables usando los valores de la tabla siguiente:

   Campo editable	Valor original	Valor nuevo	Descripción
   Descripción		Devuelve el valor del parámetro de entrada más 10.	No es visible en la interfaz de usuario del diseñador de procesos, pero puede resultar útil al generar documentación de los datos extraídos de la entidad PluginType que almacena esta información.
   FriendlyName	un valor de GUID	IncrementByTen	Nombre descriptivo para el complemento.
   Nombre	SampleWorkflowActivity.IncrementByTen	Incrementar en 10	El nombre del menú representado
   WorkflowActivityGroupName	SampleWorkflowActivity (1.0.0.0)	Ejemplo	El nombre del submenú agregado al menú principal del diseñador del proceso de Dataverse.

   Nota

   Si el Nombre y WorkflowActivityGroupName están establecidas como null, la actividad personalizada no será visible en el diseñador de procesos.

3. Haga clic en el (icono) Guardar para guardar los cambios.

   

Probar el ensamblado

Puede probar la nueva actividad de flujo de trabajo creando un proceso que la use. Use estos pasos para crear el proceso de flujo de trabajo descrito en la sección Objetivo anterior:

1. AbrirPower Apps

2. Seleccione Solución.

3. Abra la solución Editor predeterminados de CDS.

4. En el menú, amplíe los ... y elija Cambiar a clásica.

   

5. Seleccione Procesos en la lista Componentes

6. Seleccione Nuevo y en el diálogo Crear proceso escriba lo siguiente:

   Campo	Value
   Nombre del proceso	Prueba de SampleWorkflowActivity.IncrementByTen
   Categoría	Flujo de trabajo
   Entidad	Cuenta
   Ejecutar este flujo de trabajo en segundo plano (recomendado)	anulada la selección

   Nota

   La opción de Ejecutar este flujo de trabajo en segundo plano se ha vuelto a seleccionar para convertir esto en un flujo de trabajo ( sincrónico) en tiempo real. Esto facilitará las pruebas.

   

7. Haga clic en Aceptar.

8. Aplique los cambios siguientes:

   Campo	valor
   Scope	Organización
   Iniciar cuando: Cambio en los campos de registro	seleccionada y el campo name especificado en el diálogo.

   

   Nota

   Al configurar Ámbito como Organización se crea un flujo de trabajo que puede aplicar cualquier persona de la organización.

9. Agregue el siguiente Paso:

   

10. Establezca el paso Descripción como Obtener Límite de crédito de la cuenta incrementado y haga clic en Establecer propiedades.

11. Establezca el valor de la propiedad Decimal input como el Límite de crédito de la cuenta con un valor predeterminado de 0.

    

12. Haga clic en Guardar y cerrar.

13. Agregue un paso Actualizar registro:

    

14. Haga clic en Establecer propiedades y establezca el valor del Límite de crédito como el valor del paso Obtener Límite de crédito de la cuenta incrementado.

    

    Los pasos del flujos de trabajo deben tener un aspecto similar al siguiente:

    

15. Haga clic en Guardar y cerrar.

16. Active el flujo de trabajo haciendo clic en Activar en el menú…

    

17. Y haga clic en Activar en el cuadro de diálogo Confirmación de activación de proceso.

    

18. Navegue a una aplicación basada en modelos y vea una lista de cuentas.

19. Seleccione una cuenta.

20. Editar el valor del campo Nombre de cuenta.

21. Guarde el registro de cuenta.

22. Compruebe que la cuenta que editó tiene un valor de Límite de crédito aumentado en 10.

    

Agregar el ensamblado a una solución

Para distribuir una actividad de flujo de trabajo personalizada en una solución, debe agregar el ensamblado registrado que lo contiene a una solución no administrada.

1. Abra la solución no administrada a la que desea agregar el ensamblado utilizando Power Apps

2. Seleccione Agregar existentes > Otro > Ensamblado de complementos

   

3. Busque el ensamblado de complemento por nombre, en este caso 'SampleWorkflowActivity'.

4. Seleccione el ensamblado de complemento y seleccione Agregar.

Vea también

Extensiones de flujo de trabajo
Ejemplo: crear una actividad de flujo de trabajo personalizada
Ejemplo: actualizar el siguiente cumpleaños con una actividad de flujo de trabajo personalizada
Ejemplo: Calcular una puntuación de crédito con una actividad de flujo de trabajo personalizada

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).