IM-BPM for Accel Platform IM-BPM チュートリアルガイド 第18版 2021-04-01

4.3.4.1. IM-Wikiを関連ドキュメントとして設定する

このチュートリアルでは、プロセスやタスクに対し、「IM-Wiki」を「関連ドキュメント」として設定する方法を解説します。
「IM-Wiki」は、「intra-mart Accel Platform」上でWikiページを作成、編集、管理ができる機能です。

プロセスを進めていく中で、「IM-FormaDesigner」を使用します。
チュートリアルを開始する前に「IM-FormaDesigner」で作成したアプリケーションをインポートしてください。

また、「IM-Knowledge」を閲覧するには、「Knowledge コンテンツ利用者」ロールが必要です。
「サイトマップ」→「共通マスタ」→「ユーザ」から「青柳辰巳(ユーザコード : aoyagi)」を検索し、以下の設定を行ってください。
  • 「ロール」タブ - 「Knowledge コンテンツ利用者」ロールの追加

コラム

このチュートリアルで作成する資材のサンプルを以下のリンクからダウンロードできます。
「IM-Knowledgeナレッジグループの認可(ポリシー)」をインポートする際は、ジョブネットパラメータの「 file 」を「 authz_policy-relation_document_wiki.xml 」に変更してください。
これらのサンプルは、各アプリケーションの機能でアップロード、または、インポートして利用可能です。
詳細な手順については、以下のリンク先を参照してください。

コラム

「IM-FormaDesigner」で作成したアプリケーションのインポート方法は以下を参照してください。

4.3.4.1.1. IM-Wikiで業務マニュアルを作成する

関連ドキュメントとして紐づけるWikiを「IM-Knowledge」で作成します。
「IM-Knowledge」のグループを作成し、そのグループにWikiを作成します。
「プロセス開始時に参照するWiki」と「タスク処理時に参照するWiki」を作成します。

注意

IM-Knowledgeグループを作成するためには、以下のいずれかに当てはまるユーザでアクセスする必要があります。
  • IM-Knowledgeグループ管理者の認可と、「認可設定(ポップアップ)」の認可を持つユーザ
  • 「テナント管理者」のロールを持つユーザ
  1. 「IM-Knowledge」のグループを作成します。
    「テナント管理者」でログインします。
  2. 「サイトマップ」→「Knowledge」→「管理」→「グループ一覧」画面を表示します。

  3. 「グループ一覧」の「新規登録」をクリックし、「グループ登録」画面を表示します。

    ../../../../_images/relation_document_wiki_0001.png
    図:「グループ一覧」
  4. 「グループ登録」画面で、項目を以下のように設定します。

    • グループID : relation_document_wiki-wiki_group
    • グループ名(標準) : 任意
    ../../../../_images/relation_document_wiki_0002.png
    図:「グループ登録」
  5. 入力後、「登録」をクリックします。

  6. グループの「参照・編集」の権限を設定します。
    「グループ一覧画面」で「group_list-authz」アイコンをクリックし、「認可設定」ダイアログを表示します。
    ../../../../_images/relation_document_wiki_0003.png
    図:「グループ一覧」
  7. 画面の右上の「権限設定を開始する」ボタンをクリックします。

  8. 「IM-BPM管理者」の「authz_unset」をクリックし、「authz_permit」に切り替えます。

    ../../../../_images/relation_document_wiki_0004.png
    図:「認可設定」
  9. 上記で作成したグループの「コンテンツ」にWikiを作成します。
    「IM-BPM管理者(im_bpm_manager)」のロールが付与されている aoyagi でログインします。
  10. 「サイトマップ」→「Knowledge」→「コンテンツ」→「Wiki新規作成」をクリックし、「Wiki新規作成」画面を表示します。

  11. 「プロセス開始一覧」画面で、プロセスを開始する際に参照できるWikiを作成します。
    項目を以下のように設定します。
    • グループ :上記で作成したグループを選択

    • Wiki名 : 任意

    • Wiki ID : relation_document_wiki-wiki

    • タイトル : プロセス開始時に参照するIM-Wiki

    • テキスト形式 : 任意

    • 本文 : 以下の文章をコピー&ペーストします。

      このように、プロセスを開始する際に参照する資料を紐づけることが可能です。
      今回は、担当者として「青柳辰巳(ユーザコード:aoyagi)を設定します。
      入力フォームの右の虫眼鏡マークをクリックし、「ユーザ検索」ダイアログから``aoyagi``を選択します。
    ../../../../_images/relation_document_wiki_0005.png
    図:「IM-Wiki」 - 「新規作成」
  12. 入力後、「登録」をクリックします。

  13. 「タスク一覧」画面で、タスクを処理する際に参照できるWikiを作成します。
    「新規ページ作成」をクリックします。
    ../../../../_images/relation_document_wiki_0006.png
    図:「IM-Wiki」 - 「【チュートリアル】関連ドキュメントとして設定するIM-Wiki」
  14. 項目を以下のように設定します。

    • 親ページ : 上記で作成したページ

    • タイトル : ユーザタスク処理の際に参照するIM-Wiki

    • テキスト形式 : 任意

    • 本文 : 以下の文章をコピー&ペーストします。

      このように、ユーザタスクを処理する際に参照する資料を紐づけることが可能です。
      「IM-FormaDesigner」の画面で``aoyagi``を指定したため、このタスクが「タスク一覧」に表示されました。
    ../../../../_images/relation_document_wiki_0007.png
    図:「IM-Wiki」 - 「新規ページ作成」
  15. 入力後、「登録」をクリックします。

