Руководство по рабочему процессу соединителя веб-служб для SOAP

В этой статье описывается, как создать проект для источника данных в средстве настройки веб-службы. Выполните следующие действия, чтобы создать проект.

1. Откройте средство настройки веб-службы. Откроется пустой проект.

   

2. Выберите проект SOAP и затем нажмите Добавить.

   

3. На следующей странице укажите следующие сведения, а затем нажмите кнопку Далее:

   • Новое имя веб-службы
   • Адрес (путь WSDL) для извлечения предоставляемых сервисов, конечных точек и операций.
   • Пространство имен
   • Режим безопасности (тип проверки подлинности)

4. В этом примере страница учетных данных отображается с требованиями к режиму безопасности базовый (режим, выбранный на предыдущем шаге). Если параметр "Нет" был указан для режима безопасности, страница "Учетные данные" не будет отображаться. Выберите Далее.

   

5. Получен доступ к пути WSDL для извлечения информации о сервисе, и отображается список открытых функций. Если введенный путь WSDL неверный, средство настройки не получает сведения о службе и выдает ошибку.

   

6. После выполнения обнаружения он перечисляет конечную точку и обнаруженные операции. Нажмите Готово.

   

7. Компиляция выполнена. Компиляция — это процесс создания сборки контракта данных, который может быть продолжительным. Пользователь сообщает о любых ошибках компиляции. После выполнения обнаружения средство отображает следующую страницу:

   

8. Расширение проекта SOAP и выбор открытой конечной точки, представленной ниже экраном. На этом экране перечислены операции, объявленные в конечной точке.

   

9. При расширении конечной точки отображается список операций. Операция — это функция, объявленная конечной точкой. Каждая операция решает тип задачи, которую можно выполнить в службе. На этом экране перечислены аргументы, объявленные для операции. Затем эти аргументы определяются при использовании операции при настройке рабочих процессов.

   

10. Далее необходимо определить схему пространства соединителя, которая достигается путем создания типа объекта и определения их типов объектов. Выберите типы объектов, а затем выберите Добавить. В новом окне добавьте новый тип объекта и укажите имя. Нажмите ОК.

    

11. Добавление типа объекта предоставляется на экране ниже.

    

12. Правая область, соответствующая типу объекта, позволяет поддерживать атрибуты и их свойства для выбранного типа объекта. Выберите Добавить. Откроется новое окно для добавления атрибутов:

    

    

13. Следующий экран появляется после того, как все обязательные атрибуты добавлены.

    

14. Тип объекта и атрибуты после создания предоставляют пустые рабочие процессы, которые удовлетворяют операциям, выполняемым в Microsoft Identity Manager 2016 (MIM).

    

Настройка рабочих процессов в средстве настройки веб-службы

Следующим шагом является настройка рабочих процессов для типа объекта. Файлы рабочего процесса — это последовательность действий, используемых соединителем веб-служб во время выполнения. Рабочие процессы используются для реализации соответствующей операции MIM. Средство настройки веб-службы помогает создать четыре разных рабочих процесса:

• Импорт: импорт данных из источника данных для следующих двух типов рабочих процессов:

  • Полный импорт: полный импорт, который можно настроить.
  • Разностный импорт: не поддерживается инструментом конфигурации веб-службы.

• Экспорт: экспорт данных из MIM в подключенный источник данных. Для операции поддерживаются следующие три действия. Эти действия можно настроить на основе ваших требований.

  • Добавь
  • Удалить
  • Заменить

• Пароль. Выполнение управления паролями для пользователя (типа объекта). Для этой операции доступны два действия:

  • Установка пароля
  • Смена пароля

• Проверка подключения: настройте рабочий процесс, чтобы проверить, успешно ли установлено соединение с сервером источника данных.

Конструктор рабочих процессов

Конструктор рабочих процессов открывает рабочую область для настройки рабочего процесса по требованию. Для каждого типа объекта (новый /существующий) средство настройки предоставляет узлы для рабочих процессов, поддерживаемых средством.

Конструктор рабочих процессов состоит из следующих элементов пользовательского интерфейса:

