Guía de flujo de trabajo de Web Service Connector para SOAP

En este artículo se describe cómo crear un nuevo proyecto para el origen de datos en la herramienta de configuración del servicio web. Siga estos pasos para crear un proyecto.

1. Abra la herramienta de configuración del servicio web. Abre un proyecto en blanco.

   

2. Seleccione Proyecto SOAP y, a continuación, seleccione Agregar.

   

3. En la página siguiente, proporcione la siguiente información y, a continuación, seleccione Siguiente:

   • El nuevo nombre del servicio web
   • Dirección (ruta de acceso WSDL) para recuperar los servicios expuestos, los puntos de conexión y las operaciones
   • Namespace
   • Modo de seguridad (tipo de autenticación)

4. En este ejemplo, la página Credenciales se muestra con los requisitos para el modo de seguridad básico (el modo seleccionado en el paso anterior). Si se especificó "None" para el modo de seguridad, no se mostrará una página Credenciales. Seleccione Siguiente.

   

5. Se accede a la ruta de acceso WSDL para recuperar la información del servicio y se muestra la lista de funciones expuestas. Si la ruta de acceso WSDL especificada es incorrecta, la herramienta de configuración no puede recuperar la información del servicio y produce un error.

   

6. Una vez realizada la detección, se enumeran el punto de conexión y las operaciones que se detectan. Selecciona Finalizar.

   

7. Se realiza la compilación. Compilar es un proceso de ensamblar el contrato de datos, que puede llevar mucho tiempo. El usuario se informa sobre los errores de compilación. Una vez realizada la detección, la herramienta muestra la página siguiente:

   

8. Expandir el proyecto SOAP y seleccionar el punto de conexión expuesto proporcionado a continuación. En esta pantalla se enumeran las operaciones declaradas en el punto de conexión.

   

9. El punto de conexión expandible muestra la lista de operaciones. Una operación es una función declarada por un punto de conexión. Cada operación aborda un tipo de tarea que se puede realizar dentro del servicio. En esta pantalla se enumeran los argumentos declarados para la operación. A continuación, estos argumentos se definen cuando se usa la operación para configurar los flujos de trabajo.

   

10. El siguiente paso consiste en definir el esquema de espacio del conector, que se logra mediante la creación del tipo de objeto y la definición de sus tipos de objeto. Seleccione Tipos de objetos y, a continuación, seleccione Agregar. En la nueva ventana, agregue un nuevo tipo de objeto y proporcione un nombre. Selecciona Aceptar.

    

11. Al añadir un tipo de objeto se muestra la pantalla siguiente.

    

12. El panel derecho correspondiente al tipo de objeto permite mantener los atributos y sus propiedades para el tipo de objeto seleccionado. Selecciona Agregar. Se abre una nueva ventana para agregar atributos:

    

    

13. La siguiente pantalla aparece después de agregar todos los atributos necesarios:

    

14. El tipo de objeto y los atributos una vez creados proporciona flujos de trabajo en blanco que satisfacen las operaciones realizadas en Microsoft Identity Manager 2016 (MIM).

    

Configurar flujos de trabajo en la herramienta de configuración de servicios web

El siguiente paso consiste en configurar los flujos de trabajo para el tipo de objeto. Los archivos de flujo de trabajo son una serie de actividades que usa el conector de servicios web en tiempo de ejecución. Los flujos de trabajo se usan para implementar la operación MIM adecuada. La herramienta de configuración del servicio web le ayuda a crear cuatro flujos de trabajo diferentes:

• Importar: importe datos desde un origen de datos para los dos tipos de flujos de trabajo siguientes:

  • Importación completa: importación completa que se puede configurar.
  • Importación diferencial: no es compatible con la herramienta de configuración del servicio web.

• Exportar: exporte datos de MIM a un origen de datos conectado. Se admiten las tres acciones siguientes para la operación. Puede configurar estas acciones en función de sus requisitos.

  • Agregar
  • Eliminar
  • Replace

