Шаг Отправить email отправляет уведомление по электронной почте одному или нескольким получателям при выполнении этого шага. Этот тип шага можно использовать для отправки уведомлений о завершении шага или задания или о неудачном завершении шага.
Вы можете дополнительно настроить параметры уведомлений по электронной почте для ArcGIS Workflow Manager перед отправкой уведомлений в шаге Отправить email. Настройки пользовательского SMTP-сервера позволяют включать вложения и использовать адреса электронной почты вместо имен пользователей или ID группы, а также включать текстовые поля Копия и Скрытая копия.
Примечание:
Возможно, вам придется изменить пользовательские роли, чтобы получить адреса электронной почты участников организации с помощью выражения ArcGIS Arcade.
Настройка шага
Для настройки шага выполните следующее:
- Создайте или отредактируйте схему рабочего процесса, чтобы получить доступ к панели Библиотека шагов.
- Перетащите Отправить email из панели Библиотека шагов на стрелку соединения шага на холсте рабочего процесса.
Появится панель Подробная информация о шаге.
- Укажите имя шага в текстовом окне Имя шага.
- Дополнительно щелкните переключатель Включить пользовательский сервер SMTP для использования вашего SMTP-сервера для отправки сообщений.
- Если у вас нет собственного SMTP-сервера, выберите один из следующих вариантов Тип получателя и укажите получателей в текстовом поле Кому:
- Имена пользователей — Укажите список имен пользователей, разделенных точкой с запятой, или используйте выражение Arcade для создания динамического списка получателей. Выражения Arcade должны быть заключены в двойные кавычки.
- ID группы — Укажите один идентификатор группы или используйте выражение Arcade для получения идентификатора группы. Выражения Arcade должны быть заключены в двойные кавычки.
В текстовом поле Кому должно быть указано хотя бы одно допустимое имя пользователя, идентификатор группы или выражение Arcade.
Внимание:
Если у вас нет собственного SMTP-сервера, можно задавать не более 50 получателей. Выражения Arcade могут привести к тому, что список получателей превысит максимальный размер.
Одно имя пользователя
JDoe
Один ID группы
7dr6de56442840ccbf49b3f869f49b27
Несколько имен пользователей
JDoe;KSmith;MFields
Одно выражение Arcade
"GetUser($CurrentPortal, jobOwner($job))['username']"
Несколько выражений Arcade
"GetUser($CurrentPortal, jobOwner($job))['username']";"jobCreator($job)";"lastRunner($job, '8b107614-c6dc-20b3-c232-e03bf7c007bc')"
Имена пользователей и выражения Arcade
JDoe;"GetUser($CurrentPortal, jobOwner($job))['username']";KSmith;"lastRunner($job, '8b107614-c6dc-20b3-c232-e03bf7c007bc')"
Подсказка:
Нажмите Этот входной параметр поддерживает выражения Arcade
и выберите выражение ArcGIS Arcade, чтобы добавить его в соответствующее текстовое поле. - Если у вас есть собственный SMTP-сервер, введите адреса электронной почты, разделенные точкой с запятой, в текстовые поля Кому, Копия и Скрытая копия по мере необходимости или используйте выражение ArcGIS Arcade для создания динамического списка получателей. Выражения Arcade должны быть заключены в двойные кавычки.
В текстовом поле Кому, Копия или Скрытая копия должен быть указан хотя бы один действительный адрес электронной почты или выражение Arcade.
Один адрес электронной почты
user1@test.com
Несколько адресов электронной почты
user1@test.com;user2@test.com;user3@test.com;user4@test.com
Одно выражение Arcade
"GetUser($CurrentPortal, JobOwner($Job))['Email']"
Несколько выражений Arcade
"GetUser($CurrentPortal, JobOwner($Job))['Email']";"GetUser($CurrentPortal)['Email']";"GetUser($CurrentPortal, LastRunner($Job, 'f50d740d-cc04-9296-4ce3-181e82604465'))['Email']"
Адреса электронной почты и выражения Arcade
user1@test.com;"GetUser($CurrentPortal, JobOwner($Job))['Email']";user3@test.com;"GetUser($CurrentPortal)['Email']"
Подсказка:
Нажмите Этот входной параметр поддерживает выражения Arcade
и выберите выражение ArcGIS Arcade, чтобы добавить его в соответствующее текстовое поле. - Укажите тему для уведомления по электронной почте в текстовом поле Тема.
Необходимо ввести тему. Текстовое окно Тема не может быть пустым.
Вы также можете использовать выражения Arcade для предоставления динамического значения темы. Если тема содержит обычный текст и выражения Arcade, отформатируйте текст следующим образом:
JobName($Job) + 'is ready' - Укажите текст сообщения для уведомления по электронной почте в текстовом окне Сообщение.
Вы должны указать сообщение в теле письма. Текстовое окно Сообщение не может быть пустым.
Вы также можете использовать выражения Arcade для предоставления динамического значения тела письма.
Если тело письма содержит обычный текст и выражения Arcade, отформатируйте текст следующим образом:
'<b>' + JobName($Job) + '</b>, created by <b>' + JobCreator($Job) + '</b>, was started on <b>' + Text(Date(JobStartDate($Job)), 'dddd, MMMM D, Y') + '</b>.'Внимание:
Если у вас нет пользовательского SMTP-сервера, размер текста письма ограничен 100 КБ. Выражения Arcade могут привести к тому, что тело письма превысит максимальный размер.
- Если у вас есть пользовательский SMTP-сервер, то в почтовое уведомление можно включить вложения, используя следующие опции раздела Включить вложения:
- Нет — Не включать вложения задания в уведомления по электронной почте.
- Все — Включить все папки вложений задания в уведомление по электронной почте.
- По папке — Введите список имен папок вложений задания, разделенных запятой, в текстовом поле По папке, чтобы указать папки вложений задания, которые следует включить в уведомление по электронной почте.
Примечание:
Папки вложения задания содержатся в элементе рабочего процесса и не являются путями файловой системы.
Примечание:
Если задание содержит несколько вложений, они отправляются в виде отдельного файла .zip, при этом структура вложенных папок сохраняется.
- Дополнительно, щелкните Просмотреть email, чтобы просмотреть электронное письмо.
Примечание:
Если электронное письмо содержит выражение Arcade, относящееся к заданию, вы должны указать действительный идентификатор задания в текстовом поле Просмотреть Email, прежде чем вы сможете просмотреть выражение Arcade. Если электронное письмо содержит выражение Arcade для выходного значения шага, шаг должен быть завершен, прежде чем вы сможете просмотреть выходное значение.
Появится окно Просмотреть Email со списком получателей и предварительным просмотром темы и тела письма.
- Перейдите на вкладку Опции.
- При необходимости настройте Опции шага.
- Вручную - запустить шаг вручную.
- Дополнительно - позволяет завершить шаг без запуска.
- Автоматически - Запускает шаг, как только он становится активным.
Примечание:
Если для схемы рабочего процесса настроен автоматический запуск последовательности шагов, включая шаг Запустить сервис GP, то после истечения срока действия токена пользователя запускаемые шаги не будут выполняться автоматически. Для выполнения дополнительных автоматизированных шагов без ручного вмешательства требуется Дополнительный модуль организации ArcGIS Workflow Manager Advanced.
- Запуск по расписанию - запуск шага по заданному расписанию.
- Вручную - запустить шаг вручную.
- При желании выберите один из следующих вариантов настройки справки на этом шаге:
- Нет - настройте шаг без пошаговой справки.
- Текст - настройте текст справки для шага в текстовом поле Текст.
Вы можете использовать выражения ArcGIS Arcade для предоставления динамического значения справки по шагу. Если справка по шагу содержит обычный текст и выражения Arcade, выполните форматирование текста следующим образом:
'For further assistance, please contact' + JobCreator($Job) + '.' - URL - настройте шаг, указав ссылку на справочный ресурс в текстовом поле URL.
Примечание:
Шаги, выполняемые в веб-приложении, поддерживают только форматы HTTP и HTTPS URL. Шаги, выполняемые в ArcGIS Pro, поддерживают HTTP, HTTPS и форматы файлов.
Вы также можете использовать выражения Arcade для предоставления динамического значения. Если URL-адрес содержит обычный текст и выражения Arcade, выполните форматирование текста следующим образом:
'https://pro.arcgis.com/en/pro-app/latest/tool-reference/' + JobExtendedProperty($Job, 'tools', 'toolbox') + '/' + jobExtendedProperty($job, 'tools', 'alias') + '.htm'Выполните следующие настройки для опции Автоматически кодировать результат Arcade:
- Если выражение Arcade возвращает специальные символы, которых нужно избегать при конвертировании в URL, например, пробел или прямой слэш, убедитесь, что опция Автоматически кодировать результат Arcade включена.
- Если для формирования базового URL-адреса используется выражение Arcade, отключите опцию Автоматически кодировать результат Arcade.
- Дополнительно, щелкните вкладку Стиль, чтобы изменить форму и цвет шага.
- Дополнительно, щелкните вкладку Описание и введите описание шага в текстовом поле Описание шага.
Подсказка:
Вкладка Описание также содержит идентификатор шага, который можно использовать с динамическими свойствами задания для получения выходных данных шага. Щелкните Копировать ID шага
, чтобы скопировать идентификатор шага в буфер обмена.
Возвращаемое значение
Когда шаг завершен, его возвращаемое значение сохраняется, чтобы указать результат шага. Возвращаемое значение может быть немедленно оценено с использованием путей для определения следующих шагов рабочего процесса. Вы также можете получить возвращаемое значение для завершенных шагов рабочего процесса с помощью выражений ArcGIS Arcade. В следующей таблице перечислены возвращаемые значения шага:
| Возвращаемое значение | Описание |
|---|---|
| S000001 | Шаг завершен успешно. |
F000001 | Шаг не удалось завершить успешно. |