Язык @-формул в LotusDomino R 6.

Функции, определяющие тип и характеристики используемого программного обеспечения


@ClientType

Область применения: нельзя использовать в формулах отбора, колонок, редактируемых, секциях заголовка окна. При использовании в формулах фоновых агентов всегда возвращает значение "None".

Возвращает текстовую строку "Notes", если для доступа к базе данных используется клиентская программа LN, "Web" - в случае использования браузера. Очень часто применяется в формулах видимости объектов, для скрытия не работающих в браузерах компонент.

Пример. При использовании в формуле видимости объекта, скрывает его при работе в браузере.

@If( @ClientType = "Web"; 1; 0 )

@Platform           @Platform( [SPECIFIC] )

Область применения: без ограничений. При использовании в формулах отбора, колонок и фоновых агентов возвращает платформу, согласно местонахождению базы данных. Для серверных баз данных - платформу сервера, для локальных баз данных соответственно платформу клиента LN. В остальных формулах возвращает серверную платформу. В Web-приложениях возвращает только серверную платформу.

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

При использовании флага [SPECIFIC] возвращаемое значение обычно представляет собой текстовый список, состоящий из имени первичной операционной системы, версии первичной операционной системы, имени вторичной операционной системы и версии вторичной операционной системы. Так, например, для Windows 3.11, которая запускается из-под MS-DOS 6.22, функция вернет список: "Windows/16":"3.11":"MS-DOS":"6.22".

Для UNIX-платформ возвращается только имя операционной системы без ее версии.

При вызове без параметра возвращаемое значение может быть одним из следующих: Windows/16, Windows/32, MS-DOS, OS/2v1, OS/2v2, OS/400, Macintosh, UNIX, NetWare.


При использовании флага [SPECIFIC] имя имени первичной операционной системы может быть одним из следующих: Windows/16, Windows/95, Windows/NT, MS-DOS, NetWare, Macintosh/68K, Macintosh/PowerPC, OS/2v1, OS/2v2, IBM OS/400, IBM OS/390, AIX, UNIXWARE, HP UNIX, SUN Sparc, SOLARIS x86, SOLARIS Sparc, SCO OpenDeskTop, Linux.



Пример. Может вернуть значение "Windows/NT" : "5.0".

@Platform( [SPECIFIC] )

@Version

Область применения: без ограничений. При использовании в формулах отбора, колонок и фоновых агентов возвращает версию Lotus Notes/Domino, согласно местонахождению базы данных. Если она находится на сервере, то для сервера, и для локальной базы данных соответственно версию клиента LN. В остальных формулах возвращает версию рабочей станции.

Возвращает текстовую строку соответствующую релизу версии Lotus Notes/Domino согласно следующей таблице:

Возвращаемое значение

Соответствует версии Lotus Notes/Domino

114

Lotus Notes 3.x

136

Lotus Notes 4.0 - 4.0x

138

Lotus Notes 4.1 - 4.1x

145

Lotus Notes 4.5 - 4.5x

147

Lotus Notes 4.6

166

Lotus Notes 5.0 – 5.0x

184

Lotus Notes 6 пререлиз 1

189

Lotus Notes 6 Gold Candidate

190

Lotus Notes 6

Функция может использоваться в целях обеспечения переносимости программного обеспечения.

Пример. В формуле поля, выполяняющейся на станции с установленной версией Notes/Domino R 6.0.1 вернет "190".

@Version

@RegQueryValue( "имя_ключа"; "имя_подключа";

                               "имя_значения" )

Область применения: В DOMINO R 6.0.1 НЕ ДОКУМЕНТИРОВАНА.

Для не Windows-платформ возвращает пустую строку.

Возвращает значение ключей из Windows-реестра.

Пример. Может вернуть "C:\Lotus\Notes"

@RegQueryValue("HKEY_LOCAL_MACHINE";

   "Software\\Lotus\\Notes\\5.0"; "Path");

@IsAppInstalled( "имя_клиентского_ПО" )

Область применения: нельзя использовать в формулах отбора и редактируемой секции.



Функция, в зависимости от параметра "имя_клиентского_ПО", возвращает 1 (TRUE), если данное программное обеспечение установлено на рабочей станции, и 0 (FALSE) в противном случае.

Параметр "имя_клиентского_ПО" может принимать значение "Designer" соответствует дизайнерскому ПО, и "Admin" - администраторскому ПО.

Пример. Возвращает 1, если на рабочей станции установлено дизайнерское ПО.

@IsAppInstalled( "Designer" )

@BrowserInfo( "имя_свойства")

Область применения: нельзя использовать в формулах отбора, колонок и агентов. Не работает в клиенте Notes ниже 5-й версии.

Определяет и возвращает параметры используемого браузера. Возвращаемое значение определяется согласно таблице:

Имя свойства

Тип возвращаемого значения

Возвращаемое значение для браузера

Возвращаемое значение для клиента LN

BrowseType

Текстовое

"Microsoft",

"Netscape",

"Compatible" (для браузеров совместимых с Netscape, включая Notes Navigator 5.0),

"Unknown".

"Notes"

Cookies

Логическое

1 (True), если браузер поддерживает режим Cookies, 0 (False) в противном случае.

0 (False)

DHTML

Логическое

1 (True), если браузер поддерживает режим Dynamic HTML, 0 (False) в противном случае.

0 (False)

FileUpload

Логическое

1 (True), если браузер поддерживает режим загрузки файлов, 0 (False) в противном случае

0 (False)

Frames

Логическое

1 (True), если браузер поддерживает режим тегов <FRAME> в HTML, 0 (False) в противном случае.

1 (True)

Java

Логическое

1 (True), если браузер поддерживает режим Java апплетов, 0 (False) в противном случае.

1 (True)

JavaScript

Логическое

1 (True), если браузер поддерживает язык JavaScript, 0 (False) в противном случае.

1 (True)

Iframe

Логическое

1 (True), если браузер поддерживает режим тегов Microsoft <IFRAME> в HTML, 0 (False) в противном случае.

0 (False)

Platform

Текстовое

Операционная платформа, под управлением которой в настоящее работает браузер:

"Win95",

"Win98",

"WinNT',

"MacOS",

"Unknown".

"Unknown"

Robot

Логическое

1 (True), если браузер может выступать в качестве Web-автомата, 0 (False) в противном случае.

0 (False)

SSL

Логическое

1 (True), если браузер поддерживает режим SSL, 0 (False) в противном случае.

0 (False)

Tables

Логическое

1 (True), если браузер поддерживает режим тегов <TABLE> в HTML, 0 (False) в противном случае.

1 (True)

VBScript

Логическое

1 (True), если браузер поддерживает язык VBScript, 0 (False) в противном случае.

0 (False)

Version

Числовое

Номер версии для браузера, или -1, если она не определяется.

Номер версии для клиента LN

Функция может использоваться в целях обеспечения переносимости программного обеспечения.


Содержание раздела