• Contraseña: realice la administración de contraseñas para el usuario (tipo de objeto). Hay dos acciones disponibles para esta operación:

  • Establecer contraseña
  • Cambiar contraseña

• Probar conexión: configure un flujo de trabajo para comprobar si la conexión con el servidor de origen de datos se ha establecido correctamente.

Nota:

Puede configurar estos flujos de trabajo para el proyecto o descargar el proyecto predeterminado desde el Centro de descarga de Microsoft.

Diseñador de flujo de trabajo

El Diseñador de flujos de trabajo abre el área de trabajo para configurar el flujo de trabajo según los requisitos. Para cada tipo de objeto (nuevo /existing), la herramienta de configuración proporciona los nodos para los flujos de trabajo admitidos por la herramienta.

El Diseñador de flujos de trabajo se compone de los siguientes elementos de interfaz de usuario:

• Nodos en el panel izquierdo: le ayudarán a seleccionar qué flujo de trabajo desea diseñar.

• Diseñador central de flujos de trabajo: aquí puede quitar las actividades para configurar los flujos de trabajo. Para realizar varias operaciones de MIM (exportación, importación, administración de contraseñas), puede usar las actividades de flujo de trabajo estándar y personalizadas de .NET Workflow Framework 4. La herramienta Configuración del servicio web usa actividades de flujo de trabajo estándar y personalizadas. Para obtener más información sobre las actividades estándar, consulte Uso de diseñadores de actividad.

  • En el Diseñador central de flujos de trabajo, un círculo rojo con signo de exclamación junto a cualquier actividad indica que la operación se quitó y no está definida correctamente y completamente. Mantenga el puntero sobre el círculo rojo para averiguar el error exacto. Una vez definida correctamente la actividad, el círculo rojo cambia a la marca de información amarilla.

  • En el Diseñador central de flujos de trabajo, una marca de información de triángulo amarillo junto a cualquier actividad indica que se define la actividad, pero hay más que puede hacer para completar la actividad. Mantenga el puntero sobre el triángulo amarillo para ver más información.

• Cuadro de herramientas: empaqueta todas las herramientas, incluidas las actividades personalizadas y del sistema, y las instrucciones predefinidas para diseñar el flujo de trabajo. Para obtener más información, consulte Cuadro de herramientas.

• Secciones del cuadro de herramientas: el Cuadro de herramientas tiene las siguientes secciones y categorías:

  • Descripción: encabezado del cuadro de herramientas. Una pestaña accede al Cuadro de herramientas y a las propiedades de la actividad de flujo de trabajo seleccionada.

  • Flujo de trabajo de importación: actividades personalizadas para configurar flujos de trabajo de importación.

  • Exportar flujo de trabajo: actividades personalizadas para configurar flujos de trabajo de exportación.

  • Común: actividades personalizadas para configurar cualquier flujo de trabajo.

  • Depurar: actividades de flujo de trabajo del sistema para la depuración definidas en el flujo de trabajo 4. Estas actividades permiten el seguimiento de problemas de un flujo de trabajo.

  • Instrucciones: actividades de flujo de trabajo del sistema definidas en Flujo de trabajo 4. Para obtener más información, consulte Uso de diseñadores de actividad.

• Propiedades: en la pestaña propiedades se muestran las propiedades de una actividad de flujo de trabajo determinada que se quita en el área del diseñador y se selecciona. En la figura de la izquierda se muestran las propiedades de la actividad Asignar. Para cada actividad, las propiedades difieren y se usan al configurar el flujo de trabajo personalizado. Esta pestaña permite que defina los atributos de la herramienta seleccionada que se ha introducido en el diseñador central de flujos de trabajo. Para obtener más información, vea Propiedades.

