システム連携ネタでよくブログを書いている日下です。

 

ここ最近、ご要望をいただいたりして、いくつかビジネスチャット(社内 SNS)ツールとの連携のための「アドオン XML(サービスタスク定義ファイル)」を準備しました。

今回は Hangouts Chat です。

 

目次
1: Hangouts Chat と Questetra の連携の概要
2: Hangouts Chat 側の設定
3: Questetra 側の設定
4: まとめ

 

1: Hangouts Chat と Questetra の連携の概要

処理の流れとしては、以下のような形となります。
フローサンプルとしては Questetra 上での稟議の結果が出たら、その内容を詳細リンクを Hangouts Chat に投稿します。

 

2: Hangouts Chat 側の設定

チャットルームを作成した後、Webhook の設定をして投稿 URL を取得して、メモしておきます。

 

3: Questetra 側の設定

以下の「アドオン XML」を使います。

※API 定義にあわせて「メッセージ送信中間イベント(HTTP)」を設定することでも対応可能ですが、「アドオン XML」を使う方がカンタンです。

※「メッセージ送信中間イベント(HTTP)」の詳細については、以下をご覧ください。
 M225: 業務データを組み込んだHTTPリクエストが、自動的に送信されるように設定する

ファイルを以下ページからダウンロードして、こちらのページ(マニュアル M415)を参考にインポートしてください。

 Hangouts Chat メッセージ投稿

設定項目は以下の通り。

項目名 必須 形式
A: エンドポイント URL 必須 さきほど取得したエンドポイント URL を入力
B: 投稿テキストが格納されている文字型データ項目 必須 投稿したいテキストが入っている文字型データ(複数行)を指定
X: ログが格納される文字型データ項目 (更新) (任意) ログを出力したい場合に文字型データを指定

※投稿テキストのデータの初期値として、以下のような指定をしておくと、自動的に文面が準備されます。
(「XXX.questetra.net」には環境ごと値を入れてください。ここでは後述の「${var[applicationRoot]}」という書式は使えません)

承認されました。[詳細リンク](https://XXX.questetra.net/OR/ProcessInstance/listView?processInstanceId=#{processInstanceId})
 もしくはアドオンの前に「サービスタスク(データ設定)」を置いて、文面作成する方法もあります。
  関連マニュアル M227: 業務データの結合や四則演算が自動実行されるように設定する

 

4: まとめ

動かしてみると、以下のような形で投稿されます。自動的にリンク先の画像も入りました。

このようにカンタンな設定だけで Hangouts Chat への投稿処理を業務フローの途中に埋め込むことができます。

もし、ご質問等がありましたら、お問い合わせフォームからお気軽にご連絡ください。