カード情報を更新する

このピースでできること

  • formrunのカード(フォーム回答)の情報を更新します。
  • ステータス・担当者・ラベル・対応状況・アーカイブのうち、必要なものだけを変更できます。
  • 未選択の項目は変更されないため、意図しない上書きの心配なく使えます。
⚠️
ステータス・担当者・ラベル・対応状況・アーカイブのうち、1つ以上を指定してください。すべて未入力の場合は何も更新されません。

formrun の接続方法

formrun と workrun の連携方法は、使うピースによって 2 種類あります。
  • アクション(カード一覧の取得・メール送信など)を使う場合 → ステップ 1・2 の APIキー接続 が必要です
  • トリガー(Webhookを受信する)だけを使う場合 → 接続の作成は不要です。ステップ 3 の Webhook 設定のみ行ってください

ステップ 1:APIキーを取得する

  1. formrun にログインし、対象チームの 「チーム設定」 画面を開きます。
  1. 「API設定」 から API キーを発行します。
  1. 発行された API キーをコピーしておきます。

ステップ 2:workrun に接続を追加する

  1. workrun で formrun のアクションをフローに追加します。
  1. 「接続を選択」の横にある 「+ 新しい接続」 をクリックします。
  1. 「APIキー」 フィールドに、ステップ 1 でコピーした API キーを貼り付けます。
  1. 「保存」 をクリックして接続を完了します。

ステップ 3:Webhook を設定する(トリガーを使う場合)

  1. workrun で formrun のトリガー 「Webhookを受信する」 をフローに追加します。
  1. トリガーの設定画面に表示される 「Webhook URL」 をコピーします。
  1. formrun の管理画面で、対象フォームの 「Webhook」 アプリをインストール し、「作成する」 をクリックします。
  1. タイトルに任意の名前を入力し、「連携先のWebhook URL」 に手順 2 でコピーした URL を貼り付けます。
  1. 「条件設定」 でトリガーとしたい条件を設定します。
  1. 「有効にする」 を選択し、「保存する」 をクリックします。
💡
トリガーの設定画面で認証方式を 「なし」または「ヘッダー認証」 から選べます。ヘッダー認証を選ぶと、ヘッダー名と値を追加で設定できます。

テスト方法

  • workrun の 「テストトリガー」 をクリック後、実際に formrun でトリガー条件を実行するとデータを受信できます。
  • formrun の管理画面で 「テスト送信する」 にチェックを入れて保存することでもサンプルデータを送信できます。

ピースの設定項目

1. フォームID(必須)

  • 更新したいカードが属するフォームのID(数字)を入力します。
  • formrunの「設定 > フォーム基本設定 > フォームの基本情報」にあるフォームIDで確認できます。
[設定例]

2. カードID(必須)

  • 更新対象のカードのID(数字)を入力します。
  • カード詳細画面のURLの末尾 の後ろに続く数字がカードIDです。
  • 前のステップの「カード一覧を取得する」やトリガーの結果から差し込むこともできます。
[設定例]

3. ステータスID(任意)

  • 変更後のステータスIDを数字で入力します。
  • formrunの「設定 > 回答画面設定 > ステータス」から、それぞれのステータスIDを確認できます。
[設定例]

4. 担当者の操作(任意)

  • 担当者を変えたい場合に選びます。
    • 担当者を指定する:次の「担当者のメールアドレス」で指定した人を担当者にします
    • 担当者を解除する:現在の担当者を外します
  • 未選択の場合は担当者を変更しません。
[設定例]

5. 担当者のメールアドレス(任意)

  • 「担当者を指定する」を選んだ場合に、担当者のメールアドレスを入力します。
[設定例]

6. ラベルの操作(任意)

  • ラベルを変えたい場合に選びます。
    • 指定したIDに置き換える:次の「ラベルID」で指定した内容に入れ替えます(追加ではなく置換です)
    • すべて解除する:付いているラベルをすべて外します
  • 未選択の場合はラベルを変更しません。
[設定例]

7. ラベルID(任意)

  • 「指定したIDに置き換える」を選んだ場合に、設定したいラベルIDを追加します。
  • 未入力のままだとラベルは変更されません。
  • formrunの「設定 > 回答画面設定 > カードラベル」から、それぞれのラベルIDを確認できます。
[設定例]

8. 対応状況(任意)

  • 「対応済みにする」または「未対応にする」を選びます。
  • 未選択の場合は変更しません。
[設定例]

9. アーカイブ(任意)

  • 「アーカイブする」または「アーカイブを解除する」を選びます。
  • 未選択の場合は変更しません。
[設定例]