フォームに入力したテキストをGoogleドキュメントとしてGoogleドライブに保存する

開始イベント

• 接続している『タスク』が業務プロセス（ワークフロー）の先頭タスクとなる
• 先頭タスクは人間が手動起動できる

タイマーで自動起動を実施するだけであれば、本来は（今回の要旨を実施するだけであれば）開始イベントは使用しません。しかし、デバッグのために手動でこのプロセスを起動することもあるかと考え、「手動起動用」に使用します。

タイマー開始イベント

• 日・週・月・年など、繰り返し開始されるべきプロセス（業務）を自動的に起動する
• 月末申請、日報報告など

今回は毎週金曜日の朝10時にこのアプリを起動させるために使用します。

フロー

「フロー」パーツはどんなアプリでも毎回使用しますので、説明は割愛。

ヒューマンタスク

• 業務プロセス（ワークフロー）を構成する作業工程（仕事）
• 業務プロセスは、通常は１つ以上の『タスク』（仕事）から構成される
• １つの『タスク』（仕事）につき、１つの「入力フォーム」が定義される

※ 自分が処理を担当する事になったプロセスを、特に「マイタスク」と呼ぶ

今回は「アジェンダ入力」の為に、ヒューマンタスクを使用します。

サービスタスク（データ設定）

• 業務プロセス（ワークフロー）を構成する自動処理工程
• プロセス（業務）が到達した際に、自動的に計算をする

今回は2つの用途で使用します。
用途1：自動で会議日時を計算・算出
用途2：用途1で算出された日時を、自動で「件名」と「ファイル名」に差し込む設定をする為

ジェネレータ（テキストファイル）

• 業務プロセス（ワークフロー）を構成する自動処理工程
• 任意のテキストファイルを生成し、ファイルデータ項目に格納します

「ヒューマンタスク」で入力されたテキスト情報を「テキストファイル」に自動生成する為に使用します。

Google ドライブ：ファイルアップロード

• 業務プロセス（ワークフロー）を構成する自動処理工程
• プロセス（業務）が到達した際に、ファイル型データを Google ドライブに自動保存する

「ジェネレータ（テキストファイル）」で生成されたテキストファイルをGoogleドライブにアップロードするために使用します。アップロードと共に、アップロード先の「フォルダURL（閲覧用と編集用の2つ）」を設定・取得します。

Google ドライブ: ファイル, コンバート

• Googleドライブ内の任意のファイルを、別の MimeType ファイルに変換して新規保存します。
• Googleファイルだけでなく、一般的なファイルもサポートします。
• 画像ファイル（JPEG, PNG, GIF, PDF）を「Google ドキュメント」に変換すると OCR テキスト抽出が実行されます。

Google ドライブにアップロードされたテキストファイルを Google ドキュメント形式に自動で変換します。地味に便利です。変換されたファイルのURLを取得します。

並列ゲートウェイ

• 複数進路の全てに分離して進む　（プロセスの分離）
• 同時並行処理になる

今回は、自動的に立ち上がったタスクを並列で2つの部署に割り振る為に使用します。

結合ゲートウェイ

• 複数に分かれた進路を集約する
• プロセスが分離した際は、結合ゲートウェイ上で、先着側が遅着側を待つ

各部署で処理されたタスクの処理完了を受け、次の工程へタスクを進めるために使用します。

1. スイムレーン
   
   マーケティング部に所属する人が処理するレーンです。
   
   マーケティング部の誰が引き受けても良いように「チーム」スイムレーンを使用しています。

2. スイムレーン
   
   営業部に所属する人が処理するレーンです。
   
   営業部に所属する人が誰でも引き受けられるように「チーム」スイムレーンを使用しています。

3. タイマー開始イベント
   
   タイマーで自動的に立ち上がる工程です。定期的に自動で起動して、アジェンダ入力のタスクを促します。
   
   画像では開始日時を「毎週金曜日　09:00」に設定しています。

4. ヒューマンタスク
   
   手動起動の工程です。
   タイマーで設定された日時以外にこのワークフローを起動したい際やテストしたい際に使用します。

5. ヒューマンタスク
   
   会議の日時を手動で入力する工程です。開始工程が「4」で起動された際にのみ入力する項目です。ここで入力された日時は、アジェンダ内の会議日時や件名に使用されます。

6. 結合ゲートウェイ
   
   3もしくは5の工程の完了を受け、次の工程にタスクを移動する役割のゲートウェイです。

7. 自動処理工程：サービスタスク（データ設定）
   
   会議日時設定。
   
   タイマーでこのアプリが自動で起動された日時を基準として「何日後の何時に」会議が実施されるのか、自動で計算します。
   
   例：
   タイマーでの自動起動日時：2021-06-01 10:00
   
   上記の日時を元に、「3日後」の「10時」と会議日時を定めたい場合は、以下のように式を挿入します。
   
   processInstanceStartDatetime.addDays(3).getFirstTimeInDate().addHours(10)
   
   processInstanceStartDatetime：これはアプリが起動された日時です
   .addDays(3)：()内の数値でn日後の指定をします。この場合は3日後です。
   getFirstTimeInDate()：addDaysで指定された日時の「何時」を基準とするか定めています。
   addHours(10)：基準時から何時間後を指定しています。

8. 自動処理工程：サービスタスク（データ設定）
   
   議事録件名設定。
   
   ファイルの件名に7で算出された日時を自動挿入します。
   
   日時以外にも任意の文字列や自動的に取得した文字列を挿入することが可能です。