4.3.4.1.2. プロセス定義を作成する

このプロセスは、「関連ドキュメント」にWikiを設定することで、プロセス開始・タスク処理の際に参照できるようにします。
プロセスを開始する際に、インポートした「IM-FormaDesigner」のアプリケーションを使用します。
../../../../_images/relation_document_wiki_0008.png
図:完成イメージ
  1. 「開始イベント」を配置します。

  2. 「開始イベント」の「プロパティ」 - 「 メインコンフィグ」で項目を以下のように設定します。

    • フォームキー : forma:relation_doc_wiki_select_user
    ../../../../_images/relation_document_wiki_0009.png
    図:「開始イベント」 - 「プロパティ」 - 「メインコンフィグ」
  3. プロセス全体に対する設定を行います。
    キャンバスの余白をクリックし、「プロパティ」をプロセス全体に切り替えます。
  4. 「プロセス」で項目を以下のように設定します。

    • 処理対象グループ : im_bpm_manager
    ../../../../_images/relation_document_wiki_0010.png
    図:「プロパティ」 - 「プロセス」
  5. 「関連ドキュメント」の設定を行います。
    「プロパティ」 - 「関連ドキュメント」の「追加」リンクをクリックします。
    ../../../../_images/relation_document_wiki_0011.png
    図:「プロパティ」 - 「関連ドキュメント」
  6. 「関連ドキュメント」ダイアログの項目を以下のように設定します。
    • ドキュメントタイプ : 外部URL

    • URL : http://localhost:8080/imart/knowledge/contents/wiki_view/relation_document_wiki-wiki/
    • 表示名 : 任意

    ../../../../_images/relation_document_wiki_0012.png
    図:「関連ドキュメント」

    注意

    URLは、チュートリアルを行っている環境に合わせて指定してください。
    今回は 「 http://localhost:8080/imart/ 」 を使用していると仮定し、行っています。

    ベースURLを省略することで、相対パス形式でURLを指定できます。
    例 : knowledge/contents/wiki_view/relation_document_wiki-wiki/

    URLは、絶対パス、または、相対パスで指定してください。
    相対パスの指定は、IM-WikiとIM-Wikiを開こうとしている環境のベースURLが同一の場合のみ利用可能です。

    コラム

    URLの「/wiki/」を「/wiki_view/」に置き換えることで、「編集」ボタンのないWikiを表示させることが可能です。
    例 : ../imart/knowledge/contents/wiki_view/Wiki名
  7. 「決定」をクリックします。

  8. 「ユーザタスク」を配置します。

  9. 「ユーザタスク」の「メインコンフィグ」で項目を以下のように設定します。

    • 担当者 : ${userCd1}
    ../../../../_images/relation_document_wiki_0013.png
    図:「ユーザタスク」 - 「プロパティ」 - 「メインコンフィグ」

    コラム

    ${userCd1} は、「IM-FormaDesigner」で作成した入力フォームのフィールド識別IDです。
    「担当者」にEL式を入力することにより、フォームで指定したユーザをタスクの担当者に設定できます。
  10. 「関連ドキュメント」の設定を行います。
    「ユーザタスク」の「関連ドキュメント」の「追加」リンクをクリックします。
    ../../../../_images/relation_document_wiki_0014.png
    図:「ユーザタスク」 - 「プロパティ」 - 「関連ドキュメント」
  11. 「関連ドキュメント」ダイアログの項目を以下のように設定します。
    • ドキュメントタイプ : 外部URL

    • URL : http://localhost:8080/imart/knowledge/contents/wiki_view/relation_document_wiki-wiki/ユーザタスク処理の際に参照するIM-Wiki?sidebar=false
    • 表示名 : 任意

    ../../../../_images/relation_document_wiki_0015.png
    図:「関連ドキュメント」

    コラム

    URLの最後に「 ?sidebar=false 」を書き加えることで、目次一覧が非表示のWikiを表示させることが可能です。
    例 : ../imart/knowledge/contents/wiki_view/Wiki名 ?sidebar=false
  12. 「決定」をクリックします。

  13. 「終了イベント」を配置します。

