Crear un flujo de trabajo personalizado (Master Data Services)

  • Artículo

Master Data Services utiliza reglas de negocio para crear soluciones básicas de flujo de trabajo, como actualizar y validar datos automáticamente, y enviar notificaciones por correo electrónico en función de las condiciones que especifique. Cuando requiera un procesamiento más complejo que el que proporcionan las acciones de flujo de trabajo integradas, puede usar un flujo de trabajo personalizado. Un flujo de trabajo personalizado es un ensamblado de .NET creado por usted. Cuando se llama a su ensamblado de flujo de trabajo, el código puede realizar cualquier acción que requiera la situación. Por ejemplo, si su flujo de trabajo requiere un procesamiento de eventos más complejos, como aprobaciones de varios niveles o árboles de decisiones complejos, puede configurar Master Data Services para que inicie un flujo de trabajo personalizado que analice los datos y determine dónde enviarlos para su aprobación.

Cómo se procesan los flujos de trabajo personalizados

Hay tres componentes principales implicados en el procesamiento de flujos de trabajo personalizados: la aplicación web de Administrador de datos maestros, el servicio de integración de flujos de trabajo MDS de SQL Server y el ensamblado controlador del flujo de trabajo. Estos componentes procesan un flujo de trabajo personalizado de la manera siguiente:

  1. Para validar una entidad que inicia un flujo de trabajo se usa Administrador de datos maestros.

  2. Administrador de datos maestros envía los miembros que satisfacen las condiciones de la regla de negocio a una cola de Service Broker en la base de datos de Master Data Services.

  3. A intervalos regulares, el servicio de integración de flujos de trabajo MDS de SQL Server llama a un procedimiento almacenado en la base de datos de Master Data Services.

  4. Cuando este procedimiento almacenado encuentra registros en la cola de Service Broker, los devuelve al servicio de integración de flujos de trabajo MDS de SQL Server.

  5. El servicio de integración de flujos de trabajo MDS de SQL Server enruta los datos al ensamblado controlador del flujo de trabajo.

[!NOTA]

Nota: el servicio de integración de flujos de trabajo MDS de SQL Server está diseñado para desencadenar procesos simples. Si su código personalizado requiere un procesamiento complejo, realice el procesamiento en un subproceso distinto o fuera del proceso de flujo de trabajo.

Configurar Master Data Services para flujos de trabajo personalizados

Crear un flujo de trabajo personalizado requiere escribir código personalizado y configurar Master Data Services para que pase los datos del flujo de trabajo al controlador de flujo de trabajo. Para habilitar el procesamiento del flujo de trabajo personalizado, siga estos pasos:

  1. Cree un ensamblado .NET que implemente Microsoft.MasterDataServices.WorkflowTypeExtender.IWorkflowTypeExtender.

  2. Configure el servicio de integración de flujos de trabajo MDS de SQL Server para que se conecte a la base de datos de Master Data Services y para asociar una etiqueta a su controlador de flujo de trabajo.

  3. Inicie el servicio de integración de flujos de trabajo MDS de SQL Server.

  4. Cree una regla de negocio en Administrador de datos maestros que inicie un flujo de trabajo etiquetado con el nombre de su controlador de flujo de trabajo.

  5. Aplique la regla de negocio a un miembro que desencadene el flujo de trabajo personalizado.

Crear el ensamblado controlador del flujo de trabajo

Un flujo de trabajo personalizado es un ensamblado de la biblioteca de clases .NET que implementa la interfaz Microsoft.MasterDataServices.WorkflowTypeExtender.IWorkflowTypeExtender. El servicio de integración de flujos de trabajo MDS de SQL Server llama al método StartWorkflow para ejecutar el código. Para obtener código de ejemplo que implementa StartWorkflow, vea Ejemplo de flujo de trabajo personalizado (Master Data Services).

