Crear un flujo de trabajo personalizado (Master Data Services)

Artículo
04/04/2023

Se aplica a: SQL Server: solo Azure SQL Instancia administrada de Windows

Master Data Services usa reglas de negocio para crear soluciones básicas de flujo de trabajo, como actualizar y validar automáticamente los datos 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 el flujo de trabajo requiere un procesamiento de eventos complejo, como aprobaciones de varios niveles o árboles de decisión complicados, puede configurar Master Data Services para iniciar un flujo de trabajo personalizado que analice los datos y determine dónde enviarlo para su aprobación.

Cómo se procesan los flujos de trabajo personalizados

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

Se usa Master Data Manager para validar una entidad que inicia un flujo de trabajo.
Master Data Manager envía miembros que cumplen las condiciones de la regla de negocio a una cola de Service Broker en la base de datos de Master Data Services.
A intervalos regulares, SQL Server MDS Workflow Integration Service llama a un procedimiento almacenado en la base de datos de Master Data Services.
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.
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

La creación de un flujo de trabajo personalizado requiere escribir código personalizado y configurar Master Data Services para pasar datos de flujo de trabajo al controlador de flujo de trabajo. Para habilitar el procesamiento del flujo de trabajo personalizado, siga estos pasos:

Cree un ensamblado de .NET que implemente Microsoft.MasterDataServices.WorkflowTypeExtender.IWorkflowTypeExtender.
Configure sql Server MDS Workflow Integration Service para conectarse a la base de datos de Master Data Services y asociar una etiqueta al controlador de flujo de trabajo.
Inicie el servicio de integración de flujos de trabajo MDS de SQL Server.
Cree una regla de negocio en Master Data Manager que inicie un flujo de trabajo etiquetado con el nombre del controlador de flujo de trabajo.
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 biblioteca de clases de .NET que implementa la interfaz Microsoft.MasterDataServices.WorkflowTypeExtender.IWorkflowTypeExtender . Sql Server MDS Workflow Integration Service llama al método Microsoft.MasterDataServices.WorkflowTypeExtender.IWorkflowTypeExtender.StartWorkflow* para ejecutar el código. Para obtener código de ejemplo que implementa Microsoft.MasterDataServices.WorkflowTypeExtender.IWorkflowTypeExtender.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:

En Visual Studio 2010, cree un proyecto Biblioteca de clases que use el idioma que quiera. Para crear una biblioteca de clases de C#, seleccione los tipos de proyecto Visual C#\Windows y la plantilla Biblioteca de clases. Escriba un nombre para el proyecto (por ejemplo, MDSWorkflowTest) y haga clic en Aceptar.
Agregue una referencia a Microsoft.MasterDataServices.WorkflowTypeExtender.dll. Este ensamblado se puede encontrar en <La carpeta> de instalación\Master Data Services\WebApplication\bin.
Agregue "using Microsoft.MasterDataServices.Core.Workflow;" al archivo de código de C#.
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".
Implemente la interfaz Microsoft.MasterDataServices.WorkflowTypeExtender.IWorkflowTypeExtender . El método Microsoft.MasterDataServices.WorkflowTypeExtender.IWorkflowTypeExtender.StartWorkflow* lo llama el servicio de integración de flujos de trabajo MDS de SQL Server para iniciar el flujo de trabajo.
Copie el ensamblado en la ubicación del ejecutable del servicio de integración de flujos de trabajo de MDS de SQL Server, denominado Microsoft.MasterDataServices.Workflow.exe, en <la 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 información de conexión para la base de datos de Master Data Services y asociar una etiqueta con el ensamblado del controlador de flujo de trabajo siguiendo estos pasos:

Busque Microsoft.MasterDataServices.Workflow.exe.config en <la carpeta> de instalación\Master Data Services\WebApplication\bin.
Agregue la información de conexión de base de datos de Master Data Services a la configuración "ConnectionString". Si la instalación de SQL Server usa intercalación que distingue mayúsculas de minúsculas, el nombre de la base de datos debe escribirse en el mismo caso que en 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>  
```
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 de valor> está en forma de nombre> de tipo de flujo de trabajo calificado>< para ensamblados de flujo de <trabajo. <La etiqueta> de flujo de trabajo es un nombre que se usa para identificar el ensamblado del controlador de flujo de trabajo al crear una regla de negocio en Master Data Manager. <el nombre> del tipo de flujo de trabajo calificado para ensamblados es el nombre completo del espacio de nombres de la clase de flujo de trabajo, seguido de una coma, seguido 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 de configuración> si ha creado varios controladores de flujo de trabajo para distintos tipos de flujos de trabajo.

Nota:

En función 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:

Utilice el administrador Usuarios y grupos locales para crear un usuario local con nombre, por ejemplo, mds_workflow_service.
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 este usuario al inicio de sesión de mds_workflow_service y conceda al usuario el permiso EXECUTE a [mdm]. Procedimiento almacenado [udpExternalActionsGet].
Conceda al usuario mds_workflow_service permiso para ejecutar el ensamblado controlador del flujo de trabajo. Para ello, agregue el usuario mds_workflow_service a la pestaña Seguridad de las propiedades del ensamblado controlador del flujo de trabajo y conceda al usuario mds_workflow_service los permisos READ y EXECUTE.
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, agregue el mds_workflow_service usuario a la pestaña Seguridad de las propiedades de Microsoft.MasterDataServices.Workflow.exe, en <la carpeta> de instalación\Master Data Services\WebApplication\bin y conceda el permiso READ y EXECUTE del usuario mds_workflow_service.
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 pueden encontrar en la carpeta de instalación de .NET, como 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.
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

Use Master Data Manager para crear y publicar una regla de negocios que iniciará el flujo de trabajo cuando se aplique. 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 los 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 Master Data Manager siguiendo estos pasos:

En el editor de reglas de negocios de Master Data Manager, después de especificar las condiciones de la regla de negocio, arrastre la acción Iniciar flujo de trabajo de la lista Acciones externas a la etiqueta Acción del panel THEN.
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).
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.
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.
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.
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 Master Data Manager para editar la entidad que contiene los miembros que desea validar. Haga clic en Aplicar reglas de negocios. En respuesta a la regla de negocios, Master Data Manager 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:

Utilice el complemento Servicios para detener el servicio.
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.
En Master Data Manager, actualice el miembro y vuelva a aplicar 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 pueden encontrar en la Explorador de objetos de SQL Management Studio en 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.

Consulte también

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

Compartir vía