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

60000 Access達成

先ほど60000 Accessを超えました。


ご愛用頂いている皆さんのお陰です。


どうもありがとうございます。


Workflow Applicationを開発してみよう -5-

<話題の履歴>


Workflow Applicationを開発してみよう -4-

Workflow Applicationを開発してみよう -3-

Workflow Applicationを開発してみよう -2-

Workflow Applicationを開発してみよう -1-



前回は、Form設計の前半までの隠し制御Field関係を紹介しました。


今回は、Formの中で、Userに見せる部分の設計を行っていきます。



前回から作成しているFormは以下のようになっています。


Workflow_4


前回は、上側の非表示部分を開発しましたので、今回は、表示部分を開発します。


今回は、表示部分といっても、本当に基本的な部分だけであり、実際にWorkflowの申請Formの内容までを開発する訳ではありません。


申請Formの基本的な表示部分とか、承認依頼Mailの送信設定といった本当に基本的な部分のみとしています。


では、順に定義するFieldの内容をみていくことにしましょう。



CreatorName : 名前Field(作成時の計算結果)


前回、申請Formの作成者は、Notes IDをCreator Fieldに保持させましたが、通常は漢字名を表示したいというのが通常です。


これを行うために、申請者の漢字名をCreatorNameという名前Fieldで定義し、式には@UserName(1)を設定しています。


@UserName(1)は、User IDに別名認証を行っている場合のみ利用できる式ですので、別名を利用されていない場合は、User IDから@DBLookupを使って別名情報を取得する必要があります。


R4.x の頃に構築されたWorkflow Applicationの場合、別名は利用できませんので、通常漢字名を持たせたDBを@DBLookupで処理しています。


前回も書きましたが、@DBLookupの多用はPerformance問題を起こすこともありますし、今回のSampleでは省略していますが、通常のWorkflow Applicationであれば申請者の組織名や、申請するFormによっては、申請内容を選択させ、勘定科目などを取得してFormに設定する必要も出てくるでしょう。


このような場合も、「Performance Design Tips : @DBLookup 関数」 で紹介している手法を使って@DBLookupの数を減らすことを考えないといけないのです。


別名を使っている場合は、@UserName(1)で簡単に漢字名が取得できますので、Performanceが悪くなることはありません。


今回は、このFieldは名前Fieldにしていますが、@DBLookupで取得するような場合は、Text Fieldで十分ですし、@Name([CN];@UserName(1))のようにCN部分だけを抜き出すのであればText Fieldでも構いません。


今回は@UserName(1)で取得していますので、Text Fieldにすると、表示がCN=/OU=/O=の形式になってしまいますので、名前Fieldにしているのです。勿論Text Fieldにした場合でも@Name([ABBREVIATE] ;@UserName(1))で処理してやれば問題はありませんが、余分な式を書かなくていいようにこのようにしている訳です。


ApproverName : 名前Field(作成時の計算結果)


Approver Fieldで承認者のNotes IDを保持していますが、これも別名を取得するようにしています。


CreatorName Fieldと同様に別名を保持するようにしているのですが、それを実現するために、以下のような式を書いています。


@If(Approver="";"申請不可";@DbLookup("";@DBName[1]:"names.nsf";"($Users)";Approver;"AltFullName"))


この式では、Domino DirectoryをLookupして別名情報を取得していますが、Domino Directoryで承認者(上司)が設定されていない場合は、"申請不可"を値に設定するようにしています。


DispStatus : テキストField(表示用の計算結果)


Status Fieldは前回、隠しFieldとしてStatus Code保持するようにしましたが、実際の申請書上に現在のStatusを表示する際にはStatus Codeではなく、状態を表す言葉で表示してあげるのが親切です。


そのために、値は保持しない表示用の計算結果Fieldとして定義し、Status Codeを以下の式で変換して表示しています。


StatusCode :="0":"1":"2":"3":"9";
StatusDisp :="作成中":"申請中":"承認済":"却下":"差戻し";
@Replace(Status;StatusCode;StatusDisp)


このような表示用のFieldを用意して、式での処理を行う場合、その量や式の複雑さによっては、表示用の計算結果ではなく、計算結果で値を保持することを検討することも重要です。