4.3.4.1.3. 実行結果を確認する

このチュートリアルで作成した「プロセス定義」を実行環境にデプロイし、実行結果の確認を行います。
「Knowledge コンテンツ利用者」のロールを付与した aoyagi でログインしてください。
  1. 「サイトマップ」→「BPM」→「プロセス開始一覧」画面を表示します。
  2. startable_list-document」アイコンをクリックします。

    ../../../../_images/relation_document_wiki_0016.png
    図:「プロセス開始一覧」
  3. Wikiが新しいタブ、または、ウィンドウで表示されます。
    参照用のURL形式(「 /wiki_view/ 」)を利用しているため、ここからWikiの編集は行えません。
    ../../../../_images/relation_document_wiki_0017.png
    図:プロセス開始時に参照するIM-Wiki(IM-Wiki)
  4. Wikiに従って処理を行います。
    プロセス開始一覧から、「startable_list-start_processes」アイコンをクリックします。
    ../../../../_images/relation_document_wiki_0018.png
    図:「プロセス開始一覧」
  5. 「プロセス開始一覧」画面の左上、「タスク一覧」をクリックします。
    ../../../../_images/relation_document_wiki_0020.png
    図:「プロセス開始一覧」
  6. 個人タスクに、上記で実行したプロセスのタスクがあるので、「task_list-document」アイコンをクリックします。

    ../../../../_images/relation_document_wiki_0021.png
    図:「タスク一覧」
  7. 「ドキュメント」ダイアログから、「ユーザタスク処理の際に参照するIM-Wiki」を選択します。

    ../../../../_images/relation_document_wiki_0022.png
    図:「ドキュメント」
  8. Wikiが新しいタブ、または、ウィンドウで表示されます。
    参照用のURL形式(「/Wiki名 ?sidebar=false 」)を利用しているため、Wikiの目次一覧は表示されません。
    ../../../../_images/relation_document_wiki_0023.png
    図:ユーザタスク処理の際に参照するIM-Wiki(IM-Wiki)