Google スプレッドシートアクション - Update row using row ID (行 ID を使用した行の更新) (旧バージョン)

注 : この記事は、近日中に廃止される Google Sheets API v3 を使用した、旧バージョンの Update row (行の更新) アクションに関するものです。代わりに、こちらの新しい Update row アクションを使用することをお勧めします。

Update row アクションを使用すると、任意の既存の行の値を変更できます。

このアクションは多くの場合 Search rows アクションとともに使用されます。そうすることで、更新したい行をまず検索してから、それらの行を更新できます。

このアクションの使用方法

Google シートの設定

シート内のカスタムデータを取得するには、まず以下のスクリーンショットに示すように、シートに少なくとも1つのヘッダー行と1つのデータ行が含まれている必要があります。

1行のヘッダー行と1行のデータ行を含む Google シートのサンプル

Update row アクションの設定

特定のスプレッドシートとシートを選択してから、Search rows アクションのデータツリーから行 ID を渡す必要があります。この ID により、更新すべき正確な行がレシピに伝えられます。

未設定の Update row アクション

Search rows アクションからの行 ID を Update row アクションに入力する。これにより、更新すべき行がレシピに伝えられる。

サンプルのシナリオ

このケースでは、Salesforce 内の新規または更新された連絡先を、この Google シートに移そうとしていると想定しましょう。

以下の図は、あらかじめ準備しておいたレシピとデータマッピングを示しています。これによって、Google スプレッドシート内の適切な行が検索で見つかるようになっており、Salesforce からの新規データが Google スプレッドシート内の項目に対応付けられています。

新規または更新された Salesforce の連絡先を選択された Google シートへと移動させる完成済みレシピ

Search rows アクションを使用してシート内の行をクエリーで検索。ここでは、Salesforce の連絡先の Email と一致する email 列を持つ Google スプレッドシート行を検索している。

Search rows アクションの出力からこの Update row アクションに Row ID を渡し、更新する必要のある行を示す。その後、Salesforce new/updated Contact からのデータピルを Update row アクションにマッピングする。

適切なデータツリーからデータを取得するように注意してください。よくある間違いは、Search rows アクションからのピルを使用することです。そうすると、Google スプレッドシートの行から既存のデータを取り、それをまったく同じ行に再び書き込むことになります。それは本質的に何も行っていないことになり、役に立ちません。

レシピの実行

トリガーとアクションの設定が完了したので、いよいよレシピを実行してみましょう。

テスト用に設定済みのレシピ

Salesforce の連絡先の名前を Anna Sharpay から Anna Mccoy に更新してみます。メールアドレスが anna@workato.com であることに注意してください。

ジョブレポートを見て、レシピでこの変更がどのように取得されたかを確認しましょう。

更新された連絡先をトリガーが取得 (ジョブの詳細ページの [Output] タブに表示)

Search rows アクションがメールアドレス anna@workato.com を見つけようと試みる。1行を検出し、その Row ID を Update row アクションに渡す。その後、Update row アクションが名前を Anna Mccoy に更新する。

レシピが行を更新した後の結果のシートは以下のようになります。名前が Anna Sharpay から Anna Mccoy に変更されていることに注目してください。 元のシート 更新されたシート