Slack モジュール

Adobe Workfront Fusion のシナリオでは、Slack を使用するワークフローを自動化したり、複数のサードパーティのアプリケーションやサービスに接続したりできます。

シナリオの作成方法については、 シナリオの作成:記事のインデックスの記事を参照してください。

モジュールについて詳しくは、「 モジュール:記事インデックス」の記事を参照してください。

アクセス要件

展開すると、この記事の機能のアクセス要件が表示されます。

この記事で説明している機能を使用するには、次のアクセス権が必要です。

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Adobe Workfront パッケージ 任意
Adobe Workfront プラン

新規:標準

または

現在:仕事以上

Adobe Workfront Fusion ライセンス**

現在:Workfront Fusion ライセンス要件なし

または

従来のバージョン:作業の自動化と統合のためのWorkfront Fusion

製品

新規:

  • Prime Workfront パッケージを選択する:Adobe Workfront Fusion を購入する必要があります。
  • Ultimate Workfront パッケージ:Workfront Fusion が含まれています。

または

現在:Adobe Workfront Fusion を購入する必要があります。

このテーブルの情報について詳しくは、 ドキュメントのアクセス要件を参照してください。

Adobe Workfront Fusion ライセンスについて詳しくは、Adobe Workfront Fusion ライセンスを参照してください。

前提条件

Slack モジュールを使用するには、Slack アカウントが必要です。

Slack API の情報

Slack コネクタでは、以下を使用します。

ベース URL
{{ifempty (parameters.domain, 'https://slack.com/api/') }}
API タグ
v4.0.15

Slack モジュールとそのフィールド

Slack モジュールを設定すると、Workfront Fusion には以下のフィールドが表示されます。これらとともに、アプリやサービスのアクセスレベルなどの要因に応じて、追加の「Slack」フィールドが表示される場合があります。モジュール内の太字のタイトルは、必須フィールドを示します。

フィールドまたは関数の上にマップボタンが表示されている場合は、このボタンを使用すると、そのフィールドの変数や関数を設定できます。詳しくは、 モジュール間で情報をマッピングするを参照してください。

マップ切り替え

メッセージ

メッセージを作成

このアクションモジュールは、新しいメッセージを作成します。

Connection
Slack アカウントをAdobe Workfront Fusion に接続する手順については、Workfront Fusion への接続の作成 – 基本手順を参照してください。
Enter a channel ID or name

メッセージを作成するチャネルの選択方法を選択します。

  • Enter manually

    Channel ID or name」フィールドに、メッセージを投稿するチャネル ID またはチャネルの名前を入力またはマッピングします。

    メモ:チャネル ID は、List Channels モジュールを使用して取得できます。

  • Select from the list

    チャネルのタイプを選択し、チャネルを選択します。

Text

作成するメッセージのテキストコンテンツを入力します。

メモ:テキストの書式設定について詳しくは、Slack ドキュメント内のアプリケーションサーフェスのテキストの書式を参照してください。

ユーザーとしての
このオプションを有効にすると、このモジュールの接続で使用される資格情報を所有するユーザーとしてメッセージを投稿できます。
Thread message ID (time stamp)
新しいメッセージが返信の場合は、返信先のメッセージのタイムスタンプを入力します。既に返信があるメッセージのタイムスタンプを入力しないでください。
Reply broadcast

次の両方に該当する場合、Yes を選択します。

  • 新しいメッセージは別のメッセージへの返信

  • 新しいメッセージをチャネル内の全員に表示する

Attachments
メッセージに添付する項目ごとに、「 項目を追加 」をクリックして項目の詳細を入力します。
アイコン絵文字 ​
:icon-name: の形式で、このメッセージのアイコンとして使用する絵文字を入力またはマッピングします。
アイコン URL
このメッセージのアイコンとして使用する画像の URL を入力またはマップします。
Link names

このオプションを有効にすると、名前とチャネルで @username または #channel 書式を使用できるようになります。

詳しくは、Slack ドキュメントのアプリケーションサーフェスのテキストの書式を参照してください。

Parse message text

このオプションを有効にすると、自動解析を行うことができるようになります。

詳しくは、Slack ドキュメントのアプリケーションサーフェスのテキストの書式を参照してください。

メモ:元のメッセージで Link names オプションまたは Parse message text オプションを使用した場合は、Update a Message モジュールの実行時にもオプションを指定する必要があります。

