Lotus Notes/Domino (R) をこよなく愛して。。。。 -352ページ目

Domino Web AccessをCustomizeしてみよう ! -5-

<話題の履歴>


Domino Web AccessをCustomizeしてみよう ! -4-

Domino Web AccessをCustomizeしてみよう ! -3-

Domino Web AccessをCustomizeしてみよう ! -2-

Domino Web AccessをCustomizeしてみよう ! -1-



前回は、DWA 7のAddress PickerのView Listを決定している"x_NamePickerViewList" Subformの内容がどのような物なのかを調べてみました。



皆さんの多くの方々は、まだDWA 7を使われていることは少ないと思いますので、今回は念の為にDWA 6.5の内容も確認しておくことにします。


以下では、Domino 6.5.5 IE版のDWAを使って内容を見ていくことにします。


注)以下に出てくるCodeは部分的にCopyしたりしているため、CodeにCopy Right表示はありませんが、IBMのCodeのCopyですので、IBMに知的所有権が存在しますので、ご注意ください。


DWA 6.5.5のAddress Pickerは以下のようになっていて、DWA 7とは少し異なっていることがわかります。


DWA_AddressPicker_3


DWA 6.5.5のCodeは以下のようになっています。



CK.nViewListWidth = 550;
CK.aViewListColWidth = [200, 100, 100, 100];
CK.aViewListColLabel = ["Name", "Position", "Phone", "Dedicated Line"];
CK.BTM = [
// for Contacts
{
sViewTitle : "List by name",
sViewName : '($PeopleGroupsFlatExt)',
sViewInfo : '$39;MAMailAddress;NPName;Form;AltFullName;0;NPJobTitle;NPPhoneNumber;NPOtherPhone',
nViewType : 2,
bIsFlat : true,
aDBPaths : []
},
// for Catalog
{
sViewTitle : "List by name",
sViewName : '',
sViewInfo : '',
nViewType : 3,
bIsFlat : true,
aDBPaths : ['*']
},
// for LDAP
{
sViewTitle : "List by name",
sViewName : '',
sViewInfo : 'title;telephonenumber;telexnumber',
nViewType : 4,
bIsFlat : true
},
// for normal directory
{
sViewTitle : "List by name",
sViewName : '($PeopleGroupsFlat)',
sViewInfo : '$39;MAMailAddress;NPName;Type;AltFullName',
nViewType : 1,
bIsFlat : true,
aDBPaths : ['*']
},
{
sViewTitle : "Notes name hierarchy",
sViewName : '($PeopleGroupsHier)',
sViewInfo : '$11;MAMailAddress;$24;Type;AltFullName;$8',
nViewType : 1,
aDBPaths : ['*']
},
{
sViewTitle : "Corporate hierarchy",
sViewName : '($PeopleGroupsCorpHier)',
sViewInfo : '$60;MAMailAddress;NPName;Type;AltFullName;$55',
nViewType : 1,
aDBPaths : ['*']
},
{
sViewTitle : "Categorized by language",
sViewName : '($PeopleGroupsByLang)',
sViewInfo : '$11;MAMailAddress;NPName;Type;AltFullName;$8',
nViewType : 1,
aDBPaths : ['*']
}
];


基本的にはDWA 7と同様であることが理解できると思いますが、Name Picker画面が異なっていることから、最初の部分のView Listの幅の設定などが異なっていることが理解できます。


また、DWA 6.5.5では参照するViewのTypeとして"bIsFlat"という変数で参照Viewが階層構造で無い場合は明示的に指定しなければならないことが分かります。


更に、DWA 7では階層構造Viewの場合だけ、"aDefaultColumnWidths"という指定がありましたが、DWA 6.5.5の場合はこの指定が無いことが違いとなっています。



これで、DWA 6.5.5でもDWA 7とほぼ同様になっていることがご理解頂けたのではないかと思います。



今回はIE版で内容を見てきましたが、最初に紹介したDJX版のFormsX.nsfの場合のように日本語版でも同様になっています。


更に、DominoをMulti-Language対応している場合は、FormsX.nsfの"x_NamePickerViewList" Subformは言語別に複数の設計要素が格納されています。


Mail DB側の言語設定により、FormsX.nsfのどの言語の設計要素を利用するかが決まり、複数言語への対応ができるようになっているのです。


即ち、Multi-Language対応されている場合は、言語ごとの"x_NamePickerViewList" Subformを個別に変更すれば言語によって異なるView Listを提供することが出来るわけです。



今回は、DWA 6.5.5の場合の"x_NamePickerViewList" Subformの内容を見てきましたが、次回以降は、DWA 7を使って実際にどのようなCustomizeが出来るのかを見ていくことにします。



<続く>


Domino Web AccessをCustomizeしてみよう ! -4-

<話題の履歴>


Domino Web AccessをCustomizeしてみよう ! -3-

Domino Web AccessをCustomizeしてみよう ! -2-

Domino Web AccessをCustomizeしてみよう ! -1-



前回は、DJX版のDWAのAddress Pickerがどのように実現されているのかを見てみました。



今回は、これを参考に標準版のDWAのAddress PickerがCustomize可能かどうかを実際に試してみることにします。


ただ、このCustomizeは私が知る限り、TechnoteやHelpの記述は見つかりませんので、IBMとしてCustomizeをサポートしているかどうかの確認はできていませんので、もし、実施される場合は、ご自身のリスクでお願いします。



では、まず、この"x_NamePickerViewList" Subformに書かれている内容を理解していくことから初めてみます。


以下では、Domino 7 IE版のDWAを使って内容を見ていくことにします。


