notes函数.docx
- 文档编号:14720176
- 上传时间:2023-06-26
- 格式:DOCX
- 页数:43
- 大小:38.87KB
notes函数.docx
《notes函数.docx》由会员分享,可在线阅读,更多相关《notes函数.docx(43页珍藏版)》请在冰点文库上搜索。
notes函数
@MailDbName3
傳回Domino伺服器的名稱和目前使用者「電子郵件」資料庫的名稱。
3
@Member3
給予一個值,找出它在文字串中的位置。
3
@UpperCase4
將指定字串中的小寫字母轉換成大寫。
4
@LowerCase5
將指定字串的大寫字母轉換成小寫字母。
5
@ProperCase5
將字串中的字轉換成適當的大小寫:
每個字的第一個字母變成大寫,其他字母變成小寫。
5
@Name6
讓您處理有階層的名稱,您可以將標準格式的名稱縮寫、將縮寫名稱展開成標準格式、辨識名稱中的特殊元件、使元件反序以便按階層名稱將視界分類。
6
@UserName8
傳回目前使用者的名稱或伺服器名稱。
8
@V3UserName9
傳回目前使用者名稱或伺服器名稱。
在本區資料庫,或是在伺服器端的資料庫的專用視界內使用@V3UserName,會傳回使用者的名稱。
9
@Prompt10
顯示一個對話方塊給使用者,並依據使用者在對話方塊中的動作傳回文字值。
@Prompt非常有用,可以提示使用者資訊並依據使用者的輸入來決定要執行那些動作。
10
@Right13
傳回字串中最右邊的字元,您可以指定要傳回的最右邊字元的數目,或者您要將指定子字串右邊的所有字元都傳回來。
14
@Left14
由左至右搜尋字串並傳回字串最左邊的字元。
14
@DbLookup(Notes資料庫)15
提供一關鍵字,在指定的視界(或資料夾)中查詢,然後尋找該視界中第一個排序過欄位含有此關鍵字的所有文件。
至於所選的文件,@DbLookup會傳回視界中特定欄位的內容,或指定欄位的內容。
15
@If19
評估一個條件;如果這個條件為「真」,Notes就執行顯示在該條件後面的動作,並停止評估。
但是如果條件為「假」,Notes就跳到下一個條件並加以測試,以此類推。
如果沒有條件為「真」,Notes就執行else_action。
19
@IsError20
如果值為@ERROR值就傳回1(真),如果不是錯誤就傳回0(假)。
20
@Elements21
計算清單中文字、數字或時間-日期值的個數,這個函數會傳回指示清單中詞項數目的數字。
21
@Unavailable21
利用這個函數來刪除欄位。
21
@PostedCommand22
執行一個Notes指令,所有的功能表標準指令都可以利用@PostedCommand來執行。
此外,一些特殊的指令也可以執行。
在公式中,任何利用@PostedCommand啟動的指令都會在公式的其他指令執行之後才被執行。
22
@Unique22
如果沒有參數,就傳回一個隨機的特別文字值。
如果有參數,則刪除文字清單中的重複值,只傳回清單中每個第一次出現的成員。
22
@Select23
傳回出現在number位置的值,如果number大於值的number,則傳回清單中的最後一個值。
如果在number位置的值是一個清單,則傳回包含在這個值之中的整個清單。
23
SELECT23
在執行公式的代理程式、視界中或在抄寫時,SELECT關鍵字用來定義文件的選擇規則。
您可以在一個表示式之前使用SELECT敘述句來定義您要變更、在視界中查看或抄寫的文件組。
23
ENVIRONMENT24
設定存在使用者NOTES.INI檔(Windows、OS/2和UNIX)的環境變數。
24
@Environment26
設定或傳回儲存在使用者NOTES.INI檔(Windows、OS/2和UNIX)中的環境變數。
26
@SetField27
指定一個值給儲存在文件中的欄位(暫時變數請用@Set),這類似於使用FIELD關鍵字,只是@SetField還可用於另一個@function中。
27
@Do28
由左至右執行表示式並傳回清單中最後一個表示式的值。
28
@Text28
將任何值轉換為文字串。
28
@Now30
傳回目前的時間-日期。
30
@MailDbName
傳回Domino伺服器的名稱和目前使用者「電子郵件」資料庫的名稱。
Ø語法
@MailDbNamereturns:
傳回的值
server;path
兩個元件的文字清單,server是目前資料庫所在的伺服器名稱,如果資料庫在本機上則為空字串;path為資料庫的目錄和檔案名稱。
Ø用法
除了欄位公式之外,這個函數可用於任何公式中。
當公式在伺服器上執行時,伺服器就被當作是目前的使用者,因此@MailDbName會傳回伺服器的名稱。
所傳回值的格式為,指定伺服器;目錄\資料庫.NSF兩項文字清單,如:
acmemail;legal\dlee.NSF
如果資料庫存在使用者自己的電腦上,Notes傳回的伺服器名稱為空字串。
例如,撥號使用者可以在她的工作站上保留她的「電子郵件」資料庫副本;當她設定為工作端的電子郵件時,@MailDbName會傳回:
;dlee.NSF
在Web應用程式中不可使用此函數。
Ø範例:
@MailDbName
&如果使用者的電子郵件存在使用者電腦的MTSEN.NSF資料庫中,而且使用者設定使用工作站端的電子郵件,則此範例會傳回;MTSEN.NSF。
&如果使用者的電子郵件存在SALES1伺服器MAIL目錄下的MTSEN.NSF中,而且使用者設定使用以伺服器端的電子郵件,則此範例會傳回SALES1;MAIL\MTSEN.NSF。
如果這個資料庫存在伺服器的根目錄下(也就是說它不是存在次目錄內),則其結果為SALES1;MTSEN.NSF。
&下面範例會傳回MTSEN.NSF檔案名稱,因為這是@MailDbName所傳回清單中的最後一個元件。
@Subset(@MailDbName;-1)
@Member
給予一個值,找出它在文字串中的位置。
Ø語法
@Member(value;stringlist)
Ø參數
value
文字,您要在stringlist中找出其位置的值。
stringlist
文字清單。
Ø傳回的值
position
數字,如果value不包含於stringlist中,傳回0,如果value包含於stringlist中,傳回1。
其中1至n是該value在stringlist中的位置。
Ø範例:
@Member
&此範例會傳回0。
@Member("Sales";"Finance":
"Service":
"Legal")
&如果欄位ReportName的值是欄位RequiredReading中所含清單的第12個值,則傳回12;否則就傳回0。
@Member(ReportName;RequiredReading)
@UpperCase
將指定字串中的小寫字母轉換成大寫。
Ø語法
@UpperCase(string)
Ø參數
string
文字,您要轉換成大寫的字串。
Ø傳回的值
uppercaseString
文字,所有字母都轉換成大寫之後的string。
Ø範例:
@UpperCase
&此範例會傳回ROBERTT.SMITH。
@UpperCase("RobertT.Smith")
&如果State欄位包含"ma","Ma"或"MA",則會傳回MA。
@UpperCase(State)
&此範例會傳回FLETCHER,如果“WilliamFletcher“是和使用者識別碼相關的名稱,@UpperCase和@Right使用結合方式找到使用者的姓並只轉換使用者的姓。
@UpperCase(@Right(@UserName;""))
@LowerCase
將指定字串的大寫字母轉換成小寫字母。
Ø語法
@LowerCase(string)
Ø參數
string
文字,您要轉換成小寫字母的字串。
Ø傳回的值
lowerCaseString
文字,轉換成小寫字母之後的sting。
Ø範例:
@LowerCase
&此範例會傳回juanmendoza。
@LowerCase("JuanMendoza")_)
&如果Furniture欄位包含"ArmChair","Armchair","armchair",或"ARMCHAIR"或其他的變化字,此範例會傳回
armchair。
@LowerCase(Furniture)
&如果WilliamFletcher是與目前使用者識別碼相關的名稱,則此範例會傳回fletcher。
@LowerCase(@Right(@UserName;""))
@ProperCase
將字串中的字轉換成適當的大小寫:
每個字的第一個字母變成大寫,其他字母變成小寫。
Ø語法
@ProperCase(string)
Ø參數
string
文字,您要轉換的字串。
Ø傳回的值
properString
文字,轉換成適當大小寫的string。
Ø用法
一個字就是其間沒有空格的連續字元組,用連字號連接的字會被當作是兩個字,以其他標點符號分隔的字也一樣,只有撇號例外。
Ø範例:
@ProperCase
&此範例會傳回EveryChildLovesToys。
@ProperCase("everyCHILDLOvestoys")_)
&此範例會傳回3-digitCode。
@ProperCase("3-digitcode")_)
&如果欄位City所含的字串為losangeles、LosAngeles、LOSANGELES、losAngeles或其他變化字,則傳回LosAngeles。
@ProperCase(City)
@Name
讓您處理有階層的名稱,您可以將標準格式的名稱縮寫、將縮寫名稱展開成標準格式、辨識名稱中的特殊元件、使元件反序以便按階層名稱將視界分類。
Ø語法
@Name([action];name)
Ø參數
&[action]
指示您要對名稱所做的事-是否要將它展開、縮寫等等(請參閱下文可能的動作清單)。
&Name
文字或名稱,使用者或伺服器名稱,可用任何格式輸入。
Notes會決定完全的階層名稱,然後傳回所要的元件。
&您可以用@Name在階層名稱中執行下列的動作:
✓[A]
傳回ADMD元件(執行管理網域名稱)。
✓[Abbreviate]
縮寫階層名稱,刪除元件的標籤。
這能夠節省顯示的空間,看起來更加友善。
✓[C]
傳回階層名稱的國家元件。
✓[Canonicalize]
展開縮寫的名稱,加入遺失的元件及標籤。
✓[CN]
傳回名稱的階層式名稱元件。
✓[G]
傳回指定名稱的元件(名)。
✓[I]
傳回姓氏元件。
✓[O]
傳回階層名稱的組織元件。
✓[OUn]
傳回名稱的指定組織單元元件;n可以由1到4,如OU1。
在名稱的標準格式中,OU元件並未編號;但是它們會右至左計算將第一個出現的OU標籤當作是OU1,第二個出現的當作是OU2,以此類推。
Notes不會接受[OU]作為關鍵字。
✓[P]
傳回PRMD元件(私人管理網域名稱)。
✓[Q]
傳回衍生元件(如“Jr“)。
✓[S]
傳回姓氏元件(姓)。
✓[ToKeyword]
使名稱元件反序顯示,並將斜線以反斜線取代:
國家\組織\組織單元...,當您要以使用者階層名稱的元件將視窗分類時這就很有用(反斜線代表視窗的子類別)。
[ToKeyword]選項不會傳回使用者名稱的「共同名稱」部分。
Ø用法
@Name用於視窗中縮寫階層名稱特別有用。
階層名稱是以一系列的元件來判定,這些元件能辨識全名、組織單元、組織和國家。
使用階層名稱可以保證每個使用者和伺服器都有不同的名稱。
作為一個資料庫的設計者,您負責控制使用者名稱如何輸入,並將它顯示在Notes應用程式中。
為了簡化起見,您應該允許使用者以縮寫格式輸入其名稱;然後用@Name將其名稱展開成標準格式。
同理,您應該以縮寫格式來顯示名稱,使用@Name將儲存的名稱標準格式轉換成縮寫格式。
當您使用Names、Readers或Authors欄位時,Notes會自動將階層名稱轉換成適當的格式以便顯示和儲存。
如果使用者輸入縮寫名稱,在儲存時Notes會將它展開成標準格式;名稱會一直以縮寫格式來顯示。
當您在視界中顯示階層名稱欄位的內容時,它不會自動轉換;會顯示名稱的完整標準格式。
您可能必須以@Name將名稱轉換成縮寫格式。
Ø範例:
@Name
&此範例會傳回MaryTsen/Illustration/Documentation/Development/R&D/WorkSavers/US。
@Name([Abbreviate];AUTHOR)
如果使用者正在查看的文件的AUTHOR欄位含MaryTsen名稱的階層格式。
&此範例會傳回MaryTsen。
@Name([Canonicalize];"MaryTsen")
因為沒有斜線跟在名稱後面,它就是非階層名稱,沒有其他元件。
&此範例傳回CN=MaryTsen/OU=Illustration/OU=Documentation/OU=Development/OU=R&D/O=WorkSavers/C=US。
@Name([Canonicalize];"MaryTsen/")
&此範例傳回MaryTsen。
@Name([CN];AUTHOR)
&此範例傳回Development。
@Name([OU2];AUTHOR)
&此範例傳回US\WorkSavers\R&D\Development\Documentation\Illustration;注意到斜線現在是反斜線,允許指定的元件可以在視界中當做子類別來用,請記得不會傳回階層式名稱的元件。
@Name([ToKeyword];AUTHOR)
@UserName
傳回目前使用者的名稱或伺服器名稱。
Ø語法
@UserName
Ø傳回的值
name
文字,目前使用者的名稱或伺服器名稱。
Ø用法
當公式在伺服器上執行時,伺服器就被當作是目前的使用者,因此@UserName會傳回伺服器的名稱。
我們不建議將@UserName用於公用視窗中,這樣做可能會造成無法預期的結果。
@UserName的一個用途是用來顯示和目前使用者相關的文件,例如,您的「服務要求」資料庫可以在稱為Assignments的私用視窗中使用@UserName來顯示每個技術人員的指定工作,去除其他顯示:
SELECT@UserName=AssignedTo
然而使用者仍然可以設計不同的私用視窗來取得所有的文件,因此不要仰賴@UserName作為安全機構。
Ø範例:
@UserName
&如果RobertT.Smith是相關於目前使用者識別碼的名稱,則此範例會傳回RobertT.Smith。
@UserName
&如果WilliamFletcher是相關於目前使用者識別碼的名稱,則此範例會傳回Fletcher。
@Right(@UserName;"")
&如果WilliamFletcher是相關於目前使用者識別碼的名稱,則此範例會傳回FLETCHER。
@UpperCase(@Right(@UserName;""))
&此範例會傳回名稱的標準格式。
給予階層式使用者ID:
CN=MaryTsen/OU=Illustration/OU=Documentation/OU=Development/OU=R&D/O=WorkSavers/C=US
&若要傳回名稱的縮寫格式(省略CN、OU、O和C等識別字),請使用@V3UserName。
@V3UserName
傳回目前使用者名稱或伺服器名稱。
在本區資料庫,或是在伺服器端的資料庫的專用視界內使用@V3UserName,會傳回使用者的名稱。
如果使用者名稱為階層式,則@V3UserName將傳回縮寫格式的名稱(省略CN、OU、O及C識別字)。
要傳回使用正規格式的名稱,請用@UserName。
ØNote
假如您在Notes的Release3中使用@UserName,便會在Release4中自動將它轉換成@V3UserName,以保留您原有公式的功能。
如果您將這些公式改成使用@UserName,請確定要在Release4下重新編譯它們。
如果您在Release4中使用@UserName,則Release3中建立的資料庫必須先升級為Release4,否則此資料庫將無法辨識該公式。
如果公式將在Release3中求解,請使用@V3UserName。
Ø語法
@V3UserName
Ø回覆值
name
文字。
目前使用者名稱或伺服器名稱。
Ø用法
當公式在伺服器上執行時,該伺服器會被視為是目前的使用者,因此@V3UserName將傳回伺服器的名稱。
不過,我們不建議您在公用視界中使用@V3UserName。
這麼做可能會導致無法預期的結果。
@V3UserName的用途之一是只顯示與目前使用者相關的文件。
例如,您的ServiceRequest(服務要求)資料庫可能在命名為Assignments(指定工作)的專用視界中使用@V3UserName,顯示每一位技術人員的指定工作(並略去其他人的資料):
SELECT@V3UserName=AssignedTo
不過,使用者仍可設計不同的專用視界,擷取所有的文件。
因此,不要依賴
@V3UserName作為安全機制。
Ø範例:
@V3UserName
&@V3UserName會傳回RobertT.Smith,如果它是與目前的使用者ID相關的名稱。
&@Right(@V3UserName;"")會傳回Fletcher,如果WilliamFletcher是與目前的使用者ID相關的名稱。
&@UpperCase(@Right(@V3UserName;"")會傳回FLETCHER,如果WilliamFletcher是與目前的使用者ID相關的名稱。
&給定階層式使用者ID:
CN=MaryTsen/OU=Illustration/OU=Documentation/OU=Development/OU=R&D/O=WorkSavers/C=US
@V3UserName會傳回名稱的縮寫格式:
MaryTsen/Illustration/Documentation/Development/R&D/WorkSavers/US
如果要傳回名稱的標準格式(使用CN、OU、O和C等識別字),請使用@UserName。
@Prompt
顯示一個對話方塊給使用者,並依據使用者在對話方塊中的動作傳回文字值。
@Prompt非常有用,可以提示使用者資訊並依據使用者的輸入來決定要執行那些動作。
Ø對話方塊樣式的總結
此表格顯示了不同樣式的對話方塊,@Prompt接受參數並依據您指示的樣式傳回一個值。
樣式
目的
內容
傳回的值
Ok
顯示參考資訊
標題和提示
「確定」按鈕
1(真)
YesNo
允許使用者做是/否的決定
標題和提示
「是」和「否」按鈕
1(真,是)或0(假,否)
YesNoCancel
允許使用者做是/否的決定或取消
標題和提示
「是」、「否」和「取消」按鈕
1(真,是),0(假,否)或-1(取消)
OkCancelEdit
允許使用者鍵入文字
標題和提示-輸入的文字方塊
「確定」和「取消」按鈕
文字,使用者輸入的值。
OkCancelList
允許使用者由選擇清單中選擇一個值
標題和提示-選擇清單「確定」和「取消」按鈕
文字,使用者選擇的值。
OkCancelCombo
允許使用者由下拉式選擇清單中選擇一個值
標題和提示-下拉式選擇清單「確定」和「取消」按鈕
文字,使用者選擇的值。
OkCancelEditCombo
允許使用者由選擇清單中選擇一個值,或鍵入不同的值
標題和提示-具有文字方塊的下拉式選擇清單「確定」和「取消」按鈕
文字,使用者選擇或輸入的值。
OkCancelListMult
允許使用者由選擇清單中選擇多個值
標題和提示-選擇清單「確定」和「取消」按鈕
文字清單,使用者選擇的所有的值,以:
(冒號)連結。
LocalBrowse
允許使用者由本區檔案系統選擇檔案名稱
瀏覽本區檔案系統的控制及顯示
「選取」、「取消」及「網路」或「輔助說明」按鈕
文字。
使用者選取或輸入的檔案名稱或名稱。
多重名稱用空白隔開。
第一個名稱包含完整的路徑。
Password
允許使用者輸入密碼而不顯示在螢幕上
標題和提示-接受並隱藏使用者輸入的文字方塊「確定」和「取消」按鈕
文字,使用者輸入的密碼。
Ø語法
@Prompt([style]:
[NoSort];title;prompt;defaultChoice;choiceList;filetype)
Ø參數
[style]
常數,指示您要顯示的對話方塊形式。
可以是賞表列的任一值:
Ø[NoSort]
選用的關鍵字,如果您要choiceList依您輸入的順序顯示,就必須加上這個關鍵字。
如果您省略這個關鍵字,會依字母順序排列。
&title
文字,您要顯示在對話方塊標題列中的文字。
雖然您可以只是指定一個空字串,但是所有的styles都需要這些文字。
&Prompt
文字,您要顯示在對話方塊中的文字,所有的styles都需要這些文字,除了LocalBrowse。
如果您使用一個公式來出現prompt,而且那個公式會傳回一份清單,則只有該清單的第一個項目會顯示為Prompt。
若要顯示整個清單請使用@Implode。
@NewLine不能用於prompt中。
&DefaultChoice
文字,要作為使用者輸入預設值的值。
對話方塊的輸入選擇會先提供這個值;使用者可以選擇「確定」來接受這個值,或以另一個值來取代。
不可以用於style[Ok]、[YesNo]、[YesNoCancel]、[LocalBrowse]或[Password]的對話方塊中,其他styles都是必要的。
若是[OkCancelListMult],您可以指定多個預設值做為文字清單"item1";"Item2"。
&ChoiceList
文字清單,您要顯示在對話方塊的清單方塊中的值。
使用者可以選擇其中一個作為輸入,將這些值用:
號分開,如:
"PHONE.NSF":
@MailDbName。
清單中的每個值都可以為文字串,只有[OkCancelList]、[OkCanc
- 配套讲稿:
如PPT文件的首页显示word图标,表示该PPT已包含配套word讲稿。双击word图标可打开word文档。
- 特殊限制:
部分文档作品中含有的国旗、国徽等图片,仅作为作品整体效果示例展示,禁止商用。设计者仅对作品中独创性部分享有著作权。
- 关 键 词:
- notes 函数
![提示](https://static.bingdoc.com/images/bang_tan.gif)