Siga estos pasos para utilizar Visual Studio 2010 para crear un ensamblado al que el servicio de integración de flujos de trabajo MDS de SQL Server pueda llamar para controlar un flujo de trabajo personalizado:

  1. En Visual Studio 2010, cree un nuevo proyecto de biblioteca de clases con el lenguaje que desee. Para crear una biblioteca de clases en C#, seleccione los tipos de proyecto Visual C#\Windows y seleccione la plantilla Biblioteca de clases. Escriba un nombre para el proyecto, como PruebaFlujoDeTrabajoMDS y haga clic en Aceptar.

  2. Agregue una referencia a Microsoft.MasterDataServices.WorkflowTypeExtender.dll. Este ensamblado se encuentra en <Su carpeta de instalación>\Master Data Services\WebApplication\bin.

  3. Agregue ‘using Microsoft.MasterDataServices.Core.Workflow;’ al archivo de código C#.

  4. Herede de Microsoft.MasterDataServices.WorkflowTypeExtender.IWorkflowTypeExtender en la declaración de clase. La declaración de clase debe ser similar a: ‘public class WorkflowTester : IWorkflowTypeExtender’.

  5. Implemente la interfaz Microsoft.MasterDataServices.WorkflowTypeExtender.IWorkflowTypeExtender. El servicio de integración de flujos de trabajo MDS de SQL Server llama al método StartWorkflow para iniciar el flujo de trabajo.

  6. Copie el ensamblado en la ubicación del archivo ejecutable del servicio de integración de flujos de trabajo MDS de SQL Server, denominado Microsoft.MasterDataServices.Workflow.exe, en <Su carpeta de instalación>\Master Data Services\WebApplication\bin.

Configurar el servicio de integración de flujos de trabajo MDS de SQL Server

Edite el archivo de configuración de Master Data Services para incluir la información de conexión de su base de datos de Master Data Services y asociar una etiqueta al ensamblado controlador del flujo de trabajo siguiendo estos pasos:

  1. Busque Microsoft.MasterDataServices.Workflow.exe.config en <Su carpeta de instalación>\Master Data Services\WebApplication\bin.

  2. Agregue la información de conexión de la base de datos de Master Data Services al valor “ConnectionString”. Si su instalación de SQL Server usa la intercalación con distinción de mayúsculas y minúsculas, el nombre de la base de datos debe especificarse con el mismo uso de mayúsculas y minúsculas que el de la base de datos. Por ejemplo, la etiqueta de configuración completa debe ser similar a la siguiente:

    <setting name="ConnectionString" serializeAs="String">
    <value>Server=myServer;Database=myDatabase;Integrated Security=True</value>
</setting>

  3. Debajo del valor “ConnectionString” agregue un valor “WorkflowTypeExtenders” para asociar un nombre de etiqueta al ensamblado controlador del flujo de trabajo. Por ejemplo:

    <setting name="WorkflowTypeExtenders" serializeAs="String">
    <value>TEST=MDSWorkflowTestLib.WorkflowTester, MDSWorkflowTestLib</value>
</setting>

    El texto interno de la etiqueta <value> tiene el formato <Etiqueta de flujo de trabajo>=<nombre de tipo de flujo de trabajo calificado mediante el nombre de ensamblado>. <Etiqueta de flujo de trabajo> es el nombre que utiliza para identificar el ensamblado controlador del flujo de trabajo cuando crea una regla de negocio en Administrador de datos maestros. <nombre de tipo de flujo de trabajo calificado mediante el nombre de ensamblado> es el nombre de la clase de flujo de trabajo calificado para el espacio de nombres, seguido de una coma y del nombre para mostrar del ensamblado. Si su ensamblado tiene un nombre seguro, tendrá que incluir también la información de versión y su PublicKeyToken. Puede incluir varias etiquetas <setting> si ha creado varios controladores de flujo de trabajo para distintos tipos de flujos de trabajo.

[!NOTA]