• Узлы в левой панели: они помогают выбрать, какой рабочий процесс вы хотите разработать.

• Центральный Конструктор Рабочих Процессов: Здесь вы можете перетащить действия для настройки рабочих процессов. Для выполнения различных операций MIM (экспорт, импорт, управление паролями) можно использовать стандартные и настраиваемые действия рабочего процесса .NET Workflow Framework 4. Средство настройки веб-службы использует стандартные и настраиваемые действия рабочего процесса. Дополнительные сведения о стандартных действиях см. в разделе Использование конструкторов действий.

  • В центральном конструкторе рабочих процессов красный круг со восклицательным знаком рядом с любым действием указывает, что операция удалена и не определена правильно и полностью. Наведите указатель мыши на красный круг, чтобы узнать точную ошибку. После правильного определения действия красный круг изменится на желтый знак информации.

  • В центральном конструкторе рабочих процессов желтый треугольник рядом с любым действием указывает на то, что действие определено, но для выполнения действия можно сделать больше. Наведите указатель мыши на желтый треугольник, чтобы просмотреть дополнительные сведения.

• панели элементов: упаковает все средства, включая системные и пользовательские действия, и предопределенные инструкции для разработки рабочего процесса. Дополнительные сведения см. в разделе набор инструментов.

• разделы панели инструментов: Панель инструментов имеет следующие разделы и категории:

  • Description: заголовок панели инструментов. Одна вкладка обращается к панели элементов и свойствам выбранного действия рабочего процесса.

  • импорт рабочих процессов: настраиваемые действия для настройки импорта рабочих процессов.

  • Процесс экспорта: пользовательские действия для конфигурации экспортных процессов.

  • Common: настраиваемые действия для настройки любого рабочего процесса.

  • отладка: действия системного рабочего процесса для отладки, предусмотренные в рабочем процессе 4. Эти действия позволяют отслеживать проблемы для рабочего процесса.

  • утверждения: действия системного рабочего процесса, определенные в Workflow 4. Дополнительные сведения см. в разделе Использование конструкторов действий.

• Свойства: вкладка свойств отображает свойства определенного действия рабочего процесса, которое помещено в область конструктора и выбрано. На рисунке слева показаны свойства действия Назначение. Для каждого действия свойства отличаются и используются при настройке пользовательского рабочего процесса. Эта вкладка позволяет определить атрибуты выбранного инструмента, который был удален в центральный конструктор рабочих процессов. Дополнительные сведения см. в разделе Свойства.

• панель задач : Панель задач включает три элемента: переменные, аргументыи импорт. Эти элементы используются в сочетании с действиями рабочего процесса. Дополнительные сведения см. в статье Введение разработчика в Windows Workflow Foundation (WF) в .NET 4.

Настройка полного рабочего процесса импорта в средстве настройки веб-службы

1. Выберите рабочий процесс полного импорта для настройки. Аргументы и Импорты уже определены и специфичны для конкретных действий. Дополнительные сведения см. на следующих экранах.

   

   

   После перенастройки вызовов измените имена атрибутов, которые изменились, и добавьте или измените пространство имен для переменных, ссылающихся на структуру возвращаемых данных API, а также для типов объектов, которые ссылаются на старое пространство имен. Панель инструментов в правой области содержит все специфические пользовательские действия, необходимые для настройки. Назначьте значения переменным, которые будут использоваться для логики. Перейдите в нижний раздел центрального конструктора рабочих процессов и объявите переменные. Переменные объявляются на следующем шаге.

2. Добавьте действие последовательности. Перетащите средство разработки последовательностей из панели инструментов и поместите его на поверхность Windows Workflow Designer. Пожалуйста, посмотрите следующие экраны. Действие Последовательности содержит упорядоченную коллекцию дочерних действий, которые выполняются по очереди.

   

3. Чтобы добавить переменную, найдите Создать переменную. Введите wsResponse для имени, выберите в раскрывающемся списке тип переменной, а затем выберите "Обзор типов". Отображается диалоговое окно. Выберите сгенерированные>по умолчанию>ответы. Оставьте значения Область и По умолчанию не выбранными. Кроме того, задайте эти значения с помощью представления свойств .

   

   