注)以下に出てくるCodeは部分的にCopyしたりしているため、CodeにCopy Right表示はありませんが、IBMのCodeのCopyですので、IBMに知的所有権が存在しますので、ご注意ください。


DWA 7のAddress Pickerは以下のようになっています。


DWA_AddressPicker_1


これと、"x_NamePickerViewList" Subformの内容を比較して見ていくことにしましょう。

Address Pickerでは、上記のようにDomino Directoryを選択すると、"List by name"、"Notes name hierarchy"、"Corporate hierarchy"、"Categorized by language"という4つのViewが選択できます。


また、Contactsを選ぶと、"List by name"のみが選択できるようになっています。


一方、Forms7.nsfの"x_NamePickerViewList" Subformの内容は以下のようになっています。


この内容を見れば、//for contactsで始まる部分がAddress PickerのContactsのListになり、//for normal directoryで始まる部分がDomino Directoryを選択した場合のView Listになっていることがわかります。


CK.Rs = 600;
CK.Br = 400;
CK.nViewListWidth = 300;
CK.BTM = [
// for Contacts
{
sViewTitle : "List by name",
DcS : '($PeopleGroupsFlat)',
sViewInfo : '$39;MAMailAddress;NPName;Form;AltFullName',
nViewType : 2,
aDBPaths : []
},
// for Catalog
{
sViewTitle : "List by name",
DcS : '($PeopleGroupsFlat)',
sViewInfo : '$39;MAMailAddress;NPName;$40;AltFullName',
nViewType : 3,
aDBPaths : ['*']
},
// for LDAP
{
sViewTitle : "List by name",
DcS : '',
sViewInfo : 'SummaryName;MailAddress;FullName;Type;AltFullName',
nViewType : 4
},
// for normal directory
{
sViewTitle : "List by name",
DcS : '($PeopleGroupsFlat)',
sViewInfo : '$39;MAMailAddress;NPName;Type;AltFullName',
nViewType : 1,
aDBPaths : ['*']
},
{
sViewTitle : "Notes name hierarchy",
DcS : '($PeopleGroupsHier)',
sViewInfo : '$11;MAMailAddress;$24;Type;AltFullName;$8',
nViewType : 1,
aDBPaths : ['*']
},
{
sViewTitle : "Corporate hierarchy",
DcS : '($PeopleGroupsCorpHier)',
sViewInfo : '$60;MAMailAddress;NPName;Type;AltFullName;$55',
nViewType : 1,
aDefaultColumnWidths : [10],
aDBPaths : ['*']
},
{
sViewTitle : "Categorized by language",
DcS : '($PeopleGroupsByLang)',
sViewInfo : '$11;MAMailAddress;NPName;Type;AltFullName;$8',
nViewType : 1,
aDefaultColumnWidths : [10],
aDBPaths : ['*']
}
];


他に、//for Catalog、//for LDAPという部分がありますが、標準ではDirectory CatalogもLDAPを参照するようにも構成されていませんので、Address Pickerにはこれらは選択肢として現れていないわけです。


では、Domino Directoryの場合の、Viewの内容の定義を見てみましょう。


{
sViewTitle : "List by name",
DcS : '($PeopleGroupsFlat)',
sViewInfo : '$39;MAMailAddress;NPName;Type;AltFullName',
nViewType : 1,
aDBPaths : ['*']
},



sViewTitleはAddress Picker Dialogで表示するViewの名前になっていることがわかります。

DcSは実際のDomino DirectoryのViewの設計要素の名前となっています。


では、sViewInfoは何を表しているのでしょうか?


DWAではViewの情報にAccessする際にProgrammatic Nameを使ってAccessすることが多いのですが、この値も実はViewの列のProgrammatic Nameなのです。


実際に、Domino Directoryの"($PeopleGroupsFlat)" Viewを開いて、列のPropertyを確認してみるとそれがわかります。


一列目は、Propertyの"Advanced"タブで確認すると、"$28"となっており、2番目が"39"、"MAMailAddress"、"NPName"、"Type"、"AltFullName"はViewに定義された列のProgrammatic Nameとなっていることが確認できます。


DWA_AddressPicker_2


つまり、sViewInfoでは利用する列を定義していることがわかります。


nViewTypeはどうやら分類に使われていて、"1"を指定することが、Domino Directoryを表しているようです。


また、aDBPathsはDB Pathを表しているようで、Domino内のDBの場合は"*"、UserのMail DB内(つまりContactsの場合)は指定なしとなっているようです。


また、"x_NamePickerViewList" Subformの一番最初に記載されている、以下の部分は、Dialogで表示するSizeを表しているのではないかと思えます。


CK.Rs = 600;
CK.Br = 400;
CK.nViewListWidth = 300


これで、ある程度は内容が理解できたのではないでしょうか?


私自身、DWAの全てのCodeが読めるわけではありませんので、ここに書いた内容は誤っているかも知れません。



では、次回以降、これらの内容を実際に変更してどのように変化が生じるかを見ながら、Customizeを行っていくことにします。



<続く>


50,000 Access達成 ありがとうございました

単にCounterの数字ではありますが、50,000 Accessを達成することができました。


読者の皆さんのお陰です。


最近は、このCounterだけしかありませんが、Ameba Blogが提供しているIP数Countによると、1日(平日ですが)に150-170 IPからアクセス頂いているようです。


今後も皆さんの期待に沿えるように記事を書く積りですが、もし、ご希望がありましたら、ご意見コーナーの記事にコメントを付けてください。


普段は私の思いつきで記事内容を決めているのですが、皆さんのご希望でお応えできることがありましたら記事にさせて頂きます。


今後とも、ご愛顧の程お願い致します。