• Barra de tareas: La barra de tareas incluye tres elementos: Variables, Argumentos e Importaciones. Estos elementos se usan junto con las actividades de flujo de trabajo. Para obtener más información, consulte Introducción de un desarrollador a Windows Workflow Foundation (WF) en .NET 4.

Configuración de un flujo de trabajo de importación completo en la herramienta de configuración del servicio web

En los pasos siguientes se muestra cómo configurar flujos de trabajo de importación completos para SOAP mediante la herramienta de configuración del servicio web.

Advertencia

Este ejemplo solo crea un flujo de trabajo. Es posible que se requieran modificaciones en el flujo de trabajo, como usar lógica personalizada en la API.

1. Seleccione el flujo de trabajo de importación completa para configurar. Los argumentos e importaciones ya están definidos y son específicos de las actividades. Consulte las siguientes pantallas para obtener más información.

   

   

   Después de la reconfiguración de las llamadas, cambie los nombres de los atributos que cambian, agregue o cambie el espacio de nombres a variables que hacen referencia a la estructura de retorno de la API y los tipos de objeto que hacen referencia al espacio de nombres anterior. El cuadro de herramientas del panel derecho contiene todas las actividades personalizadas específicas del flujo de trabajo que necesita para la configuración. Asigne los valores a las variables que va a usar para la lógica. Vaya a la sección inferior del diseñador de flujos de trabajo central y declare las variables. Las variables se declaran en el paso siguiente.

2. Añada una actividad Sequence. Arrastre el diseñador de actividades Sequence desde el cuadro de herramientas y colóquelo en la superficie del diseñador de flujos de trabajo de Windows. Consulte las siguientes pantallas. La actividad Sequence contiene una colección ordenada de actividades secundarias que sen ejecutan por orden.

   

3. Para agregar una variable, busque Crear variable. Escriba wsResponse para el nombre, seleccione la lista desplegable Tipo de variable y, a continuación, seleccione Examinar tipos. Se muestra un cuadro de diálogo. Seleccione generada>predeterminada>respuesta. Mantenga los valores Ámbito y Predeterminados no seleccionados. Como alternativa, establezca estos valores mediante la vista Propiedades .

   

   

4. Ahora, agregue todas las demás variables y a continuación es la pantalla final.

   

5. Arrastre otro diseñador de actividades Sequence desde el cuadro de herramienta dentro de la actividad Sequence ya añadida.

6. Arrastre una actividad WebServiceCallActivity presentada en Común. Esta actividad se usa para invocar una operación de servicio web disponible después de la detección. Se trata de una actividad personalizada y es común en diferentes escenarios de operación.

   

   Para usar la operación de servicio web, establezca las siguientes propiedades:

   • Nombre del servicio: escriba un nombre para el servicio web.

   • Nombre del punto de conexión: especifique un nombre de punto de conexión para el servicio seleccionado.

   • Nombre de la operación: especifique la operación correspondiente para el servicio.

   • Argumento: seleccione Argumentos. En el cuadro de diálogo siguiente, asigne los valores de argumento, como se muestra en la ilustración siguiente:

     

     Importante

     No cambie el nombre, la dirección ni el tipo de un argumento mediante este cuadro de diálogo. Si se cambia alguno de estos valores, la actividad deja de ser válida. Establezca solo el valor para el argumento . Como se muestra en esta ilustración, se establece el valor wsResponse .

7. Añada una actividad ForEach justo debajo de WebServiceCallActivity. Esta actividad se usa para recorrer todos los atributos (tanto delimitadores como no delimitadores) del tipo de objeto. Al arrastrar esta actividad a la superficie del Diseñador de flujos de trabajo, enumera automáticamente todos los nombres de atributo del objeto. Establezca los valores necesarios según la siguiente pantalla:

   

8. Arrastre una actividad CreateCSEntryChangeScope dentro del cuerpo de ForEach. Esta actividad se usa para crear una instancia del objeto CSEntryChange en el dominio de flujo de trabajo para cada registro respectivo mientras recupera datos del origen de datos de destino. Al arrastrar esta actividad, se muestra la siguiente pantalla. Las actividades CreateAnchorAttribute se heredan automáticamente.

   

