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

  • Статья

API рабочих процессов жизненного цикла в Microsoft Graph позволяет автоматизировать базовые процессы жизненного цикла для пользователей на трех уровнях: Joiner, Leaver и Mover. Основными для рабочих процессов являются задачи, представляющие конкретные действия, которые выполняются автоматически при активации рабочего процесса.

Microsoft Graph поддерживает 16 встроенных задач , которые можно использовать для создания пользовательских рабочих процессов. Каждая задача имеет набор аргументов, допустимых для этой задачи. Например, задача создания временного прохода доступа (TAP) для пользователя позволяет настроить время существования TAP и возможность его повторного использования. Задача добавления пользователя в группу требует указания групп, в которые вы хотите добавить пользователя. Эта конфигурация выполняется на основе свойства arguments задачи и основана на типе ресурса keyValuePair.

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

Настройка аргументов для задач

Описание задачи taskDefinitionId Аргументы
Отправить приветственное письмо новому сотруднику 70b29d51-b59a-4773-9280-8841dfd3f2ea Имя: cc
value: допустимый идентификатор пользователя (строка) для пользователя, который вы хотите получить в сообщении электронной почты.

Имя: customSubject
value: настраиваемый заголовок темы для отправляемого сообщения электронной почты.


Имя: customBody
value: текст настраиваемого сообщения электронной почты.


Имя: locale
value: значение языка, которое переопределяет языковые параметры получателя электронной почты. Не настраивает пользовательский текст сообщения электронной почты и должен быть задан на том же языке, что и пользовательский текст.
Создание временного пропуска доступа и отправка по электронной почте руководителю пользователя 1b555e50-7f65-41d5-b514-5894a026d10d Имя: tapLifetimeMinutes
value: 10 upto 43000

Имя: tapIsUsableOnce
value: true или false

Предварительные требования:
  1. Пользователю должен быть назначен руководитель.
  2. У руководителя пользователя должна быть включена почта.
  3. Политика временного доступа (TAP) должна быть включена в клиенте, и пользователь должен использовать метод проверки подлинности TAP. Дополнительные сведения см. в разделе Тип ресурса temporaryAccessPassAuthenticationMethodConfiguration.
Добавление пользователя в группы 22085229-5809-45e8-97fd-270d28d66910 Имя: groupID
value: допустимый идентификатор группы или разделенный запятыми список групп, в которые будет добавлен пользователь в качестве участника. Пример: "06269010-2d8e-48e4-8f0e-33580720c9e1, 06bba22c-775e-42d8-b451-4221af061af0, 182f68db-6513-4e79-9ec2-a7e89a460e7f"
Добавление пользователя в teams e440ed8d-25a1-4618-84ce-091ed5be5594 Имя: teamID
value: допустимый идентификатор группы или разделенный запятыми список команд, в которые будет добавлен пользователь в качестве участника. Пример: "06269010-2d8e-48e4-8f0e-33580720c9e1, 06bba22c-775e-42d8-b451-4221af061af0, 182f68db-6513-4e79-9ec2-a7e89a460e7f"
Включение учетной записи пользователя 6fc52c9d-398b-4305-9763-15f42c1676fc Нет
Запуск пользовательского расширения задач 4262b724-8dba-4fad-afc3-43fcbb497a0e Имя: CustomTaskExtensionID
value: идентификатор расширения настраиваемой задачи.
Отключение учетной записи пользователя 1dfdfcc7-52fa-4c2e-bf3a-e3919cc12950 Нет
Удаление пользователя из выбранной группы 1953a66c-751c-45e5-8bfe-01462c70da3c Имя: groupID
value: допустимый идентификатор группы или разделенный запятыми список групп, в которые входит пользователь. Пример: "06269010-2d8e-48e4-8f0e-33580720c9e1, 06bba22c-775e-42d8-b451-4221af061af0, 182f68db-6513-4e79-9ec2-a7e89a460e7f"
Удаление пользователей из всех групп b3a31406-2a15-4c9a-b25b-a658fa5f07fc Нет
Удаление пользователя из teams 06aa7acb-01af-4824-8899-b14e5ed788d6 Имя: teamID
value: разделенный запятыми список команд, в которые входит пользователь. Пример: "06269010-2d8e-48e4-8f0e-33580720c9e1, 06bba22c-775e-42d8-b451-4221af061af0, 182f68db-6513-4e79-9ec2-a7e89a460e7f"
Удаление пользователя из всех команд 81f7b200-2816-4b3b-8c5d-dc556f07b024 Нет
Удаление всех назначений лицензий от пользователя 8fa97d28-3e52-4985-b3a9-a1126f9b8b4e Нет
Удаление пользователя 8d18588d-9ad3-4c0f-99d0-ec215f0e3dff Нет
Отправка электронной почты руководителю до последнего дня пользователя 52853a3e-f4e5-4eb8-bb24-1ac09a1da935 Имя: cc
value: допустимый идентификатор пользователя (строка) для пользователя, который вы хотите получить в сообщении электронной почты.

