宛先ダイアログへの挑戦 ?! -4-
<話題の履歴>
前回は、標準のAddress Picker DialogboxとDJXの「部署別宛先」Dialogを呼び出して活用することが出来るかを試してみました。
残念ながら、標準の場合はViewがSystem Viewに限定されることは変わらず、DJXはUI自体も固定であることが分かりました。
今回は、同じUIをNotes/Dominoの機能で作成して、System View以外のViewを参照してTo/CC/BCCを設定する方法が無いかを模索します。
皆さんの中には、別のViewを参照したDialogboxを表示するなら、@Picklist([Custom])とかで十分では?と思われる方もいらっしゃるでしょう。
しかし、このCustom Picklistの場合は、以下のような画面となり、To/CC/BCCを別々に設定するUIしか作ることができません。
作りたいのは、Address Picker DialogboxのUIを持った画面で、かつ、選択肢を選ぶViewを自由に変更可能なものです。
はたして、こんなUIの画面は作ることが出来るのでしょうか?
実現したいのは、以下のUIです。
簡単に思いつくのは、@DialogboxでFromを表示する方法です。
取り敢えず、この方法で作成してみることにします。
このAddress Picker DialogboxのUIは、Directory指定、View指定、前方一致検索条件、別名利用Check、選択用View Window、宛先設定Window、宛先設定ボタン、設定した宛先削除ボタン、選択したUserの詳細確認ボタン、アドレス帳へのCopyボタンなどから成り立っています。
サイズは、横16cm、縦7cm程度です。
このUIを見て思いつくのは、5行5列のTableとなりますので、まずは、Subformを定義してTableを作成してみましょう。
簡単にレイアウトだけ作ってみましたが、以下のように画面サイズが小さくなりません。
レイアウト領域を使って作成すると、画面サイズは綺麗に領域に合わせて調整されるのですが、Tableの場合は最少サイズが定義されているようで、なかなかうまく行かないのです。
まあ、UIが実現できるか?の評価ですので、今回はこのまま進めて行くことにします。
上記のSubform設計は、以下のようになっています。
EnterSendTo、EnterCopyTo、EnterBlindCopyToは非表示となっています。
ここで、今回の設計をどのようにしたかを解説します。
Formの表は見てお分かり頂けますが、5x5の表となっていて、一部のCellを連結しています。
上の3行の部分は、仮に設定しただけですので、Fieldがそれらしく表示されているだけですので、割愛します。
まず、左側のViewのWindowですが、これは皆さんもご存知の通り、埋め込みViewとして仮に設定しました。
埋め込みViewのPropertyで幅と高さを以下のように設定しています。
次に右側のAddress用のFieldのEnterSendTo、EnterCopyTo、EnterBlindCopyTo Fieldですが、上記に書きましたが非表示Fieldとなっていて、これらのFieldが配置されている表の行そのものが非表示です。
Fieldは編集可能な名前Fieldで、勿論Fieldの値は複数値が可能になっています。
Default値は、元のFormの値を引き継ぐために@ThisValueを指定しています。
他のAddress Input Fieldも同様の設定です。
次に、宛先の入力値を表示するWindowですが、Address Picker Dialogboxを見ていると、FieldではなくViewのような感じに見えていますが、今回はFieldとして作成してみました。
というのは、これを表示するためのViewなど文書も保存されていない状態ですのである訳もありません。
Fieldは以下のように編集可能なリストボックスとして作成しています。
また、サイズも限定して、左側にある埋め込みViewと高さが合うように調整しました。
また、このFieldの制御設定は以下のようになっています。
「キーワードの更新時にフィールドを更新」、「文書の更新時に選択肢を更新」、「キーワードの別名を許可」を有効にしています。
選択肢を表示する式は以下のように設定しました。
tmpTo := @Name([Abbreviate];@Unique(EnterSendTo));
tmpCC := @Name([Abbreviate];@Unique(EnterCopyTo));
tmpBCC := @Name([Abbreviate];@Unique(EnterBlindCopyTo));
"宛先: | EnterSendTo:All": (tmpTo + " | EnterSendTo:" + EnterSendTo ) :"CC: | EnterCopyTo:All": (tmpCC + " | EnterCopyTo:"+ EnterCopyTo ) : "BCC: | EnterBlindCopyTo:All": ( tmpBCC + " | EnterBlindCopTo:" + EnterBlindCopyTo)
EnterSendToなどのFieldの内容を@Uniqueで重複を排除し、完全階層名で保存されている名前Fieldの値を平たんに表現し、その後、「宛先:」「CC:」「BCC:」などの区分を付加しています。
また、「キーワードの別名を許可」に設定した理由がここにあるのですが、別名として、To/CC/BCCフィールド名:UserIDの形式を保持するようにしました。
「リストボックス」のFieldですから、画面上で選択したField値を検知できるハズですので、この選択肢を検知した際、To/CC/BCCのどのFieldの値を選択したかを分かるようにするためです。
この状態で、EnterSendTo、EnterCopyTo、EnterBlindCopyToが定義されて、値が設定されているFormからこのSubformのDialogboxを呼び出すと、以下のように表示されるという訳です。
Dialog画面サイズとかは別にして、見た目だけは、Address Picker Dialogboxにそっくりな物となったのではないでしょうか?
しかし、To/CC/BCCの表示を単なるFieldの文字で表現した結果、この部分は本物のAddress Picker Dialogとは異なってしまっています。
何故こんなことをしたのか?と思われる方も多いのではないかと思いますが、宛先を表示するのに、別のFieldで表示することも出来ます。
この場合、Address Picker Dialogが実現しているように、1個の窓のような状態で、To/CC/BCC Fieldを表示し、それらのFieldの宛先数によってTo/CC/BCCごとに表示を広げていき、最終的にDialogboxの縦の範囲を超えた場合は、スクロールバーを表示するというUIを実現しようとすると、今思いつく方法としてはこれしかなかったからです。
実際に別Fieldにして定義してもある程度は同じようなUIが実現出来るのですが、To/CC/BCCの内容が増えた場合の表示のWindow制御が上手く行かないために(Notes形式のFieldの場合はWindowサイズを無視して拡張して行き、Dialogboxの縦の制限を超えて参照できない状態になったりします)、現時点ではこの方法を採用したというだけなのです。
皆さんが良いアイデアをお持ちであれば、是非教えて頂きたいと思います。
多分、ここからが大変な苦労が待っていると思うのですが、Dialogboxに埋め込みViewで表示したViewで選択したEntryのColumnの値を取得して、Dialogbox内のFieldに値をSet出来るのでしょうか?
最終的に出来なかったという結論になるかも知れませんが、挑戦してみましょう。
今回は、Address Picker Dialogと同様のUIを持ったDialog用のSubformを作成しました。
次回は、このDialogでAdderss Picker Dialogが実現している、To/CC/BCCに設定されたUserの削除処理の実装に挑戦します。
<続く>
宛先ダイアログへの挑戦 ?! -3-
<話題の履歴>
前回は、DJXの「部署別」宛先ボタンも含め、Address Picker Dialogboxの機能を見てみました。
今回は、同様なInterfaceに挑戦するにあたり、先ずはDJXの「部署別宛先」ボタンがどのようになっているかを調べてみます。
DJXのMemo FormのAction Buttonを確認すると、以下のLotus Scriptが記述されています。
(Options)
Uselsx "?djxaddr.dll"
Sub Click(Source As Button)
Dim ws As New NotesUIWorkspace
Dim uidoc As NotesUIDocument
Dim pick As New DJX_MailAddress
Dim getCal As String
Dim session As New NotesSession
Dim ret As Long
' Dim focus As String
Set uidoc = ws.CurrentDocument
%REM
focus = uidoc.CurrentField
If ( focus = "Body" ) Then
Messagebox "宛先にフォーカスを移動してください", 64, "部署別宛先"
Exit Sub
End If
%ENDREM
pick.to = uidoc.FieldGetText("EnterSendTo")
pick.cc = uidoc.FieldGetText("EnterCopyTo")
pick.bcc = uidoc.FieldGetText("EnterBlindCopyTo")
ret = pick.dialogBox
If ret <> 0 Then
Call uidoc.GotoField( "EnterSendTo" )
Call uidoc.FieldClear( "EnterSendTo" )
Call uidoc.InsertText( pick.to )
Call uidoc.GotoField( "EnterCopyTo" )
Call uidoc.FieldClear( "EnterCopyTo" )
Call uidoc.InsertText( pick.cc )
If pick.bcc <> "" Then
getCal = session.GetEnvironmentString("MBCC")
If getCal <> "1"Then
Call session.SetEnvironmentVar("MBCC", "1")
Call uidoc.RefreshHideFormulas
End If
Call uidoc.GotoField( "EnterBlindCopyTo" )
Call uidoc.FieldClear( "EnterBlindCopyTo" )
Call uidoc.InsertText( pick.bcc )
Else
Call uidoc.FieldSetText("EnterBlindCopyTo", pick.bcc)
End If
%REM
Call uidoc.FieldSetText("EnterSendTo", pick.to)
Call uidoc.FieldSetText("EnterCopyTo", pick.cc)
Call uidoc.FieldSetText("EnterBlindCopyTo", pick.bcc)
%ENDREM
End If
End Sub
Optionsに書かれている通り、DJXの「部署別宛先」ボタンは独自に作成されたDLLを使っており、これはDJXが開発されたNotes/Domino R5の頃から変わっていません。
流石に、DLLを作ってまで開発することは出来ませんが、Codeとしては参考になるのではないかと思います。
REM文も残っていて、途中でLogicを変更しているのも分かります。
最初はuidoc.FieldSetTextでDJXのPickerが返してきた値をセットしているだけだったのが、何故かuidocのFieldを順番に移動してuidoc.InsertTextでセットするように変更されています。
その為、BCCの非表示が設定されている場合を考慮して、BCC非表示の場合は表示を有効にしてから値をセットしています。
何故、uidocのFieldを移動しながらSetするように変更したのでしょう?
そんなことはさておき、DJXのAddess Pickerを利用する為には、DJX_MailAddressというClassを利用して、それに対して、to、cc、bccをセットして、Dialogboxを呼び出すだけで出来るようです。
同様に標準のAddress Picker Dialogboxの起動は以下となっています。
getCal := @Environment("MBCC");
@Command([MailAddress];"EnterSendTo";"EnterCopyTo";"EnterBlindCopyTo");
@If(EnterBlindCopyTo != "" & getCal != "1"; @Do(@SetEnvironment("MBCC"; "1"); @Command([RefreshHideFormulas])); "")
こちらもBCCの非表示の対応を行っているようです。
ということは、Notes 8あたりだったと思いますが、BCC Fieldを標準では表示しないように変更したことに対応して修正を加えていることが分かりますが、DJXがuidoc.FieldSetTextからuidoc.InsertTextに変更した理由は分かりません。
また、この標準機能の@Command([MailAddress])のHelpを参照してみると以下のようになっています。
[宛先の設定] ダイアログボックスを表示します。このダイアログボックスで、メール文書の [宛先] フィールドに含めるユーザーやグループを選択できます。
構文
@Command([MailAddress])
使用法
このコマンドが正常に動作するには、メール文書が編集モードで開いていて、編集可能フィールドに挿入点がなければなりません。
表示されるダイアログボックスは、コア Lotus Notes プログラムコンポーネントに組み込まれたダイアロアグリソースですが、ローカルのアドレス帳またはサーバーディレクトリ (使用するように選択したもの) の ($PeopleGroupsFlat) ビューに基づいています。
このコマンドは Web では機能しません。
この@Commandでは、参照できるViewはUIからも分かる通り、LocalやDominoのDAに設定されたAddressbookの($PeopleGroupsFlat)などの一部のSystem Viewに限定されているようです。
ここに使えるViewが追加/削除できれば、独自に宛先設定ボタンを作る必要は無いかも知れませんし、System ViewをCustomizeすることもないでしょうし、DJXのAddress Pickerも不要になるかも知れません。
ただ、Helpには書かれていませんが、実際のCodeを見ると、To/CC/BCCとして使うFieldを渡してやることはできることが分かります。
では、少しこれらの機能を試してみましょう。
ApplicationでUserやGroup選択をしなければならないFieldがあったとしましょう。
典型的な例は、文書の公開先などのReaders Fieldや文書の編集可能者を定義するEditors Fieldが考えられます。
評価ですので、新規のDBに単純に1個の名前Fieldを作成して試してみます。
皆さん、ご存知のように、Fieldの設定で名前を選択した場合は、以下のように名前選択のDialogをどこから行うかの設定ができます。
Application DBの名前Fieldであれば、これを使えば良いことです。
DBのViewからの選択もできますので、Domino Directoryから選びたい場合は、追加のViewがあればそれを使って選択することもできますし、勿論Domino Directoryの標準Viewを使って選択することも出来ます。
今回は、宛先ダイアログを使う設定でFieldを作成しておきます。
まず、この標準の選択ダイアログを試してみると、以下のようなDialogになります。
使えるDirectoryやViewは通常のMailのAddress Dialogboxと変わることはありませんが、別名選択のCheckが出来なくなったこと(これは別名表示設定のない管理者IDのLocationで利用しているからで、別名表示が有効になったLocationであれば表示されます)、宛先欄がTo/CC/BCCではなく単なる「名前」という表示になったこと、名前の追加ボタンが1個になり「追加」だけになったことが変更点になります。
これは、@PickList([Name])でDialogbox表示するのと同じです。
では、@Command([MailAddress]; "FieldName")を使って、Filed名を引き渡してみると以下のようになります。
殆ど違いが分からないかも知れませんが、ボタン表示や右側の表示が「宛先」となったことくらいでそれ以外変化はありません。
つまり、この@Command([MailAddress]; "FieldName1";"FieldName2";"FieldName3")の形式でField名を渡して処理する場合は、To/CC/BCCとして認識されるということでしょう。
この表示を見比べていると、@Command([MailAddress])と@PickList([Name])との違いが分かってきます。
しかし、これらを使ったとしても、宛先選択のDialog Boxで表示するViewが変更できない限り、表示内容を制限することはSystem ViewをCustomizeしない限り出来ない訳です。
試しにDJXのDialogではどうなるのか?を試してみました。
同じFormの中にボタンを作成して実行します。
私が試しているのは上記のような単純なFormで名前が設定されているのがNameという名前の名前Fieldで、「名前」という青色の部分にはMailのMemoと同様の@Command([MailAddress];"Name")、「STD」ボタンにはFIELD Name := @PickList([Name] ; Name);@Truが設定されているだけです。
「DJX」ボタンには以下のLotusScriptを書きました。
Sub Click(Source As Button)
Dim ws As New NotesUIWorkspace
Dim uidoc As NotesUIDocument
Dim pick As New DJX_MailAddress
Dim getCal As String
Dim session As New NotesSession
Dim ret As Long
Set uidoc = ws.CurrentDocument
pick.to = uidoc.FieldGetText("Name")
ret = pick.dialogBox
Call uidoc.FieldSetText("Name", pick.to)
End Sub
引数の数が少なくても変わることなく、以下の画面となりました。
Mailの宛先設定以外には利用できないUIになっていることが分かります。
話が逸れてしまいますが、昔「Domino Web AccessをCustomizeしてみよう ! -1- 」という記事のシリーズを書いていたことを思い出しました。
iNotes(DWA)の場合、Address Pickerに利用できるViewをCustomizeするのは意外と簡単に出来てしまうのですが、通常は楽だと思われるNotesの方が大変なのです。
今回は、DJXの「部署別宛先」ボタンの構造や、標準のAddress Pickerについて調べてみました。
次回は、同じようなUIを実現する為の方法を模索します。
宛先ダイアログへの挑戦 ?! -2-
<話題の履歴>
前回は、Address Picker Dialogboxの概要をみてみました。
今回は、もう少し、DJXの部署別宛先Dialogboxも含めて調べてみます。
標準のAddress Picker Dialogboxでは、勿論部署別の表示もSupportしていて、以下のように表示されます。
標準の場合、DAに設定されたAddressbookも含め選択できます。
また、組織表示の場合、役職、基本名、別名が表示され、選択したUserの詳細情報を確認したり、LocalのAddressbookにUserを登録することもできます。
方やDJXの「部署別宛先」ボタンで表示すると以下のようになります。
Dialogbox自体のサイズも異なりますし、ボタンなども微妙に異なっています。
また、DAに設定されたAddressbookを選択することはできません。
標準のAddress Picker Dialogと異なり、複数のAddressを宛先に登録する為には、組織を選択して真ん中の名前の窓に組織内のUserやGroupを表示させてから、そのUserを複数選択して宛先に登録するという操作になっています。
この場合は、ShiftやCtrlを使ってWindowsの通常操作と同様に宛先設定が可能で、Drag & Drop操作も可能です。
一番左の窓からのDrag & Dropでの宛先への登録も可能で、宛先は同じ名前を設定しても標準のAddress Picker Dialogboxと同様に重複して登録されますし、当然、沢山のAddressを登録すると、スクロールバーが現れます。
DJXのDialogboxの利点は、組織Codeや役職Codeで並び順を制御できるということです。
まあ、標準のDialogboxでOrder制御を採用してくれればこんな特殊で中途半端なDialogboxは要らなくなります。
しかし、両方のDialogboxに共通して言えることは、Groupは英語表示のままです。
これは、Notes/Dominoの制限で、Group名には日本語を設定してはいけないことになっているためですが、日本や英語圏以外の環境では現地の言語で設定している場合も多いかも知れませんが、正式にはサポートされていないのです。
昔から思っているのですが、Group文書にも別名Fieldを設け、そこに英語以外の言語の名前を設定すれば、それがこれらのDialogboxに表示されたら便利だと思うのは私だけなのでしょうか?
ちょっとした機能変更だと思うのですが、未だに実現されていないのが残念です。
また、組織に関係のないGroupはどちらのDialogboxでも、DJXでは「(所属なし)」、標準では「*組織階層の指定なし*」として表示されてしまいます。
GroupにはCategory設定があることは皆さんもご存知だと思いますが、組織情報の無いUserやGroupは、Userは「その他のUser」として表示するとか、Serverは別にするとか、Mail-in DBやRsourceも別にするとか、GroupはCategoryで分けて表示して欲しいと思います。
DJXの場合は、ServerやMail-in DBなどが表示されませんので、少しはましなのかも知れません。
DJX環境であっても、標準の日本語環境であっても製品の制限から、Group名が英語のみの設定になっていることから、どういうGroupなのかも分からなくななるために、日本ではDomino DirectoryのSystem Viewを変更して、Address Picker DialogboxのユーザーViewにGroupを表示させないようにしている場合も見受けます。
しかし、System Viewを変更すると、Add-in製品の導入時に問題になることが多々あります。
例えば、今はもう無い?Domino.Docの導入に失敗したり、OnTimeGCの設定が適切に出来ないと言う問題が発生します。
何故、日本のUserがこのようなことをしてしまうか?を考えると、全ては誤送信防止の為なのです。
こういう状況を見ていると、標準のAddress Picker DialogboxやDJXの「部署別宛先」ボタンのDialogboxを改善して頂くのが一番良いのですが、それが実現されていない現状を考えると、何らかの解決策が無いと困ります。
そういう意味で、Address Picker Dialogboxと同等の機能がUserのProgramとして実現できれば、問題が無くなるのではないかと思った次第です。
今回は、現状のDJXの「部署別宛先」ボタンや標準のAddress Picker Dialogboxの機能を再確認しました。
少し、グチっぽい内容になってしまった感じがありますが、現状を打破するためには、解決策を模索しないといけない訳です。
次回は、DJXの「部署別宛先」ボタンの機能を調べ、新しいAddress Picker Dialogboxの開発に役に立つかどうかを見てみます。

















