Compartir a través de

Crear una actividad de flujo de trabajo personalizada

  • Artículo

 

Publicado: enero de 2017

Se aplica a: Dynamics 365 (online), Dynamics 365 (on-premises), Dynamics CRM 2016, Dynamics CRM Online

Este tema describe cómo crear una actividad personalizada de flujo de trabajo y registrarla para usarla en Microsoft Dynamics 365 (en línea y local). En Microsoft Dynamics 365 (online), las actividades de flujo de trabajo personalizadas solo pueden registrarse para ejecutarse en el espacio aislado (confianza parcial). Para obtener más información acerca del espacio aislado y la confianza parcial, consulte Aislamiento, relacioens de confianza y estadísticas de complementos.

En este tema

Software y ensamblados necesarios

Uso de la clase base de flujo de trabajo CodeActivity

Especificación del nombre y el nombre de grupo para una actividad de flujo de trabajo personalizada

Software y ensamblados necesarios

Para desarrollar actividades personalizadas de Windows Workflow Foundation 4 para Dynamics 365, debe desarrollarlas en Microsoft .NET Framework 4.5.2. Los ensamblados siguientes deben agregarse como referencias en el proyecto. Pueden encontrarse en la carpeta SDK\Bin del SDK de Microsoft Dynamics 365.Descargue el paquete de SDK de Microsoft Dynamics CRM.

  • Microsoft.Xrm.Sdk.dll

  • Microsoft.Xrm.Sdk.Workflow.dll

Uso de la clase base de flujo de trabajo CodeActivity

Para crear una actividad personalizada de flujo de trabajo, cree una clase que herede de la clase base de flujo de trabajo CodeActivity. Esta clase está disponible en el espacio de nombres System.Activities. Las actividades que heredan de la clase CodeActivity pueden reemplazar el método Execute para generar funciones personalizadas.

  1. Iniciar Microsoft Visual Studio.

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

  3. En el cuadro de diálogo Nuevo proyecto, seleccione Flujo de trabajo en Visual c# en el panel Plantillas instalan y, a continuación, seleccione Biblioteca de actividad.

  4. Especifique un nombre y una ubicación para la solución y, a continuación, haga clic en Aceptar.

  5. Vaya al menú Proyecto y seleccione Propiedades. En la pestaña Aplicación, especifique .NET Framework 4.5.2 como marco de trabajo de destino.

  6. Agregue referencias a los ensamblados Microsoft.Xrm.Sdk.dll y Microsoft.Xrm.Workflow.dll.

  7. Elimine el archivo Activity1.xaml del proyecto.

  8. Agregue un archivo de clase (.cs) al proyecto. En el Explorador de soluciones, haga clic con el botón secundario en el proyecto, seleccione Agregar y, a continuación, haga clic en Class. En el cuadro Agregar nuevo artículo, escriba un nombre para la clase y haga clic en Agregar.

  9. Abra el archivo de clase y agregue lo siguiente usando directivas:

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

  10. 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 SampleCustomActivity : CodeActivity

  11. Agregue funcionalidad a la clase agregando un método Execute:

    protected override void Execute(CodeActivityContext context){    //Activity code}

    Para obtener más información, vea Agregar metadatos a una actividad de flujo de trabajo personalizada.

  12. Especifique parámetros de entrada y salida. Para obtener más información, vea Agregar metadatos a una actividad de flujo de trabajo personalizada.

  13. En las propiedades del proyecto, en la pestaña Firma, seleccione Firmar el ensamblado y especifique un nombre de archivo clave. Los ensamblados de actividad personalizada de flujo de trabajo (y los complementos) se deben firmar.

  14. Compile el proyecto para crear un ensamblado (.dll).

Para ver un código de ejemplo que muestra cómo crear una actividad personalizada de flujo de trabajo, consulte Ejemplo: crear una actividad de flujo de trabajo personalizada.

Importante

Para mejorar el rendimiento, Microsoft Dynamics 365 almacena en caché las instancias de actividad personalizada de flujo de trabajo. El método Execute de la actividad personalizada de flujo de trabajo se debe escribir para que no tenga estado porque no se llama al constructor para cada invocación de la actividad personalizada de flujo de trabajo. Además, varios subprocesos del sistema podrían ejecutar la actividad personalizada de flujo de trabajo al mismo tiempo. Toda la a información de estado por llamada se almacena en el contexto, por lo que no se recomienda usar variables globales o a variables de miembro para pasar datos de una invocación a la siguiente.

Especificación del nombre y el nombre de grupo para una actividad de flujo de trabajo personalizada

Cuando registre un ensamblado de actividades de flujo de trabajo personalizadas, especifique el nombre y el nombre de grupo. La propiedad de nombre especifica el nombre de la actividad de flujo de trabajo. La propiedad de nombre de grupo especifica el nombre del submenú agregado al menú principal del diseñador del proceso de Microsoft Dynamics 365. Estas propiedades vinculan la actividad de flujo de trabajo personalizada con el diseñador del proceso de Microsoft Dynamics 365, de modo que aparezca el nombre de la actividad personalizada en la interfaz de usuario.

Para especificar el nombre y el nombre de grupo de una actividad personalizada de flujo de trabajo, use los atributos PluginType.Name y PluginType.WorkflowActivityGroupName al registrar el ensamblado de actividades de flujo de trabajo personalizadas. Para obtener más información acerca del registro de actividades personalizadas de flujo de trabajo, consulte Registrar y usar un ensamblado personalizado de actividad de flujo de trabajo. Si los atributos PluginType.Name y PluginType.WorkflowActivityGroupName se establecen en null, la actividad personalizada se oculta del diseñador de flujo de trabajo de Microsoft Dynamics 365 y solo es accesible desde flujos de trabajo XAML.

Si va a usar la herramienta de registro de complementos para registrar el ensamblado de actividades de flujo de trabajo personalizadas, puede especificar valores apropiados en los cuadros Name y WorkflowActivityGroupName, en la región Editable. Para obtener más información acerca de la herramienta de registro de complementos, consulte Tutorial: registrar un complemento mediante la herramienta de registro de complementos.

Especificar nombre de grupo y nombre durante el registro

Una vez registrada esta actividad personalizada de flujo de trabajo, puede usarla desde el diseñador del proceso de Microsoft Dynamics 365 para flujos de trabajo o diálogos. Para obtener más información, vea Registrar y usar un ensamblado personalizado de actividad de flujo de trabajo.

Ver también

Actividades de flujo de trabajo personalizadas (ensamblados de flujo de trabajo)
Agregar metadatos a una actividad de flujo de trabajo personalizada
Usar el servicio web de IOrganization en una actividad de flujo de trabajo personalizada
Ejemplo: crear una actividad de flujo de trabajo personalizada
Ejemplo: actividad personalizada de flujo de trabajo basada en Azure
Clases de actividad base de Windows Workflow Foundation 4

Microsoft Dynamics 365

© 2017 Microsoft. Todos los derechos reservados. Copyright