特に、変換するために@DBLookupを使わ無ければならないような場合は、Viewで表示する場合にViewに@DBLookupは書けません(R5とかではかけるのですが、Viewでの@DBLookupの利用は保障された使い方ではありませんのでご注意ください)ので、Formの中にFieldの値を保持することが必要になるのです。

一般的には、勘定科目Codeなどから、その内容もTableから取得するような場合がそうです。


勘定科目などは、変更されることもありますので、その時点の最新の物を取得する必要があります。


ただ、この場合は、毎回評価される計算結果Fieldで取得するのが正しいかというとそうではないのです。


計算結果にすると、保存時などさまざまな局面で式が評価されますが、Performanceを考えるとこれも好ましいことではありません。


逆に変更が必要な場合だけ、ボタンで勘定科目Codeを選択すると、その意味も同時に取得して作成時の計算結果や編集可能Fieldに値を代入するといった手法を取った方がいいのです。


SendMail : ラジオボタン(編集可能)


DB型のWorkflowでは、申請を行った時に承認者に承認依頼Mailを送付したり、承認が完了した場合に完了Mailを受け取ることが重要だというのは「Workflow Applicationを開発してみよう -1-」 でも紹介した通りです。


今回は、この承認依頼や承認完了通知を行うかどうかを申請者自身が決められるように作っています。


Mailが必要かどうかを決めるために、ラジオボタン(どちらか一つを選択)を採用しています。


チェックボックスにして、必要な場合だけCheckさせるという方法もありますが、今回はDefaultを通知ありにしていますので、チェックボックスで必要な場合だけCheckさせる方法を取ると、通知解除のためのボタンが必要になってしまいますので、ラジオボタンを採用しているのです。


このあたりも、どういう設計にするかによって、適切なField Typeを選択することが重要になります。


ラジオボタンFieldの設定は以下のようにしています。


Workflow_6


選択肢が横に並ぶように、一列の数は2個に設定し、シンプルな表示にするために、Borderは無しに指定しています。


また、選択肢は、別名を使い、送信が必要かどうかをCodeで保持するように設定しているのです。


Defaultはこの設定に従い、"1"の通知Mailを有効にする値を設定します。


また、このFieldは申請者が一度設定したら承認者によって変更されないようにすることが必要です。


そのために今回は、Notes/Domino 7から新しくサポートされたInput Enabledを使っています。


Workflow_7


この式により、申請Formを作成した本人で無い限り、このFieldを修正できないということになるのです。


これと同じことをNotes/Domino 6.xとかで実現するためには、このFieldを申請者以外からは見えないように画してしまうといった処理が必要ですが、Notes/Domino 7では編集を禁止することが非常に簡単にできてしまいますので、Workflow Applicationで編集可能なFieldを制御することが非常に容易になっているのです。


DispComment : テキストField(表示用の計算結果)


前回隠しFieldでComment Fieldを作成していますが、これをUserに見える領域に表示させるためのFieldです。


Comment Field(編集可能Field)を見える位置に配置してしまうことも考えられますが、そうすると、編集権限を持っている人なら、誰でも編集できてしまいます。


今回は承認Routeが1段階なのでまだいいのですが、多段階承認の場合は、承認者のコメントを追記で残していく必要があるでしょう。


また、それらのコメントは改ざんされてはいけないのです。


こういうことを実現するために、今回は、編集可能なComment Fieldを隠してしまい、表示用のFieldは別に作るという手法を用いています。


Fieldを直接編集させないで値を保持するという目的ですので、作成時の計算結果Fieldを使うことも可能です。



これでほぼ、FormのField設計が終わったわけですが、今回承認者はDomino DirectoryのManager Fieldを参照して自動設定しています。


もし、Managerが設定されていないのに、申請が行われては困りますので、この対処のために、Formを開いた時に警告することを行います。


こういうことを行うために利用できるのが、QueryOpen EventやPostOpen Eventなのですが、今回の場合は、承認者が正しく取得できたかどうかを判断することが必要ですので、QueryOpenでは承認者を取得する前ですので処理ができませんので、PostOpen Eventを利用することにします。


皆さん、Eventと聞くとLotusScriptで書かなければならないと思い込まれている人も中にはいらっしゃるかも知れませんが、@関数式で書くことができます。


今回は以下のように設定しています。


Workflow_8


