Desarrollo de servicio de flujo de trabajo de contrato primero
A partir de .NET Framework 4.5, Windows Workflow Foundation (WF) cuenta con una mejor integración entre los servicios web y los flujos de trabajo en forma de desarrollo de flujo de trabajo de contrato primero. La herramienta de desarrollo de flujo de trabajo de contrato primero permite diseñar el contrato en Code First. La herramienta después genera automáticamente una plantilla de actividad en el cuadro de herramientas para las operaciones del contrato. Este tema proporciona información general sobre cómo se asignan las actividades y las propiedades de un servicio de flujo de trabajo a los atributos de un contrato de servicio. Para ver un ejemplo paso a paso de cómo crear un servicio de flujo de trabajo de contrato primero, consulte Procedimiento para crear un servicio de flujo de trabajo que consuma un contrato de servicio existente.
En este tema
Asignar atributos de contrato de servicio a atributos de flujo de trabajo
En las tablas de las siguientes secciones se especifican los diferentes atributos y propiedades de WCF, así como el modo en que se asignan a las actividades y a las propiedades de mensajería en un flujo de trabajo de contrato primero.
Atributos de contrato de servicio
| Nombre de la propiedad | Compatible | Descripción | Validación WF |
|---|---|---|---|
| CallbackContract | No | Obtiene o establece el tipo de contrato de devolución de llamada cuando el contrato es un contrato dúplex. | (No disponible) |
| ConfigurationName | No | Obtiene o establece el nombre utilizado para buscar el servicio en un archivo de configuración de la aplicación. | (No disponible) |
| HasProtectionLevel | Sí | Obtiene un valor que indica si el miembro tiene un nivel de protección asignado. | Receive.ProtectionLevel no debe ser NULL. |
| Nombre | Sí | Obtiene o establece el nombre para <portType> con el lenguaje de descripción de servicios Web (WSDL). | Receive.ServiceContractName.LocalName debe coincidir. |
| Espacio de nombres | Yes | Obtiene o establece el espacio de nombres para <portType> con el lenguaje de descripción de servicios Web (WSDL). | Receive.ServiceContractName.NameSpace debe coincidir. |
| ProtectionLevel | Sí | Especifica si el enlace para el contrato debe admitir el valor de la propiedad ProtectionLevel. | Receive.ProtectionLevel debe coincidir. |
| SessionMode | No | Obtiene o establece si se permiten sesiones, si no se permiten o si son necesarias. | (No disponible) |
| TypeId | No | Cuando se implementa en una clase derivada, obtiene un identificador único para este atributo. (Heredado del atributo) | (No disponible) |
Inserte aquí el cuerpo de la subsección.
Atributos de contrato de operación
| Nombre de la propiedad | Compatible | Descripción | Validación WF |
|---|---|---|---|
| Acción | Sí | Obtiene o establece la acción WS-Addressing del mensaje de solicitud. | Receive.Action debe coincidir. |
| AsyncPattern | No | Indica que una operación se implementa utilizando de forma asincrónica un par de métodos Begin<nombreDelMétodo> y End<nombreDelMétodo> en un contrato de servicio. | (No disponible) |
| HasProtectionLevel | Sí | Obtiene un valor que indica si los mensajes para esta operación deben cifrarse, firmarse o ambos. | Receive.ProtectionLevel no debe ser NULL. |
| IsInitiating | No | Obtiene o establece un valor que indica si el método implementa una operación que puede iniciar una sesión en el servidor (si tal sesión existe). | (No disponible) |
| IsOneWay | Sí | Obtiene o establece un valor que indica si una operación devuelve un mensaje de respuesta. | (Ningún SendReply para este Receive o ningún ReceiveReply para este envío). |
| IsTerminating | No | Obtiene o establece un valor que indica si la operación de servicio hace que el servidor cierre la sesión después de enviar el mensaje de respuesta, si lo hubiera. | (No disponible) |
| Nombre | Sí | Obtiene o establece el nombre de la operación. | Receive.OperationName debe coincidir. |
| ProtectionLevel | Yes | Obtiene o establece un valor que especifica si los mensajes de una operación deben cifrarse, firmarse o ambos. | Receive.ProtectionLevel debe coincidir. |
| ReplyAction | Yes | Obtiene o establece el valor de la acción SOAP para el mensaje de respuesta de la operación. | SendReply.Action debe coincidir. |
| TypeId | No | Cuando se implementa en una clase derivada, obtiene un identificador único para este atributo. (Heredado del atributo) | (No disponible) |
Atributos de contrato de mensaje
| Nombre de la propiedad | Compatible | Descripción | Validación WF |
|---|---|---|---|
| HasProtectionLevel | Sí | Obtiene un valor que indica si el mensaje tiene un nivel de protección. | Ninguna validación (Receive.Content y SendReply.Content deben coincidir con el tipo de contrato de mensaje). |
| IsWrapped | Yes | Obtiene o establece un valor que especifica si el cuerpo del mensaje tiene un elemento contenedor. | Ninguna validación (Receive.Content y Sendreply.Content deben coincidir con el tipo de contrato de mensaje). |
| ProtectionLevel | No | Obtiene o establece un valor que especifica si los mensajes deben cifrarse, firmarse o las dos cosas. | (No disponible) |
| TypeId | Sí | Cuando se implementa en una clase derivada, obtiene un identificador único para este atributo. (Heredado del atributo) | Ninguna validación (Receive.Content y SendReply.Content deben coincidir con el tipo de contrato de mensaje). |
| WrapperName | Sí | Obtiene o establece el nombre del elemento contenedor del cuerpo del mensaje. | Ninguna validación (Receive.Content y SendReply.Content deben coincidir con el tipo de contrato de mensaje). |
| WrapperNamespace | No | Obtiene o establece el espacio de nombres del elemento contenedor del cuerpo del mensaje. | (No disponible) |
Atributos de contrato de datos
| Nombre de la propiedad | Compatible | Descripción | Validación WF |
|---|---|---|---|
| IsReference | No | Obtiene o establece un valor que indica si conservar los datos de referencia al objeto. | (No disponible) |
| Nombre | Sí | Obtiene o establece el nombre del contrato de datos para el tipo. | Ninguna validación (Receive.Content y SendReply.Content deben coincidir con el tipo de contrato de mensaje). |
| Espacio de nombres | Yes | Obtiene o establece el espacio de nombres del contrato de datos para el tipo. | Ninguna validación (Receive.Content y SendReply.Content deben coincidir con el tipo de contrato de mensaje). |
| TypeId | No | Cuando se implementa en una clase derivada, obtiene un identificador único para este atributo. (Heredado del atributo) | (No disponible) |
Atributos de contrato de error
| Nombre de la propiedad | Compatible | Descripción | Validación WF |
|---|---|---|---|
| Acción | Sí | Obtiene o establece la acción del mensaje de error de SOAP que se especifica como parte del contrato de la operación. | SendReply.Action debe coincidir. |
| DetailType | Yes | Obtiene el tipo de un objeto serializable que contiene información de error. | SendReply.Content debe coincidir con el tipo |
| HasProtectionLevel | No | Obtiene un valor que indica si el mensaje de error de SOAP tiene un nivel de protección asignado. | (No disponible) |
| Nombre | No | Obtiene o establece el nombre del mensaje de error en el Lenguaje de descripción de servicios Web (WSDL). | (No disponible) |
| Espacio de nombres | No | Obtiene o establece el espacio de nombres del error de SOAP. | (No disponible) |
| ProtectionLevel | No | Especifica el nivel de protección que el error de SOAP requiere del enlace. | (No disponible) |
| TypeId | No | Cuando se implementa en una clase derivada, obtiene un identificador único para este atributo. (Heredado del atributo) | (No disponible) |
Información adicional sobre compatibilidad e implementación
Características no admitidas de contrato de servicio
No se admite el uso de tareas TPL (biblioteca de tareas en paralelo) en contratos.
No se admite la herencia en contratos de servicio.
Generación de actividades de mensajería configuradas
Dos métodos static públicos se agregan a las actividades Receive y SendReply para admitir la creación de actividades de mensaje preconfiguradas al usar servicios de flujo de trabajo de contrato primero.
La actividad generada por estos métodos debe pasar la validación del contrato y, por consiguiente, estos métodos se usan internamente como parte de la lógica de validación para Receive y SendReply. OperationName, ServiceContractName, Action, SerializerOption, ProtectionLevel y KnownTypes están preconfigurados para coincidir con el contrato importado. En la página de propiedades de contenido para las actividades del Diseñador de flujo de trabajo, las secciones Mensaje o Parámetros también están preconfiguradas para coincidir con el contrato.
Los contratos de error de WCF también se controlan con la devolución de un conjunto aparte de actividades SendReply configuradas para cada uno de los errores que aparecen en Faults FaultDescriptionCollection.
Para otras partes de OperationDescription que los servicios WF no admiten actualmente (por ejemplo, los comportamientos WebGet y WebInvoke, o comportamientos de operación personalizados), la API omite esos valores en la generación y la configuración. No se producirán excepciones.