Dependiendo de la configuración del servidor, puede que aparezca un error "Acceso denegado" al intentar guardar el archivo Microsoft.MasterDataServices.Workflow.exe.config. En tal caso, deshabilite temporalmente Control de cuentas de usuario (UAC) en el servidor. Para ello, abra el Panel de control y haga clic en Sistema y seguridad. En Centro de actividades, haga clic en Cambiar configuración de Control de cuentas de usuario. En el cuadro de diálogo Configuración del Control de cuentas de usuario, desplace la barra hasta abajo para no recibir nunca ninguna notificación. Reinicie su equipo y repita el procedimiento anterior para editar el archivo de configuración. Después de guardar el archivo, restaure la configuración de UAC al nivel predeterminado.

Iniciar el servicio de integración de flujos de trabajo MDS de SQL Server

De manera predeterminada, el servicio de integración de flujos de trabajo MDS de SQL Server no se instala. Debe instalar el servicio para poder usarlo. Para mayor seguridad, cree un usuario local para el servicio y conceda a este usuario sólo los permisos necesarios para realizar operaciones de flujo de trabajo. Para crear un usuario, instalar el servicio e iniciarlo, siga estos pasos:

  1. Utilice el administrador Usuarios y grupos locales para crear un usuario local con nombre, por ejemplo, mds_workflow_service.

  2. Utilice SQL Server Management Studio para conceder permiso al usuario mds_workflow_service para ejecutar el procedimiento almacenado [mdm].[udpExternalActionsGet]. Para ello, cree un nuevo inicio de sesión para la cuenta de mds_workflow_service, cree un nuevo usuario en la base de datos de Master Data Services, asigne el usuario al inicio de sesión de mds_workflow_service y conceda al usuario permiso EXECUTE al procedimiento almacenado [mdm].[udpExternalActionsGet].

  3. Conceda al usuario mds_workflow_service permiso para ejecutar el ensamblado controlador del flujo de trabajo. Para ello, en la pestaña Seguridad agregue el usuario mds_workflow_service a las Propiedades del ensamblado controlador del flujo de trabajo y conceda al usuario mds_workflow_service el permiso READ y EXECUTE.

  4. Conceda al usuario mds_workflow_service permiso para ejecutar el archivo ejecutable del servicio de integración de flujos de trabajos MDS de SQL Server. Para ello, en la pestaña Seguridad agregue el usuario mds_workflow_service a las Propiedades de Microsoft.MasterDataServices.Workflow.exe, ubicado en <Su carpeta de instalación>\Master Data Services\WebApplication\bin, y conceda al usuario mds_workflow_service el permiso READ y EXECUTE.

  5. Instale el servicio de integración de flujos de trabajo MDS de SQL Server mediante la utilidad de instalación de .NET, denominada InstallUtil.exe. InstallUtil.exe se encuentra en la carpeta de instalación de .NET (por ejemplo, C:\Windows\Microsoft.NET\Framework\v4.0 .30319 \). Instale el servicio de integración de flujos de trabajo MDS de SQL escribiendo lo siguiente en el símbolo del sistema con permisos elevados:

    C:\Windows\Microsoft.NET\Framework\v4.0.30319\InstallUtil Microsoft.MasterDataServices.Workflow.exe

    Especifique el usuario mds_workflow_service cuando se le solicite durante la instalación.

  6. Inicie el servicio de integración de flujos de trabajo MDS de SQL Server mediante el complemento Servicios. Para ello, busque el servicio de integración de flujos de trabajo MDS de SQL Server en el complemento Servicios, selecciónelo y haga clic en el vínculo Iniciar.

Crear una regla de negocio del flujo de trabajo

