Вставка ссылки в текст оповещения

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

При использовании конструкций, преображающихся в ссылки, в поле "Текст оповещения" необходимо переключиться в режим "html source", нажав на ссылку "html" в правом углу редактора.

Возможные действия по ссылке в оповещении

• Открытие карточки объекта, формы добавления или формы редактирования.

  Методы api.web, см. api.web Формирование ссылок, ведущих в заданное место в интерфейсе.

  Пример. Ссылка для перехода на форму редактирования объекта с ключом авторизации:

  ${api.web.asLink(api.web.edit(subject, api.auth.getAccessKey('username')), 'Форма редактирования объекта')}

• Добавление, редактирование, удаление объектов без перехода в интерфейс системы.

  Методы api.rest, см. api.rest Формирование ссылок для выполнения действий без перехода в интерфейс системы.

  Пример. Ссылка для редактирования названия объекта (title) с ключом авторизации:

  <a href="${api.rest.edit(subject, ['title' : 'new title'], api.auth.getAccessKey('username'))}">Переименовать в 'new title'</a>

• Добавление, редактирование, удаление объектов с последующей переадресацией пользователя по заданному URL и открытием диалогового окна

  • Скриптовый модуль restModule. Ссылки с переадресацией
  • api.auth Работа с ключами авторизации

Вход в систему при переходе по ссылке

Вход в систему при выполнении действия по ссылке осуществляется с помощью: ключа авторизации; логина и пароля или механизма прозрачной аутентификации.

Для выполнения действия по ссылке может генерироваться ключ авторизации, под которым будет выполняться операция. Методы формирования ключа авторизации см. api.auth Работа с ключами авторизации.

Особенности работы ключа авторизации для оповещений:

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

• Чтобы каждому сотруднику отправить индивидуальное письмо и сгенерировать индивидуальный ключ, вместо "username" следует использовать конструкцию "currentRecipient.login", которая возвращает логин каждого сотрудника-получателя письма, см. Переменная "currentRecipient"

  api.auth.getAccessKey (currentRecipient.login).

  При формировании ссылки для перехода на карточку объекта проверяется заполнение переменной currentRecipient. Если переменная заполнена, будет сформирована ссылка, содержащая ключ авторизации, иначе — ссылка без ключа авторизации.:

  <a href="${!currentRecipient ? api.web.open(subject) : api.web.open(subject, currentRecipient.login)}">Карточка объекта</a>

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

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

  Настройка выполняется в конфигурационном файле dbaccess.properties (Аутентификация и авторизация).