4. Теперь добавьте все остальные переменные и ниже — окончательный экран.

   

5. Перетащите еще один конструктор действий последовательности из Панели элементов в уже добавленный элемент последовательности.

6. Перетащите WebServiceCallActivity, представленный в разделе Common. Это действие используется для вызова операции веб-службы, доступной после обнаружения. Это настраиваемое действие и распространено в разных сценариях операций.

   

   Чтобы использовать операцию веб-службы, задайте следующие свойства:

   • имя службы: введите имя веб-службы.

   • имя конечной точки: укажите имя конечной точки для выбранной службы.

   • имя операции: укажите соответствующую операцию для службы.

   • аргумент: выберите аргументы. В следующем диалоговом окне назначьте значения аргументов, как показано на следующем рисунке:

     

     Это важно

     Не изменяйте Имя, Направлениеили Тип для аргумента с помощью этого диалогового окна. Если любое из этих значений изменено, действие становится недействительным. Задайте только значение аргумента. Как показано на этом рисунке, задано значение wsResponse.

7. Добавьте действие ForEach чуть ниже WebServiceCallActivity. Это действие используется для итерации по всем атрибутам (как привязкам, так и не привязкам) типа объекта. При перетаскивании этого действия в область конструктора рабочих процессов он автоматически перечисляет все имена атрибутов для объекта. Задайте необходимые значения на следующем экране:

   

8. Перетащите действие CreateCSEntryChangeScope в тело ForEach. Это действие используется для создания экземпляра объекта CSEntryChange в домене рабочего процесса для каждой соответствующей записи при получении данных из целевого источника данных. Перетаскивание этого действия предоставляется на экране ниже. действия CreateAnchorAttribute автоматически наследуются.

   

9. Задайте значение выражения DN как ‘string.Concat ("Employee",item.EmployeeID)’. Задайте AnchorValue для EmployeeID значением ‘Convert.tostring(item.EmployeeID)’. Задайте ObjectTypeName как Employee. После внесения этих изменений вы увидите следующий экран:

   

   Примечание.

   Значения привязки и имена объектов зависят от предоставленной веб-службы. На рисунке показан пример.

10. Перетащите действие CreateAttributeChange под действием CreateAnchorAttribute. Количество перетаскиваемых действий равно числу незакрепленных атрибутов. Дополнительные сведения см. на следующем рисунке.

    

11. Перетащите CreateValueChangeActivity в действие CreateAttributeChange и установите значение атрибута, как показано на экране ниже.

    

    Примечание.

    Чтобы использовать это действие, выберите и назначьте соответствующие поля из раскрывающегося списка и назначьте значения. Для многозначных атрибутов поместите несколько действий CreateValueChangeActivity внутрь действия CreateAttributeChangeActivity.

12. Чтобы добавить условия для атрибута, добавьте действие If, как показано на следующем рисунке:

    

13. Наконец, добавьте действие Назначить и задайте выражение, как показано на следующем рисунке:

    

14. Сохраните этот проект в расположении %FIM_INSTALL_FOLDER%\Synchronization Service\Extensions.

    Проекты по умолчанию следует скачать и сохранить в расположении %FIM_INSTALL_DIR\2010\Synchronization Service\Extensions в целевой системе. Затем проекты отображаются в мастере настройки соединителя веб-службы.

    При запуске исполняемого файла вам будет предложено указать расположение для установки. Введите расположение сохранения.

    Это важно

    Файл проекта можно сохранить и открыть из любого расположения (с соответствующими привилегиями доступа исполнителя). В мастере соединителя веб-службы, доступ к которому осуществляется через пользовательский интерфейс синхронизации MIM, можно выбрать только файлы проекта, сохраненные в папке Synchronization Service\Extension.

    Пользователю, выполняющему средство настройки веб-службы, требуются следующие привилегии:

    • Полный доступ к папке расширения службы синхронизации.
    • Доступ на чтение к разделу реестра HKLM\System\CurrentControlSet\Services\FIMSynchronizationService\Parameters, через который определяется путь к папке с расширением.

