В Notes можно автоматизировать выполнение задач при помощи макросов, называемых агентами. Они позволяют автоматически выполнять повторяющиеся задачи, такие как упорядочение документов и отправка записок. (Средство отправки сообщений при отсутствии на работе является примером агента, который можно использовать в Notes.)
В данной справочной системе описывается создание только простых агентов. Сведения по созданию более сложных агентов с помощью формул Notes, LotusScript или Java см. в справочной базе данных Lotus Domino Designer 6.
Задачи, выполняемые агентами
С помощью агентов могут выполняться почти все действия, выполняемые в базах данных вручную. Удобно использовать агенты для автоматического выполнения следующих задач:
создание ответов на сообщения;
пересылка почты;
отправка документов;
копирование документов из одной базы данных или папки в другую;
удаление документов;
изменение состояния прочтения.
С помощью параметров поиска могут создаваться простые агенты, работающие с конкретными документами базы данных.
Описание работы агента
Агенты хранятся в базах данных. Агенты, которые могут запускаться только создавшим их пользователем, называются личными агентами; агенты, которые могут запускаться другими пользователями, называются общими.
При создании агента могут указываться следующие параметры.
Режим работы агента. Агент может запускаться вручную, автоматически по расписанию или автоматически при регистрации определенного события, например получения новой почты или изменения документа.
Документы базы данных, которые обрабатывает агент. Агент может обрабатывать все документы или любые наборы документов базы данных.
Действия, выполняемые агентом. Для создания агентов можно выбирать действия из списка или описывать их с помощью формул Notes, сценариев и языков программирования.
Таблицы управления доступом и агенты
Можно создать и запустить агент в любой локальной базе данных, однако чтобы создать агенты для запуска в базе данных на сервере Domino, необходимо иметь соответствующие права доступа. В таблице управления доступом базы данных определено, может ли пользователь создать агент в базе данных, какие действия выполняет агент и как он взаимодействует с другими агентами.
Создание агента
Можно создать простой агент в базе данных, что поможет автоматизировать задачи.
Чтобы создать агент, сначала откройте базу данных и выберите команду: Создание - Агент. Появятся окно свойств агента и область программирования.
В окне свойств агента
Откройте вкладку "Основные".
Введите имя агента в поле "Имя".
(Необязательно.) Введите комментарий в поле "Заметки". Комментарий отобразится в списке агентов.
Установите переключатель в положение "Общий", если этот агент будет запускаться другими пользователями. Установите переключатель в положение "Личный", если этот агент будет запускаться только создавшим его пользователем.Можно преобразовать личный агент в общий агент и наоборот.
Если агент выполняет поиск текста в документах, в группе "Параметры" можно задать следующие параметры.Установите флажок "Хранить условия поиска в меню строки поиска", чтобы отобразить запрос поиска на панели поиска.
Установите флажок "Сохранять выделение в документах", чтобы выделять результаты поиска в документах.
(Необязательно.) Чтобы запускать агенты, не появляющиеся в интерфейсе пользователя, установите флажок "Запускать в фоновом потоке клиента".
В группе "Запуск" в окне свойств выберите один из следующих триггеров для агента. В зависимости от выбранного триггера отображаются различные параметры.Установите переключатель в положение "Событие", а затем выберите событие, запускающее агент.
Установите переключатель в положение "Расписание", а затем определите время запуска агента.
Примечание В зависимости от выбранного типа триггера в поле "Объект", возможно, потребуется выбрать документы, в которых будет запускаться агент.
Откройте вкладку "Безопасность" окна свойств агента, чтобы задать параметры безопасности для агента.
Заполнив нужные поля, закройте окно свойств агента.
В области программирования
Нажмите кнопку "Добавить действие", чтобы открыть диалоговое окно "Добавление действия", и укажите простые действия, которые должны выполняться агентом. (Выбирайте действия в том порядке, в котором они должны впоследствии выполняться.)
Если необходимо, чтобы агент выполнял поиск документов, откройте вкладку "Объекты", а затем выделите элемент "Выбор документов". Нажмите кнопку "Добавить условие", чтобы открыть диалоговое окно "Добавление условия", и задайте условия поиска.
Выберите команду: Файл - Сохранить, чтобы сохранить агент в базе данных.
Присваивание имен агентам
Имена запускаемых вручную агентов отображаются как команды меню "Действия". Имена агентов задаются с учетом регистра и могут представлять собой любую комбинацию знаков, включая буквы, цифры, пробелы и знаки препинания.
Советы по присваиванию имен
Для действий с формами и представлениями, отображающихся в качестве кнопок на панели действий, выбирайте короткие имена.
Команды меню "Действия" выводятся в алфавитном порядке. Чтобы имена отображались в другом порядке, присвойте им номера или буквы.
В базе данных для одинаковых агентов используйте одинаковые имена, чтобы пользователи могли их распознавать.
Способы задания имен
Псевдоним
Псевдоним представляет собой другое имя или синоним для определенного агента. При использовании псевдонима можно изменить или перевести отображаемое для пользователей имя без отключения формул, связанных с исходным именем. К псевдонимам применяются те же правила присвоения имен, как и к обычным именам. При работе с действиями с формами и представлениями псевдонимы не используются.
Чтобы создать псевдоним, добавьте вертикальную черту ( | ) и псевдоним справа от исходного имени. Исходное имя всегда должно быть расположено слева.
Агент1 | Агент1_Псевдоним
Можно создать несколько псевдонимов. Их необходимо разделять вертикальной чертой ( | ).
Сочетания клавиш
Назначенная клавиша представляет собой подчеркнутую букву в названии команды меню "Действия". Пользователи Windows и UNIX® для выбора команды меню могут ввести только назначенную букву. Чтобы задать в меню "Действия" назначенную клавишу, введите знак подчеркивания перед назначаемой буквой. Например, "С" является назначенной клавишей для действия "Сохранить".
_Сохранить
В Notes при отображении имени действия на панели действий знак подчеркивания игнорируется.
Составные имена
Если нежелательно создавать в меню длинный список команд или существует необходимость сгруппировать связанные действия или агенты, выполните группировку, чтобы при выборе команды меню отображались связанные команды подменю. Для имен можно создавать только один вложенный уровень.
Введите имя, которое должно отображаться в меню "Действия", после чего введите обратную косую черту (\), за которой следует указать имя действия или агента. Например:
Средства почты\Добавить отправителя в АК
Средства почты\Выбрать шапку
Редактирование, копирование, удаление или перемещение агента
Агенты в базе данных могут копироваться, удаляться и перемещаться. Кроме того, агенты могут копироваться и перемещаться между базами данных. Однако во время выполнения агент нельзя изменить и сохранить.
Чтобы изменить агент
Откройте список агентов и дважды щелкните агент, который необходимо изменить.
Внесите необходимые изменения в окне свойств агента или в области программирования.
Нажмите клавишу Esc.
Нажмите кнопку "Да", чтобы сохранить изменения агента.
Чтобы скопировать агент
Откройте список агентов и выделите агент.
В меню выберите команду: Правка - Копировать.
Если агент копируется в другую базу данных, откройте эту базу данных и выберите команду: Вид - Агенты.
Выберите команду: Правка - Вставить.
Агент появится в списке.
Примечание При создании копии агента в той же самой базе данных в Notes ей присваивается имя "Копия <имя агента>". При создании еще одной копии ей присваивается имя "Другая копия <имя агента>".
Чтобы удалить агент
Откройте список агентов и выделите агент.
Выберите команду: Правка - Вырезать.
Агент будет удален из списка.
Совет Чтобы немедленно переместить агент, выберите команду: Правка - Вставить.
Чтобы переместить агент из одной базы данных в другую
Откройте список агентов и выделите агент.
Выберите команду: Правка - Вырезать.
Выделите конечную базу данных и выберите команду: Вид - Агенты.
Выберите команду: Правка - Вставить.
Агент появится в списке.
Просмотр списка агентов
Список агентов содержит все агенты в базе данных.
Чтобы просмотреть список агентов
Откройте базу данных.
В меню выберите команду: Вид - Агенты.
(Необязательно.) Чтобы отображать агенты в списке в нужном порядке, щелкните заголовок столбца "Псевдоним", "Владелец", "Дата изменения" или "Автор изменений".
(Необязательно.) Дважды щелкните агент, чтобы открыть его и внести необходимые изменения.
Пример агента: создание ответов на сообщения
Была создана база данных, в которую поступают ответы сотрудников на опрос о привилегиях, предоставляемых им фирмой. Требуется автоматически отправлять благодарность всем отвечающим.
Сначала откройте базу данных и выберите команду: Создание - Агент. Появятся окно свойств агента и область программирования.
В окне свойств агента
На вкладке "Основные" в поле "Имя" введите "Отправить сообщение с благодарностью".
В группе "Запуск" установите переключатель в положение "Событие", а затем в списке выберите значение "После прихода новой почты".
Закройте окно свойств агента.
В области программирования
Откройте вкладку "Объекты" в области списка сведений, а затем в списке объектов выделите элемент "Действие".
В нижней части области программирования нажмите кнопку "Добавить действие".Появится диалоговое окно "Добавление действия".
В поле "Действие" выберите значение "Ответить отправителю".
В группе "Отправить ответ" установите переключатель в положение "отправителю".
В поле "Ответное сообщение" введите "Спасибо".
Нажмите кнопку ОК.Notes вставит в агент действие и закроет диалоговое окно "Добавление действия".
Выберите команду: Файл - Сохранить, чтобы сохранить агент в базе данных.
Пример агента: пересылка почтовых сообщений
Предположим, требуется ежедневно автоматически рассылать расписания отгрузки, полученные от управляющего, Петра Иванова, всем остальным членам вашей группы.
Сначала откройте почтовую базу данных и выберите команду: Создание - Агент. Появятся окно свойств агента и область программирования.
В окне свойств агента
На вкладке "Основные" в поле "Имя" введите "Расписание пересылки".
В группе "Запуск" установите переключатель в положение "Расписание", а затем в списке выберите значение "Ежедневно".
Нажмите кнопку "Расписание". Откроется окно расписания агента.
Введите время в поле "Начать выполнение агента", а затем нажмите кнопку ОК. Диалоговое окно расписания агента закроется.
В поле "Объект" выберите значение "Все новые и измененные документы".
Закройте окно свойств агента.
В области программирования
Откройте вкладку "Объекты" в области списка сведений, а затем выделите элемент "Выбор документов" в списке объектов.
В нижней части области программирования нажмите кнопку "Добавить условие". Появится диалоговое окно "Добавление условия".
Укажите условие "Несколько слов".
Введите слово "расписание" в первое поле.
Нажмите кнопку "Добавить".Условие будет добавлено в агент, а диалоговое окно "Добавление условия" закроется.
Нажмите кнопку "Добавить условие".
Укажите условие "По автору".
В группе "Найти документы, у которых автор" выберите значение "любой из".
В поле имени введите: Петр Иванов.Примечание Имена при вводе следует разделять запятыми. Введите иерархическое имя пользователя (например, Maria Bolohova/Development/Acme), если оно известно. Если написание имени пользователя неизвестно, нажмите кнопку пользователя, чтобы найти имена в общей адресной книге.
Нажмите кнопку "Добавить".Условие будет добавлено в агент, а диалоговое окно "Добавление условия" закроется.
Откройте вкладку "Объекты" в списке сведений, а затем в списке объектов выделите элемент "Действие".
В нижней части области программирования нажмите кнопку "Добавить действие".Появится диалоговое окно "Добавление действия".
В поле "Действие" выберите значение "Отправить сообщение".
Введите имена получателей в поле "Кому".
В поле "Тема" введите "Последнее расписание отгрузки".
Установите флажок "Включить в это сообщение копию документа".
Нажмите кнопку "Добавить".Notes вставит в агент действие и закроет диалоговое окно "Добавление действия".
Выберите команду: Файл - Сохранить, чтобы сохранить агент в базе данных.
Пример агента: отправка документов
Требуется отправлять еженедельный отчет о проделанной работе сотрудникам, работающим над тем же проектом. (Во всех отправляемых документах должно быть поле "Кому".)
Сначала откройте базу данных, в которой имеется документ для отправления, а затем выберите команду: Создание - Агент. Появятся окно свойств агента и область программирования.
В окне свойств агента
На вкладке "Основные" в поле "Имя" введите "Еженедельный отчет".
В группе "Запуск" установите переключатель в положение "Расписание", а затем в списке выберите значение "Еженедельно".
Нажмите кнопку "Расписание".Откроется окно расписания агента.
Укажите дату в поле "Число" и время в поле "Время", а затем нажмите кнопку OK.Диалоговое окно расписания агента закроется.
В поле "Объект" выберите значение "Все новые и измененные документы".
Закройте окно свойств агента.
В области программирования
Откройте вкладку "Объекты" в области списка сведений, а затем выделите элемент "Выбор документов" в списке объектов.
В нижней части области программирования нажмите кнопку "Добавить условие".Появится диалоговое окно "Добавление условия".
Укажите условие "Несколько слов".
Введите "Еженедельный отчет" в первое поле.
Нажмите кнопку "Добавить".Условие будет добавлено в агент, а диалоговое окно "Добавление условия" закроется.
Откройте вкладку "Объекты" в списке сведений, а затем в списке объектов выделите элемент "Действие".
Нажмите кнопку "Добавить действие".Появится диалоговое окно "Добавление действия".
В поле "Действие" выберите значение "Отправить документ".
Нажмите кнопку "Добавить".Notes вставит в агент действие и закроет диалоговое окно "Добавление действия".
Выберите команду: Файл - Сохранить, чтобы сохранить агент в базе данных.
Примечание
Если в документе также имеются значения в полях "Копия" и "СК", он также отправляется этим лицам.
Если в документе имеются поля "Приоритет доставки", "Отчет о доставке" и "Вернуть уведомление", они используются для определения приоритета доставки, а также для создания отчетов и отправки уведомлений. Если же в документе нет этих полей, по умолчанию используется обычный приоритет, отчет о доставке не создается, а уведомление не отправляется.
Пример агента: изменение состояния документа
Предположим, Петр Иванов работал над черновиками документов в Notes и теперь требуется изменить их состояние на "Непрочтенные", чтобы упростить их поиск до завершения работы над ними. Этот агент изменяет состояние черновиков на "Непрочтенные" в конце каждого дня.
Сначала откройте почтовую базу данных и выберите команду: Создание - Агент. Появятся окно свойств агента и область программирования.
В окне свойств агента
На вкладке "Основные" в поле "Имя" введите значение "Черновики - изменение состояния".
В группе "Запуск" установите переключатель в положение "Расписание", а затем в списке выберите значение "Ежедневно".
Нажмите кнопку "Расписание".Откроется окно расписания агента.
Введите "17:00" в поле "Начать выполнение агента", а затем нажмите кнопку ОК.Диалоговое окно расписания агента закроется.
В поле "Объект" выберите значение "Все новые и измененные документы".
Закройте окно свойств агента.
В области программирования
Откройте вкладку "Объекты" в области списка сведений, а затем выделите элемент "Выбор документов" в списке объектов.
Нажмите кнопку "Добавить условие".Появится диалоговое окно "Добавление условия".
Укажите условие "По автору".
В группе "Найти документы, у которых автор" выберите значение "любой из".
В поле имени введите: Петр Иванов.Примечание Имена при вводе следует разделять запятыми. Введите иерархическое имя пользователя (например, Maria Bolohova/Development/Acme), если оно известно. Если написание имени пользователя неизвестно, нажмите кнопку пользователя, чтобы найти имена в общей адресной книге.
Нажмите кнопку "Добавить".Условие будет добавлено в агент, а диалоговое окно "Добавление условия" закроется.
Откройте вкладку "Объекты" в списке сведений, а затем в списке объектов выделите элемент "Действие".
Нажмите кнопку "Добавить действие".Появится диалоговое окно "Добавление действия".
В поле "Действие" выберите значение "Пометить документ как непрочтенный".
Нажмите кнопку "Добавить".Notes вставит в агент действие и закроет диалоговое окно "Добавление действия".
Выберите команду: Файл - Сохранить, чтобы сохранить агент в базе данных.
Пример агента: удаление документов
На протяжении нескольких месяцев важные сообщения сохранялись в папке "Сохраненные". Размер папки стал слишком большим и требуется удалить все сообщения, созданные до августа 2002 года.
Сначала откройте почтовую базу данных и выберите команду: Создание - Агент. Появятся окно свойств агента и область программирования.
В окне свойств агента
На вкладке "Основные" в поле "Имя" введите "Удалить старую почту".
В группе "Запуск" установите переключатель в положение "Событие", а затем в списке выберите значение "При выборе из меню действий".
В поле "Объект" выберите значение "Все документы в представлении".
Закройте окно свойств агента.
В области программирования
Откройте вкладку "Объекты" в области списка сведений, а затем выделите элемент "Выбор документов" в списке объектов.
В нижней части области программирования нажмите кнопку "Добавить условие".Появится диалоговое окно "Добавление условия".
Укажите условие "По дате".
В группе "Найти документы, у которых" выберите в списках первых двух полей значения "дата создания" и "предшествует" соответственно, затем в крайнем правом поле (поле даты) укажите "8/1/02".
Нажмите кнопку "Добавить".Условие будет добавлено в агент, а диалоговое окно "Добавление условия" закроется.
Откройте вкладку "Объекты" в списке сведений, а затем в списке объектов выделите элемент "Действие".
Нажмите кнопку "Добавить действие".Появится диалоговое окно "Добавление действия".
В поле "Действие" выберите значение "Удалить из базы данных".
Нажмите кнопку "Добавить".Notes вставит в агент действие и закроет диалоговое окно "Добавление действия".
Выберите команду: Файл - Сохранить, чтобы сохранить агент.
Примечание Чтобы запустить агент, откройте папку "Сохраненные" и выберите команду: Действия - Удалить старую почту.