@If(@IsNewDoc & Approver=""; @Do(@Prompt([Ok];"エラー";"承認者が設定されていません。管理者に連絡してください。");@SetField("SaveOptions";"0"));"")


この処理によって、新規にFormが開かれた場合(新規作成の場合)で、承認者が取得できていない場合は、Messageを表示し、SaveOptions Fieldに"0"を設定して、文書が保存されないようにしているのです。



これで、FormのFieldなどの設計はほぼ終わりました。



今回設計したのは、WorkflowのFormのHeader部分ということになります。



実際には、この下に、Applicationで必要なFieldを定義する必要があるのですが、今回は行いません。


また、今回設定してきたFieldは隠しFieldもありますし、Userに見えるFieldもあります。


Notes/DominoはFieldの式の評価順序というのが決まっており、左から右へ、上から下へと評価されていくことは皆さんもご存知でしょう。


つまり、Fieldを参照して処理するような式を書く場合は、参照するFieldはそれより前に無くてはなりません。


こういったこともForm設計をする際に考慮が必要で、隠しFieldの定義位置、見えるFieldの定義位置も考慮しながら開発する必要があるのです。



今回は、FormのField設計を行いましたが、次回は、Formで申請処理などを行うためのActionの定義を行っていきます。



<続く>


Notes/Domino Mail転送設定での注意点 -2-

<話題の履歴>


Notes/Domino Mail転送設定での注意点 -1-



前回は、Mail自動転送の方法の概要を紹介しました。


今回は、Mail自動転送の方法として、Domino DirectoryのPerson文書で転送先Address指定を行った場合について考えて見ます。



前回紹介したように、DominoではMail転送先AddressをDomino DirectoryのPerson文書に指定することで自動的に転送させることができます。


Mail_Forwarding_1

皆さんの会社のMail Routingの環境というのは会社によって異なるでしょうが、Relay Hostを経由してDominoにMailを配信するような構成をとられている場合もあるでしょうし、DNSのMX RecordでDomino SMTPに配信されているような場合もあることでしょう。


どちらの場合であっても、DominoがMailを受けた際に、Person文書の転送先Addressの設定により、Mailは指定されたAddressに転送が行われるようになります。



この転送先Address設定ですが、非常にSecurityを気にする場合は、Domino DirectoryのPerson文書に対する編集権限はUserには与えられていないのが一般的ですので、Userが自分で直接修正することは少ないのではないかと思います。


しかし、前回述べたようなAgentでの処理やMail Ruleでの処理を行われていない場合には、この転送先Address設定をUserの申請により自動変更したりする仕組みを構築されているような場合もあるでしょうし、転送先設定をどこかのDBに行うと、AgentでDomino DirectoryのPerson文書の転送先Addressの指定を変更するといった処理をされている場合もあるかも知れません。


あるいは、Userに直接変更を行わせるような運用をされていることもあることでしょう。


では、この転送先Addressというのは、変更さえすれば即時に反映されてRouterは別のAddressに転送を始めてくれるのでしょうか?


実は、これが問題となる場合があります。


Notes/DominoはPCの能力が低い頃に作成されたSoftwareですから、様々なところでPerformanceをあげるための工夫がされています。


「Single Copy Templateの仕組」 のシリーズで紹介しているDesign Cacheの仕組みもまさにそうです。


Mailの配信やAddress参照に関しても、工夫がされており、DominoはName Lookup Cache(NLCache)という物を持ち、前回参照したAddressはこのCacheから読み込むようになっているのです。


このNLCacheはAddress指定した場合の、曖昧な名前検索に用いられていたりしますが、それだけではなく、RouterがMailを配信するAddressを決定する際にも用いられるようになっています。


RouterはDomino Directoryの($Users) Viewを参照してMailの配信を行っているわけですが、Domino DirectoryのPerson文書の転送先Addressの指定を変更すると、この($Users) ViewのMailAddressの値が変更され、これを参照して転送処理が行われるようになります。


しかし、DominoはPerformanceを考えて賢く出来ており、直接このViewを参照している訳ではありません。


まず、View Indexを保持するNIF Poolという物があり、Domino Directoryの($Users) ViewはこのNIF Poolに保持されるようになっています。


当然、NIF PoolはPerformanceを考慮していますので、仮想Memory上に展開されています。