Настройка рабочих процессов экспорта в средстве настройки веб-службы

В следующих разделах показано, как экспортировать рабочие процессы с помощью средства настройки веб-службы.

Добавление рабочих процессов

1. Выберите рабочий процесс экспорта для настройки. В разделе Экспортвыберите Добавить. Аргументы и Импорты уже определены и специфичны для конкретных действий. Просмотрите следующие экраны для справки.

   

2. Добавьте действие Последовательность. Перетащите конструктор действий последовательности из панели элементов и перетащите его в область конструктора рабочих процессов Windows. Действие Последовательности содержит упорядоченную коллекцию дочерних действий, которые выполняются по порядку. Выберите Создать переменную. Назначьте значения переменным, которые вы собираетесь использовать для логики.

   

   Примечание.

   Действия по добавлению переменной описаны в разделе, посвященном созданию полного рабочего процесса импорта.

3. Перетащите действие ForEach в действие Sequence, которое уже добавлено, чтобы перебирать значения атрибутов привязки.

4. Выберите Свойства и задайте Значения в соответствии с изображением ниже. Здесь objectToExport аргумент.

   

5. Установите DisplayName как ForEach<AnchorAttribute>

   

6. Задайте TypeArgument как Microsoft.MetadirectoryServices.AnchorAttribute.

   

7. Добавьте действие Switch в теле ForEachAnchorAttribute.

   

8. Добавьте выражение, как показано на следующем экране.

   

9. Выберите Добавить новый вариант и введите значение EmployeeId. Перетащите действие последовательности и добавьте в нее действие Назначить .

   

10. Назначьте свойства To и Value для действия Назначить.

    

11. Действие ForEach используется для значений привязки. Добавьте еще одно действие ForEach, чтобы назначить значения, которые не являются привязками. В этом примере используется привязка AttributeChange.

    

12. Добавьте действие Switch в теле ForEach привязки AttributeChange anchor.

    

13. Добавьте выражение, как показано на следующем экране.

    

14. Выберите Добавить новый случай и введите значение для FirstName. Перетащите действие последовательности и добавьте в нее действие Назначить . Назначьте свойства To и Value для действия Назначить.

    

15. Добавьте значения для обязательных атрибутов, таких как LastName, emailи т. д.

    

16. В разделе Common перетащите WebServiceCallActivity и задайте значения для аргументов.

    

    Это важно

    Не изменяйте Имя, Направлениеили Тип для аргумента с помощью этого диалогового окна. Если любое из этих значений изменено, действие становится недействительным. Задайте только значение аргумента. Как показано на этом рисунке, задано значение wsResponse.

17. Наконец, добавьте активность If для проверки ответов, которые возвращаются из операции веб-службы.

Создание рабочего процесса экспорта с помощью операции добавления завершено:

Сохраните этот проект в расположении %FIM_INSTALL_FOLDER%\Synchronization Service\Extensions.

Удаление рабочих процессов

Удалите рабочие процессы экспорта, выполнив следующие действия в средстве настройки веб-службы.

1. Выберите рабочий процесс экспорта для настройки. В разделе Экспортвыберите Удалить. Аргументы и Импорты уже определены и специфичны для конкретных действий. Просмотрите следующие экраны для справки.

   

2. Добавьте активность Sequence. Выберите Создать переменную. Назначьте значения переменным, которые будут использоваться для логики.

   

   Примечание.

   Действия по добавлению переменной описаны в разделе, посвященном созданию полного рабочего процесса импорта.

3. Перетащите действие ForEach в уже добавленную активность Sequence, чтобы выполнить итерацию значений атрибутов привязки.

4. Выберите свойства и установите значения , как показано на экране ниже. Здесь objectToExport аргумент.

   

5. Установите отображаемое имя в виде ForEach\<AnchorAttribute\>:

   

6. Задайте typeArgument как Microsoft.MetadirectoryServices.AnchorAttribute:

   

