- •Введение
- •Синтаксис формул
- •Лексические элементы формул
- •Переменные
- •Предопределенные поля
- •Временные переменные
- •Константы
- •Операторы выполнения операций
- •Порядок выполнения вычислений
- •Ключевые слова
- •Функции
- •Побочные эффекты
- •Ограничения применимости @-функций и команд, налагаемые списком управления выполнением (ecl)
- •Ограничения применимости @-функций и команд для Web-приложений
- •Как выполняются формулы
- •Порядок выполнения
- •Формулы, возвращающие значения
- •Формулы, выполняющие последовательность действий
- •Выполнение формул, содержащих вызовы @-команд
- •Обработка ошибок в формулах
- •Описание @-функций Domino
- •Функции - базовые конструкции языка формул
- •Функции выполнения циклов
- •Функции определения и преобразования типов данных
- •Функции для работы со строками
- •Определение вхождения подстроки в строку
- •Выделение и замена части строки
- •Функции для работы со значениями типа "дата-время"
- •Функции, работающие с компонентами значения типа "дата-время"
- •Функции для работы с численными значениями
- •Функции для работы со списками
- •Работа с переменными окружения
- •Установка значения временной переменной
- •Функции для работы с текущим документом
- •Определения свойств, характеристик и состояния текущего документа
- •Операции с полями
- •Операции с документом
- •Функции для работы с паролями
- •Функции для работы с почтой
- •Функции, определяющие почтовые настройки
- •Работа с идентификаторами документов
- •Получение информации из баз данных Domino
- •@DbColumn - выбор значений из колонки
- •@DbLookup - выбор из колонки или поля значений по ключу
- •Получение информации из баз данных, поддерживающих odbc-драйверы
- •Функции для работы с видами
- •Функции, используемые в формулах отбора документов
- •Функции, используемые в формулах колонок
- •Функции, работающие с именами пользователей
- •Функции, работающие с правами доступа
- •Функции, работающие с профильными документами
- •Функция выбора требуемого фрейма
- •Диалог с пользователем
- •Функции, определяющие тип и характеристики используемого программного обеспечения
- •Функции, используемые в Web-приложениях
- •Информационные функции
- •Функции для обработки ошибок
- •Описание @-команд Domino
- •Команды для работы с текущим и выделенными документами
- •Команды открытия объектов
- •Команды для работы с профильными документами
- •Команды обновления отображаемой информации
- •Команды для работы с видами и папками
- •Команды запуска приложений
- •Команды для работы с почтой
- •Алфавитный список @-функций
- •Алфавитный список @-команд
- •Разработка тестовых приложений
- •Простые операции с документами
- •Создание нового документа по форме
- •Редактирование текущего документа
- •Удаление документа
- •Печать документа и вида
- •Упражнение
- •Формулы полей
- •Упражнение
- •Получения доступа к данным, находящимся вне текущего документа
- •Доступ к данным вида
- •Наследование
- •Функция @DialogBox
- •Функция @PickList
- •Формулы скрытия информации
- •Формулы скрытия абзаца формы
- •Формулы скрытия акций формы и вида
- •Формулы скрытия столбцов вида и строк аутлайна
- •Упражнение
- •Формулы работы с видами
- •Формула отбора документов
- •Формулы столбцов вида
- •Наложения фильтра на вид
- •Работа с почтой
- •Работа с именами пользователей
- •Работа с уровнями доступа
- •Блокировка документов на редактирование
- •Операции с папками
- •Функции, используемые в Web-приложениях
- •Формулы по месту применения
- •Формулы панели инструментов - Toolbar button
- •Формулы агентов
- •Формула секции с управляемым доступом
- •Остальные функции
- •Литература
- •1 Введение 3
- •2 Синтаксис формул 5
- •3 Лексические элементы формул 6
- •4 Как выполняются формулы 30
- •5 Обработка ошибок в формулах 36
- •6 Описание @-функций Domino 39
- •11 Литература 412
-
Функции, определяющие почтовые настройки
Эти функции позволяют определить текущие почтовые настройки пользователя. Почтовые настройки определяются пользователем в документах Locations из личной адресной книги и выбираются при смене текущего местоположения, а также, общие для всех местоположений, выбираются в окне, получаемом из меню по File -> User Preferences -> Preferences.
Рис. 6.9 Общие почтовые настройки
@MailDbName
Область применения: нельзя использовать в формулах колонок. В Web-приложениях не работает.
Функция @MailDbName возвращает двухэлементный текстовый список формата "сервер": "файл_почтового_ящика", соответствующий текущему размещению почтового ящика пользователя. Первый элемент списка может быть пустой строкой, если почтовый ящик размещен локально, или функция используется в агенте по расписанию, выполняющемуся на сервере.
Вообще говоря, в контексте выполнения функции @MailDbName на стороне сервера, последний (т.е. сервер) воспринимается как текущий пользователь, а так как у сервера нет своего почтового ящика, то возвращается список из двух пустых строк.
@Domain
Область применения: нельзя использовать в формулах навигатора. При выполнении на сервере возвращает домен сервера. В Web-приложениях не работает.
Возвращает имя домена для текущего пользователя из личной адресной книги, в соответствии с текущим местом вызова. Функцию удобно использовать в формулах, оперирующих почтовыми адресами.
Пример 1. Возвращает "InterTrustCorp", если текущий пользователь принадлежит к домену "InterTrustCorp" в соответствии со своей личной адресной книгой и текущим местом вызова.
@Domain
Пример 2. Если в списке CopyTo содержится почтовый адрес текущего пользователя, он будет заменяться пустой строкой, а функция @Trim будет устранять пустые строки из списка, что в итоге приведет к удалению имени текущего пользователя из поля CopyTo.
FIELD CopyTo := @Trim( @Replace( CopyTo; @UserName +
" @ " + @Domain ); "" ));
@MailSavePreference
@MailSignPreference
@MailEncryptSentPreference
@MailEncryptSavedPreference
Область применения: нельзя использовать в формулах отбора, колонок. В Web-приложениях не работают.
Функция @MailSavePreference возвращает:
-
0, если в общих почтовых настройках в выпадающем списке с заголовком "Save mail that yoy send" выбрано "Don't keep a copy" (не сохранять копию);
-
1, если выбрано "Always keep a copy" (всегда сохранять копию);
-
2, если выбрано "Always prompt" (всегда выводить окно, позволяющее конкретно разрешить вопрос о сохранении).
Функция @MailSignPreference возвращает 1 (TRUE), если в общих почтовых настройках отмечена опция "Sign mail that you send" ("подписывать" отправляемую почту), и 0 (FALSE) в противном случае.
Функция @MailEncryptSentPreference возвращает 1 (TRUE), если в общих почтовых настройках отмечена опция "Encrypt mail that you send" (шифровать отправляемую почту), и 0 (FALSE) в противном случае.
Функция @MailEncryptSavedPreference возвращает 1 (TRUE), если в общих почтовых настройках отмечена опция "Encrypt saved copy of mail that you send" (шифровать сохраняемую в почтовом ящике копию почтового сообщения), и 0 (FALSE) в противном случае.
@GetAddressBooks( флаги )
Область применения: нельзя использовать в формулах отбора и колонок.
Возвращает список адресных книг ассоциированных с клиентом (если формула выполняется в локальной БД), или с сервером – для серверных БД.
Флаги являются необязательными параметрами функции, и могут принимать следующие значения:
-
[TITLES] – возвращает вместо имени файла(ов) адресных книг их заголовки;
-
[FIRSTONLY] – возвращает только первую адресную книгу.
Если параметры не указаны, то должно возвращаться имена файлов всех адресных книг.
В документации сказано, что для релиза M10 Lotus Domino Designer 6 (скорее всего, имеется ввиду пререлиз R 6) необходимо использовать хотя бы один из флагов, и для флага [TITLES] все равно возвращается имя файла, а не его заголовок. Из опыта (Designer 6.0.1, ОС – Windows 2000) формула не сохраняется без использования флагов, и как в серверном, так и в локальном варианте возвращается только имя файла первой адресной книги.