9. 自動処理工程：ANDゲートウェイ
   
   以降の工程に「並列」でタスクを渡すためのゲートウェイです。

10. ヒューマンタスク
    
    議題入力。「1」のスイムレーンで設定したグループに所属する人間がアジェンダを入力する工程です。

11. ヒューマンタスク
    
    営業部議題入力。「2」のスイムレーンで設定したグループに所属する人間がアジェンダを入力する工程です。

12. 結合ゲートウェイ：10と11の工程の完了を受け、次の工程にタスクを移動する役割のゲートウェイです。

13. 自動工程：ジェネレータ（テキストファイル）
    
    10と11で入力したテキストデータを「ひとつのファイル」に自動生成する工程です。
    
    ・生成したファイルの保存場所（項目名）
    ・保存するファイル名
    ・テキストファイルの内容
    
    を、設定しています。
    
    ここでは自動で「会議日時」と「アジェンダ」が設定されるように、参照から「データ項目」を差し込んでいます。
    
    例）
    #{#q_mtg} = 会議日時のデータ項目
    #{#q_yoken} = マーケティング部のアジェンダが格納されているデータ項目
    
    
    

14. 自動工程：Google ドライブ：ファイルアップロード
    
    Google ドライブへファイルをアップロードする自動工程です。
    
    事前に
    ・アカウント設定 > Google連携
    ・システム設定 > セキュリティ > Google連携
    の設定をしておく必要があります。
    
    ここでは以下を設定します。
    
    ・Googleドライブに接続するユーザー
    ・アップロードするファイルが保存されているデータ項目（GoogleドライブのURLのお尻の文字列）
    ・ファイルアップロード先のフォルダID
    ・ファイルIDを保存するデータ項目
    ・表示用URLを保存するデータ項目
    ・ダウンロードURLを保存するデータ項目
    ・エラー内容を保存するデータ項目
    
    上記のうち「ファイルアップロード先のフォルダID」以外は、事前にデータ項目を作成しておく必要がありますのでご注意下さい。

15. ヒューマンタスク
    
    Googleドライブへアップロードしたテキストファイルの内容をGoogleドキュメントへ変換する前の最終確認工程です。
    
    「編集の可否」項目で、各項目を「編集・閲覧・非表示」のどの状態で表示させるか選択します。
    
    まあこの工程は最終確認ですので、今回の場合は「開始日時」「議題」「議題：営業部」が表示（閲覧）できるようにしておけばOKだと思います。
    
    文字化けなどをチェックします。

16. 自動工程：Google ドライブ：ファイル、コンバート
    
    Google ドライブ上のテキストファイルを Google ドキュメント形式のファイルに変換する工程です。
    
    ここで項目を設定する前に以下2点の設定が必要です。
    
    Google Drive とのOAuthの設定
    
    右の画面の「設定はこちらから」ボタンを押すと「HTTP 認証設定」の画面が表示される。
    この文章のブロックの次のブロックに設定方法を記載しているのでそちらを参照し設定する。
    
    addonの設定
    以下のリンクよりダウンロードし、アプリ詳細 > アプリ > アドオンの管理 > サービスタスク定義ファイル　よりアップロードしておいて下さい。
    
    ダウンロードしておくaddonファイル
    Google ドライブ: ファイル, コンバート – Questetra Support
    
    上記2点を設定した上で、以下の項目を設定していきます。
    
    ・サービスタスク定義ファイル：Google-Drive-File-Convert-2021.xml
    ・通信許可の設定名：次章で設定したHTTP認証の設定名を選択
    ・新しいファイルが保存されるフォルダ名：任意。
    ・新しいファイルのMime Type：application/vnd.google-apps.document
    ・編集用URLを取得したい場合のデータ項目：Googleドキュメント

17. 自動工程：メッセージ送信中間イベント（メール）
    
    作成されたGoogle ドキュメントを関係者に宛てメールで周知します。
    
    以下の項目の設定が可能です。
    
    送信元：送信者のメールアドレス
    TO：宛先メールアドレス
    Cc：任意
    Bcc：任意
    メールの件名：今回は自動で会議日時の差込みを行っています。
    本文：今回は自動で「会議日時」「GoogleドキュメントのURL」の差込みを行っています。

18. 終了イベント
    
    全ての工程の完了を受け、プロセス自体を終了する工程です。

Google Cloud Platformにログインする
https://console.cloud.google.com/
※アカウント作成の必要あり
※APIでのコールは、ものにより有料と無料のものがある
※GoogleドライブへのOAuth認証だけであれば無料で利用可能

APIとサービス > 認証情報 へ進む

+ 認証方法を作成 > O Auth クライアントID を選択。

開いた画面で以下の内容で設定する

・アプリケーションの種類→ウェブアプリケーション
・名前→わかりやすいものでOK
・承認済みの JavaScript 生成元（2つ入力）
1.自身のQBPMSのURL（例：https://kimura.questetra.net）
2.指定のQBPMSのURL（https://s.questetra.net）
承認済みのリダイレクト URI
1.自身のQBPMSのURL（例：https://kimura.questetra.net）
2.指定のQBPMSのURL（https://s.questetra.net）
3.指定のURL(https://s.questetra.net/oauth2callback)

保存すると右側に「クライアントID」と「クライアントシークレット」が表示されるので、それを保存しておく（QBPMS上の設定で使用します）