7. Добавьте действие Switch в теле ForEachAnchorAttribute.

   

8. Добавьте выражение, как показано на следующем экране.

   

9. Выберите Добавить новый вариант и введите значение EmployeeId. Перетащите действие последовательности и добавьте в нее действие Назначить .

   

10. Назначьте свойства To и Value для действия Назначить.

    

11. В разделе Common перетащите WebServiceCallActivity и задайте значения для аргументов.

    

    Это важно

    Не изменяйте Имя, Направлениеили Тип для аргумента с помощью этого диалогового окна. Если любое из этих значений изменено, действие становится недействительным. Задайте только значение аргумента. Как показано на этом рисунке, задано значение employeeID.

12. Наконец, добавьте , если выполняется условие, чтобы проверить ответы, возвращенные операцией веб-службы.

Удаление рабочего процесса экспорта с помощью операции Удалить завершено:

Сохраните этот проект в расположении %FIM_INSTALL_FOLDER%\Synchronization Service\Extensions.

Замена рабочих процессов

Замените рабочие процессы экспорта, выполнив следующие действия в средстве настройки веб-службы.

1. Выберите рабочий процесс экспорта для настройки. В разделе Экспортвыберите Заменить. Аргументы и Импорты уже определены и специфичны для конкретных действий. См. экран ниже для справки.

   

2. Добавьте действие Последовательности.

3. Перетащите действие ForEach для <AnchorAttribute>.

4. Добавьте еще одно действие ForEach<AttributeChange>, чтобы назначить значения без привязки.

5. Наконец, экран выглядит следующим образом. Инструкции по конфигурации этой активности приведены в разделе, посвящённом настройке экспортных рабочих процессов.

   

6. В разделе Common перетащите WebServiceCallActivity и задайте значения для аргументов.

   

   Это важно

   Не изменяйте Имя, Направлениеили Тип для аргумента с помощью этого диалогового окна. Если любое из этих значений изменено, действие становится недействительным. Задайте только значение аргумента. Как показано на этом рисунке, значение установлено для сотрудника.

7. Наконец, добавьте действие If, чтобы проверить ответы, возвращаемые из операции веб-службы.

Замена рабочего процесса экспорта операцией Замена завершена:

Сохраните этот проект в расположении %FIM_INSTALL_FOLDER%\Synchronization Service\Extensions.

Отладка активностей

Следующие пользовательские действия доступны для отладки шаблона рабочего процесса.

Запись активности

Действие журнала используется для записи текстовых сообщений в файл журнала. Более подробную информацию см. в разделе Ведение журналов.

Чтобы использовать активность журнала, задайте следующие свойства. Свойства видны, когда вы выбираете действие в Дизайнере рабочих процессов и просматриваете свойства для этого действия.

Действие «WriteLine»

Действие WriteLine используется для записи текстовых сообщений в текстовый редактор поставщика. Если модуль записи недоступен, действие WriteLine записывает текст в окно консоли.

В текстовом поле напишите сообщение, которое нужно увидеть в целевом объекте записи.

Чтобы использовать действие WriteLine, задайте следующие свойства. Свойства видны, когда вы выбираете действие в Дизайнере рабочих процессов и просматриваете свойства для этого действия.

• Уровень журнала : определяет объем содержимого для записи в журнал. Возможные значения:

  • Высокая серьезность: запишите сообщение LogText в файл журнала, если серьезность журнала установлена на высокий уровень.
  • Подробные сведения: напишите сообщение LogText в файл журнала, если для серьезности журнала задано значение Verbose.
  • Отключен: не записывайте в файл журнала.

• LogText: указывает текстовое содержимое для записи в журнале.

• тег: добавляет тег в текст, чтобы определить тип содержимого, записываемого в журнал. Возможные значения: Error, Trace или Warning.

Дальнейшие действия

• Обзор универсального коннектора веб-службы
• установить средство настройки веб-службы
• руководство по развертыванию SOAP
• руководство по развертыванию REST
• конфигурация веб-службы MA