Workflow Applicationを開発してみよう -4-
<話題の履歴>
Workflow Applicationを開発してみよう -3-
Workflow Applicationを開発してみよう -2-
Workflow Applicationを開発してみよう -1-
前回までは、Workflow Applicationを開発するにあたっての前提知識などについて紹介しました。
今回からは、実際に簡単なSample Applcationを開発してみましょう。
まずは、Formの開発からはじめることにしますが、Formの設計で知っておかなければいけない設計要素はFieldとActionとなりますが、Fieldについては前回紹介した通りです。
では早速開発を始めることにしましょう。
ある程度、Domino Designerの使い方はご存知であるということを前提に話を進めていきますので、初めてDomino Designerを触られる方にとっては少し分かりにくい部分もあるかも知れませんが、その点はご容赦ください。
Designerを開いて新規にDBを作成します。
新規にFormを作成して、以下のようにFieldを定義します。
今回は非常に単純な例を示しますので、実際のApplication開発の際はもっと様々なことを考えないといけませんが、簡単な例ですので、その点はご理解ください。
上記のFormは非表示領域(UserがFormを見るときには見えない領域)と表示領域とから成り立っています。
まず、ここで定義しているFieldを説明しましょう。
Editor : 作成者Field(作成時の計算結果)
このFieldは申請書Formを編集できる人を保持するようになっています。Workflowでは申請者が申請Formを申請すると次は承認者がFormを編集するという動きになりますので、このFieldで制御していく訳です。
最初に起票した際は、起票者が文書を編集する必要がありますので、このFieldは作成時の計算結果とし、式には@UserNameを指定して、起票者のNotes User IDをここにセットされるようにします。
Readers : 読者Field(作成時の計算結果)
このFieldは申請書Formを読むことが出来る人を保持するようになっています。Workflowでは申請者や承認者以外には申請Formを見せないことも必要となりますので、このFieldで読者を制御していく訳です。
最初に起票した際は、申請者がドラフト保存する場合もあるでしょうから、このFieldも作成時の計算結果とし、式には@UserNameを指定して、起票者のNotes User IDをここにセットされるようにします。
Status : テキストField(編集可能)
Workflowの進捗状況(作成中/申請中/承認済など)をCodeで保持するようになっています。
ここは、Statusを分かりやすく状態の説明で保持してもいいのですが、Codeとして保持するようにしています。Codeにすることで、@TextToNumberで処理することもできるというメリットがあります。
それなら数値Fieldで持てばいいのではないかと思われるかも知れませんが、数値で持った場合と、Textで持った場合のどちらの方がより利用価値があるかで判断いただければいいかと思います。
今回は、Status Codeを以下のように定義し、編集可能Fieldでの初期値(Default Value)はStatus "0"を設定するようにしています。
REM { "0":作成中 "1":申請済 "3":承認済 "4":却下"9":差戻し};
"0"
蛇足ですが、後から設計を見る人のために、Codeの意味をREMで入れておくことも重要です。
DBManager : 読者Field(作成時の計算結果)
上記のReaders Fieldで申請Formを読める人を制御するようにしましたが、これでは申請者が起票した際には申請者本人だけが参照可能な文書となりますし、申請途中ではWorkflowの経路にいる人だけが参照できる文書になってしまいます。
こうなると、Workflow Applicationが障害を起こした場合などにDB管理者が文書を参照できず、復帰することができなくなってしまいます。
Domino 6以降では、Serverの管理者権限として、"Full Access Administrator"が追加され、Domino Administrator Clientからこの権限を有効にしてDBにAccessするとReaders Fieldの値を無視して全ての文書をみることができますが、障害の度にServer管理者が介在しなくてはならないというのは好ましいことではありません。
通常はDBの管理者は別にいる訳ですから、DBの管理者は全ての文書を見ることができるようにしておく必要があります。
かといって、ここにDB管理者のNotes IDを指定してしまうと、人事異動などでDB管理者が変更された場合に過去の文書まで修正しなくてはならなくなります。
このようなことが無いように、このFieldにはDomino Directoryに定義されたDB管理者GroupやDBに定義されたRoleを埋め込んでおけば、GroupやRoleをメンテナンスするだけでよくなります。
このFieldの値も後で修正することはないですから、作成時の計算結果でGroupまたはRoleを保持するように指定します。
Approver : 名前Field(作成時の計算結果)
このFieldは承認者のNotes IDを保持します。
今回の例は簡単な例ですので、1段階承認となっていますので、単純に申請者の上司のNotes IDを保持するようにしています。
皆さんが実際に開発されるWorkflow Applicationでは、多段階承認の物もあるでしょうが、そのような場合は、承認経路のNotes IDを持たせて、経路の進捗状態で処理していくといった処理も必要になるでしょう。
今回は単純な1段階承認ですので、以下のような式でDomino Directoryの上司Fieldの値を取得するようにしています。
Manager :=@DbLookup("";"DomSrv/LotusSW":"names.nsf";"($Users)";Editor;"Manager");
@If(@IsError(Manager);"";Manager)
ここでも、一つ注意点があります。この式の場合は、参照するServerを明示的に指定していますが、このようなProgrammingをすると、DBが稼動するServerを変更した際や、Server集約を行った際に、Programを書き直さなければならなくなります。
こういった場合に対処するためには、以下のような式を書いておくことで、問題はなくなります。
Manager :=@DbLookup("";@DbName[1]:"names.nsf";"($Users)";Editor;"Manager");
@If(@IsError(Manager);"";Manager)
@DBNameは、ListとしてServer名とFile Pathを返してくれるのですが、その最初に返されるServer名だけをセットするために、@DBName[1]というように、Listの最初の要素を取得するようにします。
この機能は、Notes/Domino 6以降で可能になった方法であり、R5以前の場合は、@Subset(@DBName;1)のように書かなくてはならないことは皆さんもご存知でしょう。
また、ここでは単純に承認者IDをSetするようにしていますが、実際のApplicationでは、承認者の部門名などの付帯情報も取得しなければならないこともあります。
そのような場合、いくつかのFieldで@DBLookupを発行して取得することになるのですが、このようなことをするとPerformanceは悪くなってしまいます。
というのも、Fieldの値を設定するために、何度もDomino Directoryや情報を取得するDBを参照するNRPC Commandが発行されるからです。
これについては以前、「Performance Design Tips : @DBLookup 関数」
で紹介しましたのでそちらを参照ください。
Creator : 名前Field(作成時の計算結果)
このFieldは申請者のNotes IDを保持します。
Workflowでは差し戻しをした場合など、制御を元に戻すことも必要ですので最初の申請者の情報を保持しておくことも重要です。
このFieldも作成時に一度計算すれば再計算の必要はありませんので、作成時の計算結果で、式は@UserNameです。
Comment : テキストField(編集可能)
承認時のCommentを保持するためのFieldです。却下の理由などを保持していきます。
以上で、Formの中で赤字で示した部分の設計が完了です。
尚、この部分は制御に使う部分なので、一般Userに見えないように設定されています。
見えなくする範囲を選択して以下の設定を行うことで隠してしまうことができるのです。
今回はFormの設計で、制御に利用する隠された部分の設計を行いました。
次回は、実際に申請書Formで利用者に見える部分の設計を行います。
Notes/Domino Mail転送設定での注意点 -1-
皆さんの会社でも、Notes/Dominoの機能を活用してMailを自動的に転送するような設定を行われている場合もあることと思います。
Mailの転送設定は、Notes/Dominoの標準ではDomino DirectoryのPerson文書の転送先Addressに転送先のMail Addressを設定する方法と、Mail Ruleで設定する方法があります。
また、全く別に皆さんの会社で転送Agentを作成されて運用されている場合もあるのではないでしょうか?
Notes/Dominoの基本機能で行った場合は、
1.Domino Directoryの転送Addressの設定
2.Mail Ruleでの転送先の設定
という二つの方法があるわけですが、これらは少し動きが異なります。
Domino Directoryで転送設定を行った場合は、受信者(User)のMail DBにはMailは残ることなく、Mailが指定されたAddressに転送されます。
これはRouterが($Users) ViewのMailAddress(転送先)を参照して、RouterがUserのMail DBにMailが配信される前に処理をするからです。
Securityの観点では好ましくないですが、ちょっとした外出などで携帯に転送するような場合、本来のMail DBにもMailは残しておきたいというような場合に、この方法を使うと、MailはDBに残らなくなりますので注意が必要です。
もう一つの方法は、Mail Ruleで転送を行うことですが、この際は「Copyを送信」という形態をとります。
Mail RuleもMail受信前のAgentと同様にRouterで配信する際に稼動するAgentとなりますので、Routerが配信する際に「Copyを送信」で指定したAddressにも同時に配信するようになります。
ただ、送信方法は全体を送るか、Headerのみを送るかのどちらかしか選べません。
しかし、この場合は、Mailは受信者のMail DBに残り、かつ、転送処理が行われたことがわかるようにMarkされます。
これらの方法で転送を行うと、単純に転送されてしまうだけとか、Copyを転送するとSubjectでForwardされたMailが分からないといった理由で自由に処理したいためにAgentを組まれている場合もあることでしょう。
特に、携帯に送る場合などは、巨大な添付Fileは削除して送りたいとか、転送設定が間違っていてMailが届かず帰ってきた場合に対処したいとか、Summaryだけ転送したいとかといった要望から、そういったことをされている場合が多いと思います。
こういうAgentを組んで対処する場合にも2つの方法があります。
1.Mail受信後のAgentでの処理
2.Mail受信前のAgentでの処理
前者は、Mail DBにMailが配信された後に動くAgentで、Agent Managerが管理して動作するAgentとなります。
後者は、Mail DBにMailが配信される前に動くAgentで、Routerが管理して動作するAgentです。
この2つの大きな違いはAgentの実行を管理するTaskですが、この違いにより、即時性という観点で大きな違いが生まれます。
Mail受信前のRouterが処理するAgentは即時に実行されますが、Mail受信後のAgent Managerが実行するAgentは、Agent Managerが判断してServerがBusyな状態であれば実行が先送りされることもあり、即時性の保障はないのです。
こういうことから、皆さんの会社ではR5でMail受信前Agentがサポートされたことにより、それを使われていることもあるかも知れませんし、内容を編集したいがために、Routerが管理するMail.boxに直接文書を作成するといったProgramming Techniqueを利用されている方もいらっしゃるかも知れません。
Notes/Domino R5の頃は、標準TemplateとしてMailing List Templateが提供されていたということを覚えていらっしゃる方もおられるでしょうが、実はこのTemplateは送られてきたMailをMemberに送付する処理をMail受信後のAgentで処理し、Mail.boxにMemberに送付するMessageを生成するという動きをしています。
この動きを真似て、Mail受信前Agentに同様な処理を書いて、即時性を実現しておられる皆さんも中にはいらっしゃるかも知れません。
もしかすると以前に紹介したかも知れませんが、Mail受信前AgentでのMail.boxへの直接書き込みに関しては、Domino R5とDomino 6以降で扱いが変わっています。
というのも、Mail受信前Agentというのは、Routerで動く訳で、RouterはMail.boxを見ながら処理するわけです。
Routerが実行するAgentがRouterに影響を及ぼすMail.boxを直接触るというのは良くないことでしょう。
そういう意味からだと思いますが、Mail受信前AgentでのMail.boxへの直接書き込みはDomino 6以降で一部制限されています。
というのは、添付Fileが入っているようなMailをMail.boxに直接書き込むことが出来なくなっているのです。
Textのみ書き込む場合は何ら問題なく処理されます。
もし、皆さんのMail受信前の転送Agentがこのように添付Fileを含む場合でも、Mail.boxに直接書き込んでいるようなら、Domino 6以降にVersion UpするとErrorで動かなくなってしまうのです。
添付FileをMail.boxに直接書き込む場合は、Mail.boxに対してAgentの実行者が書き込み権限を持っている必要があり、権限が無い場合は書き込みが拒否されてしまうのです。
回避策としては、Mail.boxのACLを変更して、Agentの実行権限者にMail.boxへの文書作成権限を与えることですが、一般的に好ましいことではありません。
即時性というのは、外部にMailを転送する場合は、所詮e-Mailですから保障されるものではありませんので、このような場合はMail受信後のAgentで処理する方が一般的なのです。
Mail受信前AgentはRouterで動かされるため、即時性はありますが、Performanceの観点を考えると問題になる場合もあります。
こういったことも考えながら、Mailの転送処理をどのように行うかを考えることも重要かも知れません。
今回は、Mailの自動転送方法についていくつかの方法を紹介しました。
次回は、Mailの転送にDominoの標準機能である、Domino DirectoryのPerson文書での転送先設定を行った場合を考察してみます。
このBlogのAccess傾向分析 -2-
<話題の履歴>
前回はAccess分析に使うToolの紹介になってしまいました。
今回は、Access Analyzerを設置して、1週間たらずなのですが、現時点での状態を解析してみたいと思います。
以下が、先週のAccess傾向です。
1週間表示で見ると、上記のように、Page Viewは1日あたり450-600 Hit程度を記録しています、Visitは200強というところですが、このVisitの定義が不明なので、これはあまりあてにならないかも知れません。
というのもFirefoxからOCN経由でAccessしてTestすると、Browserで更新ボタンを押してもVisitとして記録されているからです。
同じ事を、OCN経由でIEから行うとPage Viewとしてのみ記録されます。
Visitはあてにならないので、Page Viewの傾向だけ見ると、当然ですが、会社からAccessされている人が多いためか、平日の業務時間中にAccessの殆どが集中していることが分かります。
次に、当てにならないVisit数から分析したDomainですが、以下のようになります。
これでどのDomainからAccessが多いかが分かるハズなのですが、先ほどのFirefoxでのAccessの場合を考慮すると、IBMからのAccessはFirefox Userが多いということが考えられますので、比率を見てもあまり参考になるものではないでしょう。
この解析で参考になるのは、Domain数ぐらいですが、1週間で約300 Domain、平日は1日あたり100強のDomainからAccessが行われているということが分かっています。
前回も書きましたが、Providerは1 Domain Countされますし、DNSで逆引きできないIPはxxx.xxx.xxx.*でまとめられてしまいますので、1日100社からのAccessという判断をすることはできませんが、DNSで逆引き可能なProxyから来ているAccessについてはある程度分析はできます。
また、DNSで逆引きできないIPについては、IP登録情報を調べることでどこの会社が所有しているIPかもわかりますが、そこまで調べるのは結構面倒な作業なので、今回はそういうことは一切行っていません。
これに付随して、Visit情報からOSなどの分析を見ると、以下のようになります。
Visit情報があやふやな事から、これも正確ではないですが、ここに訪問頂いているみなさんがどういったOSを利用されているかが分かり、その比率も分かります。
Windows XPが主流でWindows 2000の比率がかなり少なくなってきているということが分かりますし、中にはLinuxやMacからAccessされている方もいらっしゃるようです。
Browserを見てみると、以下のようになります。
ここで、Stationというのが記録されていますが、これは生Logを見る限り、Browserの種類がうまく取れていないのではないかと思います。
まだIE4があるのには驚きましたが、Opera/Mozilla(Firefox)、Netscapeなどもありますが、やはりほとんどの方がIE6をお使いであるということになります。
また、このVisit数のCountの動きから考えて、これを訪問者のBrowser Shareであるという見方はできません。Mozillaの方がIEよりも多くCountされているからです。
また、Browserの言語を見ると、以下のようになっています。
まあ、殆どが日本語なのは当然ですが、日本以外からもAccessされていることが分かります。
生Logを見ると、海外からのAccessは殆どがSearch EngineからのAccessであり、私のSiteでは英語が文章の中にあるために、海外でも検索にHitして訪問してきているのでしょう。
次に、Link元を見ると、以下のようになっています。
HTTP Refererの値での分析で、これもVisit数を元に分析しているのですが、「不詳」が半分を占めていることがわかります。
おそらく、ここをAccess頂いている皆さんは、Bookmarkをしたり、RSS Readerに登録したりしてAccess頂いており、検索Engineから検索して訪問される方は意外と少ないのでしょう。
次に、検索エンジンを見てみると、以下のようになります。
この解析はPage Viewからの解析ですので、正確なものと思われます。
検索Engineを使ってのAccessはPage View全体の14%程度であり、EngineとしてはGoogleが圧倒的なShareを持っていることが分かります。
検索エンジンからのAccessでどのような検索Keywordが使われているのかも見ることができますが、ここでは割愛します。
次はリピーター調査ですが、今回は1週間弱での解析ですので、1週間で見てしまうと、多くが1回目のAccessということになってしまいますので、金曜日のDataを見てみることにします。
本来は、1ヶ月とか経過してから見るのが一番よいのでしょうが、今回は仕方ありません。
これもVisit数からの分析ですので、正確ではないでしょうが、以下のようになっています。
初めての方が、60%弱、残りは何度か訪問された方となっていることがわかり、リピーターが多いSiteであるということがいえます。
一番多いリピーターは当然私です。
しかし、ここで一つ疑問に残るのは、RSS ReaderからAccessされた場合は、リピートなのか新規なのかということです。
最後に、リピーターの前回からの訪問時間ですが、以下のようになっています。
これもVisit数からの分析となっていますが、一日1回というAccessが多いことが分かります。
それは当然の結果で、このBlogは基本的に平日の8:00に決まったように新しい記事が掲載されますので、皆さんもそういうことはご存知で通常は1日1回Checkされているということだと思います。
今回は少しだけ傾向を分析してみましたが、このToolを使う限り、Visitがどのような観点で判断されているかが明確でない限り、正確な分析はできないということです。
他のToolがどうなっているかは分かりませんが、単純にPage Viewだけから分析できるToolの方が良いのかも知れません。
また、暫くたって傾向が変わっていたら、報告させていただく事にします。