9. Establezca el valor de la expresión DN como ‘string.Concat ("Employee",item.EmployeeID)’. Establezca AnchorValue para EmployeeID en 'Convert.tostring(item). EmployeeID)'. Establezca ObjectTypeName como Employee. Después de realizar estas modificaciones, verá la siguiente pantalla:

   

   Nota:

   Los valores de delimitador y los nombres de objeto varían según el servicio web expuesto. En la ilustración se muestra un ejemplo.

10. Arrastre una actividad CreateAttributeChange debajo de la actividad CreateAnchorAttribute . El número de actividades que se arrastran es igual al número de atributos no delimitadores. Consulte la ilustración siguiente para obtener referencia.

    

11. Arrastre CreateValueChangeActivity dentro de la actividad CreateAttributeChange y establezca el valor de atributo según la pantalla siguiente.

    

    Nota:

    Para usar esta actividad, elija y asigne los campos respectivos de la lista desplegable y asigne los valores. En el caso de los atributos multivalor, agregue varias actividades CreateValueChangeActivity dentro de una actividad CreateAttributeChangeActivity.

12. Para agregar condiciones para un atributo, agregue una actividad If como se muestra en la ilustración siguiente:

    

13. Por último, agregue una actividad Assign y establezca la expresión, como se muestra en la ilustración siguiente:

    

14. Guarde este proyecto en la ubicación %FIM_INSTALL_FOLDER%\Synchronization Service\Extensions.

    Los proyectos predeterminados deben descargarse y guardarse en la ubicación %FIM_INSTALL_DIR\2010\Synchronization Service\Extensions del sistema de destino. A continuación, los proyectos estarán visibles en el Asistente para conectores de servicios web.

    Al ejecutar el archivo ejecutable, se le pedirá que especifique la ubicación de la instalación. Escriba la ubicación de almacenamiento.

    Importante

    El archivo del proyecto se puede guardar y abrir desde cualquier ubicación (con los privilegios de acceso adecuados de su ejecutor). Solo se pueden seleccionar los archivos de proyecto guardados en la Synchronization Service\Extension carpeta en el asistente del conector de servicios web al que se accede a través de la interfaz de usuario de sincronización de MIM.

    El usuario que ejecuta la herramienta de configuración del servicio web requiere los siguientes privilegios:

    • Control total en la carpeta Extensión del servicio de sincronización.
    • Acceso de lectura a la clave del registro HKLM\System\CurrentControlSet\Services\FIMSynchronizationService\Parameters a través de la cual se ubica la ruta de acceso de la carpeta de extensiones.

Configuración de flujos de trabajo de exportación en la herramienta de configuración de servicios web

En las secciones siguientes se muestra cómo exportar los flujos de trabajo mediante la herramienta de configuración de servicios web.

Adición de flujos de trabajo

Agregue flujos de trabajo de exportación siguiendo estos pasos en la Herramienta de configuración de servicios web.

1. Seleccione el flujo de trabajo de exportación que desea configurar. En Exportar, seleccione Agregar. Los argumentos e importaciones ya están definidos y son específicos de las actividades. Consulte las siguientes pantallas para obtener referencia.

   

2. Agregue una actividad Sequence . Arrastre el diseñador de actividades Secuencia desde el Cuadro de herramientas y colóquelo en la superficie del Diseñador de flujos de trabajo de Windows. La actividad Sequence contiene una colección ordenada de actividades secundarias que sen ejecutan por orden. Seleccione Crear variable. Asigne los valores a las variables que va a usar para la lógica.

   

   Nota:

   Los pasos para agregar una variable se describen en la sección para crear flujos de trabajo de importación completos.

3. Arrastre una actividad ForEach dentro de la actividad Sequence ya agregada para iterar sobre los valores de atributo de ancla.

