新しい添付ファイルが追加されました(トリガー)

このピースでできること

  • Smartsheetのシート(行またはシート)に新しい添付ファイルが追加されたことを検知して、ワークフローを起動します。

トリガーの動作について

このトリガーは定期実行ではありません。Smartsheet でデータが変更されると、そのタイミングでワークフローが起動します。ワークフローを公開すると、Smartsheet への変更通知の設定が自動で行われます。

Smartsheet の接続方法

Smartsheet のアクセストークンを入力して接続します。

アクセストークンの取得手順

  1. Smartsheet にログインします
  1. 右上のプロフィール画像をクリックします
  1. ドロップダウンから 個人設定(Personal Settings) を選択します
  1. 左メニューの API アクセス(API Access) をクリックします
  1. 「新しいアクセストークンを生成(Generate new access token)」 をクリックします
  1. トークンの名前を入力し(例: "workrun 連携")、「OK」 をクリックします
  1. 生成されたアクセストークンをコピーし、接続画面の 「Access Token」 欄に貼り付けます
⚠️
注意: トリガーを使用する場合は、連携するシートに対して 管理者(Admin)権限 を持つアカウントのアクセストークンを使用してください。権限が不足していると、接続はできてもトリガーが正常に動作しません。
 

ピースの設定項目

1. シート(必須)

  • 監視したいSmartsheetのシートを選択します。
[設定例]
1234567890123456

取得できる情報

新しく追加された添付のイベント情報と、取得できた詳細情報を利用できます。
実際のキー内容・条件
/ シートID(文字列)・対象イベントのコメント/添付/行ID。
/ 対象の種類()・操作()。
/ イベント時刻・変更したユーザーのIDなど、通知に含まれる情報。
/ 添付先のID・種類。
/ / 詳細取得に成功した場合の添付ID・名前・URL。ファイル本体は追加されません。
/ 添付の種類・作成日時など。
詳細取得でエラーが発生した場合のメッセージ。
  • 通知内に対象イベントが複数ある場合は、イベント1件ごとに処理します。元の 配列全体が出力される形式ではありません。
  • は詳細取得結果です。対象が見つからない場合はnull、取得エラーなどの場合は未設定となり、 が付く場合があります。詳細取得時点の内容であり、変更前の値は追加されません。
  • 接続ユーザーの参照権限や受信内容により項目は異なります。通知の接続確認・状態変更だけでは業務データは出力されません。

出力例(抜粋)

後続ステップで使うキーを説明するための架空例です。実際の値や全項目を示すものではありません。