使い方... for Slack
使い方・レセプション for Slack
- アドオンはメッセージ送信機能だけを実装しています。（検証済）
- Slackのワークフロー機能を利用するには、あらかじめワークフロービルダーを使ってワークフロー用のアクションを設定し、Webhookを使用した連携の設定をするなど、Slack側の準備が必要です。（未検証）
目次
【管理者編】
【利用者編】
❃❃❃
【管理者編】
1. アドオンパッケージを作成する
- マーケットプレイスへの登録ができるようになれば、アドオンの提供方法も簡単なのですが、アドオンを作成する機能自体が今時点（2021/1/10）でまだプレビュー版のため、ローカルな環境にアドオンを保存するスクリプトを含んだカスタムAppを丸ごと提供することにしました。以下の手順により、実行した環境でのアドオン参照ができるようになります。
 |
| レセプション for Slack の起動画面です。 |
a. アドオン部品
- アドオン作成スクリプトが使用するレイアウトオブジェクトです。
- __parent_key ＞このアドオンがレイアウトテーブルのレコードとリレーションを持つことをアドオン作成スクリプトに知らせるためのフィールドです。値は必要ありませんが、オブジェクト名にルールがあるようです。（詳細は参考にしたサイトをご覧ください。）フィールドは空のままにしておいてください。
- ボタンバー ＞アドオンオブジェクトです。
b. 言語設定初期値
- アドオンで表示する文言,ダイヤログメッセージの言語を設定できます。
- アドオンでの言語切り替えは、以下のように機能します。
※レセプション for Redmineの説明画像を利用しています。
c. バージョン
- アドオンのバージョン設定フィールドです。
d. プレビュー画像
- ユーザーがアドオンをインストールする際に、アドオンアイコンを選択すると表示されるプロフィール情報に含まれる画像です。
e. アドオン作成ボタン
- アドオン作成ボタンを押して作成します。以下にその手順を記述します。
 |
| 続行するには『OK』を押します。 |
 | ||
アドオンの保存先ディレクトリが自動的に開きます。ここでの操作は不要です。
|
- 以上で自端末のアドオンライブラリに『レセプション for Slack』が登録されます。
2. アドオンをインストールする
【注意】レセプション３部作から複数をひとつのカスタムAppにインストールしようとすると（現時点でのFileMaker19.2.1.14は）フリーズします。ひとつのカスタムAppにひとつのレセプションシリーズをインストールしてください。
- ここでは、Claris社が提供しているサンプルファイル『資産』を例にしてアドオンのインストール手順を説明します。
- レイアウトモードでアドオンタブを選択します。
- 『＋』ボタンを押します。
- インストールしたアドオンを選択し、『選択』ボタンを押します。
- アドオンタブにインストールしたアドオンのアイコンが登場します。
- アドオンのアイコンをレイアウト内にドラッグ＆ドロップすると、アドオン部品が登場します。
☝to top
3. インストール後の設定
アカウントの権限がフルアクセスの場合、ボタンバーの設定ボタンが表示されます。
アドオンの設定は、フルアクセスの権限を持ったアカウントのスタッフが、この設定ボタンで一度だけ初期設定を行うことを想定しています。
3.1 設定＞接続
a. WebhockURL
- Slack Incoming Webhockで生成したURLを設定します。
- Slackのウィンドウ
- Slackをブラウズする＞App＞Incoming Webhookを追加＞設定
- slack app directryのウィンドウ
- Incoming Webhook＞設定＞設定を編集アイコン＞インテグレーションの設定＞Webhook URL
b. チャンネル
- 上記インテグレーションの設定＞チャンネルへの投稿で指定したチャンネルを設定します。
c. ユーザー名
- 上記インテグレーションの設定＞名前をカスタマイズ で指定したユーザー名を設定します。
d. 『テスト』ボタン
- Slackとの疎通をテストできます。テストメッセージが送信されます。
 |
| 設定ウィンドウ・接続 |
 |
| 設定ウィンドウ・接続で『テスト』をクリック |
- 『"これはテスト投稿です。"送信』ボタンにより、該当のSlackサイトの該当チャネルにテストメッセージが投稿されます。
 |