Use markdown
このオプションを有効にすると、Slack がテキスト内でマークダウンを使用できるようになります。
Unfurl primarily text-based content

このオプションを有効にすると、主にテキストベースのコンテンツを展開できるようになります。

Slack での展開について詳しくは、Slack ドキュメントのメッセージ内のリンクを展開を参照してください。

Unfurl media content

このオプションを有効にすると、メディアコンテンツを展開できるようになります。

Slack での展開について詳しくは、Slack ドキュメントのメッセージ内のリンクを展開を参照してください。

User name
メッセージの投稿に使用するユーザー名を指定します。 ユーザー名を指定しない場合は、「Bot」という名前が使用されます。

メッセージを削除

このアクションモジュールは、指定されたメッセージを削除します。

Connection
Slack アカウントをAdobe Workfront Fusion に接続する手順については、Workfront Fusion への接続の作成 – 基本手順を参照してください。
Channel ID

チャネル ID を入力またはマッピングします。

メモ:チャネル ID は、List Channels モジュールを使用して取得できます。

Message ID

削除するメッセージのタイムスタンプを入力またはマッピングします。

メモ:タイムスタンプは、プライベートチャネルメッセージを監視モジュールなどの別のモジュールを使用して取得できます。

ユーザーとしての
接続で使用された資格情報を持つユーザーとしてメッセージを削除する場合は、このオプションを有効にします。

プライベートチャネルメッセージを取得

このアクションモジュールは、選択したチャネルからメッセージの詳細を取得します。

Connection
Slack アカウントをAdobe Workfront Fusion に接続する手順については、Workfront Fusion への接続の作成 – 基本手順を参照してください。
Channel ID

チャネル ID を入力(マッピング)します。

メモ:チャネル ID は、List Channels モジュールを使用して取得できます。

Message ID (Time stamp)

情報を取得するメッセージのメッセージタイムスタンプを入力またはマッピングします。

メモ:タイムスタンプは、Watch Private Channel Messages モジュールなどの別のモジュールを使用して取得できます。

​ 公開チャネルメッセージの取得 ​**

このアクションモジュールは、指定された公開チャネルから、指定された ID を持つメッセージを返します。

Connection
Slack アカウントをAdobe Workfront Fusion に接続する手順については、Workfront Fusion への接続の作成 – 基本手順を参照してください。
Channel ID

チャネル ID を入力またはマッピングします。

メモ:チャネル ID は、List Channels モジュールを使用して取得できます。

Message ID (Time stamp)

情報を取得するメッセージのメッセージタイムスタンプを入力またはマッピングします。

注意:タイムスタンプは、Watch Public Channel Messages モジュールなどの別のモジュールを使用して取得できます。

メッセージを更新

このアクションモジュールを使用すると、既存のメッセージを編集できます。

Connection
Slack アカウントをAdobe Workfront Fusion に接続する手順については、Workfront Fusion への接続の作成 – 基本手順を参照してください。
Channel ID

更新するメッセージを含むチャネルの ID を入力またはマッピングします。

メモ:チャネル ID は、List Channels モジュールを使用して取得できます。

Message ID (Time stamp)

情報を取得するメッセージのメッセージタイムスタンプを入力またはマッピングします。

注意:タイムスタンプは、Watch Public Channel Messages モジュールなどの別のモジュールを使用して取得できます。

Text

更新するメッセージの新しいテキストコンテンツを入力します。

詳しくは、Slack ドキュメントのアプリケーションサーフェスのテキストの書式を参照してください。

ユーザーとしての
このオプションを有効にすると、このモジュールの接続で使用される資格情報を所有するユーザーとしてメッセージが更新されます。
Attachments
メッセージに添付する項目ごとに、「 項目を追加 」をクリックして項目の詳細を入力します。
Link names

このオプションを有効にすると、名前とチャネルで @username または #channel 書式を使用できるようになります。

詳しくは、Slack ドキュメントのアプリケーションサーフェスのテキストの書式を参照してください。

Parse message text

このオプションを有効にすると、自動解析を行うことができるようになります。

詳しくは、Slack ドキュメントのアプリケーションサーフェスのテキストの書式を参照してください。

メモ:元のメッセージで Link names オプションまたは Parse message text オプションを使用した場合は、メッセージを更新モジュールの実行時にもオプションを指定する必要があります。