4. Seleccione Propiedades y establezca los valores según la pantalla siguiente. Aquí objectToExport es el argumento .

   

5. Establecer DisplayName como ForEach<AnchorAttribute>

   

6. Establezca TypeArgument como Microsoft.MetadirectoryServices.AnchorAttribute.

   

7. Agregue una actividad Switch dentro del cuerpo ForEach del AnchorAttribute.

   

8. Agregue una expresión de acuerdo con la siguiente pantalla.

   

9. Seleccione Agregar un nuevo caso y escriba un valor para EmployeeId. Arrastre una actividad Sequence y, dentro de ella, agregue una actividad Assign .

   

10. Asigne las propiedades To y Value para la actividad Assign .

    

11. La actividad ForEach se usa para los valores ancla. Agregue otra actividad ForEach para asignar valores que no son delimitadores. En este ejemplo, se usa el ancla AttributeChange.

    

12. Agregue una actividad Switch en el cuerpo de ForEach del anclaje AttributeChange .

    

13. Agregue una expresión como se muestra en la pantalla siguiente.

    

14. Seleccione Agregar un nuevo caso y escriba un valor para FirstName. Arrastre una actividad Sequence y, dentro de ella, agregue una actividad Assign . Asigne las propiedades To y Value para la actividad Assign .

    

15. Agregue valores para los atributos necesarios, como LastName, Email, etc.

    

16. En Común, arrastre un WebServiceCallActivity y establezca Valores para sus argumentos.

    

    Importante

    No cambie el nombre, la dirección ni el tipo de un argumento mediante este cuadro de diálogo. Si se cambia alguno de estos valores, la actividad deja de ser válida. Establezca solo el valor para el argumento . Como se muestra en esta ilustración, se establece el valor wsResponse .

17. Por último, agregue una actividad If para comprobar las respuestas que se devuelven de la operación del servicio web.

La creación del flujo de trabajo de exportación con la operación Agregar se ha completado:

Guarde este proyecto en la ubicación %FIM_INSTALL_FOLDER%\Synchronization Service\Extensions.

Eliminación de flujos de trabajo

Elimine los flujos de trabajo de exportación siguiendo estos pasos en la herramienta de configuración del servicio web.

1. Seleccione el flujo de trabajo de exportación que desea configurar. En Exportar, seleccione Eliminar. Los argumentos e importaciones ya están definidos y son específicos de las actividades. Consulte las siguientes pantallas para obtener referencia.

   

2. Agregue una actividad Sequence . Seleccione Crear variable. Asigne los valores a las variables que va a usar para la lógica.

   

   Nota:

   Los pasos para agregar una variable se describen en la sección para crear flujos de trabajo de importación completos.

3. Arrastre una actividad ForEach dentro de la actividad Sequence ya agregada para iterar sobre los valores de atributo de anclaje.

4. Seleccione Propiedades y establezca los valores según la pantalla siguiente. Aquí objectToExport es el argumento .

   

5. Establezca displayName como ForEach\<AnchorAttribute\>:

   

6. Establezca TypeArgument como Microsoft.MetadirectoryServices.AnchorAttribute:

   

7. Agregue una actividad Switch dentro del cuerpo ForEach del AnchorAttribute.

   

8. Agregue una expresión de acuerdo con la siguiente pantalla.

   

9. Seleccione Agregar un nuevo caso y escriba un valor para EmployeeId. Arrastre una actividad Sequence y, dentro de ella, agregue una actividad Assign .

   

10. Asigne las propiedades To y Value para la actividad Assign .

    

11. En Común, arrastre WebServiceCallActivity y establezca Valores para sus argumentos.

    

    Importante

    No cambie el nombre, la dirección ni el tipo de un argumento mediante este cuadro de diálogo. Si se cambia alguno de estos valores, la actividad deja de ser válida. Establezca solo el valor para el argumento . Como se muestra en esta ilustración, se establece el valor employeeID .