Utilice Administrador de datos maestros para crear y publicar una regla de negocio que inicie el flujo de trabajo cuando corresponda. Debe asegurarse de que la regla de negocio contiene las acciones que cambian los valores de atributo, de modo que la regla se evalúe como false una vez aplicada. Por ejemplo, la regla de negocio puede evaluarse como true cuando un valor del atributo Precio sea superior a 500 y el valor del atributo Aprobado esté en blanco. La regla puede incluir dos acciones: una para establecer el valor del atributo Aprobado en Pendiente y otra para iniciar el flujo de trabajo. También puede crear una regla que use la condición "ha cambiado" y agregar atributos a los grupos de seguimiento de cambios. Para obtener más información sobre las reglas de negocio, consulte Reglas de negocios (Master Data Services).

Cree una regla de negocio que inicie un flujo de trabajo personalizado en Administrador de datos maestros siguiendo estos pasos:

  1. En el editor de la regla de negocio de Administrador de datos maestros, una vez especificas las condiciones de la regla de negocio, arrastre la acción Iniciar flujo de trabajo desde la lista Acciones externas a la etiqueta THEN del panel Acción.

  2. En el panel Editar acción, en el cuadro Tipo de flujo de trabajo, escriba la etiqueta que identifica el ensamblado controlador del flujo de trabajo. Esta es la etiqueta que especificó en el archivo de configuración del ensamblado (por ejemplo, PRUEBA).

  3. Opcionalmente, active la casilla Incluir datos de miembro. Active esta casilla para incluir nombres y valores de atributo en el XML que se pasa al controlador del flujo de trabajo.

  4. En el cuadro Sitio de flujo de trabajo, escriba el nombre de un sitio web. Puede que esto no se aplique a su flujo de trabajo personalizado, pero se puede usar para agregar contexto.

  5. En el cuadro Nombre de flujo de trabajo, escriba el nombre del flujo de trabajo de Visual Studio. Puede que esto no se aplique a su flujo de trabajo personalizado, pero se puede usar para agregar contexto.

  6. Guarde y publique la regla de negocio.

Aplicar las reglas de negocio para iniciar un flujo de trabajo

Aplique la regla de negocio a sus datos para iniciar el flujo de trabajo. Para ello, use Administrador de datos maestros para editar la entidad que contiene los miembros que desea validar. Haga clic en Aplicar reglas de negocios. En respuesta a la regla de negocio, Administrador de datos maestros rellena la cola de Service Broker de la base de datos de Master Data Services. Cuando el servicio de integración de flujos de trabajo MDS de SQL Server compruebe la cola, enviará los datos al ensamblado controlador del flujo de trabajo especificado y borrará la cola. El ensamblado controlador del flujo de trabajo realiza todas las acciones que se hayan codificado en él.

Solución de problemas de flujos de trabajo personalizados

Si el ensamblado controlador del flujo de trabajo no recibe datos, puede intentar depurar el servicio de integración de flujos de trabajo MDS de SQL Server o examinar la cola de Service Broker.

Depurar el servicio de integración de flujos de trabajo MDS de SQL Server

Para depurar el servicio de integración de flujos de trabajo de SQL Server, siga estos pasos:

  1. Utilice el complemento Servicios para detener el servicio.

  2. Abra un símbolo del sistema, vaya a la ubicación del servicio y ejecute el servicio en modo de consola especificando: Microsoft.MasterDataServices.Workflow.exe -console.

  3. En Administrador de datos maestros, actualice el miembro y aplique de nuevo las reglas de negocio. En la ventana de la consola se muestran registros detallados.

Examinar la cola de Service Broker

La cola de Service Broker que contiene los datos maestros pasados como parte del flujo de trabajo es: mdm.microsoft/mdm/queue/externalaction. Las colas se encuentran en el Explorador de objetos de SQL Management Studio bajo el nodo Service Broker de la base de datos de Master Data Services. Tenga en cuenta que si el servicio borró la cola correctamente, la cola estará vacía.

Vea también

Conceptos

Ejemplo de flujo de trabajo personalizado (Master Data Services)

Descripción del código XML de flujo de trabajo personalizado (Master Data Services)