Руководство по рабочему процессу соединителя веб-служб для 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.

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

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

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

   

   

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

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

   

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 в уже добавленном действии последовательности для итерации значений атрибутов привязки.

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

   

5. Задайте DisplayNameForEach<AnchorAttribute>

   

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

   

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

   

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

   

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

   

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

    

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

    

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

    

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

    

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

    

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

    

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

    

    Это важно

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

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

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

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

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

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

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

   

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

   

   Примечание.

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

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

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

   

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

   

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

   

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

   

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

   

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

   

10. Назначьте свойства и 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