12. Por último, agregue una actividad If para comprobar las respuestas devueltas desde la operación del servicio web.

La eliminación del flujo de trabajo de exportación con la operación Delete se ha completado:

Guarde este proyecto en la ubicación %FIM_INSTALL_FOLDER%\Synchronization Service\Extensions.

Reemplazar flujos de trabajo

Reemplace los flujos de trabajo de exportación siguiendo estos pasos en la Herramienta de configuración de servicios web.

1. Seleccione el flujo de trabajo de exportación que desea configurar. En Exportar, seleccione Reemplazar. Los argumentos e importaciones ya están definidos y son específicos de las actividades. Consulte la pantalla siguiente para obtener referencia.

   

2. Agregue una actividad Sequence .

3. Arrastre una actividad ForEach para <AnchorAttribute>.

4. Agregue otra actividad ForEach<AttributeChange> para asignar valores que no son delimitadores.

5. Por último, la pantalla tiene el siguiente aspecto. Las instrucciones para configurar esta actividad se proporcionan en la sección para agregar flujos de trabajo de exportación.

   

6. En Común, arrastre un WebServiceCallActivity y establezca Valores para sus argumentos.

   

   Importante

   No cambie el nombre, la dirección ni el tipo de un argumento mediante este cuadro de diálogo. Si se cambia alguno de estos valores, la actividad deja de ser válida. Establezca solo el valor para el argumento . Como se muestra en esta figura, se establece el valor empleado.

7. Por último, agregue una actividad If para comprobar las respuestas que se devuelven de la operación del servicio web.

Se ha completado el reemplazo del flujo de trabajo de exportación por la operación Replace :

Guarde este proyecto en la ubicación %FIM_INSTALL_FOLDER%\Synchronization Service\Extensions.

Actividades de depuración de software

Las siguientes actividades personalizadas están disponibles para ayudar a depurar la plantilla de flujo de trabajo.

Registro de actividad

La actividad Registro se usa para escribir mensajes de texto en el archivo de registro. Para obtener más información, vea Registro.

Nota:

Si no puede depurar fácilmente el flujo de trabajo, pruebe a depurar el flujo de trabajo en el entorno de producción.

Para usar la actividad Registro , establezca las siguientes propiedades. Las propiedades son visibles al seleccionar la actividad en el Diseñador de flujos de trabajo y ver las propiedades de la actividad.

Actividad WriteLine

La actividad WriteLine se usa para escribir mensajes de texto en el escritor de un proveedor. Si no hay ningún escritor disponible, la actividad WriteLine escribe el texto en la ventana de la consola.

En el cuadro de texto, escriba el mensaje que desea que esté visible en el destino del escritor.

Importante

La ventana de la consola no se puede usar para esta actividad. Use otro escritor de salida de ventana para esta tarea.

Para usar la actividad WriteLine , establezca las siguientes propiedades. Las propiedades son visibles al seleccionar la actividad en el Diseñador de flujos de trabajo y ver las propiedades de la actividad.

• Nivel de registro: especifica la cantidad de contenido que se va a escribir en el valor de registro. Los valores posibles son:

  • Alto: escriba el mensaje LogText en el archivo de registro si la gravedad del registro está establecida en Alto.
  • Detallado: escriba el mensaje LogText en el archivo de registro si el nivel de severidad del registro está establecido en Detallado.
  • Deshabilitado: no escriba en el archivo de registro.

• LogText: especifica el contenido de texto que se va a escribir en el registro.

• Etiqueta: agrega una etiqueta al texto para identificar el tipo de contenido que se está escribiendo en el registro. Los valores posibles son: Error, Seguimiento o Advertencia.

Pasos siguientes

• Información general sobre el conector genérico de servicios web
• Instalar la herramienta de configuración de servicios web
• Guía de implementación de SOAP
• Guía de implementación de REST
• Configuración de MA del servicio web