【非公開関数】@ExpandNameListを検証
先日報告 しました@ExpandNameListという非公開関数(Undocumented Funciton)ですが、少し試してみることにします。
前回の報告のように、引き渡すGroup名は単純なStringではなく、String Listを渡しても処理できることが分かっています。
これにより、MailのInput Fieldである、EnterSendTo、EnterCopyTo、EnterBlindCopyToを渡せば容易に宛先FieldのGroup Entryを展開することが出来ます。
その前に、まず理解して頂きたいことがあります。
Notes Mail 9やNotes Mail 8.5では、基本的にPersonal AddressbookのGroupは標準で展開するように出来ています。
個人グループを宛先に設定して、F9を押すと展開されることが分かるでしょう。
F9を押さなくても、送信時に自動的に展開されます。
これは、現在のTemplateでは個人AddressbookのGroupは自動展開するのが標準になっているからです。
NotesのUIで解説すると、Mail 送信時のOptionに以下の項目があり、Defaultで個人Groupを展開するようになっていることが分かります。
このOptionをCheckすると、F9を押しても個人Groupの展開は行わなくなります。
このOptionは、Mail Memo Formの中でControleされていて、ExpandPersonalGroups Fieldの値で判断されています。
この値は、Defaultで"1"に設定されている為、F9で自動展開される動きをしているのです。
MailのMemo Formとかの設計を参照すると分かりますが、このDefaultを変更することも可能になっています。
TemplateのFieldの値は以下となっていますので、Notes.iniに$CollapsePersonalGroups=1があれば、送信Optionの設定のDefaultが変わるのです。
coll := @Environment("CollapsePersonalGroups");
@If(coll = "1"; "0"; "1")
このように、Userの設定によって、個人Groupが展開されるかどうかが決まってしまう訳で、送信先が許可されたAddressであるかどうかのCheckを行っているような場合は、これが問題となる訳です。
そこで登場するのが、今回の@ExpandNameListです。
この隠し@関数は、Userの設定とは関係なく、指定したAddressbookのGroup情報を使って、Groupを個人に展開してくれます。
それもList形式のField(Notesの名前Field)を渡せる訳ですから、EnterSendTo、EnterCopyTo、EnterBlindCopyToをCheckすることが出来るのです。
評価するために、MailのMemo Formに以下の内容のButtonを記述してみます。
FIELD EnterSendTo := @OptimizeMailAddress(@ExpandNameList("":"names.nsf" ; EnterSendTo));@True
このButtonは個人のAddressbookのGroupを強制的に展開し、EnterSendTo Fieldに展開結果を設定します。
個人AddressbookのGroupには以下のように登録しています。
Group1にはInternet Addressのみ、Group2にはInternet AddressとNotesの別名ID、個人AddressbookのUserとなっています。
Testですので、Mailの送信Optionで個人Groupの展開は禁止しておきます。
この時点でF9を押してもGroupが展開されないことを確認します。
新しく設定した「グループ展開」Buttonを実行すると、実行結果は以下のようになります。
個人Groupは展開され、Groupの中に設定されていた、個人宛先も正しく展開されています。
ところが、個人Groupに設定してあったNotesの別名IDが基本名になって展開されています。
ここでF9を押すと、以下のようにNotesIDは別名に変換されます。
つまり、@ExpandNameListはGroupをAddressに展開しますが、Group Memberを展開し、更にGroup MemberのAddressまでCheckして全てをValidなAddressに展開してくれるという訳ですが、Locationが別名表示になっていても別名を返して来ることはないということです。
F9を押す前でもMail送信すれば、F9を押したのと同じ状態になり、別名がSetされてMail送信が行われますが、別名を利用しているUserにとっては不便です。
そこで、F9を押したのと同じ状態にするために、Button式を以下のように変更します。
FIELD EnterSendTo := @OptimizeMailAddress(@ExpandNameList("":"names.nsf" ; EnterSendTo));
@Command([ViewRefreshFields])
これでButtonを押しただけで、Notesの別名Userは別名に展開されてEnterSendToに設定されます。
皆さんも、この@関数が搭載される前には、自作でGroup展開ボタンを作成されたこともあると思いますが、GroupはNestすることも出来、これを最後まで展開するのはかなり面倒な処理ですが、この@関数だとNest Groupであっても一発で展開してくれます。
更に、個人Addressbookに登録した個人連絡先(Nickname登録)も正しくAddress展開してくれるのです。
これはかなり便利に使えるのではないかと思います。
この処理ですが、ButtonであればUserが操作しない限り、展開が行われない訳です。
これでは、常に個人Groupを展開して送信させることは出来ないでしょう。
では、この処理をEnterSendTo Fieldの入力変換式に記述します。
Notes 9 Templateでは変換式が設定されていますので、以下のように修正します。
CopyInto:=@Environment("tmpCopyMail");
@If(CopyInto = "1"; @SetEnvironment("tmpCopyMail";""); "");
@If(CopyInto = "1";
@If(NamePreference="1" & AltSendTo !="" ; @OptimizeMailAddress(AltSendTo) ;
@OptimizeMailAddress(EnterSendTo))
;@OptimizeMailAddress(EnterSendTo))
;@OptimizeMailAddress(@ExpandNameList("":"names.nsf" ; EnterSendTo))
これで、UI画面でF9を押しても、F9を押さずにMailを送信しても以下のように個人Groupが展開されて送信されるようになります。
勿論、ServerのNames.nsfのGroupの展開が必要な場合は、ServerのNames.nsfを指定してEnterSendTo Fieldを渡してやれば展開できます。
このGroup展開が強制されている状態であれば、Memo FormのQuerySendで送信先が禁止送信先を含んでいないかのCheckも適切に行えるのではないかと思います。
Undocumented Functionですが、かなり便利に使えますし、Mail Tempalteの中でも使われている@関数ですので、Mail Templateの互換性を重視した開発が行われている限りは使える関数だと思います。
蛇足ですが、LotusScriptでEvaluateして使っても問題はありません。
ただ、LotusScriptでField値を無理やり置換するような場合は、Address Listの戻り値が別名ではなく、基本名ですので、別名が必要な場合には別名変換する処理が必要になりますので、ご注意ください。
@ExpandNameList(AddressbookPath;GroupName)
以前、紹介したことがある隠し関数 ですが、久々に利用してみて気が付きました。
この隠し@関数は様々なSiteでも紹介されていると思いますが、使い方は以前も紹介した通り、以下の通りです。
@ExpandNameList(<Server Name>:<Addressbook File Path> ; <Group Name>)
この<GroupName>の部分ですが、私はStringしかダメなのだと思い込んでいましたが、Listでも正常に処理するようです。
個人Addressbookに複数のGroup(この例では、"Group1"と"Group2")を登録して、
@ExpandNameList("":"names.nsf" ; "Group1":"Group2")
のようにすると分かると思います。
簡単に試すなら、Local AddressbookにGroupを登録し、Mail DBを開いて新規メールを作成し、Subject Fieldに式を書いてShift+F9すると分かります。
これが可能だと言うことは、EnterSendToやEnterCopyTo、EnterBlindCopyToの値をそのまま渡して、Group展開が可能となります。
動作確認はNotes 9.0.1でしか行っていませんが、多分、8.5.xでも大丈夫だと思われます。
また、機会があれば、詳細に検証してみたいと思います。
iNotes 9をCustomizeしてみよう! -2-
<話題の履歴>
前回は、iNotes 9をCustomizeするための環境を構築しました。
今回は、実際にiNotesのCustomizeを行って行きたいと思いますが、iNotes 9のCustomizeをするにあたって少し知っておかなければならないことがあります。
まずは、どのようなFormが使われるのかを理解します。
iNotesで基本的に使われる基本FormはForms9.nsfにListされています。
Forms9.nsfをNotes Clientで開いて、System\Forms Viewを開くと、以下のように表示されます。
「s_」で始まるFormが基本的にClassic UIを使っている物、「l_」で始まる物がLite UIを使っている物となっており、これを見ると、「l_」で始まるFormが少ないことが分かります。
次に、DWA 7の時代から、iNotesには独自の略号のFunctionやVariableが提供されており、Codeはこの独自の略号で書かれています。
このCodeが曲者で、英字2-3文字のFunction名やVariable名となっていて、一体なのか?理解が出来ないのです。
Codeの容量を節約するために、このようなCodeになっているようです。
このCodeに関しても、Forms9.nsfのResource\Fileに「ObfuscationList.txt」として提供されており、内容は以下のようになっています。
============================================================
The keys on the left have replaced the following functions and variables in DWA code:
============================================================
AA IWAOfflineCtrl_DoInstall
AAA com_ibm_dwa_globals
AB getViewList
AC bEditable
AD refreshtree
これを見たから内容が理解できるというものではありませんが、iNotesのCodeではこの略号が多用されており、意味を理解する為にも、このTextをText EditorにCopyしていつでも検索して参照できるようにしておいた方が便利です。
Functionの引数などが解説されている訳ではありませんので、実際の使い方はCodeを参考にして使うしかありません。
最後に、iNotesで使われる日本語Textですが、これもDWA 7の頃はCodeの中に直接書かれていましたが、多言語対応翻訳を楽に行うためだと思いますが、Resourceとして提供されるようになっています。
これに関しても、Forms9.nsfのResource\Fileに「dwa_ja.properties」として提供されており、内容は以下のようになっています。
#---------------------------------------------
# Shimmer
#
# Copyright (c)2000-2008 Iris Associates, Inc.
#---------------------------------------------
#---------------------------------------------------------------------------
# Localizable text used by Shimmer applications
#---------------------------------------------------------------------------
(中略)
# s_mailaddrobj.h
# s_MailMemoRead.nx, s_MailMemoEdit.nx
L_RE=Re:
L_RE_SHORT_UPPERCASE=RE:
L_FW=Fw:
L_FW_SHORT_UPPERCASE=FW:
L_TO=\u5b9b\u5148:
L_CC=Cc:
L_BCC=Bcc:
L_FROM=\u9001\u4fe1\u8005:
L_SUBJECT=\u4ef6\u540d:
英語の場合は直ぐに分かりますが、日本語の場合はUnicodeでEncodeされて格納されているため直ぐには分かりません。
この中身を見たり、語句を変更する場合は、Encode/Decodeを提供しているSite
を利用して理解する必要があります。
例えば、「L_SUBJECT=\u4ef6\u540d:」をDecodeしてみると、以下のようになります。
書き換える際も、UnicodeでEncodeしてこのFileを変更する必要がありますし、独自の定数を定義したい場合もこのFileに追加することで参照が出来るようになります。
今回は、最初に最低限理解しておかなければならない項目について簡単に解説しました。
次回は、Custome_JSやCustome_JS_Lite Subformで提供されているSample Codeを動かしながら中身を見てみます。



