Extensibilidad de almacén

Este tema es aplicable a Windows Workflow Foundation 4.

SqlWorkflowInstanceStore permite a los usuarios promover propiedades personalizadas, específicas de la aplicación que se pueden utilizar para consultar instancias en la base de datos de persistencia. El acto de promover una propiedad hace que el valor esté disponible dentro de una vista especial en la base de datos. Estas propiedades promovidas (propiedades que se pueden usar en consultas de usuario) pueden ser de tipos simples como Int64, Guid, String y DateTime o de un tipo binario serializado (byte []).

La clase SqlWorkflowInstanceStore tiene el método Promote que puede usar para promover una propiedad que se puede usar en consultas. El siguiente ejemplo es un ejemplo de un extremo a otro de extensibilidad del almacén.

1. En este escenario de ejemplo, una aplicación de procesamiento (DP) de documentos tiene flujos de trabajo, cada uno de los cuales usa actividades personalizadas para el procesamiento del documento. Estos flujos de trabajo tienen un conjunto de variables de estado que deben hacerse visibles para el usuario final. Para conseguirlo, la aplicación DP proporciona una extensión de instancia de tipo PersistenceParticipant, que las actividades usan para proporcionar variables de estado.

   class DocumentStatusExtension : PersistenceParticipant
   {
       public string DocumentId;
       public string ApprovalStatus;
       public string UserName;
       public DateTime LastUpdateTime;
   }
   

2. A continuación, la nueva extensión se agrega al host.

   static Activity workflow = CreateWorkflow();
   WorkflowApplication application = new WorkflowApplication(workflow);
   DocumentStatusExtension documentStatusExtension = new DocumentStatusExtension ();
   application.Extensions.Add(documentStatusExtension);
   

   Para obtener más detalles sobre cómo agregar un participante de persistencia personalizado, vea el ejemplo Participantes de persistencia.

3. Las actividades personalizadas en la aplicación DP rellenan varios campos de estado en el método Execute.

   public override void Execute(ActivityExecutionContext context)
   {
       // ...
       context.GetExtension<DocumentStatusExtension>().DocumentId = Guid.NewGuid();
       context.GetExtension<DocumentStatusExtension>().UserName = "John Smith";
       context.GetExtension<DocumentStatusExtension>().ApprovalStatus = “Approved”;
       context.GetExtension<DocumentStatusExtension>().LastUpdateTime = DateTime.Now();
       // ...
   }
   

4. Cuando una instancia de flujo de trabajo alcanza un punto de persistencia, el método CollectValues del participante de persistencia de DocumentStatusExtension guarda estas propiedades en la colección de datos de persistencia.

   class DocumentStatusExtension : PersistenceParticipant
   {
       const XNamespace xNS = XNamespace.Get("https://contoso.com/DocumentStatus");
   
       protected override void CollectValues(out IDictionary<XName, object> readWriteValues, out IDictionary<XName, object> writeOnlyValues)
       {
           readWriteValues = new Dictionary<XName, object>();
           readWriteValues.Add(xNS.GetName("UserName"), this.UserName);
           readWriteValues.Add(xNS.GetName("ApprovalStatus"), this.ApprovalStatus);
           readWriteValues.Add(xNS.GetName("DocumentId"), this.DocumentId);
           readWriteValues.Add(xNS.GetName("LastModifiedTime"), this.LastUpdateTime);
   
           writeOnlyValues = null;
       }
       // ...
   }
   

   Nota:
   Todas estas propiedades se pasan a SqlWorkflowInstanceStore mediante el marco de persistencia a través de la colección SaveWorkflowCommand.InstanceData.

5. La aplicación DP inicializa el almacén de instancias de flujo de trabajo de SQL e invoca el método Promote para promover estos datos.

       SqlWorkflowInstanceStore store = new SqlWorkflowInstanceStore(connectionString);
   
       List<XName> variantProperties = new List<XName>() 
       { 
           xNS.GetName("UserName"), 
           xNS.GetName("ApprovalStatus"), 
           xNS.GetName("DocumentId"), 
           xNS.GetName("LastModifiedTime") 
       };
   
       store.Promote("DocumentStatus", variantProperties, null);
   

   Según la información de promoción, SqlWorkflowInstanceStore coloca las propiedades de datos en las columnas de [System.Activities.DurableInstancing.InstancePromotedProperties] view.

6. Para consultar un subconjunto de datos en la tabla de promoción, la aplicación DP agrega una vista personalizada encima de la vista de promoción.

   create view [dbo].[DocumentStatus] with schemabinding
   as
       select  P.[InstanceId] as [InstanceId],
           P.Value1 as [UserName],
           P.Value2 as [ApprovalStatus],
           P.Value3 as [DocumentId],
           P.Value4 as [LastUpdatedTime]
   from [System.Activities.DurableInstancing].[InstancePromotedProperties] as P
   where P.PromotionName = N'DocumentStatus'
   go
   

Vista [System.Activities.DurableInstancing.InstancePromotedProperties]