| テストが成功したSlackサイト |
3.2 設定＞初期値を編集／内容
a. フィールド名を選択して編集
- 投稿内容に含めたいレイアウトのフィールドを選択します。複数選択した場合は、フィールドの値ごとに改行します。
b. 自由書式で編集
- 投稿内容を自由に編集できます。固定文字列はダブルクォーテーションで囲い、連結させたい場合は "&" を使います。
- Evaluate関数を使っているので、標準の関数やカスタム関数も使用できます。例えば、データベース名称を先頭に含めたい場合は、Get(filename)関数を記載します。（WebDirectではサーバサイドで動く標準関数は英語表記のみの対応のため、filenameと記載します。）
- ポータルの値を列挙したい場合はList関数が使えます。しかし、関連レコードが全て列挙されるため、先頭のn件だけを表示したい場合は、カスタム関数 RS_top( List(テーブル名::フィールド名); n ) を使ってください。
3.3 設定＞SlackのチャンネルURL
a. チャンネルURL
- SlackのチャンネルページをFileMakerの利用者に公開する場合は、ここにチャンネルのURLを設定します。
b. 『テスト』ボタン
- Slackのチャンネルページを標準ブラウザで開きます。
c. チャンネルURLを申請した人に公開する
- SlackのチャンネルページをFileMakerの利用者に公開する場合は、”ON”にします。
3.4 設定＞FileMakerのURL
a. リンク用基本URL- Slackへの送信内容に、FileMakerServerのURLを埋め込む場合は、FileMakerServerのトップURLを設定します。ファイル名は自動的に埋め込まれます。
b. 『テスト』ボタン（左）
- 『テスト』ボタン（左）はFileMakerServerのトップURLを開きます。
c. 『テスト』ボタン（右）
- 一度送信済みのレコードでこの画面を開くと、実際にSlackに埋め込まれるURLの『テスト』ボタン（右）が表示されます。FileMakerの該当レコードを開くURLです。（主キーとクイック検索を使用します。）
- 一度送信済みのレコードでこの画面を開くと、実際にSlackに埋め込まれるURLの『テスト』ボタン（右）が表示されます。FileMakerの該当レコードを開くURLです。（主キーとクイック検索を使用します。）
d. 送信内容にリンクを含む
- FileMakerのURLを送信内容に含める場合は"ON"にします。
参考
- 管理＞セキュリティ＞詳細設定＞拡張アクセス権
- この機能を"ON"にする場合は、fmurlscript 権限が必要です。
- WebDirectで公開する場合は、fmwebdirect 権限が必要です。
3.5 設定＞このアドオンについて
【利用者編】
1. 設定後の使い方・申請
- レコードが入力されている状態からの手順です。
- アドオンのボタンバーよりフルアクセスのアカウントの場合は左のボタンを押します。（フルアクセス以外は、左のボタンだけが表示されます。）
1.1 申請＞Slackによる受付
a. 内容
- 投稿されるテキストです。管理者によって予め設定されたルールによって自動編集されたものを表示します。
b. 『送信』ボタン
- Slackへデータが送信されます。
1.2 参考・送信ボタンを押した後の状態
- 送信ボタンを押すとSlack側にデータが送信され、次のダイヤログが表示されます。
- OKを押します。
- Slackの該当チャンネルに投稿されています。
- FileMakerのURLも埋め込まれています。
2.1 訂正＞再申請する内容
a. 最新のフィールド内容
- レコードを修正した場合など、再申請する流れを想定してます。最新のフィールドの内容を自動編集しています。
b. 前回の送信日時
- 既に送信済みの場合、前回の送信日時を表示します。
c. 『Slack URL』ボタン
- "チャンネルURLを申請した人に公開する"が"ON"の場合、表示されます。Slackサイトをブラウザで開きます。
2.2 訂正＞コメントを追加する
a. コメント
- コメントを追加する場合に記入します。再申請の理由など記載することを想定しています。
b. 『送信』ボタン
- Slackへデータが送信されます。
2.3 参考・送信ボタンを押した後の状態
- 送信ボタンを押すとRedmine側にデータが送信され、次のダイヤログが表示されます。
- OKを押します。
- Slackの該当チャンネルに再申請内容が追加投稿されています。
以上
0 comments :
コメントを投稿
注: コメントを投稿できるのは、このブログのメンバーだけです。