不思議なGroup転送とLocation転送 -1-
皆さん、滅多に使われることは無いと思いますが、LocalのAddressbookに設定したLocationやGroupを他の人に転送してあげることができるようになっているのはご存知でしょうか?
例えば、LocalのAddressbookを開いて、Group Viewを開くと以下のAction Buttonが存在します。
同様にLocation文書の一覧でも以下のAction Buttonが存在します。
これらのButtonを使うと、個人で作成したGroupやLocation文書を他人に送信することが出来ます。
ButtonのICONや表示状態が異なるのは、Old UIとNew UIが混在しているという感じなので、ここでは笑って見過ごしましょう。
例えば、Groupの転送を行うと、以下のように文書が作成されます。
これを送信すれば、相手にGroupを送信できるというものです。
実際に送信を行ってみると、以下のようなMailが届きます。
このMailを開いてImportを行えば、個人Groupを別の人に送れるというものなのです。
さて、こんな機能だということは分かりましたが、私としては、ほんのちょっとしたことが気に入らないのです。
以下を良く見てください。
送信者Addressだけが位置が高く表示されている訳です。
設計を確認すると、このFieldだけOS Native Fieldで定義されています。
何の意図があってこのようになっているのでしょうか??
益々不思議な訳です。
普通のNotes Fieldで定義すれば、表示位置が微妙にズレたりしません。
また、このFormに設定されている、「送信」ボタンを見てみると、以下のようになっています。
Sub Click(Source As Button)
Dim Workspace As New NotesUIWorkspace
Dim uidoc As NotesUIDocument
Set uidoc = Workspace.currentdocument
Dim doc As NotesDocument
Set doc = uidoc.document
Dim y As Integer
doc.Sent = "Yes" 'DNT
Call doc.RemoveItem( "Type" )
Call doc.Send (True)
Forall x In doc.SendTo
y = y + 1
End Forall
Print xMsg & doc.ListName(0)
Call uidoc.CLOSE
End Sub
これは益々意味不明です。
特に以下は一体何の為なのでしょう??
Forall x In doc.SendTo
y = y + 1
End Forall
謎は深まるばかりです。
今回は、実験を通じでこの謎に挑戦したいと思います。
iNotes 9をCustomizeしてみよう! -5-
<話題の履歴>
前回は、Classic UIのMenu Position表示の確認とLite UIでのAction MenuのCustomizeのためのSample Codeを見てみました。
今回は、Lite UIのAction Menu CodeのSampleを実際に動かしてみたいと思います。
まあ、サンプルを動かすだけなので、つまらないとは思いますが、DWA 7の頃と異なり注意点があるようなので、それを簡単に紹介してみます。
Custome_JS_LiteのSampleには以下のようなCodeが紹介されています。
// Add to the mail view toolbar, only the normal one
if (-1 == s_MenuID.indexOf("mailview"))
return false;
var bLeftItems = true;
// Add menus and submenus
var aAdd1 = [
{title:"Hello world", find_id: "new", id: "hello1", before: true,
action:"com_ibm_dwa_ui_EXAMPLE_alert {sMsg: \'Hello1\'}", help_text:"some hover text" },
{title:"Sub menus", find_id: "new", id: "hello2", before: false,
action: "com_ibm_dwa_ui_EXAMPLE_alert {sMsg: \'Hello2\'}", help_text:"submenu hover text",
submenus: [
{title:"Selected docs",
action:"com_ibm_dwa_ui_EXAMPLE_actionSelectedDocs {}"},
{title:"Is view",
action:"com_ibm_dwa_ui_EXAMPLE_IsView {}"},
{is_divider:true},
{title:"Toggle Sidebar",
action:"EcV {sAction: \'toggle\'}"}
]},
{title:"Image", find_id: "hello2", id: "image1", before: false,
action:"com_ibm_dwa_ui_EXAMPLE_alert {sMsg: \'Icon and text\'}", help_text:"icon and text", img:"/iNotes/Forms9.nsf/commonactionicons.gif?OpenFileResource", img_width: 16, img_height: 16, x_offset: 48, y_offset: 0 },
{find_id: "image1", id: "image2", before: false,
action:"com_ibm_dwa_ui_EXAMPLE_alert {sMsg: \'Icon only\'}", help_text:"icon only", img:"/iNotes/Forms9.nsf/commonactionicons.gif?OpenFileResource", img_width: 16, img_height: 16, x_offset: 96, y_offset: 0 }
];
addActionsLite( s_MenuID, bLeftItems, aAdd1 );
注目頂きたいのは、以下の部分です。
action:"com_ibm_dwa_ui_EXAMPLE_alert {sMsg: \'Hello1\'}", help_text:"some hover text" },
わざわざFunctionを定義して、それをCallしてAlert Messageを表示するようになっています。
このFuncitonもSampleが提供されていて、以下のように書かれています。
function com_ibm_dwa_ui_EXAMPLE_alert(sId){
// This is an example of how to retrieve action Gkn
var o_ActionContext = ELU.EJs[sId];
alert(o_ActionContext.sMsg);
}
早速ここで、iNotes特有の書き方が現れました。
「ELU.EJs[sId]」の部分です。
さて、これを理解するには、以前の記事で紹介したForms9.nsfのResource\Fileの「ObfuscationList.txt」をCheckする必要があります。
Domino Designer自身でも検索は可能ですが、便利に使うにはこの「ObfuscationList.txt」をText FileにCopyしておいて参照すると便利だと思います(かなりの行数ですので)。
このListを参照すると、以下となっています。
Gkn params
ELU com_ibm_dwa_ui_invokeAction
EJs oContext
つまり、ELUというFunctionのContextにsMsgという値を設定して、この値をalertで表示するという内容です。
呼ぶ側では、
com_ibm_dwa_ui_EXAMPLE_alert {sMsg: \'Hello1\'}
となっていますので、sMsgの値として、"Hello1"を設定して渡していますので、このActionを押すと"Hello1"というAlertのPOPupが表示されるという訳です。
DWA 7の頃にCustomizeをされた方はご存知だと思いますが、Classic UIは普通にJavaScriptのalertだけでMessage表示が出来ましたが、Lite UIの場合は異なっています。
では、Sample Codeを元にして簡単なAction Menuを作ってみましょう。
まず、Alert Messageを出すためのFunctionをIBMのSampleを元に以下のように作成して、Custome_JS_Liteの最後に追加します。
function alertMsg(sId){
var o_ActionContext = ELU.EJs[sId];
alert(o_ActionContext.sMsg);
}
次に、Actionを定義します。
これも、IBMのSampleを元に以下のように作成してみます。
function Custom_Scene_Actions_Lite(s_MenuID)
{
if (-1 == s_MenuID.indexOf("mailedit"))
return false;
var bLeftItems = true;
var aAddMenu = [
{title:"新メニュー", find_id: "send$bold", id: "custom", before: true,
action:"alertMsg {sMsg: \'新規メニュー\'}", help_text:"新規ドロップダウンメニュー",
submenus: [
{title:"サブメニュー1",
action:"alertMsg {sMsg: \'ドロップダウンメニュー1\'}"},
{is_divider:true},
{title:"サブメニュー2",
action:"alertMsg {sMsg: \'ドロップダウンメニュー2\'}"}
]
}
];
addActionsLite( s_MenuID, bLeftItems, aAddMenu );
checkActionIDs( s_MenuID );
これは、s_MenuIDが"mailedit"を含んでいる場合に表示するメニューとしていますので、新規Mail作成時やMail返信時などMailが編集Modeの場合のみ表示されるMenuとなります。
MenuはMail編集時のTop Menuである「送信」ボタン(MenuIDは"send$bold")を見つけ、その左側(before: true)に新規メニューを挿入しています。
トップメニューのタイトルは「新メニュー」(title:"新メニュー")で、このボタンを押すと「新規メニュー」がAlert Messageとして表示されます。
また、サブメニューも二つあり、これもAlert Messageを表示するようになっていて、サブメニューの間にセパレーター(is_divider:true)を入れています。
最後に、checkActionsIDs( s_MenuID )を入れたことにより、MenuIDの表示は全体ではなく、Mail編集時のみに表示されるようになります。
変更が完了したら、Custome_JS_Lite Subformを保存して、CustomizeしたLocalのForms9_x.nsfをReplicaし、Domino Server Consoleから以下のCommandを入力します。
> dbc flush
> tell http inotes flushforms
Web BrowserでCacheをClearしてみると、以下のようになります。
まず、Mail Inboxではこれまで設定していたcheckActionsIDs( s_MenuID )が無効になり、MenuIDが表示されなくなります。
また、今回の変更で以前checkActionsIDs( s_MenuID )だけを動かして際に発生していたErrorは出なくなりました。
Classic UIのMenu Position表示は全体に適用した場合も問題なく動作するのですが、どうやら、Lite UIのMenuID表示は特定のs_MenuIDに適用しないと、sDescriptionが空でErrorとなるようです。
では、新規Mailを作成してMenuが追加されたか確認してみます。
以下のように、checkActionsIDs( s_MenuID )はMail編集時のみ有効となり、この画面だけでs_MenuIDが表示されています。
新規MenuのIDが表示されているのが確認できます。
新規MenuにHelp Textを設定していましたが、MenuID表示を有効にしているため、ID表示が優先され、Help Textは表示されませんので、Menu位置の確認が終わったら、MenuID表示を無効にしてHelp Textを確認する必要があります。
この新規Menuをクリックしてみると、以下のようになります。
通常のJavaScriptのAlertとは異なり、iNotesの画面上のAlertでバックがGlayoutされているのが分かります。
サブメニューも見てみましょう。
以下のようにサブメニューが表示され、メニューの間にセパレーターも入っていることが確認できます。
サブメニューを押すと以下のメッセージが表示されます。
これでSample Codeは正常に動いていることが確認できました。
最後にHelp Text表示を確認するために、checkActionsIDs( s_MenuID )を無効にして確認します。
以下のように、Help Textも正常に表示されていることが確認できます。
さて、ここでついでにClasic UIを使っているFormである「伝言メモ」(PhoneMessage)を開いて見ます。
以下のように、追加したLite UIのActionは表示されておらず、かつ、Custom_JSで設定したMenu Position表示が有効になっていることが分かります。
Classic UIの場合は、s_MenuIDはありませんので、SceneNameで判断したActionをCustom_JSで定義しないと現れないのです。
つまり、Classic UIとLite UIが混在してしまっている現在のiNotes 9では、Classic UIとLite UIを認識しながらCustomize Codeを夫々に対応した形で作らなければならないということです。
今回紹介した内容は簡単なSample Codeの内容で、全く役に立たないと思いますし、Alert Messageの場合は、BrowserのSecurityによって、Alert Message内にMessageをBlockするMessageが挿入されることがあります。
本来のCustomizeであれば、JavaScriptのshowModalDialogと同様のCustom Dialog Box表示が必須になりますが、Lite UIの場合、Custom Dialog Boxの表示もClassic UIの場合とは異なっていますので、別の機会に紹介したいと思います。
今回は、IBMが提供しているSample Codeを元に新規Menuの追加を行ってみました。
次回は、少し役立つCustomizeを考えてみます。
iNotes 9をCustomizeしてみよう! -4-
<話題の履歴>
前回は、Custome_JS_LiteのActionIDの表示を行ってみました。
今回は、従来のCustome_JSのMenu Position表示を有効にしてみたいと思います。
前回と同様に、Domino DesignerでCustom_JS Subformを開き、以下のように設定します。
Utilityは最初から読み込むように設定されていますので、そのままの状態にしておきます。
// Include utility routines common to both Classic and Sparkle Full/Lite
<InsertNotesSubForm Name="Custom_Common_Utils">
次に、Action HelperのUrilityを読み込むように設定します。
// ===========================================================================
// Expose this comment block to include actions helper routines
// ===========================================================================
//
<InsertNotesSubForm Name=API_ActionsHelper_Subform>
</NotesComment>
<InsertNotesSubForm Name=API_ActionsHelper_Subform>
また、以下の通り、Action Positionを表示するように設定します。
function Custom_Scene_Actions( s_SceneName, o_Window, s_TopBranchId ){
checkActionPositions(s_TopBranchId);
これで設定は完了しましたので、変更をServerのForms9_x.nsfに反映させて、以下のCommandでCacheのRefreshを行います。
> dbc flush
> tell http inotes flushforms
これでBrowerをRefreshして、Classic UIを使ったFormである「伝言メモ」(PhoneMessage)を開くと以下のようになります。
従来のMenu Positionが表示されたことが分かります。
では、Classic UIはこれくらいにして、Lite UIにAction Menuを追加する場合を見てみましょう。
Lite UIのMenu IDは以下のように表示されています。
これは、このSceneのMenu ID全体の名前で、MailのInboxのMenu IDであることを示しています。
「Scene」というのはiNotesが初めての方にとっては聞きなれない言葉かもしれませんが、現在の
作業画面の名前を表しています。
つまり、このAction Menu IDはMail Viewの一つであるInboxのMenuという意味なのです。
話しが逸れますが、Notesを使い慣れた人であればInboxはViewではなくFolderだと突っ込まれるかも知れませんが、iNotesではViewとFolderの区別は無いのです。
では、Custome_JS_Liteに書かれたSample Codeを見てみましょう。
Menuを追加するためのCodeが以下のように書かれています。
// Add to the mail view toolbar, only the normal one
if (-1 == s_MenuID.indexOf("mailview"))
return false;
var bLeftItems = true;
// Add menus and submenus
var aAdd1 = [
{title:"Hello world", find_id: "new", id: "hello1", before: true,
action:"com_ibm_dwa_ui_EXAMPLE_alert {sMsg: \'Hello1\'}", help_text:"some hover text" },
{title:"Sub menus", find_id: "new", id: "hello2", before: false,
action: "com_ibm_dwa_ui_EXAMPLE_alert {sMsg: \'Hello2\'}", help_text:"submenu hover text",
submenus: [
{title:"Selected docs",
action:"com_ibm_dwa_ui_EXAMPLE_actionSelectedDocs {}"},
{title:"Is view",
action:"com_ibm_dwa_ui_EXAMPLE_IsView {}"},
{is_divider:true},
{title:"Toggle Sidebar",
action:"EcV {sAction: \'toggle\'}"}
]},
{title:"Image", find_id: "hello2", id: "image1", before: false,
action:"com_ibm_dwa_ui_EXAMPLE_alert {sMsg: \'Icon and text\'}", help_text:"icon and text", img:"/iNotes/Forms9.nsf/commonactionicons.gif?OpenFileResource", img_width: 16, img_height: 16, x_offset: 48, y_offset: 0 },
{find_id: "image1", id: "image2", before: false,
action:"com_ibm_dwa_ui_EXAMPLE_alert {sMsg: \'Icon only\'}", help_text:"icon only", img:"/iNotes/Forms9.nsf/commonactionicons.gif?OpenFileResource", img_width: 16, img_height: 16, x_offset: 96, y_offset: 0 }
];
addActionsLite( s_MenuID, bLeftItems, aAdd1 );
最初に書かれているのは以下のCodeです。
if (-1 == s_MenuID.indexOf("mailview"))
return false;
s_MenuIDというのが、先程の画像で「MENU ID」に表示されていた値を含んでいる変数となっています。
この受信ボックス表示のSceneでは、"e-actions-mailview-inbox"という値が格納されています。
つまり、最初の部分が、追加するAction MenuのSceneを決定する判断となっていて、JavaScriptのindexOfを使って、s_MenuID.indexOf("mailview")でs_MenuIDに"mailview"含まれているかどうかを判断していますので、この場合は"mailview"という値を持つ全てのViewにAction Menuを追加するということになります。
新規Mail作成のSceneでは、"e-actions-mailedit"というのがs_MenuIDの値ととなりますが、これらの値はMenuIDのHelperが有効になっていれば容易に確認することができる訳です。
それ以外の方法で確認する為には、Firefoxなどの開発者Toolを使って調べる必要があります。
例えば、このTable定義されたMenu部分をFirefoxの開発者Toolを使って表示してみると、以下のようになっていることが分かります。
全体を見ると、iNotes Consoleを含めて表示されてしまいますので、個別のAction Menuを選択して表示すると以下のようになります。
開発Toolでの解析は面倒ですが、iNotesのDOM Treeの詳細を解説した資料はありませんので、本格的にCustomizeを行う場合は開発Toolによる解析が必須となってきます。
今回は、Classic UIのMenu Position表示の確認とLite UIでのAction MenuのCustomizeのためのSample Codeを見てみました。
次回は、Lite UIのAction Menu CodeのSampleを実際に動かしてみたいと思います。

















