Extremo de control de flujo de trabajo

El punto de conexión de control de flujo de trabajo permite a los desarrolladores llamar a las operaciones de control para controlar de forma remota instancias de flujo de trabajo hospedadas mediante WorkflowServiceHost. Esta característica se puede utilizar para realizar operaciones de control mediante programación como la suspensión, la reanudación y la finalización.

Advertencia

Si usa el punto de conexión de control de flujo de trabajo dentro de una transacción y el flujo de trabajo que se controla contiene una actividad Persist, la instancia de flujo de trabajo no responderá hasta que se agote el tiempo de espera de la transacción.

Administración de instancias de flujo de trabajo

.NET Framework 4.6.1 define un nuevo contrato denominado IWorkflowInstanceManagement. Este contrato define una serie de operaciones de control que le permiten controlar de forma remota instancias de flujo de trabajo hospedadas por WorkflowServiceHost. WorkflowControlEndpoint es un extremo estándar que proporciona una implementación del contrato de IWorkflowInstanceManagement. WorkflowControlClient es una clase que se usa para enviar operaciones de control a WorkflowControlEndpoint.

Las instancias de flujo de trabajo pueden presentar uno de los estados siguientes:

Activo
El estado de una instancia de flujo de trabajo antes de alcanzar el estado completado y cuando no se encuentra en estado suspendido. Cuando se encuentra en este estado, la instancia de flujo de trabajo se ejecuta y procesa los mensajes de aplicación.

Suspended
Cuando se encuentra en este estado, la instancia de flujo de trabajo no se ejecuta aunque haya actividades que no hayan comenzado a ejecutarse o se han ejecutado parcialmente.

Completado
El estado final de una instancia de flujo de trabajo. La instancia de flujo de trabajo no se puede ejecutar después de alcanzar el estado completado.

IWorkflowInstanceManagement

La interfaz IWorkflowInstanceManagement define un conjunto de operaciones de control con versiones sincrónicas y asincrónicas. Las versiones de transacción requieren el uso de un enlace que reconoce las transacciones. En la siguiente tabla, se enumeran las operaciones de control admitidas.

Operación de control	Descripción
Anulación	Detiene de forma obligatoria la ejecución de la instancia de flujo de trabajo.
Cancelar	Realiza una transición de una instancia de flujo de trabajo del estado activo o suspendido al estado completado.
Ejecutar	Ofrece a una instancia de flujo de trabajo la oportunidad de ejecutarse.
Suspender	Realiza una transición de una instancia de flujo de trabajo del estado activo al estado suspendido.
Terminate	Realiza una transición de una instancia de flujo de trabajo del estado activo o suspendido al estado completado.
Unsuspend	Realiza una transición de una instancia de flujo de trabajo del estado suspendido al estado activo.
TransactedCancel	Realiza la operación de cancelación en una transacción (procedente del cliente o creada localmente). Si el sistema mantiene el estado durable de la instancia de flujo de trabajo, la instancia de flujo de trabajo se debe conservar durante la ejecución de esta operación.
TransactedRun	Realiza la operación de ejecución en una transacción (procedente del cliente o creada localmente). Si el sistema mantiene el estado durable de la instancia de flujo de trabajo, la instancia de flujo de trabajo se debe conservar durante la ejecución de esta operación.
TransactedSuspend	Realiza la operación de suspensión en una transacción (procedente del cliente o creada localmente). Si el sistema mantiene el estado durable de la instancia de flujo de trabajo, la instancia de flujo de trabajo se debe conservar durante la ejecución de esta operación.
TransactedTerminate	Realiza la operación de finalización en una transacción (procedente del cliente o creada localmente). Si el sistema mantiene el estado durable de la instancia de flujo de trabajo, la instancia de flujo de trabajo se debe conservar durante la ejecución de esta operación.
TransactedUnsuspend	Realiza la operación de cancelación de la suspensión en una transacción (procedente del cliente o creada localmente). Si el sistema mantiene el estado durable de la instancia de flujo de trabajo, la instancia de flujo de trabajo se debe conservar durante la ejecución de esta operación.

El contrato de IWorkflowInstanceManagement no proporciona un medio para crear una nueva instancia de flujo de trabajo, solo para administrar instancias de flujo de trabajo existentes. Para obtener más información sobre cómo crear de forma remota una nueva instancia de flujo de trabajo, consulte Extensibilidad de host de servicio de flujo de trabajo.

WorkflowControlEndpoint

WorkflowControlEndpoint es un extremo estándar con un contrato fijo, IWorkflowInstanceManagement. Cuando se agrega a una instancia de WorkflowServiceHost, este extremo se puede usar para enviar operaciones de comando a cualquier instancia de flujo de trabajo hospedada por la instancia del host. Para obtener más información sobre los puntos de conexión estándar, consulte Puntos de conexión estándar.

WorkflowControlClient

WorkflowControlClient es una clase que le permite enviar mensajes de control a una clase WorkflowControlEndpoint en una clase WorkflowServiceHost. Contiene un método para cada una de las operaciones admitidas por el contrato de IWorkflowInstanceManagement excepto para las operaciones con transacciones. WorkflowControlClient usa la transacción ambiente para determinar si se debe usar una operación con transacciones.