I Д^птоге RomFojcler ~] 1^ШВИЩЙЩ-ЙШ -l[T_f Рис. 3.48 Внешний вид формы в Domino Designer Однако форма будет не столь проста, как может показаться на первый взгляд.

 ; Lotus Domino R. 5: @~формулы, LotusScript, «строенные классы LotusScript и Java 701
Возвращаемое значение - объект класса NotesUIDocument, представляющий документ, открытый в рабочем пространстве. с" '
Пример 1. Скрипт акции по виду открывает в режиме редактирования документ, «на котором находится» курсор вида (прямоугольная рамка).
Sub Click(Source As Button)
ws As New NotesUIWorkspace ' : .-,.
Call ws.EditDocument( True )
End Sub
Пример 2. Скрипт акции по виду открывает в режиме редактирования документ, «на котором находится» курсор вида, и перемещает курсор документа в поле Body.
Sub Click(Source As Button)
Dim ws As New NotesUIWorkspace
Dim uidoc As NotesUIDocument
Set uidoc = ws.EditDocument( True ) ' ><
Call uidoc. GotoField ( "Body" ) '*
End Sub
Метод editProfile - «создать или открыть профильный документ»
Set notesUIDocument = nolesUIWorkspace.editProTi\e(profileName$ [, userName$ ])
Открывает в режиме редактирования новый или существующий «профильный» документ в текущей базе рабочего пространства. Параметр profileNameS (тип String) задает имя или алиас «профильного» документа, а в базе должна присутствовать соответствующая форма (с именем profileNameS) для его отображения. Необязательный параметр userName$ (тип String) определяет имя пользователя, к которому относится «профильный» документ.
Пример, Скрипт создает новый или открывает уже существующий профильный документ "Interest Profile" для текущего пользователя.
Dim ws As New NotesUIWorkspace
Dim session As New NotesSession - ' '-'- '
Call ws.EditProfile("Interest Profile", session.UserName)
Метод composeDocument - «создать новый документ»
Set notes UIDocument = notes UnVorkspace.ComposeDocwnent(
[ servers [ ,file$ [ ,form$ [, windowWidth# [, windowHeighttt ]]]]])
Создает новый документ по форме form$ из базы/г/е$ на сервере serverS, «делает его» текущим документом и «показывает» в интерфейсе пользователя.
':'' Параметр server$ (тип String) задает имя сервера, на котором находится содержащая к,; форму база. Если параметр опущен или задан, как пустая строка (""), предполагается, что - база расположена локально. Если оба параметра server$ ufi!e$ опущены или заданы пустыми
строками, форма выбирается из текущей базы.
Параметр file$ (тип String) указывает имя файла базы, в которой (по форме из которой) необходимо создать документ. Если параметр опущен или задан пустой строкой (""), документ создается в текущей базе (по форме из текущей базы).
Параметр form$ (тип String) задает название формы, по которой должен быть создан документ. Если параметр опущен или задан пустой строкой (""), появляется диалоговое окно Create Other, в котором пользователь может выбрать имя формы.
© InterTrust Co. Тел. (095) 9567928
702 Встроенные классы LotusScript и Java
Параметры windowWidthft и windowHeighttt (оба типа Double) задают соответственно ширину и высоту (в дюймах) окна создаваемого документа. Если параметры опущены, они выбираются такими же, как у текущего окна.
Возвращаемое значение - объект класса NotesUIDocument, представляющий документ, который создан в виртуальной памяти и открыт в рабочем пространстве.
Пример. Скрипт создает новый документ по форме Main Topic в текущей базе, когда пользователь нажимает кнопку акции в виде.
Sub Click{Source As Button)
Dim ws As New NotesUIWorkspace
Dim uidoc As NotesUIDocument
Set uidoc = ws.ComposeDocument( "", "Main Topic" )
End Sub
© Метод dialogBox - «открыть документ в диалоговом окне по указанной форме»
flag = notesUIWorkspace.dialogBox(form$ [, autoHorzFit [, autoVertFit
[, noCancel [, noNewFields [, noFieldUpdate [, readonly [, title$ [, notesDocument [, sizeToTable [, noOkCancel ]]]]]]]]]] )
Выводит в модальном диалоговом окне текущий (открытый в окне или выбранный курсором в виде или папке) или специфицированный параметром notesDocument (объект класса NotesDocument) документ по указанной форме.
Параметр form$ (тип String) задает имя формы, по которой следует отображать документ.
Если параметры autoHorzFit или autoVertFit равны true, то требуется «подгонять» размеры диалогового окна по горизонтали или вертикали под размер области первой размещения (layout region) в форме. Значение false или отсутствие соответствующего параметра запрещает подгонку размеров диалогового окна по горизонтали или вертикали.
Если параметр noCancel равен true, в окне будет присутствовать только кнопка ОК, если false - кнопки ОК и Cancel.
Если параметр noNewFields равен true, поля, имеющиеся в форме, по которой в диалоговом окне открывается документ, но отсутствующие в самом документе, не будут «переданы» в документ. Если же этот параметр равен false или опущен, «новые» поля, созданные в форме, будут «переданы» в документ.
Если параметр noFieldUpdate равен true, изменения, выполненные пользователям в полях формы, по которой в диалоговом окне открывается документ, не передаются в сам документ. Если же параметр равен false или опущен, изменения будут «переданы» в документ.
Если параметр readonly равен true, документ будет открыт в диалоговом окне в режиме чтения, в нем будет присутствовать только кнопка Ok, а пользователь не сможет перевести этот документ в режим редактирования. Такое может быть полезно, например, при «выводе» развернутых подсказок. Если же параметр равен false или опущен, документ будет открыт в режиме редактирования.
Параметр titleS (тип String) определяет текст в заголовке диалогового окна. Значение по умолчанию "Lotus Notes".
Параметр notesDocument (объект класса NotesDocument) определяет открываемый в диалоговом окне документ. Когда параметр опущен, по умолчанию открывается текущий
документ.
© InterTrust Со. Тел. (095) 9567928
Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 703
Если параметр sizeToTable (появился в версии 50) равен true, то будет выполняться «подгонка» размеров таблицы под размеры диалогового окна. Если же параметр равен false или опущен, подгонка таблицы под размер диалогового окна не выполняется.
Если параметр noOkCancel (появился в версии 5.0) равен true, в окне будут отсутствовать кнопки Ok и Cancel. Если же он равен false или опущен, кнопка ОК присутствует, а наличие кнопки Cancel зависит от значений предшествующих параметров.
Возвращаемое значение flag равно true, если пользователь закрыл диалог кнопкой ОК, или false, если кнопкой Cancel. . -
При применении метода пользователь получает возможность работы с документом в диалоговом окне, причем он не может переключиться в другое окно Notes, пока не закроет этот диалог кнопкой ОК или Cancel.
Такая возможность может использоваться с любой формой, но она особенно полезна с формами, которые содержат одну область размещения (layout region), потому что пользователь может работать с этой областью, как с диалоговым окном. В окне свойств области размещения рекомендуется «снимать» опцию Display Border и выбирать опцию 3D style. Параметры autoHorzFit и autoVertFit позволяют удачным образом выводить отдельную область размещения в диалоговом окне. Ниже дается пример диалогового окна, «подогнанного» под размеры области размещения.

Рис. 3.3. Диалоговое окно, подогнанное под размер области размещения
Однако, если в форме присутствует более одной области размещения, в диалоговом окне будет выведена только первая область.
При работе с одним и тем же документом по разным формам действуют следующие соглашения:
если форма form$ имеет общие (одноименные) поля с текущим документом, значения этих полей из текущего документа выводятся в диалоговом окне;
если пользователь изменяет значение какого-то поля в диалоговом окне и нажимает кнопку Ok, эти изменения произойдут в соответствующих полях текущего документа, если только это не «запрещено» параметрами метода;
© InterTrust Со. Тел. (095)9567928
704 Встроенные классы LotusScript и Java
, если пользователь вводит значение для поля в диалоговом окне, но текущий документ и содержит поля с таким именем, «новое» поле и значение добавляются в документ, да» если в основной форме для показа этого документа такого поля нет, но если только это и «запрещено» параметром noNewFields метода.
Пример 1. Скрипт акции по виду открывает текущий документ в диалоговом окне по форме Polic1 Предполагается, что форма содержит область размещения (layout region), и диалоговое окн «подгоняется» под размер этой области.
Sub Click(Source As Button)
Dim ws As New NotesUIWorkspace
Call ws.DialogBox("Policy",True,True,True,True,False,False,"Policy")
End Sub
Пример 2. Скрипт кнопки открывает в диалоговом окне первый документ из вида "By Categorj текущей базы. Предполагается, что форма Dialog Box содержит область размещения (layout region содержащую поля Subject и Categories, и пользователь изменить название и категорию открытого и форме документа. Диалоговое окно «подгоняется» под размер этой области.
Sub Click(Source As Button) - . / '
Dim db As NotesDatabase
Dim s A
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·© Метод refreshParentNote - «передать данные из диалога в документ» Call notesUIWorkspace.refreshPareniNQte()
Рассматривая метод dialogBox, внимательный читатель мог обратить внимание, что Domino версий 5 можно открыть документ в диалоговом окне, не содержащем кнопок О] или Cancel. Конечно, такой диалог можно закрыть, однако данные, введенные ил измененные в полях формы этого диалога, не будут при этом переданы в докумен' Проблему решает метод refreshParentNote.
Подобно команде @Command([RefreshParentNote]), этот метод передает данньк введенные или измененные пользователем в полях формы, используемой диалоговым окно* в соответствующий документ. Обычно вызов метода refreshParentNote выполняется пр обработке события QueryClose используемой диалоговым окном формы, или по нажатш имеющейся в форме «собственной» кнопки, скрипт которой сначала передает изменения документ, а затем закрывает диалоговое окно.
Пример. Скрипт акции по виду открывает «указанный курсором» документ в диалоговом окне б( кнопок ОК и Cancel по форме LR.
Sub Click(Source As Button)
Dim ws As New notesUIWorkspace
Call ws.DialogBox("LR", True , True, True, True, False, False, _
"My Title",,False,True)
End Sub
Форма LR представляет собой область размещения с полем Subject и «собственной» кнопке; скрипт которой сначала передает изменения из поля Subject в документ, а затем закрывает диало
© InterTrust Co. Тел. (095) 9567928
Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 705
Заметим, что если вызов метода RefreshParentNote «закомментировать», изменения не будут передаваться в документ. (. ,,.-..

Sub Click(Source As Button)
Dim ws As New NotesUIWorkspace Call ws.RefreshParentNote
Set uidoc - ws.CurrentDocument Call uidoc.close End Sub
Метод addDatabase - «добавить пиктограмму базы в рабочее пространство» Call notesUIWorkspace.addDstt'Abase( server $ , filenames )
Добавляет в рабочее пространство пиктограмму базы filenames, расположенной на сервере serverS или локально, если server$ = "", и «выбирает» эту пиктограмму в рабочем пространстве. Если пиктограмма базы уже присутствует в рабочем пространстве, происходит только ее выбор.
Метод openDatabase - «открыть указанный вид из указанной базы» Call notesUIWorkspace.o'penDatabsise( server$ ,file$ , view$ , key$ , ,
newlnstance, temporary)
Открывает в интерфейсе пользователя указанный вид из указанной базы. Параметры serverS (тип String) nfile$ (тип String) задают имя сервера и путь и имя файла базы.
Необязательный параметр viewS (тип String) сообщает имя вида, который следует открыть. Если параметр опущен, открывается вид по умолчанию.
Необязательный параметр key$ (тип String) позволяет «прокручивать» открываемый вид на первый из документов, содержащих в первом сортированном столбце этого вида значение key$. Если же параметр опущен, позиционирование вида на документ не выполняется.
Если параметр newlnstance равен true, то вид будет открыт в новом окне, даже если этот вид уже открыт в другом окне. Значение false или отсутствие параметра требуют открывать вид в новом окне только тогда, когда окно с данным видом в списке окон отсутствует.
Если параметр temporary равен true, то база должна быть открыта только «временно», без добавления ее пиктограммы в рабочее пространство пользователя (если только ее там нет). Значение false или отсутствие параметра требуют добавления пиктограммы базы в рабочее пространство пользователя (если ее там еще нет).
© Метод openFileDialog - «диалог для выбора открываемых файлов»
stringArray = notesUIWorkspace.openFileDialag( multipleSelection [, title$ ] [,filters$ ] [, initialDirectoryS ] [, initialFile$ ])
Выводит диалоговое окно FileOpen («выбор открываемых файлов»). Если параметр multipleSelection равен true, окно позволяет выбрать несколько файлов, иначе только один файл. Строка title$ задает текст в заголовке окна. Строка filters$ задает шаблон для отбора предлагаемых пользователю файлов. Например, если filtersS - "Notes Databases|*.nsfjNotes Templates]*.ntf", то в списке кандидатов для отбора присутствуют только базы и шаблоны баз Notes. Наконец, строки initialDirectoryS и initialFileS задают соответственно каталог, из
© InterTrust Со. Тел. (095) 9567928
706 Встроенные классы LotusScript и Java
которого первоначально отображаются удовлетворяющие шаблону отбора файлы, и имя файла, первоначально выбираемое автоматически.
Возвращаемое значение имеет тип Variant и содержит массив строк с именами выбранных файлов, если пользователь нажал кнопку Ok, или Empty, если пользователь нажал кнопку Cancel.
Пример. Скрипт выводит диалог для выбора любых файлов с диска С:, а затем отображает результаты осуществленного пользователем выбора.
Dim ws As New NotesUIWorkspace
Dim files As Variant
files = ws.OpenFileDialog(True, "File List", "", "c:")
If Isempty(files) Then
Messagebox "Ничего не выбрано" Else
Dim messagelist As String
Forall filelist In files
messagelist = messagelist & filelist & Chr(lO)
End Forall
Messagebox messagelist End If
© Метод saveFileDialog - одиалог для выбора сохраняемых файлов»
stringArray = notesUIWorkspace.sa\eҐileDialog( multipleSelection [, titleS ] [,filters$ ] [, initialDirectoryS ] [, initialFile$ ] )
Выводит диалоговое окно FileSave («выбор сохраняемых файлов»). Параметры и возвращаемое значение метода аналогичны соответствующим параметрам метода openFileDialog.
© Метод openFrameSet - «открыть набор фреймов» Call notesUIWorkspace.openҐmmeSet( framesetS )
Подобно «команде» @Command([OpenFrameset]), открывает указанный параметром frameset$ (тип String) набор фреймов. Если предварительно был определен текущий целевой фрейм, набор фреймов открывается в нем.
Пример. Скрипт открывает набор фреймов myFrameset.
Dim ws As New NotesUIWorkspace Call ws.OpenframeSet{"myFrameset")
© Метод setTargetFrame - «определить целевой фрейм» Call notesUIWorkspace.setTnrgeiFrame(frame$ )
Подобно функции @SetTargetFrame, позволяет определить целевой фрейм при открытии вида, страницы, набора фреймов или создании или редактировании документа. Параметр frameS (тип String) задает имя фрейма, в который должна выполняться «загрузка».
Вызывать метод SetTargetFrame необходимо перед вызовом методов openView (открыть вид), openPage (открыть страницу), openFrameSet (открыть набор фреймов), composeDocument (создать и открыть документ) или editDocument (открыть документ для редактирования) - все эти методы выполняют «загрузку» в предустановленный методом setTargetFrame целевой фрейм.
© InterTrust Co. Тел. (095) 9567928
Lotus Domino R. S: @-формулы, LotusScript, встроенные классы LotusScript и Java 707
Пример. Скрипт открывает набор фреймов myFrameset, определяет его фрейм frame2 в качестве текущего фрейма и загружает в него страницу banner.
Dim ws As New NotesUIWorkspace ''' ;-':' '"-" ' .-- : - : ; '
Call ws.OpenframeSet("myFrameset") Call ws.SetTargetFrame("top")
Call ws.OpenPage("banner")
0 Метод openPage - «открыть страницу»
Call notes UIWorkspace.openPage(pagename$) .
Подобно «команде» @Command([OpenPage]), открывает заданную параметром pagename$ (тип String) страницу из текущей базы. Если предварительно был определен текущий целевой фрейм, страница открывается в нем.
© Метод prompt - «диалог предопределенного типа»
variant = notesUIWorkspace.prampt( type%, title$,prompt$, [default] [, values ] )
Подобно «команде» @Prompt, метод выводит диалоговое окно. Пользователь выбирает или вводит информацию в окне и завершает диалог, а метод возвращает введенную или выбранную пользователем информацию.
Параметр type% задается константой, определяющей тип диалогового окна. Возможные типы точно такие же, как у функции @Prompt: PROMPT_OK, PROMPTJYESNO, PROMPTJfESNOCANCEL, PROMPT_OKCANCELED1T, PROMPT_OKCANCELLIST, PROMPTJ3KCANCELCOMBO, PROMPT OKCANCELEDITCOMBO,
PROMPT_OKCANCELLISTMULT, PROMPT PASSWORD. . , :... ..
Параметры titleS и prompt$ (оба типа String) задают текст, выводимый соответственно в заголовок окна и в само окно.
Параметр default задает выбор по умолчанию и необходим в диалоговых окнах типа PROMPT_EDIT, PROMPT_LIST, PROMPT COMBO, PROMPT_EDITCOMBO и PROMPTJLISTMULT. Он может быть типа String, Array of type String, Variant of type String или Variant Array of Strings и содержать одну или несколько строк текста.
Параметр values задает все предоставляемые на выбор пользователю варианты и необходим в диалоговых окнах типа PROMPT LIST, PROMPT COMBO, PROMPT_ EDITCOMBO и PROMPT JJSTMULT. Он может быть типа Array of type String, Variant of type String или Variant Array of Strings.
Возвращаемое значение имеет тип Variant и зависит от способа завершения диалога и типа использованного диалогового окна. Если диалог был завершен кнопкой CANCEL, возвращается Empty. Если же диалог был завершен кнопкой ОК, то для диалогов типа . PROMPT_OK, PROMPT_YESNO, PROMPT_YESNOCANCEL возвращается Variant of type . Integer, для PROMPTJEDIT, PROMPTJJST, PROMPT_COMBO, PROMPT EDITCOMBO, PROMPTJPASSWORD - Variant of type String, а для PROMPT_LISTMULT - Variant Array.
Пример. Реализация и внешний вид диалога с выбором одного элемента из списка.
Dim ws As New NotesQIWorkspace .
Dim returnValue As Str
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
· Тел. (095) 9567928
708 Встроенные классы LotusScript u Java
possibleValues(5) = "Bobby Jones"
returnValue = ws.Prompt(PROMPT_OKCANCELLIST,"Survey", _
"Who was the greatest Philadelphia 76er of all time?","",possibleValues)
If (returnValue <> "") Then
Print "Your favorite player is " & returnValue Else
Print "Sorry, but no selection was made." End If

f

© Метод pickListColleetion - едиалог для выбора документов из вида» ;
Set notesDocumentCollection = notesUIWorkspace.picliljistCol\ection( type%,
multipleSelection [, server$ ] [, databaseFileName$ ] [, viewName$ ] [, titleS ] [, prompt$ ] [, categorynameS ] )
Подобно функции @Picklist, метод выводит модальное диалоговое окно с содержимым вида. Пользователь может выбрать в этом окне один или несколько документов, коллекция которых и возвращается методом.
Значение параметра type$ (тип Integer) задается константой PICKLIST_CUSTOM - в диалоговом окне будет отображаться содержимое вида. Иных вариантов, подобных доступным в функции @Picklist, в документации не упоминается.
Если параметр multipleSelection равен true, возможен выбор нескольких документов, если false - только одного документа.
Параметры server$, databaseFileNameS и viewNameS (все типа String) специфицируют имя сервера, имя файла базы данных и имя вида, который должен отображаться в диалоговом окне.
Параметры title$ и prompts (оба типа String) задают текст, выводимый соответственно в заголовок диалогового окна и в само окно в его верхней части.
Необязательный параметр categorynameS (тип String) может применяться для категоризированных видов и содержать название категории - в этом случае в диалоговом окне будут отображаться не все документы из вида, а только документы из этой категории.
Возвращаемое значение представляет собой объект класса NotesDocumentCollection, содержащий коллекцию (возможно, пустую) отобранных пользователем документов, если пользователь завершил диалог нажатием кнопки (Ж, или Nothing, если диалог был завершен кнопкой Cancel.
© Метод pickListStrings - «диалог для выбора строк из столбца вида»
Set stringArray = notesUIWorbpace.pKkListStrings( type%, multipleSelection
[, serverS ] [, databaseFileName$ ] [, viewName$ ] [, title$ ] [,prompt$ ] [, column% ] )
© InterTrust Co. Тел. (095) 9567928
Lotus Domino R. 5: (^-формулы, LotusScript, встроенные классы LotusScript и Java 709
В основном, подобно функции @Picklist и методу pickListCollection, этот метод выводит модальное диалоговое окно с содержимым вида. Пользователь может выбрать в этом окне один или несколько документов. Возвращается массив строк, содержащих для отобранных документов информацию из указанного столбца вида.
Параметры метода, за исключением первого и последнего, аналогичны соответствующим параметрам метода pickListCoIiection.
Параметр type$ (тип Integer) задается одной из следующих констант: PICKLISTjSiAMES -выбор имен из адресной книги, PICKLIST_ROOMS - выбор помещений из адресной книги, PICKL1ST_RESOURCES - выбор ресурсов из адресной книги, PICKLIST_CUSTOM - выбор по содержимому любого вида. Если type$ не равно PICKLIST_CUSTOM, следует задать еще только параметр multipleSelection, а остальные опустить. Если же type$ равно P1CKLIST_CUSTOM, обычно задают все параметры метода.
Последний параметр - column% (тип Integer) - задает номер столбца вида, из которого для выбранных пользователем документов должны извлекаться и возвращаться значения.
Возвращаемое значение имеет тип Variant и содержит массив строк, возможно, пустой, если пользователь завершил диалог кнопкой ОК, или Empty, если диалог был завершен кнопкой Cancel.
Метод viewRefresh - «обновить вид»
Call notesUIWorkspace.viGw'Refresh -: ,
Обновляет текущий вид.
Когда активным является окно документа, полученного из вида, для обновления окна вида рекомендуется вызвать два метода: refresh класса NotesView и viewRefresh класса NotesUI Workspace.
Пример 1. Скрипт кнопки акции (по виду) обновляет открытый в рабочем пространстве вид.
Sub Click(Source As Button)
Dim ws As New NotesUIWorkspace ' :' "''.
Call ws .ViewRefresh . ;, ;
End Sub
Пример 2. Скрипт кнопки акции (по виду) создает и сохраняет документ в текущей базе, а затем обновляет текущий вид, чтобы созданный документ «появился в нем».
Sub Click(Source As Button)
Dim ws As New NotesUIWorkspace : * ' " . -
Dim session As New NotesSession ... ' . : '
Dim db As NotesDatabase ...... . . -.--
Dim doc As NotesDocument
Set db = session.CurrentDatabase
1 Создание и сохранение документа в базе " ' ' -
Set doc = New NotesDocument ( db ) !; ' '" ' '.
doc.Subject = "This is my new doc" - . .- -'" ' ": '' :'
doc. From = session. UserName ' ' ' ' ,--.-'.
Call doc.Save( True, True )
1 Обновление вида, чтобы новый документ отображался в нем
Call ws.ViewRefresh
End Sub <-- ; --.. .-.;.-. .
© Метод reloadWindow - «перезагрузить содержимое текущего окна»
Call notes f//fForbjt?ace.reloadWindow
--.---:-' .--, '.'.'!',
© InterTrust Co. Тел. (095) 9567928
710 Встроенные классы LotusScript u Java
Подобно «команде» @Command([ReloadWindow]) «перезагружает» содержимое текущего окна. Если окно содержит набор фреймов, перезагружается как сам набор, так и содержимое его фреймов. Если в окне или фрейме содержится HTML-страница, она перезагружается с Web-сервера. Для окон, содержащих «традиционную» информацию из базы, выполняется операция обновления (refresh).
© Метод folder - «поместить или переместить документ в папку»
variant ~ notesUIWorkspace.fo\Aer( [foldernameS ] [, move ] )
Если параметр foldername$ опущен, метод выводит стандартное диалоговое окно Move То Folder и, после выбора пользователем нужной папки, помещает в нее текущий документ. Если же параметр foldernameS задан, то он должен содержать имя папки, а окно Move To Folder в этом случае не выводится. Текущий документ будет или помещен в эту папку, когда параметр move равен false или опущен, или перемещен в эту папку из текущей папки, когда параметр move равен true.
@ Метод setCurreatLocation - «изменить местоположение» Call notesUIWorkspace,setCurreniLoca.tion( [ location^ ] )
Подобно «команде» @Command([SetCurrentLocation]), меняет «текущее местоположение», т.е. делает активным другой документ Location из локальной адресной книги. Параметр location$ (тип String) задает название нового «местоположения». Если параметр опущен или задан пустой строкой, выводится диалоговое окно Change Location, в котором пользователь сам выбирает новое «местоположение».
Пример. Скрипт «переключает текущее местоположение» на "Internet".
Dim ws As New NotesUIWorkspace -:
Call ws.SetCurrentLocation("Internet")
Метод URLOpen - «открыть страницу с Web-сервера»
Call notesUIWorkspaceJJRLOpen( url$, reload, urllist, charge t$, webuser$, webpasswd$, proxyuser$, proxypasswdS, notesRetriever )
Открывает страницу с Web-сервера. Во многом похож на метод getDocumentByURL класса NotesDatabase.
Параметр url (тип String) - универсальный указатель ресурса (URL), например, "http://www.lotus.com". Если параметр опущен, появляется окно Open URL, в котором пользователь должен ввести URL.
Необязательный параметр reload имеет тип Integer. Значение 1 указывает на то, что необходимо «перезагрузить» страницу с Web-сервера. Значение 2 «требует перезагружать» страницу с Web-сервера только тогда, когда она была модифицирована на Web-сервере. Значение 0 или отсутствие параметра указывает на то, что не требуется выполнять перезагрузку страницы с Web-сервера.
Запрошенная вами HTML-страница обычно содержит ссылки (URL) на другие страницы. Можно получить список всех ссылок страницы в отдельном поле документа-образа этой страницы. Естественно, выбор возможности ухудшает производительность, но любителям создавать «роботов» («пауков», «странников»...) - приложения, автоматически, обычно рекурсивно, получающих HTML-страницы с Web-серверов - эта возможность может пригодиться. Параметр urllist имеет тип Integer (по умолчанию 0). Значение 1 указывает на то, что все URL-ссылки (если есть) с этой страницы должны сохраняться в документе-образе страницы в текстовых полях с именами URLLinksw, a 0 - что не должны. Если возможность
© InterTrust Со. Тел. (095) 9567928
Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 711
выбрана, «первое» поле со списком ссылок имеет имя URLLinksl. Если ссылок много, и их общий размер превышает 64 Кб, автоматически создается поле с именем URLLinks2, содержащее логическое продолжение списка, и т.д.
Параметр charset (тип String) задает кодировку, использованную на странице. Значение по умолчанию "" - задача WEB или клиент автоматически распознает кодировку страницы по ее MIME-атрибутам, а при их отсутствии в соответствии со своими настройками. Указывать кодировку явно, например, "ISO-8859-5", имеет смысл только тогда, когда кодировка неправильно опознается автоматически. . .„.-' '-."'
Web-сервер, с которого должна быть получена страница, может требовать вашей аутентификации. Параметры webmer и webpasswd (оба типа String, по умолчанию "") позволяют сообщить имя и пароль для доступа к Web-серверу.
Серверная задача WEB или станция клиента может иметь доступ в Internet через proxy-сервер, требующий аутентификации '-вводом имени и пароля. Параметры proxyuser и proxypasswd (оба типа String, по умолчанию "") позволяют сообщить имя и пароль для доступа к proxy-серверу.
Последний параметр notesRetriever, если задать его равным true, обеспечит открытие страницы средствами Notes Web Navigator. Если же параметр равен false или опущен, страница будет открыта броузером, установленным по умолчанию.
© Метод getListOfTunes - «получить массив «звуков»»
variant- notes UIWorkspace.getUstOfTunes - -....,'._,-;..,.. Возвращает массив «звуков», определенных в системе.
© Метод playTime - «проиграть звук»
' Call notes UIWorkspace.playTune(tuneName$) -. ' -..'-, " ,
«Проигрывает звук» с именем tuneName$ (тип String). Список всех доступных «звуков» может быть определен методом getListOfTunes. В качестве значения параметра может задаваться также полный путь и имя «звукового файла».
Пример. Скрипт сначала выводит в диалоговом окне определенные в системе «звуки», а затем «проигрывает» выбранный пользователем «звук».

Dim ws As New NotesUIWorkspace ;*,;--,,...- ..' IBHHRHHHEElj
Dim tunes As Variant * . ,.
. " - Л . _ entme? .
tunes ws . G
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·Метод useLSX - «загрузить файл LSX» Call notesUIWorkspace.use1LSX( lsxLibraryName$ ) Загружает указанный файл LSX (LotusScript Extensions).
Параметр lsxLibraryName$ (тип String) должен содержать или полный путь к загружаемому файлу, например, "c:\notes\nlsxodbc.dil", или начинающийся с символа «*»
© InterTrust Со. Тел. (095) 9567928
712
Встроенные классы LotusScript и Java
шаблон для поиска имени загружаемого LSX, например, "*lsxodbc". В последнем случае на платформах Windows/32 поиск выполняется по реестру (registry) среди группы ключей HKEY_LOCAL_MACHINE\SOFTWARE\Lotus\Components\LotusScriptExtensions\2.0. Так, если выбран шаблон "*lsxodbc", а в реестре имеется ключ HKEY_LOCAL_MACHINE\ SOFTWARE\Lotus\Components\LotusScriptExtensions\2.0\LSXODBC со значением
"c:\notes\nlsxodbc.dll", будет загружен файл c:\notes\nlsxodbc.dll.

Рис. 3,43 Окно приложения RegEdt32 с информацией о 4-х зарегистрированных LSX
Метод enableAlarms - «запустить/остановить демона предупреждений»
flag = notesUIWorkspace.Enab\eA\arms( enable )
Запускает «демона предупреждений» (Alarm daemon), если он не запущен и параметр enable = true или останавливает его, если демон запущен и параметр enable = false.
Метод eheckAlarms - «проверить наличие новых событий, требующих предупреждения»
Call notesUIWorkspace.CheckAlarms( )
«Заставляет» демона предупреждений проверить наличие в почтовом файле пользователя новых событий, которые требуют предупреждения.
Для получения дополнительной информации исследуйте в своем почтовом файле возможности, получаемые выбором Tools - Preferens - закладка Alarms и, из календарного вида, выбором New - Event - закладка Options - кнопка Alarm settings.
) InterTrust Co. Тел. (095) 9567928
Lotus Domino R. 5: @гформулы, LotusScript, встроенные классы LotusScript и Java 713
,-.- .-','.--'-. * « '-
3.35. «База в интерфейсе пользователя» - класс NotesUIDatabase
Объект класса NotesUIDatabase представляет* базу данных, открытую в рабочем пространстве пользователя Notes. В классе определены несколько событий. Свойства класса позволяет получить соответствующий базе объект класса NotesDatabase и коллекцию документов, которые должны обрабатываться событием класса NotesUIDatabase. Методы класса NotesUIDatabase позволяют открыть нужный вид или навигатор.
«Контейнерная иерархия»
LotusScript NotesUIDatabase > NotesUIDatabase > "NotesDatabase1
NotesDocumentCollection [
Получить объект класса NotesUIDatabase можно только в качестве параметра в скриптах обработки событий этого класса.
3.35.1. Свойства и методы
Свойство Database - «объект класса NotesDatabase»
Set notesDatabase = notesUIDatabase.Database
Возвращает объект класса NotesDatabase, представляющий данную базу.
Пример. При каждом открытии базы будет появляться диалоговое окно с ее названием и именем файла базы.
Sub Postopen (Source As Notesuidatabase) '--'"- -
Dim db As NotesDatabase
Set db = Source.Database
Messagebox "Title: " & db.Title & Chr(lO) & "Path: " & db.FilePath,,
"Database opened" End Sub
Свойство Documents - «коллекция документов, относящихся к событию»
г "
Set notesDocumentCollection = notesUIDatabase.Documents,
Возвращает коллекцию документов (объект класса NotesDocumentCollection), которые 'должны обрабатываться данным событием класса NotesUIDatabase.
0 Метод openNavigator - «открыть навигатор»
;i Call notesUIDatabase.openNa\ig&tor( navigatorName$ \_,fullWindow\ )
Открывает навигатор. Параметр navigatorName$ (тип String) задает имя навигатора. Если параметр fullWindow равен true, навигатор будет открыт в своем собственном окне.
© Метод open View - «открыть вид»
Call notes UIDatabase.openVievf( viewName$ [, key$] [, newinstance] )
Открывает вид. Параметр viewName$ (тип String) задает имя вида. Если задан параметр
key$ (тип String, введен в версии 5.0), то при открытии вид будет автоматически
.. скроллироваться на первый документ, представленный значением key$ в первой
отсортированной колонке этого вида. Если параметр newinstance (введен в версии 5.0) равен
true, навигатор будет открыт в новом окне.
© InterTrust Co. Тел. (095) 9567928
714 Встроенные классы LotusScript u Java
3.35.2. События
Событие PostOpen - «после открытия базы» PostOpen( Source As Notesuidatabase)
Возникает после того, как база была открыта в интерфейсе пользователя, но после событий QueryOpen и PostOpen класса NotesUIView. Аргумент события - объект класса NotesUIDatabase, представляющий текущую базу.
Пример. Событие Postopen класса NotesUIDatabase возникает после событий QueryOpen и PostOpen класса NotesUIView для вида, по умолчанию открываемого в базе (default view). Поэтому уже ничто не мешает в скрипте события Postopen класса NotesUIDatabase «заменять» вид, открываемый по умолчанию, на любой другой вид.
Sub Postopen(Source As Notesuidatabase) Call Source.OpenView("By Category")
End Sub
0 Событие QueryDragDrop - «при попытке выполнить операцию «перетаскивания»»
QueryDragDrop( Source As Notesuidatabase, EntryName, Continue As Variant)
Возникает при попытке пользователя «перетащить» документ, когда при нажатой клавише мыши уже определен элемент дизайна, в который должно выполняться «перетаскивание», но до отпускания клавиши мыши и, естественно, до исполнения собственно операции «перетаскивания».
Аргумент Source - объект класса NotesUIDatabase, представляющий текущую базу.
Аргумент EntryName - имя или алиас элемента дизайна, с которым связано это событие. Например, имя папки, в которую пользователь намеревается «перетащить» документ.
Если установить аргумент Continue в значение false, операция «перетаскивания» будет отменена.
© Событие PostDragDrop - «перед исполнением операции «перетаскивания»»
PostDragDrop( Source As Notesuidatabase, EntryName, Continue As Variant)
Возникает, когда при нажатой клавише мыши определен элемент дизайна, в который должно выполняться «перетаскивание», непосредственно в момент отпускания пользователем клавиши мыши, но до исполнения собственно операции «перетаскивания».
Аргумент Source - объект класса NotesUIDatabase, представляющий текущую базу.
Аргумент EntryName - имя или алиас элемента дизайна, с которым связано это событие. Например, имя папки, в которую пользователь хочет «перетащить» документ.
Если установить аргумент Continue в значение false, исполнение операции «перетаскивания» будет отменено.
Событие QueryDocumentDelete - «перед удалением документа» QueryDocumentDelete( Source As Notesuidatabase, Continue As Variant)
Возникает непосредственно перед удалением (операции Clear или Cut) документа или выбранного (отмеченного «галочками») множества документов. Аргумент Source - объект
© InterTrust Co. Тел. (095) 9567928
Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 715
класса NotesUIDatabase, представляющий текущую базу. Если установить аргумент Continue в значение false, операция удаления документов будет отменена.
Событие QueryDocumentUndelete - «при отказе от удаления документа»
QueryDocumentUndelete( Source As Notesuidatabase, Continue As Variant)
Возникает непосредственно перед выполнением операции Undelete для документа или выбранного множества документов. Аргумент Source ~ объект класса NotesUIDatabase, представляющий текущую базу. Если установить аргумент Continue в значение false, операция «снятия отметок об удалении документов» будет отменена.
Событие PostDocumentDelete - «после удаления документа» PostDocumentDelete( Source as Notesuidatabase)
Возникает после того, как помеченные к удалению документы были удалены. Аргумент Source - объект класса NotesUIDatabase, представляющий текущую базу.
Событие QueryClose - «перед закрытием базы» QueryClose( Source As Notesuidatabase, Continue As Variant)
Возникает перед закрытием базы, но до того, как она будет закрыта. Аргумент Source -объект класса NotesUIDatabase, представляющий текущую базу. Если установить аргумент Continue в значение false, закрытие базы будет отменено.
Пример. Совокупность скриптов событий выполняет подсчет количества документов, удаленных из базы за время, в течении которого база была открыта пользователем.
(Declarations) , ...;.
Dim
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·uerydocumentundelete(Source As Notesuidatabase, Continue As Variant) If Continue Then
deleteCount = deleteCount - Source.Documents.Count
End If : : : ' " ' ; '.- - ." ' . " - - - ' '
End Sub ... , :;: : '" -Л---; ;':-. '
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·Тел. (095) 9567928
716 Встроенные классы LotusScript u Java
3.36. «Вид в интерфейсе пользователя» - класс NotesUIView
Объект класса NotesUIView представляет вид базы данных, открытый в интерфейсе пользователя Notes. Свойства класса позволяет получить соответствующий виду объект класса NotesView, название вида, дату и время текущей области в календарном виде, текущую категорию в виде и коллекцию документов, которые должны обрабатываться событием класса NotesUIView. Методы класса NotesUIView позволяют отмечать «галочками» документы в виде и печатать сам вид или отмеченные в нем документы. Кроме того, в классе определен ряд событий.
«Контейнерная иерархия»
LotusScript NotesUIView > NotesUIView > NotesView
NotesDocumentCollection
Получить объект класса NotesUIView можно только в качестве параметра в скриптах обработки событий этого класса.
/
3.36.1. Свойства и методы
Свойство View - «объект класса NotesView»
Set notes View = notes UlView.View
Возвращает объект класса NotesView, представляющий данный вид.
© Свойство ViewName - «название вида»
viewnameS = notes UlView. ViewName Возвращает название вида.
Свойство Documents - «коллекция документов, относящихся к событию» Set notesDocumentCollection - notesUIView.Documents
Возвращает коллекцию документов (объект класса NotesDocumentCollection), которые должны обрабатываться данным событием класса NotesUIView. Обратите внимание, что события QueryOpen, PostOpen, QueryPaste, QueryClose и QueryRecalc класса NotesUIView не работают с документами, поэтому в них данное свойство возвращает пустую коллекцию.
@ Свойство CaretCategory - «текущая категория в категоризированном виде»
variant = notes UlView.CaretCategory
Возвращает текущую категорию, в которую входит текущий документ вида. Свойство имеет смысл только для категоризированных видов.
Пример. Скрипт выводит текущую категорию для текущего документа.
Dim ws As New NotesUIWorkspace
Dim uiview As NotesUIView
Set uiview = workspace.CurrentView
Dim category As Variant
category = uiview.CaretCategory .
Messagebox category ,
© InterTrust Co. Тел. (095) 9567928
Lotus Domino R. 5: @гформулы, LotusScript, встроенные классы LotusScript и Java 717
Свойство CalendarDateTime - «дату и время текущей области в календарном виде»
date V ~ notes f/JF/ew.CalendarDateTime
Возвращает дату и время (Variant of type DATF^) для текущей «области» в календарном виде. Свойство имеет смысл только для календарных видов.
Пример. При выполнении пользователем «двойного щелчка мышью» по области календарного вида происходит событие Regiondoubleclick, скрипт которого выводит в окне соответствующее этой области дату и время.
Sub Regiondoubleclick(Source As Notesuiview)
Messagebox Source.CalendarDateTime,, "Date and time for this region" End Sub
© Метод print - «напечатать вид или документы из вида»
Call notesUIView.print( [ nwnCopies% ] [,fromPage% ] [, toPage% ] [, draft ]
[, pageSeparator% ] [,fonnOverride$ ] [, printview] [, dateRangeBegin] [, dateRangeEnd] )
Подобно «команде» @Command([FilePrint]), печатает текущий вид или документы из этого вида («отмеченные галочками» документы или, если отмеченных нет, то текущий документ вида).
Параметр nwnCopies% (тип Integer) задает количество копий. Если параметр опущен, появится диалоговое окно File Print.
Параметр fromPage% (тип Integer) задает номер страницы, с которой начинается печать документа. Значение 0 требует печатать все.
Параметр toPage% (тип Integer) задает номер страницы, до которой включительно продолжается печать документа. Значение 0 требует печатать все.
Если параметр draft равен true, вывод осуществляется в «черновом» режиме.
Параметр pageSeparator% (тип Integer) определяет разделитель страниц.
Параметр formOverrideS (тип String) задает название формы, по которой (вместо формы, по которой документ отображается на экране) будет выполняться вывод документов.
Если парамvrpprintView равен true, то будет выполняться печать вида, а не документов.
Параметры dateRangeBegin и dateRangeEnd (тип Variant) задают дату начала и окончания, если метод применяется к календарному виду.
Пример. Скрипт выдает диалоговое окно File Print, в котором пользователь выбирает, что (вид или документы) и как должно быть напечатано.
Dim workspace As New NotesUIWorkspace
Dim uiview As NotesUIView
Set uiview = workspace .Currentview "" ' '''"'
Call uiview.Print
Метод selectDocument - «выбрать документ»
Call notes ty/F/ew.SelectDocument( notesDocument) , ; :
Отмечает в виде «галочкой» документ, определенный параметром метода (объект класса NotesDocument).
* .., ' :.----. 3.36.2. События ....
Событие Query Open - «перед открытием вида»
QueryOpen( Source As Notesuiview, Continue As Variant) ....,,....;.
© InterTrust Co, Тел, (095) 9567928
718 Встроенные классы LotusScript u Java
Возникает при попытке открыть вид, но прежде чем вид будет открыт. Аргумент Source -объект класса NotesUIView, представляющий этот вид. Если установить аргумент Continue в значение false, операция открытия вида будет отменена.
Пример. При попытке открыть этот вид, если только он календарный, появится диалоговое окно с кнопками Yes и No. Если пользователь нажмет кнопку No, то вид не будет открыт.
Sub Queryopen(Source As Notesuiview, Continue As Variant) Dim view As NotesView Set view = Source.View If view.IsCalendar Then
If Messagebox("Do you want to continue?",MB__ICONQUESTION, _ "Calendar view") = IDNO Then
Continue = False End If End End Sub
Событие PostOpen - «сразу после открытия» PostOpen( Source As Notesuiview )
Возникает сразу после того, как вид был открыт. Аргумент Source - объект класса NotesUIView, представляющий этот вид.
Событие QueryDragDrop - «в начале операции «перетаскивания»» QueryDragdrop( Source As Notesuiview, Continue As Variant)
Возникает при попытке выполнить операцию «перетаскивания» в календарном виде, но до выполнения этой операции. Аргумент Source - объект класса NotesUIView, представляющий этот вид. Если установить аргумент Continue в значение false, операция «перетаскивания» будет отменена.
Событие PostDragDrop - «после операции «перетаскивания»» PostDragdrop( Source As Notesuiview )
Возникает сразу по завершении операции «перетаскивания» в календарном виде. Аргумент Source - объект класса NotesUIView, представляющий этот вид.
Событие RegionDoubleClick - «двойной щелчок мышью по области календарного вида»
RegionDoubIeClick( Source As Notesuiview )
Возникает при выполнении пользователем «двойного щелчка мышью» по области календарного вида. Аргумент Source - объект класса NotesUIView, представляющий этот вид.
Событие QueryAddToFolder - «перед добавлением документов в папку» QueryAddToFolder( Source As Notesuiview, Target As Variant, Continue As Variant)
Возникает непосредственно перед добавлением одного или нескольких документов в папку. Аргумент Source - объект класса NotesUIView, представляющий этот вид. Аргумент Target - название папки, в которую «хотят» добавить документы. Если установить аргумент Continue в значение false, операция добавления будет отменена.
Пример. Скрипт выводит в окне список названий документов, которые пользователь пытается добавить в папку. Если пользователь нажимает в окне кнопку No, операция добавления отменяется.
(Globals) (Declarations) © InterTrust Co. Тел. (095) 9567928
Lotus Domino R. 5: @гформулы, LotusScript, встроенные классы LotusScript и Java 719
%INCLUDE "Isconst.lss"
Sub Queryaddtofolder(Source As Notesuiview, Target As Variant,
Continue As Variant) Dim doc As NotesDocument
Dim docList As String " ' ' :" . For j 1 To Source . Documents . Count-Set
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·Событие QueryOpenDocument - «перед открытием документа» QueryOpenDocument( Source As Notesuiview, Continue As Variant)
Возникает непосредственно перед открытием документа из этого вида. Аргумент Source -объект класса NotesUIView, представляющий этот вид. Свойство Documents возвращает коллекцию, содержащую только один документ, который пользователь пытается открыть. Если установить аргумент Continue в значение false, операция открытия документа будет отменена.
Пример. При открытии вида пользователь «сообщает», документы какой категории его интересуют. Затем при любых попытках открыть документ из вида выполняется проверка, принадлежит ли открываемый документ указанной пользователем категории, и, если не принадлежит, открытие документа блокируется.
(Declaration
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
Событие QueryPaste - «перед вставкой документов из буфера обмена»
QueryPaste( Source As Notesuiview, Continue As Variant)
Возникает непосредственно перед «вставкой» документов из буфера обмена в вид. Аргумент Source - объект класса NotesUIView, представляющий этот вид. Если установить аргумент Continue в значение false, операция открытия документа будет отменена.
Пример. Скрипт события Querypaste в зависимости от ответа пользователя разрешает или запрещает вставку документа в базу.
(Globals) (Declarations)
%INCLUDE "Isconst.lss"
Sub Querypaste(Source As Notesuiview, Continue As Variant)
If Messagebox("Do you want to proceed with this paste operation?", _ MB_YESNO + MB_ICONQUESTION, "Paste operation") = IDNO Then
© InterTrust Co. Тел. (095) 9567928
720 Встроенные классы LotusScript и Java
Continue = False End If End Sub
Событие PostPaste - «после вставки документов из буфера обмена» PostPaste( Source As Notesuiview )
Возникает непосредственно после «вставки» документов из буфера обмена в вид. Аргумент Source - объект класса NotesUIView, представляющий этот вид. Свойство Documents возвращает коллекцию, содержащую один или несколько документов, которые были вставлены в вид.
Пример. Реализация подсчета количества документов, «вставленных» в вид из буфера обмена за время работы с этим видом.
(Declarations)
Dim pasteCount As Integer
Sub Postopen(Source As Notesuiview) f
pasteCount =0 .
End Sub Sub Postpaste(Source As Notesuiview) '
pasteCount = pasteCount + source.Documents.Count End Sub Sub Queryclose(Source As Notesuiview, Continue As Variant)
Messagebox pasteCount & " documents pasted",, "Paste operations" End Sub
Событие QueryRecalc - «перед рекалькудяцией вида» QueryRecalc( Source As Notesuiview, Continue As Variant)
Возникает непосредственно перед «рекалькуляцией» вида. Аргумент Source - объект класса NotesUIView, представляющий текущий вид. Если установить аргумент Continue в значение false, операция «рекалькуляции» вида будет отменена.
Пример. Скрипт события Queryrecalc может отменять «рекулькуляцию» вида.
(Globals) (Declarations) %INCLUDE "Isconst.Iss"
Sub Queryrecalc(Source As Notesuiview, Continue As Variant) If Messagebox("Do you really want to recalc?", __
MB_YESNO + MB_ICONQUESTION, "Recalc operation") = IDNO Then
Continue = False End If End Sub
Событие QueryClose - «перед закрытием вида» QueryClose( Source As Notesuiview, Continue As Variant)
Возникает непосредственно перед закрытием вида. Аргумент Source - объект класса NotesUIView, представляющий текущий вид. Если установить аргумент Continue в значение false, операция закрытия вида будет отменена.
© InterTrust Co, Тел. (095) 9567928
Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 721
. -.. ; t,"i :m< . < !,;'! mu!..,,. . , - - .
' - j' : --. . : :
3.37. «Документ в интерфейсе пользователя» - класс "':'
NotesUIDocument
Объект класса NotesUIDocument представляет документ, который открыт в рабочем пространстве пользователя Notes, Свойства объекта класса NotesUIDocument позволяют получить доступ к документу как объекту класса NotesDocument, определить, новый ли это документ, в каком поле находится курсор, какой заголовок окна, управлять режимом (просмотр/редактирование), «видимостью» подсказок для полей, скрытых символов, линейки форматирования, горизонтальной полосы прокрутки, панелей предпоказа. Методы объекта класса NotesUIDocument позволяют выполнять типовые операции с буфером обмена, «категоризацию» документа, пересчет формул полей и формул «видимости» абзацев, управлять состоянием секций документа, создавать встроенные OLE-объекты в текущем поле типа RichText и импортировать в него содержимое файлов, разными способами перемещать курсор по полям документа, получать из редактируемого поля и заносить в него текст, очищать, добавлять текст в редактируемое поле, выполнять поиск текста и проверку текста по словарю, осуществлять поиск свободного времени, создавать почтовое сообщение с «изображением» документа в ооле тела сообщения, отправлять почтой, удалять, сохранять и «перезагружать» документ. Наконец, объект класса NotesUIDocument имеет 8 событий: пользователь, оперируя с документом в рабочем пространстве, инициирует события, а программист может создать скрипты, которые будут выполняться «в ответ» на возникшее событие.
«Контейнерная иерархия»
LotusScript NotesUIWorkspace > NotesUIDocument > NotesDocument NotesUIDocument |
Получить ссылку на объект класса NotesUIDocument можно следующими способами:
свойством CurrentDocument класса NotesUIWorkspace;
методами EditDocument и ComposeDocument класса NotesUIWorkspace;
как аргумент Source скриптов обработки событий объекта класса NotesUIDocument.
Пример 1. Скрипт создает объект workspace класса NotesUIWorkspace, сопоставленный рабочему пространству, и затем получает ссылку uidoc на объект класса NotesUIDocument, сопоставленный текущему документу в рабочем пространстве. Далее используется метод FieldGetText для вывода в диалоговом окне содержимого поля Subject этого документа.
Dim workspace As New NotesUIWorkspace .;.,-': ' ' '
Dim uidoc As NotesUIDocument '
Set uidoc = workspace.CurrentDocument
Messagebox uidoc. FieldGetText ( "Subject" ) .' - ,...4:
' 3.37.1. Свойства
Свойство Document - «объект класса NotesDocument»
SetnotesDocu?nent = notesUIDocument.DQCumKnt : .
Объект класса NotesDocument, представляющий документ в базе, который соответствует текущему документу в интерфейсе пользователя. Если в интерфейсе пользователя создан новый документ, но он еще не сохранен, свойство возвращает ошибку, поскольку соответствующего ему документа в базе еще нет. Если в полученном этим свойством объекте NotesDocument произведены изменения, для того, чтобы они «проявились» в документе в интерфейсе пользователя, следует воспользоваться свойством AutoReload или методом reload.
© InterTrust Co. Тел. (095) 9567928
722 Встроенные классы LotusScript и Java
Свойство IsNewDoc - «новый ли документ»
flag = notesC//D0cM/He«?.IsNewDoc
Возвращает true, если документ в интерфейсе пользователя является новым (был создан, но еще не сохранен в базе), или false, если для документа в интерфейсе пользователя имеется соответствующий документ в базе.
Пример. Скрипт кнопки или акции в форме служит для помещения текущего документа в папку. Поскольку для нового документа нельзя получить объект класса NotesDocument, скрипт вынужден выполнять соответствующую проверку.
Sub Click(Source As Button)
Dim workspace As New NotesUIWorkspace
Dim uidoc As NotesUIDocument
Dim doc As NotesDocument
Di
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
Свойство AutoReload - «автоперезагрузка документа»
flag - notes UIDocument.AutoReload nolesUIDocument.AxLtoRKlouA -flag
Используется для контроля или установки свойства AutoReload («автоперезагрузка») текущего документа в интерфейсе пользователя. Если свойство включено (flag - true), то документ в интерфейсе пользователя (объект класса NotesUIDocument) должен автоматически приводиться в соответствие со связанным с ним объектом класса NotesDocument и обновляться «на экране», когда в объекте NotesDocument произошли изменения. Если же свойство выключено (flag false), такой «автоматической перезагрузки» не должно происходить. Для принудительного внесения изменений из объекта NotesDocument в документ в интерфейсе пользователя в пределах одного скрипта можно воспользоваться методом reload.
Уточним связанные со свойством AutoReload эффекты.
По умолчанию свойство AutoReload «включено».
Если скрипт работает в интерфейсе пользователя и им выполнены изменения в полях не типа RichText связанного с объектом NotesUIDocument объекта NotesDocument, который был получен свойством Document класса NotesUIDocument или иным «не прямым» способом, но с использованием объекта NotesUIWorkspace, то эти изменения «не появляются» в текущем документе в интерфейсе пользователя, если свойство AutoReload равно false. Когда необходимо, чтобы такие изменения были внесены в документ в интерфейсе пользователя, нужно или предварительно установить свойство AutoReload в значение true, или в пределах одного скрипта воспользоваться методом reload, или закрыть документ и открыть его снова.
Если скрипт работает в интерфейсе пользователя и им выполнены изменения в полях не типа RichText соответствующего объекту NotesUIDocument объекта NotesDocument, который был получен без использования объекта NotesUIWorkspace (например, методом
© InterTrust Со. Тел. (095)9567928
Lotus Domino R. 5: @гформулы, LotusScript, встроенные классы LotusScript и Java 723
getDocumentByUNID из «заново открытой» базы), то изменения «не появляются» в текущем документе в интерфейсе пользователя, пока документ не будет закрыт и открыт снова.
Если скрипт работает в интерфейсе пользователя и им выполнены изменения в полях типа RichText связанного с объектом NotesUlDocument объекта NotesDocument, эти изменения «не появляются» в текущем документе в интерфейсе пользователя, пока документ не будет закрыт и открыт снова.
Изменения, выполненные не из интерфейса пользователя (например, выполняющимся на сервере агентом или другим пользователем) в полях любого типа документа в базе (back- end), не «появляются» в текущем документе в интерфейсе пользователя, пока документ не будет закрыт и открыт снова.
Пример 1. Скрипт кнопки в форме получает объект NotesDocument, соответствующий текущему документу в интерфейсе пользователя, и изменяет в нем значение поля Subject. Это «фоновое» изменение, но поскольку свойство AutoReload по умолчанию равно true, а объект doc был получен свойством Document класса NotesUJDocument, оно немедленно происходит и в текущем документе интерфейса пользователя.
Sub
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·Эксперимент" End If End Sub .:'--- -
Пример 2. Для изучения свойства AutoReioad и метода reload сделана форма AutoReloadTest, имеющая три поля (Subject - редактируемое поле типа Text, Display - вычисляемое для показа поле типа
Text с формулой Display, Body - редактируемое поле типа RichText), восемь кнопок, событие PostOpen и «глобальные переменные», скрипты для которых приведены ниже.
Скрипт события PostOpen (это событие возникает при открытии документа по этой форме) инициализирует глобальные переменные: «рабочее пространство» ws класса NotesUIWorkspace, «документ в интерфейсе пользователя» uidoc класса NotesUlDocument и три связанных с ним объекта docl, doc2 и doc3 класса NotesDocument. Объект docl получается свойством Document от объекта uidoc. Объект doc2 получается методом GetDocumentByUNID класса NotesDatabase от объекта db2, в свою очередь полученного свойством Database от объекта ws класса NotesUIDatabase (т.е. doc2 получен «не напрямую», но с использованием объекта класса NotesUIWorkspace). Объект doc3 получается методом GetDocumentByUNID класса NotesDatabase от объекта db3, который представляет «заново открытую» базу на сервере (т.е. doc3 получен без использования объекта класса NotesUIWorkspace).
Кнопка «AutoReload» служит для «переключения режима AutoReload». Кнопка «Reload» вызывает метод reload для объекта uidoc. Кнопки Button! и Button2 «дописывают текст» в поля Subject и Display соответственно объектов docl и doc2, а кнопка ВипопЗ «дописывает текст» только в поле Subject объекта doc3 (вычисляемое для показа поле Display для объекта doc3 просто недоступно). Кнопки RButtonl и RButton2 пять раз подряд с секундной паузой «дописывают текст» в поля Subject и Display соответственно объектов docl и doc2, а кнопка RButton3 - только в поле Subject объекта doc3, а по завершении все эти кнопки вызывают метод reload для объекта uidoc.
' Globals(AutoReloadTest) - глобальные переменные формы Dim ws As NotesUIWorkspace
©InterTrustCo. Тел. (095) 9567928
724 Встроенные классы LotusScript u Java
Di
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
· Инициализация глобальных переменных
Set ws = New NotesUIWorkspace
Set uidoc = ws.CurrentDocument
UNID = uidoc.Document.UniversallD
uidoc.save
' Иначе для нового документа нельзя получить NotesDocument по UNID
Set docl = uidoc.Document
Set db2 = ws.CurrentD
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
· Сейчас AutoReload" End Sub
Sub Click(Source As Button)
1 Кнопка AutoReload - переключение режима uidoc.AutoReload = Not (uidoc.AutoReload)
Msgbox uidoc.AutoReload,,"Теперь AutoReload равно" End Sub
Sub Click(Source As Button) -
' Кнопка Reload - вызов метода Reload Call uidoc.Reload
End Sub ; ' . - '
Sub Click(Source As Button)
' Кнопка Buttonl '
docl.Subject = docl.Subject(0) & " +Buttonl"
docl.Display = docl.Display(0) & " +Buttonl" End Sub
Sub Click(Source As Button)
' Кнопка Button2
doc2.Subject = doc2.Subject(0) & " +Buttonl"
doc2.Display = doc2.Display(0) & " +Buttonl" End Sub
Sub Click(Source As Button)
' Кнопка Button3 ' '..-..
doc3.Subject = doc3.Subject(0) & " +Buttonl"
End Sub
Sub Click(Source As Button) . -
' Кнопка RButtonl For i = 1 To 5
docl.Subject = docl.Subject(0) & " +Buttonl" docl.Display = docl.Display(0) & " +Buttonl" Sleep(1) : Beep
© InterTrust Co. Тел. (095)9567928
Lotus Domino R. 5: @гформулы, LotusScript, встроенные классы LotusScript и Java 725
Next . ""-.-.,- '';'' ::\ '. v-v -',v-:;; ' i;':>. ,-'-:!v ...- -,-;>.,-.
Call uidoc.Reload
End Sub ' ''- ' "''-
Sub Click(Source As Button)
1 Кнопка Rbutton2 " ' : ''.--: : . : - .
For i = 1 To 5 ' ' ' : . -..: -
doc2.Subject = doc2.Subject(0) & " +Buttonl" : .
doc2.Display = doc2.Display(0) & " +Buttonl" Sleep(1) : Beep Next
Call uidoc.Reload - --. . л . . . ^ -:.,-. .. . - .... .
End Sub
Sub Click(Source As Button) . -. ., . .... . . ;
1 Кнопка Rbutton3
For i = 1 To 5 .-,,..
doc3. Subject = doc'3.Subject (0) & " +Buttonl" Sleep (1) : Beep . ,.-,. . : ..;.'
Next . . ., ,. - ..-..-
Call uidoc.Reload End Sub
При экспериментах с документами, созданными по этой форме (Notes/Domino 5.0a), наблюдались следующие результаты.
Свойство AutoReload = true. Изменение полей Subject и Display, выполняемое кнопками Button! и Button2, сразу же отображается на экране. Изменение полей Subject и Display, выполняемое кнопками RButlonl и RButton2, сразу же отображается на экране, т.е. «добавления» появляются в полях на экране через каждую секунду. Кнопки ButtonS и Rbutton3 вообще никаких изменений на экране не вызывают. Кнопка Reload ни при каких условиях изменений на экране не вызывает.
Свойство AutoReload = false. Изменение полей Subject и Display, выполняемое кнопками Button! и Button2, не отображается на экране. Нажатие кнопки Reload вслед за нажатием кнопок Button! или Button2 никаких изменений на экране не вызывает. Изменение полей Subject и Display, выполняемое кнопками RButtonl и RButton2, вызывает изменения на экране в момент вызова имеющегося в скриптах этих кнопок метода reload - все пять «добавлений» появляются в полях на экране одновременно, а не последовательно через секунду. Кнопки ВипопЗ и RbuttonS, в том числе и в сочетании с последующим нажатием кнопки Reload, вообще никаких изменений на экране не вызывают. Так что кнопка Reload ни при каких условиях никаких изменений на экране не вызывает.
Можно сделать следующие выводы. Свойство AutoReload объекта uidoc функционирует только в том случае, если объект doc класса NotesDocument был получен или «напрямую» свойством Document от объекта uidoc, или «косвенно» с использованием объекта класса NotesUIWorkspace (вероятно, в последнем случае сказывается эффект кэширования объекта). Метод reload функционирует только тогда, когда он был вызван в пределах того скрипта, в котором были выполнены изменения в объекте doc, «прямо или косвенно связанном» с объектом uidoc. Если же метод reload был вызван за пределами того скрипта, в котором были выполнены изменения в объекте doc, метод не функционирует (вероятно, при выходе из скрипта все выполненные в объекте doc изменения просто теряются).
Сбойство EditMode - «режим документа в интерфейсе пользователя»
flag = notesUIDocument.JLditMode notesUIDocument.EdiiMode = flag
Позволяет выяснить или изменить режим документа в интерфейсе пользователя (редактирование или просмотр). Значение flag = true соответствует режиму редактирования, а false - режиму просмотра.
© InterTrust Co. Тел. (095) 9567928
726 Встроенные классы LotusScript и Java
Свойство FieldHelp - «режим отображения подсказки по полям»
flag = notesUIDocument.T?Kl<№elp notes UIDocument.TFieldHLelp -flag
Позволяет выяснить или изменить режим отображения подсказки по редактируемым полям документа в интерфейсе пользователя. Если flag true, то подсказка отображается, если false - нет. Установить же это свойство можно только тогда, когда документ находится в режиме редактирования.
Свойство HiddenChars - «режим отображения скрытых символов»
flag notes UIDocument.TtliddenC bars notesUIDocument.HiddenChars =flag
Позволяет выяснить или изменить режим отображения скрытых символов в документе (см. пункт меню View - Show - Hidden Characters, символы «видны» только в полях типа RichText). Если flag = true, то скрытые символы отображаются, если false - нет. Установить это свойство можно только тогда, когда документ находится в режиме редактирования.
Свойство HorzScrolffiar - «режим отображения горизонтальной полосы прокрутки»
flag = notesUIDocument.HorzScro\\E&r notes UIDocument.tiorzScrollBar -flag
Позволяет выяснить или изменить режим отображения горизонтальной полосы прокрутки. Если^7аЈ = true, то горизонтальная полоса прокрутки отображаются, если false -нет.
Свойство Ruler - «режим отображения линейки форматирования»
flag - notes UIDocument.Ruler notesUIDocument.Ruler=flag

Позволяет выяснять и изменять режим отображения линейки форматирования. Если flag = true, то линейка отображается, если false - нет. Устанавливать это свойство можно, если только документ находится в режиме редактирования.
Свойство PreviewDocLInk - «режим отображения панели предпоказа DocLink-ов»
flag = notes UIDocument.PreviewQocLink notesUIDocument.Previev/DocLink flag
Позволяет выяснять и изменять режим отображения панели предпоказа DocLink-ов из документа в интерфейсе пользователя. Если flag - true, то панель отображается, если false -нет. Если документ вообще не содержит DocLink-ов на другие документы, панель предпоказа остается пустой.
Свойство PreviewParentDoc - «отображения панели предпоказа
родительского документа»
flag = notesUIDocument.PrevietwPureniDoc © InterTrust Co. Тел. (095) 9567928
Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 727
notesUIDocument.PreviewParentDoc --flag
Позволяет выяснять и изменять режим отображения панели предпоказа родительского документа для находящегося в интерфейсе пользователя документа-ответа. Если flag = true, то панель отображается, если false - нет. Если документ не имеет родителя (он сам главный документ), панель предпоказа остается пустой.
Свойство CurrentFieJd - «текущее поле документа»
fieldNameS ~ notesUIDocument.CurreniField
Если документ находится в режиме редактирования, возвращается имя поля (тип String), в котором в настоящее время находится курсор, В режиме чтения всегда возвращается пустая
строка (""). .. ?,
Свойство WindowTitle - «заголовок окна»
title$ = notesUIDocument.WindowTitle :
Позволяет получить заголовок окна (тип String), отображающего текущий документ в интерфейсе пользователя.
Свойство DialogBoxCanceled - «Как пользователь закрыл диалоговое окно»
flag = notesUIDocnment.'DlsilogBoTiCanceleu
Возвращает true, если пользователь закрыл диалоговое окно кнопкой Cancel или клавишей Esc, или false, если кнопкой Ok. Воспользоваться этим свойством можно в обработчике события QueryCIose той формы, по которой в диалоговом окне отображается документ. :. ...;.- ,_.-. , : . ; ... . .,-;.,- .. , . . ,; , >. -: . .
Свойство InPreviewPane - «отображается ли на панели предпоказа»
flag- notesUIDocument.lKPreviev/Ряпе ...
Возвращает true, если документ отображается на панели предпоказа (в виде), или false, если документ «полнофункционально» открыт пользователем. ...
Пример. Документ должен автоматически переводиться в режим редактирования, но за исключением случая, когда он отображается на панели предпоказа. Это реализуется скриптом обработки события PostOpen в форме.
Sub Postopen(Source As Notesuidocument) ...-.;.,.
If Not source. InPreviewPane Then ' "'-H
*;/ source. EditMode = True ' "
.' End If ..,...:-- :.-;.. , -'.-.
End Sub .. . , ., ...-..; ;. -.,....,: . . . : v
3.37.2. Методы
Метод clear - «очистить блок без переноса в буфер обмена» Call notesUIDocument.clear
Если документ в интерфейсе пользователя находится в режиме редактирования и в нем выделен блок (фрагмент текста, графики и пр. в пределах одного редактируемого поля), содержимое блока очищается. Содержимое блока не заносится в буфер обмена - такое делает
© InterTrust Co. Тел. (095) 9567928
728 Встроенные классы LotusScript и Java
метод cut. Если выделенный блок отсутствует, будет получено сообщение об ошибке "Document command is not available".
Метод cut - «очистить блок с переносом в буфер обмена» Call notesUIDocument.cnt
Подобен методу clear, но переносит выделенный блок в буфер обмена (естественно, перекрывая при этом предыдущее содержимое буфера).
Метод сору - «скопировать блок в буфер обмена»
Call notesUIDocument.copy
Подобен методу cut, но не удаляет выделенного блока из редактируемого поля.
Метод paste - «вставить содержимое буфера обмена» Call notes UIDocument.p&ste .
Вставляет содержимое буфера обмена с текущей позиции курсора в редактируемое поле документа, который, очевидно, находится в режиме редактирования.
Метод selectAIi - «выделить содержимое поля или документа» Call n otes UIDocument.select All
Если документ в режиме редактирования, метод «выделяет» все содержимое текущего редактируемого поля. Если же текущее поле пустое, возникает ошибка: "Document command is not available". Если документ в режиме просмотра, «выделяется» все содержимое документа.
Метод deselectAIl - «убрать выделение блока» Call notes UIDocument.deselectAll
«Снимает выделение» блока в документе. Если ничего не было выделено, возникает ошибка "Document command is not available".
Метод expandAHSections - «раскрыть все секции» Call notesUIDocument.expandAllSections
Раскрывает все секции (определенные как в форме, так и в полях типа RichText) документа, находящегося в интерфейсе пользователя, причем независимо от того, в каком состоянии каждая их этих секций перед этим находилась.
Метод coIlapseAHSections - «свернуть все секции» Call notes UIDocument.collapseAllSections
Напротив, сворачивает все секции (как определенные в форме, так и в полях типа RichText) документа, находящегося в интерфейсе пользователя, независимо от того, в каком состоянии каждая их этих секций перед этим находилась.
© InterTrust Со. Тел. (095) 9567928
730 Встроенные классы LotusScript и Java
возвращается все значения, «разделенные» выбранным в свойствах поля разделителем для отображения информации. Документ может находиться как в режиме редактирования, так и в режиме просмотра.
© Метод getSelectedText - «получить выделенный текст»
text$ = notesUIDocument.getSelectedTe\t([fieldName$\)
Возвращает текст, который был выделен пользователем в поле или документе.
Параметр fieldName$ (тип String) - необязательное имя поля, содержащего выделенный
текст.
Пример. Скрипт акции в форме копирует выделенный текст из любого поля (в частности, и из поля типа RichText, пропуская при этом «нетекстовые» элементы) в поле Subject типа Text.
Sub Click(Source As Button)
Dim workspace As New NotesUIWorkspace
Dim uidoc As NotesUIDocument
Dim text As String
Set uidoc = workspace.CurrentDocument
text = uidoc.GetSelectedText
Call uidoc.fieldSetText( "Subject", text) End Sub
Метод fieldSetText - «присвоить полю текстовое значение» Call notesUIDocument.fieldSetText(fieldName$ , textValue$ )
Присваивает содержимое textValue$ (тип String) полю с именем fieldName$ (тип String). Если в качестве параметра fieldName$ задана пустая строка (""), значение присваивается текущему полю. Для полей не текстового типа предпринимается попытка выполнить преобразование содержимого textValtte$ к соответствующему типу, но уже при сохранении документа (точнее, в момент пересчета значений полей). Для «списковых» полей значения элементов списка должны задаваться в строке textValue$ «через разделитель», выбранный в свойствах поля в качестве разделителя для ввода информации. Метод допустим только в режиме редактирования, иначе будет получена ошибка "You must be in edit mode to change the value of a field".
Метод fieldAppendText - «добавить в поле текстовое значение» Call notesUIDocument.fieldA.ppendTen.t(fieldName$ , text$ )
Добавляет текст text$ (тип String) в редактируемое текстовое поле с именем fieldName$ (тип String) в документе. Получаемое значение в поле - конкатенация (сцепление) строк прежнего значения и добавленного текста. Пустая строка ("") в качестве имени поля подразумевает добавление в текущее поле. Документ должен находиться в режиме редактирования, иначе возникает ошибка "You must be in edit mode to change the value of a field". Если поле с именем fieldName$ отсутствует в документе, возникает ошибка "Cannot locate field definition for fieldName$".
Пример 1. Скрипт кнопки извлекает имеющийся текст из поля Body, перекодирует его «латиницей» (вместо русских букв «подобно звучащие» английские) и добавляет «в конец» поля Body.
Sub Click(Source As Button)
Dim workspace As New NotesUIWorkspace Dim uidoc As NotesUIDocument Set uidoc = workspace.CurrentDocument Dim si, so, с As String
©InterTrust Co. Тел. (095) 9567928
Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 731
Call uidoc.GotoField("Body")
si = uidoc. FieldGetText ("Body") " .'. :
For i=l To Len(si) " ': '" ''
с - Mid(si, i, 1)
Select Case с '
Case "A" so=so+"A" "
Case "a" so=so+"a" " '"'- ' ' :
Case "Б" so=so+"B" : '- "''-' ' '
Case "6" so=so+"b" '
Case "B" so=so+"W" ' ' "
Case "в" so=so+"w" -.-.--.
Case "Г" so=so+"G" "
Case "t" so=so+';g" " ' :'
Case Else: so=so+c End Select Next
Call uidoc.FieldAppendText( "Body", so ) End Sub
Пример 2. Когда пользователь сохраняет документ, возникает событие Query Save, и его скрипт добавляет текущую дату, имя пользователя и содержимое поля Event в поле Log и очищает содержимое поля Event.
Sub Querysave(Source As Notesuidocument, Continue As Variant)
Dim session As
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
· Метод import - «импортировать файл в поле типа RichText» Call notesUIDocument.lmpart( [JilterS ] [, filenames ] )
Выполняет импорт файла «в позицию» курсора в поле типа RichText документа, находящегося в режиме редактирования.
.... Параметр filter$ (тип String) - тип фильтра, используемого для импорта файла. Должен содержать то же самое, что можно выбрать в окне File Import. Если параметр опущен, метод выводит диалоговое окно File Import, предоставляя пользователю возможность осуществить выбор.
Параметр filename$ (тип String) - путь и имя импортируемого файла.
Пример. Предположим, что в документах некоторой базы в поле Body типа RichText имеются присоединенные файлы, содержащие изображения распространенных графических форматов. Необходимо импортировать эти изображения из присоединенных файлов непосредственно в поле Body. Следующий агент, запускаемый в интерфейсе клиента Notes, обрабатывает отмеченные пользователем документы из вида. Если документ содержит поле Body и в нем есть присоединенный файл, этот файл «отцепляется» во временный каталог и удаляется из поля Body. Затем документ переводится в режим редактирования, «отцепленный» файл импортируется в поле Body и документ снова сохраняется. Отметим, что агент был написан и протестирован в расчете на случай, когда в поле Body имеется только один присоединенный файл. . ,- -.--. .'-"_ ,
Sub Initialize ". '' ' ' " "' " '
Dim fn As String ' ..
Dim filter As String
© InterTrust Co. Тел. (095) 9567928
732 Встроенные классы LotusScript и Java
Dim workspace As New NotesUIWorkspace Dim uidoc As NotesUIDocument Dim doc As NotesDocument Dim session As New NotesSession Dim db As NotesDatabase
Dim collection As NotesDocumentCollection Set db = session.currentDatabase Set collection = db.UnprocessedDocuments For j = 1 To collection.Count Set doc = collection.getNthDocument( j ) Set rtitem = doc.GetFirstltem( "Body" ) If ( rtitem.Type = RICHTEXT ) Then Forall о In rtitem.EmbeddedObjects If ( o.Type = EMBED_ATTACHMENT ) Then fn = "c:\" & o.Source
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·End Sub
Метод fieldContains - «содержит ли поле заданное значение»
flag = notesUIDocument.fieldC(mtains(fieldName$ , textValue$ ) ,
Когда документ находится в режиме редактирования, метод проверяет, содержит ли текстовое редактируемое поле с именем fieldName$ (тип String) заданное значение textValue$ (тип String). Если содержит, возвращает true, иначе false. Задание пустой строки в качестве имени поля подразумевает проверку содержимого текущего поля.
> Метод fmdString - «найти текст в поле или документе»
Call notesUIDocument.findString( text$ [, wholeword] [, backwards ] [, caseSensitive ]
[, wildcards ] [, accentSensitive ] [, searchDocument ] [,JindNext ] [, wrapAround]
[, ignoreDiacritics ])
Подобно выбору в интерфейсе клиента пункта меню Edit - Find или нажатию клавишной комбинации Ctrl-F или Ctrl-G, метод выполняет поиск текста, заданного параметром text$ (тип String). Если документ находится в режиме просмотра, поиск выполняется во всем документе, если в режиме редактирования - только в пределах текущего редактируемого поля (в котором находится курсор). Остальные параметры метода задают дополнительные поисковые опции (см. Рис. 3.44).
© InterTrust Co. Тел. (095) 9567928
Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 733

Рис. 3.44 Окно Find Text
Если параметр wholeword равен true (это значение по умолчанию), выполняется поиск «целого слова» (аналог опции Match on entire word). Если параметр backwards равен true (no умолчанию false), поиск выполняется «по направлению к началу документа» (аналог опции Find backward). Если параметр caseSensitive равен true (по умолчанию false), поиск выполняется «с учетом регистра» (аналог опции Case sensitive). Если параметр wildcards равен true (по умолчанию false), то символы «*» и «?» в строке text$ рассматриваются как шаблоны для поиска любых символов. Если параметр accentSensitive равен true (по умолчанию false), поиск выполняется с учетом диакритических знаков (аналог опции Accent sensitive; accent, диакритический знак - знак, который в ряде языков ставится над буквой, ниже буквы или «пересекает» букву для того, чтобы обозначить ее особое звучание). Если параметр searchDocument равен true (значение по умолчанию), поиск выполняется в текущем документе. Если параметр findNext равен true (значение по умолчанию), выполняется поиск «следующего вхождения» (аналог кнопки Find Next). Если параметр wrapAround равен true (по умолчанию false), при поиске учитываются возможные переносы в словах (аналог опции Wrap around). Если параметр ignoreDiacritics равен true (по умолчанию false), при поиске игнорируются диакритические знаки.
Пример. Скрипт акции в форме выполняет поиск текста, который вводится пользователь.
Sub Click(Source As Button)
Dim workspace As New NotesUIWorkspace "* " ' '.""'
Dim uidoc As NotesUIDocument . .-...-.
Set uidoc = workspace.CurrentDocument
Call uidoc.FindString(Inputbox$("Word or phrase to look for:")) End Sub
® Метод findFreeTimeDialog - «поиск возможного времени для проведения мероприятия»
flag wofest//DocMme«/.fmdFreeTimeDia!og( reqPeopleltems, optPeopleltems, reqRoomsItemS) optRoomsItems, reqResourcesltems, optResourcesItems, removedPeopleltems, startDateltem, endDateltem )
Выводит диалоговое окно Find Free Time для поиска возможного времени для проведения некоторого мероприятия («встречи»).
© InterTrust Co. Тел. (095) 9567928
734 Встроенные классы LotusScript u Java
Параметры reqPeopleltems и optPeopleltems (оба типа String) - имена полей из текущего документа, в которых содержатся имена тех, кто должен (reqPeopleltems) или «необязательно может» (optPeopleltems) присутствовать на мероприятии.
Параметры reqRoomsItems и optRoomsItems (оба типа String) - имена полей из текущего документа, в которых содержатся названия помещений, в которых должно (reqRoomsItems) или «необязательно может» (optRoomsItems) произойти мероприятие.
Параметры reqResourcesItems и optResourcesItems (оба типа String) - имена полей из текущего документа, в которых содержатся названия иных ресурсов, необходимых (reqResourcesItems) или «желательных, но не необходимых» (optResourcesItems) для проведения мероприятия.
Параметр removedPeopleltems (тип String) - имя поля из текущего документа, в котором содержатся имена тех, кто должен быть исключен из списка участников мероприятия.
Параметры startDatetime и endDateTime (оба типа String) - имена полей типа Time из текущего документа, в которых содержатся соответственно время начала и время завершения мероприятия. Время начала должно быть меньше времени окончания, а отрезок времени проведения мероприятия не должен включать «полночь».
Возвращаемое значение flag равно true, если пользователь завершит этот диалог кнопкой ОК, или false, если кнопкой Cancel. Это и есть нововведение версии 5.0 - в предыдущих версиях метод ничего не возвращал.
Пример. Скрипт выводит диалог Find Free Time для лиц, перечисленных в поле SendTo, начиная со времени, содержащегося в поле StartDateTime и продолжающегося до времени, содержащегося в поле EndDateTime.
Sub Click(Source As Button)
Dim workspace As New NotesUIWorkspace
Dim uidoc As NotesUIDocument
Set uidoc = workspace.CurrentDocument
Call uidoc.Refresh
Call uidoc.FindFreeTimeDialog _
("SendTo", "", "", "", "", "", "", "StartDateTime","EndDateTime") End Sub
© Метод findFreeTinieDialogEx - «поиск возможного времени для проведения мероприятия»
flag = notesUIDocument.unAҐreeTimeDi»logETi( reqPeopleltems, optPeopleltems, reqRoomsItems, optRoomsItems, reqResourcesItems, optResourcesItems, removedPeopleltems, startDateltem, endDateltem)
Аналогично методу fmdFreeTimeDialog, выводит диалоговое окно Find Free Time для поиска возможного времени для проведения некоторого мероприятия («встречи»). Отличие в том, что все параметры, кроме startDateltem и endDateltem, должны быть массивами строк (Array of Strings), содержащими имена полей, а не строками.
Пример. Скрипт выводит диалог Find Free Time для лиц, перечисленных в полях Name! и Name2, начиная со времени, содержащегося в поле StartDateTime и продолжающегося до времени, содержащегося в поле EndDateTime.
Dim workspace As New NotesUIWorkspace
Dim uidoc As NotesUIDocument
Set uidoc = workspace.CurrentDocument
Call uidoc.Refresh
Dim reqPeople(2) As String
© InterTrust Co. Тел. (095) 9567928
Lotus Domino R. 5: @-форл1улы, LotusScript, встроенные классы LotusScript ч Java 735
reqPeople (0) = "Nam.el"... ,. -;'<;..; , „,,, ' :,-'^« >,-;:- ,f ,.--,.,. V. : ., -.-.,,. . , "'"''>
reqPeople(l)="Name2"
Call uidoc.FindFreeTimeDialogEx _
{reqPeople, "", "", "", "", "", "", "StartDateTime", "EndDateTime")
Метод createObject - «создать OLE-объект в Поле типа RichText»
handleV- notesUIDocument.createQbiect( [ name$ [, type$ [ ,filePath$ | ] ] )
Когда документ из рабочего пространства находится в режиме редактирования, а курсор расположен в редактируемом поле типа RichText, метод создает в этом поле OLE-объект. Не поддерживается на платформах OS/2, UNIX и Macintosh.
Если никакие параметры не указаны, метод выдает диалоговое окно Create Object, в котором пользователь может выбрать или тип, или файл для создания OLE-объекта. ,
Параметр пате$ (тип String) - имя, которое программист желает использовать для ссылки на OLE-объект.
Параметр type$ (тип String) - тип OLE-объекта, который программист желает создать. В названии типа различаются большие и малые буквы. Название типа должно совпадать с одним из зарегистрированных OLE-имен. Если задан параметр type$, параметр filePathS должен быть опущен. В этом случае метод создает «пустой» экземпляр OLE-объекта указанного типа.
Параметр filePath$ (тип String) - путь и имя файла, содержащего документ, который должен быть использован для создания OLE-объекта. Если задан параметр filePath$, параметр type$ должен быть задан пустой строкой (""). В этом случае тип OLE-объекта определяется по расширению файла.
Возвращаемое значение handleV(тип Variant) - дескриптор созданного OLE-объекта или Null, если OLE-объект не удалось создать.
Пример. Скрипт создает в поле Body текущего документа новый пустой «рисунок» PaintBrush. Тип OLE-объекта - PaintBrush Picture - должен быть зарегистрированным OLE-именем.
Dim workspace as New NotesUIWorkspace - .
Dim uidoc as NotesUIDocument . ..... .
Set uidoc = workspace . CurrentDocuinent
Call uidoc.GotoField( "Body" }
Call uidoc.CreateObject( "New picture", "Paintbrush Picture" )
Метод getObject - «получить дескриптор OLE-объекта»
handleV= notesUIDocument.getObjKct( name$ )
По заданному имени OLE-объекта возвращает его дескриптор или Null, если объект не найден. Описание параметра пате$ смотрите в методе createObject.
© Метод refresh - «выполнить рекалькуляцию вычисляемых полей» Call notesUlDocument.refresb( [ IncludeRichTextltems ] )
Подобно нажатию пользователем клавиши F9 (View - Refresh), выполняет пересчет вычисляемых полей (computed field's) в документе. Такое действие может иметь смысл, если некоторые вычисляемые поля зависят от значений в других, в частности, в редактируемых полях. Применим только для документа, находящегося в режиме редактирования.
Параметр IncludeRichTextltems добавлен в версии 5.0. Если он выбран равным true, происходит пересчет и вычисляемых полей типа RichText.
© InterTrust Co. Тел. (095) 9567928
736 Встроенные классы LotusScript и Java
Метод refreshHideFormuIas - «пересчитать формулы видимости абзацев формы»
Call notesUIDocument.refreshHideҐormu.las
Пересчитывает только формулы, управляющие «видимостью» отдельных параграфов (hide-when formulas) формы, по которой открыт текущий документ. Формулы других типов не пересчитываются.
Обычно метод используется, когда внешний вид формы зависит от значений в некоторых, в частности, в редактируемых полях. Однако это относительно «трудоемкая» операция, и ею не следует злоупотреблять.
Метод categorize - «категоризировать документ» Call notes UIDocument.categor\xe( [ categoryName$ ] )
Помещает документ в категорию, заданную строкой (тип String) categoryNameS. Если параметр categoryNameS опущен, пользователь получит диалоговое окно Categorize, в котором он имеет возможность выбрать нужную категорию (или сразу несколько) из списка имеющихся.
Отметим, что категоризация основана на добавлении в документ поля с именем Categories (типа текстовый список), а возможность выбора категорий из списка в диалоговом окне Categorize предполагает наличие вида, в котором первый сортированный столбец отображает значение поля Categories из отобранных документов. Если документ новый (еще не был ни разу сохранен), возвращается сообщение об ошибке: "Cannot categorize unsaved document".
Метод forward - «отправить образ документа почтой» Call notesUIDocument.forward
Подобно пункту меню Actions - Forward, создает новое почтовое сообщение с содержимым документа в поле Body. Далее уже пользователь вручную должен выбрать или ввести получателей и отправить сообщение. Документ может находиться как в режиме редактирования, так и в режиме просмотра. Метод выдает ошибку, если текущий документ еще ни разу не был сохранен в базе.
Пример. Скрипт кнопки передает (forwards) текущий документ. Если документ новый, появляется диалоговое окно с предложением сохранить документ. Если же документ не новый, из него выбирается значение поля From (пусть оно содержит адрес «первого отправителя» документа), создается почтовое сообщение - новый документ формы Memo с образом исходного документа в его поле Body, в поле Subject почтового сообщения добавляется адрес «первого отправителя» документа, курсор позиционируется на поле SendTo почтового сообщения, а окно «уже переданного» документа закрывается. Пользователю остается выбрать адрес получателя и нажать кнопку Send.
Sub Click(Source As Button)
Dim ws As New NotesUIWorkspace
Dim uidoc, fuidoc As NotesUIDocument
Dim FromAddr As String
Set uidoc = ws.CurrentDocument
If uidoc.IsNewDoc Then
Messagebox( "Сначала сохраните документ!") Else
FromAddr = uidoc.fieldGetText("From")
Call uidoc.Forward
Set fuidoc = ws.CurrentDocument
Call fuidoc.fieldAppendText("Subject", " [From: " & FromAddr & " ]")
© InterTrust Co. Тел. (095) 9567928
Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java
737
Call fuidoc.gotoField("SendTo") . . , -_.,.., f;i:: .. -. : ., „ .,- Call uidoc. Close . ....-..
End If . . ...'>' . "' ' - -""'-
End Sub .., . ... . ,-. ',. .
"' ',''"'.- ' ' ' * '
Метод send - «отправить документ почтой» Call notesUIDocument.send
Отправляет документ по почте. В документе должно присутствовать, как минимум, поле SendTo, содержащее список получателей. Кроме того, на отправку документа оказывают влияние поля Copy To, BiindCopyTo, DeliveryPriority, DeliveryReport, ReturnReceipt и др.
Пример. Поле Status документа может содержать одно из трех значений: "New" (новый документ), "Approved" (согласовано) или "Rejected" (отвергнуто). Скрипт события Querysave (оно возникает при попытке сохранить документ) дополнительно отправляет копию этого документа почтой в почтовую базу по адресу, который выбирается в зависимости от значения поля Status.
Sub Querysave(Source As Notesuldocument, Continue As Variant) s = source. FieldGetText ( "Status" ) .. ........ .ч.Д. '.,,.'.
Select Case s -.....-.-.
Case "New" : -.... ---...- v... -:,,,- - - .
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·Метод print - «напечатать документ»
Call notesUIDocument.print
Call notes WDocument.print(numCopies% ,fromPage%, toPage% , draft) , .,...,,, .,,,
Печатает текущий документ:

Рис. 3.45 Окно Print
если не указано ни одного параметра, выдает диалоговое окно Print, информацию в котором пользователь может изменить перед печатью; - = . '.->
если указан хотя бы один параметр, начинает печать сразу, без диалога с пользователем.
) InterTrust Co. Тел. (095) 9567928
738 Встроенные классы LotusScript и Java
Параметр numCopies% (тип Integer) - количество копий. Если параметр опущен, печатается одна копия.
Параметр fromPage% (тип Integer) - номер страницы, с которой должна начаться печать документа. Если параметр опущен, печать начинается с первой страницы.
Параметр toPage% (тип Integer) - номер страницы, до которой включительно должна выполняться печать документа. Если параметр опущен, печать продолжается до конца документа.
Если параметр draft равен true, печать выполняется в черновом режиме (Draft quality).
Метод reload -« документ в интерфейсе пользователя в
соответствие с к„„.„*«..п*жмми в связанном с ним объекте NotesDocument»
Call notes UIDocument.reload
Приводит документ в интерфейсе пользователя в соответствие с изменениями, которые могли произойти в связанном с ним объекте класса NotesDocument в ходе выполнения скрипта, содержащего вызов метода reload. Применим только для документа, находящегося в режиме редактирования. Имеет смысл, когда свойство AutoReload равно false. Изменения в полях (кроме полей типа RichText) в документе из интерфейса пользователя и соответствующие изменения на экране произойдут сразу по окончании работы метода.
Правильное использование метода - в пределах одного скрипта «отключить» свойство AutoReload, затем внести изменения в поля объекта NotesDocument, связанного с документом в интерфейсе пользователя, и вызвать метод reload для того, чтобы сразу отобразить все выполненные изменения на экране. Для получения дополнительной информацией обратитесь к описанию свойства AutoReload.
© Метод spellCheck - «выполнить проверку правописания» Call notes UIDocument.spellCbecli()
Стартует процесс проверки правописания в находящемся в режиме редактирования документе.
~
Метод save - «сохранить документ в базе» Call notesUIDocument.sa.ve
Сохраняет документ из интерфейса пользователя в базе. Применим только к документу, находящемуся в режиме редактирования.
Метод saveNewVersion - «сохранить новую версию документа» Call notes UIDocumenLsaveNewVersion
Сохраняет документ из интерфейса пользователя в базе как новую версию документа. Применим только для документа, находящегося в режиме редактирования.
Для использования этого метода форма документа должна иметь одну из опций создания версий (Versioning):
New versions become responses - новая версия становится ответным документом;
Prior versions become responses - предыдущая версия становится ответным документом;
New versions become siblings - новая версия должна остаться на том же уровне, что и предыдущая.
© InterTrust Со. Тел. (095)9567928
Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 739
Если же для формы выбрана опция создания версий None (нет), метод выдает сообщение: "Document command is unavailable".
Кроме того для формы должна быть установлена опция создания версий (Create versions) по управлению пользователем - командой меню File - Save New Version. Если же опция Create versions установлена на автоматическое создание версий, новая версия документа в базе будет автоматически создаваться при сохранении документа методом save, так что в этой ситуации использование метода saveNewVersion потеряет смысл.

Comment Comment
Type i , -ь> т Type ' , 'Л -г
' , " indudrt in 1'iuriU i , '<'!" fi vij
Duple1' ' Disphy
I > Include i,", oeaich Bu'lde1
' V'efsiorung ^!-v- 'u^oii* become (espouse; »
Ver I Versions , JHESBRHL..
: Create versions iManu» - f яел New Vetsjon > "*"
j .-:„,«„..If''^=.1 ,.„ i,
i
Option*. , Ofrfij
I
i
, : : 1
Рис. З.4. Опции создания версий в свойствах формы
Метод deleteDocument - «удалить документ» Call notes UIDocument.deleteDocument
Отмечает документ как подлежащий удалению и закрывает его. Объект класса NotesUIDocument становится после этого недоступным. Сам документ, однако, не удаляется из базы до тех пор, пока пользователь не обновит вид или не закроет базу, подтвердив удаление в появившемся при этом диалоговом окне. Если текущий документ уже отмечен для удаления, метод только закрывает этот документ, оставляя отметку удаления («корзинка») на своем месте. Отмечаемый к удалению документ не должен находится в режиме редактирования, иначе возникает ошибка "Document command is not available". Если объект класса NotesUIDocument пытаются использоваться «после удаления», возникает ошибка "NotesUIDocumentWnd is no longer valid".
Пример. Скрипт кнопки отмечает документ как подлежащий удалению и закрывает его. Если документ в режиме редактирования, скрипт ничего не делает - иначе будет ошибка.
Sub Click(Source As Button)
Dim workspace As New NotesUIWorkspace
Dim uidoc As NotesUIDocument
Set uidoc = workspace.CurrentDocument
If Not ( uidoc.EditMode ) Then Call uidoc.DeleteDocument
End If '
End Sub
© InterTrust Co. Тел. (095) 9567928
740 Встроенные классы LotusScript и Java
Метод close - «закрыть окно документа» Call notesUIDocument.close
Закрывает окно документа в интерфейсе пользователя. После этого действия объект класса NotesUIDocument становится недоступным. Если пользователь перед этим редактировал и изменил документ1, перед закрытием появляется диалоговое окно с запросом на сохранение внесенных изменений.
Методы navBarSetText, navBarSpinnerStart, navBarSpinnerStop -«отображение состояния объекта Internet Explorer browser в клиенте Notes»
Call notesUIDocument.n&\'EarSetText( urltext$ , windowTitleS )
Call notesUIDocument,n'dvBarSpinnerStart( )
Call notesUIDocument.nmBarSpinnerStop() ;
Методы используются для отображения состояния объекта Internet Explorer browser в интерфейсе клиента Notes.
...-: > -
Метод navBarSetText помещает в Navigator bar клиента Notes универсальный указатель ресурса, заданный параметром urltextS (тип String), и устанавливает заголовок окна, заданный параметром windowTitle$ (тип String).
Метод navBarSpinnerStart стартует «перемещение звездочки» по надписи Notes в правом верхнем углу окна клиента Notes, а метод navBarSpinnerStart останавливает «перемещение этой звездочки».
Пример. Некоторая «загадочность» рассматриваемых методов требует примера их применения. Однако при рассмотрении вы обнаружите, что в примере затрагиваются более серьезные вопросы -разработка форм, содержащих OLE Control объекты для просмотра HTML-страниц.
Изготовим форму BrowserForm, в которой определены три глобальные переменные, скрипт события PostOpen, три кнопки акций и один OLE-объект - Internet Explorer browser.
' (Globals)BrowserForm - Declarations Dim ws As notesuiworkspace Dim uidoc As notesuidocutnent Dim browserobject As Variant
»
' Скрипт события Postopen (инициализация глобальных переменных) Sub Postopen(Source As Notesuidocument)
Set w = New notesuiworkspace
Set uidoc=w. currentdocuinent
Set browserobject=uidoc.GetObject("Browser") End Sub
' Скрипт кнопки акции Navigate (загрузить страницу) Sub C.lick(Source As Button)
Dim URL As String
URL=Inputbox$("URL:", "Navigate to URL")
If URL <> "" Then
browserobj ect.Navigate(URL)
End If End Sub
1 Скрипт кнопки акции GoBack (предыдущая страница) Sub Click(Source As Button)
browserobject.GoBack End Sub
© InterTrust Co. Тел. (095) 9567928
Lotus Domino R. S: @гформулы, LotusScript, встроенные классы LotusScript и Java 741
''" ' ' ;л ^*;rv uv' * i
'''' -..- - . _ J i ,
' Скрипт кнопки акции Go Forward (следующая страница): , Sub Click(Source As Button) browserobject.GoForward End Sub ,
OLE-объект Internet Explorer browser должен обеспечивать возможность получения и отображения HTML-страниц. Используем в качестве него OLE Control Microsoft Web Browser (Рис. 3.46). В свойствах объекта выберем опции Size object to window (чтобы объект занимал все окно документа), Run object when reading document и для краткости изменим его имя на «Browser». ;

. tteatenew. - I of"" J
<~ fibjecl (? ё«*ol : !
C»vei I <" ОЬДО from elite '" iavaBean -~ -J
inserts a new Microsoft Vv'eh Btomet control into your document

:,' Ki- Microsoft TreeView Control, version 5.0 j
,. l^-MictpsqftUpPgwriControl version 5.0 |
Г ' КЗ|||ДД|||Д , "" Siie оцвсПо fit vvinduvJ
K;»-RoveBvr Class , 5|ге <5bp fiWecl helnw liplri
jsi. . ._ . _ . ; jiac ucaect oeiuvv нею
KVMS InvestoM i&ket J^J
Bemove Control from List 1 Location: CAWINNTVSystert!324SHDQCVW.DU. j t' Run object (when rearing dooumeni
^, , _*„„л j Options
ёddCi. ' Update ob|ect trorn document
Puc. 3.46 Вставка объекта Microsoft Web Browser в форму , . ,
Для объекта определим три события. Событие Titlechange возникает в объекте Browser, когда объект получает URL очередной HTML-страницы - в этот момент в интерфейсе клиента Notes должен измениться Navigator bar и заголовок окна, подсказывая пользователю, какая страница отображается в окне. Событие Downloadbegin возникает в объекте Browser, когда начинается процесс загрузки HTML-страницы в объект - в этот момент в интерфейсе клиента Notes в правом верхнем углу по надписи Notes
«должна побежать звездочка» &зЭЙ^ИЩ.:, подсказывая пользователю, что начался процесс загрузки страницы. Событие Downloadcomplete возникает в объекте Browser, когда процесс загрузки HTML- страницы в объект завершился - в этот момент в интерфейсе клиента Notes в правом верхнем углу по надписи Notes «звездочка должна прекратить свой бег», подсказывая пользователю, что страница загружена. .
' Скрипт события Titlechange объекта Browser
Sub Titlechange(Source As Webbrowser, Tex_ As String)
Dim NavBarURL As String ' Узнаем текущий URL объекта Browser
NavBarURL = browserobject.LocationURL ' Заносим его в Navigator bar и заголовок окна
Call uidoc.NavBarSetText(NavBarURL, NavBarURL) End Sub
1 Скрипт события Downloadbegin объекта Browser Sub Downloadbegin(Source As Webbrowser} uidoo.Navbarspinnerstart
End Sub
1 Скрипт события Downloadcomplete объекта Browser Sub Downloadcomplete(Source As Webbrowser) uidoc.Navbarspinnerstop
End Sub
© InterTrust Co. Тел. (095) 9567928
742 Встроенные классы LotusScript и Java Л ., »

.ijes - Aii Documents " |_j httpv'/w
^ВШШШёМ яш^у-у^*Ш1рШ _
aj co^T^ i ^^^^^^^^ЛЦ99
- Cz^^ /--Z-- (.r^^m mm mm
Ri Ммйш»8 ^"^ v ^"^ %F\vmm
.^, Eifiii'icts '
Jep T . _ . »»-Notes and Domino R5 add COM support
as, Tech Support ..,,,„„„. , ,
.ci „4 oomino Workflow 2.0 introduced VJ
i How to Buy i i i t,1
I "- ' ™-*~-« _..JL.I !"f. i TiT.-ri-m.-mj.i-щцц J--n-Tr.TV.-irr.i-.-.i.-ji -. -.-.|-.'.г.Г" г-j.-|- UJ- -.--.-inrrtrnT-mn-
i "J^ "fflone} <д_ ..._....„, .... ..
Рис. 3.47 Внешний вид «документа» по этой форме в клиенте Notes
3.37.3. События
Событие QueryOpen - «перед открытием документа»
QueryOpen( Source as NotesUIDocument, Mode as Integer, - ''<
IsNewDoc as Variant, Continue as Variant) Возникает при попытке открыть текущий документ, перед его «открытием».
Аргумент Source (объект класса NotesUIDocument, только чтение) представляет текущий документ в интерфейсе пользователя. Если значение аргумента Mode (тип Integer, только чтение) равно 0, пользователь пытается открыть документ в режиме чтения, если равно 1 - в режиме редактирования. Если значение аргумента IsNewDoc (только чтение) равно true, пользователь пытается создать новый документ, если равно false - открыть существующий документ. Аргумент Continue (чтение и установка, исходно равен true) позволяет программисту разрешить (если он «не изменит или установит» аргумент в true) или запретить (если он установит аргумент в false) открывать этот документ.
Пример 1. Скрипт «запрещает» создавать новые документы.
Sub Queryopen(Source As Notesuidocument, Mode As Integer, _
Isnewdoc As Variant, Continue As Variant) If IsNewDoc Then , '
Messagebox ( "Нельзя создавать новые документы!" ) continue = False End I f End Sub
Пример 2, Скрипт обеспечивает, чтобы в базе в виде Setup существовало не более одного
документа.
Sub Queryopen(Source As Notesuidocument, Mode As Integer, _ > Isnewdoc As Variant, Continue As Variant) ,,:
Dim session As New NotesSession , , ,. -. ^,.:---
Dim db As NotesDatabase . . , ..-..,,.
Dim view As NotesView ,
© InterTrust Co. Тел. (095) 9567928
Lotus Domino R. 5: ©-формулы, LotusScript, встроенные классы LotusScript и Java 743
Dim doc As Notes Document . - - ' '
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
Пример З. Скрипт проверяет, назначен ли текущий пользователь на роль Supervisor. Если да, пользователь может открыть документ. Если пользователь не назначен на эту роль или вообще
отсутствует в ACL, он не сможет открыть документ.
Sub Queryopen(Source As No
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
Событие PostOpen - «после открытия документа»
PostOpen( Source as NotesUIDocumeut)
Возникает после того, как текущий документ был открыт, но перед передачей пользователю фокуса ввода. Аргумент Source - текущий документ в интерфейсе пользователя. Обычно в скрипте этого события программист выполняет проверку или установку значений полей в текущем документе.
Пример 1. Если значение поля CheckedOut равно "Yes", скрипт выводит диалоговое окно.
Sub Postopen(Source As Notesuidocument)
If ( source.FieldGetText( "CheckedOut" ) = "Yes" ) Then
Messagebox( "This document is currently checked out." ) End If
End Sub ' -
Пример 2. Скрипт «инициализирует» значение поля ProblemHistory для нового документа.
Sub Postopen(Source As Notesuidocument)
Dim dateTime As New NotesDateTime( "Today" ) If source.IsNewDoc Then
Call source.FieldSetText( "ProblemHistory", __
"Problem opened on " & dateTime.LocalTime ) End If End Sub
© InterTrust Co. Тел. (095) 9567928
744 Встроенные классы LotusScript и Java
Событие QueryModeChange - «перед изменением режима документа» QueryModeChange( Source as NotesUIDocument, Continue as Variant )
Возникает, когда пользователь пытается изменить режим документа (перейти в режим редактирования или вернуться в режим чтения), но перед изменением режима.
Аргумент Source - текущий документ в интерфейсе пользователя. Аргумент Continue (чтение и установка, исходно равен true) позволяет программисту разрешить (если он установит аргумент в true) или запретить (если он установит аргумент в false) изменять режим этого документа. Определить текущий режим документа программист всегда может свойством EditMode объекта Source.
Пример. Если в поле Status документа содержится "Closed" и документ находится в режиме просмотра, скрипт события предотвращает перевод документа в режим редактирования.
Sub Querymodechange(Source As Notesuidocumerit, Continue As Variant) If Not ( source.EditMode ) Then
current-Status = source. FieldGetText ( "Status" ) If ( currentStatus = "Closed" ) Then
Messagebox ( "Document available tor browsing only." } continue = Enalse End If End If End Sub
Событие PostModeChange - «после изменения режима документа»
FostModeChange( Source as NotesUIDocument)
Возникает после того, как режим документа (чтение или редактирование) был изменен, но перед передачей пользователю фокуса ввода. Аргумент Source - текущий документ в интерфейсе пользователя. Определить текущий режим документа (это уже «новый» режим) программист может свойством EditMode объекта Source-Пример. Скрипт добавляет текст в поле ProblemHistory всякий раз, когда пользователь переводит документ из режима просмотра в режим редактирования.
Sub Postmodechange(Source As Notesuidocument) Dim dateTime As New NotesDateTime( "Today" ) If source.EditMode Then
Call source.FieldAppendText ( "ProblemHistory", _ "Problem edited on " & dateTime.LocalTime ) End If End Sub - ' ,
Событие PostRecalc - «после рекалькуляции полей»
PostRecaIc( Source as NotesUIDocument)
Возникает после того, как документ был пересчитан, т.е. после того, как все формулы полей в документе были выполнены. Аргумент Source - текущий документ в интерфейсе пользователя.
Пример. После каждого пересчета полей документа скрипт проверяет значение поля city и, в зависимости от него, изменяет значение поля address.
Sub Postrecalc(Source As Notesuidocument) Dim location As String
location = source.FieldGetText( "city" ) Select Case location
© InterTrust Co. Тел. (095) 9567928
Lotus Domino R. 5: @гформулы, LotusScript, встроенные классы LotusScript и Java 745
Case "Cambridge"
Call source.FieldSetText( "address", "5 Memorial Drive" ) Case "Chicago"
Call source.FieldSetText( "address", "44 Diversey Blvd" ) Case "Paris"
Call source.FieldSetText( "address", "32 Rue Henri IV" } End Select End Sub
Событие QuerySave - «перед сохранением документа» QuerySave( Source as NotesUIDocument, Continue as Variant)
Возникает при попытке сохранить документ в базе, но перед сохранением. Причиной может быть как попытка только сохранить документ (подобно File - Save), так и попытка закрыть измененный документ (подобно File - Close).
Учтите, что событие возникает до того, как в процессе сохранения документа начнется пересчет полей, в частности выполнение формул трансляции и проверки ввода (input translation и validation) в полях. Поэтому, если уже в событии QuerySave необходимо, чтобы данные формулы отработали (поскольку в полях, заполненных пользователем, в момент возникновения события могут быть некорректные или «не оттранслированные» значения), следует в скрипте события QuerySave явно вызвать метод refresh для объекта Source.
Аргумент Source - текущий документ в интерфейсе пользователя. Аргумент Continue (чтение и установка, исходно равен true) позволяет программисту разрешить (если он установит аргумент в true) или запретить (если он установит аргумент в false) сохранение документа. Если событие QuerySave возникло при попытке закрыть документ, установка Continue в false предотвратит как сохранение, так и закрытие.
Пример 1. Скрипт предотвращает сохранение документа с незаполненным полем Title. Это действие подобно использованию функции @Failure в формуле проверки ввода.
Sub Querysave(Source As Notesuidocument, Continue As Variant) If ( source.FieldGetText( "Title" ) = "" ) Then
Messagebox( "You must enter a title for your document." ) Call source.GotoFieldt "Title" ) continue = False End If End Sub
Пример 2. В зависимости от разности значения поля dueDate (дата, до которой должен быть оплачен счет) и текущей даты скрипт вычисляет значение поля статуса ProjectStatus. Можно предположить, что в базе имеется вид, категоризированный по полю ProjectStatus.
Sub Querysave(Source As Notesuidocument, Continue As Variant) Dim targetDate As String Dim todayDateTime As NotesDateTime Dim dueDateTime As NotesDateTime Dim daysLeft As Long
Set todayDateTime = New NotesDateTime( "To
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
· Тел. (095) 9567928
746 Устроенные классы LotusScript и Java
Case 6, 7:
status = "No worries" End Select.
Call source. FieldSe t'lext ( "Pro j ectStatus " , status ) End Sub
@ Событие PostSave - «после сохранения документа»
PostSave( Source as NoteslIIDocument)
Возникает после того, как документ был сохранен. Аргумент Source - текущий документ в интерфейсе пользователя.
Пример. Скрипт проверяет, содержится ли в поле Body сохраненного документа хоть какая-то текстовая информация, и, если не содержится, «предупреждает» об этом пользователя и устанавливает курсор в поле Body.
Sub PostSave(Source As NotesUIDocument)
If(Source.FieldGetText("Body") = "") Then
Messagebox("Document must contain body text.") Call source.GotoField("Body") End If End Sub
Событие QueryClose - «перед закрытием документа» , V : ..' : ..-:.:: :.-'.'..--:: .::: ::: QueryC!ose( Source as NotesUIDoeuinent, Continue as Variant)
Возникает при попытке закрыть документ, но перед тем, как документ будет закрыт, Аргумент Source - текущий документ в интерфейсе пользователя. Аргумент Continue (чтение и установка, исходно равен true) позволяет программисту разрешить (если он установит аргумент в true) или запретить (если он установит аргумент в false) закрытие документа.
Пример. При попытке закрыть документ пользователь получит диалоговое окно с предложением отправить документ почтой. Если пользователь нажмет кнопку Yes, документ будет отправлен всем адресатам, указанным в поле SendTo документа.
Sub Queryclose(Source
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
· Тел. (095) 9567928
Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 747
3.38. «Поле в интерфейсе пользователя» - класс Field
Объект этого класса представляет редактируемое поле в форме, по которой в интерфейсе пользователя открыт документ. Объект доступен только в интерфейсе пользователя Notes, не имеет свойств и методов, а только два события.
Событие Entering - «курсор вошел в редактируемое поле»
Entering( Source as Field )
Возникает, когда курсор входит в редактируемое поле документа, находящегося в режиме редактирования. Аргумент Source - объект класса Field, в котором произошло событие.
Событие Exiting - «курсор покинул редактируемое поле» Exiting( Source as Field )
Возникает, когда курсор покидает редактируемое поле документа, находящегося в режиме редактирования. Аргумент Source - объект класса Field, в котором произошло событие.
Пример. Скрипты событий Entering и Exiting поля типа RichText обеспечивают автоматическое появление линейки форматирования при входе курсора в поле и исчезновение линейки при выходе курсора из поля.
Sub Entering(Source As Field)
Dim workspace As New NotesUIWorkspace
Dim uidoc As NotesUIDocument
Set uidoc = workspace,CurrentDocument
uidoc.Ruler = True End Sub
Sub Exiting(Source As Field)
Dim workspace As New NotesUIWorkspace
Dim uidoc As NotesUIDocument
Set uidoc = workspace.CurrentDocument
uidoc. Ruler = False ,»... End Sub
;'- ~- ' - ~~\
© InterTrust Co. Тел. (095) 9567928
748 Встроенные классы LotusScript u Java
3.39. «Кнопка в интерфейсе пользователя» - класс Button
Объект этого класса представляет акцию, кнопку или «активную площадку» (hotspot) в форме, по которой в интерфейсе пользователя открыт документ, или в поле типа RichText открытого в интерфейсе пользователя документа. Объект доступен только в интерфейсе пользователя Notes, не имеет свойств и методов, а только два события.
Событие Click - «нажатие кнопки»
CHck( Source as Button )
Возникает при «нажатии мышью» акции, кнопки или «активной площадки» (hotspot-a).
Аргумент Source - объект класса Button, в котором произошло событие.
Событие ObjectExecute - «активизация кнопки ОЬЕ2-сервером» ObjectExecute( Source as Button, Data as Variant)
Возникает, когда акция, кнопка или «активная площадка» (hotspot) активизируются ОЬЕ2-сервером или OLE custom control-ом, поддерживающим FX/Notesflow.
Аргумент Source - объект класса Button, в котором произошло событие. Аргумент Data (тип Variant) - дескриптор Dispatch/Automation-интерфейса ОЬЕ2-сервера или OLE custom control-a.
Пример. Наиболее распространенная ситуация, когда приходится столкнуться с событием ObjectExecute - использование объектов Lotus Components в формах Notes/Domino. Объекты Lotus Components как раз и представляют собой OLE custom control-ы с поддержкой FX/Notesflow.
Создадим форму, в которой будет три «вычисляемых для показа» поля Col, Row и CellValue типа Text, поле Body типа RichText и одна акция с именем "Column and row value".
JiJ "Categorize
Value p Col Т W Row "т1=К CelMaluet] "Edit Document
„„„_zz:zzz:~ """ *S end D ocurnent
К Body t\ "Forward
i _J "Move To Folder...
I Д^птоге RomFojcler ~] 1^ШВИЩЙЩ-ЙШ
-l[T_f
Рис. 3.48 Внешний вид формы в Domino Designer
Однако форма будет не столь проста, как может показаться на первый взгляд. В состав глобальных объявлений формы «включим» файлы с описанием констант Lotus Components и LotusScript (хотя действительно нужна лишь константа LC CLICK из Lotus Components).
1 (Globals)Spreadsheet - (Declarations) % INCLUDE "econsts.txt" %INCLUDE "ssconsts.txt" %INCLUDE "Isconst.lss"
Скрипт события Postopen формы будет сразу переводить документ в режим редактирования, а затем, если документ новый, создавать в поле Body новый объект с именем Sheet - «электронную таблицу» Lotus Spreadsheet Component из комплекта Lotus Components - и получать его дескриптор VSheet. Если же по форме открывается существующий документ, скрипт события Postopen будет получать дескриптор VSheet уже существующего в поле Body объекта с именем Sheet. В объекте Lotus Spreadsheet Component определен метод ActionLinkSet(EventID, EventNarne), «связывающий» действие EventID в объекте Spreadsheet с акцией EventName в объекте-контейнере. Когда такая связь определена,
© InterTrust Co. Тел. (095) 9567928
Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 749
пользователь, выполняя действие EventID в объекте Spreadsheet, будет инициировать возникновение события Objectexecute в акции EventName нашей формы. Пусть этим действием в объекте Spreadsheet будет LC_CLICK - «щелчок мышью» по области объекта Spreadsheet. И пусть это действие повлечет возникновение в акции "Column and row value" из нашей формы события Objectexecute.
' Spreadsheet(Form) - событие Postopen
Sub Postopen(Source
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
Скрипт события Objectexecute в акции "Column and row value" нашей формы будет просто получать дескриптор объекта Sheet и заносить в поля Col, Row и CellValue документа в интерфейсе пользователя соответственно номер столбца, строки и значение из ячейки объекта, «в которую» пользователь «щелкнул мышью».
' Column and row value(Action) - событие Objectexecute Sub Objectexecute(Source As Button, Data As Variant)
Dim workspace As New NotesUIWorkspace
Dim uidoc As NotesUIDocument
Set uidoc = workspace.CurrentDocument
Set VSheet = uidoc.GetObject("Sheet")
Dim doc As NotesDocument
Set doc = uidoc.Document
doc.Col = VSheet.Col ' Номер текущего столбца
doc.Row = VSheet.Row ' Номер текущей строки
doc.CellValue = VSheet.Text ' Значение в текущей ячейке End Sub
В результате при «щелчке мышью в ячейку» 1:3 объекта в вычисляемых для показа полях «над объектом» будут выводиться координаты и значение из этой ячейки.
У]1№ЪЩ&,,.-,,<,,,<,,,,,,,,,,,__.
f^'^T^ir^'^r"") е"Т^ р
\ 1 Г 123
ГТП 234. ;
\ 3 "" 3451 |
{""Т"]"" 456
5_JLJ 567 ' ' !
'_JLJ 678
\ 7 1 789
ЈД„ '.. ^ „ > Jj
Рис. 3.49 Внешний вид документа по этой форме в интерфейсе пользователя
© InterTrust Co. Тел. (095) 9567928
750 Встроенные классы LotusScript и Java
3.40. «Элемент навигатора» - класс Navigator
Объект этого класса представляет кнопку, «активную площадку» (hotspot) или другой объект в навигаторе, открытом в интерфейсе пользователя. Объект доступен только в интерфейсе пользователя Notes, не имеет свойств и методов, а только событие.
Событие Click - «нажатие»
CIick( Source as Navigator )
Происходит, когда пользователь выбирает элемент навигатора. Аргумент Source - объект класса Navigator, в котором произошло событие.
i
t
© InterTrust Со, Тел. (095) 9567928
Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 751
3.41. Обработка ошибок времени выполнения в методах встроенных
классов LotusScript и Java
В большинстве методов встроенных классов Domino для LotusScript и Java во время выполнения могут возникать ошибки. Значительная часть таких ошибок может отслеживаться по возвращаемому значению метода или проверкой свойств полученного объекта. Хотя в большинстве случаев такой «последовательный» анализ возможных ошибок можно считать более целесообразным, он ориентирован только на конкретную обработку и часто не учитывает «всей гаммы» возможных ошибок.
В LotusScript в случае ошибки вызывается подпрограмма обработки ошибок, если конечно ее определил программист. Если же подпрограмма обработки ошибки отсутствует, происходит стандартная обработка - выполнение скрипта завершается с сообщением об ошибке.
Определяют подпрограмму обработки ошибок оператором On Error. Если оператор On Error задан без кода конкретной ошибки, он касается любых ошибок, возникающих в операторах «вслед за» On Error, если «позже» в операторах On Error с конкретными номерами ошибок не даны другие определения подпрограмм обработки. Например, если для ошибок с кодами ErrDatabaseDoesNotExist (база данных не существует) и ErrObjectVariableNotSet (объект не создан, а потому ссылка на объект не установлена) необходима своя обработка, а для всех других возможных ошибок - иная обработка, в «начале скрипта» можно записать «тройку» операторов On Error:
On Error Goto processError
On Error ErrDatabaseDoesNotExist Goto processErrDatabaseDoesNotExist
On Error ErrObjectVariableNotSet Goto processErrObjectVariableNotSet
Константы, соответствующие кодам ошибок определены в следующих файлах из каталога данных Domino:
файл Isxbeerr.Iss содержит определения констант, соответствующих ошибкам, возникающим в методах классов «заднего плана» (back-end);
файл Isxuierr.lss содержит определения констант, соответствующих ошибкам, возникающим в методах классов «интерфейса пользователя» (UI);
файл Iserr.lss содержит определения констант, соответствующих ошибкам, возникающим в самом LotusScript - в операторах и функциях;
файл Isconst.lss содержит определения констант, используемых в качестве параметров в операторах и функциях LotusScript.
Операторы %include, «включающие» эти файлы, обычно помещают или в «событие» (Declarations) соответствующего объекта, или в соответствующее событие в библиотеке скриптов (script library).
Пример 1. В этом скрипте при возникновении любой ошибки вызывается «подпрограмма обработки», начинающаяся меткой processError. Она выводит номер и описание ошибки, после чего выполнение скрипта завершается. Наиболее вероятная ошибка в данном примере - ввод пользователем несуществующего имени файла базы, в результате чего объект db оказывается неопределенным, отчего оператор "Set dc = db.AHDocuments" вызывает ошибку.
Sub Initialize
On Error Goto processError
Dim dc As NotesDocumentCollection
Dim db As New NotesDatabase("", Inputbox("Database?")) Set dc = db.AHDocuments Exit Sub processError:
© InterTrust Co. Тел. (095) 9567928
752 Встроенные классы LotusScript и Java
Messagebox "Error " & Err() & ": " & Error() Exit Sub
End Sub
Пример 2. В этом скрипте, являющемся несложным расширением скрипта из предыдущего примера, при возникновении ошибки ERRJ^JQTESJDATABASE NOTOPEN (не удалось открыть базу) вызывается «подпрограмма обработки», начинающаяся меткой processNotOpen, а при возникновении любой другой ошибки - «подпрограмма обработки», начинающаяся меткой processError. Подпрограмма processNotOpen предлагает пользователю повторить ввод имени файла базы, и при согласии пользователя, после ввода имени, повторяет попытку открыть базу и получить коллекцию содержащихся в ней документов При отказе пользователя повторить ввод имени файла базы, а так же в случае любой другой ошибки выводится номер и описание ошибки, после чего выполнение скрипта завершается.
' (Declarations) .
%INCLUDE "Isconst.lss" %INCLUDE "
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·Exit Sub End Sub
Пример З. Поскольку предыдущий скрипт «неудобочитаем», в этом примере вместо «перехвата» ошибки для проверки успешности открытия базы применено свойство IsOpen. В результате получен более удобочитаемый, но обрабатывающий только конкретную ситуацию, скрипт.
' (Declarations) %INCLUDE "Isconst.lss"
Sub Initialize
Dim dc As NotesDocumentCollection
Dim db As New NotesDatabase("", Inputbox("Database?"))
Do While Not db.IsOpen
reply = Messagebox("Database name is wrong", MB_RETRYCANCEL) If reply = IDRETRY Then
Call db.Openf"", Inputbox("Database?"}) Else
Messagebox "Database can't be opened" Exit Sub End If Loop
Set dc = db.AllDocuments End Sub
© InterTrust Co. Тел. (095) 9567928
Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 753
Пример 4. В этом примере вместо «перехвата» ошибки для проверки успешности открытия базы анализируется значение, возвращаемое методом open. В результате получен более удобочитаемый, однако обрабатывающий только конкретную ситуацию, скрипт.

·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·Аналогично и в Java: при возникновении ошибки генерируется исключение и вызывается обработчик исключения. Типовая обработка исключения - выдача «стека вызовов» и завершение приложения.
Для обработки ошибок в методах встроенных классов Domino для Java предусмотрены классы NotesException и NotesError.
Класс NotesException «расширяет» класс UserException, в свою очередь «расширяющий» класс java.lang.Exception, и имеет следующую спецификацию.
public final class NotesException extends UserException f
public int id;
public String text;
public NotesException();
public NotesException {int __id, String _text); }
Переменная NotesException.id содержит код возникшей ошибки, a Notes Exception.text - ее описание.
Класс NotesError реализует интерфейс NotesError, в котором даны определения символьных констант для всех возможных кодов ошибок.
Пример 5. При возникновении в Java-агенте исключений класса NotesException выводится код и наименование ошибки.
Title:
4003 File does not exist
lotus. domino.N
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·Тел. (095) 9567928
754 Встроенные классы LotusScript и Java .
( .
Session session = getSession();
AgentContext agentContext = session.getAgentContext();
// (Your code goes here)
Agent agent = agentContext.getCurrentAgent();
DbDirectory dir = session.g
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
Пример 6. При возникновении в Java-агенте исключений класса NotesException с кодом ошибки NOTES_ERR_SYS_FILE_NOT_ FOUND (файл не существует) выводится собственное сообщение об ошибке, а при возникновении ошибок с другими кодами - код и наименование ошибки. Однако при возникновении любых ошибок выполнение агента завершается.
import lotus.domino.*;
public class JavaAgent extends AgentBase
{
public void NotesMain() {
try {
Session session = getSession();
AgentContext agentContext = session.getAgentContext(); /
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·rintstackTrade(); }
} 'J
}
© InterTrust Co. Тел. (095) 9567928
Lotus Domino R, 5: (^-формулы, LotusScript, встроенные классы LotusScript и Java 755
4. Классы для доступа к внешним базам данных через
ODBC-интерфейс х
Замысел расширений LotusScript (LotusScript Extensions) - LSX - состоит в том, чтобы позволить разработчикам приложений создавать свои собственные классы, доступные из Notes и имеющие собственные методы, свойства и события. Эти классы должны существовать физически не в форме включаемого в приложение директивой %Include исходного текста на LotusScript, а в форме загружаемых в память исполняемых файлов, например, библиотек динамической компоновки. Средство для разработки таких классов поставляется фирмой Lotus и называется LSX Toolkit.
4.1. Введение в классы для работы с внешними БД через ODBC-интерфейс
Наряду с созданием собственных классов, не менее важно уметь использовать в среде Notes/Domino классы LSX, созданных другими разработчиками. Три таких LSX-класса всегда /доступны из Notes/Domino. Они позволяют интегрировать приложения Notes с данными из внешних баз данных, поддерживаемых ODBC-драйверами.
ODBC (Open DataBase Connectivity) - интерфейс, который позволяет приложениям получать данные от систем управления базами данных (СУБД, DBMS) с использованием запросов на языке SQL. Этот интерфейс позволяет одному приложению (Application) соединяться со многими разными типами баз данных, используя один и тот же стандартный интерфейс (ODBC interface). ODBC состоит из менеджера драйверов (Driver Manager) и многих драйверов, каждый из которых "умеет работать" с базой данных конкретного типа. Попутно заметим, что существует и ODBC-драйвер для работы с базами Notes/Domino -NotesSQL. SQL - язык структурированных запросов - используется для описания конкретного обращения приложения за данными к источнику данных (Data Source).

Application - гршюкеше, исгшьзуквде даньв из вгеших баз
I р =^= _=Щ 1
ODBC Interface - стандартньй ODBC- ODBC
интерфейс
Driver Manager - жжджер драйверов
Ll±=rp=ILJ ==7р
Driver - ODBC-драйвер Driver - ODBC-драйвер NotesSQL - ODBC-
драйвер для баз Notes
^^ __ ^^ , -.
Data Source-истшшк Data Source-истсншк Notes Database-база
даньк даньк даньк Notes
Ч } \ J V . J
Рис. 4.1. Архитектура ODBC
Применительно к MS Windows, Windows 95 и Windows NT главная компонента ODBC -Microsoft ODBC Driver Manager. Он доступен пользователю для контроля и настроек через
© InterTrust Co. Тел. (095) 9567928
756 Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java
Control Panel. ODBC-драйвер является библиотекой динамической компоновки (DLL), реализующей доступ к конкретному типу СУБД, ODBC-драйверы обычно разрабатываются "третьими" фирмами. Драйверы совместно с менеджером драйверов содержат средства для конфигурирования источников данных. Источник данных в общем случае - специфическая комбинация системы управления базой данных, операционной системы удаленного компьютера, "несущего" файлы баз, и сети.
Классы ODBCConnection, ODBCQuery и OBDCResultSet предлагают свойства и методы для доступа из приложений Notes к внешним базам с использованием стандарта ODBC. Сами эти классы только реализуют интерфейс между приложением Notes и нужным ODBC-драйвером через стандартный ODBC-интерфейс.
Для доступа к этим классам Вы должны включить в скрипт события (Options) объекта (Global) оператор:
UseLSX "*LSXODBC"
Этот оператор осуществляет загрузку в память библиотеки динамической компоновки, реализующей классы. Под Windows 95 и Windows NT, например, загружается файл NLSXODBC.DLL. Для других операционных систем первые буквы имени загружаемого файла могут быть разными, на что и указывает символ "*" в имени "*LSXODBC".
Класс ODBCConnection представляет возможности стандарта ODBC по подключению к источникам данных.
Класс ODBCQuery представляет возможности стандарта ODBC по определению запросов на данные из источника.
Класс ODBCResultSet предоставляет разные возможности по работе с таблицей
результатов.
Следующий рисунок "крупномасштабно" поясняет взаимосвязь объектов классов ODBCConnection, ODBCQuery и OBDCResultSet.
Метод ConnectTo
Соединение с источником данных , ч
Объект класса ODBCConnection -W Источник данных 1
Метод Connection _,_.,
Метод SQL
SQL-запрос на получение данных JТ^с^^с~а ^
Объект класса ODBCQuery * SELECT FROM
Метод Query
Метод Execute
Таблица результатов запроса Г~ Л
Объект класса ODBCResultSet »[ Таблица результатов ^
Рис. 4.2. Взаимосвязь объектов ODBC-классов
Рассмотрим пример использования этих классов. /
Dim con As New ODBCConnection L^
Dim qry As New ODBCQuery vj
Dim res As New ODBCResultSet
Dim ws As New NotesUIWorkSpace . .
Dim uidoc As NotesUIDocurnent
© InterTrust Co. Ten. (095) 9567928
Lotus Domino R. 5: ©-формулы, LotusScript, встроенные классы LotusScript и Java 757
Set uidoc = ws.CurrentDocument
con.ConnectTo ( "MyDataSource" ) -;..-^..
Set qry.Connection = con
qry.SQL = "SELECT FirstName, EmpNumber FROM employee " & _
"WHERE LastName = 'Hawker' " ~
Set. res. Que
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
· Переменным con (соединение), qry (запрос) и res (таблица результатов) присваиваются новые объекты соответствующих классов.
5, 6. Переменной ws (рабочее пространство) присваивается новый объект, представляющий рабочее пространство пользователя. Переменная uidoc (документ в интерфейсе пользователя) становится ссылкой на объект, представляющий текущий документ в рабочем пространстве пользователя.
7. Метод ConnectTo устанавливает соединение объекта con с источником данных, имеющим имя MyDataSource. Этот источник должен быть определен в настройках драйвера ODBC.
8, 9. Свойство Connection (соединение) объекта qry получает значение ссылки на объект, представляющий соединение. Свойство SQL объекта qry получает текст запроса на получение данных. Запрос интерпретируется так: "Выбирать из записей в таблице employee значения из полей FirstName и EmpNumber, если в поле LastName записи содержится 'Hawker'
и
10, 11. Свойство Query (запрос) объекта res становится ссылкой на объект qry, представляющий запрос. Метод Execute выполняет запрос, теперь объект res уже содержит отвечающие запросу данные - таблицу из двух столбцов.
12. Дальнейшее выполняется в цикле до тех пор, пока курсор объекта res, который по умолчанию при выполнении запроса устанавливается на первую строку таблицы результатов, не переместится за последнюю строку таблицы. Когда это случится, свойство IsEndOfData вернет True.
13, 14. Курсор в документе uidoc из интерфейса пользователя устанавливается в поле FirstName. В это поле вставляется текст, извлеченный методом GetValue из первого столбца (поля) в той строке (записи таблицы результатов) объекта res, на которой в настоящее время находится курсор объекта res.
15, 16. Курсор в документе uidoc из интерфейса пользователя устанавлищется в поле EmpNumber. В это поле вставляется текст, извлеченный методом GetValue из второго столбца в той строке таблицы результатов, на которой в настоящее время находится курсор.
17. Метод NextRow перемещает курсор объекта res на следующую строку (запись в таблице результатов). Следующим выполняется оператор из строки 12.
18. Это конец цикла.
19. Метод Close закрывает объект res, таблица результатов с этого момента не определена.
20. Метод Disconnect разрывает соединение объекта con с источником данных.
© InterTrust Co. Тел. (095) 9567928
758 Lotus Domino R. 5: @гформулы, LotusScript, встроенные классы LotusScript и Java
4.2. «Объект соединение с источником данных» - класс
ODBCConnection
Класс ODBCConnection представляет возможности стандарта ODBC по подключению к источникам данных. Свойства и методы класса позволяют получить список доступных источников данных, подключиться к источнику, получить список доступных таблиц в источнике и полей в таблице, установить или проверить некоторые специфические свойства источника и соединения с ним, вести обработку ошибок, а когда соединение более не нужно, отключиться от источника данных.
Для создания нового объекта класса ODBCConnection используют метод New. Dim variableName As New ODBCConnection или Set odbcConnection = New ODBCConnection
Метод isConneejted - «есть ли соединение»
status = odbcConnectionAsConnected
Возвращает True, если объект соединен с источником данных, или False, если нет.
Свойство DataSourceName - «имя источника данных»
пате$ = odbcConnection.T)ntaSourceName
Возвращает имя источника данных ODBC (тип String), с которым соединен объект, или ошибку (DBstsNCON) в случае если соединения нет.
Метод isSupported - «определение характеристик соединения»
status = odbcConnection. isSupported( option )
Позволяет определить, какие возможности поддерживаются установленным соединением. True означает, что возможность поддерживается, a False - нет. Аргумент option может быть одним из следующих:
DB SUPP_CURSORS - СУБД поддерживает работу с курсорами;
DB SUPPJPROCEDLJRES - СУБД поддерживает механизм хранимых процедур (stored- procedure);
DB_SUPP_READONLY - СУБД или драйвер позволяют только читать данные;
DB SUPP_SILENTMODE - СУБД обладает возможностью "тихо", т.е. без выдачи диалогового окна для ввода идентификатора и пароля, отвергать попытку доступа, если идентификатор пользователя или пароль изначально были заданы ошибочно;
DB_SUPP_TRANSACTIONS - СУБД поддерживает механизм транзакций.
Свойство SilentMode - «проверка/установка «тихого» режима»
status = odbcConnection.SHeniMode odbcConnection. SilentMode = status Значение True устанавливает "тихий" режим, False - обычный.
Некоторые источники данных при попытке доступа к ним требуют ввода идентификатора пользователя и соответствующего пароля.
© InterTrust Co. Тел. (095) 9567928
Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 759
Когда для доступа к данным требуются идентификатор и пароль, но в методе ConnectTo они не указаны или указаны неверно, в обычном режиме появляется окно "Идентификатор и пароль пользователя". Пользователь может правильно ввести требуемое, и ему будет обеспечен доступ к данным.
В "тихом" режиме (SilentMode = True), если для доступа к данным требуются идентификатор и пароль, но в методе ConnectTo они не указаны или указаны неверно, окно "Идентификатор и пароль пользователя" не появляется, а попытка установить соединение просто терпит неудачу. "Тихий" режим поддерживается для тех ODBC-драйверов, которые поддерживают функцию SQLBrowseConnect (например, драйверы Oracle и Sybase).
Свойство AutoCommit - «проверка/установка режима транзакций»
flag% - odbcConnection. AutoCommit odbcConnection, AutoCommit =flag% Используется для контроля и управления режимом внесения изменений в базу данных.
В режиме AutoCommit (flag% = True) все изменения в таблице результатов автоматически и постоянно вызывают соответствующие изменения в базе данных.
Альтернативой является внесение изменений в базу данных в режиме отложенных транзакций (flag% = False). В этом случае изменения, выполненные в таблице результатов, заносятся в файл транзакции, а не сразу в базу данных. При закрытии таблицы результатов возможен как "откат" изменений (операция rollback) - файл транзакции попросту не выполняется, так и внесение изменений в базу (операция commit) - файл транзакции выполняется. Если база данных поддерживает отложенные транзакции, можно установить значение свойства AutoCommit как в True, так и в False. Если будет выбрано True, то при каждом изменении в объекте класса ODBCResultSet будет осуществляться автоматическое выполнение изменений (commit) в базе. Но если база данных не поддерживает режима транзакций, невозможно установкой свойства в False "заставить" ее работать в этом режиме - свойство останется в значении True. ^
Свойство CommitOnDisconnect «проверка/установка режима транзакций при отсоединении от источника»
flag% = odbcConnection.CommitOaJ)lsconnect odbcConnection.CommitQnDisconnect ~flag%
Свойство определяет, что должно происходить при отсоединении от источника данных, поддерживающего отложенные транзакции. Значение True требует выполнять изменения (операция commit), a False - производить "откат" (операция rollback). Если же источник данных не поддерживает отложенных транзакций, это свойство вообще не имеет смысла.
Свойство GetLSDOMasterRevision - «определение версии текущего LSX ODBC»
пате$ = odbcConnection. GetLSDOMasterRevision Возвращает информацию о версии конкретного LSX ODBC.
Метод connectTo - «выполнение соединения с источником данных»
status - odbcConnection.connectTo( dataSourceName$ [, userlDS ,password$])
© InterTrust Co. Тел. (095)9567928
760 Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java
Выполняет соединение с источником данных. Параметр dataSourceName$ (тип String) задает имя источника данных ODBC, с которым требуется соединиться. Необязательные параметры userlDS и passwords (оба типа String) задают идентификатор и пароль пользователя. Возвращается True, если соединение установлено, или False, если имела место ошибка.
Источник данных должен быть уже зарегистрирован в менеджере драйверов (Driver Manager). Метод автоматически не регистрирует незарегистрированный источник данных.
События: BeforeConnect, AfterConnect, BeforeConnectTo, AfterConnectTo. Ошибки:
запрашиваемый источник данных не найден (DBstsCANF);
соединение не возможно (DBstsCCON);
отсутствует имя или пароль пользователя (DBstsACCS).
Пример. Соединение с источником данных Volunteers. Указаны идентификатор пользователя и пароль.
volunteers.ConnectTo( "Volunteers", "JOE", "JOESPASS2" )
Метод disconnect - «выполнение отсоединения от источника данных»
status = odbcCormection.disconuect \
Выполняет отсоединение от источника данных. Возвращает True, если отсоединение произошло успешно, или False, если нет.
После успешного выполнения отсоединения остается возможность работать с полученными результатами, однако новых изменений и выборок сделать нельзя.
События: BeforeDisconnect, AfterDisconnect.
Ошибки: нет соединения с источником данных (DBstsNCON).
Метод HstDataSources - «определение имен зарегистрированных источников данных»
*
sourceArray - odbcConnection.\isiD&t&Sources
Возвращает имена всех зарегистрированных источников данных (тип Array of strings). Каждая строка в массиве - имя зарегистрированного источника.
В приведенном ниже окне настроек MicroSoft ODBC32 содержится список зарегистрированных источников данных. Метод ListDataSources в этом случае возвращает следующие имена источников: "dBASE Files", "Excel Files", "FoxPro Files", "Text Files".
© InterTrust Co. Тел. (095) 9567928
Lotus Domino R. 5: (д)-формулы, LotusScript, встроенные классы LotusScript и Java 761

Use* Data Sources fDiiwrt- Close I
Excel Files (Microsoft Excel Driver (*.xls)) Help' 1
FoxPro Files (M icrosoft FoxPro D river (". dbf)) ^»_-J
Text Files (Microsoft Text Driver (K.(xt; *csv)) ; "1
- . J
' J
' „&» *.-s»)t***St*«A"'' 'Т!»Л»Й1»ВЙ1К.'?«ЯК<ЧЬ. i
Puc. 4. i.Пример окна настроек MicroSoft ODBC32 События: BeforeListDataSources, AfterListDataSources.
Метод listTables - «определение доступных таблиц в источнике данных»
table Array = odbcConnection.listTstbles( dataSourceNatne$
[, userID$ , passwords ] ] )
Возвращает список доступных таблиц в источнике данных, с которым соединен объект. Необязательный параметр dataSourceName$ (тип String) задает имя источника данных. Если требуется, параметр userID$ (тип String) задает идентификатор пользователя, а параметр passwords (тип String) - его пароль. Каждый элемент возвращаемого значения tableArray (тип Array of strings) содержит имя доступной в источнике данных таблицы.
События: BeforeListTables, AfterListTables. Ошибки:
нет соединения с источником данных (DBstsNCON);
остутствует имя или пароль пользователя (DBstsACCS).
Метод listFidds - «определение имен полей конкретной таблицы источника данных»
fleldArray = odbcConnection.listҐields( [ tableName$ ] )
Возвращает список имен полей в таблице. Необязательный параметр tableNameS (тип String) задает имя таблицы. Если tableName$ опущено, возвращаются имена полей текущей таблицы (если она есть). Каждый элемент возвращаемого значения fleldArray (тип Array of strings) является именем поля в таблице. Их порядок в массиве повторяет порядок полей в таблице.
События: BeforeListFields, AfterListFields. Ошибки:
нет соединения с источником данных (DBstsNCON);
невозможно вернуть имена некоторых колонок таблицы (DBstsNCOL).
© InterTrust Co, Тел. (095) 9567928
762 Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java
Метод listProcedures - «определение хранимых в источнике данных процедур»
procArray = odbcConnection.lisiProcedmes( [ dataSourceName$
''.' [, userID$ ,password$ ] ] ) .
Возвращает список имен (тип Array of strings) хранимых в источнике данных процедур. Не все драйверы поддерживают эту возможность.
Имя источника данных может задаваться параметром dataSourceName$. Если требуется, указывают идентификатор пользователя userID$ и пароль passwords. Все параметры типа String.
События: BeforeListProcedures, AfterListProcedures. Ошибки:
нет соединения с источником данных (DBstsNCON); « отсутствует имя или пароль пользователя (DBstsACCS).
Метод commitTransactions - «осуществление принятия транзакции»
status = oo%cCoraec//o«.commitTransactions
Осуществляет попытку для отложенных транзакций принять изменения (операция commit). Возвращаемое значение True сообщает об успехе операции, a False - об ошибке. Если же источник данных не поддерживает отложенных транзакций, или в случае установки свойства AutoCommit, этот метод вообще не имеет смысла.
События: BeforeCommitTransactions, AfterCommitTransactions. Ошибки: нет соединения с источником данных (DBstsNCON).
Метод rollbackTransactions - «осуществление отмены транзакции»
status = oc/^cCo«necf/o«.rolJBackTransactions
Осуществляет попытку для отложенных транзакций выполнить "откат" изменений (операция rollback). Возвращаемое значение True сообщает об успехе операции, a False - об ошибке. Если же источник данных не поддерживает отложенных транзакций, или в случае установки свойства AutoCommit, этот метод вообще не имеет смысла.
События: BeforeRollBackTransactions, AfterRoliBackTransactions. Ошибки: нет соединения с источником данных (DBstsNCON).
О InterTrust Co. Тел. (095) 9567928
Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 763
4.3. «SQL-запрос» - класс ODBCQuery
Объект класса ODBCQuery представляет возможности стандарта ODBC по определению запросов. Запрос определяет, какие именно данные должны выбираться из источника данных.
Для создания нового объекта класса ODBCQuery используют метод New. Dim variableName As New ODBCQuery или Set odbcQuery = New ODBCQuery
Свойство Connection- «связь с объектом соединение»
Set odbcQuery.ODJ&CConnectiQn = odbcConnection
Связывает запрос odbcQuery с источником данных odbcConnection. Запрос сначала следует связать с имеющимся соединением, и только после этого использовать или проверять.
Ошибки: недопустимый объект соединение (DBstsNCOJ).
Свойство QueryExecuteTimeOut - «максимальное время выполнения запроса»
time% = odbcQuery.Query^En.ecuteTimeOat odbcQuery. QueryExecuteTimeOut = time%
Интервал времени в секундах (тип Integer). Если запрос "не успел" выполниться в течение этого времени, его выполнение должно быть прервано.
© Свойство UseRowID- «проверяет/устанавливает поддержку базой данных источника обращение по номеру строки»
flag% = odbcQuery. UseRowID odbcQuery. UseRowID ~flag%
Осуществляет проверку или установку поддержки базой данных источника возможности обращения по номеру строки.
Возвращаемое значение True - если база данных источника поддерживает механизм обращения по номеру строки, и False - в противном случае.
По умолчанию данное свойство установлено в False, т.к. большинство баз не поддерживает данный механизм.
Данное свойство при необходимости нужно установить до определения SQL свойства.
Свойство SQL - «SQL-оператор запроса»
statements = odbcQuery.SQIL odbe Query.SQJu= statements
Задает оператор SQL (тип String), определяющий, какие именно данные должны быть получены. При установке свойства выполняется синтаксический анализ текста оператора. Практически отсутствуют ограничения на длину оператора, однако в запросе допустим только оператор SELECT. Метод не выполняет оператор SQL - оператор будет выполнен только тогда, когда программист создаст объект ODBCResultSet, свяжет его с этим запросом и применит к нему метод Execute. . , , ,
© InterTrust Co. Тел. (095) 9567928
764 Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java
При использовании свойства SQL необходимо помнить, что его выполнению могут помешать следующие обстоятельства:
оператор SQL содержит ключевое слово FROM, но не содержит имя таблицы;
в процессе проверки SQL-оператора возникает ситуация нехватки памяти.
Кроме того, выполнение оператора SQL будет зависеть от прав доступа пользователя. Учтите, что пользователь может быть не уполномочен изменять некоторые поля или таблицы, выполнять некоторые операции или вообще иметь доступ к некоторым таблицам или столбцам.
События: BeforeSetSQL, AfterSetSQL. Об операторе SELECT в SQL
Л
Исключительно в ознакомительных целях, не претендуя на полноту или поддержку всеми ODBC-драйверами, приведем синтаксис оператора SELECT и сопроводим его примерами.
Оператор SELECT> ::=
SELECT [DISTINCT] <список выбираемых полей> FROM <список таблиц> [ WHERE <условие выбора> ] [ GROUP BY <условие группировки>
[ HAVING <условие выборки группы> ] ] [ ORDER BY <условие упорядочивания> ]
Список выбираемых полей, и список таблиц определяют состав, и порядок следования полей (столбцов) в получаемой таблице.
<список выбираемых полей> :: = * <список выбираемых полей> :: = <элемент списка> | <список выбираемых полей>, <элемент списка> <элемент списка> :: = <имя поля> | <имя таблицы>.<имя поля> |
9
] <выражение>
Символ "*" означает выбор всех полей. Если в разных таблицах имеются одноименные поля, чтобы обеспечить однозначность, задают имя таблицы и имя поля в ней. Выражение строится из констант и имен полей с использованием знаков операций, круглых скобок и функций.
<список таблиц> ::= <имя таблицы> | <список таблиц>, <имя таблицы> Примеры выбора полей из таблицы:
SELECT * FROM Customer " . .,,
SELECT CustCode, FullName FROM Customer
SELECT DISTINCT ProductType FROM Products , ...
SELECT ProductName, Cost* ( 1 + 0.23 ) FROM Products
Условие выбора определяет записи, которые должны быть включены в получаемую таблицу.
<условие выбора> ::== [NOT] <предикат> |
| <условие выбора> {AND | OR} <предикат>
© InterTrust Co, Тел. (095) 9567928
Lotus Domino R. 5: (w-формулы, LotusScript, встроенные классы LotusScript и Java 765
<предикат> ::=
<выражение> {=|о>|<|<= >=} {<выражение> |(<оператор SELECT>)}| <выражение> [NOT] BETWEEN <выражение> AND <выражение> | | <имя поля> IS [NOT] NULL EXISTS («эператор SELECT>) <выражение> [NOT] LIKE <строка-константа> j <выражение> [NOT] IN <множество>
<множество> ::= (<оператор SELECT>) | (<список констант>) Примеры всевозможных предикатов:
Tablel.CustNumber = Tabie2.CustNumber
Salary < (SELECT AVG( Salary ) FROM Employee)
ProjCost BETWEEN 2000 AND 4000
Cost IS NOT NULL
EXISTS (SELECT * FROM Project WHERE ProjNo = 1}
Name LIKE '%son'
DeptNo IN (10, 20, 30)
Date NOT IN (SELECT Date FROM Orders WHERE date < 05/21/95)
Пример оператора SELECT, выполняющего "склейку" таблиц:
SELECT Orders.FullName, Custlnfо.Address FROM Orders, Custlnfo WHERE Orders.CustNumber = Custlnfo.CustNumber
Условие группировки позволяет "сгруппировать" в получаемой таблице записи с одинаковыми значениями перечисленных в условии полей.
<условие группировки> ::= <имя поля> | <условие группировки>, <имя поля> Пример группировки по полю ProductCode:
SELECT ProductCode, Cost FROM Products GROUP BY ProductCode
Условие выборки группы позволяет сохранить в получаемой таблице только группы, удовлетворяющие этому условию.
<условие выборки группы>:= <условие выбора>
В следующем примере в получаемую таблицу включаются только группы, содержащие три и более записей:
SELECT ProductCode, Cost FROM Products GROUP BY ProductCode
HAVING COUNT( * ) > 2
Условие упорядочивания позволяет расположить записи получаемой таблицы по возрастанию или убыванию значений перечисленных в условии полей.
<условие упорядочивания> ::= <имя поля> [ASC | DESC ] |
| <условие упорядочивания^ <имя поля> [ASC | DESC ] Пример упорядочивания по убыванию поля Cost:
SELECT ProductCode, Cost FROM Products ORDER BY Cost DESC ':
© InterTrust Co. Тел. (095) 9567928
766 Lotus Domino R. 5: (^-формулы, LotusScript, встроенные классы LotusScript и Java
4.4. «Таблица результатов» - класс ODBCResultSet
Объект класса ODBCResultSet представляет возможности стандарта ODBC по выполнению операций с таблицей результатов (result set). Таблицу результатов можно рассматривать как некоторый буфер в памяти выполняющего скрипт компьютера, в который из источника данных заносится информация в соответствии с запросом на SQL. Программист может оперировать с информацией из этой таблицы, изменять информацию в ней, а в определенные моменты времени заносить информацию из таблицы в базу данных источника.
Методы класса позволяют создать соответствующую запросу таблицу результатов, перемещать курсор по записям таблицы, определять тип и свойства полей записи, получать информацию из полей текущей записи, изменять информацию в полях текущей записи, добавлять в таблицу новые записи, удалять записи из таблицы, заносить изменения из текущей записи таблицы в источник данных, закрывать таблицу результатов.
Для создания нового объекта класса ODBCResultSet используют метод New.
Dim variableName As New ODBCResultSet или
Set odbcResultSet = New ODBCResultSet ~
(
Свойство Query - «SQL-запрос»
Set odbcResultSet.Query = ODBCQuery
Связывает таблицу результатов (объект класса ODBCResultSet) с запросом (объект класса ODBCQuery). Для выполнения запроса данное действие необходимо.
Ошибки: недопустимый объект запрос (DBstsNQOJ).
Свойство ReadOnly - «только для чтения»
flag% = odbcResultSet. Read Only odbcResultSet.ReadOnly =flag%
Значение True констатирует, что источник данных доступен только для чтения, a False -для чтения и записи. Установка указанного свойства в True предотвратит изменений в источнике данных, даже если сам источник не поддерживает режима "только для чтения".
Свойство CacheLimit - «размер кеша»
limit% = odbcResultSet.CacbeLimit odbcResultSet.CacheUmit ~ limit%
Максимальное количество записей (тип Integer), кэшируемых в памяти. Помимо числового значения в качестве limit% допустимы также константы DB_ALL (каптируется вся таблица результатов) или DB_NONE (минимум - только текущая запись находится в памяти). Если задано также значение свойства FetchBachSize, то оно должно быть меньше или равно значения CacheLimit.
Ограничение размера кэша способствует экономии памяти. Но когда размер кэша ограничен, "недавно" прочитанные из базы записи будут постепенно замещать "более старые" записи в кэше. Если записи, которые уже были прочитаны из базы и были замещены в кэше, потребовались скрипту снова, они будут заново считываться из базы данных.
© InterTrust Co. Тел. (095) 9567928
Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 767
Свойство FetchBatchSize - «число записей обрабатываемых за одну операцию»
size% = о dbcResultSet. FetchBatchSize odbcResuhSet.FetchBatchSize = size%
Задает количество записей, которые передаются (читаются) за одну операцию с базой. Значение по умолчанию 1 - читать только требуемую запись. При последовательном чтении записей одновременная передача "по несколько записей" оказывается более эффективной, чем их получение "по одной". Если также установлено значение CacheLimit, оно должно быть больше или равно значения FetchBatchSize.
Свойство тажКлт§ - «максимальное количество записей в таблице результатов»
rows& - odbcResuhSet.ms\Rows odbcResultSet.m&-8RovfS - rows&
Максимальное количество записей, передаваемых в таблицу результатов, или 0 для передачи всех записей в пределах имеющейся памяти.
Метод isResuItSetAvailable - «состояние таблицы результатов»
flag% = odbcResultSet. isResuItSetAvailable
После выполнения запроса значение True констатирует, что таблица результатов доступна, и в ней имеется, по крайней мере, одна запись. Значение False - что таблица результатов недоступна.
Ошибки: результат выполнения запроса был неуспешным, или таблица результатов была закрыта (DBstsNOEX).
Метод mimColumns - «количество столбцов в таблице результатов»
пит% ~ odbcResultSet.numColumns
Возвращает количество столбцов в таблице результатов.
События: AfterNumColumns, BeforeNumColumns.
Метод numRows - «количество записей в таблице результатов»
пит% ~ odbcResultSet.numRows Количество записей в таблице результатов.
Вы не можете этим свойством определить количество записей непосредственно после запроса или пока еще происходит выборка записей. Это можно сделать только после того, когда выбраны все записи из таблицы результатов. Вы можете непосредственно после запроса только определить, содержит ли таблица результатов что-нибудь вообще.
Значение 0 - вполне допустимое значение свойства. Свойство возвращает DB_NORESULT - если таблица результатов отсутствует, DB ROWSUNKNOWN - если число записей неизвестно, и DB_ROWSLIMITED - если значение свойства MaxRows меньше реального количество записей в таблице результатов.
I .-...'
© InterTrust Co. Тел. (095) 9567928
768 Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java
При "нехватке" памяти содержимое таблицы результатов "усекается", свойство IsEndOfData устанавливается в True, но NumRows при этом имеет значение
DB ROWSUNKNOWN. ;
')
События: AfterNumRows, BeforeNumRows. I
Метод isBegmOffiata - «положение курсора по отношению к первой записи в таблице результатов»
flag% = odbcResu/tSet.isBegmOU)nta Возвращает значение:
0 - когда таблица результатов содержит ноль строк;
True - когда курсор стоит на первой записи в таблице результатов;
False - в противном случае.
Так как возвращаемое значение имеет тип либо integer (записей нет), или Boolean (есть записи), то во избежание ошибок, связанных со смешением типов данных, применяйте перед вызовом IsBeginOfData метод IsResultSetAvailable.
Ошибки:
нет соединения с источником данных (DBstsNCON);
таблица результатов не содержит данных (DBstsNODA).
Метод isEndQfflata - «положение курсора по отношению к последней записи в таблице результатов»
flag% = odbcResultSet.isEndOfData Возвращает значение:
0 - когда таблица результатов содержит ноль строк;
True - когда курсор стоит на последней записи в таблице результатов;
False - в противном случае.
Так как возвращаемое значение имеет тип либо Integer (записей нет), или Boolean (есть записи), то во избежание ошибок, связанных со смешением типов данных, применяйте перед вызовом IsEndOfData метод IsResultSetAvailable.
Ошибки: метод вернет значение True даже при отсутствии в таблице результатов данных, и при вызове до применения метода Execute, и после применения метода Close.
Пример. Метод IsEndOfData используется в цикле, для обработки всех полученных с помощью SQL-запроса значений в таблице результатов result.
Do '
result.NextRow '
'Здесь находятся операторы обработки текушей строки
Loop Until result.IsEndOfData
Свойство CurrentRow - «номер текущей строки»
row& = odbcResultSet.CurrenVRow odbcResultSet.CurreniRav? = row&
© InterTrust Co. Тел. (095) 9567928
Lotus Domino R. 5: @гформулы, LotusScript, встроенные классы LotusScript и Java 769
Номер текущей записи (тип Long) в таблице результатов. Первая запись в таблице имеет номер 1. Изменение номера текущей записи эквивалентно позиционированию курсора на эту запись и требует получения записи из базы. Если кэширование не используется или драйвер не поддерживает позиционирования курсора, то будет невозможно позиционировать курсор на запись перед текущей записью.
Попытка установки указанному свойству значения 0 после извлечения данных приводит к ошибке #545.
Специальное значение DB_ADDROW используется для позиционирования курсора в пространство, используемое для добавления новой записи (см. метод AddRow).
События: AfterCurrentRow, AfterRowPositionChange, BeforeCurrentRow,
BeforeRowPositionCSiange.
Ошибки:
таблица результатов не содержит данных (DBstsNODA);
отсутствует доступ к текущей строке (DBstsCARR);
нельзя осуществить позиционирование в пространство, используемое для добавления новой записи (DBstsCPAR);
неправильный номер строки (DBstsINVR);
текущая строка была удалена (DBstsROWD).
t.
Метод hasKowChanged - «флаг изменения текущей строки по отношениию к моменту ее извлечения из источника данных»
status = odbcResuhSet.hasRov/Changeil
Значение True сигнализирует о том, что текущая запись в источнике данных изменилась после того, как ее копию поместили в таблицу результатов, а значение False - что не изменилась. Изменение методом SetValue текущей записи в таблице результатов не влияет на значение свойства HasRowChanged.
Метод может возвращать недостоверную информацию, когда таблица результатов содержит столбцы с полями типа RTF, графических объектов или когда в таблице результатов есть дублирующиеся строки.
Ошибки:
таблица результатов не содержит данных (DBstsNODA);
в таблице результатов есть дублирующиеся строки (DBstsNUNQ).
Метод execute - «выполнение SQL-запроса»
status - odbcResultSeLexecute
Выполняет запрос, содержащийся в связанном с объектом класса ODBCResultSet объекте класса ODBCQuery, и создает соответствующую таблицу результатов. Предыдущие значения таблицы результатов теряются. Свойство NumColumns устанавливается равным фактическому числу столбцов в таблице результатов, свойство NumRows получает значение DB^ROWSUNKNOWN. Переустанавливаются значения свойств IsResultSetAvailable, IsBeginOfData, IsEndOfData и CurrentRow.
События: BeforeExecute, AfterExecute.
Ошибки: ODBC не может выполнить запрашиваемую операцию (DBstsODBC).
© InterTrust Co. Тел. (095) 9567928
770 Lotus Domino К. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java
© Метод execProcedure - «выполнение хранимой в источнике данных процедуры»
status - odbcResultSet.e\ecProcedure(procedureName$ [,argl] [,arg2J . . . /,arg30J ) или status = odbcResultSet.execProcedure(procedureName$ , DB_PARAM_ARRAY, argArray )
Выполняет хранимую в источнике данных процедуру. Процедура задается ее именем procedureNameS. Параметры (не более 30), если они необходимы, задаются, либо как аргументы метода, либо, если второй параметр DBJPARAM_ARRAY, как элементы массива argArray. Во втором варианте синтаксиса ограничение на число аргументов (до 30) снято.
Параметры процедуры могут использоваться как для передачи, так и для возврата в вызывающую программу значений. Тип их может быть любой, но он должен соответствовать типу данных используемых в процедуре. Любые пропущенные аргументы передаются как аргументы со значением NULL.
Возвращаемое значение зависит от хранимой процедуры. Это может быть либо какое-либо возвращаемое значение, таблица результатов, или статус успеха/неуспеха выполнения процедуры.
Метод firstRow - «установка курсора на первую строку в таблице результатов»
status = odbcResultSet. firstRow
Устанавливают курсор на первую запись в таблице результатов. Возвращают True, если операция завершилась успешно, или False, если имела место ошибка.
Установка курсора на первую запись эквивалентна установке свойства CurrentRow в значение 1. Обратите внимание, что Вы не сможете переместить курсор на запись перед текущей, если не определили кэширование, или драйвер не поддерживает позиционирование курсора.
События: BeforeFirstRow, AfterFirstRow, BeforeRowPositionChange,
AfterRowPositionChange.
Ошибки:
т
отсутствует доступ к текущей строке (DBstsCARR);
неправильный номер строки (DBstsINVR),
Метод lastRow - «установка курсора на последнюю строку в таблице результатов»
status = odbcResultSet.lasiRo\v
Устанавливают курсор на последнюю запись в таблице результатов. Возвращают True, если операция завершилась успешно, или False, если имела место ошибка.
В ходе перемещения курсора на последнюю запись драйвер обычно "просматривает одна за одной" записи из таблицы, начиная с текущей и до нахождения последней, поэтому достижение последней записи может потребовать некоторого времени,
События: BeforeLastRow, AfterLastRow, BeforeRowPositionChange,
AfterRowPositionChange.
© InterTrust Co. Тел. (095) 9567928
Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 111
Метод nextRow - «установка курсора на следующую строку в таблице результатов»
status = odbcResultSet, nextRow
Перемещает курсор на следующую запись в таблице результатов. Возвращает True, если операция завершилась успешно, или False, если имела место ошибка. Ошибка возникает, когда таблица результатов не содержит значений, или уже все строки были извлечены из таблицы результатов.
Нельзя использовать данный метод в качестве условия цикла по всем записям таблицы результатов. Дело в том, что метод возвращает значение False уже, когда в таблице результатов не осталось ни одной строки, и при этом все равно генерируется ошибка. Вместо данного метода в циклах по всем записям таблицы результатов необходимо использовать метод IsEndOflData.
События: BeforeNextRow, AfterNextRow, BeforeRowPositionChange,
AfterRowPositionChange.
Ошибки:
достигнут конец данных в таблице результатов (DBstsEOFD);
неправильный номер строки (DBstsINVR).
Метод prevRow - «установка курсора на предыдущую строку в таблице результатов»
status = odbcResultSet.\>revR.aw
Перемещает курсор на предыдущую запись в таблице результатов. Возвращает True, если операция завершилась успешно. False возвращается, если имела место ошибка: была предпринята попытка перейти к записи перед первой, таблица результатов не кэшируется, текущее местоположение курсора находится в пространстве для добавления новой записи (AddRow workspace), кеш ограничен и драйвер ODBC не поддерживает позиционирование курсора, и др.
События: BeforePrevRow, AfterPrevRow, BeforeRowPositionChange,
AfterRowPositionChange.
Ошибки: :
неправильный номер строки (DBstsINVR);
отсутствует доступ к текущей строке (DBstsCARR).
Метод fieldlD - «определение номера столбца» ;.;;ъ; ?"~ ;.;-: :;;; ...:У":':С": ! '':.'.-'::
id% = odbcResultSet.fieldJD( column$ )
Возвращает номер столбца (тип Integer) в таблице результатов по заданному параметром columnS (тип String) имени поля (тоже из таблицы результатов). Первый столбец имеет номер 1, второй - 2, и т.д.
Ошибки: несуществующий столбец (DBstsINVC).
Метод fieldName - «определение имени поля/столбца»
fieldName$ = odbcResultSet.fieldNam^ columned)
Возвращает имя поля (тип String) по заданному параметром column id (тип Integer, но можно использовать любой числовой тип за исключением Currency) номеру столбца в
©InterTrustCo, Тел. (095)9567928
772 Lotus Domino R, 5: @-формулы, LotusScript, встроенные классы LotusScript и Java
таблице результатов. Для вычисляемых полей возвращаемые значения будут соответственно Computed I, Computed2 и т.д.
Ошибки: несуществующий столбец (DBstsINVC).
Метод fieldNativeDataType - «определение типа унаследованных данных»
formatValue - odbcResultSet.ueldNatrveDataType(column_id%) или formatValue = odbcResultSet.&eldNativeDsttaType(column Name$ )
Возвращает унаследованный от базы данных тип поля в таблице результатов. Поле задают номером столбца column_Jd% (тип Integer) или названием column_Name$ (тип String). Возвращаемое значение может быть одним из следующих:
SQL CHAR SQLJFLOAT SQL_TIMESTAMP SQL^LONGVARBINARY
SQL_NUMER1C SQL REAL SQL VARCHAR SQL_BIGINT
SQL_DECIMAL SQL_DOUBLE SQL BINARY , SQLJTINYINT
SQLJNTEGER SQL_DATE SQL VARBINARY SQLJBIT
SQL_SMALLINT SQLJTIME SQL_LONG VARCHAR
Для уяснения роли данного метода обратите внимание на метод FieldExpectedDataType. Ошибки: несуществующий столбец (DBstsINVC).
Метод fieldExpectedDataType - «определение/установка ожидаемого типа данных» :. .-....--. ... :.....
dataType = oJ&c.Re5w/ё$Позволяет определять текущий и устанавливать нужный "ожидаемый тип" - тот тип, которым данные поля из таблицы результатов будут передаваться в скрипт (по GetValue). Параметр column (тип Integer или String) задает номер столбца или имя поля. Параметр dataType при установке определяет, в какой тип должны преобразовываться данные поля. Возвращаемое значение dataType "сообщает" текущий (ранее установленный) тип. Допустимые значения для dataType: DBJTYPEJJNDEFINED, DB_CHAR, DB_SHORT, DB LONG, DB DOUBLE, DB DATE, DBJTIME, DB BINARY, DBJBOOL, DBJDATETIME.
Значения всех полей по умолчанию передаются в таблицу результатов "унаследованным от базы данных типом" - тем типом, который они имеют в базе данных. Однако Вы можете пожелать, чтобы поступающие в Ваш скрипт данные имели некоторый иной тип, например, чтобы информация из числового поля преобразовывалась в строку. Некоторые преобразования типа данных невозможны, например, DB BINARY нельзя преобразовать в любой тип отличный от Variant или String.
Ошибки: несуществующий столбец (DBstsINVC).
Метод fieldlnfo - «определение характеристик столбца»
infoArray = odbcResuhSet.ueMlnfo( column id% ) или infoArra = odbcResultSet.fieldlafo( column_Name$ )
Возвращает массив характеристик указанного столбца, который задается номером столбца column_id% (тип Integer) или названием column_Name$ (тип String).
© InterTrust Co. Тел. (095) 9567928
Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java
Элементы возвращаемого массива определяются по следующей таблице:
773

Имя параметра Тип Значение значения
DB INFO AUTOINCREMENT Булевское True, если столбец определен как автоинкрементный (т.е. увеличивающий свое значение на единицу для каждой новой строки).
DB INFO CASESENSITIVE Булевское True, если столбец определен как "чувствительный к регистру", т.е. символы в значениях полей могут быть как в верхнем, так и в нижнем регистре.
DB_INFO_COLUMNID Строка Номер столбца. Значение в точности совпадает с возвращаемым значением метода FileldlD.
DB_INFO_COLUMNAME Строка Имя столбца. Значение в точности совпадает с возвращаемым значением метода FileldName.
DB INFO COMPUTED Булевское True, если значение столбца определяется по формуле.
DB INFO DISPLAYSIZE Целое Максимальное значение при отображении в символах (не в байтах).
DB_INFO_EXPECTED DATATYPE Целое Ожидаемый тип данных для столбца. Значение в точности совпадает с возвращаемым значением метода FileldExpectedDataType.
DB_INFO_LENGTH Целое Значение в точности совпадает с возвращаемым значением метода FileldSize.
DB_IFOJMONEY Булевское True, если столбец содержит значения для валюты.
DB INFO_NATIVE DATATYPE Целое Унаследованный тип данных для столбца. Значение в точности совпадает с возвращаемым значением метода FileldNativeDataType.
DB INFOJNULLABLE Целое Значение может быть одним из следующих:
DB_NOJNULLS - для столбцов, значение которых не может быть пустым;
t DB_NULLABLE - для столбцов, \ значение которых может быть \ . . . пустым;
DB_NULL_UNKNOWN - для ; столбцов, статус которых по отношению к пустым значениям, определить невозможно.

© InterTrust Co. Тел. (095) 9567928
774 Lotus Domino R. 5: @гформулы, LotusScript, встроенные классы LotusScript и Java

DEMNFO_PRECESION Целое Максимальная разрядность значения.
DB_JNFO_READONLY Целое Свойство столбца источника "только для чтения". Это свойство не связано со свойством таблицы результатов Readonly. Значение может быть одним из
следующих:
« DB_READONLY - для столбцов с установленным свойством "только для чтения";
DBJREADWRITE - для столбцов с выключенным свойством "только для
чтения";
DB_READONLY_UNKNOWN - для
столбцов, статус которых по отношению к свойству "только для | чтения", определить невозможно. DB_TNFO_SCALE Целое Максимальное число знаков после запятой. Значение имеет смысл только для типов Real и Float, для остальных -возвращаемое значение есть 0.
DB_INFO_ SEARCHABLE Целое Значение может быть одним из следующих:
DBJJNSEARCHABLE - столбец не может участвовать в условии выбора с ключевым словом Where в SQL-операторе;
* DB_LIKE_ONLY - столбец может участвовать в условии выбора с ключевым словом Where в SQL-операторе только в операторе Like;
DB_ALLEXEPT_LIKE - столбец может участвовать в условии выбора с ключевым словом Where в SQL-операторе везде кроме оператора Like;
DB_SEARCHABLE - столбец может участвовать в любом условии выбора с ключевым словом Where в SQL-операторе. DB_fNFO_SETABLE Булевское False - если метод SetValue не может присвоить значение полю по причине, либо столбец имеет свойство "только для чтения", либо база данных источника имеет свойство "только для чтения", либо установлено свойство Readonly для таблицы результатов, либо столбец вычисляемый. True - если метод SetValue может присвоить значение полю, однако это не гарантирует от ошибок. Так, например, даже если столбец требует уникальных значений, метод SetValue

© InterTrust Co. Тел. (095) 9567928
Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java
775



может присвоить повторяющееся значение.

DB_INFO_SQLDATATYPE
Целое
Унаследованный тип данных для столбца. Значение в точности совпадает с возвращаемым значением метода FileldNativeDataType.

DB INFO_TABLENAME
Строка
Имя таблицы, содержащей указанный столбец. Если столбец вычисляемый, или составленный из разных таблиц, то возвращается пустая строка.

DBJNFOJJNSIGNED
Булевское
True, если столбец содержит беззнаковые значения данных.

Не все источники данных поддерживают все характеристики из перечисленной таблицы, однако, стандарт ODBC требует от драйверов генерации полного отчета по вышеприведенной таблице.
Ошибки: несуществующий столбец (DBstsINVC).
Метод fieldSize- «определение максимального размера данных столбца»
size% = odbcResultSet.fie\dSize( column_id%) или
size% odbcResultSet.fieldSize( column_Name$ ) s
Возвращает максимальный размер (тип Integer) данных поля. Поле задают номером столбца column_id% (тип Integer) или названием column_Name$ (тип String). Размер зависит от типа поля. Например, размер поля переменной длины - максимальная длина поля, хотя сохраненный в поле текст может быть короче.
Возвращаемое значение может быть равно 0 для полей некоторых типов, позволяющих хранить большие объемы данных, например, для полей типа RichText.
Ошибки: несуществующий столбец (DBstsINVC).
Метод getValue - «получение значения поля текущей строки»
variable = odbcResultSet.getValue( column_id% [,variable] ) или variable - odbcResultSet.getVa\ue( column_Name$ {^variable} ) или Call odbcResultSet.getValue(column Name$, variable) пли Call odbcResultSet.getV»lue( column id%, variable )
Получает значение поля из текущей записи в таблице результатов и копирует значение в переменную variable. Поле задается номером столбца column_id% (тип Integer) или именем column_Name$ (тип String). Необязательный аргумент variable, если задается, должен быть именем той переменной, которой будет присвоено значение. Задание имени переменной еще и в качестве аргумента (это ссылка на переменную) позволяет методу предварительно "узнать" тип этой переменной.
Тип возвращаемых данных в первую очередь определяется типом второго аргумента. Если второй аргумент опущен, принимается тип данных, установленный для столбца методом FieldExpectedDataType. Например, можно устанавливать как "ожидаемый тип" вещественное значение для целочисленного числового поля. Если ничего из
© InterTrust Со. Тел. (095) 9567928
776 Lotus Domino R, 5: @-формулы, LotusScript, встроенные классы LotusScript и Java
предшествующего не имеет места, выбирается тип данных, "наиболее близкий" к типу, унаследованному полем в таблице результатов из базы данных.
При использовании методов GetValue и SetValue требуют специального рассмотрения "пустые" значения. Факт наличия "пустого" значения в поле распознается методом IsValueNull. Если аргумент типа Variant, "пустое" значение поля возвращается как EMPTY. Иначе данные, возвращаемые методом GetValue, преобразуются в необходимый тип данных LotusScript: для целых и вещественных типов возвращается значение 0, для строк - строка нулевой длины "", для типа "дата-время" - соответствующая форма "нуля".
События: BeforeGetValue, AfterGetValue. Ошибки:
несуществующий столбец (DBstsINVC);
таблица результатов не содержит данных (DBstsNODA);
» невозможно осуществить конвертацию данных (DBstsCNVR).
Метод isValueNull - «проверка поля на нулевой значение»
flag% = odbcResultSet.\sValue;Null( column _id%) или flag% = odbcResultSel.isValueNull(column Name$ )
Возвращает True, если значение поля текущей записи в таблице результатов "пустое", или False, если нет. Поле задается номером столбца column_id% (тип Integer) или именем column Name$ (тип String).
Ошибки: несуществующий столбец (DBstsINVC).
Метод setValue - «установка значения поля текущей строки»
status = odbcResultSeLsetValue( column id%, value ) или status = odbcResultSet.setVal\ie( column_Name$ , value )
Устанавливает новое значение value полю в текущей записи. Поле задается номером столбца column_id% (тип Integer) или именем column Name$ (тип String). Возвращает True, если метод завершился успешно, или False, если нет (в частности, когда таблица результатов доступна только для чтения).
Задаваемое значение должно быть типа, допускающего преобразование к типу поля, унаследованного им из базы данных (см. свойство FieldNativeDataType). Если полю необходимо присвоить "пустое" значение, укажите в качестве аргумента value NULL.
Фактические изменения в источнике данных произойдут, когда отработает метод UpdateRow, а в режиме отложенных транзакций "еще позже" - когда отработает операция commit.
События: AfterSetValue, BeforeSetValue. Ошибки:
несуществующий столбец (DBstsINVC);
таблица результатов не содержит данных (DBstsNODA);
невозможно осуществить конвертацию данных (DBstsCNVR);
значение не может быть присвоено из-за свойства "только для чтения" (DBstsRDON);
строка перед выполнением операции уже была удалена (DBstsROWD).
© InterTrust Co. Тел. (095) 9567928
Lotus Domino R, 5: @-формулы, LotusScript, встроенные классы LotusScript и Java IT!
Метод isValueAltered - «определение изменялось ли значение поля»
flag% ~ odbcResultSeLlsValueAltered( column jd% ) или flag% - odbcResultSet.I$ValueAltereВозвращает True, если значение поля текущей записи в таблице результатов изменено методом SetValue, или False, если нет. Поле задается номером столбца column_id% (тип Integer) или именем column JName$ (тип String).
Этот "флажок" остается истинным до выполнения метода UpdateRow или DeleteRow. Метод Close удаляет весь кэш.
Ошибки: несуществующий столбец (DBstsINVC).
Метод locateRow - «поиск определенной строки»
status = odbcResultSet.}ocateRaw( column_id% или column JName$ , value
f, column jd2% или columnJMame2$ , value2 [, column_id3% или column_Name3$ , valueS ] ] )
Находит и делает текущей ту запись в таблице результатов, которая содержит в указанных полях указанные значения. Поле(я) задаются номером столбца column_id% (тип Integer) или именем column_Name$ (тип String). Нужное(ые) значения задаются аргументом
value.
ВНИМАНИЕ: в документации сказано, что тип данных аргумента value есть String. Однако, из опыта известно, что для правильной работы метода тип данных аргумента value должен совпадать с реальным типом данных искомого столбца. То есть, если в столбце column хранятся значения даты-времени или числовые, то и тип value должен быть соответственно дата-время или числовой.
Метод возвращается True, если соответствующая запись найдена. Иначе возвращается False и генерируется ошибка, анализируя код которой можно выявить причину подробнее.
Поля и значения, если необходимо, задаются "парами". Допустимо не более трех таких "пар". "Пустое" значение поля задается как NULL.
Метод осуществляет поиск по таблице результатов от текущей записи в направлении конца таблицы, пропуская удаленные записи. Если очередная запись соответствует критерию поиска, она становится текущей, и метод успешно завершается. Проверка критерия выполняется без учета регистра.
Чтобы получить еще одну удовлетворяющую критерию запись, необходимо вызвать метод NextRow перед очередным вызовом LocateRow, это особенно важно помнить при использовании метода внутри цикла, в противном случае получится бесконечный цикл. Чтобы поиск начинался с начала таблицы результатов, нужно вызвать метод FirstRow перед вызовом LocateRow.
В случае если установлено свойство CacheLimit, после выхода курсора за пределы допустимой памяти возвращаемое значение метода будет не определено.
Поиск ведется без учета регистра. Также нельзя использовать выражения в качестве значения для поиска.
События: BeforeLocateRow, AfterLocateRow, BeforeRowPositionChange,
AfterRowPositionChange.
Ошибки:
* таблица результатов не содержит данных (DBstsNODA);
© InterTrust Co. Тел. (095) 9567928
778 Lotus Domino R. S: @-формулы, LotusScript, встроенные классы LotusScript и Java
достигнут конец данных в таблице результатов (DBstsEOFD);
отсутствует доступ к текущей строке (DBstsCARR).
Пример. В таблице результатов Res имеется три столбца данных. Второй имеет числовой тип данных, а третий - типа дата-время. Скрипт в цикле удаляет из таблицы источника Rooms строки, в которых значение второго столбца равно 666, или значение третьего столбца соответствует 1 апреля 1999 года. Изменения передаются в источник данных.
Flag = Res.FirstRow
MyExit = False
DelDate = DateNumber( 1999, 04, 01) ' 1 апреля 1999 года
Do
Flag = Res.LocateRow( 2, 666 )
If Flag Th
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·Метод addRow - «добавление новой строки»
status = odbcResultSet.nduRow
Добавляет в пространство для новых записей в таблице результатов (ADDROW workspace) новую пустую запись.
Обычно последовательность действий такова: вызываем AddRow для создания пустой записи в ADDROW workspace; используя SetVaJue, заносим в поля записи нужные данные;
© InterTrust Со. Тел. (095) 9567928
Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 779
вызываем UpdateRow для помещения записи в источник данных, а если база поддерживает отложенные транзакции, то еще и Commit или Rollback. Учтите, что в ADDROW workspace может находиться только одна запись.
Добавленная запись не считается частью кэшируемой таблицы результатов. Текущая позиция курсора может располагаться или в таблице результатов, или на добавленной записи. Первый вызов AddRow устанавливает курсор на добавленную запись. Вы можете переустановить курсор обратно в таблицу результатов, используя методы CurrentRow, LocateRow, FirstRow или LastRow. Когда курсор уже находится в таблице результатов, Вы можете также использовать методы PrevRow и NextRow. Если возникает необходимость вновь установить курсор на добавленную запись, воспользуйтесь свойством CurrentRow с специальную константой DB_ADDROW (подобно res. CurrentRow = DB ADDROW). Методы PrevRow и NextRow не позволяют "перейти" на добавленную запись. Для проверки того, находится ли курсор в таблице результатов или на добавленной записи, используйте свойство CurrentRow с константой DB ADDROW.
В случае успешного применения метода UpdateRow пространство ADDROW workspace закрывается и с помощью свойства CurrentRow с константой DB ADDROW уже нельзя "попасть" на добавленную запись. Метод UpdateRow только посылает изменения в таблице результатов в источник данных, но не обновляет саму таблицу результатов. Для изменения таблицы результатов (например, в случае изменений в источнике данных) необходимо опять выполнить SQL-запрос.
Применение методов Execute и Close отменяют изменения в пространстве ADDROW workspace.
Если SQL-запрос содержит не все столбцы из таблицы, то применение метода AddRow присвоит не перечисленным столбцам, в списке столбцов из SQL-запроса, значение NULL.
Л События: BeforeAddRow, After AddRow. Ошибки:
в пространстве ADDROW workspace уже есть одна строка (DBstsAHVR);
значение не может быть присвоено из-за свойства "только для чтения" (DBstsRDON);
выполнение метода закончилось неуспешно, или таблица результатов закрыта (DBstsNOEX).
Метод deleieRow-«удаление текущей строки»
status = odbcResultSet.deleteRovf( tableName$ )
Удаляет из указанной аргументом tableNameS (тип String) таблицы в базе данных запись, соответствующую текущей записи в таблице результатов. Параметр tableNameS необходим для устранения неоднозначности: ведь таблица результатов могла быть получена в результате выполнения SQL-запроса по многим таблицам из источника данных.
Метод DeleteRow не имеет смысла, если таблица результатов или база данных доступны только для чтения. Если база данных поддерживает отложенную обработку транзакций, действительное удаление записи произойдет позже (commit) или будет "откачено" (rollback).
Метод DeleteRow не изменяет значение свойства NumRows, так что значение свойства CurrentRow не нуждается в пересчете.
Применение метода заканчивается ошибкой, если колонки таблицы результатов содержат данные типа графических образов или RichText поля, а также в случае, если в таблице результатов присутствуют дублирующиеся строки.
События: BeforeDeleteRow, AfterDeleteRow. Ошибки:
© InterTrust Co. Тел. (095) 9567928
780 Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java
неправильный номер строки (DBstsINVR);
в таблице результатов есть дублирующиеся строки (DBstsNUNQ);
данные не могут быть изменены или удалены из-за свойства "только для чтения" (DBstsRDON);
» возможно появление ошибки "about not being applicable to the AddRow workspace" (невозможно выполнение из-за ошибок, связанных с пространством для добавления новой записи). Возникновение этой ошибки связано с появлением перед выполнением метода других ошибок.
Метод updateRow - «передача изменений из текущей строки в источник данных»
status = odbcResultSet. updateRow \
Заносит изменения из текущей записи в таблице результатов в базу данных. Возвращает True, если запись была успешно изменена, или False, если запись была изменена другим пользователем или процессом или база данных доступна только для чтения.
В случае если перед выполнением данного метода вызывался метод AddRow, то UpdateRow добавит в источник данных новую запись.
Применение метода заканчивается ошибкой, если колонки таблицы результатов содержат данные типа графических образов или RichText поля, а также в случае, если в таблице
результатов присутствуют дублирующиеся строки.
События: BeforeUpdateRow, AfterUpdateRow, Ошибки:
данные не могут быть изменены или удалены из-за свойства "только для чтения" (DBstsRDON);
в таблице результатов есть дублирующиеся строки (DBstsNUNQ);
текущая строка была удалена (DBstsROWD);
в текущей строке нет изменений (DBstsRUNC).
т
Метод getRowStatus - «определение характеристик текущей записи»
statua% = odbcResultSet.getRovrStat\is
Возвращает состояние текущей записи в таблице результатов:
DB_UNCHANGED - никаких изменений не произошло, все осталось в том виде, как выбрано из базы;
DB ALTERED - были внесены изменения методом SetValue;
DB_UPDATED - был выполнен метод UpdateRow;
DB_DELETED - был выполнен метод DeleteRow;
DB_NEWROW - был выполнен метод AddRow, но значения в строке не были установлены методом SetValue.
Свойство HasRowChanged отражает изменения, произошедшие в записи из источника данных. Эти изменения никак не воздействуют на состояние записи в таблице результатов.
Как только запись удалена, применение к ней методов SetValue или UpdateRow будет вызывать ошибку, однако метод GetValue допустим.
Ошибки: таблица результатов не содержит данных (DBstsNODA). © InterTrust Co. Тел. (095) 9567928
Lotus Domino R, 5: @-формулы, LotusScript, встроенные массы LotusScript и Java 781
Метод close - «закрытие таблицы результатов/пространства для добавления новой записи»
status = odbcResultSet.close [( option )]
Закрывает таблицу результатов и выполняет или "откатывает" изменения в источнике данных. Параметр option может быть одной из следующих констант:
DB CLOSE - закрывает целиком таблицу результатов (по умолчанию - при отсутствии параметра);
DB_CANCELADDROW - закрывает только пространство, используемое для добавления новой записи (AddRow workspace).
После выполнения метода Close объект ODBCResultSet все еще существует, однако почти все данные в нем (в частности, таблица результатов) не определены. Вы можете пользоваться некоторыми свойствами объекта ODBCResultSet, включая Query, а так же "вновь переоткрыть" таблицу результатов методом Execute.
Таблица результатов может быть использована и после отсоединения от источника данных, однако в этом случает никакие изменения в таблице результатов не отразятся в источнике данных и наоборот. Для выборки всех данных за один проход установите свойство CacheLimit в значение DB_ALL, выполните запрос и вызовите метод LastRow. После этого можно отсоединиться от источника данных и использовать таблицу результатов.
События: BeforeClose, AfterClose.
Параметры в запросах
В оператор SQL, задаваемый методом Query, для объекта класса ODBCQuery могут включаться параметры (в отличие от ODBC и стандартного SQL). Это позволяет разработчику создавать достаточно универсальные скрипты: В скрипт "зашивается" параметризованный запрос, а конкретные значения параметров непосредственно перед выполнением запроса в диалоге задает пользователь.
Параметр "вставляется" в текст запроса "обрамленным", словно кавычками, знаками "?", например:
SELECT * from ?tablename? where amount > ?break?
Если просматривать текст запроса слева направо, каждому параметру можно присвоить порядковый номер - т.н. индекс параметра. Первый параметр в запросе имеет индекс 1, второй - индекс 2, и т.д. Таким образом, к параметру можно обратиться как по имени, так и по индексу.
Метод numParameters - «определение числа параметров в запросе»
пит% = odbcResultSet. numParameters
Возвращает количество параметров (тип Integer) в запросе, или 0, если их нет. Ошибки: недопустимый объект запрос (DBstsNQOJ).
Метод getParameterName- «получение имени параметра»
пате = odbcResultSet. getParameterName( parameter'_index% )
Возвращает имя параметра (тип String) по его индексу (тип Integer). "Обрамляющие" имя параметра символы "?" не включаются в возвращаемое значение.
© InterTrust Co. Тел. (095) 9567928
782 Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java События: BeforeGetParameterName, AfterGetParameterNarae.
Метод setParameter - «установка значения параметра»
status = odbcResultSet.setPsirfimeter(' parameter_name$ , value$ ) или status = odbcResultSet.setPar&meter{parameter_index% , value$ )
Присваивает параметру заменяющее значение value$ (тип String). Параметр задается своим именем parameterNameS (тип String) или индексом parameter jndex% (тип Integer). Возвращает True, если "замена" прошла успешно, или False, если параметр в запросе не обнаружен. Если параметру необходимо присвоить "пустое" значение, укажите в качестве аргумента valued NULL.
В случае если по синтаксису запроса требуется задание параметра, обрамленного одинарными кавычками, необходимо указывать их при его задании методом SetParameter (см. пример).
События: BeforeSetParameter, AfterSetParameter.
\
Пример. Параметр в примере требует заключение его в одинарные кавычки.
Query.SQL = 'SELECT * FROM SOURCE WHERE NAME = ?name?' '
result.Set Parameter("name","'Evgenii V Polyakov'")
Метод getParameter - «получение последнего значения параметра»
value - odbcResultSet,geiPsirameter(parameterName$ ) или
value odbcResu!tSet.getParameter( parameter jndex%) , -
Возвращает последнее значение параметра. Параметр задается своим именем parameterNameS (тип String) или индексом parameter_index% (тип Integer).
События: BeforeGetParameter, AfterGetParameter.
(
Пример. В запросе содержатся два параметра - имена полей. Пользователь вводит значения для замены параметров в диалоговых окнах,
у
Dim con As New ODBCConnection ' ...
Dim qry As New ODBCQuery
Dim res As New ODBCResultSet '
Con.ConnectTo ( "dBASE Files" ) ' .......
Set Qry.Connection = Con
Qry.SQL = "SELECT custmr_id, ?field2?, ?field3? FROM customer"
Set Res.Query = Qry
s% = Res.SetParameter( "field2", InputBox?("Field Name 2" )) s% = Res.SetParameter( 2, InputBox$( "Field Name 3" )}
Г '
Res.Execute
Messagebox "E'ield Name #2 : " & Res. GetParameter ( 1 ) ь
Messagebox "Field Name #3 :" & Res.GetParameter( 2 )
© InterTrust Co. Тел. (095) 9567928
Lotus Domino R. 5: @гформулы, LotusScript, встроенные классы LotusScript и Java 783
4.5. Методы классов ODBCConnection, ODBCQuery и ODBCResuItSet
для обработки ошибок
Ошибки могут случиться при работе практически всех методов или свойств любого из трех классов. Рассматриваемые здесь методы позволяют определить код ошибки, а по нему получить текст краткого сообщения об ошибке, или текст подробного описания ошибки. Программист может или "проверять" ошибки или каждый раз после того, как использованы какой-либо метод или свойство, или создать обработчик ошибок с использованием оператора ON ERROR, что более рационально, поскольку позволяет сосредоточить обработку ошибок в одном месте. ,
Подробный перечень ошибок можно найти в описании метода GetErrorMessage в базе данных Notes Help. Значения кода ошибки сгруппированы в три общих категории:
ошибки из-за недопустимых параметров
ошибки в базе данных
ошибки, связанные с тем, что метод или свойство не поддерживаются этой базой данных.
Метод getError - «возвращение кода последней ошибки»
error% = odbcConnection.geiError
error% = odbcQuery.getError
error% - odbcResultSet.geiError
Возвращает значение кода последней произошедшей ошибки (тип Integer).
Метод getErrorMessage - «возвращение краткого сообщения об ошибке»
message$ = odbcConnection.getErrorM.essage( [ errorvalue ] ) messages - odbcQuery.getErrorMess»ge( [errorvalue }) message$ odbcResultSet.getErrorMessage( [ errorvalue ] )
По заданному коду ошибки errorvalue возвращает краткое сообщение об ошибке message$. В качестве errorvalue может быть задан код, ранее возвращенный методом GetError, или константа DB_LASTERROR, "ссылающаяся" на имевший место быть последним код ошибки. Так же для задания номера ошибки могут использоваться константы из нижеприведенной таблицы:
Константа Сообщение на английском языке Перевод
DBstsSUCCES Not an error, SUCCES (cannot be Ошибок нет, (данную ситуацию нельзя 'J' ' * trapped by ON ERROR) использовать в обработчике ошибок по
ON ERROR).
DBstsACCS Unable to get user ID and password Невозможно получить имя и пароль
пользователя.
DBstsAHVR The previous added row has not been Строка, которая перед этим была
updated добавлена, не может быть изменена.
DBstsBADP Bad parameter Недопустимый параметр.
DBstsCANF Cannot find named data source Требуемый источник данных не найден.
DBstsCARR Cannot access requested row Нет доступа к требуемой записи.
DBstsCCON Unable to connect Соединение невозможно.
© InterTrust Co. Тел. (095) 9567928
784 Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java

DBstsCNVD String length exceeded Превышена длина строки.
DBstsCNVR Cannot convert data from native to Невозможно преобразовать данные из expected or requested datatype унаследованного формата в ожидаемый или требуемый формат.
DBstsCOAR Operation not allowed on AddRow Операция недопустима в пространстве workspace для добавления новой записи.
DBstsCPAR Cannot position at AddRow Невозможно позиционироваться в пространстве для добавления новой записи.
DBstsCXIN Could not execute insert or update Невозможно выполнить операцию добавления новой или изменение текущей записи.
DBstsENTR Entry missing Пропущена точка входа. DBstsEOFD End of data has been reached Достигнут конец данных.
DBstsFAIL TLe operation failed for unspecified Операция закончилась неудачно по reason неопределенным причинам.
DBstsHSTMT ODBC could not allocate a new ODBC не может разместить указатель на statement handle новый оператор.
DBstslLLG Unrecognized or illegal data type Нераспознаваемый или недопустимый тип данных.
DBstsFNTR Internal buffer limit reached when Достигнуто ограничение внутреннего creating a string буфера при создании строки.
DBstsINVC Field ID is out of range Недопустимый номер столбца. DBstslNVR Invalid row number Недопустимый номер строки. DBstsMEMF Out of memory "Нехватка" памяти.
DBstsNAFI Cannot insert new row before Невозможно вставить новую строку, т.к. AddRow в пространстве для добавления новых строк уже есть строка.
DBstsNOCJ No valid connection object Нет допустимого объекта соединения.
DBstsNCOL Table did not return any columns Некоторые столбцы не могут быть возвращены из таблицы.
DBstsNCON Not connected to a data source Нет соединения с источником данных.
DBstsNODA The result contains no data Таблица результатов не содержит данных.
DBstsNOEX Never executed successfully or result Таблица результатов не была создана set closed или была закрыта.
DBstsNQOJ No valid query object Нет допустимого объекта SQL-запрос.
DBstsNUNQ Update or Delete cannot locate а Операции удаления или изменения unique data row строки не могут быть выполнены по причине дублирующихся строк.
DBstsODBC ODBC could not complete the ODBC не может завершить требуемую requested operation операцию.

© InterTrust Co. Тел. (095) 9567928
Lotus Domino R. 5: (а^-формулы, LotusScript, встроенные классы LotusScript и Java
785

DBstsPMIS
Missing parameter in query
Пропущен параметр в запросе.

DBstsRCHG
Original row data changed. Cannot be updated or deleteed
Исходная строка была изменена. Операции удаления или изменения строки не могут быть выполнены.

DBstsRDON
Read Only. Data cannot be updateed or deleleted
Установлено свойство "только для чтения". Данные не могут быть изменены или удалены.

DBstsROWD
The row has previously been deleted
Строка перед выполнением операции была удалена.

DBstsRUNC
No changes in row
В строке нет изменений.

DBstsSNFD
A resource string could not be found in resource file
Строка ресурса не найдена в файле ресурсов.

DBstsUBLE
Column Not Updateable
Данный столбец не может быть изменен.

DBstsUNIM
Unimplemented feature
Зарезервированная ошибка.

Метод getExtendedErrorMessage - «возвращение подробного описания ощибки»
extendedMessage$ 0<#>cCo«wec/70/7.getExtendedErrorMessage( errorvalue ) extendedMessageS = ocgMerv.getExtendedErrorMessage( errorvalue ) extendedMessage$ = odbcResu!tSet.getExteadedErrorMessage( errorvalue )
По заданному коду ошибки errorvalue возвращает подробное описание возникшей ошибки extendedMessageS. В качестве errorvalue может быть задан код, ранее возвращенный методом GetError, или константа DB LASTERROR, обозначающая код последней возникшей ошибки.
4.6. Собственная обработка событий, возникающих при вызове методов классов ODBCConnection, ODBCQuery и ODBCResultSet
Многим методам из классов ODBCConnection, ODBCQuery и ODBCResultSet при их выполнении предшествуют и/или следуют после выполнения определенные события. Каждое событие имеет свое уникальное имя, например, BeforeGetParameter для метода GetParameter класса ODBCResultSet. Конкретные имена всех возникающих событий приведены в описании методов классов в данной главе.
Разработчики имеют возможность написать свои обработчики определенных событий с помощью оператора On Event. Синтаксис данного оператора следующий:
On Event имя_событш From имя^объекта Call гтя_процедуры ,
где:
имя_события - соответственно имя события согласно документации, например, BeforeGetParameter;
имя объекта - имя экземпляра класса, для которого будет происходить обработка события, например, result;
имя_процедуры - имя процедуры, которая будет вызываться при возникновении указанного события.
© InterTrust Co. Тел. (095) 9567928
786 Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java
Первый аргумент у процедуры, вызываемой по событию, должен быть объект, в рамках которого это событие возникает. .......
Пример. Перед удалением текущей записи во всех других записях таблицы результатов проверяется значением второго поля, и если оно равно "QWERTY", то данное значение заменяется на пустую строку. Задача решена с помощью использования события BeforeDeleteRow.
Dim con As New ODBCConnection
Dim qry As New ODBCQuery
Dim result As New ODBCResultSet .... . .
On Event BeforeDeleteRow from result Call MyPrevDelete
'Здесь идут операторы установки соединения, выполнения SQL-запроса 'и поиска строки, которую надо удалить
flag = result. DeleteRow ' . , "."/-.-.
Sub MyPrevDelete ( res As ODBCResultSet ) .
Dim row^old as Long Dim my_value as String
row__old = res. CurrentRow ' ' -_.... ' - i
flag = res.FirstRow ,
Do ;
my_value = res.GetValue( 2 ) If my__value = "QWERTY" Then
flag = res.SetValue( 2, "" ) flag = res.UpdateRow End If res.NextRow
Loop Until res.IsEndOfData
res.CurrentRow = row_old '
End Sub
4.7. Примеры чтения и добавления записей
Приведем два простых примера, которые могут использоваться для проверки работоспособности классов ODBCConnection, ODBCQuery и ODBCResultSet. Эти примеры были написаны и отлажены для работы с базами данных формата dBase IV.
Пример 1. Выполняет соединение с источником данных с именем "dBASE Files", формирует по таблице customer таблицу результатов из трех полей и добавляет информацию из таблицы результатов в поле типа RichText с именем Others из текущего документа.
Option Public '
Uselsx "*LSXODBC" -
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·Тел. (095) 9567928
Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 787
Set Qry.Connection = Con
Qry.SQL = "SELECT custmr_id, company, address FROM customer"
Set Res.Query = Qry
Res.Execute
While res.nextrow .
1$ = Res.G
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
Пример 2. Выполняет соединение с источником данных с именем "dBASE Files", формирует по таблице customer таблицу результатов из всех полей, добавляет в таблицу результатов новую запись и методом UpdateRow заносит ее из таблицы результатов в таблицу custome
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·
·Поле1" )
status = res.SetValue( 2, "*Поле2" )
status = res.SetValue( 3, "*ПолеЗ" )
status = res.UpdateRow
If status = True Then
Messagebox "The new record has been created" Else
Messagebox "Could not create record - The driver " _
& "or data source may be read only." End If
res. Closet DB_Close )
con.Disconnect
Else
Messagebox ( "Could not connect to data source" ) End If
© InterTrust Co. Тел. (095) 9567928
788 Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java
5. Приложения
5.1. Алфавитный список @-функций

Функция Область применения Краткое описание
@Abs Без ограничений. Возвращает модуль числа или числового списка.
@Abstract Нельзя использовать в Осуществляет выделение и замену в формулах отбора, колонок. тексте определенных его частей, видимости объекта, редактируемой секции, формы и навигатора. Работает только с текстом, представленным в однобайтовой кодировке. При использовании с RTF-полями документ должен перед применением функции быть сохранен.
@Accessed Нельзя использовать в Возвращает величину "дата-время" формулах навигатора. Функция последнего доступа (для чтения или "' "чувствительна" к часовому записи) к документу, поясу.
@Acos Без ограничений. Аргумент Возвращает значение арккосинуса должен лежать в пределах [- числа или числового списка. 1,1].
@AddToFolder Разрешается использование в Добавляет текущий документ в
формулах активных папку с именем, содержащимся в Стр. 5 в f пиктограмм, кнопок и агентов, первом аргументе, удаляя при этом
тот же документ из папки, имя которой находится во втором аргументе.
@Adjust Без ограничений. Функция Изменяет величину "дата-время" на "чувствительна" к часовому заданный интервал времени. Р° поясу.
@АН Без ограничений. Всегда возвращает 1 (TRUE). Стр. 76
@AHChildren Разрешается использовать Конструкция SELECT только в формулах отбора формула_отбора @AllChildren ТР' документов и селективной отобирет все документы, репликации. Не работает в удовлетворяющие формуле отбора, версиях Lotus Notes/Domino плюс документы, которые являются ниже R4. документами-ответами только на документы, удовлетворяющие формуле отбора.
@AllDescendants Разрешается использовать Конструкция SELECT только в формулах отбора формула отбора | @AllDescendants "' документов и селективной отбирает все документы, репликации. Не работает в удовлетворяющие формуле отбора, версиях Lotus Notes/Domino плюс документы, которые являются ниже R4. документами-ответами и

© InterTrust Co. Тел. (095) 9567928
Lotus Domino R. 5: @гформулы, LotusScript, встроенные классы LotusScript и Java 789

документами-ответами на ответ на : всех уровнях дерева, '-'" "начинающегося" только от документов, удовлетворяющих формуле отбора.
@Ascii Без ограничений. Преобразует строку или список строк, представленных в кодировке ^ LMBCS (Lotus Multi-Byte Character - Set) соответственно в строку или список строк в кодировке ASCII.
@Asin Без ограничений. Аргумент Возвращает значение арксинуса должен лежать в пределах [- числа или числового списка. Ы].
@Atan Без ограничений. Возвращает значение арктангенса числа или числового списка.
@Atan2 Без ограничений. Аргументы Возвращает значение арктангенса от должны быть числа или дроби второго аргумента на первый, числовые списки.
@AttachmentLengths Нельзя использовать в Возвращает число или числовой формулах навигатора. . . список приблизительного размера в байтах присоединенных файлов.
@AttachmentNames Нельзя использовать в Возвращает строку или текстовый формулах навигатора. список имен присоединенных файлов.
@Attachments Нельзя использовать в Возвращает число присоединенных
формулах навигатора. файлов. > Стр. 52
@Author . : . Нельзя использовать в Возвращает текстовый список формулах навигатора. авторов текущего документа.
@Begins Без ограничений. Определяет, является ли заданная
' подстрока (или хотя бы один из
Стр.31 ч .-..- ч г элементов списка подстрок)
началом строки.
@BrowserInfo Нельзя использовать в Определяет и возвращает параметры формулах отбора и колонок. используемого браузера.
@Certificate Разрешается использовать Возвращает информацию о только в формулах отбора, заверенном открытом ключе колонок, агентов и полей. Не (Certified Public Key) из общей работает в Web-приложениях. адресной книги
@Char Без ограничений. Код символа Преобразует код символа в должен быть числом и лежать в односимвольную строку в ™' интервале от 0 до 255. Дробные соответствии с 850-й кодовой * " значения автоматически страницей IBM. усекаются до целого.
@CheckAlarm Нельзя использовать в Применяется для изменения формулах отбора, колонок, параметров оповещения в личном редактируемой секции, почтовом ящике, заголовка окна, полей, формы и области размещения.

© InterTrust Co. Тел. (095) 9567928
790 Lotus Domino R. 5: @гформулы, LotusScript, встроенные классы LotusScript и Java
@ClientType Нельзя использовать в Возвращает текстовую строку
формулах отбора, колонок, "Notes", если для доступа к базе Стр. 98 г редактируемых секциях и данных используется клиентская
заголовка окна. При программа LN, "Web" - в случае использовании в формулах использования браузера, фоновых агентов всегда возвращает значение "None".
@Command Нельзя использовать в Выполняет команды LN. формулах отбора, колонок, Большинство стандартных команд видимости объектов, из системного меню LN можно редактируемой секции, формы, выполнить с помощью этой полей, заголовка окна и функции, фоновых агентов.
(«^Contains Без ограничений. Определяет, является ли подстрока
(или хотя бы один из элементов Стр. 32 , г списка подстрок) частью строки.
@Cos Без ограничений. Возвращает значение косинуса числа или числового списка.
@Created Нельзя использовать в Возвращает время и дату создания формулах навигатора. При документа. ' ' использовании в формулах полей возвращаемое значение определяется по часам сервера, j если база данных не является / локальной. Функция 1 "чувствительна" к часовому . , поясу.
@Date Без ограничений. Функция Возвращает заданную параметрами "чувствительна" к часовому дату как величину типа "дата-ТР- поясу. время", но содержащую только компоненту даты.
@Day Без ограничений. Функция Извлекает день месяца из указанной
"чувствительна" к часовому даты. Стр. 4 1 : * s F поясу.
@DbCoIumn Нельзя использовать в Находит и возвращает колонку формулах отбора, колонок и значений из вида или папки в базе (базы данных LN) почтовых агентов. данных Notes/Domino. Стр.67 Ограниченно применима в формулах всплывающих окон. Возвращаемое значение не должно превышать 64 Кбайта. Не работает при установке переменной окружения NoExternalApps равной 1 .
@DbCoIumn Нельзя использовать в Использует для доступа к формулах отбора, колонок, соответствующей таблице и колонке (UJJtJLJ видимости объекта, ODBC-драйвер, соответствующий Стр. 71 редактируемой секции, указанному источнику данных, заголовка окна и почтовых Извлекает значения из одной агентов. Возвращаемое колонки в таблице, значение не должно превышать 64 Кбайта. Не работает при установке переменной окружения NoExternalApps
© InterTrust Co. Тел. (095) 9567928

Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java
791

равной 1.
@DbCommand Нельзя использовать в Выполняет указанную команду формулах отбора, колонок, ODBC- драйвера, или осуществляет ТР' всплывающих окон и почтовых навигацию в Web-приложениях. ; t : 1 агентов. Ограниченно , ...... Tfj- применима в Web-приложениях. Возвращаемое значение не должно превышать г? ;i '.>:.-. 64 Кбайта. Не работает при установке переменной окружения NoExternalApps равной 1.
@DbExists Нельзя использовать в Возвращает 1(Тше), если база формулах отбора, колонок, существует, или 0(False) в ™' всплывающих окон и фоновых противном случае, агентов.
@DbLookup Нельзя использовать в Получив значение ключа, функция формулах отбора, колонок и просматривает указанный вид или
1 ПЯЧЫ ГТЯННЫХ 1 N 1
Woom «""шил ^lv почтовых агентов. папку и находит в них все Стр. 69 Ограниченно применима в документы, содержащие значение формулах всплывающих окон, "ключ" в первой отсортированной Ограниченно отбирает колонке, значения из RTF-полей. Результирующее значение может быть неточным, если : первая сортировочная колонка "вида" содержит поле, которое : ... - может принимать несколько . значений (multi-values field), и сортировка колонки указана без категоризации. Возвращаемое значение не должно превышать 64 Кбайта. Не работает при установке переменной окружения , NoExternalApps равной 1 .
@DbLookup Нельзя использовать в Использует соответствующий (тлппг'ч формулах отбора, колонок, указанному источнику данных ((JU ^) заголовка окна, видимости ODBC-драйвер для доступа к Стр. 74 объекта, редактируемой секции соответствующей таблице и и почтовых агентов. колонкам. Извлекает и возвращает Возвращаемое значение не значения из указанной колонки, должно превышать 64 Кбайта. принадлежащие к тем записям, у Не работает при установке которых значение в ключевой переменной окружения колонке совпадает с указанным NoExternalApps равной 1. параметром ключ.
@DbManager Нельзя использовать в Возвращает список групп, формулах отбора, колонок. При пользователей и серверов, имеющих ТР' использовании в формуле доступ менеджера к текущей базе, заголовка окна возвращает , , только первое найденное в " " ' ; ACL значение, имеющее ; л; .'« доступ менеджера.
@DbName Без ограничений. Возвращает для текущей базы данных имя сервера и собственно

© InterTrust Со. Тел. (095) 9567928
792 Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java
Стр.102 базы данных. @DbTitle Без ограничений. Возвращает название текущей базы
стр.102 *" ^г^'--:- "' - ' '- Д™-
@DDEExecute Нельзя использовать в Передает указанному DDE-формулах отбора, колонок, приложению команду и выполняет заголовка окна, формы и ее. Возвращаемое значение навигатора. Не работает под @Тгае(1) в случае удачного управлением операционной выполнения команды, @False(0) в среды MacOS и UNIX. He противном случае, работает при установке переменной окружения - NoExternalApps равной 1 . Не , работает в Web-приложениях.
@DDEInitiate Нельзя использовать в Инициирует связь с DDE-сервером и формулах отбора, колонок, возвращает полученный заголовка окна, формы и идентификатор связи с сервером, навигатора. Не работает под управлением операционной ; среды MacOS и UNIX. Не работает при установке переменной окружения NoExteraalApps равной 1 . Не „ / работает в Web-приложениях.
@DDEPoke Нельзя использовать в Передает данные указанному DDE-формулах отбора, колонок, приложению. Возвращаемое заголовка окна, формы и значение @Тше(1) в случае навигатора. Не работает под удачного выполнения команды, управлением операционной @False(0) в противном случае, среды MacOS и UNIX. He работает при установке переменной окружения NoExternalApps рав ной 1. Не работает в Web-приложениях.
@DDETerminate Нельзя использовать в Завершает связь с указанным DDE-формулах отбора, колонок, приложением, заголовка окна, формы и . =; навигатора. Не работает под ' управлением операционной среды MacOS и UNIX. Не работает при установке переменной окружения NoExternalApps равной 1. Не " г ; "' ' работает в Web-приложениях.
DEFAULT Без ограничений. На время выполнения формулы
_ присваивает полю значение по т^' умолчанию.
@DeleteDocument Разрешается использовать Удаляет документ, обрабатываемый только в формулах агентов. В агентом. ТР' Web-приложениях не работает.
@DeleteField Нельзя использовать в Удаляет поле из текущего формулах заголовка окна, документа. ТР' отбора, колонок, формы и навигатора

Стр.102 базы данных.
@DbTitle Без ограничений. Возвращает название текущей базы
стр.102 *" ^г^'--:- "' - ' '- Д™-
@DDEExecute Нельзя использовать в Передает указанному DDE-
формулах отбора, колонок, приложению команду и выполняет заголовка окна, формы и ее. Возвращаемое значение
навигатора. Не работает под @Тгае(1) в случае удачного управлением операционной выполнения команды, @False(0) в среды MacOS и UNIX. He противном случае,
работает при установке переменной окружения
- NoExternalApps равной 1. Не t ,
работает в Web-приложениях.
@DDEInitiate Нельзя использовать в Инициирует связь с DDE-сервером и
формулах отбора, колонок, возвращает полученный
заголовка окна, формы и идентификатор связи с сервером,
навигатора. Не работает под
управлением операционной ;
среды MacOS и UNIX. Не работает при установке переменной окружения
NoExteraalApps равной 1. Не „ /
работает в Web-приложениях.
@DDEPoke Нельзя использовать в Передает данные указанному DDE-
формулах отбора, колонок, приложению. Возвращаемое
заголовка окна, формы и значение @Тше(1) в случае
навигатора. Не работает под удачного выполнения команды, управлением операционной @False(0) в противном случае, среды MacOS и UNIX. He работает при установке переменной окружения NoExternalApps равной 1. Не работает в Web-приложениях.
@DDETerminate Нельзя использовать в Завершает связь с указанным DDE-
формулах отбора, колонок, приложением, заголовка окна, формы и . =;
навигатора. Не работает под
' управлением операционной
среды MacOS и UNIX. Не работает при установке переменной окружения NoExternalApps равной 1. Не
"г ; "' ' работает в Web-приложениях.
DEFAULT Без ограничений. На время выполнения формулы
_ присваивает полю значение по
т^' умолчанию.
@DeleteDocument Разрешается использовать Удаляет документ, обрабатываемый
только в формулах агентов. В агентом. ТР' Web-приложениях не работает.
@DeleteField Нельзя использовать в Удаляет поле из текущего
формулах заголовка окна, документа.
ТР' отбора, колонок, формы и
навигатора
© InterTrust Co. Тел. (095) 9567928
Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 793
@DialogBox Нельзя использовать в Открывает в модальном диалоговом формулах отбора, колонок, окне текущий документ по т'э' почтовых агентов и агентов, указанной форме. При закрытии ------ выполняющихся по модального окна может передать расписанию, видимости изменения, произошедшие в его ' ' , ' - объекта, заголовка окна и полях, в основной документ. : ' формы. Не передает данные из ; RTF-полей. Не работает при установке переменной окружения NoExternalApps равной 1. В Web-приложениях не работает.
@Do Нельзя использовать в Используется для ' формулах отбора и столбцов. последовательного вычисления т')' , г--.,, нескольких выражений. Вычисляет выражения слева направо и возвращает значение последнего ~ " выражения.
@DocChildren Разрешается использовать Используется для определения только в формулах колонок и числа ответных документов у ™' ..-...-.-. заголовка окна. Ограниченно текущего документа или категории ; ' применима в формулах полей, (считаются только документы-! В Web-приложениях работает ответы на текущий документ, но ни только в формулах колонок. ответы на ответы).
@DocDescendants Разрешается использовать Используется для определения только в формулах колонок и числа ответных документов у
ОТО. 78 <" MKV"'i ,;ьо'-и ' - \ v - Л
f f" заголовка окна. Ограниченно текущего документа или категории у * > применима в формулах полей, (считаются документы-ответы и f -'.*'-" - = ; В Web-приложениях работает ответ-на-ответ у текущего ' "' " только в формулах колонок. документа).
@DocFieIds Нельзя использовать в Возвращает текстовый список, формулах отбора, колонок и содержащий имена всех полей в
ч^Ти, 0 / .„..,-..-
v навигатора. , текущем документе.
@DocLength п Нельзя использовать в Возвращает приблизительный формулах навигатора. размер документа в байтах.
\^/Тр. Зл
@DocLevel Разрешается использовать Возвращает значение только в формулах колонок и представляющее текущий уровень ^ , . заголовка окна. Ограниченно документа или категории в дереве применима в формулах полей, ответов. В Web-приложениях работает только в формулах колонок.
@DocMark Разрешается использовать Устанавливает для текущего только в формулах агентов. В документа пометку: сохранены/не Web-приложениях не работает, сохранены его изменения на диске.
@DocNumber Разрешается использовать Возвращает значение, только в формулах колонок и представляющее иерархический "^' заголовка окна. Ограниченно уровень текущего документа или применима в формулах полей, категории в дереве ответов. Г " В Web-приложениях работает только в формулах колонок. ;
@DocParentNumber Разрешается использовать Возвращает значение, только в формулах колонок и представляющее иерархический ТР' заголовка окна. Ограниченно уровень родительского документа

@DialogBox Нельзя использовать в Открывает в модальном диалоговом
формулах отбора, колонок, окне текущий документ по
т'э' почтовых агентов и агентов, указанной форме. При закрытии
------ выполняющихся по модального окна может передать
расписанию, видимости изменения, произошедшие в его
' ' объекта, заголовка окна и полях, в основной документ.
:' формы. Не передает данные из
; RTF-полей. Не работает при
установке переменной окружения NoExternalApps равной 1. В Web-приложениях не работает.
@Do Нельзя использовать в Используется для
' формулах отбора и столбцов. последовательного вычисления
т')' , г--.,, нескольких выражений. Вычисляет
' "''; выражения слева направо и
возвращает значение последнего
~" выражения.
@DocChildren Разрешается использовать Используется для определения
только в формулах колонок и числа ответных документов у
™' ..-...-.-. заголовка окна. Ограниченно текущего документа или категории
; ' применима в формулах полей, (считаются только документы-
! В Web-приложениях работает ответы на текущий документ, но ни
только в формулах колонок. ответы на ответы).
@DocDescendants Разрешается использовать Используется для определения
_ _„ только в формулах колонок и числа ответных документов у
Сто. 78 i"M«'',~'j ,.'-<'' «,-- ^
f f" заголовка окна. Ограниченно текущего документа или категории
у * > применима в формулах полей, (считаются документы-ответы и
f -'.*'-" - = ; В Web-приложениях работает ответ-на-ответ у текущего
' ' " только в формулах колонок. документа).
@DocFieIds Нельзя использовать в Возвращает текстовый список,
формулах отбора, колонок и содержащий имена всех полей в
ч^Ту» О / .„..,-..-
v навигатора. , текущем документе.
@DocLength п Нельзя использовать в Возвращает приблизительный
формулах навигатора. размер документа в байтах.
\^/Тр. Jjё
@DocLevel Разрешается использовать Возвращает значение
только в формулах колонок и представляющее текущий уровень
^ , . заголовка окна. Ограниченно документа или категории в дереве
применима в формулах полей, ответов. В Web-приложениях работает только в формулах колонок.
@DocMark Разрешается использовать Устанавливает для текущего
только в формулах агентов. В документа пометку: сохранены/не
Web-приложениях не работает, сохранены его изменения на диске.
@DocNumber Разрешается использовать Возвращает значение,
только в формулах колонок и представляющее иерархический
"^' заголовка окна. Ограниченно уровень текущего документа или
применима в формулах полей, категории в дереве ответов.
Г " В Web-приложениях работает
только в формулах колонок. ;
@DocParentNumber Разрешается использовать Возвращает значение,
только в формулах колонок и представляющее иерархический
^ заголовка окна. Ограниченно уровень родительского документа
© InterTrust Со. Тел. (095) 9567928
794 Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java
применима в формулах полей, или категории в дереве ответов. В Web-приложениях работает только в формулах колонок.
@DocSublings Разрешается использовать Возвращает значение ,,, только в формулах колонок и представляющее количество т'э' заголовка окна. Ограниченно документов или категорий на применима в формулах полей, текущем уровне иерархии в дереве В Web-приложениях работает ответов, только в формулах колонок.
@I>ocumentUniqueID Нельзя использовать в Возвращает так называемый формулах навигатора. В универсальный идентификатор ^ , \ формулах полей создает документа (UNID) - 32-х ссылку (DocLink) на текущий символьную комбинацию букв и документ. При отправке такого цифр, уникально . „ документа по почте, ссылка идентифицирующую текущий , , теряется, так как она документ во всех репликах , , определяет местоположение распределенной базы, документа только в пределах текущей базы данных. :
@Domain „. . , Нельзя использовать в Возвращает имя домена для ,,"„., формулах навигатора. При текущего пользователя из личной ^ ,. _ выполнении на сервере адресной книги, в соответствии с , , , , возвращает домен сервера. В текущим местом вызова. Web-приложениях не работает.
@EditECL Нельзя использовать в Выводит модальное диалоговое формулах отбора, колонок, окно с параметрами списка редактируемой секции, управления выполнением рабочей видимости объекта, заголовка станции администратора для окна, поля, формы, акций указанного списка управления _ видов и формы и области выполнением и указанной адресной " размещения. книги.
@EditUserECL Нельзя использовать в Выводит модальное диалоговое формулах отбора, колонок, окно с параметрами списка -..-.- . .- " ."': . редактируемой секции, управления выполнением текущей * j . видимости объекта, заголовка рабочей станции, окна, поля, формы, акций ..ч- видов и формы и области » i: г,; . размещения.
(о) Elements Без ограничений. Вычисляет и возвращает в формате
_ "" числа количество текстовых, Стр. 45 ,, „ г числовых или дата-время
элементов в списке.
@EnableAlarms Нельзя использовать в Включает или выключает механизм формулах отбора, колонок, оповещения в почтовом ящике, видимости объекта, редактируемой секции.
@Ends Без ограничений. Определяет, находится ли заданная подстрока (или хотя бы один из ТР' элементов списка подстрок) в самом конце строки.
@Environment Нельзя использовать в Устанавливает или возвращает формулах отбора, колонок, значение переменной окружения. Стр" 48 навигатора и Web-

применима в формулах полей, или категории в дереве ответов. В Web-приложениях работает только в формулах колонок.
@DocSublings Разрешается использовать Возвращает значение
,,, только в формулах колонок и представляющее количество
т'э' заголовка окна. Ограниченно документов или категорий на
применима в формулах полей, текущем уровне иерархии в дереве
В Web-приложениях работает ответов, только в формулах колонок.
@I>ocumentUniqueID Нельзя использовать в Возвращает так называемый
формулах навигатора. В универсальный идентификатор
^ , \ формулах полей создает документа (UNID) - 32-х
ссылку (DocLink) на текущий символьную комбинацию букв и документ. При отправке такого цифр, уникально
. „ документа по почте, ссылка идентифицирующую текущий
, , теряется, так как она документ во всех репликах
, , определяет местоположение распределенной базы, документа только в пределах текущей базы данных. :
@Domain „.., Нельзя использовать в Возвращает имя домена для
,,"„., формулах навигатора. При текущего пользователя из личной
^ ,. _ выполнении на сервере адресной книги, в соответствии с
, , ,, возвращает домен сервера. В текущим местом вызова.
Web-приложениях не работает.
@EditECL Нельзя использовать в Выводит модальное диалоговое
формулах отбора, колонок, окно с параметрами списка
редактируемой секции, управления выполнением рабочей
видимости объекта, заголовка станции администратора для
окна, поля, формы, акций указанного списка управления
_ видов и формы и области выполнением и указанной адресной
" размещения. книги.
@EditUserECL Нельзя использовать в Выводит модальное диалоговое
формулах отбора, колонок, окно с параметрами списка
-..-.-. .- "."': . редактируемой секции, управления выполнением текущей
* j . видимости объекта, заголовка рабочей станции.
окна, поля, формы, акций
..ч- видов и формы и области » i: г,;
. размещения.
(о) Elements Без ограничений. Вычисляет и возвращает в формате
_ "" числа количество текстовых,
Стр. 45 „ „
г числовых или дата-время
элементов в списке.
@EnableAlarms Нельзя использовать в Включает или выключает механизм
формулах отбора, колонок, оповещения в почтовом ящике, видимости объекта, редактируемой секции.
@Ends Без ограничений. Определяет, находится ли заданная
подстрока (или хотя бы один из
ТР' элементов списка подстрок) в самом
конце строки.
@Environment Нельзя использовать в Устанавливает или возвращает
формулах отбора, колонок, значение переменной окружения.
Стр'48 навигатора и Web- [
© InterTrust Co. Тел. (095)9567928
Lotus Domino R. 5: @гформулы, LotusScript, встроенные классы LotusScript и Java 795
приложениях. Ограниченно применима в формулах всплывающих окон. Для присвоения переменным окружения значения при использовании в теле других функций (таких как @If или @Do) применяйте функцию @SetEnvironment. В формулах выполняющихся на сервере, -например, в теле агента по . расписанию, идет обращение к переменным окружения сервера, а не рабочей станции. Возвращаемое значение всегда есть текстовая строка.
ENVIRONMENT Нельзя использовать в Присваивает значение переменной формулах отбора, колонок, окружения ™' видимости объекта, навигатора и Web-приложениях. Ограниченно применима в , ; формулах всплывающих окон.
@Error Без ограничений. Генерирует ситуацию ошибки. >. , Возвращаемое значение @Error.
L^XD. I wt" \
@Ехр Без ограничений. Аргумент Вычисляет значение должен лежать в пределах [- экспоненциальной функции от числа 11355.1371,11356.5234]. или числового списка.
@ExpIode Без ограничений. Возвращает список, составленный из подстрок списка строк или ^' диапазона дат. ,
@Failure . Предназначена для В формуле проверки вводимых использования в формулах данных редактируемых полей, ^ ; проверки вводимых данных функция выводит диалоговое окно с ..--.. редактируемых полей, но текстом сообщения об ошибке. ;чу может быть также - - ' использована в формулах . формы и агентов. В последнем i , , случае, только возвращает г;.;, значение, но не выводит предупреждающих сообщений.
@False Без ограничений. Возвращает 0 (False).
FIELD Нельзя использовать в Присваивает значение полю, формулах отбора, колонок, ТР' видимости объекта, заголовка окна, формы и навигатора. ; .
@FontList В DOMINO R 5.0 НЕ Возвращает список доступных
ДОКУМЕНТИРОВАНА. шрифтов в виде текстового списка. Стр. 103
@FormLanguage В DOMINO R 5.0 НЕ Для баз, использующих формы с ДОКУМЕНТИРОВАНА. поддержкой нескольких языков, возвращает имя языка текущей : ^ формы.

приложениях. Ограниченно применима в формулах всплывающих окон. Для присвоения переменным окружения значения при использовании в теле других функций (таких как @If или @Do) применяйте функцию @SetEnvironment. В формулах выполняющихся на сервере, -
например, в теле агента по .
расписанию, идет обращение к переменным окружения сервера, а не рабочей станции. Возвращаемое значение всегда есть текстовая строка.
ENVIRONMENT Нельзя использовать в Присваивает значение переменной
формулах отбора, колонок, окружения ™' видимости объекта, навигатора
и Web-приложениях. Ограниченно применима в , ;
формулах всплывающих окон.
@Error Без ограничений. Генерирует ситуацию ошибки.
>. , Возвращаемое значение @Error.
L^XD. 1 wt" \
@Ехр Без ограничений. Аргумент Вычисляет значение
должен лежать в пределах [- экспоненциальной функции от числа 11355.1371,11356.5234]. или числового списка.
@ExpIode Без ограничений. Возвращает список, составленный
из подстрок списка строк или ^' диапазона дат. ,
@Failure . Предназначена для В формуле проверки вводимых
использования в формулах данных редактируемых полей,
^ ; проверки вводимых данных функция выводит диалоговое окно с
..--.. редактируемых полей, но текстом сообщения об ошибке.
;чу может быть также
- - ' использована в формулах . формы и агентов. В последнем i , ,
случае, только возвращает
г;;. значение, но не выводит
предупреждающих сообщений.
@False Без ограничений. Возвращает 0 (False).
FIELD Нельзя использовать в Присваивает значение полю.
формулах отбора, колонок, ТР' видимости объекта, заголовка
окна, формы и навигатора. ; .
@FontList В DOMINO R 5.0 НЕ Возвращает список доступных
ДОКУМЕНТИРОВАНА. шрифтов в виде текстового списка.
Стр. 103
@FormLanguage В DOMINO R 5.0 НЕ Для баз, использующих формы с
ДОКУМЕНТИРОВАНА. поддержкой нескольких языков,
возвращает имя языка текущей - формы.
:.'. -.:;< © InterTrust Co. Тел. (095) 9567928
796 Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java Ш
@GetDocFieId Нельзя использовать в Возвращает значение поля по его
формулах отбора, колонок, имени и универсальному Сто. 66 1 г всплывающих окон и идентификатору документа.
навигатора. Также нельзя использовать для получения значений полей текущего документа.
@GetPortsList Нельзя использовать в Возвращает текстовый список формулах отбора, колонок. Не включенных/выключенных портов, работает в Web-приложениях. I
<й),Се1Р*оЩе1?\й,\Л уйлзйй» таспользовать в Функция возвращает значение поля
формулах отбора, колонок, из профильного документа по имени Стр. об ,--видимости объекта, поля и имени документа.
редактируемой секции, заголовка окна, полей, формы, акций формы и вида и области размещения.
@HardDeleteDocument В DOMINO R 5.0 ФУНКЦИЯ ПОЛНОСТЬЮ НЕ
^ fa ДОКУМЕНТИРОВАНА
Стр. 58
Работает в формулах агентов. Физически удаляет документ из базы данных.
@Hour Без ограничений. Функция Возвращает количество часов в "чувствительна" к часовому параметре "дата-время". Стр' 42 поясу.
@If Без ограничений. Осуществляет проверку входящих в ' \" ' него условий, и выполняет связанное с истинным (TRUE) - , ? ' условием действие. Возвращается ; : - i->' значение выполненного действия.
@lmplode Без ограничений. "Сцепляет" все элементы списка
с 28 г>,;: >: w ( строк в одну строку.
@InheritedDocumentUniq Нельзя использовать в Возвращает универсальный иеГО .;: формулах навигатора. идентификатор документа, который Предназначена для работы с был текущим в момент создания ТР' документами, созданными по документа, для которого форме с включенной опцией используется эта функция, наследования полей. Если опция не включена, возвращает такое же значение, что и @DocumentUniqueID. В формулах полей создает .. . .. ,„ , . ссылку (DocLink) на текущий документ. Однако при отправке такого документа по почте, | ссылка теряется,- так как oH8j«v-< , ,v,j?;, и . . определяет местоположение „ , ' " ! <":;*'.<.., ; документа только в пределах ''* ;-;:"*:; текущей базы данных. '
@Integer ., , , ,..,-,' Без ограничений. Возвращает целую часть числа или числового списка.
@IsAgentEnabled Нельзя использовать в Возвращает 1 (True) для формулах отбора, колонок, "включенного" агента, 0 (False) если

@GetDocFieId Нельзя использовать в Возвращает значение поля по его
формулах отбора, колонок, имени и универсальному
Сто. 66 1
г всплывающих окон и идентификатору документа.
навигатора. Также нельзя
использовать для получения
значений полей текущего |
документа. :
@GetPortsList Нельзя использовать в Возвращает текстовый список
формулах отбора, колонок. Не включенных/выключенных портов, работает в Web-приложениях. I \
@GetPvoGH.el?\s,\A уйлзйй» таспользовать в Функция возвращает значение поля !
формулах отбора, колонок, из профильного документа по имени
Стр. об ,--
видимости объекта, поля и имени документа.
редактируемой секции, заголовка окна, полей, формы, акций формы и вида и области размещения.
HiHardDdeteDocumentВ DOMINO R 5.0 ФУНКЦИЯ ПОЛНОСТЬЮ НЕ
^ fa ДОКУМЕНТИРОВАНА
Стр. 58
Работает в формулах агентов. Физически удаляет документ из
базы данных.
@Hour Без ограничений. Функция Возвращает количество часов в
"чувствительна" к часовому параметре "дата-время". Стр'42 поясу.
@If Без ограничений. Осуществляет проверку входящих в
' \" ' него условий, и выполняет
связанное с истинным (TRUE)
--....,-.-,?-"": условием действие. Возвращается
; : -: i->' значение выполненного действия.
@lmplode Без ограничений. "Сцепляет" все элементы списка
с 28 г>,;: >: w ( строк в одну строку.
@InheritedDocumentUniq Нельзя использовать в Возвращает универсальный
иеГО .;: формулах навигатора. идентификатор документа, который
Предназначена для работы с был текущим в момент создания ТР' документами, созданными по документа, для которого
форме с включенной опцией используется эта функция, наследования полей. Если опция не включена, возвращает такое же значение, что и @DocumentUniqueID. В формулах полей создает
.. ... ,„ , . ссылку (DocLink) на текущий
документ. Однако при отправке такого документа по почте, | ссылка теряется,- так как ощ*,ъ~.<, ,^к, ,*
. . определяет местоположение . . _ /
' " ! <":;*'.<.., ; документа только в пределах ''* ;-;:"*:;
текущей базы данных. '
@Integer ., , ; ....,-,' Без ограничений. Возвращает целую часть числа или
числового списка.
@IsAgentEnabled Нельзя использовать в Возвращает 1 (True) для формулах отбора, колонок, "включенного" агента, 0 (False) если
© InterTrust Со. Тел. (095) 9567928
Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 797
заголовка окна и формы. База он не включен, или не существует, данных должна быть открыта, в противном случае возвращается 0. Для агентов : созданных в LN версии 3.x и -.,-- ' для агентов, выполняющихся не по расписанию, всегда : возвращает 1 . Не работает в Web-приложениях.
@IsAppInstalIed В DOMINO R 5.0 НЕ Определяет тип установленного ДОКУМЕНТИРОВАНА. клиентского программного
Т^' „ _ , обеспечения (дизайнерский Работает в формулах . ^ г . , ... клиент/администраторский клиент), видимости объекта, акций г г
формы и видов, и кнопок.
@IsAvailable Нельзя использовать в Проверяют наличие в документе формулах навигатора. В поля с указанным именем. ТР' формуле колонок может использоваться только для определения суммарных ' ; значений.
@IsCategory Разрешается использовать Проверяет, является ли строка в только в формулах колонок. В виде категорией или нет. Web-приложениях не работает.
@IsDocBeingEdited Разрешается использовать Возвращает 1 (TRUE), если текущий только в формулах кнопок, документ находится в режиме ТР' видимости объектов, полей и редактирования, или 0 (FALSE) в акций формы. противном случае.
@IsDocBeingLoaded Разрешается использовать Возвращает 1 (TRUE), если текущий только в формулах видимости документ в настоящее время ТР' . -....-.- объекта, заголовка окна, полей загружается в память для
. .- . .:.., ...,.... , ''-..:> и формы. последующего отображения, или 0 , (FALSE) в противном случае.
@IsDocBeingMailed Разрешается использовать в Возвращает 1 (TRUE), если в ., ..?,;:,, формулах полей, может настоящее время текущий документ ТР'' , ; ограниченно использоваться в отправляется почтой, или 0 (FALSE) ; - формулах активных в противном случае. > пиктограмм, кнопок, гиперобъектов и акций формы.
@IsDocBeingRecalculated Разрешается использовать в Возвращает 1 (TRUE), если в формулах полей, может настоящее время текущий документ ™' ограниченно использоваться в пересчитывается, , или 0 (FALSE) в формулах активных противном случае. 1 пиктограмм, кнопок, гиперобъектов и акций формы.
@IsDocBeingSaved Разрешается использовать в Возвращает 1 (TRUE), если в формулах полей, может настоящее время текущий документ т^' ..> ограниченно использоваться в сохраняется, , или 0 (FALSE) в ',' формулах активных противном случае. ' ''"' пиктофамм, кнопок, . гиперобъектов и акций формы. ;, ' ,
@IsDocTruncated Нельзя использовать в Возвращает 1 (TRUE), если текущий формулах навигатора. документ является "усеченным" в процессе репликации, , или 0

заголовка окна и формы. База он не включен, или не существует, данных должна быть открыта, в противном случае возвращается 0. Для агентов
: созданных в LN версии 3.x и
-.,-- ' для агентов, выполняющихся
не по расписанию, всегда :
возвращает 1. Не работает в
Web-приложениях.
@IsAppInstalIed В DOMINO R 5.0 НЕ Определяет тип установленного
ДОКУМЕНТИРОВАНА. клиентского программного
Т^' „ _ , обеспечения (дизайнерский
Работает в формулах . ^ г .
, ... клиент/администраторский клиент),
видимости объекта, акций г г
формы и видов, и кнопок.
@IsAvailable Нельзя использовать в Проверяют наличие в документе
формулах навигатора. В поля с указанным именем.
ТР' формуле колонок может
использоваться только для определения суммарных ' ; значений.
@IsCategory Разрешается использовать Проверяет, является ли строка в
; 4 только в формулах колонок. В виде категорией или нет.
Web-приложениях не работает.
@IsDocBeingEdited Разрешается использовать Возвращает 1 (TRUE), если текущий
только в формулах кнопок, документ находится в режиме
ТР' видимости объектов, полей и редактирования, или О (FALSE) в
акций формы. противном случае.
@IsDocBeingLoaded Разрешается использовать Возвращает 1 (TRUE), если текущий
только в формулах видимости документ в настоящее время
ТР' . -....-.- объекта, заголовка окна, полей загружается в память для
..-..:.., ...,.... , ''-..:> и формы. последующего отображения, или О
, (FALSE) в противном случае.
@IsDocBeingMailed Разрешается использовать в Возвращает 1 (TRUE), если в
., ..?,;:,, формулах полей, может настоящее время текущий документ
ТР'' , ; ограниченно использоваться в отправляется почтой, или О (FALSE)
; - формулах активных в противном случае. >
пиктограмм, кнопок, гиперобъектов и акций формы.
@IsDocBeingRecalculated Разрешается использовать в Возвращает 1 (TRUE), если в
формулах полей, может настоящее время текущий документ
™' ограниченно использоваться в пересчитывается,, или О (FALSE) в
формулах активных противном случае. 1 пиктограмм, кнопок,
гиперобъектов и акций формы.
@IsDocBeingSaved Разрешается использовать в Возвращает 1 (TRUE), если в
формулах полей, может настоящее время текущий документ
т^' ..> ограниченно использоваться в сохраняется,, или О (FALSE) в
',' формулах активных противном случае.
' ''"' пиктофамм, кнопок, . гиперобъектов и акций формы. ;, ' ,
@IsDocTruncated Нельзя использовать в Возвращает 1 (TRUE), если текущий
формулах навигатора. документ является "усеченным" в
". .".' ' процессе репликации,, или 0
© InterTrust Co. Тел. (095) 9567928
798 Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java
(FALSE) в противном случае.
@IsError Нельзя использовать в Возвращает 1 (TRUE) если поле,
_ .... формулах навигатора. временная переменная или Стр. 104 г- г. , выражение содержит ошибку, и 0
' (FALSE) в противном случае.
@Isёxpandable Разрешается использовать Используется для определения, только в формулах колонок. В является ли данный уровень ™' Web-приложениях не работает, документов в виде "разворачиваемым".
@IsMember Без ограничений. Возвращает 1 (TRUE), если строка является элементом списка строк, т^' или 0 (FALSE) в противном случае.
@IsModalHelp Без ограничений. В Web- Возвращает 1 (TRUE), если текущий приложениях не работает. документ является документом модальной подсказки, и 0 (FALSE) в противном случае.
@IsNewDoc Нельзя использовать в Возвращает 1 (TRUE), если формулах навигатора. редактируемый документ еще не ™' Корректно работает в сохранялся на диске, или 0 (FALSE) формулах активных в противном случае, пиктограмм, кнопок, видимости абзацев, доступа к секции, заголовка окна, полей, , ' . ; ! формы и акций формы. При ь -"! использовании в формулах ^ : ' ; столбцов, отбора документов, j , "' *.\ агентах и акциях видов всегда У ;- ,v. Т/, возвращает значение 0.
@IsNotMember Без ограничений. Возвращает 1 (TRUE), если строка , не является элементом списка строк, т*)' ,-, или 0 (FALSE) в противном случае.
@IsNumber Без ограничений. Проверяет значение и возвращает 1
Г '! i ' ' " ''''' ''-'"': (TRUE), если параметр является
^' ': ; , ЧИСЛОМ ИЛИ ЧИСЛОВЫМ СПИСКОМ, ИЛИ
0 (FALSE) в противном случае.
@IsResponseDoc Нельзя использовать в Возвращает 1 (TRUE), если формулах навигатора. Для документ является документом-ТР' документов, которые еще не ответом (Response), или 0 (FALSE) в , разу не сохранялись на диске, противном случае. » всегда возвращает значение 0.
@IsText Без ограничений. Возвращает 1 (TRUE), если параметр является строкой или Стр'25 . ., списком строк, или 0 (FALSE) в ......... противном случае.
@IsTime Без ограничений. Возвращает 1 (TRUE), если
....... . . , параметр является величиной или
ОТП 2 S
·
·
·
·
·списком величин дата-время , или : . 0 (FALSE) в противном случае.
@IsUnavailable Нельзя использовать в Проверяет наличие в документе
. формулах навигатора. поля с указанным именем. Стр. 57 '
@IsValid Нельзя использовать в Возвращает 1 (True) если все © InterTrust Со. Тел. (095) 9567928

Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 799
формулах отбора, колонок, формулы проверки для значений агентов по расписанию, текущей формы возвращают 1 видимости объектов и (True), или 0 (FALSE) в противном заголовка окна. случае.
@Keywords Без ограничений. Возвращает список, состоящий из всех тех элементов второго ™' , аргумента, которые содержатся "в качестве слов" в первом аргументе.
@LanguagePreference В DOMINO R 5.0 НЕ Возвращает пользовательские ДОКУМЕНТИРОВАНА. установки параметров национального языка.
@LaunchApp В DOMINO R 5.0 НЕ Запускает (или передает фокус) на ДОКУМЕНТИРОВАНА. зарегистрированное клиентское программное обеспечение (обычный клиент, дизайнер, администратор)
@Left Без ограничений. Возвращает указанное количество
символов от начала строки. Стр.34
@LeftBack Без ограничений. Возвращает все символы слева, считая от указанного числа ТР' символов с конца строки.
@Length Без ограничений. Возвращает число или числовой список, определяющее длину строки т')' или длины строк текстового списка.
@Like Без ограничений. Функция Проверяет указанную строку на поддерживается драйвером соответствие строке-образцу. Стр'33 NotesSQL ODBC.
@Ln Без ограничений. Аргумент Возвращает число или числовой должен быть болыпе нуля. список, являющийся натуральным логарифмом от аргумента.
@Locale В DOMINO R 5.0 НЕ Возвращает имя альтернативного ДОКУМЕНТИРОВАНА. языка по его коду.
@Log Без ограничений. Аргумент Возвращает число или числовой должен быть больше нуля. список, являющийся десятичным логарифмом от аргумента.
@LowerCase Без ограничений. Преобразует все символы строки-аргумента к нижнему регистру. Стр.30
@MailDbName Нельзя использовать в Возвращает двухэлементный формулах колонок. В Web- текстовый список формата "сервер": т^' приложениях не работает. "файл почтового ящика", соответствующий текущему размещению почтового ящика пользователя.
@MailEncryptSavedPrefer Нельзя использовать в Возвращает 1 (TRUE), если в общих епсе формулах колонок и отбора. В почтовых настройках отмечена Web-приложениях не работает, опция "Encrypt saved mail" Стр.64 (шифровать сохраняемую в , ., почтовом ящике почту), и 0 , ...;.. г" .... .:...... (FALSE) в противном случае.
@MaiIEncryptSentPrefere Нельзя использовать в Возвращает 1 (TRUE), если в общих © InterTrust Co. Тел. (095) 9567928

800 Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java
псе формулах колонок и отбора. В почтовых настройках отмечена : Web-приложениях не работает, опция "Encrypt sent mail" "' (шифровать отправляемую почту), и 0 (FALSE) в противном случае.
@MailSavePreference Нельзя использовать в Функция @MailSavePreference формулах колонок и отбора. В возвращает: ТР' Web-приложениях не работает. 0, если в общих почтовых настройках выбрано "Don't keep а сору" (не -сохранять копию);
1, если выбрано "Always keep a сору" (всегда сохранять копию);
2, если выбрано "Always prompt" (всегда выводить окно, позволяющее конкретно разрешить вопрос о сохранении). (o)Mai!Send Нельзя использовать в Функция отправляет текущий формулах отбора, колонок, документ получателю. ТР' ... ' видимости объекта, заголовка : , . окна и формы. Не работает при установке переменной окружения NoExternalApps равной 1 . В Web-приложениях не работает.
@MaiISignPreference Нельзя использовать в Возвращает 1 (TRUE), если в общих формулах колонок и отбора. В почтовых настройках отмечена ТР' -"-..- Web-приложениях не работает, опция "Sign sent mail" ("подписывать" отправляемую почту), и 0 (FALSE) в противном случае.
@Matches Без ограничений. Проверяет указанную строку на соответствие строке-образцу.
@Мах Без ограничений. Возвращает наибольшее из двух чисел или числовых списков. Для списков выполняется попарное сравнивание.
@Member Без ограничений. Возвращает 0, если строка не содержится в списке строк; ТР' возвращает величину от 1 до N, '''. определяющую положение строки в --'- списке строк.
@Middle Без ограничений. Возвращает указанное число символов из средины строки, ТР" просматривая ее слева направо.
@MiddleBack .Без ограничений. Возвращает указанное число символов из средины строки, ТР' , просматривая ее справа налево.
@Min Без ограничений. Возвращает наименьшее из двух чисел или числовых списков. Для списков выполняется попарное сравнивание. ......
© InterTrust Со. Тел. (095) 9567928

Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 801
@Minute Без ограничений. Функция Возвращает количество минут в "чувствительна" к часовому параметре "дата-время".
СТР'42 ПОЯСу. ,;/,;::: К; - «Г ;>
@Modified Корректно работает только в Возвращает величину "дата-время", формулах столбцов. Нельзя показывающую, когда документ в ™' использовать в формулах последний раз редактировался и навигатора, видимости объекта, сохранялся, формы, редактируемой секции, почтовых агентах и агентах, запускаемых по событию вставки документов из буфера '"'' обмена. При использовании в - формулах вычисляемых и вычисляемых для показа полей возвращает значение соответствующее предпоследнему, а не последнему времени ,-модификации. Функция "чувствительна" к часовому . поясу.
@Modulo Без ограничений. Второй Возвращает число или числовой аргумент не должен содержать список, соответствующий остатку от : элементов равных нулю. деления первого аргумента на ; . второй. В случае списков выполняется попарная операция вычисления остатка.
@Month ..,-..... Без ограничений. Функция Возвращает номер месяца в
_, , "чувствительна" к часовому параметре "дата-время". Стр. 41 г поясу.
@Name Без ограничений. При Возвращает определенные
использовании с именами, составляющие имени пользователя. Стр.81 г полученными из адресных книг
Lotus Notes, не работают форматы [A], [G], [I],[P], [Q] и [S]. Они предназначены для ; работы с именами адресов, пришедших из внешней (не Lotus Notes) почты. .
@NameLookup Без ограничений. Функция просматривает все ! ; ; . доступные адресные книги, ищет в < *- них пользователей с именами из второго аргумента и возвращает объединенный текстовый список с определенной параметрами функции информацией об этих пользователях.
@Narrow Предназначена для Преобразует строку из использования только в двухбайтовой кодировки DBCS в формулах полей. однобайтовую SBCS.
@NewLine Нельзя использовать в Вставляет символ перехода на формулах отбора, колонок, новую строку (возврат каретки) в ТР' .,. видимости объекта, формы, текстовую строку.
... >.,;;« .-. -. заголовка окна и в контексте функции @Prornpt (внутри
© InterTrust Со. Тел. (095) 9567928

802 Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java
функции @Prompt используйте ,; ; для перевода строки функцию , @Char с параметрами, ; соответствующими символу : возврата каретки для данной > платформы).
@No Без ограничений. Всегда возвращает 0.
@NoteID Нельзя использовать в Возвращает 8-и символьный
_ формулах навигатора. идентификатор документа в базе. Стр. 65
@Now Нельзя использовать в Возвращает текущие дату и время формулах формы. При как значение типа "дата-время". ТР" использовании в формулах полей, возвращает значение текущего времени по таймеру рабочей станции, а не сервера.
@OptimizeMailAddress Нельзя использовать в Функция удаляет из почтового формулах отбора, колонок, адреса все повторяющиеся в нем т^' видимости объекта, заголовка домены, окна и формы.
@Pas sword Без ограничений. Возвращает строку закодированную от исходной.
@PasswordQuality В DOMINO R 5.0 ФУНКЦИЯ ПОЛНОСТЬЮ НЕ ДОКУМЕНТИРОВАНА
@Pi Без ограничений. Возвращает число "пи".
@PickList Нельзя использовать в Выдает модальное диалоговое окно , формулах отбора, колонок, с информацией из определенной ТР' . почтовых агентов и агентов, базы данных или из доступных '-'.-,,-' - г выполняющихся по адресных книг. ; , . ....--' расписанию, видимости объекта, заголовка окна и .....; формы. Не работает при установке переменной окружения NoExternalApps . ! равной 1 . В Web-приложениях не работает.
@Platform Без ограничений. При Возвращает текстовый список или
-;--.. ,.,».; использовании в формулах строку, определяющую платформу ТР' .- отбора, колонок и фоновых сервера/клиента. . - агентов возвращает платформу . :... согласно местонахождению - базы данных. Для серверных ! -' . :. баз данных соответственно платформу сервера, для локальной базы данных -платформу клиента. В остальных формулах ' возвращает серверную платформу. В Web-' г приложениях возвращает ,, ---только серверную платформу.
@PostedCommand Нельзя использовать в Выполняет команду LN. формулах отбора, колонок, Большинство стандартных команд
© InterTrust Co. Тел. (095) 9567928

Lotus Domino R. 5: @гформулы, LotusScript, встроенные классы LotusScript и Java 803
видимости объектов, из системного меню LN можно ./ редактируемой секции, формы, выполнить-с помощью этой полей, заголовка окна и функции. Отличается от ©Command фоновых агентов. тем, что выполняется в формуле в : последнюю очередь, и не имеет i , ; возвращаемого значения.
@Power Без ограничений. Возвращает число или числовой список, соответствующий возведению первого аргумента в : степень второго. Для списков операция осуществляется попарно.
@Prompt Нельзя использовать в Используется для запроса формулах отбора, колонок, информации у пользователя. ТР' почтовых агентов и агентов, Функция показывает диалоговое выполняющихся по окно заданного стиля, с заданным , .: - расписанию. Ограниченно заголовком и текстом, и содержащее : ..--.. ,i применима в формулах информацию из остальных заголовка окна и формы. Не параметров. i ° -а"-. !:. . работает при установке ! ! переменной окружения NoExternaiApps равной 1 . В , ''' ',;,..,'., Г Web-приложениях не работает. ..'"" , ' '
@ProperCase Без ограничений. Преобразует первый символ каждого слова строки или ™' ; ' ' i текстового списка к верхнему ; регистру, а остальные символы - к нижнему.
@Random Без ограничений. ;; Генерирует случайное число в интервале [0,1].
@RefreshECL Нельзя использовать в Копирует список управления . формулах отбора, колонок, выполнением администратора из видимости объекта, указанной адресной книги на
..'...; ..",, ',...'. редактируемой секции, текущую рабочую станцию. \ .. , , v заголовка окна, полей, формы, ! '; области размещения, акций видов и формы.
КЕМ .-.,,,,:,.. Без ограничений. Позволяет включать в формулу
: - комментарии. Стр. 9 v
@Repeat .. . Без ограничений. Длина Возвращает строку, полученную из возвращаемой строки не исходной путем многократной ^' должна превышать 1 024 операции конкатенации ее с собой, символа.
@Replace Без ограничений. Ищет в списке строк значения, указанные в списке для поиска и ^ заменяет каждое найденное
i ''" значение соответствующим : ''' значением из списка для замены.
@ReplaceSubstring ' Без ограничений. Выполняет замены в исходной ' строке или списке строк всех ТР' '. ; вхождений слов или фраз из списка строк для поиска, на соответствующие слова или фразы
© InterTrust Со. Тел. (095) 9567928

804 Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java
из списка строк для замены.
(^Responses Предназначена только для Возвращает количество ответных использования в формулах документов (response) на текущий ™' заголовка окна. Не работает в документ в текущем виде. Web-приложениях.
@Return Нельзя использовать в Немедленно прекращает формулах колонок. выполнение формулы и возвращает ' указанное значение.
@Right Без ограничений. Возвращает указанное число
символов, считая от конца строки. Стр. 35 г
@RightBack Без ограничений. Просматривает строку слева , направо и возвращает все символы правее указанного числа символов.
@Round Без ограничений. Округляет число или элементы числового списка до наименьшего , ' . '''' } 's целого или если есть второй параметр, до ближайшего целого кратного второму параметру.
@Second Без ограничений. Извлекает и возвращает количество секунд в указанной величине "дата-Стр'42 время".
@Select Без ограничений. Возвращает значение в позиции,
_ . . заданной первым параметром. Стр.24
SELECT Разрешается использовать Определяет критерий для отбора только в формулах отбора, документов, которые будут ГР' агентах и акциях видов. обрабатываться.
@Set Без ограничений. Присваивает значение временной
: <э переменной. Стр.50 , ^ v
@SetDocField Нельзя использовать в Присваивает новое значение полю формулах отбора, колонок, по его имени и универсальному г'э' всплывающих окнах и идентификатору, навигатора. Также нельзя , использовать для изменения значений полей текущего документа.
@SetEnvironment Нельзя использовать в Устанавливает значение переменной формулах отбора, колонок, и окружения. ТР' Web-приложениях. Ограниченно применима в формулах всплывающих окон. Следует помнить, что в формулах выполняющихся на сервере идет обращение к переменным окружения сервера, а не рабочей станции. Возвращаемое значение всегда , ::- >. есть текстовая строка.
@SetField Нельзя использовать в Присваивает значение полю в формулах заголовка окна, текущем документе. ^ отбора, колонок, видимости
© InterTrust Co. Тел. (095) 9567928

Lotus Domino R. 5: (^формулы, LotusScript, встроенные классы LotusScript и Java 805
объекта, формы.
@SetProfiIeField Нельзя использовать в Присваивает значение полю в формулах отбора, колонок, профильном документе. 'ТР' ; видимости объекта, секции, заголовка окна, полей, формы, акций формы и вида и области размещения.
@SetTargetFrame Предназначена для Позволяет указать фрейм, в котором использования только в необходимо открыть вид, страницу, т^' формулах гиперобъектов и набор фреймов или акций видов и форм. создать/отредактировать документ.
@Sign Без ограничений. Определяет знак числа или элементов числового списка.
@Sin Без ограничений. Определяет синус числа или элементов числового списка.
@Soimdex Предназначена для Возвращает код "созвучия" для использования только в текстовой строки, формулах колонок адресных книг.
@Sqrt ' Без ограничений. Аргумент Определяет корень квадратный от должен быть положительным числа или элементов числового числом. списка.
@Subset Без ограничений. Возвращает указанное число
значений, считая от начала или Стр. 46 . -,. v -* конца списка.
@Success Предназначена для Возвращает 1 (TRUE).
_ : использования в формулах Сто. 104 v проверки вводимых данных
редактируемых полей.
@Sum Без ограничений. Возвращает сумму всех элементов
' с: и; числового списка или нескольких Стр.48 v числовых списков.
@Тап Без ограничений. Вычисляет тангенс числа или элементов числового списка.
@Text Без ограничений. Преобразует любое значение в
,-.--.. , текстовую строку или список строк. Стр. 26
@TextToNumber Без ограничений. Преобразует, если возможно, текстовую строку в число, или ТР' список строк в числовой список.
@TextToTime Без ограничений. Преобразует, если возможно, текстовую строку в величину "дата-ТР j время", или текстовый список в список величин типа "дата-время".
@Time Без ограничений. Преобразует заданное параметрами
....-,' время в величину типа "дата-время",
Сто 43 - ."',
v' :.--. --. '' ; ; ; г НО СОДерЖЗЩуЮ ТОЛЬКО КОМПОНСНТу
времени.
@Today Без ограничений. При Возвращает текущую дату, использовании в формулах полей, возвращает значение
© InterTrust Со. Тел. (095) 9567928

806 Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java
Стр. 39 текущей даты по таймеру рабочей станции, а не сервера.
@Tomorrow Без ограничений. При Возвращает значение "дата-время", использовании в формулах соответствующее завтрашнему дню. ТР' полей, возвращает значение "дата-время" по таймеру рабочей станции, а не сервера.
@Trim Без ограничений. Удаляет пробелы в начале, в конце и
внутри строки, или в списке строк. \-'Хр. j 1
@Тгае Без ограничений. Возвращает 1 (TRUE).
(«^Unavailable Нельзя использовать в Удаляет полев текущем документе, формулах заголовка окна, ТР' отбора, колонок, формы, навигатора и видимости объекта.
@UndeIeteDocument Разрешается использование в В случае если у базы установлено формулах агентов, кнопок и свойство "мягких" отметок об Т^' активных пиктограмм. удалении, снимает такие отметки с удаленных документов.
@Unique Без ограничений. При вызове без параметра возвращает случайным образом ™' сгенерированную уникальную строку. При вызове с параметром, удаляет из списка строк повторяющиеся значения.
@UpperCase Без ограничений. Преобразует все символы строки или списка строк к верхнему т^1' регистру.
@URLGetHeader Нельзя использовать в Возвращает определенную формулах отбора, колонок, информацию из заголовка видимости объекта, унифицированного локатора ресурса редактируемой секции, (URL). заголовка окна, полей и формы. Не работает в Web-приложениях.
@URLHistory Нельзя использовать в Выполняет определенные команды с формулах отбора, колонок, ресурсами URL, которые уже когда-видимости объекта, агентов по либо загружались и информация о расписанию, редактируемой них была сохранена в листке секции, заголовка окна, полей и предыстории URL (History URL формы. Не работает в Web- List), приложениях.
@URLOpen Нельзя использовать в Выдает диалоговое окно для формулах отбора, колонок, открытия ресурса URL, или видимости объекта, открывает ресурс URL. редактируемой секции, заголовка окна, полей и формы.
@UserAccess Нельзя использовать в Возвращает числовой список из формулах отбора, колонок и девяти элементов, позволяющий ™' фоновых агентов. В Notes R 4.x определить уровень доступа автоматически заменяется на текущего пользователя в указанной функцию @V4UserAccess. Для
© InterTrust Co. Тел, (095) 9567928

Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 807
локальных баз всегда базе, возвращает значение :-----' '- 6:1:1:1:1:1:1:1:1. Если пользователь не имеет доступа к базе, он получит сообщение: "You are not authorized to perform that operation. "(Вы .;,.; неавторизованы для ; выполнения данной операции). Не работает с оператором Evaluate LotusScript.
@UserName Без ограничений. Возвращает основное или альтернативное имя пользователя в Стр. Ошибка! Закладка не каноническом формате определена. ([Canonicalize]).
@UserNameLanguage В DOMINO R 5.0 НЕ Возвращает имя основного или
ДОКУМЕНТИРОВАНА. альтернативного языка. Стр. Ошибка! Закладка не
определена.
@UserNamesList Нельзя использовать в Функция возвращает текстовый формулах отбора, колонок и список, содержащий уровни доступа 1^' .:.,'.' фоновых агентов. текущего пользователя к текущей Предназначена для '::: базе данных. ; использования в базах данных, расположенных на сервере, или <; для локальных баз данных с установленным свойством "Enforce a consistent Access i ! Control List across all replicas" (Использовать единый список : управления доступом для всех реплик). Для локальных баз данных без этого свойства всегда возвращает пустую строку.
@UserPrivileges Нельзя использовать в Функция возвращает для текущего формулах отбора, колонок и пользователя текстовый список фоновых агентов. Не работает порядковых номеров, назначенных в Web-приложениях. ему привилегий (аналог ролей в LN R 2.x), но не сами имена привилегий.
@UserRoles Нельзя использовать в Возвращает текстовый список имен формулах отбора, колонок и ролей, на которые в списке Р' фоновых агентов. управления доступом текущей базы Предназначена для ' назначен текущий пользователь, использования в базах данных, расположенных на сервере, или для локальных баз данных с с , , : ,-. установленным свойством ..-.*-. ;.-..; "Enforce a consistent Access ....... Control List across all replicas" - ; : -, (Использовать единый список - r v!" ' ---. управления доступом для всех ';-г ! » реплик). Для локальных баз ~ "7V,,., данных без этого свойства всегда возвращает пустую
© InterTrust Co. Тел. (095) 9567928

808 Lotus Domino R. 5: ^формулы, LotusScript, встроенные классы LotusScript и Java
строку.
@V2If Без ограничений. .- - Аналог функции @If для версии LN
2.x
@V3UserName Без ограничений. Аналог функции @UserName для
_ .' версии 3.x. Возвращает имя Стр. 80 v текущего пользователя или имя
сервера в сокращенном формате ([Abbreviate]).
@V4UserAccess Нельзя использовать в Аналог функции @UserAccess для формулах отбора, колонок и версии 4.x. Возвращает числовой фоновых агентов. Для список из трех элементов, локальных баз всегда позволяющий определить уровень возвращает значение 6:1:1. доступа текущего пользователя в Если пользователь не имеет указанной базе, доступа к базе, он получит сообщение: "You are not authorized to perform that operation."(Bbi неавторизованы для выполнения данной -.,..- операции).
@VaIidateInternetAddress В DOMINO R 5.0 НЕ Функция проверяет почтовый адрес ДОКУМЕНТИРОВАНА. на соответствие его стандартам RFC Стр'62 822 или RFC 821.
@Version Без ограничений. При Возвращает текстовую строку использовании в формулах соответствующую релизу версии ГР' отбора, колонок и фоновых Domino, агентов возвращает версию Lotus Notes/Domin согласно местонахождению базы данных. Если она находится на сервере, то для сервера, и для локальной базы данных соответственно версию клиента LN. В остальных формулах -возвращает версию сервера.
@ViewTitle Нельзя использовать в Возвращает название текущего вида формулах отбора, колонок, или папки. ^Р' фоновых агентов, заголовка окна, полей, редактируемой секции, видимости акций видов, но работает в остальных формулах видимости объекта.
@Weekday Без ограничений. Функция Определяет день недели для "чувствительна" к часовому величины типа "дата-время". Cl?-41 поясу.
@Wide Предназначена для Преобразует строку из использования только в однобайтовой кодировки SBCS в формулах полей. двухбайтовую DBCS.
@Word Без ограничений. Функция просматривает исходную строку слева направо и возвращает ТР' "слово" по его позиции в строке.
@Year Без ограничений. Функция Из указанной величины "дата-" чувствительна" к часовому
© InterTrust Со. Тел. (095) 9567928

Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 809

Стр. 42 поясу. время" извлекает и возвращает год. @Yes Без ограничений. ; . - Возвращает 1 (TRUE).
@ Yesterday « ; Без ограничений. Возвращает величину "дата-время", Использование функции в соответствующую вчерашнему дню. V' формулах колонок и отбора документов может иногда приводить к отображению недостоверных данных, особенно в момент перехода дат. При использовании в формулах полей, возвращает значение "дата-время" по таймеру рабочей станции, а не ' сервера.
@Zone Без ограничений. Функция возвращает числовое значение, определяющее установки
™' '. '- ''. часового пояса с учетом перехода на ', , летнее/зимнее время.

© InterTrust Co. Тел. (095) 9567928
810 Lotus Domino R. 5: @гформулы, LotusScript, встроенные классы LotusScript и Java
5.2. Алфавитный список @-команд
Команда Область применения Краткое описание
AddBookmark Без ограничений. Добавляет закладку с указанными параметрами в текущий объект.
AddDatabase Без ограничений. Добавляет для указанной базы данных ее иконку на рабочее пространство без открытия базы данных.
AddDatabaseRepID Без ограничений. Добавляет для базы данных, указанной идентификатором реплики и сервером, ее иконку на рабочее пространство без открытия базы данных.
AdminCertify Нельзя применять в формулах Используется для сертификации диалогового окна. ID-файлов пользователей и серверов.
AdminCreateGroup Работает только при открытой Открывает адресную книгу и администраторской панели выводит форму для ввода группы с управления (Administration пустыми значениями. Control Panel).
AdminCrossCertifylDFile Нельзя применять в формулах Используется для создания кросс-диалогового окна. сертификатов.
AdminCrossCertifyKey Нельзя применять в формулах Используется для создания кросс-диалогового окна. сертификата с использованием ключа, ассоциированного с ID-файлом.
AdminDatabaseAnalysis Работает только при открытой Выдает диалоговое окно для администраторской панели анализа характеристик выбранной управления. базы данных.
AdminDatabaseQuotas Работает только при открытой Для выбранного сервера выдает администраторской панели список баз данных, у которых управления. можно изменить их максимальный размер.
AdminlDFileClearPassword Нельзя применять в формулах Используется для снятия пароля с диалогового окна. ID-файла без переключения на этот ID-файл.
AdminlDFileExamine Нельзя применять в формулах Используется для получения диалогового окна. информации о ID-файла (тип лицензии, сертификат, ключи шифрования и т.д.)
AdminlDFileSetPassword Нельзя применять в формулах Используется для смены пароля диалогового окна. ID-файла, в частности может быть использована для смены пароля ID-файла сертификатора.
Administration Нельзя применять в формулах Открывает администраторскую диалогового окна. панель управления.
AdminNewOrganization Нельзя применять в формулах Выдает диалоговое окно для диалогового окна. создания иерархического ID-файла
© InterTrust Со. Тел. (095) 9567928

Lotus Domino R. 5: ^-формулы, LotusScript, встроенные классы LotusScript и Java 811
сертификатора новой организации.
AdminNewOrgUnit Нельзя применять в формулах Используется для создания
:<: ' -'' i -'- диалогового окна. иерархического ID-файла w::-; ; ;;л ;ч , ; сертификатора новой ' ' ' организационной единицы.
AdminOpenAddressBook Работает только при открытой Для выбранного сервера г*:, :-.-. /*; - -..,: администраторской панели открывает адресную книгу, если 1 : управления. их несколько, выдается диалоговое окно для выбора адресной книги.
AdminOpenCatalog Работает только при открытой Для выбранного сервера ' администраторской панели открывает базу данных каталога управления. (Catalog.nsf)
AdmmOpenCertLog Работает только при открытой Для выбранного сервера администраторской панели открывает базу данных журнала управления. сертификатов (Certlog.nsf).
AdminOpenGroupsView Работает только при открытой Для выбранного сервера администраторской панели открывает адресную книгу и --- управления. выводит вид "Группы" (Groups), 8 если адресных книг несколько '.,...- , выдается диалоговое окно для выбора адресной книги.
AdminOpenServerLog Работает только при открытой Для выбранного сервера ;-; ;; администраторской панели открывает базу данных журнала управления. (Log.nsf)-
AdminOpenServersView Работает только при открытой Для выбранного сервера администраторской панели открывает адресную книгу и управления. выводит вид "Сервера" (Servers), " , -,.-.-.- если адресных книг несколько , ,. ... ^ выдается диалоговое окно для ' ........ ....... .,,;.л выбора адресной книги.
AdminOpenStatistics Работает только при открытой Для выбранного сервера администраторской панели открывает базу данных статистики управления. работы сервера (Statrep.nsf).
AdminOpenUsersView Работает только при открытой Для выбранного сервера администраторской панели открывает адресную книгу и управления, выводит вид "Пользователи" , " .i, . (Users), если адресных книг несколько выдается диалоговое окно для выбора адресной книги.
AdminOutgoingMail Работает только при открытой Для выбранного сервера администраторской панели открывает базу данных почтового управления. ящика сервера (Mail.box).
AdminRegisterFromFile Нельзя применять в формулах Используется для регистрации диалогового окна. пользователей, в случае если ^ информация о них хранится в : , L ,; : текстовом файле.
AdminRegisterServer Нельзя применять в формулах Используется для регистрации диалогового окна. сервера.
AdminRegisterUser Нельзя применять в формулах Используется для регистрации диалогового окна. пользователя.
© InterTrust Co. Тел. (095) 9567928

812 Lotus Domino R. 5: @~формулы, LotusScript, встроенные классы LotusScript и Java
AdminRemoteConsole ,,K,, , Нельзя применять в формулах Выдает диалоговое окно диалогового окна, удаленной консоли сервера.
Admin SendMailTrace Работает только при открытой Выдает диалоговое окно ,- , ,.,:,.,. -х;;-л -.. администраторской панели трассировки прохождения почты управления. (Mail Path Tracing).
AdminStatisticsConfig : . „ Работает только при открытой Для выбранного сервера администраторской панели открывает базу данных статистики
г v. -,„.,., -...::,.-.; управления. работы сервера (Events4.nsf).
AdminTraceConnection Нельзя применять в формулах Выдает диалоговое окно
, .... ,...-,. , диалогового окна. ,. . , трассировки соединений (Trace j, ). Connections) для сервера-
:'. ,, - . посредника.
AgentEdit Агент должен быть выбран в Открывает редактор агентов и
., ,,. .,v,,;j;,.. виде "Агенты" текущей базы загружает в него выбранного .'-.-.-. данных. агента.
AgentEnableDisable Без ограничений. Включает/выключает выбранного
., -">; -: i .-,>;.-.> .."-- ; '. -. - . аГвНТЭ.
AgentLog Нельзя применять в формулах Выводит диалоговое окно с диалогового окна. Агент журналом работы последнего ' ' должен быть выбран в виде запуска агента. "Агенты" текущей базы данных. ...-';-. i
AgentRun Нельзя применять в формулах Запускает выбранного агента и диалогового окна. Агент затем выводит журнал его работы.
. " , ,. .;..,...; должен быть выбран в виде , , ,. -...-.,, ... .. . "Агенты" текущей базы .-, . . . данных.
AgentSetServerName Без ограничений. Для указанного агента по *'" -; ' ' расписанию, устанавливает на каком сервере он должен выполняться.
AgentTestRun Нельзя применять в формулах Выполняет тестовый запуск ' ' ' ' диалогового окна. Агент выбранного агента и выводит ''''..'. ."-.г : должен быть выбран в виде журнал его работы. ;
. ..-,,;. , ^ --.:-.. ,; "Агенты" текущей базы
, -.„_,.;,.,. ,..,; ...,-.,- данных. .- :
AttachmentDetachAll Нельзя применять в формулах Выдает диалоговое окно для диалогового окна. Текущий сохранения на диске 1 ' " документ должен быть открыт присоединенных файлов (Save на чтение или редактирование, Attachments То). . . , или форма/подформа должны быть открыты в режиме редактирования. Документ ' должен иметь присоединенные '-' * ' файлы.
AttachmentLaunch Нельзя применять в формулах Запускает, если это возможно, диалогового окна. Текущий приложение, в котором было ' документ должен быть открыт подготовлен выбранный на чтение или редактирование, присоединенный файл и или форма/подформа должны выполняет его. быть открыты в режиме редактирования. Документ
© InterTrust Со. Тел. (095) 9567928

.- .- ' ' ...'-i-.v-d. -Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 813
должен иметь присоединенные файлы, и один из них должен быть выделен. :
AttachmentProperties Нельзя применять в формулах Выдает диалоговое окно свойств диалогового окна. Текущий присоединенного файла, документ должен быть открыт на чтение или редактирование, или форма/подформа должны быть открыты в режиме редактирования. Документ должен иметь присоединенные файлы, и один из них должен быть выделен.
AttachmentView Нельзя применять в формулах Запускает, если это возможно, диалогового окна. Текущий программу просмотра документ должен быть открыт содержимого присоединенного на чтение или редактирование, файла, и отображает в ней или форма/подформа должны содержимое выбранного быть открыты в режиме присоединенного файла. Загрузки редактирования. Документ приложения, в котором готовился должен иметь присоединенные присоединенный файл, не ,. файлы, и один из них должен происходит, быть выделен.
CalendarFormat Вид календарного стиля Меняет формат отображения вида должен быть открыт. * календарного стиля, изменяя число дней или месяцев, ! , , ОдНОВременно показываемых на экране.
CalendarGoTo Вид календарного стиля В виде календарного стиля "''' > должен быть открыт. При осуществляет переход на день, использовании с одним указанный вторым параметром, параметром нельзя применять в или выдает диалоговое окно для ' формулах диалогового окна. определения дня, на который необходимо перейти.
ChooseFolders Нельзя применять в формулах Выдает диалоговое окно для ! диалогового окна. Документ выбора папок, в которые должен быть открыт в режиме необходимо поместить текущий ; редактирования. документ.
Compose Нельзя применять в формулах Создает в указанной базе данных диалогового окна. новый документ по определенной ТР' форме и переключает на него " фокус LN.
CreateAction Форма, или подформа, или вид, Создает новую кнопку-акцию, или папка должны быть открыты в режиме редактирования. : "
CreateAgent Нельзя применять в формулах Создает нового агента в текущей диалогового окна, База данных базе данных и загружает : должна быть открыта или построитель агентов. ; '.,'.. выбрана в рабочем пространстве. Пользователь должен иметь доступ к базе " '''"', данных не ниже дизайнера, или !-! ; в списке управления доступом
© InterTrust Со. Тел. (095)9567928

814 Lotus Domino R. 5: ©-формулы, LotusScript, встроенные классы LotusScript и Java
ему должно быть разрешено создавать личных агентов.
CreateControlledAccessSectio Форма или подформа должна Создает в выбранной форме или п быть открыта в режиме подформе секцию с управляемым редактирования, и текст секции доступом, должен быть выделен.
CreateCrossCert В DOMINO R 5.0 КОМАНДА ПОЛНОСТЬЮ НЕ ДОКУМЕНТИРОВАНА
CreateEllipse Навигатор должен быть открыт Создает объект "эллипс" в в режиме редактирования. текущем навигаторе.
CreateFolder Нельзя применять в формулах Выдает диалоговое окно для диалогового окна. База данных создания новой папки, должна быть открыта или выбрана в рабочем , пространстве. Пользователь должен иметь доступ к базе данных не ниже дизайнера, или в списке управления доступом ему должно быть разрешено создавать личные папки.
CreateForm Нельзя применять в формулах Создает новую пустую форму в диалогового окна. База данных текущей базе данных. : должна быть открыта или , выбрана в рабочем пространстве. Пользователь должен иметь доступ к базе данных не ниже дизайнера.
CreateLayoutRegion Форма или подформа должна Создает новую область быть открыта в режиме размещения в форме или редактирования. подформе.
CreateNavigator Нельзя применять в формулах Создает новый пустой навигатор в диалогового окна. База данных текущей базе данных, должна быть открыта или ...,,...-.. выбрана в рабочем пространстве. Пользователь ,,-" должен иметь доступ к базе данных не ниже дизайнера.
CreatePolygon Навигатор должен быть открыт Создает объект "многоугольник" в в режиме редактирования. текущем навигаторе.
CreatePolyline Навигатор должен быть открыт Создает объект "ломаная линия" в в режиме редактирования. текущем навигаторе.
CreateRectangle Навигатор должен быть открыт Создает объект "прямоугольник" в в режиме редактирования. текущем навигаторе.
CreateRectangularHotspot Навигатор должен быть открыт Создает объект в режиме редактирования. "гиперпрямоугольник" в текущем '.'' ' * навигаторе.
CreateSection Документ должен быть открыт Создает секцию в текущем в режиме редактирования, или документе или форме/подформе. форма/подформа должны быть открыты в режиме . . редактирования. Текст секции
© InterTrust Co. Тел. (095) 9567928

Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java '' 815
должен быть выделен.
Create SubForm Нельзя применять в формулах Создает новую пустую подформу в диалогового окна. База данных текущей базе данных, должна быть открыта или выбрана в рабочем пространстве. Пользователь должен иметь доступ к базе данных не ниже дизайнера.
CreateTextbox Навигатор должен быть открыт Создает объект типа "надпись" в в режиме редактирования. текущем навигаторе.
Create View Нельзя применять в формулах Выдает диалоговое окно для диалогового окна. База данных создания нового вида, должна быть открыта или выбрана в рабочем пространстве. Пользователь должен иметь доступ к базе данных не ниже дизайнера. '
DatabaseRepl Setting Нельзя применять в формулах Выдает диалоговое окно диалогового окна. База данных параметров репликации текущей должна быть открыта или базы данных. ; t выбрана в рабочем ' , пространстве. ,.-',..- .
DebugLotusScript Без ограничений. Включает/выключает отладчик кода LotusScript.
DesignDocumentlnfo Нельзя применять в формулах Выдает окно свойств текущего диалогового окна. На документа, документе в виде или папке должен стоять световой указатель, или документ
:; : ; -: .':.. ДОЛЖ6Н быТЬ ОТКрЫТ На , .
чтение/редактирование.
DesignFormAttributes Форма/подформа должны быть Выдает окно свойств для текущей открыты в режиме формы/подформы. редактирования.
DesignFormFieldDef Форма/подформа должны быть Выдает окно свойств для , открыты в режиме выделенного поля текущей редактирования. Поле должно формы/подформы. быть выделено
DesignFormNewField Форма/подформа должны быть Создает новое поле в текущей ; открыты в режиме форме/подформе и выдает для '.- ;.'.,,.; редактирования. Ни одно поле него окно свойств. ; не должно быть выделено.
DesignForms Нельзя применять в формулах Открывает в текущей базе данных диалогового окна. База данных вид конструктора с имеющимися в должна быть открыта или базе данных формами, выбрана в рабочем :'.".',, пространстве. Пользователь ( (>, должен иметь доступ к базе , ,* -Г > : ,... данных не ниже дизайнера. . ' '
DesignFormShareField Форма/подформа должны быть Делает выделенное поле общим в открыты в режиме текущей форме/подформе. редактирования. Поле должно
© InterTrust Со. Тел. (095) 9567928

816 Lotus Domino R. S: @-формулы, LotusScript, встроенные классы LotusScript и Java
быть выделено.
DesignFormUseField Форма/подформа должны быть Выдает диалоговое окно вставки открыты в режиме общего поля (Insert Shared Field) редактирования. Ни одно поле для текущей формы/подформы. не должно быть выделено.
DesignFormWindowTitle Форма должна быть открыта в Переходит в конструкторе в режиме редактирования. режим определения заголовка окна для текущей формы.
DesignHelpAboutDocument Нельзя применять в формулах Открывает на редактирование диалогового окна. База данных документ о базе данных для должна быть открыта или текущей базы данных, выбрана в рабочем пространстве. Пользователь должен иметь доступ к базе данных не ниже дизайнера.
DesignHelpUsingDocument Нельзя применять в формулах Открывает на редактирование диалогового окна. База данных документ "О работе с базой должна быть открыта или данных" для текущей базы выбрана в рабочем данных, пространстве. Пользователь '' ! - должен иметь доступ к базе данных не ниже дизайнера.
Designlfcon Нельзя применять в формулах Выдает диалоговое окно для диалогового окна. База данных редактирования иконки выбранной должна быть открыта или базы данных, выбрана в рабочем пространстве. Пользователь должен иметь доступ к базе данных не ниже дизайнера.
DesignMacros Нельзя применять в формулах Открывает в текущей базе данных диалогового окна. База данных вид конструктора с имеющимися в должна быть открыта или базе данных агентами и макросами выбрана в рабочем для баз данных версий 3.x. пространстве.
DesignRefresh Нельзя применять в формулах Выдает диалоговое окно для диалогового окна. База данных определения сервера с шаблонами должна быть открыта или баз данных для обновления выбрана в рабочем дизайна текущей базы данных, пространстве. Пользователь ;,... , должен иметь доступ к базе данных не ниже дизайнера.
DesignReplace Нельзя применять в формулах Выдает диалоговое окно для диалогового окна. База данных определения сервера с шаблонами , . должна быть открыта или баз данных для замены дизайна выбрана в рабочем текущей базы данных, пространстве. Пользователь должен иметь доступ к базе данных не ниже дизайнера.
DesignSharedFields Нельзя применять в формулах Открывает в текущей базе данных диалогового окна. База данных вид конструктора с имеющимися в : ; . должна быть открыта или базе данных общими полями, выбрана в рабочем пространстве. Пользователь
© InterTrust Co. Тел. (095) 9567928

Lotus Domino JR. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 817
должен иметь доступ к базе : /^ данных не ниже дизайнера.
DesignSynopsis Нельзя применять в формулах Выдает диалоговое окно со диалогового окна. База данных сведениями о структуре базы должна быть открыта или данных (Design Synopsis), выбрана в рабочем пространстве.
DesignViewAppendColumn Вид или папка должны Создает новый столбец, находиться в режиме следующий за выбранным в редактирования. Столбец текущем виде/папке, должен быть выделен.
DesignView Attributes Вид или папка должны Выдает окно свойств текущего находиться в режиме вида/папки, редактирования.
DesignViewColumnDef Вид или папка должны Выдает окно свойств выделенного находиться в режиме столбца текущего вида/папки, редактирования. Столбец должен быть выделен.
DesignViewEditActions Вид или папка должны Включает/выключает режим находиться в режиме редактирования акций текущего редактирования. вида/папки.
Design ViewFormFormula Вид или папка должны Выдает диалоговое окно находиться в режиме определения формулы формы редактирования. (Design Form Formula), по которой должны открываться документы в текущем виде/папке.
DesignViewNewColumn Вид или папка должны Создает новый столбец перед находиться в режиме выбранным в текущем виде/папке, редактирования. Столбец должен быть выделен.
DesignViews Нельзя применять в формулах Открывает в текущей базе данных диалогового окна. База данных вид конструктора с имеющимися в должна быть открыта или базе данных видами, выбрана в рабочем < : пространстве. Пользователь ' Л должен иметь доступ к базе данных не ниже дизайнера.
Design ViewSelectFormula Вид должен находиться в Переходит в конструкторе в режиме редактирования. режим определения формулы отбора документов в виде.
DialingRules Нельзя применять в формулах Выдает диалоговое окно диалогового окна. установки параметров модемной связи в соответствии с текущим .. ' , местом вызова.
Directories В DOMINO R 5.0 КОМАНДА ПОЛНОСТЬЮ НЕ ДОКУМЕНТИРОВАНА
EditBottom Форма или документ должны Переводит курсор для документа в находиться в режиме последнее редактируемое поле, редактирования. для формы в конец формы.
EditButton Документ должен находиться в Переходит в конструкторе в режиме редактирования. режим определения действий по
© InterTrust Co. Тел. (095) 9567928 <

818 Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java
Кнопка должна быть выделена, выделенной кнопке и выдает ее окно свойств.
EditClear , Необходимо выполнения Выполняет команду меню Edit -
одного из условий: Clear (Правка - Очистить). Стр. 107
в виде/папке документы) должны быть выделены (помечены или на документе стоит световой ' маркер) или документ должен находиться в режиме редактирования;
документ должен находиться в режиме редактирования и данные для удаления (текст, > присоединенные файлы, объекты и т.д.) должны быть выделены;
элементы дизайна (форма, подформа, вид, папка и т.д.) должны находиться в режиме редактирования и ;. данные для удаления (поля, ,; столбцы и т.д.) должны ........ : , ,......-, быть выделены;
в рабочем пространстве ' : ' ' " ' ' иконки баз данных должны „ быть выделены. . .
:' В Web-приложениях может использоваться только в акциях формы, для пометки текущего (не выделенных) документа на .-.-.' удаление.
;-.' * . ; ,- .,, .;'.'-..' , , - -
EditCopy Необходимо выполнения Выполняет команду меню Edit -
одного из условий: Сору (Правка - Копировать). Стр. 1 10
в виде/папке документы) должны быть выделены (помечены или на
!'! ...,-' Ч
документе стоит световой маркер);
документ должен находиться в режиме редактирования или чтения, и данные для копирования (текст, присоединенные файлы, объекты и т.д.) ,v»^ рк \ должны быть выделены;
элементы дизайна (форма, подформа, вид, папка и т.д.) должны находиться в режиме редактирования, и данные для копирования
©InterTrust Co. Тел. (095)9567928

Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 819
,....- ,. -,.,..- (поля, столбцы и т.д.) , . должны быть выделены.
EditCut Необходимо выполнения , Выполняет команду меню Edit -одного из условий: Cut (Правка - Вырезать).
ч^Тр . 1 J. V/
в виде/папке документны) должны быть выделены (помечены или на документе стоит световой , маркер); ...-- -
,,.-.. ;- . .''.'' .
; документ должен находиться в режиме редактирования, и данные для копирования в буфер обмена с удалением (текст, присоединенные файлы, объекты и т.д.) должны быть выделены;
. "_'.,_: :. элементы дизайна (форма, .;,- подформа, вид, папка и т.д.) должны находиться в , . = ;" режиме редактирования, и данные для копирования (поля, столбцы и т.д.) должны быть выделены.
EditDeseiectAH Необходимо выполнения Выполняет команду меню Edit -
., одного из условий: Deslect All (Правка - Снять все Стр. 1 12 .
^ . .,,.!:. , . выделение). , : '''' в виде/папке документы
':-' должны быть выделены;
документ должен ' находиться в режиме редактирования или , -- /.:" i чтения, и данные для * 1/ ' ' " , снятия с них отметки
.-: ') . V. ')-'
: выделения (текст, присоединенные файлы, . . . - -,. - объекты и т.д.) должны "'" " ." " быть выделены;
* . элементы дизайна (форма, . '- "'". подформа, вид, папка и т.д.) : должны находиться в ; режиме редактирования, и ; , '' данные для копирования ' i .:-,-, (поля, столбцы и т.д.) ; ; должны быть выделены;
'.<'.,...'' \ ' в рабочем пространстве ::
; -: . иконки баз данных должны ; быть выделены. (1- '
EditDetach Документ должен находиться в Используется для сохранения на режиме редактирования или диске присоединенных файлов. чтения. Без указания параметров присоединенный файл должен быть выделен.
© InterTrust Со. Тел. (095) 9567928

820 Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java
EditDocument В виде/папке на документе Переводит текущий документ в должен стоять световой режим редактирования/чтения. ™' маркер, или документ открыт в режиме чтения/редактирования. Можно использовать в Web-приложениях в акциях формы (но не в акциях видов). При использовании данной команды могут не работать формулы видимости объектов в форматируемых полях. Используйте команду @Command( [OpenDocument] ), которая поддерживает работу всех формул видимости объектов.
EditDown Форма/подформа или документ Переводит курсор для документа в должны находиться в режиме пределах поля на одну или редактирования. определенное число строк вниз, если выходим за рамки поля перемещаемся в поле ниже текущего. Для формы/подформы на одну или определенное число строк вниз.
EditEncryptionKeys Вид/папка должны быть Выдает диалоговое окно свойств открыты и один или несколько текущего документа, в котором документов должны быть можно назначить ключи выбраны или световой шифрования для текущего указатель стоит на документе, документа, или документ должен находится в режиме редактирования или чтения.
EditFind Вид/папка должны быть Выполняет команду Edit -открыты, или документ должен Find/Replace (Правка -находиться в режиме Найти/Заменить), чтения/редактирования.
EditFindlnPreview Вид/папка должны быть При открытой панели открыты, или документ должен предварительного просмотра находиться в режиме выполняет команду Edit -просмотра. Find/Replace (Правка -Найти/Заменить) без перехода фокуса в окно редактирования документа. Если панель предварительного просмотра закрыта, действие аналогично команде @Command( [EditFind] ).
EditFindNext Вид/папка должны быть Выполняет команду Edit - Find открыты, или документ должен Next (Правка - Найти далее). находиться в режиме Оперирует с результатами чтения/редактирования. полнотекстового поиска, если он
,. -.-. -..*' ..,. t.-.i -- .._»;,: . . г _ ,
был произведен, и фокус
» MJH'affWtuo .'- f > *r j
находится либо в виде на ; отобранном документе, либо в отобранном документе на найденном слове/фразе. В
© InterTrust Co. Тел. (095) 9567928

Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 821
противном случае выдает диалоговое окно обычного поиска.
EditGotoField Документ должен находиться в Перемещает курсор в указанное режиме редактирования. поле текущего документа.
EditHeaderFooter Форма/подформа должны Выдает окно свойств текущего находиться в режиме документа или формы/по дформы редактирования, или документ для изменения параметров печати, должен быть выбран в виде/папке, или находиться в режиме чтения.
EditHorizScrollbar Документ должен быть открыт. Отображает горизонтальную Команда не поддерживается на линейку "прокрутки" для текущего платформах OS/2 и Macintosh, документа.
Editlndent Форма/подформа должны Для текущего и всех абзацев ниже находиться в режиме текущего увеличивает отступ от : редактирования, или документ левого края на 1/4 дюйма. .;.-.- должен находиться в режиме редактирования. Курсор должен быть для документа в форматируемом поле, для t формы/подформы в бланке формы (но не в формулах и т.д.).
EditlndentFirstLine Форма/подформа должны Для текущего и всех абзацев ниже находиться в режиме текущего увеличивает отступ от редактирования, или документ левого края на 1/4 дюйма первой должен находиться в режиме строки абзаца ("красная строка"), редактирования. Курсор должен быть для документа в форматируемом поле, для формы/подформы в бланке формы (но не в формулах и т.д.).
EditlnsertButton Форма/подформа должны Создает новую кнопку в документе находиться в режиме или форме/по дформе и выдает - редактирования и ничего не окно свойств кнопки, должно быть выделено, или документ должен находиться в режиме редактирования. Курсор должен быть для документа в форматируемом поле, для формы/подформы в бланке формы (но не в формулах и т.д.).
EditlnsertFileAttachment Документ должен находиться в Используется для создания режиме редактирования. присоединенных файлов.
5ч-."удкй1ца$йЈ «иве*;»** хал?.- : Курсор должен быть* ^,:фты«*5н ; форматируемом поле.
EditlnsertObject Форма/подформа должны Используется для встраивания в находиться в режиме документ или форму/подформу редактирования, или документ OLE-объектов. . . должен находиться в режиме
';.-.--' -, .; т .5 . редактирования. Курсор , : должен быть для документа в
©InterTrust Co. Тел. (095)9567928

822 Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java
форматируемом поле, для формы/подформы в бланке формы (но не в формулах и т.д.). Команда не поддерживается на платформах OS/2, UNIX и Macintosh.
EditlnsertPageBreak Форма/подформа или страница Добавляет/удаляет в документе, должны находиться в режиме форме/подформе, или странице редактирования, или документ символ перевода страницы, должен находиться в режиме редактирования. Курсор должен быть для документа в форматируемом поле, для формы/подформы в бланке формы (но не в формулах и т.д.).
EditlnsertPopup Форма/подформа должны Создает гиперобъект типа находиться в режиме текстового "всплывающего" окна, редактирования, или документ должен находиться в режиме редактирования. Текст для документа в форматируемом поле, для формы/подформы в бланке формы должен быть выделен.
EditlnsertTable Форма/подформа должны Выдает диалоговое окно создания находиться в режиме объекта таблицы, редактирования, или документ должен находиться в режиме редактирования. Курсор должен быть для документа в форматируемом поле, для формы/подформы в бланке формы (но не в формулах и т.д.).
EditlsertText Форма/подформа должны Вставляет указанную текстовую находиться в режиме строку с текущего положения редактирования, или документ курсора, должен находиться в режиме редактирования. Курсор должен быть для документа в поле, для формы/подформы в бланке формы (но не в формулах и т.д.).
EditLeft Форма/подформа, страница, Переводит курсор для документа в или документ должны пределах поля на один или находиться в режиме определенное, число символов редактирования. влево, если выходим зйрамхя поля перемещаемся в поле левее текущего. Для формы/подформы или страницы на одну или определенное число символов левее.
EditLinks Форма/подформа или документ Выдает диалоговое окно внешних должны находиться в режиме связей.
© InterTrust Co. Тел. (095) 9567928

Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 823
редактирования и иметь одну или более OLE или DDE-связей.
EditLocations Нельзя применять в формулах Открывает личную адресную диалогового окна. , книгу по виду "Место вызова" (Location).
EditMakeDocLink На документе в виде/папке Создает ссылку на текущий должен стоять световой документ и помещает ее в буфер указатель или документ должен обмена. Пользователь может затем находиться в режиме вставить эту ссылку в любое редактирование/чтение. форматируемое поле.
EditNextField Документ должен находиться в Перемещает указатель курсора в режиме редактирования. следующее редактируемое поле. Перемещаясь слева направо, сверху вниз, независимо от ; порядка обхода полей определенных в форме.
EditOpenLink Документ должен находиться в Открывает объекты, на которые режиме указывает выбранная ссылка редактирования/чтения. Ссылка должна быть выделена, и указывать на объекты Domino (не OLE, или DDE).
EditPaste Вид/папка должны быть Выполняет команду Edit - Paste открыты, или документ должен (Правка - Вставить). т^>' находиться в режиме редактирования, или элементы дизайна (форма, подформа, вид и т.д.) должны находиться в режиме редактирования. Информация в буфере обмена должна соответствовать типу приемника. В случае если в .»'-'.- буфере обмена находится информация из форматируемого поля, а .;-,-: вставка осуществляется в текстовое поле, часть ' информации может быть " утеряна.
EditPasteSpecial Документ должен находиться в Выдает диалоговое окно режиме редактирования и специальной вставки (Paste курсор должен быть в пределах Special), форматируемого поля, или форма/подформа должны находиться режиме редактирования.
EditPhoneNumbers Нельзя применять в формулах Открывает личную адресную диалогового окна. ; . книгу по виду "СерверШодключения" (Sever\Connections).
EditPrevField Документ должен находиться в Перемещает указатель курсора в режиме редактирования. предыдущее редактируемое поле. Перемещение осуществляется
© InterTrust Co. Тел. (095) 9567928

824 Lotus Domino R. 5: @гформулы, LotusScript, встроенные классы LotusScript и Java
справа налево, снизу вверх, ;,.,;:, , независимо от порядка обхода ,...,.., ~ полей определенных в форме.
EditProfile Нельзя применять в формулах Открывает на редактирование диалогового окна. Для новый или существующий ™' создания профильного профильный документ, документа нужен доступ к базе данных не ниже автора.
EditResizePicture Документ должен находиться в Используется для изменения режиме редактирования и размеров вставленного в рисунок должен быть выделен, форматируемое поле рисунка.
EditRight Форма/подформа или документ Переводит курсор для документа в должны находиться в режиме пределах поля на один или редактирования. определенное число символов вправо, если выходим за рамки поля перемещаемся в поле правее текущего. Для формы/подформы на одну или определенное число символов правее.
EditSelectAH Документ должен находиться в Выполняет команду Edit - Select режиме АИ (Правка - Выделить все). ГР' чтения/редактирования, или вид/папка должны быть открыты, или в текущем окне отображается лист рабочего ; пространства, или форма/подформа находятся в режиме редактирования.
EditSelectByDate Вид/папка должны быть Выдает диалоговое окно отбор открыты в текущем окне. документов по дате (Select by Стр' J U Date).
EditShowHideHiddenChars Документ или форма/подформа Отображает/скрывает должны находиться в режиме отображение скрытых символов редактирования. (табуляция, пробел, возврат каретки). Для документа показывает скрытые символы только в форматируемых полях.
EditTableDeleteRowColumn Документ или Выдает диалоговое окно удаление форма/подформа/страница строк/столбцов в текущей таблице, должны находиться в режиме редакпфоваиия. Указатель курсора должен находиться в пределах таблицы.
EditTableFormat Документ или Выдает окно свойств таблицы, форма/подформа/страница должны находиться в режиме редактирования. Указатель курсора должен находиться в пределах таблицы.
EditTablelnsertRowColumn Документ или Выдает диалоговое окно вставки форма/подформа/страница строк/столбцов в текущей таблице, должны находиться в режиме редактирования. Указатель
© InterTrust Co. Тел. (095) 9567928

Lotus Domino R. 5; @-формулы, LotusScript, встроенные классы LotusScript и Java 825
курсора должен находиться в пределах таблицы.
EditTop ,;.,,; Форма или документ должны Переводит курсор для документа в , .... !,v находиться в режиме первое редактируемое поле, для « , : -,.->, редактирования. > формы в начало формы.
EditUndo Нельзя применять в формулах Выполняет команду Edit - Undo диалогового окна. (Правка - Отменить). Для формул акции и кнопок работает только при открытом в текущем окне виде/папке, снимая при этом отметку об удалении документа.
EditUntruncate На документе в виде/папке Восстанавливает полную версию должен стоять световой усеченного документа из базы, 1 указатель. которая участвовала в репликации с параметрами усечения больших , документов.
EditUp Форма-'подформа или документ Переводит курсор для документа в должны находиться в режиме пределах поля на одну или редактирования. определенное число строк вверх, если выходим за рамки поля * перемещаемся в поле выше :--- -н текущего. Для формы/подформы , на одну или определенное число строк вверх.
EmptyTrash Без ограничений. Удаляет документы из предопределенной папки (STrash) ТР' . и обновляет индекс вида.
ExchangeUnreadMarks В текущем окне должны быть Помечает как прочтенные помечены две иконки реплик документы в одной реплике, если одной базы. Иконки не должны они помечены как прочтенные в быть наложены друг на друга, другой реплике.
Execute Нельзя применять в формулах Запускает внешнее приложение диалогового окна. Параметры операционной системы.
СТО. 121 !>'. -";..'
* должны соответствовать формату операционной системы.
FileCIoseWindow Можно использовать в Web- Закрывает текущее окно LN. В приложениях при условии, что случае если в окне присутствует не ТР' у базы установлено свойство сохраненный отредактированный "Allow Javascript on the Web" документ или элемент дизайна, (использовать Javascript при выдает диалоговое окно с создании Web-страниц). Не вопросом о сохранении закрывает окно с рабочим изменений, пространством. Всегда .....' выполняется последней в формуле,
FileDatabaseACL . База данных должна быть Выдает диалоговое окно со открыта или ее иконка должна списком управления доступом быть выделена в рабочем (ACL) к текущей базе данных, пространстве. Пользователь '-- .1 должен иметь уровень доступа ' ?-. \> о к базе выше, чем "Нет доступа" " : для чтения информации, и
© InterTrust Co. Тел. (095) 9567928

826 Lotus Domino R. 5: @гформулы, LotusScript, встроенные классы LotusScript и Java
менеджера для изменения.
FileDatabaseCompact База данных должна быть Вызывает процесс сжатия открыта или ее иконка неиспользованного пространства в '''' выделена в рабочем базе данных, и одновременно, если пространстве. дизайн базы данных подготовлен в старых версиях LN, конвертирует его в 5-. версию.
FileDatebaseCopy База данных должна быть Выдает диалоговое окно создания открыта или ее иконка должна новой копии текущей базы быть выделена в рабочем данных, пространстве. Пользователь должен иметь уровень доступа к базе не ниже читателя.
FileDatabaseDelete Иконка базы данных должна Физически удаляет файл текущей быть выделена в рабочем базы данных с диска. Если с базой пространстве, но сама база не данных в данный момент кто-то должна быть открыта. работает, то появится Пользователь должен иметь предупреждающее сообщение, что уровень доступа менеджера к база будет удалена позднее, базе. Всегда выполняется последней в формуле.
FileDatabaselnfo База данных должна быть Выдает окно свойств текущей открыта или ее иконка должна базы данных, быть выделена в рабочем пространстве. Пользователь должен иметь уровень доступа к базе не ниже депонента.
FileDatabaseRemove Иконки баз данных должны Удаляет иконки выделенных баз быть выделены в рабочем данных с рабочего пространства, пространстве, но сами базы не Если базы открыты, то появится должны быть открыты. предупреждающее сообщение, что иконка базы будет удалена позднее.
FileDatabaseUseServer Иконка базы данных должна Выдает диалоговое окно выбора быть выделена в рабочем сервера (Switch Server) для пространстве. переключения на другую реплику текущей базы данных.
FileExit Нельзя применять в формулах Выполняет команду File - Exit диалогового окна. Всегда (Файл - Выход из Notes). В случае ™' выполняется последней в если в каком-либо окне формуле. присутствует не сохраненный отредактированный документ или элемент дизайна, выдает диалоговое окно с вопросом о сохранении изменений.
FileExport Документ должен быть открыт Используется для экспорта в режиме содержимого документа или чтения/редактирования, или вида/папки в файлы приложений вид/папка должны быть не LN. открыты в текущем окне.
FileFullTextCreate База данных должна быть Выдает диалоговое окно создания открыта или ее иконка должна полнотекстового индекса для быть выделена в рабочем текущей базы данных.
© InterTrust Co. Тел. (095) 9567928

Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 827
Ц 'эомямфдошшы. . пространстве. Пользователь - №~,. должен иметь уровень доступа менеджера к базе.
FileFullTextDelete База данных должна быть Удаляет у текущей базы данных открыта или ее иконка должна полнотекстовый индекс. : быть выделена в рабочем | пространстве. Пользователь 'wi" з сЛ -.->:>; \ ; . ' - должен иметь уровень доступа I 8 менеджера к базе. У базы ! ,™„.,_^__1_____ !_ должен быть полнотекстовый индекс.
FileFullTextlnfo База данных должна быть Выдает окно свойств текущей открыта или ее иконка должна базы данных, отображая сразу быть выделена в рабочем закладку с информацией о пространстве. полнотекстовом индексе.
FileFullTextUpdate База данных должна быть Используется для обновления открыта или ее иконка должна полнотекстового индекса текущей быть выделена в рабочем базы данных. ; пространстве.
Filelmport - - Документ должен быть открыт Используется для импорта
л?»-«ут*''я"^?ч *V*'4 - ч « ' ч
, -Vi,- *...=, ~,Л:. i в режиме редактирования и содержимого файла приложении uu-гзсря qj курсор должен находиться в не LN в документ или вид/папку . форматируемом поле, или LN. ; вид/папка должны быть ; открыты в текущем окне.
FileNewDatabase Без ограничений. Выдает диалоговое окно создания новой базы данных.
FileNewReplica Без ограничений. Выдает диалоговое окно создания новой реплики текущей базы *"* т ' данных. Если в текущем окне база .^яаап в (. Л - ' ' г " ' данных не открыта и не выбрана, то сначала выдается диалоговое окно для выбора текущей базы данных.
FileOpenDatabase Нельзя применять в формулах Открывает указанную базу данных и-5 диалогового окна. Можно с использованием заданного вида ТР' использовать в Web- или навигатора, приложениях при условии, что . , t """ параметр "сервер" есть пустая строка, и если используется синтаксис с третьим параметром "вид", то j Si следующей командой в у :»-:-. vi-l 1 формуле обязательно должна j быть [OpenDocument]. - i
FileOpenDbRepID Нельзя применять в формулах Открывает базу, указанную ее диалогового окна. идентификатором реплики, с ТР' использованием заданного вида или навигатора.
FilePageSetup База данных должна быть Выдает диалоговое окно открыта или ее иконка должна параметров страницы для печати быть выделена в рабочем (Page Setup), или для OS Macintosh пространстве. диалоговое окно File Print Margin.
© InterTrust Co. Тел. (095) 9567928

828 Lotus Domino R. 5: (^-формулы, LotusScript, встроенные классы LotusScript и Java
?-:- „-,.-,>. :v,^ - . ?.»ЛлЛ -
FilePrint __„__, Вид/папка должны быть Печатает текущий/выбранные
_, открыты, или документ должен документы или содержимое Сто. 108 ^ i ^ находиться в режиме вида/папки целиком.
чтения/редактирования.
FilePrintSetup - Вид/папка должны быть Выдает диалоговое окно выбора 1 .гялйнч йывотж открыты, или документ должен принтера (Print Setup). ч находиться в режиме чтения/редактирования. :* : , - --- .- Команда не поддерживается на - платформе Macintosh. " ^ ' ' ~"
FileSave Документ или элементы Выполняет команду File - Save - дизайна (форма/подформа, (Файл - Сохранить). Стр. 1 ОЪщфъг атзйоаз оюю вид/папка, навигатор и т.д.) , - - лЙхвТИоЧ:. 1 <,Ш'Р*'" - должны находиться в режиме 'гс; { ° редактирования. Можно ,' | ""''- -':»мяюю мояотзя5 использовать в Web- '. '" -
f~ юшамондо 8KB eare^u. приложениях при условии, что "Т"~~ЖшЈт1;. ! JfemvJOT ваююш о тоао У базы Установлено свойство I " „.. "Allow Javascript on the Web"
- A- '" ' < * ' «*
j (использовать Javascript при - * L . создании Web-страниц).
FileSaveNewVersion Документ должен находиться в Сохраняет редактируемый режиме редактирования. документ как новую версию.
FindFreeTimeDialog Документ должен находиться в Выдает диалоговое окно поиска режиме редактирования. Все свободного времени для собрания параметры должны быть (Free Time).
"Ттешг^^^есГэов^^т1 заданы (необязательные могут .; . s7S"fiJeaw5S?i .хмншяхшгвд быть пустой строкой). Время j ^ _. _ . _, . собрания не должно т »«*:- Ашокямдг-: приходиться на полночь.
° ' ^ ' :
Folder Документ должен быть открыт, Копирует, или копирует с ,
^ , лп , и, ч« и Атытгт он »» ли^° документы выделены в удалением документы) в папку. Стр. 109 "и *" " wiwqxTo зн х-.
, ь.^чвяЕкэтэй; виде. Документы) должен . -> , - ^ ; j ишд ftan«w*r «-.. быть уже сохранен(ы) на диске } ; ; : ( не новый документ). г" °'\ -.",:': г "~ .~~ .-.--.-.....
FolderCollapse &?Ј?? Вид/папка должны быть Согласно документации, ™ -,чу„ ' открыты, и указатель курсора "свертывает" в области навигации 1 д, . . должен находиться в области выделенную категорию | навигации. вида/папки, содержащие | ' вложенные документы или f « категории. Автору не удалось ! м»»--. добиться от команды данного
г МНо ,
j _ , , , результата. Применение команды 1 la 8t вызывало лишь "свертывание" 1 «Ж1ВД он№*,-в**8о м .- текущей категории документов в виде/папки.
FolderCustomize Вид/папка должны быть Переводит дизайн вида/папки в ,ь ; -.гнглэо.мооотяяй открыты. режим редактирования.
FolderExpand Вид/папка должны быть Согласно документации,
( ''- '"' открыты, и указатель курсора "разворачивает" в области Г ______ „_.^_.__„„___„„_.. должен находиться в области навигации выделенную категорию «гсрэп *гл навигации. вида/папки, содержащие
j fiwtni адМ s( = >!«* а.-ш- 4^- < «е вложенные документы или
; ,4«-гЯ г *йи,«;«?;-^ ,.,«>«.., '! категории. А втору не удалось
-;;У --f' ' .':- '--'., . . -.;,.,. ,. ..,,.. :, ~-
© InterTrust Со. Тел. (095)9567928 ~ .™,-^-*«,-,^.- .,_..,._.

Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 829
добиться от команды данного
j г.,,, ; ^ : результата. Применение команды вызывало лишь "развертывание
' ' - .. текущей категории документов в 1 . .хишдогидеДО наш? , /7 | , , . виде/папки.
FolderExpandAll Вид/папка должны быть Согласно документации,
j , -"-" ' " -'"' '"''' -i---"- :" _ открыты, и указатель курсора "разворачивает" в области
1 Ј Т Ы ТЭЯЭТ ХЯННТ08Я) ТЭШ*3<:, 1 .
' ~. .. . ~ . ,.„ : должен находиться в области навигации все категории навигации. вида/папки, содержащие ! . ., ;.;,: ' ' '' вложенные виды/папки. Автору не . }" удалось добиться от команды ' данного результата. Применение команды вызывало лишь
! ' '
; "развертывание" всех категорий ^ документов в виде/папки.
FolderExpandWithChildren Вид/папка должны быть Согласно документации, в области открыты, и указатель курсора навигации "разворачивает" на все должен находиться в области уровни выделенную категорию V'"- Ч '"'"" 77 '. "' навигации. вида/папки, содержащие i ' ' вложенные виды/папки. Автору не
j удалось добиться от команды
.. „...и, i. .,.„,..,,-... .4- Hi-- " '
I млавтэя отшоэсшоюийнж^ввЕ' *Я|- а кмтякох«ч i данного результата. Применение \ *- atoldwE Jiamf) ш и .» команды вызывало лишь
\ --.-.'-. "развертывание" всех уровней \ ! . текущей категорий в виде/папки.
FolderMove Вид/папка должны быть Выдает диалоговое окно для i : открыты. перемещения текущего вида/папки Г в другой вид/папку.
FolderProperties Вид/папка должны быть Согласно документации, выдает ; } '* " открыты в режиме окно свойств текущего вида/папки. ;| ,,. , редактирования. Указатель Автору не удалось добиться от | .... >(! курсора должен находиться в команды данного результата. 1 . области навигации. Применение команды вызывало 'сообщение об ошибке.
; ' ', '
FolderRename Вид/папка должны быть Выдает диалоговое окно для - * открыты. переименования текущего вида/папки.
FormActions Форма/подформа или страница Переходит в конструкторе в должны быть открыты в режим определения акций формы. г режиме редактирования.
FormTestDocument Форма должна быть открыта в Создает по текущей форме т ЈшэшшЈв<1 ВТО8 режиме редактирования. Для документ. Можно использовать подформ не работает. для проверки формул полей, скриптов и т.д.
GoUpLevel „ _ Документ должен быть открыт Выводит вид, в котором текущий j sroi атойокэ оняо i на чтение/редактирование. документ отображается. Может быть использована для открытия вида, в котором хранится ссылка : J ! ,,а: ' на документ (DocLink), перед закрытием документа-ссылки.
HelpAboutDatabase База данных должна быть Открывает документ "О базе открыта или ее иконка должна данных" для текущей базы ^' быть выделена в рабочем данных.
- © InterTrust Со. Тел. (095)9567928^-

830 Lotus Domino R. 5: @гформулы, LotusScript, встроенные классы LotusScript и Java
пространстве.
HelpUsingDatabase База данных должна быть Открывает документ "Об открыта или ее иконка должна использовании базы данных" для ^' быть выделена в рабочем текущей базы данных, пространстве.
HotSpotClear Документ или форма/подформа Удаляет гиперобъект, не удаляя JM J'*t* должны находиться в режиме сам объект (картинка, текст и т.д.) : редактирования. Указатель
' \ ' *"1МЧ '
' * курсора должен находиться в пределах гиперобъекта. - ;" 7',",Г"*'> Работает только для Г гиперобъектов, созданных с ; J помощью команд пункта меню ! «№*№ - Create - HotSpot (Создание -! ;'да Гиперобъект).
HotSpotProperties Документ или форма/подформа Выдает окно свойств для j ,к«* «и должны находиться в режиме гиперобъекта. . оятес редактирования. Указатель , : курсора должен находиться в пределах гиперобъекта. . i
InsertSubform Форма должны находиться в Выдает диалоговое окно вставки "' i .-- , режиме редактирования. В подформы (Insert Subform). - .ли текущей базе должна .wnrns « существовать хотя бы одна
- -- подформа. Указатель курсора -- - *~~
I
s S^-T" О1&51Й ^i'ti/* *** ** ' должен находиться в пределах
Ншад^дшда бланка формы.
LayoutAddGraphic Форма/подформа должны Вставляет графическое находиться в режиме изображение из буфера обмена в S-RM8 <г редактирования. Указатель область размещения, курсора должен находиться в :, __, ,. пределах области размещения. j ^»«и«и6иь»от^»,-. в буфере обмена должно
1 . .- а находиться вставляемое 1 изображение.
LayoutAddText Форма/подформа должны Вставляет статический текст в . , находиться в режиме область размещения.
Г Й8>, ;,»8THR редактирования. Указатель ] и;«|о<^ймм^а-,',,«лшй,з*|П курсора должен находиться в -»,.. ' " пределах области размещения.
LayoutElementBringToFront Форма/подформа должны Переносит выделенный объект
\ rfrs«OEaiu»nyHOir*:oM'-Tj' находиться в режиме аэо ; mi области размещения на передний ' .fisrton RsfM0 редактирования. Объект план. Т.е. он будет отображаться ;~ , области размещения должен поверх других объектов, если они
.._._. :™_~'_..' - .-. ~.^~ быть выделен. есть.
I '. 'J~- '- "_~- : .- .. :.; ,"...'''.:;
LayoutElementProperties Форма/подформа должны Выдает окно свойств для с" находиться в режиме выделенного объекта области , редактирования. Объект размещения. :,'/ f-srfy» ' /ilnK Iit»CI} ".>?зм- области размещения должен быть выделен.
LayoutElementSendToBack Форма/подформа должны Переносит выделенный объект находиться в режиме области размещения на задний редактирования. Объект план. Т.е. он будет отображаться
© InterTrust Со. Тел. (095) 9567928

Lotus Domino R. 5: (^формулы, LotusScript, встроенные tuidc&it LolusScripfu Java 831 "
области размещения должен под другими объектами, если они "',,,... быть выделен. есть.
LayoutPfoperties Форма/подформа должны Выдает окно свойств для области находиться в режиме размещения. .ч -> ii4: редактирования. Область 8 - размещения или ее объект : должны быть выделены.
MailAddress Документ должен находиться в Выдает диалоговое окно
_, ._„ - - ~~~" режиме редактирования. определения почтового адреса ™' Указатель курсора должен (Mail Address). Пользователь находиться в пределах может выбрать адресата и при .„^.^ _____-_„. редактируемого поля. В нажатии Ok выбранная . - к иншадоэ кпд &ут&фа-- документе должно быть хотя информация занесется в йош&вж,Шб* эт(*оп ог та- бы одно поле, используемое соответствующие адресные поля ; „ ; штшомроа «уйвф-Ш дая адресации (SendTo, документа. ! ' --. СоруТо, BlindCopyTo).
; MailComposeMemo Нельзя применять в формулах Создает в почтовом ящике диалогового окна. пользователя пустое почтовое ТР' VyaYtd сообщение по форме, ......,.; используемой по умолчанию для "' L: почтовой базы (обычно Memo), и устанавливает фокус на него.
MailForward На документе в виде/папке Создает новое почтовое .... ...,._ , .а ....... . „ должен стоять световой сообщение и помещает в него ! *" указатель или он должен быть содержимое выбранных выделен, или документ должен документов. ' находиться в режиме , ; : редактирование/чтение.
MailForwardAsAttachment Работает при установленной Пересылает текущий документ, jipntnr. почтовой системе cc:Mail. На как cc:Mail присоединенный файл. ..„.,. документе в виде/папке должен стоять световой указатель, или I документ должен находиться в режиме j редактирование/чтение.
MailOpen Без ограничений. Выводит представление или навигатор почтовой базы
..,„,... . .. ., ,..,.,,, . ,. пользователя, открывавшиеся ; " ., последними в этой базе.
MailReqestCrossCert Нельзя применять в формулах Используется для создания и ; диалогового окна. отправки по почте защищенной '"*" копии ID-файла сертификатора.
MailReqestNewName Нельзя применять в формулах Используется для создания диалогового окна. пользователем запроса на i ------ изменение имени и отправки по почте этого запроса.
MailReqestNewPublicKey Нельзя применять в формулах Используется для создания диалогового окна. ID-файл пользователем запроса на пользователя должен быть изменение открытого ключа . -~ - заверен иерархическим (Public Key) и отправки по почте сертификатом. этого запроса.
MaiScanUnread Нельзя применять в формулах Проверяет почтовую базу пользователя на наличие не
© InterTrust Co. Тел. (095) 9567928

832 Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java \
... диалогового окна. прочтенной почты. Если таковая
vJ \F\S * .->: * ,
имеется, открывает первый не прочтенный документ.
MailSend ^ На документе в виде/папке Используется для отправки по должен стоять световой почте текущего или выбранных
}-\ .,„_,„ ..,-,,„..,. указатель или он должен быть документов. 1 ' выделен, или документ должен . i находиться в режиме _. . „. . . . . . t ] омяп ;, редактирование/чтение. В '- > >Ж' документе должно быть поле, if гтг | :<г,, используемое для адресации ! нкр! н йтвээодб t (SendTo).
MailSendCertificateRequest Нельзя применять в формулах Используется для создания и I кг.ой эичукдо 34WSWS диалогового окна. отправки по почте защищенной копии ID-файла пользователя.
MailSendEncryptionKey Нельзя применять в формулах Используется для отправки по диалогового окна. почте пользовательских ключей шифрования.
MailSendPublicKey Нельзя применять в формулах Используется для отправки по диалогового окна. почте открытого ключа (Public Key) пользователя.
MoveToTrash В DOMINO R 5. 0 НЕ По действию аналогична команде ДОКУМЕНТИРОВАНА. [EditClear]. Помечает к удалению ; ' Работает в акциях видов. В текущий (выделенные) документы.
ШннйЧдмв эй Web-приложениях, согласно .am;..i; документации, должна -[ помечать документ к удалению, но не удалять его.
NavigateNext Вид/папка должны быть В виде/папке осуществляет j ;..„й», ,;*.й5.,; ^..ец, „i.-^ii ;jёJ-A. открыты, или документ должен навигацию на следующий * находиться в режиме документ, чтения/редактирования. Всегда i выполняется последней в п : формуле. В Web-приложениях ~h ' : i может использоваться только в н акциях формы.
NavigateNextHighlight Документ должен находиться в Переходит к следующему режиме результату поиска. Работает слева j J wmhhu чтения/редактирования. Поиск направо, сверху вниз, с использованием полнотекстового поиска должен быть выполнен.
NavigateNextMain Вид/папка должны быть В виде/папке осуществляет i et» ксхгетда-- -"»рз"--' ' * ОТКРЬ1ТЫ' или документ должен навигацию на следующий главный ' находиться в режиме в дереве ответов документ по чтения/редактирования. Всегда отношению к текущему. |_ , ,_ выполняется последней в j 8»Hi;i формуле. В Web-приложениях ..'. - I stt saoqnBf msro может использоваться только в акциях формы.
NavigateNextSelected Вид/'папка должны быть В виде/папке осуществляет открыты, или документ должен навигацию на следующий находиться в режиме выбранный в виде/папке документ
' :')" - :..,:, : " ''.,. . -" _j_ __»_
© InterTrust Co. Тел. (095)9567928

Lotus Domino R. 5: (^формулы, LotusScript, встроенные классы LotusScript и Java 833
; » qOftrujtiKH тэл чтения/редактирования. Всегда для текущего. Работает сверху кЯйва-^ .,.- выполняется последней в вниз, по кругу.
NavigateNextUnread Вид/папка должны быть В виде/папке осуществляет jitjiarfoo- открыты, или документ должен навигацию на следующий не находиться в режиме прочтенный в виде/папке чтения/редактирования. Всегда документ для текущего. Работает -. выполняется последней в сверху вниз, по кругу. ' формуле.
NavigatePrev Вид/папка должны быть В виде/папке осуществляет открыты, или документ должен навигацию на предыдущий
.. . „. ^ara&dio-ajo аек. чтения/редактирования. Всегда выполняется последней в формуле. В Web-приложениях : может использоваться только в [ -.-{_ -'-- акцияхформы. {... .. .. . ... ; , . „
NavigatePrevHighlight Документ должен находиться в Переходит к предыдущему ' режиме результату поиска. Работает 1 ,; ' чтения/редактирования. Поиск справа налево, снизу вверх. \ -а^Одедетой^взояж с использованием ; t полнотекстового поиска ., . ' должен быть выполнен.
NavigatePrevMain Вид/папка должны быть В виде/папке осуществляет i открыты, или документ должен навигацию на предыдущий > 'Ым : находиться в режиме главный в дереве ответов | », чтения/редактирования. Всегда документ по отношению к ; : выполняется последней в текущему. 1 формуле. В Web-приложениях !: ' может использоваться только в акциях формы. ----.-
^,':Г:-„,.-:,ГГ-,:^,' '
NavigatePrevSelected Вид/папка должны быть В виде/папке осуществляет .х;,с,йл»;»! .i.iiiip, ^sa^.™.-.. открыты, или документ должен навигацию на предыдущий находиться в режиме выбранный в виде/папке документ чтения/редактирования. Всегда для текущего. Работает снизу выполняется последней в вверх, по кругу. L „-„„^_, ,„^.-,„__„. формуле. -
NavigatePrevUnread Вид/папка должны быть В виде/папке осуществляет i открыты, или документ должен навигацию на предыдущий не ' находиться в режиме прочтенный в виде/папке чтения/редактирования. Всегда документ для текущего. Работает выполняется последней в снизу вверх, по кругу, формуле.
NavigateToBackLink .,,,. Документ должен находиться в Возвращает фокус на документ, из режиме которого по ссылке был открыт чтения/редактирования. Всегда текущий документ. Текущий выполняется последней в документ и база, его содержащая, формуле. при этом закрываются.
NavigatorProperties Навигатор должен находиться в Выдает окно свойств для режиме редактирования. навигатора.
Navigator Test ---~-~'~> -->v ., Навигатор должен находиться в Запускает навигатор в тестовом режиме редактирования. режиме для проверки работы его компонент. Повторный вызов
<..-. , '-./:
© InterTrust Co. Тел. (095) 9567928

834 Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java да" л
' " команды возвращает навигатор в режим редактирования.
ObjectDisplayAs Форма/подформа должны Выдает диалоговое окно находиться в режиме определения стиля отображения ' редактирования, или документ OLE-объекта. / должен находиться в режиме 5 ! rs»8xo8fH .о г»1в<яэт «кд т редактирования. OLE-объект ; |. -i ллуф» on .jthw должен быть выделен. Команда [ ; не поддерживается на платформах OS/2, UNIX и ;' . ., ^ - -Macintosh.
ObjectOpen Форма/подформа должны Открывает OLE-объект для находиться в режиме редактирования. : редактирования, или документ ; « 'и должен находиться в режиме ! '- - , --. редактирования. OLE-объект должен быть выделен. Команда
j v, ' не поддерживается на ' jiiateBH*/ ! платформах OS/2, UNIX и * s Macintosh.
ObjectProperties OLE-объект должен быть Выдает окно свойств для OLE-выделен. Команда не объекта. ; поддерживается на платформах Ч OS/2, UNIX и Macintosh.
OpenCalendar Необходимо, чтобы к почтовой Открывает календарный вид - : базе, или к календарному виду почтовой базы указанного или ! ж шшзнк был доступ у текущего выбираемого пользователя. V' пользователя, либо через ACL, либо через профиль делегирования.
OpcnDocument Вид/папка базы данных Открывает документ на ашгуэш^ум должны быть открыты в чтение/редактирование по его ™' .fiB'^BMHaqti.e текущем окне. В открытом универсальному идентификатору. тнэмгаол зжпщЛэдва f виде/папке должен \(Јгшс» тэетоовЧ .о присутствовать открываемый 1 " документ.
OpenFrameset Предназначена для Открывает определенный набор использования в акциях формы фреймов текущей базы данных. ТР" и видов. Можно использовать в Web-приложениях.
OpenHelpDocument Справочная база данных Открывает определенный вид, должна быть одна на сервер указанной справочной базы ГР' ,„, „.,_„__ или в локальной директории. данных, и становится на нужный ... ам^яод ш э^оф T9SB*: Первый столбец указанного документ. | i ифгто им9 зякыээ ол с вида должен быть йш. сортировочным. Можно ; i jtpjiifi/sq использовать в Web- ' ,* приложениях в формулах кнопок.
OpenNavigator База данных должна быть Открывает указанный навигатор в открыта или ее иконка должна текущей базе данных. ,
СТО 116 г е- *4s»i»V*tfcJiJ-4-b
к быть выделена в рабочем м., пространстве. Можно использовать в Web-
© InterTrust Co. Тел. (095) 9567928

Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 835
:^-Ј- приложениях при опущенном i ! ' третьем параметре. *
OpenPage База данных должна быть Открывает определенную » , открыта или ее иконка должна страницу текущей базы данных. j ТР' /' быть выделена в рабочем
пространстве. Предназначена для использования в акциях :, формы и видов. Можно использовать в Web- ...«,.> ~<~. -.., приложениях. >
OpenView База данных должна быть Открывает вид/папку для текущей " '' открыта или ее иконка должна базы данных. ; ТР' ~ "" быть выделена в рабочем ' пространстве. Можно использовать в Web-приложениях.
PasteBitmapAsBackground Навигатор должен быть открыт Вставляет графическое в режиме редактирования, изображение из буфера обмена на IV онэ графическое изображение задний план навигатора, должно находиться в буфере обмена.
PasteBitmapAsObject Навигатор должен быть открыт Вставляет графическое нп« иии' в Режиме редактирования, изображение из буфера обмена как графическое изображение гиперобъект навигатора. j должно находиться в буфере обмена.
PictureProperties Документ или элемент дизайна Выдает окно свойств для должны быть открыты на графического изображения. , „ редактирование, графическое ,ТЙ, изображение должно быть выбрано.
PublishDatabase База данных должна быть Выдает диалоговое окно открыта или ее иконка должна размещение текущей базы данных азя"аэй1.?! быть выделена в рабочем в библиотечной базе данных, пространстве, причем только __ одна. В рабочем пространстве '-' должна присутствовать как ; » минимум одна библиотечная : хшшвп. Hot-ad йошшчш ион» база данных.
RefreshHideFormulas Вид/папка должны быть Пересчитывает только формулы - Стр.119 открыты, или документ должен видимости объектов в документе находиться в режиме или виде. чтения/редактирования. RefreshParentNote Работает только в формулах Передает изменения из Стр. 119 диалогового окна. одноименных полей диалогового окна в основной документ. ReloadWindow В DOMINO R 5. 0 НЕ "Перезагружает" или обновляет Стр.118 ...._...:_.... ДОКУМЕНТИРОВАНА содержимое текущего окна LN. Работает в формулах акций Для набора фреймов обновляет = <*:>,; „, t v форм и кнопок. В акциях видов содержимое всех входящих в него '- работает в случае, если вид фреймов, входит в набор фреймов. Может использоваться в Web- ; ... . _ ., -........„...„, .. приложениях.
© InterTrust Со. Тел. (095) 95679М*'

836 Lotus Domino R, 5: (д^-формулы, LotusScript, встроенные классы LotusScript и Java ,-_-« , \
RemoveFromFolder В папке документ(ы) должны Удаляет текущий документ(ы) из быть выделены (помечены или текущей папки.
™' .^«wi-«i-.-«. ««*.-.. на документе стоит световой „_.. и- ^ ,,.,г..- маркер) или документ должен ^к^й находиться в режиме чтения/редактирования.
RenameDatabase Иконка базы данных должна Для указанной базы данных находиться в рабочем переключает ее иконку на реплику ! пространстве. этой базы на другом сервере.
Replicator Нельзя применять в формулах Отображает страницу диалогового окна. "Репликатор" рабочего пространства.
ReplicatorReplicateHigh В текущем окне должна быть Начинает процесс репликации для открыта страница "Репликатор" баз с высоким приоритетом в рабочего пространства. параметрах репликации.
ReplicatorReplicateNext В текущем окне должна быть Заканчивает реплицирование . открыта страница "Репликатор" текущей базы данных и переходит
1 !,«» sr«4J«4o Ј<|э'ф'?В Н sj»r рабочего пространства. к реплицированию следующей «M^msreesH K«fi-- Процесс реплицирования базы согласно установкам. Может .-.,.- ..,,„ должен идти. привести к частичной репликации
: f- к , ,: -<-pi пя текущей базы.
ReplicatorReplicateSelected В текущем окне должна быть Начинает процесс репликации j i-,a ii-.c™.ow «.. открыта страница "Репликатор" выделенной базы данных.
j . -f''4>" - --- рабочего пространства. Иконка ;' '"'' -'*" базы данных должна быть -.. выделена на странице ' .,. '
"Репликатор". -.-
ReplicatorReplicateWithServe В текущем окне должна быть Выдает диалоговое окно г открыта страница "Репликатор" определения сервера для j i .„ - рабочего пространства. репликации и начинает процесс репликации для выбранного __„ _ - сервера.
ReplicatorSendMail В текущем окне должна быть Отправляет исходящую почту на
: j ,f.«-r,«iis ji-~; ;::ч.л -,.-,. открыта страница "Репликатор" почтовый сервер, рабочего пространства.
ReplicatorSendReceiveMail В текущем окне должна быть Начинает процесс репликации открыта страница "Репликатор" между почтовым сервером и : j '"' рабочего пространства. локальной почтовой базой данных пользователя.
Replicators tart ^^ Л, В текущем окне должна быть Начинает/продолжает процесс открыта страница "Репликатор" репликации для выделенных баз. рабочего пространства.
ReplicatorStop В текущем окне должна быть Останавливает процесс открыта страница "Репликатор" репликации. Может привести к i ..-.'... ?*'"'*' рабочего пространства. частичной репликации текущей базы.
SectionCollapse Документ должен быть открыт Свертывает/разворачивает в режиме текущую секцию в документе или чтение/редактирование, или форме/подформе. .|,>.;Г, форма/подформа должны быть ,! открыты в режиме редактирования. Секция
О InterTrust Co, Тел. (095) 9567928
.'.,-. ..',-. У-ь-ч :,-* .-

Lotus Domino R. 5: @гформулы, LotusScript, встроенные классы LotusScript и Java 837
должна быть выбрана.
,,, ':'*'; ' SectionCollapseAH Документ должен быть открыт Свертывает все секции в в режиме документе или форме/по дформе. чтение/редактирование, или форма/подформа должны быть *Ј&*> шкада \ \ открыты в режиме ._ ._ ..-., u .. .^,_J I >>зэ «i'Mii. тэг редактирования. 89ttiSQOiHwc;'i?
SectionDeflneEditors Форма/подформа должны быть Выдает диалоговое окно < открыты в режиме редактирования текущей секции
г ' ' 'А ННШЭЗ ,йТйЗ«Л г г f „ , , ,
редактирования, и секция с открытой формы/подформы. управляемым доступом должна Автору не удалось добиться от од ммь-' быть выбрана. команды данного результата. Применение команды вызывало , _ „ сообщение об ошибке.
SectionExpand Документ должен быть открыт Разворачивает/свертывает в режиме текущую секцию в документе или чтение/редактирование, или форме/подформе. форма/подформа должны быть 1 \
'"'-" " ': "... ." ;'"" открыты в режиме i ; ,.,, -, '*' редактирования. Секция ; } ' должна быть выбрана. ; ]
SectionExpandAll Документ должен быть открыт Разворачивает все секции в в режиме документе или форме/подформе. чтение/редактирование, или 4 форма/подформа должны быть i открыты в режиме ,. j ' i i редактирования.
SectionProperties Документ должен быть открыт Выдает окно свойств для текущей ' в режиме редактирования, и секции, секция в форматируемом поле "~ ,, должна быть выбрана, или .,:», i форма/подформа должны быть открыты в режиме редактирования и секция должна быть выбрана.
SectionRemoveHeader Документ должен быть открыт Удаляет текущую секцию как в режиме редактирования, и объект, возвращая документ или секция в форматируемом поле форму/подформу к состоянию до
> , _ должна быть выбрана, или создания секции. ~~-~~ ;---;- _-;.-
' .;»;; Vl?k>/X3rv«--.-'.YV-*r.i. ,- ~ ' "л^Г .'':
форма/подформа должны быть :; открыты в режиме "- А редактирования и секция должна быть выбрана.
SetCurrentLocation Без ограничений. Выдает диалоговое окно определения места вызова.
ShowHideLinkPreview Документ должен быть открыт Используется для в режиме отображения/скрытия панели чтение/редактирование. предварительного просмотра, для связанных с текущим документов , , по ссылке.
ShowHideParentPreview Документ должен быть открыт Используется для в режиме отображения/скрытия панели _ чтение/редактирование. ' предварительного просмотра для
© InterTrust Co. Тел (095) 9567928

838 Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript u Java ,
родительского, по отношению к текущему документа.
ShowHidePreviewPane В виде/папке на документе Используется для должен стоять световой отображения/скрытия панели маркер. предварительного просмотра для ' текущего в виде/папке документа.
ShowProperties Без ограничений. Выдает окно свойств для , выбранного в текущем окне объекта LN (базы данных, документа, секции и т.д.).
SmartlconFioating Без ограничений. Разрешает перемещение панели активных пиктограмм по текущему экрану.
SmartlconNextSet Без ограничений. Переключается на следующий набор активных пиктограмм.
StyleCircleKey Документ или форма/подформа Циклически переключает для i должны быть открыты в документа или формы/подформы режиме редактирования. Хотя существующие стили параграфов бы один стиль параграфа для из имеющихся, объекта должен существовать.
TextAlignCenter Форма/подформа должны Форматирует текущий текст по находиться в режиме центру абзаца. | .тки*,, редактирования, или документ ;,,!,,>/ должен находиться в режиме ; , . .-. . редактирования. Курсор ! { должен быть для документа в { форматируемом поле, для ^ i ;8'<«>., , ... формы/подформы в бланке | формы.
TextAlignFull Форма/подформа должны Форматирует текущий текст по , находиться в режиме ширине абзаца, редактирования, или документ < _ . . должен находиться в режиме : редактирования. Курсор ' должен быть для документа в ^ ......:.. форматируемом поле, для '..,?„, формы/подформы в бланке формы.
TextAlignLeft Форма/подформа должны Форматирует текущий текст по находиться в режиме левому краю абзаца. , -,. редактирования, или документ
| , должен находиться в режиме ': "-* да-к--я^;~Ј *t | редактирования. Курсор ' __.___„„_ "~ должен быть для документа в форматируемом поле, для j__,_ ,,„_^„_._ формы/подформы в бланке формы.
TextAlignNone Форма/подформа должны Отменяет предыдущие команды находиться в режиме форматирования абзаца, j ' ,-_, редактирования, или документ . 4
1. _^„,^.„_ должен находиться в режиме , -,-=..- ~~~ ! редактирования. Курсор vi W:w«,t:mt должен быть для документа в
©InterTrust Со. Тел, (095)9567928 ;"" -"- ' " - ' ...-..--.-. -

.' ." .. ,,-<'?- '' '* Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 839
форматируемом поле, для ; формы/подформы в бланке :! j . , формы.
TextAlignRight Форма/подформа должны Форматирует текущий текст по ,, , ' находиться в режиме правому краю абзаца. ,, з&одл Адфь^-. -.„, редактирования, или документ -.,,» j , должен находиться в режиме t редактирования. Курсор ' j должен быть для документа в '-' "'"' ''- \ } ' форматируемом поле, для ,>_::.,,,',,, формы/подформы в бланке формы. j
TextBold ™~_ .. Документ должен находиться в Устанавливает/снимает для ,шгшэ\1 режиме редактирования и выделенного или текущего текста t стилет <уш«уяэт над cnotfusu курсор должен быть в свойство шрифта "полужирный". ; , !1ййнрмйо*а1ф.8яш оатэ форматируемом поле, или ; - компонент дизайна должен находиться в режиме '- редактирования и курсор | " должен быть в пределах > ] объекта, имеющего свойства ; * 1 параметры шрифта. |
TextBullet Форма/подформа должны Устанавливает/снимает для находиться в режиме выделенного или текущего текста л uiajijy^an ним О'юш; редактирования, или документ форматирование типа . .. еап'еднг" должен находиться в режиме маркированный список. ..жхдагой редактирования. Курсор должен быть для документа в ; ; форматируемом поле, для j j формы/подформы в бланке > формы. i . '
TextCycleSpacing Форма/подформа должны Устанавливает для выделенного " находиться в режиме или текущего текста величину <Шйлед«г{ .т-уауг редактирования, или документ межстрочного интервала :*' ' »vt ,fv« ж. должен находиться в режиме (одинарный, полуторный, редактирования. Курсор двойной). Работает по кругу, должен быть для документа в f форматируемом поле, для : формы/подформы в бланке ' j формы.
TextEnlargeFont Форма/подформа должны Устанавливает для выделенного ' находиться в режиме или текущего текста свойство п '' *' * редактирования, или документ размер шрифта на следующий по 1 ' i ' ' ' должен находиться в режиме отношению к текущему размер. .jcHH^bt^ редактирования. Курсор должен быть для документа в , ( ; форматируемом поле, для ! формы/подформы в бланке , | формы.
TextFont Форма/подформа должны Выдает окно свойств для j3aa*a ; находиться в режиме выделенного или текущего текста. [,,; редактирования, или документ
; .:>' должен находиться в режиме -.--. ,,,(S.. ,s^s<|*Tb.*,f f редактирования. Курсор должен быть для документа в
© InterTrust Со. Тел. (095) 9567928

840 Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java
форматируемом поле, для формы/подформы в бланке формы. , ^
Textltalic Документ должен находиться в Устанавливает/снимает для режиме редактирования и выделенного или текущего текста курсор должен быть в свойство шрифта "курсив". ' " *" форматируемом поле, или j , компонент дизайна должен ! : находиться в режиме /- j ' редактирования и курсор , с j ^ __ должен быть в пределах * : ,,!,,„ объекта, имеющего свойства ! параметры шрифта. ,~ ~~
TextNormal Документ должен находиться в Устанавливает/снимает для . <»«.г>.мтл»»-.ч; >.;4>.t«4«; режиме редактирования и выделенного или текущего текста курсор должен быть в свойство шрифта "обычный". - форматируемом поле, или ? компонент дизайна должен находиться в режиме j редактирования и курсор { ' должен быть в пределах 1 ' объекта, имеющего свойства параметры шрифта.
TextNumbers Форма/подформа должны Устанавливает/снимает для находиться в режиме выделенного или текущего текста -., редактирования, или документ форматирование типа ; должен находиться в режиме нумерованный список. ' редактирования. Курсор { должен быть для документа в форматируемом поле, для ,, » формы/подформы в бланке _ -. _-_i_ формы.
TextOutdent Форма/подформа должны Форматирует текущий или гвшя0*т«н <лой!- находиться в режиме выделенный текст, уменьшая его редактирования, или документ левый отступ. „ должен находиться в режиме : редактирования. Курсор i . должен быть для документа в форматируемом поле, для формы/подформы в бланке формы.
TextParagraph Форма/подформа должны Выдает окно свойств текущего или находиться в режиме выделенного текста, становясь ' qswsp ''Kii"v «>r я ов редактирования, или документ сразу на закладку с параметрами должен находиться в режиме форматирования, редактирования. Курсор должен быть для документа в р j форматируемом поле, для формы/подформы в бланке ... ,;-. .,- . формы.
TextParagraphStyles Форма/подформа должны Выдает окно свойств текущего или находиться в режиме выделенного текста, становясь j редактирования, или документ сразу на закладку с параметрами 1 должен находиться в режиме стилей параграфа. ; редактирования. Курсор
© InterTrust Ср. Тел. (095)<>5(>Щ8.

Lotus Domino R- 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 841
| должен быть для документа в f ' < форматируемом поле, для формы/подформы в бланке \
' , " ''М_ _ -- ..- формы. -*
TextPermanentPen Форма/подформа должны Устанавливает/снимает для , ,„ ,» находиться в режиме выделенного или текущего текста редактирования, или документ свойство шрифта типа должен находиться в режиме "фломастер". Автору не удалось ; '.';.- i ': редактирования. Курсор добиться от команды данного должен быть для документа в результата для выделенного форматируемом поле, для текста. формы/подформы в бланке { формы.
TextReduceFont Форма/подформа должны Устанавливает для выделенного отонроср находиться в режиме или текущего текста свойство .iw,;x,. редактирования, или документ "размер шрифта" на предыдущий должен находиться в режиме по отношению к текущему размер, редактирования. Курсор ...___ должен быть для документа в ; форматируемом поле, для .... формы/подформы в бланке формы.
TextSetFontColor Форма/подформа должны Устанавливает для выделенного . находиться в режиме или текущего текста свойство редактирования, или документ "цвет шрифта" на указанный, должен находиться в режиме , | -;/; -;------.- _,,-,.„, редактирования. Курсор - 1 **'""*u ' * "1 должен быть для документа в '"' ' -'"-"-'^- '- '- i форматируемом поле, для "' 1 : формы/подформы в бланке ; 1 формы. ; |
TextSetFontFace Форма/подформа должны Устанавливает для выделенного ., ^ находиться в режиме или текущего текста свойство "имя , редактирования, или документ шрифта" на указанное.
-,~. ~ ' - должен находиться в режиме иш! ,,avqiirwf :, редактирования. Курсор " ^ '- '" j ;,ыгн«?а{лО'>,а^ч должен быть для документа в } ..г форматируемом поле, для -, .-~ \ формы/подформы в бланке .,. . .,,;-. ,.-,., | * '"' формы.
TextSetFontSize Форма/подформа должны Устанавливает для выделенного находиться в режиме или текущего текста свойство редактирования, или документ "размер шрифта" на указанный, должен находиться в режиме редактирования. Курсор f должен быть для документа в | форматируемом поле, для
~~- формы/подформы в бланке
,,,«bf>,WW,r«M« формы
TextSpacingDouble Форма/подформа должны Устанавливает для выделенного находиться в режиме или текущего текста величину ' редактирования, или документ двойного межстрочного "i: ' должен находиться в режиме интервала, редактирования. Курсор должен быть для документа в
©InterTrust Со. Тел. (095) 9567928

842 Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java
форматируемом поле, для формы/по дформы в бланке ! формы. ^
TextSpacingOneAndAHalf Форма/подформа должны Устанавливает для выделенного , находиться в режиме или текущего текста величину | втзнэ1 редактирования, или документ полуторного межстрочного } gn-rr srC; должен находиться в режиме интервала, редактирования. Курсор должен быть для документа в { <ул;\К:Л'**:м* rms ы*-- форматируемом поле, для ! формы/подформы в бланке ^ формы.
TextSpacingSingle Форма/подформа должны Устанавливает для выделенного находиться в режиме или текущего текста величину редактирования, или документ одинарного межстрочного должен находиться в режиме интервала. : .qa&tteq -/шш^гзт s ошг редактирования. Курсор ' , должен быть для документа в i ' форматируемом поле, для | : формы/подформы в бланке ' формы.
TextUnderline Документ должен находиться в Устанавливает/снимает для режиме редактирования и выделенного или текущего текста курсор должен быть в свойство шрифта "подчеркнутый". ,,-iHii -л.*, -, .' ,, ,-, форматируемом поле, или i компонент дизайна должен } 1 находиться в режиме ,. > ' -J ; редактирования и курсор | ; должен быть в пределах ? ' объекта, имеющего свойства ' , параметры шрифта.
ToolsCall Порты должны быть Выдает диалоговое окно соответствующим образом подключение к серверу, настроены.
ToolsCategories Документ должен быть открыт Категоризирует текущий или в режиме выбранные документы. i чтение/редактирование, или в ; i ' 1 текущем окне должен быть ; '! открыт вид/папка и документы . . : 1 . ..: _ „,. должны быть выделены или на { _.„_™„„_, документе стоит световой , маркер. Документ(ы) должны *- -. иметь поле "Categories", и ... - i ; вид/папка должны иметь i . первый сортировочный .{-.. ^ i ' столбец, в формуле которого u i . -. присутствует поле "Categories".
ToolsHangUp Порты должны быть Выдает диалоговое окно соответствующим образом отключение от сервера. ! ;«о,<: настроены.
ToolsMarkAHRead Документ должен быть открыт Помечает все документы в базе в режиме данных как прочтенные. ТР' чтение/редактирование, или в текущем окне должен быть
© InterTrust Co. Тел. (095) 9567928

Lotus Domino R. 5: (/^-формулы, LotusScript, встроенные классы LotusScript и Java 843
открыт вид/папка.
ToolsMarkAHUnread Документ должен быть открыт Помечает все документы в базе . в режиме данных как не прочтенные. ТР- -ТййКлТЗ: чтение/редактирование, или в текущем окне должен быть -- . ---открыт вид/папка. " ' * ;/
ToolsMarkSelectedRead В текущем окне должен быть Помечает текущий или выбранные открыт вид/папка, и документы документы в базе данных как
™' ,«Mivt,.- должны быть помечены, или на прочтенные. ,^ , .; .,., ..-., ,.-. .„.,-; , , документе стоит световой ' маркер.
ToolsMarkSelectedUnread В текущем окне должен быть Помечает текущий или выбранные открыт вид/папка, и документы документы в базе данных как не ТР' ' '"" должны быть помечены, или на прочтенные, документе стоит световой " . . „J, маркер, или документ должен .,._., "li \ 1: ''!:, быть открыт в режиме 'fj,-':a.'iqi. г -.-'; чтения/редактирование. , ,.J-.^ V , ., н *
ToolsRefreshAILDocs В текущем окне должен быть Перевычисляет все формулы во открыт вид/папка. всех документах текущего ™' вида/папки и сохраняет изменения.
ToolsRefreshSelectedDocs В текущем окне должен быть Перевычисляет все формулы во открыт вид/папка. всех выбранных документах ТР- „., текущего вида/папки и сохраняет
snTiiT О' ainvy'i »;
изменения.
ToolsReplicate База данных должна быть Используется для решшцирования открыта или ее иконка должна текущей базы данных. г! быть выделена в рабочем ;
пространстве. -. _- . . -
ToolsRunBackgroundMacros База данных должна быть Выполняет в текущей базе все открыта или ее иконка должна фоновые агенты, независимо от быть выделена в рабочем времени их запуска. В дальнейшем пространстве. Всегда фоновые агенты будут выполняется последней в выполняться по расписанию, формуле.
TooIsRunMacro База данных должна быть Выполняет в текущей базе открыта или ее иконка должна указанного агента. ™' быть выделена в рабочем _^. -
~.~~ ^ -~~-м. -»*-- *~~. * - . j
;,ц пространстве. Всегда ,'.<> i "а выполняется последней в гаи формуле, за исключением Web- - ' v : .х^> приложений, где все @- команды выполняются **-*? - v , " " Т
vlfitiH.j.- !
последовательно. , х | >
ToolsScanUnreadChoose Нельзя применять в формулах Выдает диалоговое окно диалогового окна. определения имен баз данных, в которых необходимо осуществить поиск не прочтенных документов.
ToolsScanUnreadPreferred Нельзя применять в формулах Выдает диалоговое окно \MiX5-w.jvjiW диалогового окна. результатов поиска не прочтенных - документов в определенных командой [ToolsScanUnreadChoose] базах
©InterTrust Со. Тел. (095) 9567928

844 Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java
данных.
ToolsScanUnreadSelected Нельзя применять в формулах Открывает первый, не прочтенный диалогового окна. документ для выбранной базы данных, или выдает диалоговое окно, как по команде 1 [ToolsScanUnreadPreferred].
ToolsSetupLocation Нельзя применять в формулах Открывает на редактирование
*«; ^мн.-ы,^ ,fU« ,. диалогового окна. документ, соответствующий ! текущему месту вызова, из личной I адресной книги.
ToolsSetupMail Нельзя применять в формулах Выдает диалоговое окно общих диалогового окна. почтовых настроек рабочей станции. -;
1 oolsSetupPorts Нельзя применять в формулах Выдает диалоговое окно настроек | диалогового окна. портов рабочей станции.
ToolsSetupUserSetup Нельзя применять в формулах Выдает диалоговое окно общих диалогового окна. настроек рабочей станции.
ToolsSmartlcons Нельзя применять в формулах Выдает диалоговое окно настроек диалогового окна. панели активных пиктограмм.
ToolsSpellCheck Документ должен быть открыт Запускает программу проверки в режиме редактирования. орфографии для текущего документа.
ToolsUserLogoff Нельзя применять в формулах Отключает текущего пользователя диалогового окна. от всех серверов LN. Для повторного подключения .*j.,.iH-«,ivti;,~: требуются ID-файл пользователя и ! пароль.
UserlDCertificates Нельзя применять в формулах Используется для выдачи диалогового окна. страницы "Сертификаты" диалогового окна ID-файл текущего пользователя.
UserlDClearPassword Нельзя применять в формулах Используется для снятия пароля с j ' «-"-$.-- диалогового окна. ID-файла текущего пользователя.
UserlDCreateSafeCopy Нельзя применять в формулах Используется для создания ; диалогового окна. безопасной копии ID-файла
i ,fcm.->=:t- текущего пользователя. \Д -,,:
UserlDEncryptionKeys Нельзя применять в формулах Используется для выдачи диалогового окна. страницы "Шифрование" диалогового окна ID-файл ' текущего пользователя.
UserlDInfo Нельзя применять в формулах Используется для выдачи ' диалогового окна. страницы общих параметров -..."_ диалогового окна ID-файл : текущего пользователя.
VserlDMergeCopy Нельзя применять в формулах Используется для объединения ID-
^ ... ,..„.„ ч,, диалогового окна. ^ файл текущего пользователя с его "--> копией (например, заверенной администратором). ;
UserlDSetPassword Нельзя применять в формулах Используется для установки : ,,-sr., диалогового окна. пароля на ID-файл текущего
© InterTrust Co. Т*л. (095) 9567928

Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 845
; пользователя.
i .,-.--
UserlDSwitch Нельзя применять в формулах Используется для переключения с , диалогового окна. ID-файл текущего пользователя на I -Яшш» другой ID-файл.
i VSEditNextField Документ должен быть открыт Перемещает указатель курсора к '~ /w»jTtW« « «*»** в режиме редактирования. следующему или первому j редактируемому полю в текущем 1 документе. Применяется для совместимости с версиями LN 3.x.
! VSEditPrevField Документ должен быть открыт Перемещает указатель курсора к , . -- в режиме редактирования. первому редактируемому полю в | текущем документе. Применяется для совместимости с версиями LN 3.x.
ViewAddlnternetCertificate В DOMINO R 5.0 КОМАНДА ПОЛНОСТЬЮ НЕ i ДОКУМЕНТИРОВАНА 4
ViewArrangelcons В текущем окне должна быть Упорядочивает иконки баз данных 1 «S1 открыта страница рабочего LN на текущей странице рабочего ! ч'--- |; пространства. пространства.
ViewBelowFolders Вид/папка должны быть Устанавливает для всех открыты в текущем окне. видов/папок в текущей базе
| ^дади>.»«*; следующий порядок отображения
j ----- --.--. панелей:
i
| „.*'"': панель навигации - в левой i верхней части экрана;
|"ёv. панель показа - в левой нижней 1 йояоь « йвизгввоылон х* части экрана; j .эднимяв Somite* кн*:-,-' . панель предварительного ! показа - в правой части экрана.
ViewBesideFolders Вид/папка должны быть Устанавливает для всех открыты в текущем окне. видов/папок в текущей базе : следующий порядок отображения панелей:
j - - .--.--- панель навигации - в левой i .эяшшэдда мэр ;.1аш^1»гвигь«$.ч верхней части экрана;
панель показа - в правой у верхней части экрана; 1 1 ^-} >
| * .нхяш\еряа so* панель предварительного ' показа - в нижней части экрана.
ViewCertify Должен быть открыт вид Используется для ресертификации ,; a »iH3F! "Пользователь" ("Person") выбранных пользователей. !<са»го*в a aoTJt5W(«t общей адресной книги, и в виде . | ^,^ул / выбран один или несколько 1 документов. И
ViewChange Вид/папка должны быть Осуществляет переход в открыты в текущем окне. указанный вид/папку текущей ^' Можно использовать в Web- базы данных, приложениях при условии задания второго параметра. >
© InterTrust Со. Тел. (095) 9567928

846 Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java
ViewColIapse Вид/папка должны быть Для текущей строки-категории открыты в текущем окне. "свертывает" все категории и ТР' ;!f,;yR0fl tnsi Можно использовать в Web- документы ниже ее. приложениях.
ViewCoIlapseAH Вид/папка должны быть "Свертывает" все категории и 1 -in открыты в текущем окне. документы в текущем виде/папке. Т^'. ^яуда?:; Можно использовать в Web-приложениях.
i ViewExpand Вид/папка должны быть Для текущей строки-категории .;*!> 'si открыты в текущем окне. "раскрывает" один уровень ; ], ;:цч»\/а*1Т= Можно использовать в Web- категории или документов ниже - приложениях. ее.
i ViewExpandAH Вид/папка должны быть "Раскрывает" все категории и
: _ , _. открыты в текущем окне. документы в текущем виде/папке. Сто. 120 - .....-- .- - » . .т г . i v -щ 0> Можно использовать в Web-
i приложениях. i ....... . .. , . _..,._ ___, .._.,._ ... _ ... ViewExpandWithChildren Вид/папка должны быть Для текущей строки-категории открыты в текущем окне. "раскрывает" все уровни ТР' .шгзмяф; Можно использовать в Web- категории или документов ниже приложениях. ее. - --
ViewHorizScrollBar Вид/папка должны быть Отображает в виде/папке ; »хг:?ж» открыты в текущем окне. горизонтальную полосу \ ' - Указатель курсора должен прокрутки. j " :." находиться в панели показа. - -".-| йовак и - яннвтийш «msm Команда не поддерживается на платформах OS/2 и Macintosh.
ViewMoveName Должен быть открыт вид Используется для ресертификации "Пользователь" ("Person") выбранных пользователей в новой ' дшмая*г*г общей адресной книги, и в виде организационной единице.
! ,шщт mlse ftiin « - мают ""^ один тя несколько ; документов.
ViewNavigatorsFolders Вид/папка должны быть Отображает в панели навигации i ..r.^.^i,, открыты в текущем окне. вида/папки стандартный навигатор по умолчанию.
ViewNavigatorsNone ,? лц&кй Вид/папка должны быть Скрывает панель навигации в открыты в текущем окне. текущем виде/папке.
ViewRefreshFields Документ должен быть открыт Осуществляет пересчет всех в режиме редактирования, или формул полей для текущего ^' ' вид/папка должны быть документа, или обновляет отглшвгвсрздэдп *г открыты в текущем окне. содержимое вида/папки. j .яняфк нтэг ?> йэ«жш s srr^or. Можно использовать в Web-приложениях.
ViewRefreshUnread '*"*"-'^;! В текущем окне должна быть Обновляет значение числа не открыта страница рабочего прочтенных документов в иконках I пространства. баз данных на текущем листе рабочего пространства.
ViewRenamePerson Должен быть открыт вид Используется для изменения "Пользователь" ("Person") общего или иерархического имени | .яин»::;; общей адресной книги, и в виде выбранного пользователя, выбран один документ.
ViewShowFieldHelp Документ должен быть открыт Отображает/скрывает строку ©InterTrust Со. Тел. (095) 9567928

Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 847
в режиме редактирования. подсказку описания полей.
ViewShowObject Документ должен быть открыт Отображает/скрывает пунктирной ; в режиме чтения. линией границы OLE/LEL объекта 1 ' в документе.
ViewShowOnlyCategories Вид/папка должны быть Отображает в виде только открыты в текущем окне. категории без документов. ТР' Работает как переключатель.
ViewShowOnlySearchResult Вид/папка должны быть Отображает в виде только s открыты в текущем окне. документы, удовлетворяющие Поиск с использованием условиям запроса полнотекстового , JP' полнотекстового индекса поиска. Работает как должен быть произведен. переключатель. ;
ViewShowOnlySelected Вид/папка должны быть Отображает в виде только открыты в текущем окне. выбранные документы. Работает ТР' как переключатель.
ViewShowOnlyUnread Вид/папка должны быть Отображает в виде только не открыты в текущем окне. прочтенные документы. Работает ТР' как переключатель.
ViewShowPageBreaks Документ должен быть открыт Отображает/скрывает линию в режиме редактирования. разрыва страницы для текущего '' --- документа, согласно параметрам выбранного принтера.
ViewShowRuler Документ должен быть открыт Отображает/скрывает линейку в режиме редактирования. форматирования для текущего документа.
ViewShowSearchBar Вид/папка должны быть Отображает/скрывает панель открыты в текущем окне. запросов полнотекстового поиска. Можно использовать в Web-J "* * ' ' приложениях. ;
ViewShowServerNames В текущем окне должна быть Отображает/скрывает имена } открыта страница рабочего серверов на иконках баз данных в пространства. рабочем пространстве.
ViewShowUnread В текущем окне должна быть Отображает/скрывает число не открыта страница рабочего прочтенных документов на с пространства. иконках баз данных в рабочем пространстве.
ViewSwitchForm Документ должен быть открыт Для текущего документа в режиме переключает его отображение по ТР' » . чтения/редактирования, или он новой указанной форме. 1 должен находиться в панели <- : предварительного просмотра, и ; *- фокус должен находиться в - 1 этой панели. Всегда . - у г выполняется последней в формуле.
WindowMaximize Нельзя применять в формулах Раскрывает на весь размер диалогового окна. главного окна активное окно, согласно линейке окон.
WindowMaximizeAll Нельзя применять в формулах Раскрывает на весь размер все диалогового окна. открытые окна.
© InterTrust Co. Тел. (095) 9567928

848 Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java ,.s
WindowMinimize Нельзя применять в формулах Свертывает активное окно, диалогового окна. согласно линейке окон.
WindowMinimizeAll Нельзя применять в формулах Свертывает все открытые окна, диалогового окна.
WindowRestore Нельзя применять в формулах Возвращает активное окно к диалогового окна. размерам до применения максимизации/минимизации.
Window Workspace Нельзя применять в формулах Переключается или открывает диалогового окна. окно рабочего пространства.
WorkspaceProperties В текущем окне должна быть Выдает окно свойств текущей открыта страница рабочего страницы рабочего пространства, пространства.
WorkspaceStackReplicalcons В текущем окне должна быть Совмещает/разделяет иконки баз открыта страница рабочего данных, являющихся репликами, пространства.
ZoomPreview Вид/папка должны быть Раскрывает или сворачивает открыты в текущем окне. панель предварительного просмотра документов.
1
f у.чка:«яг saiwHworfgv I mc-5 } 1. ' - -
V..1HP№№ CTOfiOTO>.
i * \
i_ ^___
»<;; < i
| - »">. акдяп !«;>>;::.
1 - "' ' '
i ''' '-.n '
t '
i
I . - -
\ i
1 "г"!в '«'ЧМГЗО i
© InterTrust Co. Тел. (095) 9567928

Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 849
-
":'".. -,.:,. Ј . 5.3. Алфавитный список операторов и функций LotusScript !
Функция Применение Назначение Стр.
Abs ( numExpr ) NumExpr - любое числовое Возвращает абсолютное 219 значение значение (модуль) числового значения ACos ( numExpr ) NumExpr - числовое значение от - Возвращает арккосинус 226 -атгшЁтэад- 1 до 1 включительно (arccos) в радианах > указанного числа - угол, косинус которого равен данному числу. ActivateApp WindowName - строка, Активизирует указанное 275 windowName соответствующая левой части программное окно Или строки, отображаемой в заголовке AppActivate окна. Если этому условию windowName удовлетворяет несколько окон - выбирается одно из них. Окно только активизируется, но не \ восстанавливает размеров, если _ оно было минимизировано Array Append (vl, v2) vl -значение типа Variant, Добавляет массив в конец 268 обязательно содержащее массив; другого массива и v2 - значение типа Variant, возвращает возможно содержащее массив результирующий массив ArrayGetludex ( arr, arr - массив; value - любое Возвращает позицию 269 value [, optCompare ]) значение; optCompare - число, значения в массиве. j задающее способ сравнения ArrayReplace(vl, v2, vl -исходный массив; v2- Возвращает копию массива 270 v3) скалярное значение или массив, с заменой указанных описывающий значения, значений на другие подлежащие замене; v3 - скалярное значение или массив, > описывающий подставляемые значения Asc (stringExpr) stringExpr - строка (обязательно Возвращает зависящий от 255 апоЛ непустая). Возвращается только платформы код первого код (число) первого символа символа строки ASin ( numExpr ) numExpr - числовое значение от - Возвращает арксинус 226 1 до 1 включительно (arcsin) в радианах указанного числа - угол, */*!№, v~i«<- синус которого равен , данному числу. АТп ( numExpr ) numExpr - числовое значение Возвращает арктангенс 226 (arctg) в радианах j указанного числа - угол, ^ , 1 тангенс которого равен данному числу. ATn2 ( numExprX, numExprX, numExprY - любые Возвращает значение угла, 226 numExprY ) ,, числовые значения (по крайней выраженное в радианах, мере одно из них д.б. отличным от образованного осью абсцисс ужктг нуля) и прямой, проходящей через заданную координатами
© InterTrust Co. Тел. (095) 9567928

4 850 Lotus Domino R, 5: @гформулы, LotusScript, встроенные классы LotusScript u Java '
Функция Применение Назначение Стр.
Uj^lJ точку и точку начала координат в декартовой ! .^Г* ' плоскости Веер Тональность звука зависит от Генерация однотонного 276 j j конкретной аппаратной звукового сигнала конфигурации v Bin[$] ( numExpr ) NumExpr - любое числовое Возвращает текстовое 234 } j значение. Если указано дробное двоичное представление ' ' значение, то перед получением указанного числа ; двоичного представления число i округляется до целого Call Вызов процедуры или i функции LotusScript | CCur (expr) expr - любое числовое значение Преобразует значение к 227 ! j или строка, допускающая типу данных Currency преобразование в число CDat (expr) Expr либо числовое значение, Преобразует значение в 227 либо строка, представляющая значение date/time число или дату \ CDbl (expr) expr - любое числовое значение Преобразует значение к 228 f или строка, допускающая типу данных Double преобразование в число ChDir path path - строка, представляющая Устанавливает текущую 283 ! путь к директории директорию ChDrive drive drive - строка, представляющая Устанавливает текущее 283 f .вам: имя существующего дискового дисковое устройство устройства ["'"' Chr[$] ( numExpr ) numExpr - числовое значение, Возвращает символ, 255 соответствующее зависящему от соответствующий платформы коду символа указанному коду CInt ( expr ) expr - любое числовое значение Преобразует значение к 229 или строка, допускающая типу данных Integer преобразование в число Class Определяет класс 202 ~ , CLng ( expr ) expr - любое числовое значение Преобразует значение к 229 1 или строка, допускающая типу данных Long преобразование в число Close „ Закрывает указанный ранее 294 открытый файл | CodeLock(ID) ID - числовое значение типа Закрывает указанный 316 j Н9&ЯЦ i» "iv Integer - идентификатор семафора семафор. Только для Web- ' * агентов CodeLockCheck (ID) ID - числовое значение типа Возвращает длину очереди к 317 j . j х&нв»: Integer - идентификатор семафора семафору - число агентов ! i ,r.o4v-sr закрывших семафор или ожидающих его открытия. Только для Web-агентов | CodeUnLock (ID) ID - числовое значение типа Открывает указанный 317 Integer - идентификатор семафора семафор. Только для Web- ; i > д- агентов Command [$] Возвращает строку, 276 переданную приложению в
© InterTrust Co. Тел. (095) 9567928 ,

к-, * vali, 1 s*»'. ь*««Й5-4'л -? .^ nMte*>«-<4- >W- *- '*''*'
Z,0Jto Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 851
Функция Применение Назначение Стр.
качестве параметра Const Декларация константы 138 Cos (angle) angle - числовое значение - угол в Возвращает косинус угла 226 радианах CreateLock (name) name - строка мнемоническое Возвращает идентификатор 316 . .,. имя семафора семафора. Если семафор до
OfcW
этого не существовал, то он 1 " создается. Только для Web-агентов CreateObject .,. _ className - строка, описывающая Создает объект OLE 313 (className) * имя класса Automation CSng ( expr ) expr - любое числовое значение Преобразует значение к 230 или строка, допускающая типу данных Single преобразование в число CStr (expr) expr - любое числовое значение, Преобразует значение к 230 типу данных String CurDirfS] [( drive )] drive - строка, задающая имя Возвращает текущую 283 устройства. Параметра директорию на устройстве I подразумевает текущее устройство CurDrive[$] Вовращает имя текущего 284 устройства CVar (expr) expr - произвольное значение Преобразует значение к 230 типу данных Variant DataType (expr) expr - произвольное значение Возвращает тип (в виде 230 номера) указанного значения Date[$] (функция) м^ч,. Возвращает текущие 257 системные дату и время Date[$] = dateExpr DateExpr - значение типа Variant, Устанавливает системные 257 (оператор) содержащее дату/время, либо дату и время строка, допускающая ц^ш: .-интерпретацию как дата/время DateNumber (year, year, month, day - числовые Возвращает значение типа 258 month, day) SJr значения дата по указанному году, ~ месяцу и дню Date Value (stringExpr) StringExpr - строка, допускающая Преобразует текстовое 259 интерпретацию как дата/время представление даты в значение типа дата Day (dateExpr) dateExpr - значение типа Возвращает номер дня в 260 дата/время, число значение, месяце для указанной даты лежащее в диапазоне от -657434 до 2958465, строка, допускающая интерпретацию как дата/время Declare Декларирует функцию или 201
--, „v -эжпшН - wTeeasKXpwRo.. процедуру LotusScript, 1 которая вызывает внешнюю С-функцию DefType шанаю( нМ»А Задает тип данных по 147
, ^*ма„.„-,и„« ^«хржок.]- йшнэшдоооакчоц умолчанию для j ' переменный, функций и свойств, чье имя начинается
© InterTrust Co. Тел. (095) 9567928

852 Lotus Domino R, 5: @гформулы, LotusScript, встроенные классы LotusScript и Java
Функция Применение Назначение Стр.
с символа, входящего в указанную группу Delete objRef objRef- переменная специального Уничтожает в памяти 208 -л типа со ссылкой на объект или указанный объект. Если переменная типа Variant, объект имеет деструктор - содержащая ссылку на объект процедуру Delete -, то она предварительно выполняется DestroyLock (ID) ID - числовое значение типа Удаляет ссылку текущего 318 Integer - идентификатор семафора потока на указанный ***} ,^-^-j семафор. Если при этом '.L'~~I^~~-.' общее количество ссылок на 1 * эшг этот ресурс оказывается . t , -' ^'й4*' равным нулю, то семафор Г'1„ удаляется. Только для Web- ' '" '"' агентов Dim * Декларация переменной Dir [$] [(fiieSpec, ftleSpec - строка - путь и маска В Тависимости от способа 284 [attrMask])] искомых файлов (директорий); вызова возвращает имена attrMask - число, определяющее файлов и директорий в L____ _ , „ тип возвращаемого результата указанной директории или ^-1 °^ (например, атрибуты искомых метку тома файлов) - Do Выполняет блок операторов 1 80 в цикле с выходом из цикла по условию End Прекращает выполнение 185 скрипта Environ [$] ( { EnvironName - строка (в верхнем Возращает значение 276 environName | n } ) регистре) - имя переменной переменной среды п - число - позиция переменной в операционной системы таблице переменных среды EOF(fileNumber) FileNumber - номер файла Возвращает признак - 308 достигнут ли конец файла Erase Удаляет массив, список или 1 53 элемент списка ErI i_~ Возвращает номер строки в 326 | исходном тексте скрипта, в { в мтед 5HF >'|ГМ «*«» которой произошла текущая ошибка Err (функция) Возвращает номер текущей 326 ошибки Err = errNumber errNumber - числовое значение - Устанавливает код текущей 324 (оператор) код ошибки ошибки Error[$] [(errNumber)] ErrNumber - числовое значение, Возвращает строку, 324 (функция) задающее код ошибки содержащую сообщение об j По умолчанию подразумевается ошибке г текущая ошибка Error errNumber [, ErrNumber - числовое значение, Вызывает возникновение 324 msgExpr] (оператор) задающее код ошибки ошибки с указанным msgExpr - строка с сообщением номером (и сообщением) об ошибке
© InterTrust Со. Тел. (095) 9567928 ,

Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 853
Функция Применение Назначение Стр.
Evaluate ((macro [, object ] macro - строка, содержащая текст Выполняет макрос ) макроса (формула), который продукта. В Notes макросом необходимо выполнить является @-формула object - объект продукта, в i -> wmritetifcy-t контексте которого исполняется <»~| ( , макрос Execute text Text - строка с исходным текстом Компилирует и исполняет /да* о скрипта „,. скрипт, заданный исходным [ текстом Exit blockType blockType - ключевое слово, Прерывает выполнение 184 определяющее тип блока блока операторов Exp (numExpr) numExpr - числовое значение, Возвращает экспоненту 219 задающее степень экспоненты числа (е в степени числа) FileAttr (fileNumber, fileNumber число - номер файла Возвращает системный 286 attribute) attribute - число - тип результата дескриптор или тип доступа ™J .,.- указанного файла FileCopy source, source - путь к оригинальному Копирует указанный файл 288 destination файлу destination - путь к новому файлу FileDateTime(fileName fileName - строка - путь и имя Возвращает строку, 287 ) файла содержащую дату и время ! ниш ,--.э<)8\ыт8/: « создания или послнего \ изменения файла FileLen(fileName) fileName - строка - путь и имя Возвращает размер в байтах 287 файла указанного файла Fix(numExpr) numExpr - любое числовое Возвращает целую часть 220 значение числа For Выполняет блок операторов 179 в цикле указанное число раз ForAll Выполняет блок операторов 1 82 в цикле для каждого элемента массива, списка или коллекции Format[$] (expr [, fmt]) expr - любое значение Форматирует число, дату 262 fmt - строка специального или строку указанным . .., формата, определяющая формат образом ' результата Fraction(numExpr) numExpr - любое числовое Возвращает дробную часть 220 значение числа FreeFile Возвращает незанятый 309 номер файла FullTrim(v) v - строка или массив В строке удаляет 253 лидирующие, замыкающие !° RRi и повторяющиеся пробелы; >;», .ж в массиве удаляет пустые . элементы Function Определяет функцию 1 87 LotusScript Get Считывает в переменную 295 w *K: данные из двоичного файла или файла произвольного [ доступа
©InterTrust Co. Тел. (095)9567928

854 Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java
Функция Применение Назначение Стр.
GetFileAttr(fileName) fileName - строка - путь и имя Возвращает атрибуты файла 287 файла или директории или директории GetObject(pathName [, pathName - строка - путь и имя Открывает OLE Automation 314 className]) файла приложения-сервера объект из указанного файла i / className - строка - имя класса или текущий указанного класса GetThreadlnfo(infoID) infoID - число, задающее код Возвращает системую 319 >>';..,>» исследуемого параметра информация о текущем потоке GoSub label label - строка - метка оператора Передает управление в 178 скипте на указанную метку в возможностью возврата GoTo label label - строка - метка оператора Передает управление в 176 скипте на указанную метку без возможности возврата Hex[$](numExpr) numExpr - любое числовое Возвращает 221 :. : Р. значение шестнадцатиричное ' текстовое представление числа Hour (dateExpr) dateExpr - значение типа Возвращает номер час в 260 дата/время, число значение, сутках (число от 0 до 23) лежащее в диапазоне от -657434 для указанной даты/времени < - , до 2958465, строка, допускающая интерпретацию как дата/время If Условный оператор. 174 %If Опирается на значения констант, Директива условной 132 , определенных в продукте компиляции исходного текста скрипта. IMESetMode(IMEMod IMEMode - целое число - Устанавливает текущий е) константа, определяющая режим режим ввода (IME). : Только для систем Windows « .J . , .-. DBCS IMEStatus Возвращает текущий режим ,-.,, ввода (IME). Только для систем Windows DBCS %lnclude fileName fileName - путь и имя ASCII- Включает в текст скрипта 131 файла скрипт из файла Input #fileNumber, fileNumber - число - номер файла, Считывает данные 296 variableList полученный при открытии указанного файла i variableList - текст - список последовательного доступа переменных в указанные переменные Input[$] (count, count - число, необходимое Считывает без 309 [#]fileNumber) количество символов преобразования из зм r-jvT; fileNumber - число, номер файла двоичного файла или файла ' последовательного доступа *". , ---и-1г^~---г~-ггтг*~- указанное количество символов InputB[$] (count, count - число, необходимое Считывает без 310 [#]fileNumber) количество символов преобразования из ; fileNumber - число, номер файла двоичного файла или файла последовательного доступа
© InterTrust Co. Тел. (095) 9567928

Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 855
,..,.,. ..; '/.>. .' ' : ' '' - ' ''
Функция . Применение Назначение Стр.
указанное количество байт InputBox[$] (prompt[, prompt, title, default - строки; Открывает диалоговое окно 272 [title] [,[default][,xpos, заголовок окна, комментарий и и возвращает введенную ypos]]]) значение по умолчанию пользователем строку соответственно .".,. xpos и ypos - числовые значения, ! задающие положение диалога на экране InputBP[$] (count, count - число, необходимое Считывает из двоичного [#]fileNumber) количество символов файла или файла fileNumber - число, номер файла последовательного доступа ,г . ,,.,, указанное количество байт с
;->Ј** Nfk«.
преобразовнием в | .,:,.. кодировку текущей 1 платформы InStr ([begin,] string!, begin - положительное целое Возвращает позицию 247 string2[, compMethod] ) число - стартовая позиция поиска первого символа искомой в целевой строке строки в целевой строке | ' string 1 , string2 - строки - искомая Т 1 х ' ti-. и целевая соответственно |
| ёiwlv !
: .- compMethod - число, ,1 '~„~~~,'„~\ определяющее особый способ сравнения строк InStrB ([begin,] string 1, begin - положительное целое Возвращает позицию 249 string2) число - стартовая позиция поиска первого байта искомой в целевой строке строки в целевой строке ^ , string I, string2 - строки - искомая и целевая соответственно InStrBP ([begin,] begin - положительное целое Возвращает позицию 249 string! , string2) число - стартовая позиция поиска первого байта (в кодировке в целевой строке текущей платформы) string 1, string2- строки -искомая искомой строки в целевой j и целевая соответственно строке InStrC (off, string 1, off -положительное целое число- Только для систем письма в 249 string2) стартовая позиция поиска в колонку (например, целевой строке тайской). Сканирует j string 1 , string2 строки - искомая целевую строку и -7^1 и целевая соответстсвенно возвращает позицию первой !
\ rtJIUtf! .; : i,
» . . ... колонки, содержащей j искомую строку Int (numExpr) numExpr - любое числовое Возвращает целое число, 222 " значение меньшее или равное , указанному IsArray (expr) , expr любое значение Проверяет, является ли 280 агрумент массивом IsDate (expr) expr - любое значение Проверяет, является ли , 279 ; , агрумент значением типа дата/время IsDefmed (StringExpr) StringExpr - любая строка Определяет, является ли 282 Функция является аналогом указанное значение именем директивы %If, но для времени константы, определенной в исполнения. продукте. ..
©InterTrust Ср. Тел. (0%51%$<$9Ж\ ..;.

856 Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java
Функция Применение Назначение Стр.
IsElement (listName ( listName - имя списка Проверяет список на 281 stringExpr)) stringExpr - строка - искомый наличие указанного ключ списка элемента IsEmpty (expr) expr - любое значение Проверяет, является ли 279 агрумент значением EMPTY IsList(expr) expr - любое значение Проверяет, является ли 281 агрумент списком IsNulI (expr) expr - любое значение Проверяет, является ли 279 агрумент значением NULL IsNumeric (expr) expr - любое значение Проверяет, является ли 279 агрумент числовым j r) r* t. „ значением или значением, ; . : ! -* - допускающим ** преобразование к числу IsObject (expr) expr - любое значение Проверяет, является ли 215 ' ;*Ц агрумент объектом 1 ' встроенного класса или ' 1 5ХС объектом класса, j . определенного -'- пользователем или OLE- autimation объектом IsScalar (expr) expr - любое значение Проверяет, является ли тип 280 „,„,,„ *_- значения аргумента скалярным типом Isllnknown (expr) expr - любое значение Проверяет, является ли 282 значение аргумента OLE значением V IUNKNOWN Kill fileName fileName строка - путь и имя Удаляет файл 289 файла LBound (arrayName [, arrayName - строка - имя массива Возвращает значение 267 dimension]) dimension - число - измерение нижней границы указанного массива (по умолчанию 1) измерения массива LCase[$] (expr) expr - строка, а также возможно Возвращает представление 254 ->:. -*,- .* ««л.*-. число (в случае Lease), либо строки в нижнем регистре j значение типа Variant (в случае !' LcaseS) Left[$] (expr, n) expr - строка, а также возможно Возвращает указанное 236 число (в случае Left) или значение количество символов строки типа Variant (в случае Left$) слева ;- n - число - необходимое число -_..,. символов LeftB Использовать не следует, т.к. Для строки возвращает 237 .,,_.^_ строки в LotusScript - в кодировке указанное количество ьи е- Unicode. Следует использовать байтов слева без функцию Left преобразования LeftBP [$] (expr, n) expr строка, а также возможно Для строки возвращает 245 число (в случае LeftBP), либо указанное количестве значение типа Variant (в случае байтов слева с LeftBP$) преобразованием в n - число необходимое число кодировку текущей байт платформы | LeftC (stringExpr, n) stringExpr - строка Только для систем письма в 238
© InterTrust Co. Тел. (095) 9567928

~-п, -...., '--*
Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 857
Функция 1 Применение ' Назначение Стр.
п - число - необходимое число колонку (например, ,, , колонок тайской). Для строки ! возвращает указанное количество колонок слева Len (expr) expr - либо строка, либо значение В зависимости от вида 244 . , > типа Variant (преобразуется к аргумента возвращает либо | онмо строке), либо числовое значение число символов в строке, | sohhg» (самостоятельная переменная, либо объем занимаемой элемент массива, списка, член аргументом памяти в байтах определенного пользователем типа или класса) Len В (expr) expr - либо строка, либо значение В зависимости от вида 245 типа Variant (преобразуется к аргумента возвращает либо 1 | _ строке), либо числовое значение число байт в строке (во (самостоятельная переменная, внутренней кодировке элемент массива, списка, член LotusScript), либо объем 4 ' ' определенного пользователем занимаемой аргументом типа или класса) памяти в байтах LenBP (expr) expr - либо строка, либо значение В зависимости от вида 245 (l типа Variant (преобразуется к аргумента возвращает либо то кс строке), либо числовое значение число байт в строке (в RfiHHSi^sit от, (самостоятельная переменная, кодировке платформы), { элемент массива, списка, член либо объем занимаемой определенного пользователем аргументом памяти в байтах типа или класса) LenC (stringExpr) stringExpr - строка Только для систем письма в 245 г"- колонку (например, S н кщшн'/с| тайской). Возвращает длину 1 сир ti»«M строки в смысле количества ^ колонок. [Let] variablelD = expr variablelD - имя переменной Оператор присвоения 1 73 expr - значение значения переменной. Оператор Let может ' -' ' ! ..*-; к,г безболезненно пропускаться Line Input #fileNumber fileNumber - число - номер файла, Из файла последовательного 298 , varName г полученный при открытии доступа считывает строку в 1 . ."г,й"замг! varName - имя строковой или переменную * ^ ' ~ j Variant переменной =
ListTag (refVar) refVar - переменная перебора Для элемента списка 281 внутри оператора ForAll возвращает его имя (ключ) LOC (fileNumber) fileNumber - число - номер файла, Возвращает позицию 3 1 0 ! полученный при открытии последнего чтения или 1 i l^: Результат пойимается несколько записи в указанном ? ' ' по-разному в зависимости от типа открытом файле файла Lock Всегда следует использовать в Обеспечивает блокирование 298 паре с UnLock доступа к данным файла LOF (fileNumber) fileNumber - число - номер файла, Возвращает длину 311 полученный при открытии открытого файла в байтах Log (numExpr) numExpr любое положительное Возвращает натуральный 222 число логарифм числа
...... © InterTrust Со. Тел. (095)9567928^. 's

858 Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java
Функция Применение Назначение Стр.
Lset stringVar = stringVar - имя переменной Присваивает переменной 235 stringExpr (строковой или Variant) указанную строку с stringExpr - любая строка выравниванием влево Ltrim (stringExpr) stringExpr - любая строка Удаляет из строки 252 лидирующие пробелы MessageBox ( message message, boxTitle - строки; Открывает простое 273 [, [ buttons + icon + сообщение и заголовок окна диалоговое окно default + mode] [, соответственно (информационное boxTitle ] ] ) Buttons, icon, default, mode - числа сообщение, вопрос и т.п.) и (или соответствующие ожидает реакции I стандартные константы); тип пользователя. Функция i -™. диалогового окна (набор кнопок), возвращает код нажатой значок, выбор по умолчанию, тип кнопки окна Mid[$] (expr, start [, expr - любая строка или число Функция для заданной 246 length]) [= stringExpr] (преобразуется к строке перед строки возвращает выполнением) - просматриваемая подстроку указанной длины - \. строка с указанной позиции. Длина „..-;__ 4 .._. start - целое положительное число подстроки и позиция j ~ - стартовая позиция выборки считаются в символах. I length - целое положительное Оператор отличается от число - длина возвращаемой функции тем, что найденная ( подстроки подстрока заменяется ' . . stringExpr ~ любая строка - другой указанной строкой
используется для замены
подстроки MidB Использовать не следует, т.к. Функция и оператор 246 строки в LotusScript - в кодировке отличаются от функции и Unicode. Следует использовать оператора Mid тем, что функцию Mid позиция и длина искомой подстроки измеряются в байтах, а не в символах MidBPfS] (expr, start [, expr - любая строка или число Функция MidBP отличается 247 length]) (преобразуется к строке перед от функции Mid тем, что ";~Г?~ выполнением) - просматриваемая позиция и длина искомой строка подстроки измеряются в start - целое положительное число байтах, а не в символах. 1 ''' - стартовый байт выборки Счет байт идет в кодировке | length - целое положительное текущей платформы r«~f "" ~~ "" число - длина возвращаемой * ' " подстроки в байтах MidC (string, off, n) string - строка Только для систем письма в 247 \ off -число -начальная позиция колонку (например, j выборки тайской). Для строки - n - число - необходимое число возвращает указанное - колонок количество колонок, начинаю с указанной позиции Minute (dateExpr) dateExpr - значение типа Возвращает номер минуты в 261 " j r. . дата/время, число значение, часе (число от 0 до 59) для лежащее в диапазоне от -657434 указанной даты/времени до 2958465, строка, допускающая
© InterTrust Со. Тел. (095) 9567928 s.

Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 859
Функция (Применение Назначение Стр.
интерпретацию как дата/время MkDir path path - строка, указывающая имя и Создает новую директорию 285 путь новой директории Month (dateExpr) dateExpr - значение типа Возвращает номер месяца в 260 дата/время, число значение, году (число от 1 до 12) для __; 2 лежащее в диапазоне от -657434 указанной даты/времени до 2958465, строка, допускающая интерпретацию как дата/время Name oldName As oldName, newName - строки - Переименовывает файл или 285 newName старое и новое имя директорию соответственно л. а ч ,л , ,„
Now Возвращает текущие 257 ., j , . системные дату и время как *"*'! ^«гг'-йоч». значение типа дата/время Oct (numExpr) numExpr - любое числовое Возвращает текстовое 234 - ; » значение. Если указано дробное восьмеричное 1 -..--. значение, то перед получением представление указанного * двоичного представления число числа f*s округляется до целого On Error Определяет способ 325 обработки ошибки в текущей процедуре On Event ,_,.,.,/ Указывает способ обработки события объекта On numExpr GoTo \ numExpr - число - порядковый Передает управление на 1 78 GoSub label [, label, ... ] номер метки для перехода; не метку, порядок которой в : может быть больше 255 списке указан числом, label, label, ...--строки -имена GoSub от GoTo отличается возможных меток для перехода возможностью возврата. Open fileName [For fileName - строка - имя и путь Открывает указанный файл 299 options] As файла для чтения или записи [#] fileNumber fileNumber - целое число; [Len=recLen] получаемое значение впоследствии определяет файл , при всех прочих операциях \ \ 1 , options - набор ключевых слов, ; [ f определяющих вид файла и ; -, '^J^'., __ _- _ ,.- способ его открытия --* гА >-'' '.''и ^ашгздзйн recLen - положительное целое шйг«.., число - длина записи файла :
Option Base base base - число - 0 иди 1 Устанавливает значение 1 49 нижней границы 1 размерности массива по умолчанию (0 или 1 ) Option Compare option 1 , option2 - строки - Устанавливает метод 1 63 option! [, option2 ] ключевые слова, определяющие сравнение строк правила сравнения Option Declare Вводит запрет на неявное объявление переменных Option Public Указывает, что явные объявления на уровне
©InterTrust Co. Теп. (095)9567928

860 Lotus Domino R. 5: (^-формулы, LotusScript, встроенные классы LotusScript и Java
Функция Применение Назначение Стр.
модуля являются Public по умолчанию Print [exprList] exprList - список выражений, Выводит данные в строке 301 разделенных через пробел, состояния. В фоновом запятую или точку с запятой агенте выводит данные в протокол работы сервера Print #fileNumber, fileNumber - число - номер файла, Выводит данные в 302 [exprList] полученный при открытии последовательный ' 'г» ^{-Ф^^яиг exprList - список список текстовый файл. < строковых и (или) числовых 1 выражений, разделенных через -;нЫ "-"- пробел, запятую или точку с запятой Property Get | Set Определяет свойство 198 LotusScript Put [#] fileNumber, fileNumber - число - номер файла, Записывает значения 304 [recordN umber], полученный при открытии переменных в файл -variableName recordNumber - число - позиция в двоичный или | файле для записи (байт или произвольного доступа - ~rrf "" " ' " запись) ""'"! - .."' ,. variabJeName - переменная, ' { значение которой должно быть записано Randomize [numExpr] numExpr - произвольное числовое Инициализирует генератор 222 выражение - отправная точка псевдослучайных чисел | генератора; по умолчанию -данные системного таймера ReDim [Preserve] arrayName - имя объявляемого Объявляет динамический 150 arrayName (bounds) [As или переопределяемого массива массив или переопределяет type] bounds - размерность массива его размерность [, arrayName (bounds) (список через запятую для [As type]]... многомерного массива) .^--,, «, д? : -; type - тип массива (тип данных ( элементов) 1 Preserve - при переопределении у ^ \ размерности указывает на j необходимость «по возможности» сохранить значения элементов Rein text text - любой текст в одну строку - Служит для введения в 124 ч комментарий исходный текст скрипта однострочного комментария %Rem _. text - любой текст, возможно Служит для введения в 124 text многострочный - комментарий исходный текст скрипта %End Rem ,.,^fi.» многострочного
:~ t'f ч#1«#1&1*Я - f ;
комментария Reset Закрывает все открытые 305 файлы Resume [ 0 | Next | label исполнение продолжается . . . Возобновляет указанным 325 ] 0 - с того же оператора, что способом выполнение } " вызвал ошибку скрипта после обработки ' т* "' Next - со следующего оператора ошибки aite-s' label - с указанной метки
© InterTrust Со. Тел. (095) 9567928

Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 861
Функция Применение Назначение Стр.
Return После перехода на метку с 1 79 помощью On . . . GoSub возвращает управление оператору, следующему за оператором перехода Right[$] (expr, n) expr - строка, а также возможно Возвращает указанное 240 I | число (в случае Right) или количество символов строки значение типа Variant (в случае справа Right$) n - число - необходимое число символов RightB Использовать не следует, т.к. Для строки возвращает 241 строки в LotusScript - в кодировке указанное количество Unicode. Следует использовать байтов справа без функцию Right преобразования RightBP[$] (expr, n) expr - строка, а также возможно Для строки возвращает 241 число (в случае RightBP), либо указанное количество ) значение типа Variant (в случае байтов справа с ^ ; > i ; j одованмг RightBPS) преобразованием в ! n число - необходимое число кодировку текущей байт платформы RightC (stringExpr, n) stringExpr - строка Только для систем письма в 241 n - число - необходимое число колонку (например, _,;.„[_. „„ * колонок тайской). Для строки .?§Ј} эшшэтак:* ч *н« - -&„» возвращает указанное количество колонок справа RmDir path path - строка, указывающая имя и Удаляет директорию 286 путь удаляемой директории Rnd [(numExpr)] numExpr - любое числовое Возвращает очередное 223 выражение; знак числа определяет псевдослучайное число. ячш положение результата в .. .. _4- - » - псевдослучайной ^, последовательности Round (numExpr, numExpr - любое числовое Округляет число до 224 places) выражение - число, подлежащее указанного количества ; округлению значащих цифр places - любое числовое - - - 1 выражение; определяет j __ количество значащих цифр после ^ __.. округления Rset stringVar = string Var - имя переменной Присваивает переменной 236 stringExpr (строковой или Variant) указанную строку с stringExpr - любая строка выравниванием вправо Rtrim (stringExpr) stringExpr - любая строка Удаляет из строки концевые 253 пробелы Run He используется См. Evaluate Second (dateExpr) dateExpr - значение типа Возвращает номер секунды 261 дата/время, число значение, в минуте (число от 0 до 59) ,|„...„ . . лежащее в диапазоне от -657434 для указанной даты/времени | *; до 2958465, строка, допускающая интерпретацию как дата/время Seek (fileNumber) fileNumber - число - номер файла, Функция возвращает 311
©InterTrust Co. Тел. (095) 9567928

862 Lotus Domino R. 5: ©-формулы, LotusScript, встроенные классы LotusScript и Java
Функция Применение Назначение Стр.
полученный при открытии текущую позицию указателя Результат понимается несколько в открытом файле по-разному в зависимости от типа файла Seek [#] fileNumber, fileNumber - число - номер файла, Оператор устанавливает 311 position полученный при открытии текущую позицию указателя position - число - новая позиция в открытом файле указателя в файле Результат понимается несколько по-разному в зависимости от типа файла Select Case Основываясь на значении 1 76 выражения, выбирает группу операторов для исполнения SeradKeys He поддерживается Notes. Передает в активное окно 276 последовательность, имитирующую пользовательский ввод с ' клавиатуры Set , Присваивает переменной 213 [Ш «й«мзнг ссылку на объект или ассоциирует объект с переменной SetFileAttr fileName, fileName - строка - имя и путь Устанавливает системные 289 attributes файла атрибуты файла attributes - целое число; в двоичном виде биты данного числа ассоциированы с системными атрибутами файла Sgn (numExpr) numExpr - любое числовое Определяет знак числового 225 выражение выражения Shell (program [, program - строка - имя и путь Запускает программу. 277 ' windowStyle]) программы; также может содержать и строку параметров t чф windowStyle - целое число -определяет стиль окна Sin (angle) angle - числовое значение - угол в Возвращает синус угла 226 радианах Sleep (time) time - число - время в секундах Приостанавливает 318 , выполнение скрипта на указанное время (не занимая ресурсов) Space[$] (numExpr) numExpr - любое числовое Возвращает строку, 250 выражение состоящую из указанного числа пробелов Spc (numExpr) numExpr - число от 0 до 32000 В выводе операторов Print и 250 Print # вставляет указанное число пробелов Sqr (numExpr) numExpr - любое неотрицательное Возвращает квадратный 225 числовое выражени корень числа Stop В режиме отладки 278
©InterTrust Со. Тел. (095) 9567928

Lotus Domino R. 5: @гформулы, LotusScript, встроенные классы LotusScript и Java 863
Функция Применение Назначение Стр.
имитирует точку останова Str[$] (numExpr) numExpr - любое числовое Возвращает строковое 251 выражение представление числа StrCompare (string 1, string 1 , string2- произвольные Выполняет сравнение двух 251 string2 [, compMethod]) строки строк compMethod - число, определяющее правило сравнения StrConv (expr, expr - любая строка или числовое Производит преобразование 254 conversionType) выражение (предварительно строки к другому регистру , преобразуется к строке) или перекодировку в другую ; conversionType - целое число, таблицу символов (только _ „ l__ определяющее тип для восточных языков) преобразования StrLeft (string!, string2 string 1 - строка, в которой Просматривает строку слева 238 [, flag [, occurrences]]) производится поиск направо и возвращает I ..-..„ . ... string2 - строка-образец подстроку из символов, *<»[ оят"зишго>1 . flag - число, определяющее находящихся слева от {поп з способ сравнения указанной подстроки occurrences - число - задает номер совпадения при поиске подстроки StrLeftBack (string 1, string 1 - строка, в которой Просматривает строку 239 string2 [, flag [, производится поиск справа налево и возвращает occurrences]]) string2 - строка-образец подстроку из символов, j flag - число, определяющее находящихся слева от : .„,„-,„--.. способ сравнения указанной подстроки occurrences - число - задает номер совпадения при поиске подстроки StrRight (string 1, string 1 - строка, в которой Просматривает строку слева 241 string2 [, flag [, uiorvq'f производится поиск направо и возвращает j occurrences]]) м'.йянэ» string2 - строка-образец подстроку из символов, j flag -- число, определяющее находящихся справа от способ сравнения указанной подстроки *ervJwi»Jw !.ш* occurrences - число - задает номер совпадения при поиске подстроки StrRightBack (string 1, string 1 - строка, в которой Просматривает строку 243 string2 [, flag [, мш\о производится поиск справа налево и возвращает | occurrences]]) string2 - строка-образец подстроку из символов, flag - число, определяющее находящихся справа от способ сравнения указанной подстроки occurrences - число - задает номер совпадения при поиске подстроки String[$] (stringLen, { stringLen - числовое выражение - Возвращает строку заданной 252 charCode | stringExpr }) необходимая длина строки длины, составленную 'жчлуд charCode - код символа в повторением заданного кодировке текущей платформы символа (кодом кодировки ~"~Г":~а~~ stringExpr - любая строка; первый платформы или образцом) affdy<| , символ используется для ; составления результирующей ..^.,; строки ' Sub , ;: Определяет подпрограмму 195 LotusScript Tab (column) column - число от 0 до 32000 В выводе операторов Print 312
© InterTrust Co. Тел. (095) 9567928

864 Lotus Domino R. 5: (^-формулы, LotusScript, встроенные классы LotusScript и Java
Функция Применение Назначение Стр.
или Print # устанавливает -. -' ;' :>- «курсор» в указанную позицию
Tan (angle) angle - числовое значение - угол в Возвращает тангенс угла 226 радианах Time[$] Возвращает системное 258 время Time[$] = timeExpr timeExpr - любое выражение, Устанавливает системное 257 значение которого может время интерпретироваться как дата/время (строка, Variant) TimeNumber (hour, hour, minute, second - любые Возвращает значение типа 258 minute, second) числовые выражения, значения дата/время на основе которых соответствуют часу, заданных числами часа, минуте и секунде минуты, секунды Timer Возвращает количество 262 | -. ' рнне прошедших с полуночи секунд TimeValue (stringExpr) stringExpr - строковое Возвращает значение типа 259 представление даты/времени дата/время заданное строкой Today Возвращает системную дату 258 Trim [$] (stringExpr) stringExpr - произвольная строка Удаляет из строки 253 лидирующие и концевые пробелы Туре Определяет специальный (пользовательский) тип TypeName (expr) expr - произвольное выражение Возвращает строку, 232 '' Т&&1-- идентифицирующую тип данных значения или выражения Ubound (arrayName [, arrayName - строка - имя массива Возвращает значение 268 dimension]) - dimension - число - измерение верхней границы указанного массива (по умолчанию 1) измерения массива UCase[$] (expr) expr - любое строковое или Преобразует к верхнему 254 1 тлйШ8ш;тоз н числовое (для UCase) или Variant регистру все буквенные (для UCase$) выражение символы строки UChr[$] (longExpr) longExpr - любое выражение с Возвращает символ, 256 числовым значением от 0 до 65535 имеющий указанный код Unicode Uni (stringExpr) stringExpr - любая строка Возвращает код Unicode 256 первого символа строки UnLock Используется в паре с Lock Обеспечивает 298 j разблокирование доступа к данным файла Use useScript useScript - строковый литерал или Подгружает модуль, f * строковая константа определяет содержащий Public 1 модуль, подлежащий подгрузке объявления, необходимые для компиляции модуля UseLSX IsxLibraryName - строковый Подгружает файл IsxLibraryName литерал, который задает либо имя расширения LotusScript и путь, либо шаблон имени файла, (LSX), содержащий Public
© InterTrust Со. Тел. (095) 9567928

880 Lotus Domino R. 5: (^формулы, LbtttsScripr, ettHp'oenit6ie KtttitXbi LotusScript 'it JaVu ' '
.,цц$$щ#1ш^ . - :;щ<*/1л- ,»s»»w49J*4«»" ***«-"«-< - "Ч"»- v »-4*H«*Bii
5.5. Глоссарий * ' _ .
л»"ЛЭо^г 3r:*inJ Ы * r . . , -~ -.
К- ..1.^,,»tv,..i,.,,...M.aag«t;bJi9*yw*i f
^ ,.V:Ui*tS.i . '
Ш-файл User Ш Файл, связанный с каждым пользователем или серверов, и который уникально идентифицирует его
,- v- ; ;;.- , владельца в сети LN/Domino. - '-
', Г> "" Т , '.-: :ifi.*i'»5 ' -\'7
Lotus Lotus > * Программная среда для рабочих групп, Notes/Domino Notes/Domino используемая для совместной работы. LNXDomino (LN\Domino) обеспечивает совместную работу пользователей, использующих разные операционные системы и .-Ч-.- , аппаратное обеспечение, независимо от
%' "-' ' ' ...--. .- -*.?!-,'.-, t J '
технических, организационных и географических
^ =и , ..... границ.
""*: А """"" " "
Автозапуск OLE- Autolaunch Свойство OLE-объекта, позволяющее при создании объектов или редактировании документов автоматически ' ,N;.a-0. открывать данный объект в приложении, в котором он был создан. При изменении или создании нового
1 ' '*- ..... ,.,...,, OLE-объекта LN автоматически обновляет содержимое документа.
Автора уровень Author access Уровень доступа к базе данных, при котором доступа к базе пользователь(сервер) имеет право читать * документы, может иметь право создавать ..-г, » документы, но редактировать может только те документы, для которых он является автором.
Сервер с уровнем доступа автора может реплицировать новые документы, и обычно удалять ;,,,-. ' 1, - i .. , .„ , документы, помеченные для удаления. Администратор базы данных может в дальнейшем переопределить уровень доступа с использованием j ' . чс.ч - ..,..„ механизма ролей и ограничений доступа в ACL.
Агент Agent Независимая подпрограмма в дизайне базы данных на языке разработки приложений LN (язык формул, простые действия, LotusScript, Java) выполняемая
. . ,„ , ... ,._. ..... либо: bw ^ .... ... .,...,... ,...?*?
- - - '- вручную; '"-" '" ...-..-,..--- .../-
- .. , по возникновению определенного события у: (например, приход почты);
по расписанию. fc ---'"" Событие, при котором осуществляется запуск .';:''1. . .„ .,..„... агента, называется его триггером.
" - - ' * , . , Агент обрабатывает только те документы, которые ,, s соответствуют его критерию отбора и к которым он имеет право доступа согласно ACL.
© InterTrust Co. Тел. (095) 9567928

Lotus Domino R. 5: (^-формулы, LotusScript, встроенные классы LotusScript и Java 881
Агент МТА Message Агент передачи почты, также называемый шлюзом, transfer agent представляет собой программу преобразующий (МТА) почтовые сообщения между различными форматами.
Агент личный Personal agent Агент, работать с которым может только пользователь, его создавший.
Агент общий Shared agent Агент, доступный для работы ряду пользователей (включая сервера).
Агент скрытый Hidden agent Агент, который запускается из другого агента, или из окна списка агентов.
Агент фоновый Background Агент, автоматически запускаемый по факту agent возникновения определенного события (по расписанию, по приходу в базу почты, при вставке документов через буфер обмена, по изменению/добавлению в базу документов). Такие ,з,г - л.эткзоП Tjit-Mtrt-uM 43J5 R3i,4t,t, агенты можно отключить в окне свойств базы «'.'» и>гл данных.
" ч. **
Агент, « Run once agent Агент, результат выполнения которого не зависит запускаемый от контекста его применения. Может запускаться однократно '* "*->NSu " *'J/t только из списка агентов или из другого агента.
При использовании в качестве языка разработки @-формул, последние исполняются однократно. В этом то tweaker ajo/nw**- w%-nEvti3«»G случае допускается также использование @-команд мак-» :Д *^ ос в теле агента.
Агент, Scheduled agent Агент, автоматически запускаемый по наступлению запускаемый по указанного времени. Могут выполняться каждые 5 расписанию ,гу»\ _,, ./;«», п„ минут, ежедневно, еженедельно, ежемесячно.
Агент, Paste-activated Агент, автоматически запускаемый по событию запускаемый по agent копирования в базу данных документов из буфера
_ ?СН^НУ -
событию обмена копирования в .-..чнэ" ок базу документов из буфера обмена
Агент, Change- Агент, автоматически запускаемый по событию запускаемый по activated agent изменения или добавления в базу данных событию документов. ->, ^ -».-,-появления в базе новых или измененных -Vfcv\^*v* документов
Агент, Mail-activated Агент, автоматически запускаемый по событию запускаемый по agent (mail прихода в базу данных документов почтой. событию прихода agent) почты (почтовый ^ *' i " « '-' - '* *
агент) ,4.JAV3,v^ * ir^qi^a » ."*-.>-- - > Hwqorojr ,T3V1 s OIHwtfiK qoiB«|r3«" « -
3
v ev->'p ( *'< '
© InterTrust Co. Тел (095)9567928

882 Lotus Domino R. 5: ©-формулы, LotusScript, встроенные классы LotusScript и Java
Агент, Unrestricted Агент: на языке LotusScript или Java, который может неограниченный agent использовать все возможности языка. Пользователи, по возможностям которые имею! права выполнять такие агенты, определяется в секции "Agent Manager" документа "Server" общей адресной книги.
Агент, " Restricted agent Агент на языке LotusScript или Java, которому ограниченный по запрещено использовать некоторые возможности возможностям , t wio'Js^* >№Ј> иг > » языка (такие как, файловые операции, запуск < внешних приложений и т.д.). Пользователи, которые имеют права выполнять такие агенты, определяется *ч* в секции "Agent Manager" документа "Server" общей ' адресной книги.
Агента временный In-memory Документ, создаваемый серверной или внешней документ VTV ,n document программой в виртуальной памяти средствами Notes гмЬуй ^^- Агент №ожет получать доступ к информации t. , „ , ' Л-х такого документа. В Notes API эти документы
?*--Ш1 ; ,1ч/* t~Wtt! V7Ti> ' '
' л %i *" иногда упоминаются как Parameter Document - т.е. документы, содержащие параметры для агента -поскольку, по сути такой документ реализует .ч ^гкхготг'*' *я»5«*игл1-«тА » способ передачи параметров агенту.
«Ы ТОЖО1
Агента SavedData Документ, используемый агентом для сохранения предыстории document информации, необходимой при следующем запуске документ данного агента. Благодаря наличию таких документов могут быть созданы агенты, поведение которых при очередном запуске зависит от результатов предыдущего запуска. Данные /1эвн yft и» документы не показываются в видах, но могут участвовать в репликациях.
Агента триггер Trigger Событие, при котором осуществляется запуск - -^а < ? tj"K ч> агента. Может быть одним из следующих:
» « аои&«».'Фо6 **$«««* _ ' *рчял ***> <**л» запуск вручную; *
по возникновению определенного события (например, приход почты);
по расписанию. ч-t' Администратор Administrator Пользователь, занимающийся управлением и LN/Domino поддержкой серверов LN/Dommo. Его основными обязанностями являются:
регистрация пользователей и серверов; * управление доступом к серверам; * управление механизмами репликации и
. , маршрутизации почты; . , 'wn< 'jo-- ort нимэе « > ./о.*1 «^ * ^ ^^ I»*1 , .«ь-^,/-
.йптюь rw ,г-л- |л<« * управление серверами для использования с Интернетом;
поддержка баз данных;
поддержка и контроль за серверами. Администратор NotesNIC Администратор домена NET, который NotesNIC используется для связи с другими организациями, работающими в среде LN/Dommo, через Интернет.
© InterTrust Co. Тел (095) 9567928 -, -

'-.- i . y '
Lotus Domino J?. 5.- (^-формулы, LotusScript, встроенные классы LotusScript и Java 883
Ькччки* i& »Ц|5 О^-**-1"
Администраторска Administration Диалоговое окно, в котором можно выполнять я панель Control Panel, большинство задач по администрированию управления Administration LN/Domino, таких как операции с пользователями и
Panel ", ... ...ч группами, открытие специализированных баз ' ,., . ,. ,4. ,, г„ г „ г >те^. данных, работа с удаленной консолью и т.д. Для
"' м*. а ^ж^хш^ш^ м X ВЬ™6НИЯ некот°Рых @™*«f необходимо, чтобы в текущем окне была открыта
администраторская панель управления.
Адресная книга Address book База данных, основное предназначение которой, содержать имена и почтовые адреса пользователей, групп, серверов и документы для соединения с '" нужными серверами. Наиболее употребимыми являются общая и личные адресные книги.
ЈШ*ИЩИШ*едф«? ХЬ йЯ-ЭУШф' HMHfSr-iUlV. -*
Адресная книга Personal Адресная книга, содержащая имена и почтовые личная Address book адреса пользователей, групп, серверов и документы
для соединения с необходимыми серверами. *ит й«№.тч» -«rrs;vv, - „ , , -^ ^ , ., ~ . Информацию в личную адресную книгу пользователь ,{3tti?juo тзакгдо) ч- f ^ spss заносит самостоятельно либо вручную, либо ? »qoi ,вд«/ъ „ „ тт \ копируя из общей адресной книги. Личная адресная
книга создается автоматически при установке на зчп.;гкк; ' компьютере клиента LN/Domino.
.-.. *^tei-i?*^~ir**
Адресная книга Domino Основная адресная книга для всех пользователей и общая Directory, серверов текущего домена. Общая адресная книга ~г-~~ъ -,,.,~г -.л public Address содержит:
book
имена и почтовые адреса пользователей, групп,
серверов, а также другую информацию о ,, возможности доступа к серверам клиентов LN и
,, Ж' чйЗ йЗГП.Ш.ОИ*'*?-- , , J * г
f,;,f . Internet; :; -лтОлЛл w-
i > аэ н ,b-v * информацию о параметрах настройки серверов, я.!нэ>?гс« м ,вгнэн1И ы такие как, права доступа к серверу, сетевые 7q- нщ документы для соединения с нужными , ...< «- г' серверами, для работы почтовой системы, репликаций, получения новостей. *! .i/i' Ronv'f'-.''.т к laiO*\ Ч'Гта? а Общая адресная книга, автоматически создается при ^ регистрации первого сервера в домене. Ее реплики ,. з^ . автоматически создаются на каждом сервере домена Л-...МН08Э Moooaq-sv о е;лък№:«^лл тк;»п при регистрации нового сервера.
Активные Smartlcons Линейка кнопок с пиктограммами. Служит для пиктограммы быстрого выполнения определенных команд LN/Domino. Располагается в главном окне LN сразу
-,,- »*" ч*,-ц?5о под системным меню.
Акции кнопка Action " ' Кнопка в панели акций, нажатие на которую позволяет выполнить определенные действия.
<у Акций панель Action bar ;vt ;;t Непрокручиваемая по вертикали область с :;-., , , кнопками-акциями в верхней части вида, папки или , дудь формы. ан щ-tf .mjtw-irtvri'v^ttvv'?*, ; йХ'Цаофт й2Т. -,*с/- . . . s *» ?. .'yti , . ti t i '
© InterTrust Co. Тел. (095)9567928

884 Lotus Ddmino R. 5: @гфорМулы, LotusScript, встроенные классы LotusScript и Java' %
Алиас Alias Синоним имени, который может присутствовать у большинства объектов дизайна {формы, вида, навигатора и т.д.) и у значений поля типа ключевые слова. Для элементов дизайна можно обращаться к ним как по имени, так и по алиасу, для поля типа ключевые слова их значения сохраняются в виде алиасов.
Апплет Applet Программное обеспечение, разработанное на языке Java, и которое выполняется на рабочей станции, а не на сервере. По сравнению с HTML обеспечивает большие возможности для интерактивной работы объектов. К недостаткам апплетов можно отнести, *» что для их выполнения требуется их первоначальная загрузка с сервера, браузер должен поддерживать возможность работы с апплетами.
В Domino разрешается использовать апплеты при . ' ' >»"' v»4t._ разработке схемы базы данных (объект outline),
'" ' -J'tM" „ ,
видов, панели акции и редактора форматируемых полей.
Аутентификации Authentication Процедура, которая происходит при попытке процедура обращения к серверу, и состоящая в проверке идентификаторов клиентов и/или серверов. При работе с LN/Domino возможно три типа аутентификации :
,№Г" ,-«-.' * !"«.«- "ЛП.ОП Г»*Э<ШД> ЭШЬ. ! хт * /та i
^^ Notes/Dommo аутентификация, состоит в
О 1 -Я» СИ ПЗДГч ЗЖ4ЙТ , ,
,, . ч " проверке сертификатов пользователя/сервера в к ViA о ».-> пшч> WBG'Sftasa л сьутг t j _ ^ общей их части при попытке обращения к
конкретному серверу LN/Domino. Данная процедура двунаправленная, и сервер выполняет -л .--л-гоог, i процедуру аутентификации клиента, и клиент в ;,Ј,1киг> ,„^»ям свою очередь выполняет процедуру .'HH3s.^,u^ . „iv wr аутентификации сервера LN/Domino; (. -, .... «oaoi-* .ft;'^.,f»,s, ^к/мяп з чоп< сертификатом. При этом процессе проверяются сертификаты сервера в общей их части, и обычно сертификаты клиента;
,гн!эмьм-» аутентификация на уровне имя/пароль (Basic «якгго* be *;№**„ ш«ж hi password), состоит в использовании Интернет ' адтг-Лэ« tvjpswwtt ПР°ТОКОЛОВ поверх TCP/IP и SSI. В процессе процедуры текстовый пароль посылается с ч итэргЗо |<авхн1^ш он здг/эр клиентской машины на сервер. Сервер нпн к-л-мп v»c>vrd ьтлйн йанхг^ ^ v»»" сравнивает этот пароль с хранящимся в общей : 4-»;*.Ns, адресной книге Интернет паролем для конкретного пользователя. В этой процедуре не используется проверка сертификатов.
© InterTrust Co. Тел. (095) 9567928

Lotus Domino M. 5: @гформулы, LotusScript, встроенные классы LotusScript и Java 885
'' '^ ' «V „4',
' Б 'м/';н1аг >;? "Air; vs 'HtiKX
Баз данных Stacked icon Иконка базы данных, которая представляет базу иконки данных и некоторые ее реплики. Отображается
НО rҐ/V*l/*/lUUl-ҐA Г1ПЖ/Г ^Ь-ЗгР) t/tlvA Ш^Г*
наложенные друг ^ ^ ^ > на иконке в виде значка раскрывающегося
на друга *"* ** ' : ' списка. Если при добавлении в рабочее g , пространство новой иконки базы данных, ее мтодефси о шик^ефда к реплика уже присутствует в рабочем лми&ящпиыщъыг,. . пространстве, и выставлено свойство наложение иконок, то происходит наложение иконок.
Баз данных Database cache Область памяти на сервере LN/Domino, в которой кеширование над,» <т базы данных сохраняются для более быстрого ч доступа к ним. Администратор может посмотреть .... статистику кеша, изменить число баз, сохраняемых в кеше сервера, закрыть все базы данных в кеше, WW mw *юро' wb или сделать кеш недоступным.
База данных Database Јаз« данных LN/Domino есть совокупность ' LN/Domino хранимых в ней документов с данными и дизайном, определяющего ее функциональные возможности.
База данных Administration Специализированная база данных, в которой "Administration Requests сохраняются запросы для выполнения серверной Requests" , ( database задачей Administration Process. База создается при первом запуске вышеуказанной серверной задачи. riryyv- Реплики этой базы должны присутствовать на всех ~ ^ * '"' , серверах домена. ,
5 База данных Database База данных Catalog содержит информация о базах ; "Catalog", ^ , Catalog данных, расположенных на единичном сервере LN/Domino, группе серверов, или всех серверах домена. Обычно используется для добавления Ј выбранных пользователем баз данных на его v рабочее пространство.
S -. . _. ...- -;.-..
База данных Directory База данных, которая содержит информацию о "Directory Catalog" Catalog пользователях, группах, почтовых адресах баз
; ... 3wfi»ij»j on«««u\«a .'!-- данных и планирование ресурсов. Сервера " используют эту базу для быстрого поиска имен, а у пользователи LN/Domino используют аналогичную f > хш?№| * базу данных "Mobile Directory Catalog" для упрощения адресации почты пользователям, - ,-.- находящимся вне организации, даже когда они .хшпздЬ «и узй я хгиимпйхя ш- отключены от сети.
База данных "Free Free Time База данных Free Time (файл busytime.nsf) имеется RT?ime" database на каждом сервере LN/Domino, и используется для V/1 получения информации о свободном времени '%; пользователей, у которых в поле MailServer wir'^ - - * * t"":' документа Person указан данный сервер LN/Domino. fiwrfr и-'f a' i« я Сервер LN/Domino, при внесении пользователями ^ . -- изменений в своих расписания (вид "Календарь" »i,4f*.-© InterTrust Co. Тел. (095) 9567928

886 Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java
пользователями, информация из базы данных Free * Time будет использоваться для поиска свободного времени.
Лгг. >
База данных "Help Help Lite База данных Help Lite (файл helplt4.nsf) является Lite" database сокращенной по информации версией онлайновой справочной системы. Она содержит информацию о ' - ' применении LN/Domino на уровне пользователя, и в 8 " ней отсутствует информация о разработке о. * приложений и программировании.
База данных Personal Web Локальная база данных, основное предназначение "Personal Web Navigator которой осуществлять поиск, сохранение и Navigator" отображение Web-страниц. Так как эта база данных локальная, то только один пользователь может rfTi тзжпн «!%««- иметь доступ к хранящейся в ней информации.
База данных Shared mail База данных совместного почтового ящика на "Shared mail" сервере, в которой сохраняются почтовые |<Л сообщения, адресованные более чем одному < » .онг ^у о;, <пч>э onw пользователю. При этом заголовок почтового «owtwtw^ н ымычнвл о '»os*u сообщения сохраняется в пользовательском почтовом ящике, при двойном клике мышки на заголовке такого почтового сообщения
J j « > k*fc.Ai$ , f<
активируется ссылка на содержимое письма,
"^г*Ч"* *?FS* '<&'
* * хранящегося в совместном почтовом ящике. С м?к" у*"тлв'"г< л™ W1 ,-помощью такого механизма высвобождается
, MU'WSOMViMl тт
дисковое пространство сервера. Данный термин
>Л ' < d - -'1 /WCtH ШШКО/ с. , -~, "._. . с. ro/-^/-\c>i
- ^ имеет синоним Single Copy Object Store [SCOS] (однократное сохранение объектов). ч*Ј, " * * ~" *"' S ьаза данных ' Statistics & База данных Statistics & Events используется для
"Statistics & Events database настройки параметров серверных задач Event и Events" "'** :**'Л Reporter.
База данных Statistics База данных Statistics используется для сбора "Statistics" database статистики и сводных отчетов от серверных задач Event, Reporter и Collector.
О ' VSIBttV-'Ф " "ЧЖ.рРОГ» Х&ЦОТДО »> ЛМЯ«
База данных Database />аза данных, в которой хранится информация о библиотечная , library других базах данных LN/Domino (краткое описание, 1, тотоыо ш», ч* идентификатор реплики, список пользователей, оЧг,л4*. имеющих доступ менеджера). Перечисленные базы ei « чз<' , . данных могут располагаться на разных серверах, в mi 4 ,*"rtior«*.'.or 'ттст<>г. ». отличие от базы данных каталога сервера. В »?чо г-ч- ^л библиотечной базе данных существуют также механизмы открытия входящих в нее баз данных.
База данных Outgoing mail База данных, в которой временно сохраняются исходящей почты database документы исходящей почты, в случае их создания 1Й1'^*г^г: >^.»нбс в период отсутствия соединения с почтовым J-&w М.1Ц-» .1 - сервером. Файл такой базы данных имеет имя Mailbox .
База данных Local database База данных, которая хранится на диске локальной локальная ^ к станции с клиентской программой LN, или на сетевом диске в локальной сети, и доступ к этой
i/~ju и„ базе данных имеет только один пользователь.
*" FT^qji ifi-fTS'.qnonsw ячнод
© InterTrust Со. Тел (095) 9567928 - - - .« , ,„ . ,

Lotus Domino R. 5: @гформулы, LotusScript, встроенные классы LotusScript и Java 887
База данных Shared database База данных, которая хранится либо:
общая
в каталоге или подкаталоге директории данных
,w.-*oy~^a^«' -i? л сервера LN/Domino; > ч в каталоге, или в файле на сетевом диске в локальной сети, к которой сервер LN/Domino имеет доступ. В этом случае и ссылки на 1. <4, С ociHf ,-;.ovv «i » f то VAaq-mw & p. местонахождение базы данных должны ei г,-. ,«а'ч о/ч- >>'">« - присутствовать в каталоге или подкаталоге директории данных сервера LN/Domino. , > « «
~ Доступ к этой базе данных может иметь несколько .- , чгцжэ* пользователей. кхк.*" : База данных * Notes mail База данных, в которой пользователь создает, почтовая database редактирует, отправляет и принимает почтовые сообщения. Хранится на домашнем (home) сервере
f_ пользователя. шшде eo'tfv*;* /f^ f>
База данных Current База данных LN, в которой в настоящий момент текущая database выполняется ссылающееся на нее приложение на языке формул, простых действий, Java или кйи*а< \»\4Siu«y LotusScript.
Базы данных Archive а Механизм, позволяющий переносить определенные архивация - ^ database документы (к которым не обращались XXX дней, которые не изменялись XXX дней, и т.д.) в архивную базу данных с дизайном соответствующим исходной базе данных.
Базы данных Database's title Свойство базы данных, строка до 32 символов. заголовок Заголовок базы данных отражается на рабочем л ,n л*н-1<> пространстве, странице закладок и в диалоге при *??&" м открытии новой базы данных.
Базы данных Headers and Свойства базы данных, позволяющие формировать колонтитулы footers for а верхние и нижние колонтитулы при печати database документов из базы данных. Колонтитулы могут ,ытщ^,-я ,клп-* г { -!*п. включать в себя постоянный и переменный текст Слявт & (например, дата и время, номер страницы, и т.д.) Установка производится в окне свойств базы ,'t « данных на закладке с принтером.
Базы данных Copy a database Системный LN/Domino механизм, позволяющий копирование ;о?»^ создать копию базы данных, как полную, так и ,ил jj ь только содержащую элементы дизайна. Копия базы данных всегда имеет отличный от оригинала
. „„ {.% ,»„ t. ,„ .-".J'V.,
идентификатор реплики.
Базы данных Locally encrypt Механизм, позволяющий зашифровать хранящуюся локальное в базе данных информацию. Прочитать после этого шифрование действия информацию сможет только пользователь,
.н*г hHHJV iO-fC^n *'*, с ~ it> J. -
обладающий Ю-фаилом пользователя, включившего этот режим.
tl то v LN/Dommo допускает сильную (strong), среднюю (medium), и простую (simple) степень шифрования.
© InterTrust Co. Тел (095) 9567928

888 Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java \
Базы данных Database Пользователь, имеющий уровень доступа менеджер manager менеджера к конкретной базе данных, и в чьи обязанности входит установка и поддержка списка управления доступом, контроль за репликациями, использованием и размером базы данных
Базы данных Size limit Свойство базы данных, отражающее максимальный предельный размер файла, содержащего базу данных. Может размер ' "* варьироваться в интервале от 1 (по умолчанию) до 4 Гбайт. Можно установить только при создании базы
данных. * » ,v , ,
Базы данных Database replica Базы данных LN/Domino имеющие один и тот же реплика или база- "** идентификатор реплики, и которые может реплика обмениваться между собой информацией с помощью механизма репликаций. ьЛ
Базы данных Compact а Механизм, позволяющий высвободить дисковое сжатие database пространство, занимаемое файлом базы данных и освободившееся после удаления документов и/или присоединенных файлов. В момент этого процесса с базой данных никто не должен работать. Нельзя нг, ^fy f выполнить для баз данных с сильным и средним уровнем локального шифрования.
Браузер Browser Клиентская программа для доступа к информации в сети Интернет. Например, Netscape Navigator, или Microsoft Internet Explorer.
.* , v .,', ч, - j XSd'-'Hi- *Л л "
Вид View Элемент дизайна базы данных LN, представляющий совокупность документов базы данных в табличном ^ . виде. Критерий отбора документов для каждого конкретного вида задается разработчиком базы
данных.
$
Вид "Календарь" Calendar Вид почтовой базы данных пользователя, в котором , можно управлять организацией своего рабочего времени, составлять расписания встреч, собрании, событий, напоминаний и юбилеев, а также отображав текущие дела.
Вид личный Private view Вид, работать с которым может только конкретный !и vr»..***»/ ..щи» пользователь, его создавший. .
Вид общий п. г Shared view Вид, работать с которым может любой пользователь базы данных, если только доступ к виду специально не ограничен.
Вид общий до Shared - Вид, шаблон которого является общим, но после первого Personal on first первого обращения к нему пользователя создается использования view личный вид по данному шаблону.
и
Вид с Hierarchical Вид, в котором при отображении делается различие иерархическим view между главным и ответными документами. отображением Ответные документы располагаются в таком виде элементов ! - ) о* 'чапмз тэ! ниже основного документа и с отступом от левого .prtns.*ju.^K'« -iFonsr* ( края вида
© InterTrust Со. Тел. (095) 9567928 3>

Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 889
Вид текущий Current view Вид, отображаемый в текущем окне на момент выполнения приложения, которое ссылается на это
-a *t «f.i.w n свойство (текущего вида).
Вид, Default view Вид, по которому выводятся документы при первом используемый по открытии базы данных пользователем. В дизайне умолчанию , ,, ,,,.,., , показывается со специальной отметкой. Определяется путем установки соответствующего
1* * ,« ЛЛТ. ***$!0К1 „
флажка в окне свойств вида
**:&$« к.' т
Вид, View as the Вид, дизайн которого наследуется при создании используемый по standard for новых видов или папок. Определяется путем умолчанию при newly created установки соответствующего флажка в окне создании новых views or folders свойств вида.
i'ttttlj
видов или папок * -' u
Вида колонка View icon Самая левая специальная колонка в виде/папке, в специконок которой отображаются предопределенные иконки с саяшаго" - пометками об определенных свойствах документа:
адйш,!*-У> \ н»«тлл"- , и »ие с * о не прочтении;
Ut . . - ti-.vf&H *л об удалении; ' о выборе документа пользователем; i««-- о конфликте репликации/сохранения документа;
об индексе уместности при отборе с - fJnJi тг.йзаьЛ MtH'^wnsati использованием индекса полнотекстового поиска. Вида панель Jt А^ Navigation pane Область экрана, отображаемая обычно в левой части навигации окна при открытии вида/папки. Содержит имена видов, папок, агентов или текущей навигатор базы (лт эгдошво} аллни ( ^ данных. Позволяет осуществлять навигацию по
ЮЛИВЙ*"»
представленным элементам.
1 -ЧАуЛА
Вида панель View pane Область экрана, в которой отображаются показа документы, входящие в вид/папку. Отображается ч «Аддоу ,,»« 'ujrro - 4*w обычно в правой верхней части экрана. В этой ;'>* ' области можно осуществлять навигацию по документам.
Вида панель Preview pane Область вида/папки, используемая для отображения предварительного ^"' * содержимого выбранного или связанного с просмотра выбранным документа. Отображается обычно в нижней части экрана. Администратор базы данных 1й ' <0 , ' может изменить вид панели.
Временные Temporary Переменные, "время жизни" которых определено переменные в @- variable,,,^, ш контекстом одной @-формулы.
формулах
*"t7 "-* ' * ' а ^ Выписки счетов Billing Серверная задача, позволяющая протоколировать
серверная задача определенную активность сервера для учета затрат серверного времени, и записывать обобщенную информацию для выставления счетов ?""с./г1яоязн ао<\».егг'>4 шш\к й&гзп* пользователям. Для установки этой серверной ,*>*„ j&Wi?mj^t«'( va aswj » »i*^ :, задачи формально необходимо наличие лицензии на ,» 1ч&*Ј™)Ъ и enrfisc-r. »cw;»i№Cfn д илк расигиренное программное обеспечение LN/Domino (Advanced Services).
© InterTrust Co. Тел. (095) 9567928
/

890 Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java
Т . ,-.--,
Гиперобъект Hotspot Объект в форматируемом поле документа, или в элементе дизайна базы данных (формах/подформах, *' Л "*f видах, папках, навигаторах, наборах фреймов и .мжэтейо* страницах). Позволяет выполнять определенные действия при активизации (обычно нажатие ,У ! -''-'.- клавиши мыши). Бывают типа ссылки, всплывающего окна, кнопки и действия.
Гиперобъект типа Formula Pop-up Гиперобъект, который позволяет появляться динамического "всплывающему" окну с текстом, определяемым по всплывающего - формуле, при проходе указателя мыши через
окна активный участок. * , -вцва*-Гиперобъект типа Button Гиперобъект, позволяющий выполнять
кнопка определенные действия по нажатию на него.
Гиперобъект типа Link Hotspot Гиперобъект, который позволяет осуществлять ссылки быструю навигацию между объектами LN/Domino «" (статичными и элементами дизайна), и объектами типа URL. Ссылки на статичные объекты LN/Domino
бывают типа: и-' :; cs« t . ;wKM«rraeoc«iiuji' .. . и:>* ,_.«-
,:*" л>йшгз»«%- , ,., « ссылка на документ (document link) - позволяет 4 ,.i. ист быстро переключаться на другой документ; о^слю jyswosi'ir >ш ** ссылка на абзац документа (anchor link) -переход в документе на конкретный абзац; нтаг-&лгэя8 пшч*до '" -qoou ,,„ „. . ссылка на вио или папку (view link) - переход в е»^« *«*qtf .,,сО .». нкп.» w.-> другой вид/папку. w- ,-й ^мчщ-ллии -ussfw; . , . rf »timi-- * ссылка на базу данных (database link) -
открывает базу данных.
1 Ссылки на элементы дизайна LN/Domino бывают
к. ----- -*>- -. Г.;,--,-;-. типа:
* Г ссылка на конкретную форму - открывает форму
oi , , : ,; / -..--.....= для ввода нового документа в выбранной базе данных (база данных, если она не открыта -открывается):
8ЧНЭИ^.Ч-Ч!.>Т<~ М1Д RBMS^-'-.f ;"«*-'Ч ^':!«^«^r^ Г *?*« , ,^ч-
i o'KMHBfs-ax; кд. * ссылка на конкретный вид, папку, навигатор или набор фреймов - открывает этот элемент дизайна для навигации в выбранной базе данных , , ^ г. . ', с; -л 4«ь9шщ рте <лш (база данных, если она не открыта -, открывается), оиомдэчпо xuqotou "ннеыж шесш Ссылки на jt^ переводят фокус на .мщыщу соответственный ресурс в Internet, «лч-*- я
Гиперобъект типа Text Pop-up Гиперобъект, который позволяет появляться 'статичного "всплывающему" окну, с фиксированным текстом, всплывающего при проходе указателя мыши через активный окна участок.
".Группа , Group д Список пользователей и/или серверов, используется пользователей ^н оынаах^пэн »«? как обобщенное имя в списке управления доступом, i suvivssv^u 'sw в адресации почты, в процессе доступа к серверу и
';;;. .,. ' . .".'... . ' -, . -...--. т-д- .--
© InterTrust Со. Тел. (095) 9567928

Lotus Domino R. 5: (^-формулы, LotusScript, встроенные классы LotusScript и Java 891 *
Группа ' Newsgroup Интерактивная дискуссионная группа пользователей " пользователей, которые используют программное "Newsgroup" обеспечение newsreader. NNTP-сервер Domino
от( ,Ґ\'- c.'fko *«s ,.« :о. ', n !j»vёК Я-fi ."ЧС О»1 ^ Я /* .{ТООНШЛ -
к^ЛЧкГЦйЧя*
Депозитора Depositor access Уровень доступа к базе данных, при котором уровень доступа к пользователь может создавать, но не может читать базе t ' документы, созданные как им самим, так и другими
,/uv!'.»^*- ,-,.k. авторами. %?>. > <
Диалоговое окно Dialog box Элемент дизайна, необходимый для ввода .»*>«<. «.«-н^^^ «^.-«.^ информации требуемой приложению. Может содержать элементы дизайна следующего типа: (command buttons, check boxes, option buttons, list f^ ' ' * ию| uowi" boxes, information boxes, scroll buttons, drop-down
0 *S>M- boxes, text boxes).
, i * " :;i.<
Дизайн Design База данных, которая не содержит документов, а только элементы структуры {формы, виды, этшигоэ -лж'4/ дг 4 terns:-1' . страницы, и т.д.)
Дизайнер Designer Пользователь, в чьи обязанности входит разработка баз данных, их тестирование, модификация и передача готовой базы данных ее менеджеру.
Дизайнера уровень Designer access Уровень доступа к базе данных, при котором доступа к базе пользователь может создавать, читать, редактировать и удалять любые документы, изменять: любые элементы дизайна, документы "О лл-л i« оь лг^-.имз/Оф: Qa3e данных" и "Об использовании базы данных". f|epi Ш1й№ ,АО'л Сервер с уровнем доступа дизайнера может .„-,^ tv ' *'' '- реплицировать все перечисленные изменения в базе BHt«&>H!iO „Mfsf - . - , « данных, и обычно удалять документы, помеченные t*jv«t *. t-*4f cs !,, для удаления. .»*гй'»
Директория Data Data directory Директория, в которой хранятся локальные базы в ;>зп'«">г> й«'ймк^йя*/ данных и шаблоны, файл Desctop.dsk и возможно
к.*. . -:,д',Аг>:4,этнт«4ж:-г файлЛ/bto./w. ,„.,_. _ .
Документ Document Основная единица хранения информации пользователей в базе данных LN/Domino. Может содержать поля, статичный текст, графику и т.д. , Информацию в документ можно вводить вручную, автоматически вычислять по неким формулам, ij ,4jMj3' импортировать из других приложений, а также связывать с другими приложениями с автоматическим обновлением связи.
Документ "ACL ACL Monitor Документ, создаваемый в базе данных Statistics & Monitor" Events, и указывающий серверной задаче Event, отслеживать изменения в списке управления доступом для определенной базы данных.
© InterTrust Co. Тел (095) 9567928

I ....
892 Lotus Domino R. JV @-формулы, LotusScript, встроенные классы LotusScript и Java
Документ Appointment Документы, создаваемые и отображаемые в "Appointment" календарном виде почтовой базы данных пользователя. Данные документы обязательно содержат время начала и окончания события, это может быть, например, встреча или конференция. Можно сделать событие повторяющимся с определенной периодичностью, как по дате, так и по времени.
Документ Replication Документ, создаваемый в базе данных Statistics & "Replication Monitor Events, и указывающий серверной задаче Event, Monitor" отслеживать процесс реплицирования для определенной базы данных.
Документ Statistics Документ, создаваемый в базе данных Statistics & "Statistics Monitor" Monitor Events, для настройки параметров серверных задач Reporter и Collector.
Документ "Место Location Документ в личной адресной книге, в котором вызова" document определяются параметры связи с сервером v: LN/Domino (тип связи - локальная сеть, модем ..., / ,»»ша» ..;;- порты, ...), почтовые настройки, параметры ,ий0<-> д. репликаций, тип браузера, параметры безопасности при работе в Internet и т.д. Можно создать < --а- "одг несколько таких документов и переключаться между ними в процессе работы.
Документ "О базе Document Документ, предназначенный для краткого описания ' данных" "About this предназначения базы данных, состава ,{(f database" разработчиков и т.д. Присутствует в меню "Help", когда база данных открыта. Может быть открыт г -ч» кнопкой "About..." в диалоге открытия базы данных. ,. и, Разработчик может предусмотреть возможность ft "<,«* принудительного открытия этого документа при первоначальном открытии базы данных.
Документ "О Document Документ, предназначенный для краткого описания работе с базой "Using this инструкций по работе с бозон данных. Присутствует данных". й*вг»х>л. й database" в меню "Help", когда база данных открыта. . ,жэая11
Документ $гЬ .<Ґ- Server Документ, создаваемый в Общей адресной книге "Подключение" connection или Личной адресной книге, и определяющий для:
, ,.т,
* - ' Общей адресной книги - возможности установки
Т**КОТ« ОШШОч тхт/гл
соединения между двумя серверами LN/Dommo,
11 1' И У»?-*ЙШГГ1 J"«,f3T _
! * и как, и когда эти сервера должны обмениваться информацией;
эж*»- -к ..й»"!й9шГ'ЧГ1п '> '*";-'' * Личной адресной книге - как пользователь ,., .,..vv,,.: получает доступ к определенному серверу. Документ Adjacent Документ, создаваемый в Общей адресной книге, и "Соседний домен" Domain определяющий имя, место вызова и доступ к document соседним (с которыми текущий домен соединяется напрямую), несоседним доменам Domino и доменам < t :?#;**» не-Domino.
* "''"'
© InterTrust Со. Тел. (095) 9567928 ,

Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 893
Документ Truncated "Усеченный" документ появляется в реплике базы, "усеченный" document когда в ее репликационных установках выбрана возможность "Receive summary and 40KB of rich text
э ijt ъъгщ **«. only".
f^d^O*1'* fjf^ «IF f|
„ В "усеченном" документе по сравнению с "полным" адке"** но* hii y*rq-«, t p% , л. информация в полях с флагами summary сохранена,
^ размер информации в форматируемых полях и полях иных типов с флагами non-summary, не превышает примерно 40 Кб, а все присоединенные файлы и OLE-объекты "отбрасываются".
<
При просмотре усеченного документа клиент LN
добавляет в заголовок окна слово "(TRUNCATED)" ,чнЈф з 4rea Нельзя редактировать или "категоризировать"
усеченные документы. Wtf-wjw tnv-* у ,,»?? уд>ди При репликациях усеченные документы не тгн" viKh/u,, &"">Ј ^ i v. .'%««--) передаются в другие реплики, если только другие *WHdteH! v ^ 1-щ?л>(\ \ йкцо-н реплики не имеют опции "Receive summary and 40KB of rich text only".
*uhh&*. <:ф»Н^ к- i;r>< 3-*'^sl 9 Чтобы получить вместо усеченного полный TjgTj r»n ** i> »«'Л»э-> t/ документ, необходимо выполнить пункт меню 4-, Action - Retrieve Entire Document или команду u @Command( [EditUntruncate] ).
Документ ' * Child document Документ, который наследует значения полей из дочерний другого (родительского) оокумента
Документ Conflict Документ, возникший в результате конфликта конфликтный documents репликации или сохранения. Признаком конфликтного документа служит наличие в нем предопределенного поля $Conflict.
Документ *" * Main document Документ, который не является ответным основной г документом, т.е. не имеет предопределенного поля $Ref. Обычно создается по форме используемой для ^ создания основных документов, но может быть
9MfHH>, ' г '?^ f~> чч/,1',ч v > также создан и программным путем.
Документ Response Документ, в котором хранится связь с основным ответный document документом в предопределенном поле $Ref. Обычно создается по форме используемой для создания №#ис >оз > ответных документов, но может быть также создан
ч )}>""» * -" и программным путем. <}
Документ Parent Документ, который передает для наследования родительский document значения полей в другой (дочерний) документ.
Документ текущий Current Документ, который для: " f ***- * -^Д,
document
вуту нцд?» 1чл>1 ! акций форм, кнопок, гиперобъектов и формул
гзяион' полей - в настоящее время открыт;
для акций видов и папок - на нем стоит световой маркер; ; »
агентов - в настоящее время обрабатывается агентом, в соответствии с его алгоритмом и критерием отбора.
--"- © interTrust Со. Тел (095)9567928
. х

894 Lotus Domino R. 5: (^-формулы, LotusScript, встроенные классы LotusScript и Java
». » - - »» Документ текущий Highlighted Документ, на котором в виде и папке стоит световой
для вида/папки document маркер.
Документ, Selecting Документ, который пользователь пометил с выбранный document помощью мыши или клавиатуры. Помеченный пользователем документ помечается в первой специальной колонке текущего вида. С помеченными документами можно выполнять групповые действия:
категоризироватъ;
„ ,w .. Т>
копировать; удалять; экспортировать в файл; печатать; пометить как прочтенные/непрочтенные;
переслать в одном почтовом сообщении. Документ, Unread Документ, который LN/Domino специальным помеченный как document образом помечает, и ведет такие пометки для непрочтенный каждого пользователя базы данных. Первоначально (непрочтенный vr *"""" ' LN/Domino все новые или модифицированные документ) другим пользователем документы метит как непрочтенные. Пользователь может настраивать механизм установки/снятия пометки о непрочтении QJ, - ,^. г (например, можно настроить клиентскую программу, чтобы пометки о прочтении снимались после появлении документа в панели ?'п предварительного просмотра, или можно ш принудительно пометить все выбранные документы % " " как прочтенные/непрочтенные). Администратор базы данных может установить режим, при котором fc'Sd«U4i!. модифицированные документы не метятся как атад о непрочтенные.
Документа Deletion stub При удалении документа из базы данных, в ней "окурок" остается некоторая часть документа, называемая мч "окурком" (stub). Он используется в механизме 4 -tfsa » репликации для удаления копии этого документа во всех репликах данной базы. Администратор базы данных может управлять временем жизни окурка в базе данных, устанавливая соответствующий параметр в настройках репликации.
Документа автор Author Пользователи, которые данный документ создали/модифицировали
Документа версия Document Документ, полученный из исходного документа version путем модификации (редактирование) при условии, кои*л что разработчиком базы данных предусмотрен ,9*ш<гя режим поддержки версий документов. Позволяет я>во*он^ г.*:* I- .*»». ,. . /.ч.»., хранить всю история изменения документа.
&Л1М»0Ш*эГЦр<' K!4ё'f« * Н УО|(Ш'1ОЦ.Я 0 19 "> »>«ГГЭ7 ЭЗТ-Х,'.. 8 ,,
sqo&m -*.? © InterTrust Со. Тел (095)9567928

Lotus Domino R. 5: @-формулы, LotusScript, в&проШпыё'ййасёы LotusScript и Java 895
Документа Headers and Свойства документа, позволяющие формировать колонтитулы footers for а верхние и нижние колонтитулы при его печати. При document наличие свойств колонтитулов и у базы данных, и у -,-р » f--;i,a«-i, документа, последние имеют больший приоритет. "' ' ч ., > = ,:г овры0! > .ш Установка производится в окне свойств документа на закладке с принтером.
Документов Cutoff Interval Данный параметр определяется в окне интервал № репликационных установок базы в поле XXX устаревания свойства Remove documents not modified in the last XXX days (Удалять документы не
-ff-jW ,kHj«& ,TJ4V.n' .*-. M' a wv
K, модифицированные в течение последних XXX дней). Параметр интервала устаревания документов имеет силу независимо от того, установлено или нет само свойство Remove Ј documents ....
.яоодцзд» Документы, с момента последней модификации н жЛпл'.ад хоашк/ которых уже прошло заданное свойством количество дней, при репликации подлежат автоматическому удалению из данной реплики базы, в случае установленного свойства Remove documents not modified in the last XXX days. При ^,... , ' этом удаляемый документ заменяется своим йысот.-v- -..тм.элх, .;.. '.. ' "окурком". &1- '-' >:-'н-хж?«»4)в^т) "Окурки", с момента появления (т.е. последней ч ' ЯЧП lrf! модификации) которых уже прошло заданное ** - v f;}1? оп свойством количество дней, безусловно подлежат ww«»«cvAVAtira^ т>а?/н ЛЛ "полному" удалению из данной реплики базы.
Документы одного Sibling Документы, которые при отображении в виде или уровня иерархии document папке находятся на одном уровне иерархии.
Домен ^д"- > Domain Домино домен - совокупность серверов LN/Domino и ''">. пользователей имеющих общую адресную книгу (Domino Directory). Основная функция домена чмйх «wvtHOuV'ivittWH <я'/в,щ, маршрутизация почты. Пользовательские домены *г-' определяют местоположение почтовых ящиков, w расположенных на серверах. $i . , Для возможности соединения серверов LN/Domino с
EHSMN эна-ээрнх<{й»;?к> rhrhbox s< серверами из других доменов, необходимо создать .%даод««жш{®ф v ^ошг u^jKf^y документ "Domain" в общей адресной книге. В этом документе определяется имя, местоположение, доступ к соседним и несоседним LN/Domino ' доменам и не ЬМ/Оотопо-доменам. LN/Domino под V w»ov.-f=Mr> не своим понимает следующие домены:
чужой домен (Foreign domain) - для Домино-домена и внешней почтовой системы (например, ' SMTP или cc:Mail) определяет какие исходящие -г , = .кнзйп >нн: почтовые адреса есть Интернет адреса, и куда маршрутизатор LN/Domino (Notes Mail Router) должен их доставить; кд 1/>/
глобальный домен (Global domain) - группа Домино-доменов, имеющих один Интернет
© InterTrust Co. Тел. (095) 9567928

896 Lotus Domino R. 5: (^формулы, LotusScript, встроенные классы LotusScript и Java
домен При этом вся исходящая почта из этих доменов в адресе отправителя указывает именно этот Интернет домен Доступ к серверу Anonymous Доступ пользователей к серверу без процедуры анонимный access аутентификации Обычно применяется в Web-приложениях (
ЛОТ"»' »( -Э
Закладка я **' Bookmark Графический элемент в окне LN, который **" ' * *'' обозначает ссылку на объекты LN/Dommo и Internet, '** * такие как базы данных, виды, документы, Web-
S W %* 'i!^«i*VS О *%*-* itS
страницы и т д
Закладок панель Bookmark Bar Организация закладок пользователя на странице (размешается в виде вертикальной линейки в левом верхнем углу окна LN). Нажатие на закладку активизирует соответствующую страницу закладок
МШНГХНАМ 4О.ЧА 5ЛЧ» ЗД'ЛМ
Закладок страница Bookmark page Страница, которая содержит список закладок и папок с закладками Открывается при активизации закладки из панели закладок и расположены в левой фу части окна LN. - * ,
И
Иерархическая Outline Иерархический ("древовидный") объект, который навигационная кэмои позволяет наглядно (графически) представить схема составляющие элементы приложения, и осуществлять навигацию по его составляющим Каждая база данных LN имеет стандартный навигатор по видам и папкам, называемый панелью щш Ша?< ч »*«H3r'«wi '«'Л4'/ sof*4»«ii- стандартного навигатора, включать в себя набор действий и ссылок на другие элементы дизайна (например, страницы и формы), документы, страницы в Internet Готовую навигационную схему №>*щи ."гчогиг' можно внедрить в страницу или форму для обеспечения возможности пользователям осуществлять навигацию по элементам приложения.
Имени формат Canonical Формат, в котором хранятся иерархические имена канонический format пользователей/серверов. В этом формате каждая составляющая имени имеет свой иерархический атрибут. Например, канонический формат для имени Evgeny V Polyakov/ITDep/Center_TV/RU
будет CN=Evgeny V
* _ Polyakov/OU=ITDep/O=Center TV/C=RU,
'( р^уичлГ sat, { >i *ra ~ * г
tt M,/4 где: CN - составляющая собственно имени,
hf.
fi«»tHt Я '.'M ІOJ<>W ад«н?т<\>У\Л |0rft^'1> OU - организационная единица; (*шавтэог , » о - организация; С - код страны.
© InterTrust Со. Тел (095)9567928

Lotus Domino R. 5: (^-формулы, LotusScnpt^ecjnpoeHHbie классы LotusScript и Java 897
i i., ., - ^
Имя пользователя Alternate Notes Имя пользователя (сервера), которое сохраняется в альтернативное name его ID-файле, и содержит информацию о пользователе на его родном языке (альтернативный язык). Существуют формулы и методы в LotusScript и Java для извлечения информации об альтернативном имени пользователя.
Имя языка Alternate name Имя родного языка пользователя, код которого альтернативное language сохраняется в его ID-файле. Базируясь на этом v. ,« v» . языке, сохраняется информация об альтернативном имени пользователя.
Имяобразование Hierarchical Система образования имен, связанная с ID-файлами, иерархическое naming и отражающая связь имен с сертификаторами организации. Общий формат иерархических имен '" "^ следующий:
XHst kim» обобщенное имя / организационная единица / организация / код страны
~ " " ' '*-' А- * - _, ~4 -* Г - * '
Например,
шжшж j Evgeny V PolyakovflTDep/Technic/Center_TV/RU
Число организационных единиц может доходить до
ГУ -»«Vl г 11, - . ЧШ* Mf'l' f-,
четырех. Составляющая код страны не является *rm H обязательной.
, , Jf Иерархические имена позволяют различать tsvow пользователей, имеющих одинаковые обобщенные шн^пя "xHPHqo'i' имена, для организации мероприятий по безопасности доступа к информации, и /s-jcatot с' u\/bi d осуществления децентрализованного управления сертификацией. ^
Индекс вида View index Внутренний индекс LN/Domino, использующийся тх* Эсчпети i i.anv *' » якя отображения и поиска документов в виде.
Индекс Full-text index Механизм, позволяющий осуществлять быстрый полнотекстовый поиск документов по заданным словам, фразам числам и датам в одной или нескольких базах
:нтзонж«*.'»-}а эг.^гю^чю зэшошшш данных LN/Domino.
Интерфейс общего Common АЛ.^ v CGI есть стандарт для соединения внешних шлюза CGI Gateway программ с информационными серверами, k__^_ Interface, CGI такими как Web-сервера и ЯГГР-сервера. С помощью CGI скриптов можно осуществлять I*-,- .,. . г «- поиск и отображение выборочной информации
s*T ~^v^f i ,. Ml1 # ^-зд5" А
«м^*»»<>гш«я?ч!. на Web-серверах. Эти скрипты можно снаьмз им ч ;г,„н*,1-лйЬ выполнять внутри баз данных LN/Domino и на rr t"«-v.« серверах LN/Domino.
Интерфейс* " ' Application Набор функций, позволяющих разработчикам прикладного Programming обращаться к объектам приложения без запуска программирования Interface, API самой оболочки приложения. LN API позволяет API разрабатывать полноценные клиент/сервер приложения. *м> _*\«игч«\ ч>» «
© InterTrust Со. Тел (095)9567928

898 Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java '''"'
.-..IK. . . ^~"
Интранет Intranet Компьютерная сеть с ограниченным доступом. Используется для обеспечения совместного доступа к внутренней информации. В настоящее время сети Интранет активно развиваются как аналог внутреннего Интернета. Данная сеть использует ****»»<.. протокол TCP/IP и стандарты HTML, SMTP, POPS. :> дои ж'-»твао«?Еоп; ft»jёR В отличие от Интернета, где каждый обладающий л е; - ; определенным программным обеспечением может с w .-.* сотрудники компании, где установлена сеть Итранет.
»а№ЙШ*лф -<ЗХ Э »,RHi№«
' К-° ** ' gaiepja sea^&i-
Категоризация Categorize Механизм, позволяющий группировать документы в видах и папках по определенному признаку. \ «шюшэ *шв1Шйда«Шп-- LN/Domino по умолчанию использует для этих целей предопределенное поле Categories.
Категория Categoric Значение некоторого поля, по которому в колонке вида происходит категоризация определенных документов. Колонка должна иметь ':Fyi\VT^T9tfts'?V:Hods'jT соответствующее свойство - сортировка с категоризацией.
г_- .'.' - .-.>. --*.' '-''' «« .
Клавиш Keyboard Комбинация клавиш, при нажатии на которую, "горячая" shortcut выполняется определенная команда меню. Обычно комбинация используют комбинации {CTRL} + {символьная srreFHiuFsq юаподаш = клавиша} или {SHIFT} + {символьная клавиша}. »ми Для каждого программного продукта может fin существовать свой набор "горячих" клавиш.
Классы LS:DO LotusScript Три поставляемых с LN/Domino класса Data Object (ODBCConnection, ODBCQuery и ODBCResultSet), (LS:DO) обеспечивающие доступ на чтение и изменение койчя*<и\ЕЈДаОЕт---1 / информации из внешних баз данных, через ^»» я ьояш--, механизм ODBC (Open Database Connectivity).
Кластер 1<*r***tas>; т- .Cluster Программное обеспечение для группы серверов шещф .мшэкэ; мУйл. LN/Domino общей численностью до шести, жыи.А хкя<»л«яоэн н«й tUii^u л ' находящихся в одном домене и одной локальной ^<' сети, и предоставляющее следующие возможности:
автоматическое переключение запроса к базе данных, находящейся на выключенном сервере, -* - 'iV\t> н на реплику этой базы (в случае если она имеется) на другом сервере кластера',
: "Н i 1-;'"!« '; ,"-if обеспечение равномерной загруженности очжс-.г; - t .* серверов ъ кластере, путем переключения йй ы Wv v tMO запроса к базе данных, находящейся на сильно лу загруженном сервере, на реплику этой базы (в ' у . случае если она имеется) на другом сервере
MeXNPTOOiiiJfWV" Лм?4О1йаО»«ОГ4 ,ЙКД>Н J ' V} ^ *
, ' : .''" ^acm^a; ошвкшшщн , осуществление внутрикластерных репликаций .таяо^у'.тчэн/ : ч - о-:1 баз данных в реальном масштабе времени. Для установки кластера формально необходимо наличие лицензии на расширенное программное
© InterTrust Со. Тел. (095) 9567928

Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 899
йнядаь.зая ib!«i«44Ґ«*> uirtt.».» f. г* обеспечение LN (Advanced Services). »w»jf
Кластерное Failover Способность кластера перенаправлять запросы с перенаправление одного на другой сервер кластера. Данная ситуация запросов к возникает когда:
W ,'^.Н.) if* < >
серверам
*г/7' к»* j- ** м-ч^ла*., пользователь пытается получить доступ к базе
> н ! v данных на выключенном сервере кластера;
s ш '* ' пользователь пытается получить доступ к базе ё>hv. 1 *ог<*»* н> 'ui^tor eiv, дд//ны;с ш сильно з ном
,ып q«3 rtoftft^w „ Д кшс/и^а. В этих случаях пользователь автоматически 3$И4)*Ј.~<вш» >,*Клиент LN Notes Компьютер, на котором запущено клиентское workstation программное обеспечение LN, и находятся локальные базы данных. Позволяет получить доступ к базам данных, находящимся локально и на сервере, работать с почтой, и осуществлять доступ к сети Web.
Ключ ' Negotiated Ключ шифрования, который создается при установления session key установлении SSL соединения, и определяет ключ сессии f ^vptE^ysj шифрования для информации, передаваемой по SSL «эииимяоо». ? г-1«', - ч ь» ? , соединению. Клю ч установления сессии изменяется для каждой новой сессии.
Ключ открытый Public Ключ шифрования, с помощью которого до^ encryption key осуществляется шифрование информации в бдеыжэа Mvv.iV сгни'Ог почтовых сообщений. Хранится в общей адресной книге. Расшифровка зашифрованной информации производится секретным ключом пользователя.
Ключ секретный Private Ключ шифрования, с помощью которого encryption key осуществляется расшифровывание информации в '' - ' почтовых сообщений. Хранится в ID-файле пользователя.
Он применяется для шифрования по алгоритму ^ , „^ _ ... RSA. Кроме того, применяется для шифрования значения хэш-функции при подписи почтовых
f92&Gfr и
сообщений и документов, при расшифровывании документов, зашифрованных открытыми ключами, j * -I4 в процедуре аутентификации, на начальной фазе при шифровании информации, передаваемой по порту, при расшифровывании локальных баз и в других случаях. а
Ключ шифрования Encryption key Ключ, с помощью которого осуществляется шифрование информации в шифруемых полях документа (при условии выбора шифрования не
открытым ключом).
,'-"> v "a U ,
,3 * ^
I f'-f-'t ОН^ОКЬЧйИ'Ч ««llO'K.fiY
© InterTrust Со. Тел (095)9567928 »

900 Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java ь
Кодировочный Lotus Multibyte Формат, в котором LN/Domino сохраняет введенный формат LMBCS Character Set текст, за исключением текста в присоединенных (LMBCS) файлах и объектах. В результате этой операции пользователи могут оперировать (редактировать, отправлять по почти, и т.д.) с документами баз 4 ,,%гг данных подготовленными на разных национальных ,,1( v4»rs,-> *'1>чкэропл) языках. При визуализации или передаче текста из ^ ^ LN в другие системы, он конвертируется в ^ соответствующую таблицу символов. LMBCS
«wwvvyi МГ>НН5Жу«/ '._'.. г, ~ г. ~ т-
4 * поддерживает языки Восточной и Западной Европы,
Северной Америки и Азии.
ч' is* f нтш « л sb «и .3 : еа
Колонка А «jjcS s.r ' Column Столбец в виде или папке, выводящий определенные однотипные значения.
* tr
Команда, @- , , @command Специальная @-функцш, которая вызывает команда '* немедленное действие в интерфейсе пользователя.
Коммутируемое Dial-up Тип соединения с сервером через порт, не входящий соединение в локальную сеть, обычно, через модем по телефонным линиям. it ,.~ч..
Конфликт Replication-or- Данная ситуация возникает для конкретного репликации или save conflict документа, когда:
f ЛЯ ШМДОМ *У
сохранения
при двухсторонней репликации между двумя
1 им5^ базами за период времени с прошедшей репликации документ изменился в обеих l?Wt68*oa ь репликах; при сохранении документа, его содержимое изменилось с момента запуска режима мят редактирования. .r*w **' При возникновении конфликта одна версия документа сохраняется обычным способом, а
О-иЛОЮМ Ы4У*>„-'. ^ F »
j. ^ остальные версии становятся конфликтными
документами, что помечается специальным образом
*- а * в виде. ---,
v - ОП t« t№s n'J" ^*-
Лицензия License Соглашение, которое определяет какие базы данных, шаблоны и функции пользователь может ннш> .ч* пфнш-jsq - л .-: - ИСПОльзовать в своей работе. * ( i»»q -Лицензия на Lotus Domino Наличие такой лицензии позволяет существенно расширенное Advanced расширить возможности конфигурации серверов программное д^ясн1 Services license, LN/Domino. Предоставляется дополнительные обеспечение Advanced возможности серверного программного LN/Domino Servicese обеспечения:
кластеры (clusters); S{ «чнь ц-Лив «biWiu»4^4-e/wd^^wficej!w^(partitionedserver).
*f трассировка активности серверов (usage 1 tracing). Фактически для установки перечисленного программного обеспечения соответствующая лицензия требуется только номинально.
©InterTrust Со. Тел. (095)9567928 - -

Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 901
о» kj^v .'j-wpjtm* t.-tp" ]yj
fsTNaois, Макрос Macro Программа, выполняющая автоматические действия
( по указанию пользователя. Макрос имеет три составляющие.
-,*"„ '« _й .о. 5^~ "'1 *,i"^ «'
Ј тригер (trigger) - событие, вызывающее его J запуск;
^ и"ь*1 критерий отбора (search) - документы, которые t * „ -f ** он должен обрабатывать;
? действие (action) - что он должен с документами 1 делать. С версии LN 4 х называется также агент.
Менеджера Manager access Уровень доступа к базе данных, при котором уровень доступа к пользователь может создавать, читать, базе J*" редактировать и удалять любые документы, у '* изменять: список управления доступом, любые ИУГ! '* «о Nvj.rt?* »ч элементы дизайна, документы "О базе данных" и "Об использовании базы данных", определять й R д, ц 6 параметры репликации, и удалять базу данных. Сервер с уровнем доступа менеджера может реплицировать все изменения в базе данных, и 1 обычно удалять документы, помеченные для удаления.
jT
Меню контекстно- Context menus Меню, появляющееся, когда указатель мыши стоит зависимое , на объекте (база данных, закладка, документ и т.д.) и пользователь нажимает на правую кнопку мыши. Зависит от типа объекта.
ыоп~й*а$'я f* л^ т-- *#*# ej -*-* »-г ? с -^ *<* -л_»
Место вызова Current location Место вызова, которое, в настоящее время текущее _„.,._,,- установлено. Его название отображается в строке состояния главного окна LN
Механизм DDE Dynamic data Механизм, используемый в LN/Dommo, для sops * ?5йиивЪ V4id exchange (DDE) отображения данных, подготовленных в других oewwi приложениях Windows и Presentation Manager (например, графические приложения) совместно с документами LN/Dommo. DDE-объекты могут быть , , активированы и модифицированы, не выходя из
,№«Kb\t>vrfi МГН ,»*Ш\>ГГ» - г/г.
ф ^ LN/Dommo. '^^ш^
Механизм r^i^t' Notes/FX (Field Технология, которая позволяет клиентским Notes/FX h«im Exhange) приложениям и серверу LN/Dommo совместно щп iv a j использовать данные полей.
Механизм SOCKS SOCK-et-S Механизм, посредством которого устанавливается (SOCKS) между двумя компьютерами канал данных с ?' "^ " обеспечением безопасности на уровне прокси. Данный механизм обычно используется в j л файрволах.
Механизм Notes remote Архитектурный слой LN/Domino, удаленного вызова procedure call использующийся для любых связей между процедур LN (Notes RPC) программным обеспечением LN/Domino, когда «датнлк* turn ft *> aieaoqwpuO связь осуществляется средствами не LN/Domino
kn^jijdo ь>1" tt\.v.ijuK>\ '>j«*j«^n
© InterTrust Co. Тел (095) 9567928

902 Lotus Domino R. 5: (^.-формулы, LotusScript, встроенные классы LotusScript и Java
(например, через Интернет). Для его использования можно установить протокол HTTP, или прокси SOCKS.
н
Набор фреймов Frameset Элемент дизайна базы данных, представляющий собой совокупность фреймов со структурой
отображения информации базы данных LN/Domino kjaww.s'"4^' -,-. т , или Web-сайта.
,ч. , ; , ЗЖГ1Г- i<;> (ji- ...,1 ^ наборе фреймов допускается осуществление связи между фреймами, например, при выполнении iw «уда S' определенных действий в одном фрейме может меняться отображаемая в другом фрейме Щ'-1 - информация.
Разработчик имеет возможность задать нужный набор фреймов и конкретный фрейм, которые должны автоматически отображаться при открытии базы данных.
.у.ш*шй Набор фреймов и фреймы поддерживаются в LN/Domino только с версии 5.
Навигатор Navigator Навигатор - страница базы данных со специальными программируемыми областями, позволяющими осуществлять быстрый и гяотэ ш интуитивно понятный доступ к определенным ( ' компонентам баз, таким как виды, папки, формы, документы и т. д.
Навигатор Navigator Стандартный навигатор, который имеется в каждой стандартный по Folders and базе данных, и отображает все доступные виды, умолчанию Views папки, агенты, а также возможно элементы дизайна.
Нет доступа No access Уровень доступа к базе данных, при котором уровень доступа к пользователь не имеет доступа к базе данных, он базе даже не может добавить иконку базы данных в свое г^йШ)» яо«з&Мзгз1Ч «? к рабочее пространство.
О
::->*/ое -п"-*'.*' »-- «лг:;: 0>*.ш Область Layout region Элемент дизайна формы или подформы, размещения представляет собой область фиксированных размеров, в которой входящие в нее элементы могут перетаскиваться с помощью мыши, а также отображаться в виде недоступном при использовании этих элементов просто в форме или
^ , , '"' ч_- ,. я v ^-i, -ЈЈ.-ч*а*.г-Е isff-f^- «ТА
подформе.
5 ' ^ ^
Объект LN:DO LN:DO Аббревиатура для объекта Lotus Notes Data Object.
, /i»L,i Представляют собой LSX-модули, используемые в } LotusScript для доступа к данным сторонних ^;^«-А1 «_ приложений. .. .. '..',..,,,. Объекты »{-Јя:> LotusObject Объекты, которые являются экземплярами LotusObject TvV- \ i^ i^ . встроенных классов для программных продуктов -I if фирмы Lotus. Оперировать с этими объектами можно при помощи языка LotusScript. Эти объекты
© InterTrust Co. Тел, (095) 9567928 '*

Lotus Domino R. 5: (^-формулы, LotusScript, встроенные классы LotusScript и Java 903
имеют общие элементы дизайна. При смене продукта (например, с Lotus Notes на Word Pro) данные объекты либо вообще не меняются, либо «,,.,,. „*?V> - претерпевают незначительные изменения.
Окон линейка Task buttons Линейка открытых окон в клиенте LN, „,.„.., „^.. соответствует меню "Window" в LN версий 4.x. , , Расположена под системным меню и позволяет быстро переключаться между окнами.
Оператор @- Statement Минимально возможный элемент языка формул формулы обрабатываемый отдельно. С точки зрения синтаксиса языка формул - предложение заканчивающееся ";".
Отметка о Soft deletions Отметка, которая устанавливается для документов "мягком yjHJ h( * ' ПРИ их удалении некоторыми средствами удалении" friaojiujbt/ijki разработки приложений, при наличии у базы данных установленного свойства разрешения мягкой отметки об удалении. Такие документы не видны ни в одном средстве навигации по базе данных. С таких документов можно снять отметку, штя я \ м»геч*»?\-ал& если еще не истек СрОК хранения в базе этих
документов.
'" ^'~ , .'ДЙ0' *
Панель Рапе Область рабочего пространства, в которой
«*-wn «Ъ t». }- ->' отображается определенная часть текущей базы данных. Например, панель папок, в которой Ј * -t -ли» f * отображаются все допустимые для данной базы oivrocrf\4VU R'jrsvf- данных папки и виды, или текущий вид, или ^ \w^:*oo Я йнн-п„-д> содержимое выбранного документа.
Папка Folder Элемент дизайна LN, представляющий esr.oi! x.if.i, совокупность документов базы данных в табличном .35Чч>-^>%Чв.' ' виде. Отличается от вида "ручным" критерием эж ,л н минг'. ^я»,шг> *мя- .ib отб°Ра Документов. В любой момент времени нсад Иоадо 1»к-л»ф1 " w^4 ^&э' докУмент может быть Добавлен в папку, удален из нее или перемещен в другую папку. Папка может также кроме документов содержать в себе другие папки и виды. {
Папка личная Private folder Папка, с которой может работать только пользователь ее создавший. Может сохраняться ' либо в личном desktop файле, либо в базе данных (при наличии прав в ACL).
Папка общая * Shared folder Папка, работать с которой могут все пользователи, согласно их прав.
Папка общая до Shared, private Папка, шаблон которой является общим, но при первого on first use первом обращении пользователя по дизайну использования, шаблона создается личная папка, сохраняемая в базе запоминаемая в ^>а-ии*и /.^о»<. цн данных. базе данных тэжом опо^отол §* i\ Ь№П «.JJitlib*? т «»Н
Ч! >OW»f^« Г AT) Щ
© InterTrust Co. Тел (095)9567928

904 Lotus Domino R. S: @-формулы, LotusScript, встроенные классы LotusScript и Java **
Папка общая до Shared, desktop Папка, шаблон которой является общим, но при первого private on first первом обращении пользователя по дизайну использования, use шаблона создается личная папка, сохраняемая в запоминаемая в файле desktop.dsk . файле desktop.dsk ,.,:.,
Папок панель Folder pane В открытой базе данных панель, в которой доступны все имеющиеся виды и папки.
Параграфа стиль Paragraph style, Поименованный объект LN/Domino, который Named style определяет параметры текста параграфа (имя RjRieqf w, шрифта, размер, цвет, эффекты, выравнивание). .ун!гэжоддэф1 - «.чмциф Можно по имени стиля установить все данные параметры для параграфа одной операцией.
Переменная Environment Переменные, сохраняемые в файле NOTES.INI для окружения variable платформ (Windows, OS/2, and UNIX) или в Notes Preferences file для (Macintosh).
Подкатегория Subcategories Подуровень категории, появляется в колонке вида ' t . или папки, используемой для категоризации, на 1 *^v " уровень ниже основной категории. Допускается до
У.-ЗфЙГО !М*4!/ УМЖШЛ »УИЙ> ^J, „ „ . ^ J
., 32 уровней категоризации. Подкатегория в поле ла;о seeQ а яындоедх id- ^ . г ч г ' " или формуле отделяется от предшествующего
уровня категории символом обратный слеш.
Поименованные Named element Определенные элементы дизайна баз данных. элементы LN Например, виды или папки. Н
Поле !<И«'Л^« Field Поименованная область формы, содержащая данные определенного типа.
Поле временное Temporary field Поле, которое используется LN/Domino для своих 1>ч> ' временных вычислений. В документе не
сохраняется. \ Поле вычисляемое Computed field Поле, значение которого не вводится пользователем, а вычисляется по @-формуле.
Поле общее Shared field Специальный тип поля, является одним и тем же ^р Н9о$пу д, объектом для всех форм в пределах одной базы данных.
Поле Predefined Поле, которое используются LN для определенных предопределенное fields целей. Допустимо использование таких полей в своих приложениях только в контексте »";»- '»«»чл""' предусмотренном LN/Domino. В противном случае хь»и»«л> *>шо л . возможно возникновение ошибок. Примеры таких " , полей: SendTo - для адресации почты, Categories -кг-jraaot ^я Kames°PU3aifu^ документов в видах и папках, и
, ,.i .Т.Д.
Поле RichText field Поле, содержимое которого может включать в себя произвольного(фор „f fi текст, набранный разными шрифтами и стилями, а матированного) *в»щч,> »v. также таблицы, графические изображения, текста гиперобъекты, присоединенные файлы и OLE-; объекты. .f ^u
Поле Editable field Поле, значение которого может быть введено редактируемое пользователем.
© InterTrust Со. Тел. (095) 9567928 " ' '

Lotus Domino R. 5: @гформулы, LotusScript, встроенные классы LotusScript и Java 90S
Поле с Multi-values Поле, содержимое которого может быть списком из множественным field значений определенного типа. значением
Поле скрытое Hidding field Поле, содержимое которого не выводится в определенном режиме работы с документом яяпох (редактирование, показ, печать, в Web-приложениях - ' и т.д.). Не является средством безопасности, т.к. содержимое поля может быть показано пользователю в окне свойств документа.
Ч ЙГ" it.lt ЯП х*. f
Поле типа авторы Authors field Поле, которое содержит список имен (пользователей, групп, ролей), имеющих уровень доступа автора к текущему документу и 9ov"4v't определяющий, кто может этот документ bf "1^ а бо^.^ц,,».^ редактировать. Применение этого поля не перекрывает списка управления доступом,
пользователи, имеющие уровень доступа редактора ч еьг!зог< н-лкк адцкярздвтзю и Выше? могут редактировать любой документ,
независимо от поля типа авторы. эодотол «'rfwu-yiivaoo д^ доступа на редактирование к секции Л^оС",о юл. luv»»^ ,« используйте список доступа типа редакторы.
Поле типа Keywords field Поле, значение которого выбирается из ключевые слова ограниченного набора возможных значений. Внешний вид при выводе таких полей может т .-nq&TH, я'кмиэт"? с отличаться от обычного, и представлять собой окно ,вдпм.гЬг -<лнфь.п «pvumh мгн, со списком, чекбокс или радио-кнопки.
Поле типа Readers field Поле, которое содержит список имен читатели (пользователей, групп, ролей), определяющий, кто
** ^*. ->
может этот документ читать. Применение этого оадшннгх«К>Ой н i^o* пот не перекрывает списка управления доступом.
Поле Encrypted field Поле, содержимое которого зашифровано ключом шифрованное шифрования из ID-файла пользователя. Прочитать "*"* ' . содержимое такого поля может лишь тот Tfiou .эы», ^v»jHi пользователь, который имеет данный ключ hie** Wbuionq !»««*. шифрования.
Полей порядок Fields tab order Порядок обхода полей в режиме редактирования -обхода последовательность активации полей при нажатии клавиши <ТАВ>. По умолчанию слева направо, .b^b'v.'., лаицнф i сверху вниз, но может быть изменена в свойствах вк мэосрдо чгт T^fiawT-'ji'Sjai! Si поля на закладке "Basic".
Полнотекстовый Full-text search Операция осуществления поиска документов, поиск удовлетворяющих определенным условиям. Запрос
г Vf^VVg w
на пол нетекстовый поиск может включать слова, фразы, символы подстановки и логические н мтаивп ьчвэтэо "fiF-j^so^ii нь операторы. «юв«
Почтовая система Alternate mail Почтовая система, отличная от LN/Domino, но альтернативная которую можно использовать вместо стандартной почтовой системы внутри LN/Domino. Например, ** cc:Mail.
© InterTrust Со. Тел. (095) 9567928

906 Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java
Почтового Letterhead Специальная область почтового сообщения, сообщения содержащая дату и время его создания, расположена заголовок в верхней части почтовой формы. Пользователь может выбрать стиль такого заголовка из имеющихся.
Присоединенного Detach Процесс создания локальной копии файла создание присоединенного к документу LN/Dommo файла копии
Присоединенный Attachment Файл, содержимое которого включается в файл форматируемое поле. Отображается в поле в виде 'им/с "N {vif >Провайдер, ISP Internet Service Компания, предоставляющая услуги доступа к Provider (ISP) Интернету.
Программное Newsreader Клиентское программное обеспечение, которое обеспечение использует NNTP протокол для отбора, "Newsreader" "" отображения, создания, сортировки и печати статей j»t Из сети UseNet или внутренних групп "newsgroup",
Программное Multipurpose Программное обеспечение позволяющее обеспечение MIME Internet Mail "присоединять" к почтовым сообщениям Интернет Extensions нетекстовые файлы (включая графику, таблицы, (MIME) форматируемые в текстовых процессорах документы, звуковые файлы и т.д.). *
Программное Groupware Программное обеспечение, обеспечивающее обеспечения средства связи, совместную работу и координацию коллективного * --.*-- внутри группы пользователей. использования ' M^It"*'*'»*
Программный Internet server Интерфейс прикладного уровня, поддерживающий интерфейс ISAPI application IIS. Разработчики, используя этот интерфейс, могут programming создавать программы (называемые расширениями interface IIS), которые увеличивают возможности IIS (ISAPI)
Продукт DataLens DataLens | ,& Набор драйверов для доступа из LN/Dommo к внешним базам данных. Продукт фирмы Lotus/IBM.
Прокси сервер Proxy server Сервер, который перехватывает все запросы на
, другой сервер, и определяет, может ли он сам их v «>_-rv«'»І> ян^*«?*« .д.» v ff f « ,, Tmc ш»*» Эт »и.<яш*ф1.» выполнить, и если да, то он их выполняет. В ию'-л „-. л-мим " ,**»/ л .Ю1, и противном случае запросы отправляются на другой сервер.
Прокси уровня Application Прокси, который проверяет сетевые пакеты и приложений proxy , информацию в них содержащуюся, контролирует их ?7?vw «зШк/>Мг доставку до адресата, и управляет потоками 0^ _ юяи^ /^ но,Л„ 1шГЛ1 информации между внутренними и внешними * - ~ " * * пользователями и серверами. * i
© InterTrust Co, Тел (095) 9567928

Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 907
Простые действия Simple actions Средства разработки приложений, позволяющие
ууъ&Щ*'>* -" ^гн<Д"- выбирать определенные действия из ограниченного набора имеющихся над документами.
Протокол FTP FHe Transfer Протокол передачи файлов с одного на другой Protocol (FTP) компьютер. Очень часто используется в Интернет-Л приложениях.
Протокол HTTP Hypertext Протокол передачи файлов с одного на другой Transmission компьютер. Очень часто используется в Интернет-Protocol приложениях.
TVfcrOSi ill (HTTP)
Протокол ICAP Internet Сетевой протокол позволяющий получать доступ, Calendar Access управлять и сохранять информацию о календарном Protocol (ICAP) планировании. Данный протокол использует либо:
30 „ 'У\М1А набор расширений протокола IMAP4 для создания сервера, который поддерживает как обмен сообщениями, так и функции >н>лис.пки<лч н , календарного планирования;
либо автономный протокол для сервера, специально выделенного под задачи календарного планирования. Протокол ПОР Internet Inter- Протокол, который реализует решения CORBA для - >лча о ifRnj i ORB Protocol Web-приложений. Данный протокол позволяет wsnaqdp «fi3t?-wf* (ПОР) обмениваться серверам с браузерами сложными объектами, отличающимися от HTTP, который поддерживает только передачу текста.
Протокол IMAP Internet Почтовый протокол, который позволяет клиентам Message Access обмениваться почтой с почтовым сервером,
'ШЦШ^Х ^Т^г т_ _ _
Protocol поддерживающим этот протокол. IMAP-протокол (IM АР) ',*«»' подобен протоколу РОРЗ, но имеет по отношению к , ' нему дополнительные возможности. Например, он
.ТО^Н са МОТ- -i Я^ J к к>
м , _ поддерживает три режима доступа к почтовым бпнт он,«лх* о; поз<ч < ".Т F „ J v J ^ * ящикам. Данный протокол можно использовать при
работе с Domino-сервером.
Протокол LDAP Lightweight Набор протоколов для получения информации о „ ' " Directory директориях. LDAP базируется на протоколе Х.500,
fifrKpfCM Ч --ОНа*П «х1 -т^п/гп
4 Access Protocol но также поддерживает протокол ICP/IP, который (LDAP) нужен для работы в Интернете. Так как LDAP "" можно рассматривать как упрощенную версию Х.500, то его еще называют X.500-lite. Допускается ' Л'~ совместное использование LDAP совместно с ^а ' Domino-сервером для доступа LDAP-клиентов к ;$сЈ.'*а .ъ-.^ общей адресной книге, например, для получения . .-.- требуемого электронного адреса. , .
йояизиэлэдпо с , ' tiHJiv »
ыпнт э.'Л^шг -'И'нво/ тажд*^ йиг:ог*х» " . -i ti,
* г» J"»'1' 1
'.' i <
н<р*<на ябх .ч» *ы ' . *K'J'' кыЧ - а я-r* ниьдо
*--,>;
. ., '* © InterTrust Co. Тел. (095) 9567928
,у! '"

908 Lotus Domino R. 5: @гформулы, LotusScript, встроенные классы LotusScript и Java
Протокол NNTP Network News Протокол, который поддерживает для групп Transfer "newsgroup" чтение, пересылку по почте и передачу Protocol статей между новостийными серверами. Когда (NNTP) администратор разрешает использование на Domino сервере протокола NNTP, это автоматически разрешает клиентам NNTP получить доступ к * '" группе "newsgroup" данного сервера, и позволяет ж 1 /? < ',w , Domino сервер обмениваться новостями с другими *"»'{- NNTP серверами.
Протокол POPS Post Office Почтовый протокол, который позволяет Protocol пользователям получать почту с их главного uvrvou «тиокол й- Version 3 почтового сервера, так же поддерживающего ' (РОРЗ) данный протокол. Domino сервер поддерживает работу по данному протоколу.
Протокол S/MIME Secure/MIME Версия протокола MIME с обеспечением ;, (S/MIME) безопасности. Данный протокол позволяет нмынуф и пользователям отправлять почтовые сообщения с '-.- шифрованием информации и электронной подписью, даже в случае если пользователь-получатель имеет отличную почтовую программу.
Протокол SASL Simple Протокол, используемый в Интернете, и который »т Authentication позволяет для LDAP-пользователей выполнять and Security процедуру аутентификации при связи с LDAP-Layer (SASL) сервером и обеспечивает безопасность передачи Hwqoito» ЛП'Н данных по этому протоколу.
Протокол SLIP/PPP Протокол являющийся аналогом протокола TCP/IP SLIP/PPP для коммутируемых соединений.
Протокол SMTP Simple Mail Протокол, являющийся в Интернете стандартом для Transfer передачи почтовых сообщений между базовыми Protocol узлами сети. Он обычно выполняется поверх (SMTP) протокола TCP, используя при этом 25 порт. Протокол SMTP обеспечивает только сервис типа стандартной почты, не поддерживаются возможности почтовых ящиков и некоторые другие.
Протокол SSL Secure Sockets Протокол с обеспечением безопасности, Layer (SSL) применяемый в Интернет и Интранет, и который ' обеспечивает конфиденциальность и и *'.,* Ял?' .-. . »»*..j ч и Мя-. аутентификацию для Domino-сервера при работе
поверх TCP.
Протокол TCP/IP Transmission Базовый сетевой протокол Интернета. . „-_, ^ Control Первоначально был разработан для UNIX, в иш<э<\ . - , ProtocoWnterne настоящее время поддерживается всеми основными t Protocol операционными системами. (TCP/IP)
Профильный Profile Скрытый документ, создаваемый по определенной документ форме, и который может хранить любые типы данных, допустимые в LN/Domino. Эти документы, в основном, используются для обмена данными между различными приложениями, как внутри одной, так и в различных базах данных. Имя профильного документа совпадает с именем
© InterTrust Co. Тел. (095) 9567928

Lotus Domino R. 5: @гформулы, LotusScript, встроенные классы LotusScript и Java 909
1 формы, по которой этот документ был создан. , iц-> ,,._,' >
v v > ( f» пользователей может существовать разные лщкдшнфмдек ч «w's- профильные документы с одним и тем же именем. оврадо«,чи*^'.,>,с1*и Таким о6?830»4. Разрешаются конфликты при ьнтюг.**1 / к KstoJWf^a- одновременной работе нескольких пользователей. L Для конкретного пользователя и определенной базы f* ж -41 " ' данных может существовать только один nwnsc ft профильный документ с заданным именем.
Профильный Calendar profile Профильный документ почтовой базы данных документ пользователя, в котором можно настраивать "Календарь" (JgyF ^А(^ш ,,. ,ц параметры вмда "Календарь". Например, продолжительность собраний по умолчанию, ' '- параметры оповещения, а также делегировать права йьм^о^л! sti woms«*roo к на просмотр и/или изменение информации из вида 1(> „ "Календарь" другими пользователям.
,lf\»WS ' < '<. ! «UHblOV- р
*
Рабочего ; Workspace page Страницы с закладками, внешне напоминающими
пространства картотеку. Используются для хранения на них r F чтйадлкоэ мен i n тт страница иконок баз данных. Пользователь может менять
страницам рабочего пространства заголовок, цвет к йишшшл* sjp т»>окпалоо ярлыка, а также добавлять и удалять страницы ад**' * . рабочего пространства
Рабочее * Workspace Окно, которое отображается при старте пространство v ^ клиентской программы LN. Рабочее пространство gawe^k- итн&мэи, « иглч*» итлащ»" ' состоит из :
тщ^т&ш-л /Э ,: , ч, - .» » ч, » .vsmuv. ,q oioi * строки состояния; '
wiHiPW-fieca* главного меню; , Г|СТ^ панели активных пиктограмм;
V-
набора страниц с закладками, называемыми страницами рабочего пространства, может (' " ^ **tl включать страницу Репликатора.
.Ht « 4**lt WKWUWiUWil»»»-i , w J'tjj^w тт j. ^
v ' Информация о рабочем пространстве хранится на * stsQoTOji'' Мтош, рабочей станции в файле Desktop.dsk .
- - г , ,,-' ч ,.v
Расширение файла NSF Расширение имени файла, используемое для баз NSF данных LN/Dommo. Такой файл содержит как данные, так и структуру базы данных (формы, виды
*Я Гр г| Л
tnmfwntbtb4-i , »ftfaur-t^,Расширение файла NTF *» J'* Расширение имени файла, используемое для NTF 1 шаблонов баз данных LN/Domino. Такой файл ir ^ содержит только структуру базы данных (формы, Л ' виды и т.д.) без данных пользователей. В комплект поставки клиента Domino Designer входит достаточное количество шаблонов уже готовых приложений.
„ _ © InterTrust Co. Тел (095) 9567928

910 Lotus Domino R. 5: ©-формулы, LotusScript, встроенные классы LotusScript и Java
Редактора уровень Editor access Уровень доступа к базе данных, при котором доступа к базе пользователь может создавать, читать, редактировать и удалять любые документы. Сервер с уровнем доступа редактора может реплицировать новые и модифицировать существующие документы в базе данных, и обычно удалять документы, помеченные для удаления.
Режим поддержки Version Механизм позволяющий хранить всю историю версий документов tracking модификации документа. Можно реализовать либо посредством создания документов через форму с поддержкой версий (определяется в окне свойств формы), либо путем добавления в форму поля "SVersionOpt". При поддержке версий возможно три :о«шв'г>г,о*^ да? «иго варианта:
, новая версии становиться ответом на исходный .mriv документ;
. старая версия становится ответом;
версии равноправны. , «; ншаднтьылопш wu.*h* ,нмв*, Также можно установить создание версий хин ей «*ч«ш^*ла rotwmiw- автоматически при сохранении документа, или "**dR9' вручную.
Реплика полная Full replica Реплика, которая содержит все документы и элементы дизайна исходной реплики.
Реплика л г Partial replica Реплика, которая содержит только документы, частичная < «г, отобранные по формуле селективной репликации, усеченные документы и/или элементы дизайна исходной реплики. Существует возможности указания максимального размера репл ики.
Репликатор Replicator Термин имеет два значения: ч?: ш-;
.qn рабочего пространства, и на которой можно управлять процессом реплицирования этих баз;
Щ,*01РВДС|ЖУ№^
серверная задача, которая занимается реплицированием баз данных между серверами. Репликация Replication Процесс обмена измененной информацией между базами-репликами. После выполнения репликации ' базы-реплики становятся практически идентичными по содержащейся в них информации. Исключения vf ..- эок-у-иионзн w ' составляют случаи, когда выполняется неполная пй;-Ф ГюхвТ .адат* репликация (однонаправленная, с использование формулы селективной репликации к т. д.).
' '; . ,-'' -
"я , - .... .-,.;, »»ЩЩ: эж^ eoHcnv3s>vw оагаэрнг.с „ . - -
.. ~. -...:. ... ~ -* -, - ' ., 4j(
; ;,,. .; i , ;% - ' =**" '-
©InterTrust Со. Тел. (095)9567928

Lotus Domino R. 5: @гформулы, LotusScript, встроенные классы LotusScript и Java 91 1
Реплики "окурок" Replica stub Реплика или копия базы данных, содержащая только элементы дизайна без документов исходной базы данных. Может содержать не все элементы дизайна, > v. рш здээаэг- «$М!*тл-Н $,» ээгйэ» . например, быть без видов. Возникает когда в У1э*п1 ha'Oipr настройках параметров репликации указано, что само ретицирование будет произведено при очередной репликации. Используется в основном,
для переноса дизайна на удаленный компьютер.
»ла»аа»с> ?*й"ь эт у
Реплики Replica ID но Уникальный идентификатор, который совпадает для уникальный . чдчгл всех реплик одной базы данных. идентификатор *о~ »"-<
Ресурс Image resource Элемент ресурса - графическое изображение. изображение
Роль .к Role Элемент списка управления доступом, позволяет ограничить доступ к определенным элементам f дизайна или документа, в случае если пользователь 4 i0li не назначен на конкретную роль.
(-. ,-. ,> тН J- ,". > , ' %-
с
Секция ^ *wy*-' Section Farr>^ 'Определенная область формы, или мсиовтчшф ь'1 " ооьо форматируемого поля в документе, которая ,опьп«ч1У\_ ш»~ .«.> позволяет "сворачивать" или "раскрывать" * ' - входящую в нее информацию, щелчком мыши по F заголовку или с помощью меню/клавиатуры. Секция ^*^.^ж% аягад» может содержать поля, объекты, области
ошяш*сюф u^mY« «r.^wbofs^ ^^^ew"« и статичный текст. Можно также определить заголовок секции, как статичный текст или по формуле, состояния свернута/раскрыта в режимах редактирования, чтения и просмотра, и R-ir ' формулы видимости секции. Секции бывают чму ^ лю&сн- простые и с управляемым доступом.
i it .« о>4Г5 qe RO-1
Секция с Access . Секция, которая может быть определена только для управляемым controlled формы. Редактировать пот, входящие в такую доступом section секцию, могут только пользователи, имеющие на это дона. kl право. Секция с управляемым доступом помимо i.KK^o-fHqroHHHPu» йл»1Ш^г „ полей может также содержать области размещения, объекты и статичный текст. *а$^'Л i
Сервер IIS Internet Web-сервер (Microsoft Internet Information Server),
, Information который позволяет просматривать как HTML-« «jH^SiiecMJKoAi r * . v Server (IIS) страницы, так и страницы Active Server. Сервер
Domino включает расширения IIS для просмотра ;V\a ?оц?Эч» своих баз данных, используя IIS.
Сервер LN/Domino Server Domino Компьютер, на котором запущено программное обеспечение сервера LN/Domino, и находятся базы #э.*нв«т*ч/'.оп:»г > r»arodeq в» данных LN/Domino. Xhwwno Vo6 esqoi* аоэо'аш,
OiHrj^tTOV. / oO У^'е^И^Я
n ^-\чд' . < 'Л , '*f,f H^n TS^T-qsTD «s .«tesoHEs'x* f. i, од risic.deq
© InterTrust Co. Тел. (095) 9567928

912 Lotus Domino R. 5: @гформулы, LotusScript, встроенные классы LotusScript и Java *
Сервер базовый Home server Сервер базовый - это сервер, который был указан при регистрации пользователя. Используется для: доставки почты, соединения с другими серверами етЭ drm- LN/Domino, в качестве InterNotes сервера для задачи Server Web Navigator (в случае, если InterNotes сервер не указан в документе Location).
Сервер посредник Passthru server Промежуточный сервер, который позволяет
Ч ,'"М»>'> '
пользователям получать доступ к другим серверам, с которыми они напрямую не соединены. ,, >-- . Мобильные клиенты могут иметь доступ к множеству серверов при соединении по одному телефонному каналу, для клиентов LN/Domino ъ локальной сети они могут связываться с другими серверами по протоколам отличным от протокола '\ »г. -,№> связи со своим базовым сервером. «и-оч
Сервер Нор Промежуточный сервер, который используется для промежуточный маршрутизации почты, в случае, когда сервер отправитель и сервер приемник не соединены напрямую.
Сервер Partitioned Программное обеспечение для серверов LN/Domino, разделяемый server позволяющее работать на одном физическом '.ггвяыйл^п huh "d компьютере нескольким серверам LN/Domino, общей численностью до шести. Применяется в случае необходимости увеличения числа серверов ш без вложения средств в "железо".
* ^ yVftf'S .Ч'*-'
'»ЈД *v«»yr ДдЯ установки разделяемого сервера формально v ' «т&гз >*я л необходимо наличие лицензии на расширенное -, ,ч*.т*-м\*.л*п*-> «тяпгого программное обеспечение LN (Advanced Services).
Серверная задача Server task Программа, которая может выполняться только при загруженном обеспечении сервера LN/Domino. Могут загружаться вручную, с помощью серверных grii; i..»4M>r шуя *,f»qt<-< команд, автоматически при старте сервера, или по ошшт я t»}u*ёoxre ,да.-п -ггла» расписанию.
Серверная задача Administration Серверная задача, которая автоматизирует "Administration Process, ^л;-,$- большинство операций администрирования Process" ADMINP^Hv4. LN/Domino, таких как:
ресертификация Ю-файлов;
-**' lf' " изменений имен и удаление пользователей и !\>->с;э v "- групп пользователей;
M'.jOl* 51i / « 4i <,Г-
^'I'/^urr * Удаление серверов LN; создание реплик баз данных;
30WK- --'. -~
5«ч,й к . - ... * перемещение баз данных. Данная задача работает с использованием механизма запросов через базу данных Administration Requests. По умолчанию автоматически стартует при запуске сервера, и работает до его остановки.
© InterTrust Co. Тел. (095) 9567928

Lotus Domino R, 5: (^-формулы, LotusScript, встроенные классы LotusScript и Java 913
Серверная задача Agent Manager, Фоновая серверная задача, которая занимается "Agent Manager" AMgr управлением и запуском агентов, которые должны выполняться на сервере. По умолчанию * <н tmwwh* автоматически стартует при запуске сервера, и ^на . .,^m^uv« %«н, рабогает до его остановки.
Серверная задача Collector Серверная задача, которая занимается сбором с "Collector" заданным интервалом времени статистики о работе j ада?а*г.г,д*,<к\ ;о<шшгша ^t.vvi и многих серверов (в отличие от "Reporter"), и * доставки статистики в базу данных "Statistics". В « - отличие от "Reporter" не может создавать сводных отчетов.
Серверная задача Server task Серверная задача, которая занимается отбором из "Event" Event стандартной очереди событий заданного типа и степени серьезности, и доставки отчетов о них в
базу данных "Statistics".
Серверная задача Notes Object Серверная задача, работающая с посредником "NOI" Interface (NOI) объектных запросов (Domino Object Request Broker) * для обеспечения связи между сервером Domino и t » Java апплетами, созданными на основе встроенных » 'i« v,- Notes Java классов. Пользователи, работающие f* мгн через браузер и сервер Domino, используют " urhc;js протокол ПОР для связи и обмена данными объектов.
Серверная задача Reporter Серверная задача, которая занимается сбором с "Reporter" заданным интервалом времени статистики о работе KK".ji'Ui!Vi tietui&K ,vn~ сервера, создании по ней сводных отчетов, и 8д к>я лш^шлглш»^ ш1 доставки статистики и отчетов в базу данных
"Statistics".
Серверная * *« Server Команды консоли сервера LN/Domino. Могут команда "<*» «с* command передаваться серверу вручную (с консоли или
,, '.,'v fojvi«_ . ,.., ,^ удаленной консоли), или автоматически (через
т 1^- т--. f\<\a\bqvtr«'« ' ' "~" 'г " документ Program общей адресной книги).
ЪГЧЧХЦ.' Т«
Серверная ^Server program Программа, выполняемая на сервере, но не программа требующая для своей работы загрузки обеспечении , _ сервера LN/Domino.
Серверная Binary tree Топология, при которой сервера соединяются топология типа server topology между собой по пирамидальной форме, т.е. сервер двоичное дерево верхнего уровня соединен с двумя серверами ^ уровнем ниже него, которые в свою очередь также соединен с двумя серверами уровнем ниже, и т.д.
1H9VOI/ ТОТ' Ч MbjJinvTOOa " м J Г Г JY >
Информация при этом перемещается вниз пирамиды
THfU-X^NOCa &>*»>№T Hfflt'.pn JU) -г г г г г
и затем возвращается обратно.
t
(» *Г it ,1
.,"&* ^ ^ 'ч, щу *'*' "" :яф§с\з' ttiva-
C»u'« ,'*V'~ »VV .M-V54Ji4^^K. ^.,,Ґ, Я> - f} ItfM.UMH'iM.'^UO'K' '««» Hwb « "'Utbfl'»' * '<:!S, »>',%
^\*
,Ш х«/ * '
© InterTrust Co. Тел. (095) 9567928

91 4 Lotus Domino R. 5: @гформулы, LotusScript, встроенные классы LotusScript и Java***
Серверная Hub-spoke Топология, при котором один узловой сервер (hub топология типа server topology server) соединен со всеми другими оконечными звезда серверами (spoke server). При такой схеме, изменения в базах данных на оконечном сервере, с помощью механизма репликаций, сначала передается на узловой сервер, а затем узловой сервер распространяет их на каждый оконечный Ти зчннг.го а^' сервер. Узловой сервер выполняет репликации с g каждым сервером организации или с главным *, , узловым сервером организации (при наличии в организации нескольких узловых серверов). и „
Серверная Ring server Топология, при которой сервера соединены в топология типа topology ч",э"^»- цепочку, но последний сервер соединен с первым. кольцо _ Данная топология очень похожа на топологию типа цепочки, за исключением того, что это первый < сервер соединен с последним.
Серверная Peer-peer server Топология, при которой каждый сервер в топология типа topology организации соединен с каждым другим сервером равноправных той же организации. В организации, где существует узлов не слишком большое количество серверов, такая г топология позволяет получить максимальную скорость распространения обновления информации.
Серверная Chain server Топология, при которой сервера соединяются один топология типа topology с одним, и начальный сервер с конечным. цепочка «эдг.»! wj»ef Информация при этом перемещается по цепочке и jh затем возвращается обратно. Данная топология х»-» , . ч ,, ... бывает полезна для организации репликаций, когда сервера размещены компактно.
Серверный -*'4/* Newsfeed Периодический процесс передачи по почте новых процесс юэ, э) е статей, подготовленных группой "newsgroup" с "Newsfeed" одного NNTP сервера на другой сервер по протоколу NNTP. Когда администратор разрешает использование на Domino сервере протокола NNTP,
*М >- 5 г г г
это автоматически делает доступным процесс ' "newsfeed" как для сети UseNet, так и для ***"* * w внутренних групп "newsgroup".
Серверов группа с Hunt group Группа серверов, которой для связи по одним " ^ коммутируемым каналам присвоен один и тот же коммутируемым телефонный номер. При организации вызова с
« Ч ЬиЦОГ,:,* ,<ГО1 Л ~ г г г
номером канала ^ рабочей станции по этому номеру происходит .«. г> .«*«.«,» соединение с любым доступным в этот момент ЛЬС!'*П u* сервером, В рамках группы также происходит балансировка загрузки серверов.
Серверов Usage tracing Программное обеспечение для серверов LN/Domino трассировка позволяющее трассировку и протоколирование активности следующей деятельности сервера:
сессии с сервером', * сессии с базами данных и документами; * репликации; маршрутизация почты;
© InterTrust Co. Тел (095) 9567928

Lotus Domino R. 5: @-формулы, LotusScript, встроенные классы LotusScript и Java 915
it* ><-OS нф7 запросы к Web-серверу, ft Для установки трассировки активности сервера н^ формально необходимо наличие лицензии на в ё>mw&M.4ViC\&> атон^^ц 'Ъ'л$ v расширенное программное обеспечение LN ."wvwx--^. л>.\. (Advanced Services).
Сервлет «'ввяышй s Servlet Сервлет это Java программа, которая выполняется "Wf" * на Web-сервере, и отвечает на запросы браузера. Использование сервлетов в Web-приложениях
(ПМ/«*ПП*Н} Kf'.t ~ва»>Ј4' гг Ј
,4-v* < ' предоставляет разработчикам большие функциональные возможности. Сервлеты очень анш'ть похожи на CGT-программы, но при этом они сильнее JMo-- интегрированы с серверным программным t, , й'.ш. обеспечением и могут использовать все богатство Java классов. Обычно, сервлеты используют для ш обеспечения соединения с реляционными базами 31 к -.го* йнг -»>х> >«4 .нэпэт^с" с данных или системами масштаба предприятия, и Tfyre , vs"fp; Сервер Domino поддерживает выполнение ** сервлетов.
Сертификат Certificate Уникальный электронный штамп, сохраняемый в ID-файле, и ассоциированный с определенным
r>is ' ! ' * ' ' " п именем сертификатора и его открытым ключом '^ шифрования. В одном ID-файле может быть несколько сертификатов. Сертификаты используются в процедуре аутентификации для получения доступа к определенным серверам. При тажом ' - ' Гыш *»,^Дзопо <ЙР ЭТЈ'а Работе с LN/Domino применяются как LN-Vi«v^ »"НЯд,ц, оп эын^ч^'О ,w?v\ сертификаты, так и SSL-сертификаты. i»v^ttt-ocib tf,c*4-N««-> SSL-сертификаты позволяют серверам с ЙГ~*; сертификатами, созданными в LN/Domino, легко обмениваться ими с другими приложениями. SSL-сертификаты содержат открытый ключ ' t шифрования, имя сертификатора, дату окончания « ' срока действия сертификата и электронную i подпись.
Сертификат 'lf)a Server ч Двоичный файл, сохраняемый на жестком диске сервера certificate сервера, и который содержит открытый ключ шифрования, имя сервера, дату окончания срока мнншзна х (-^fTWCjT4 ^оаоий&ф действия сертификата и электронную подпись. .( д.т rfi-ггко?' s»asqii Данный сертификат однозначно идентифицирует йзтнчВф' Й1г сервер в процедурах аутентификации. Сертификатор Certifier Учреждение или лицо, выдавшее сертификат.
Сертификации Certification Процесс создания сертификатов. LN/Domino продцедура автоматически сертифицирует пользователей/сервера при их регистрации.
Система DNS DNS Аббревиатура для Domain Name System. Система преобразования в Интернете имен доменов в IP адреса.
© InterTrust Со. Тел (095)9567928

916 Lotus Domino R, 5: @-формулы, LotusScript, встроенные классы LotusScript u Java
Скрипт, Event script Скрипт, который запускается при возникновении вызываемый определенного события. Например, скрипт наступлением QueryOpen класса NotesUIDocument вызывается при события открытии пользователем конкретного документа в ; своем рабочем пространстве.
Событие Event В LotusScript ситуация, которая вызывает отклик на
вм -ггйУояго n ,§ нее приложения. События бывают:
-,... .... v S ВО"' V „
._ . вызываемые действием пользователя (например,
МЯЯЯН'ГГУЪ- , V F F»
нажатие кнопки мыши);
d»- ..МТЭОЕ
«,-.: генерируемые системой (например, события
вызываемые таймером); i <« ; ^е** » * »
вызываемые приложением (например, сохранение документа). Каждый объект Lotus может реагировать на и ,в;:ГШ№ возникновение определенных событий, которые г-н гзв'0 определены для класса, экземпляром которого этот , ,, f объект является. Основное предназначение событий
..... sj?i«fs«'* тэяяняи. 5ч\&ом < " вызов Для и* обработки определенных скриптов , v (например, при сохранении редактируемого пользователем документа вызывается скрипт
.: r,,_,.w.,~",...~c, ;пмятп« " QuerySave класса NotesUIDocument.
-- , Й5'*;:
Список доступа Create access Список пользователей, определяющий, кто может для создания list создавать по данной форме документы в базе документа с '.;к данных. ^ .t,
: ПОМОЩЬЮ ^ ««ЪЭД!»^ as . - '..-,-,. я
конкретной формы , i i : ,»г^. нч , , .
Список доступа Read access list Список пользователей, определяющий кто может для чтения 8лм|>?< читать документы, созданные по данной форме. документа, ,2 ro/p*ioafnn « Д*18 управления таким списком доступа созданного с \ g м**ын используются поля типа читатели. помощью ,, , , . . -конкретной формы
Список ' ёtsa *"Ч' Execution Список, который определяет параметры управления control list безопасности рабочей станции при выполнении выполнением (ECL) приложений LN/Domino и Jova-апплетов. В период
>,.>„л^'^, „,,,.,.,.,,,, выполнения проверяется кем подписан дизайн н приложения, и разрешено ли данному разработчику выполнять определенные операции (например, обращение к файловой структуре, к внешним программам, отправка почты и т.д.). , *,л*ък:.
Список ,ич|»да Administration Список управления выполнением, который хранится управления ;1Г ;п ^SQ^w»; .;;ямп ч в °бщей адресной книге. Используется для создания выполнением по его образцу списка управления выполнением администратор- рабочей станции. ,, -*
ский -"-' ' ' , ' **1 .. .тгэ>г"Л! х« н^л в^эечг-1-. -.- ..«
/чмг^анЭ .rf-,;.»lgv-e »mё'': - - - ^SMCI -е^С?/дм»Т5вЭ Т; « яонэмод нэмн ч;-:. - -. ,
f . > . ,w' -
© InterTrust Co. Тел. (095) 9567928

Lotus Domino R. 5: @гформулы, LotusScript, встроенные классы LotusScript и Java 917 Список „_,_ Acces control Список пользователей базы данных, включающий:
М*Г* J*Pr
управления list (ACL) индивидуальных пользователей, сервера LN/Dommo доступом и группы пользователей и/или серверов. Данный список создается и обновляется менеджером базы ;«.< данных. Список управления доступом определяет *13><Ь $*s* какие операции разрешены/запрещены (чтение документов, редактирование, создание, и т.д.) * " "' конкретному пользователю.
Ссылка Link Иконка, которая дает прямой доступ из исходного объекта LN/Dommo (документ, вид, база данных) в * ;««Тг другой объект LN/Domino (документ, вид, база * fo данных), причем открытие другого объекта не кр» х -., лм„к; * i w .ниим-уи . ш w. сопровождается закрытием исходного объекта.
Ссылки на папки Folder Для баз, поддерживающих данное свойство, references имеется механизм, позволяющий определить, в «м-лцр»' я члл «и/а -ж J каких папках находится конкретный документ.
Реализация механизма основана на скрытом виде с именем FolderRef.
Стандарт ISDN Integrated Международный коммуникационный стандарт для services digital передачи информации типа: видео, голосовая, network (ISDN) цифровая. Для передачи используются цифровые '* """** ' телефонные каналы.
Стандарт ODBC Open Database Стандарт, разработанный фирмой Microsoft, для '? н пинт кьцл Connectivity доступа к внешним базам данных. ODBC состоит из (ODBC) четырех компонентов:
' приложения, которое может использовать вэрчхшч ж iwfё!cx>,u RHWxs< . стандарт ODBC;
tff^ ODBC управляющего драйвера (Driver Manager); драйверов ODBC для конкретных баз данных;
'нг э ^ источника данных (data source). WC№ LN/Domino поддерживает стандарт ODBC. *
Стандарт PKCS Public Key Индустриальный стандарт форматов для запросов ..пргн* Cryptography на получение сертификатов. Данный стандарт в Standards LN/Domino поддерживается в приложениях (PKCS) авторизации сертификатов Domino (Domino Certificate Authority) и в администрирование
Ф RSqOTOJi ta3K>v8
сертификатов серверов (Server Certificate Administration). При подаче запроса на получение jtfyv . ,5 сертификата при обращении к сторонним (не LN/Dommo) серверам необходимо предварительно , r ~^f.'j -о» оышо» узнать, поддерживают ли они стандарт PKCS.
Страница Page - Элемент дизайна базы данных, который может „п содержать:
й" "*(/ eioqo-bqro текстовую информацию;
в 05«»Я" М<5»ПЛЫ !.<И
«. горизонтальную линейку, разделяющую части
страницы;
&«v -"Ma^tfK v
MOHRuCtoJo о ,qi>f RwisMsm ** * таблицы; «ччоф ^ ш^л (o«>jKfiqrjjfXiiё секции;
© InterTrust Co. Тел (095)9567928

918 Lotus Domino R. 5: @~формулы, LotusScript, встроенные классы LotusScript и Java &&
* v * ссылки на другие поименованные объекты LN
или URL;
„ «.г графику,
~>1 ft У ,»
гиперобъекты, Ч(Щ KNr присоединенные файлы;
Г Т ' * *J ' «>
апплеты;
* действия;
„ й- ' ' ' U- > л "'fcft.?Aё3 а , , JV> ^мй S1 встроенные объекты;
> * ч? HTML-объекты; „t , , -t , ^ » 4,
OLE-объекты. Страница Welcome page Страница, которая по умолчанию открывается при "Welcome" x>fj! ><ч ,гш<* загрузке клиента LN. Содержит:
a .,rreii.'j?i?*4<'» ъащгчкт oaf f>ii .v»» Ј *пч^с*'< чоч йлнцоюн * основные задачи (работа с почтой, календарем, и т.д.);
j SftMs Ы( ГИП^.. ^taidOH-JO й*йЈЙЬ ^
панель поиска, информацию об изменениях в текущей версии;
* ' * "' ' _ w T-VT V*WJ »*|«К»Л«Л
справочный тур по LN. Строка состояния Status bar , г Область в нижней части окна рабочего пространства. Состоит из ряда сегментов:
*, а
сегмент индикатора обмена данных с сервером',
сегменты выбора и индикации типа и размера г- №> шрифта, и стиля абзаца;
, ,«.,~v,. сегмент системных сообщений;
* сегмент индикации уровня доступа к текущей базе данных; "- - ' ни '/*«'« *
сегмент выбора места вызова;
сегмент выбора действий с личной почтой. Субформа или Subform Элемент дизайна базы данных. Аналогична форме, подформа но никогда не используется самостоятельно, а динамически загружается из формы. В зависимости ** п от условий можно загружать различные субформы.
*Ж« * fcJ"4te«H«tq3№
о «> i« ' s.ji& 1 iftjfirt} * >
Таблица символов Lotus Таблица символов, которая поддерживается LICS International LN/Domino. ~ ! Character Set '< *'5 ''" ' ' "'"' Ґ
-rj * (LICS) ' '*' * l 4" ^i^«iyniТревог и гдьд'Ш Alarm Механизм, с помощью которого осуществляется: оповещений механизм ***' *""' w"vt *w <3 v для конечных пользователей - напоминания о событиях в его личном календаре;
для администраторов - документ, создаваемый
серверной задачей "Reporter" или "Collector" в
<-{fj,sp сч/ш?*ял$Д1йа ,^^ .. , „„ „ _ s бше данных Statistics , и сообщающий о
превышении для отслеживаемого параметра порогового значения (например, о свободном дисковом пространстве). Для настройки
© InterTrust Со. Тел (095)9567928

Lotus Domino R. 5: @гформулы, LotusScript, встроенные классы LotusScript и Java 919
мни, > ^ „ администраторского механизма тревог и ,м д, ,, UN(T,, оповещения необходимо создание документа "Statistics Monitor" в базе данных "Statistics & Events"
г?., .. ** " у > . ,а*щ®Ф
V f* SX ХГ.
Универсальный Uniform Представляет собой Интернет адрес для документа, локатор ресурса resource locator файла или другого ресурса. Он описывает протокол (URL) необходимый для доступа к ресурсу, имя узла, где Л* ь> ' f/ он находится и путь к ресурсу в рамках узла.
Универсальных Universal Набор кнопок, с помощью которых можно навигаторов navigation осуществлять перемещение по LN и Internet линейка buttons страницам (предыдущая страница, следующая страница, поиск, и т.д.). Дизайн их похож на соответствующие навигаторы в браузерах. Расположены в правом верхнем углу экрана на уровне системного меню. ~ \
i ф
f tiy.TV «fSRfKJRtt *t »ei
$Файл desktop.dsk Desktop.dsk Системный файл LN, содержащий настройки рабочего пространства клиентской программы LN.
Файл NOTES.INI NOTES.INI Системный файл LN/Domino, в котором хранятся
«,»,.„ . настройки рабочей станции или сервера,
ЙСД, s^.FSiisVC-flJfiii » «
консольные команды сервера и параметры чч*?е< вш« ^^ « г г г г ^ установки.
Файрвол f Firewall Система, предназначенная для управления доступом к приложениям или сети. Обычно файрвол управляет неавторизированным досгупом к w4W3mKjnc/ еид чл-s внутренней локальной сети из Интернета. *
Форма Form Элемент дизайна базы данных, представляющий собой бланк для ввода, чтения, редактирования и адкздо, эфю 8пд кэто^, di«otiOH кадот печати документов определенного типа. Форма з$к& о'гоыаад. может содержать иоля, статичный текст, графические и специальные объекты. В базе данных , t * г рэт^ ' может быть несколько форм.
Форма, Response-to- Форма, предназначенная для создания ответного на используемая для response form главный документ или документ-ответ. создания ,пон ggqojf документов ответ ^ л ncTJyu ^ на ответ .^- ч^Т Форма, Main form Форма, которая предназначенная для создания
используемая для основного документа. создания основных документов . „
Форма, Response form Форма, предназначенная для" создания ответного на используемая для основной документ. создания ответных ВИ1: документов гл MOWfistM.*
*<г* -" *5^ *» ч5 ^* ' д *
© InterTrust Со. Тел (095) 9567928

920 Lotus Domino R. S: (^-формулы, LotusScript, встроенные классы LotusScript и Java
Форма, Default form Форма, предназначенная для показа документов, у используемая по которых форма для вывода не определена или умолчанию ' недоступна.
Форма, Stored form Форма, по которой документ был создан или сохраняемая в отредактирован, запоминается в базе данных документе LN/Domino вместе с документом. Применяется в основном для отправки документов по почте.
Формат ODS On Disk , 'J,./ Формат, в котором базы данных LN/Dommo Structure (ODS) сохраняется на диске. Так же называется формат базы данных. В LN/Domino R5 настоящая версия }' 'ЛЛ <-Я ODS отображается на закладке Info окна свойств базы данных. mn
Л>
Формула, @- Formula Выражение, имеющее определенное сходство с формула ( , программой. Например, с помощью формул можно ***''' присвоить переменным значение, ограниченно управлять порядком выполнения входящих в нее операторов. В LN версий 3.x язык формул был единственным средством разработки приложений. В некоторых элементах дизайна (например, формула колонок вида) до сих пор можно использовать только язык формул.
Формула * Hidden @-формула, которая используется для видимости абзаца paragraph определения видимости абзаца. - .-ч formula
Формула Show action @-формула, которая используется для определения видимости акции formula видимости кнопки-акции.
Формула Formula pop-up @-формула, которая используется для определения всплывающего текста всплывающего окна окна «ячздх|П ,хинн&Ь *-*&о ; ^ шщиФ
Формула Computed field @-формула, которая используется для определения вычисляемого formula значения вычисляемого поля.
поля _„ _ „ ^,,„ ,. , ,,„ ,_ , ,,-(1 Лф ,,^ $ес,,г ,
Формула Insert subform @-формула, которая используется для определения вычисляемой formula имени загружаемой субформы. * ^мцяФ субформы - «trn,.«nvc,
Формула доступа Section access @-формула, которая используется для определения, к секции formula кто может иметь доступ к секции.
Формула Window title @-формула, которая используется для определения заголовка окна formula заголовка окна. *" " *'*' евяч,у*р
\ X.
Формула Section title @-формула, которая используется для определения заголовка секции formula заголовка секции.
Формула Image resource @-формула, которая используется для определения загружаемого formula имени загружаемого ресурса изображения. изображения
Формула значения Keywords field @-формула, которая используется для определения поля ключевых formula значения поля типа ключевые слова. слов > ,%-»
1 < S. v "ь «*
© InterTrust Со. Тел (095)9567928

Lotus Domino R. 5: @гформулы, LotusScript, встроенные классы LotusScript и Java 921
Формула значения Default value @-формула, которая используется для определения поля по formula значения редактируемого поля по умолчанию. умолчанию ' -f "
Формула колонки Column formula @-формула, которая используется для определения * информации выводимой в колонке вида или папки.
Формула отбора Selection @-формула, которая используется для отбора formula документов в вид. Должна возвращать булевское
значение для каждого документа в базе. »й -'.'Лад-Д} -wsC; '" f»n-Формула Input- @-формула, которая используется для
преобразования translation преобразования введенного значения значения поля formula редактируемого поля.
Формула проверки Input-validation @-формула используется для проверки введенного введенного formula значения редактируемого поля по заданным значения поля правилам.
Формула Replication @-формула, которая используется для ограничения селективной formula числа документов участвующих в репликации. репликации „ Должна возвращать булевское значение для
каждого документа в базе.
j
Формула формы Form formula @-формула, которая используется для определения имени формы.
Формы статичный Static text Элемент дизайна формы, представляет собой текст неизменяемый (в отличие от полей) текст для всех а Й1,. документов, созданных по этой форме.
Фрейм Frame Элемент дизайна базы данных, представляющий собой одну панель или секцию окна набора ягнв.лшп.о. фреймов, в каждой из которых можно осуществлять н независимую от других фреймов "прокрутку" ° информации. Каждый фрейм представляет из себя ом либо другой элемент дизайна базы данных (форма, HUtHu.Oi! папка, страница, документ, вид, навигатор или 6Г другой набор фреймов), или URL-ссылку, или Web-
°-c«owf страницу, шсашя * j Набор фреймов и фреймы поддерживаются в LN/Domino только с версии 5.
Функция, @- , @function Встроенные @-формулы языка формул для функция автоматического выполнения определенных операций.
(л Ч
Циркулярное Broadcast Приглашение и уведомление о встрече, которое не оповещение о meeting нуждается в подтверждении от приглашенных встрече