これでも、Performanceが心配だったのかどうかは分かりませんが、NIF Poolから読み込んだAddressをNLCacheにも保持するように出来ていて、Routerなど様々な部分からNLCacheが利用されるように出来ています。


今回の転送先Address設定の変更の場合は、Person文書が変更されると、Update Taskが動作し、View Indexの更新を行い、その結果当然NIF Poolの更新も行われるわけですが、NLCacheは頻繁に変更が行われる訳ではないのです。


このNLCacheの状態は、以下のようにServer ConsoleからShow NLCache Commandで確認できます。


   > Show NLCache
   NLCache version 2
   CacheLookups: 904
   CacheHits: 545
   CacheMisses: 229
   CacheNoHitHits: 130

   CacheResets 2

   Maximum Cache Size: 16,777,216

   CacheSize: 23,012 54 entries in Data Hash Table
   HashSize: 981,824 15 entries in View Hash Table
   CacheHitRate: 74 %


このNLCacheを利用しながらName Lookupが行われているのです。

ただ、このNLCacheは頻繁に更新したり、Viewが更新されたことを感知して自動的に更新されるのではなく、ある一定期間で更新が行われるように出来ています。


Defaultでは5分間隔でNLCacheは更新されます。


となると、Domino DirectoryのPerson文書の転送先Addressが更新されたとしても、NLCacheが更新されるのは最大5分後ということになります(Domino Directoryが膨大な場合は、View更新の時間も関係しますのでもっと時間がかかるかも知れません)。


このNLCacheの更新頻度は、以下のNotes.iniで制御することができますが、1分以内に設定すことは推奨されていません。


NLCache_Update_Suppress_Time=<Value>(1/100 Sec)


このパラメーターは1/100秒単位で指定することになっています。


このパラメーターを使って、推奨されている最低の1分(6000)に設定したとしても、1分間は設定変更がNLCacheに反映されないことがあるわけです。


例えば、Userに転送先Addressを変更することを許している場合は、もし、Userが誤って転送先Addressを設定してしまい、それが有効になると、元に戻すためには1分待たなくてはならない訳です。


つまり、即時反映ではないということに注意すべきなのです。


最大NLCache_Update_Suppress_Timeで指定された期間はNLCacheが更新されない訳ですからその間はRouterは以前の設定を使い続けるのです。



運用によっては、Userに転送先Address設定をさせる場合もありますが、このような場合にUserが間違って設定してしまったAddressを元に戻した場合にも、この時間を経過しないと変更が有効になりません。


しかし、皆さんの中には即時反映したいという要望もあるでしょう。


もし、Userが転送先Addressを変更する際にServer管理者の承認がいるということになっていれば、申請を見て、Server管理者がPerson Documentに設定を反映し、($Users) Viewの更新が行われたことを確認してから、NLCacheをResetするということもできます。


Server Consoleから、


>Show NLCache Reset


と入力することで、NLCache_Update_Suppress_Timeの設定に関係なく、NLCacheをUpdateすることが可能です。


しかし、管理者の皆さんはこんな面倒なこともしたくないという方もいらっしゃるでしょう。


その場合は、NLCacheそのものを無効化することもできます。


Notes.iniにNLCache_Disable=1を設定することで、NLCacheを利用しないようにすることができるのです。


しかし、これを設定したといっても、"即時反映"というのが保障されるものではないことは理解しておく必要があります。


Person Documentの設定が変更されて、($Users) Viewの更新が完了するまでのタイムラグというのは必ず存在するからです。


また、このNotes.iniでNLCacheを無効にした場合、Performanceの観点で好ましくないのではないかという疑問を抱かれるかも知れません。


最初に紹介したように、($Users) ViewはNIF Poolに展開されていますので、そこを読むことになりますが、これは仮想Memoryに展開されていますので、NLCacheから読み込むのに比べて大幅にPerformanceが悪くなったりするものでもありません。


多少は影響がある場合もあるでしょうが、Performanceの観点でそれほど神経質になる必要はないのではないかと思われます。



このように、Mailの転送という単純なことでも、色々と考慮すべき点はあるのです。



Notes/Dominoの仕組みを知った上で、上手な運用を行えば問題になることはありません。


Notes/Dominoに限らず、上手に運用を行うというのはどんなSoftwareでも重要なことでしょう。


Softwareの仕組みを理解して、効果を最大限に引き出すようにして使って行きたいものです。


<終わり>