Workflow Applicationを開発してみよう -8-
<話題の履歴>
Workflow Applicationを開発してみよう -7-
Workflow Applicationを開発してみよう -6-
Workflow Applicationを開発してみよう -5-
Workflow Applicationを開発してみよう -4-
Workflow Applicationを開発してみよう -3-
Workflow Applicationを開発してみよう -2-
Workflow Applicationを開発してみよう -1-
前回は、Formの稼動確認を行いました。
今回はViewの設計を行っていきます。
前回述べましたが、DBを新規に作成するとDefault Viewが標準で作成されていますが、このViewを修正して申請者別のViewを作成していきます。
まず、Default Viewを開いてViewの名前を指定します。
Default ViewはDBを開いた際に開かれるViewで、Domino DesignerのView一覧で見ると星マークがついていることは皆さんもご存知のことでしょう。
ViewのPropertyを開いて、「View Info」タブで以下のようにViewの名前と別名をつけます。
また、「Options」タブでは以下のようにDefault Viewの指定はそのままにし、階層表示のViewが指定されていますので、その設定をはずします。
今回は、Workflowなので、返答文書(Response Doc)というのは存在せず、意味がないからです。
更に、「Style」タブの指定を以下のように行います。
ここでは、Otherの部分で、選択余白の表示と最後のカラムをWindowの幅まで広げる指定を行っています。
選択余白を表示するのは、複数の文書を選択して一括処理が出来るようにしておくためです。
また、最後の列の幅をWindowに合わす指定は、定義する列がWindow幅より短くなった場合にViewの列が途中で切れたように見えないためです。
ただ、この最後の列をWindows幅に合わせる指定は、最後の列が申請内容など、列幅が伸びても問題ない場合に利用します。
最後の列が数値であったりした場合は、数値列が間延びしてしまい、かえって見にくくなってしまうことがありますので、注意が必要です。
また、これから作成していくViewは申請者別にCategorizeされたViewですが、Workflowという性格上、申請文書にはReaders制御が行われていますが、その場合、自分が作成した申請書か自分が承認権限のある申請書しか見ることができない訳です。
それ以外の人が見ると、他の申請者の申請書は名前でカテゴライズされている場合、名前(Category)は見えても中身の文書は表示されないという状態になります。
皆さんの中には、他の人が申請しているという事実すら見せたくないという方もいらっしゃるかも知れません。
その場合は、行(Rows)設定で「Don't show empty categories」にCheckを付けると自分が見えない文書ばかりが入ったCategory(今回の場合は申請者名)は見えなくすることもできます。
この機能はNotes/Domino R5以降で拡張された機能であり、R4.6以前では使うことができません。
ただ、この指定を行うと、Viewの表示のPerformanceは使わない場合よりも悪くなってしまいます。
名前くらい見られても問題がないということであれば、このOptionは使わない方がよいのです。
今回は、このOptionは使わないようにしておきます。
また、Readers制御を行った場合のViewのPerformanceについては、以前「Performance Design Tips : 文書単位の権限制御」 でも紹介していますので、参照してください。
また、少し話がそれますが、Notes/Domino 6以降ではViewのGridを指定したりといった見栄えを変えるOptionが数多く拡張されていますので、これらを変えることにより、より美しい画面設計ができるようになっています。
更に、「Advanced」タブで、未読文書表示はなしにし、ODBC AccessのUnique Key生成を指定します。
以前、「Performance Design Tips : 文書単位の権限制御」 で紹介した方法は、Readers FieldでSortしたViewを用意することでしたが、このODBC AccessのUnique Keyを生成することでもReaders Fieldで制御された文書を含むViewのPerformanceを向上させることができます。
かといって、Readers Fieldで制御された文書を数多く含むDBというのは文書が増えるにつれPerformanceが悪化していくことは皆さんもご存知のことでしょう。
そういうことから、WorkflowのDBでは定期的に承認が完了した文書を別のDBにArchiveしていくこともPerformanceを考慮する上で非常に重要になるのです。
皆さんの会社のWorkflow Applicationも定期的に別のDBに退避され古いものは、法的証拠としてCD ROMなどにBackupして改ざん不可能なDataとして残されているのではないでしょうか?
今回は、Viewの基本的なPropertyの設定を行いました。
次回は、Viewの列の定義を行っていくことにしますが、列の定義を行う前に、幾つかのテスト文書を用意しておいて下さい。
Viewの設計では、どのように表示されるのかを見ながら設計するのが一番確実に設計する方法なのです。
UserIDを変えて、申請中の物や、承認完了した物などを複数作成しておいて下さい。
では、次回はViewの列の定義を行っていきます。
Workflow Applicationを開発してみよう -7-
<話題の履歴>
Workflow Applicationを開発してみよう -6-
Workflow Applicationを開発してみよう -5-
Workflow Applicationを開発してみよう -4-
Workflow Applicationを開発してみよう -3-
Workflow Applicationを開発してみよう -2-
Workflow Applicationを開発してみよう -1-
前回は、Form設計のうちのActionの設計を行いました。
前回の設計でFormの設計は終わったことになります。
今回は出来上がった設計が設計意図通りに動いているかを見ていくことにします。
Notes/Dominoというのはこのように作成途中であっても、Applicationを試してみて見栄えや操作性を確認しながら試せるといのが非常に便利なところです。
このような機能があるから、RAD Toolとして日本の多くの皆さんに支持されてきたのです。
ただ、その前に、前回に書かなかったことが一つだけあります。
Action ButtonはR5までは四角い箱にICONを付けるくらいの装飾しかできなかったのですが、Notes/Domino 6以降では、Action ButtonをImageで指定することができるようになっています。
例えば、Notes/Domino 6以降のDiscussion Templateを見ると、以下のようになっていることが分かるでしょう。
Action ButtonがあるImageで囲まれた形になっているのです。
今回は、これと同様にAction ButtonにImageを利用して見栄えを少しだけ良くしています。
これを行うためには、まず、Imageの登録が必要ですが、今回はNotes/Domino 7のDiscussion Templateで利用されているAction ButtonのImageを利用しています。
Discussion TemplateのImage Resourceから、ActionButton.gifをCopyしてShared ResourceのImageに貼り付けを行えばよいだけです。
貼り付け時に設計を引き継ぐかどうかを尋ねて来ますが、設計を引き継がないようにしておきます。
次にAction BarでこのImageを使うために設定を行うわけですが、設計したFormを開いて、Action Paneを右クリックすると、Action Bar Propertyがありますので、Button Propertyタブで登録したImageを指定します。
また、今回は、Action Barの背景色の設定も行っています。
勿論、背景にもImageを用いることは出来ますが、今回は単純に色指定のみとしています。
さて、それでは、出来上がったFormを実際に見てみますが、Designerを使われたことのある方ならご存知のように、Domino Designerには設計した内容をPreviewする機能を持っています。
上図の「Notes Preview」を使うことで、Notes Clientで見た場合のCheckをすることが出来ますし、Web ApplicationならIEでのPreviewを使うことができます。
ただ、このPreviewで見る場合は、Application設計者のIDで行う必要があります。
恐らく皆さんの会社では、Application設計者が通常のIDではなく開発者専用IDを使われている場合もあるかと思います。
それは、Notes ClientのECLを会社で決めていて、別のIDでApplicationの設計要素に署名することを認めていないからという場合もあるでしょう。
署名だけの問題ならApplicationをUserに開放する前に署名をやり直せば良い訳ですが、Designerライセンスの数の関係から制限されている場合もあるのではないかと思います。
そのようなIDを使った場合、通常、本番環境では組織情報などはそういった開発者専用IDには設定されていませんので、今回のようなWorkflow Applicationの場合は利用できない場合もあるのではないでしょうか?
閉じた開発環境を別途用意されている場合は開発/テスト用IDに組織情報を与えても問題はありませんが、皆さんの環境ではちょっとしたDB開発なら本番環境で開発されている場合も多いのではないかと思います。
そのような環境では、開発者IDに本番に影響を与えるような組織情報などを与えていなかったり、別名を設定していなかったりする訳ですから、今回のような別名や組織情報を使う場合には確実なテストができないということになります。
そういう場合は実際のUserIDに切り替えて表示をしてみることも必要になってきますが、Workflowの場合は、承認者への経路制御やMail通知など複数のIDで稼動確認が必要となりますので、Workflow開発では開発環境を作成した方がよいのです。
今回は、別名の無い管理者IDで設計しましたので、別名を持ったUserIDに切り替えて稼動を確認してみましょう。
DBを開くと、ViewはDefaultで提供されているViewが開きますので、作成メニューから作成したFormを選択して新規に起票します。
以下のようなFormが開かれ、上司情報なども正常に設定され、Action Buttonも指定したImageを使って表示できていることがわかります。
今回は、入力項目は設定していないため、Mail通知設定くらいしかできませんが、保存ボタンや申請ボタンが正常に稼動することを確認します。
承認依頼Mailが送信され、承認者IDでMailに貼り付けられた文書Linkが開けることや、状況によってAction Buttonの非表示制御が正常に動くことが確認できますし、上司が設定されていないUserIDを使った場合は以下のようなErrorが表示され、文書の保存も申請もできなくなっていることが確認できるでしょう
また、申請された申請書の承認処理も正常に処理されることも確認できるハズです。
こういったFormの基本的な設計の動きが確認できればFormの設計は完了です。
実際のApplicationの場合は、Form内に設定されたLogicの検証や入力を誤った場合のError処理など様々なテストが必要になってきますが、今回は簡単なサンプルですので、この辺にしておきます。
次回は、Viewの設計を行っていきます。
Workflow Applicationを開発してみよう -6-
<話題の履歴>
Workflow Applicationを開発してみよう -5-
Workflow Applicationを開発してみよう -4-
Workflow Applicationを開発してみよう -3-
Workflow Applicationを開発してみよう -2-
Workflow Applicationを開発してみよう -1-
前回は、Form設計のうち、Field設計を完了しました。
今回は、このFormにAction Buttonを付けて処理ができるようにしていきます。
Workflowの場合、当然のことですが、申請したり承認したりという行為を行いますが、こういった処理は申請Formを開いて内容を確認してから処理するのが通常でしょう。
従って、FormのActionとしてこういった処理を記述する必要があります。
まずは、基本の申請Formを起票して、Draft保存する場合です。
保存Action :
単純に保存して画面を閉じるActionを記述します。
@Command([FileSave]);@Command([CloseWindow])
これで、単純にFormを保存して画面を閉じるというActionになります。
前回、PostOpen Eventで承認者のNotes IDが設定されていない場合の処理を以下のように記述しました。
@If(@IsNewDoc & Approver=""; @Do(@Prompt([Ok];"エラー";"承認者が設定されていません。管理者に連絡してください。");@SetField("SaveOptions";"0"));"")
この処理により、もし、承認者(Manager)がDomino Directoryに設定されていない場合は、SaveOptions Fieldが"0"に設定されます。
Notes/Dominoの開発を行ってきた皆さんにはおなじみのSaveOptions Fieldですが、このFieldに"1"が設定されているとFormを保存する、"0"が設定されていると保存しないという動きをします。
ただ、この設定を行っても、@Command([FileCloseWindow])という@Commandを記述すると、文書を保存するかどうかを確認するDialogが表示されてしまいます。
これを避けるためには、R5以前では@PostedCommand([FileCloseWindow])と書く、6以降では@Command([CloseWindow])と書く必要があるのです。
また、保存のActionというのは、編集している場合だけ表示されていればいい訳ですし、状況によっては表示したくない場合もあります。
Notes/DominoではActionの表示条件を簡単に指定することができるようになっています。
今回は以下のように通常の編集Modeで開いた場合だけ表示されるように設定します。
編集Action :
Draft保存した場合に、再度申請Formを開いて編集することもありますので、編集Actionも必要です。
今回は単純に以下の式を書いたActionを定義し、当然、読み込みMode以外では表示されないように設定します。
@Command([EditDocument])
申請Action :
Workflowの場合は当然申請処理が必要ですから、申請Actionを定義する必要があります。
申請処理というのは、作成した申請Formを保存して、申請者自身には文書を編集不可能にして、承認者に編集を許すという処理が必要ですし、同時に申請したことを承認者にMailで送付する処理も執拗です。
今回は、申請Actionとして以下のような式を記述します。
@If(Approver="";@Do(@Prompt([Ok];"エラー";"承認者が設定されていませんので申請はできません。管理者に連絡してください。");@Command([CloseWindow]);@Return(""));@Success);
FIELD Editor :=Approver;
FIELD Readers :=Creator:Approver;
FIELD Status :="1";
@Command([FileSave]);
@If(SendMail="1";@MailSend(Approver;"";"";"申請の承認をお願いします";"以下の申請のご承認をお願いします。";"";[IncludeDoclink]);@Success);
@Command([CloseWindow])
最初に、承認者(Approver)が設定されているかどうかを判断し、設定されていなければ当然申請は無意味ですから、申請できないように処理します。
次に重要なのが、編集者を承認者に変更することと文書を参照可能なUserとして承認者を追加することです。
また、Statusを変更することも必要です。
そういう処理を@関数式で簡単に行っているのが上記の式です。
更に、Mailによる承認者への承認依頼通知を送る処理をするのですが、この際文書そのものを送ってしまっても仕方の無いことです。
Notes/Dominoは簡単に文書Linkを送ることができます。これにより、Mailを受け取った相手はLinkをたどって自分が承認しなければならない文書を簡単に開くことができるのです。
Webであれば、URLを記述して送るようなものです。
そのために、以下のように記述しています。
@Command([FileSave]);
@If(SendMail="1";@MailSend(Approver;"";"";"申請の承認をお願いします";"以下の申請のご承認をお願いします。";"";[IncludeDoclink]);@Success);
ここで重要なのは、先に文書を保存することです。
一度Draft保存された申請書なら問題がないのですが、新規に起票された申請書はまだ保存されておらず、文書Linkに最も重要な文書のUNIDが生成されていないからです。
文書を保存して文書のUNIDを確定してから、文書Linkを含んだMailを送信することが重要なのです。
また、この申請Actionというのは、承認者には必要あrませんし、既に申請した文書を申請者が開いた場合にも必要ありません。
こういった状況によってActionの表示/非表示を制御することもNotes/Dominoでは簡単にできます。
以下のように、条件が一致した場合に表示しないという設定ができるようになっています。
今回の場合は、Edtor Fieldが現在の編集可能なUser IDを保持していますので、ボタンを押すUserが編集可能なUserであり、かつ、Workflow Statusが"0"(新規申請かDraft保存している場合)に表示する必要があります。
しかし、非表示制御式は表示しない場合を記述する必要がありますので、表示したい条件全体を()でくくり、NOT(!)で否定することで簡単に設定ができます。
論理式が複雑になる場合、このようにNOTで否定して指定した方が皆さんにとっては条件が考えやすく楽なのではないでしょうか?
承認Action :
Workflowですから、当然承認Actionも必要になります。
今回は、以下のように書いてみました。
StatusCode :="2":"3":"9";
StatusDisp :="承認":"却下":"差戻し";
Approve :=@Prompt([OkCancelList];"承認処理";"処理を選択してください。";"承認";StatusDisp);
@DoWhile(FIELD Comment :=@Name([CN] ;@UserName(1))+ " : "+@Prompt([OkCancelEdit];"コメント入力";"コメントを入力してください。" ;"");Comment="");
FIELD Status :=@Replace(Approve;StatusDisp;StatusCode);
@If(Status ="9";@SetField("Editor";Creator);@SetField("Editor";""));
@Command([FileSave]);
@If(SendMail="1";@MailSend(Creator;"";"";"【"+Approve+"】"+"申請の承認処理が完了しました。";"以下の申請のご承認処理が完了しました";"";[IncludeDoclink]);@Success);
@Command([CloseWindow])
承認処理の選択を行わせて、承認処理の行った際に、コメントを入力させるようにしていますが、コメントなしでは承認処理ができないように処理しています。
Notes/Domino R5以前では、こういった処理は@関数式で処理するのは面倒でLotusScriptで書かれている場合もあるのではないかと思いますが、Notes/Domino 6以降では@DoWhileなど、Loop処理する関数が提供されたため、@関数式だけでもかなりの処理が書けるようになっています。
今回は、@DoWhile(FIELD Comment :=@Name([CN] ;@UserName(1))+ " : "+@Prompt([OkCancelEdit];"コメント入力";"コメントを入力してください。" ;"");Comment="")
という式で、コメントが入力されていない間はコメント入力を促すようにしています。
この式で気が付いた方もおられるでしょうが、式の中で"Field XXX :="という変数への値の代入が記述できるようになったのもNotes/Domino 6以降からです。従来は@SetFieldを使わなければなりませんでした。
ここでは一段階承認のため、コメントが複数あることは考慮されていませんが、FIELD Comment :=@Name([CN] ;@UserName(1))+ " : "+@Prompt([OkCancelEdit];"コメント入力";"コメントを入力してください。" ;"")の記述ではコメントがある場合に再度コメントが入力された場合は対応ができません。
複数のコメントが付く場合には、
Field Comment := Comment + @If(Comment="";"";@NewLine) + @Prompt...
のように処理すべきでしょう。
また、Workflowですから、選択された承認状態によって、誰も編集できないようにしたり、差し戻しの際には、申請者に編集権限を与えて戻すようにしています。
同時に申請者にMailで通知する処理も行っているのです。
この承認処理も、申請者に表示されても仕方ありませんので、以下のように非表示制御を行っています。
再申請Action :
差し戻しされた場合の再申請Actionも必要です。
今回は、以下のように記述しています。
FIELD Editor :=Approver;
FIELD Readers :=Creator:Approver;
FIELD Status :="1";
@Command([FileSave]);
@If(SendMail="1";@MailSend(Approver;"";"";"申請の承認をお願いします";"以下の申請のご承認をお願いします。";"";[IncludeDoclink]);@Success);
@Command([CloseWindow])
当然、再申請の場合は、差し戻しされた場合のみ表示が必要ですから、以下のようにボタンの非表示制御をかけています。
今回は、Field Actionの定義を行いました。
これでFormの設計は完了なのですが、次回はここまで作成したFormがどのようにできているかを確認することにします。