Имя: customSubject
value: настраиваемый заголовок темы для отправляемого сообщения электронной почты.


Имя: customBody
value: текст настраиваемого сообщения электронной почты.


Имя: locale
value: значение языка, которое переопределяет языковые параметры получателя электронной почты. Не настраивает пользовательский текст сообщения электронной почты и должен быть задан на том же языке, что и пользовательский текст.
Отправка электронной почты пользователям в последний день 9c0a1eaf-5bda-4392-9d9e-6e155bb57411 Имя: cc
value: допустимый идентификатор пользователя (строка) для пользователя, который вы хотите получить в сообщении электронной почты.

Имя: customSubject
value: настраиваемая тема для отправляемого сообщения электронной почты.


Имя: customBody
value: текст настраиваемого сообщения электронной почты.


Имя: locale
value: значение языка, которое переопределяет языковые параметры получателя электронной почты. Не настраивает пользовательский текст сообщения электронной почты и должен быть задан на том же языке, что и пользовательский текст.
Отправка электронного сообщения о подключении диспетчеру пользователей после последнего дня 6f22ddd4-b3a5-47a4-a846-0d7c201a49ce Имя: cc
value: допустимый идентификатор пользователя (строка) для пользователя, который вы хотите получить в сообщении электронной почты.

Имя: customSubject
value: настраиваемый заголовок темы для отправляемого сообщения электронной почты.


Имя: customBody
value: текст настраиваемого сообщения электронной почты.


Имя: locale
value: значение языка, которое переопределяет языковые параметры получателя электронной почты. Не настраивает пользовательский текст сообщения электронной почты и должен быть задан на том же языке, что и пользовательский текст.

Примеры

Пример 1. Настройка задачи для отправки электронного сообщения об отключении диспетчеру пользователя после последнего рабочего дня пользователя

В следующих примерах показана конфигурация задачи для отправки электронного сообщения об отключении диспетчеру пользователя после последнего рабочего дня пользователя. Эта задача идентифицируется с помощью taskDefinitionId6f22ddd4-b3a5-47a4-a846-0d7c201a49ce.

{
    "category": "leaver",
    "continueOnError": true,
    "displayName": "Send offboarding email to user's manager after the last day of work",
    "description": "Send email after user’s last day",
    "isEnabled": true,
    "continueOnError": true,
    "taskDefinitionId": "6f22ddd4-b3a5-47a4-a846-0d7c201a49ce",
    "arguments": []
}

Пример 2. Настройка задачи для добавления пользователя в команды

В следующих примерах показана конфигурация задачи для добавления пользователя в команду Teams. Эта задача идентифицируется с помощью taskDefinitionIde440ed8d-25a1-4618-84ce-091ed5be5594.

{
    "category": "leaver",
    "description": "Add user to university alumni team",
    "displayName": "AddUserToUniAlumniTeam",
    "isEnabled": true,
    "continueOnError": true,
    "taskDefinitionId": "e440ed8d-25a1-4618-84ce-091ed5be5594",
    "arguments": [
        {
            "name": "teamID",
            "value": "e3cc382a-c4b6-4a8c-b26d-a9a3855421bd"
        }
    ]
}

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