プライベートチャネルメッセージを監視

このトリガーモジュールは、新しいメッセージがプライベートチャネル(グループ)に追加されると、シナリオを開始します。

Connection
Slack アカウントをAdobe Workfront Fusion に接続する手順については、Workfront Fusion への接続の作成 – 基本手順を参照してください。
Channel
新しいメッセージを監視するプライベートチャネルを選択します。
Limit
Workfront Fusion が 1 つの実行サイクルで返すメッセージの最大数を設定します。

パブリックチャネルメッセージの監視

このトリガーモジュールは、新しいメッセージがパブリックチャネルに追加されると、シナリオを開始します。

Connection
Slack アカウントをAdobe Workfront Fusion に接続する手順については、Workfront Fusion への接続の作成 – 基本手順を参照してください。
Channel
新しいメッセージを監視するパブリックチャネルを選択します。
Limit
Workfront Fusion が 1 つの実行サイクルで返すメッセージの最大数を設定します。

会話

チャネルを取得

このアクションモジュールは、ワークスペースチャネルに関する情報を返します。

チャネルを一覧表示

この検索モジュールは、ワークスペース内のすべてのチャネルのリストを返します。

Connection
Slack アカウントをAdobe Workfront Fusion に接続する手順については、Workfront Fusion への接続の作成 – 基本手順を参照してください。
Channel ID

情報を取得するチャネルの ID を入力またはマッピングします。

メモ:チャネル ID は、List Channels モジュールを使用して取得できます。

Connection
Slack アカウントをAdobe Workfront Fusion に接続する手順については、Workfront Fusion への接続の作成 – 基本手順を参照してください。
Exclude archived
「Yes」を選択して、結果のアーカイブ済みチャネルを除外します。
Type
取得するチャネルのタイプを選択します。
Limit
Workfront Fusion が 1 つの実行サイクルで返す最大チャネル数を設定します。

チャネル内のメンバーを一覧表示

この検索モジュールは、選択したチャネルのユーザーのリストを返します。

Connection
Slack アカウントをAdobe Workfront Fusion に接続する手順については、Workfront Fusion への接続の作成 – 基本手順を参照してください。
Enter a channel ID or name

必要なメッセージを選択する方法を選択します。

  • Enter manually

    チャネル ID または名前 ​」フィールドに、ユーザーのリストを表示するチャネル ID またはチャネルのマッピングを入力します。

    メモ:チャネル ID は、List Channels モジュールを使用して取得できます。

  • Select from the list

    チャネルのタイプを選択し、チャネルを選択します。

Limit
Workfront Fusion が 1 つの実行サイクルで返すメンバーの最大数を設定します。

その他

API 呼び出しを実行

このアクションモジュールでは、Slack API への認証済みのカスタム呼び出しを実行できます。これにより、他の Slack モジュールでは不可能なデータフロー自動処理を実現できます。

API 呼び出しの設定に必要な HTTP リクエストメソッドを選択します。詳しくは、HTTP リクエストメソッドを参照してください。

Connection
Slack アカウントをAdobe Workfront Fusion に接続する手順については、Workfront Fusion への接続の作成 – 基本手順を参照してください。
URL
https://slack.com/api/ への相対パスを入力します。例:/users/identity
Method
Headers

リクエストのヘッダーを標準 JSON オブジェクトの形式で追加します。

例: {"Content-type":"application/json"}

Workfront Fusion によって認証ヘッダーが追加されます。

Query String

API 呼び出しのクエリを標準 JSON オブジェクトの形式で追加します。

例: {"name":"something-urgent"}

Body

標準の JSON オブジェクトの形式で、API 呼び出しの本文の内容を追加します。

メモ:

if などの条件ステートメントを JSON で使用する場合は、条件ステートメントの外側に引用符を挿入します。

Base URL
API 呼び出しに使用するベース URL を選択します。
アクセストークンを送信 ​
アクセストークンをヘッダーとして送信するか、クエリパラメーターとして送信するかを選択します。

用語

Slack モジュールを設定する場合、次の用語が役立つ場合があります。

  • DM:ダイレクトメッセージ
  • IM:インスタントメッセージ
  • プライベートチャネル:以前はグループ化
  • ダイレクトメッセージ:以前は IM
  • チャネル:API ドキュメントの会話、Slack アプリのチャネル。
recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3