AIに聞くお問い合わせ
AIに聞くお問い合わせ
workrun ヘルプサイト/行を検索

行を検索

このピースでできること

  • 指定した列名と検索値で一致する行を取得します。部分一致も可能です。

Google Sheetsの接続方法

1. 接続を作成

  • 接続から「接続を作成」をクリックします。

2. 接続設定

  • 接続名を設定して、「接続する」をクリックします。
 

3. 接続するGoogleアカウントを選び、許可を行います

  • 接続するGoogleアカウントを選びます。
  • アプリに許可を行います。

4. 「保存」を押して接続名が設定されていることを確認します

  • 「保存」を押して接続名が設定されていることを確認します。
 

Google Sheets接続時の注意点

Googleスプレッドシートの接続時、参照元のファイルが多いと、接続に時間がかかる / 取得数が多すぎてエラーとなる場合があります。
発生した場合は、以下の対処法をお試しください。
【解決手順】
  1. 動的値をクリック
  1. スプレッドシートのIDを直接入力

よくある質問

Q. スプレッドシート連携で「403エラー (The caller does not have permission)」などの権限エラーが発生してしまいます。 設定は変えていないはずですが、どうすればよいですか？

A. ワークフローで利用している「Google Sheets接続」の認証を行ったアカウント（所有者）が、対象のスプレッドシートに対する書き込み（編集）権限を持っていない可能性があります。
スプレッドシート本体の設定を変えていなくても、以下の理由で権限エラーが発生することがあります。
  • チームで共有しているワークスペースにおいて、自分以外のメンバーが最初に接続の認証を行っていた。
  • スプレッドシートが格納されている親フォルダの共有設定（アクセス権）が変更され、中のシートの権限も連動して制限された。
【解決手順】
以下の手順で、接続アカウントとスプレッドシートの権限状況を確認・修正してください。
  1. 接続の「所有者」を確認する 　workrunの管理画面から該当の接続設定を開き、アプリ接続の「所有者（接続を作成・認証した人）」がどのアカウントになっているかを確認します。
  1. スプレッドシートに権限を付与する 　エラーになっている対象のスプレッドシート（またはその親フォルダ）の「共有設定」を開きます。 　手順1で確認した「所有者」のアカウントに対して、「編集者」権限が付与されているか確認してください。閲覧者になっている、または権限がない場合は「編集者」として追加します。
  1. ワークフローをリトライする 　適切な権限を付与したあと、エラーになっていたワークフローを再度実行（リトライ）してください。
💡 ポイント 　エラーが出た際は、「どの認証情報を使って」「どのデータにアクセスしようとしているか」、そして「その認証情報のアカウントに適切な権限（編集など）が渡っているか」を確認することで、自己解決しやすくなります。

Q. Google Sheetsで「429 Too Many Requests」「Quota exceeded」などのエラーが発生します。

A. 短時間にGoogle Sheets APIへのリクエストが集中し、Google側の利用上限に達した可能性があります。
Google側の利用上限には、同じフローや接続の実行状況だけでなく、workrun全体の利用状況が影響する場合もあるため、原因を断定はできません。
【解決手順】
  • 1分以上時間を空けてから、ワークフローを再実行してください。
  • ループ内などで同じ情報を繰り返し取得している場合は、取得処理を一度にまとめる、またはDelayピースなどで処理間隔を空けて分散してください。
  • 上記を試しても解消しない場合は、実行履歴URL・発生日時・エラーになったピース・エラー全文をサポートへ共有してください。

ピースの設定項目

1. 共有ドライブを含める（任意）

  • 共有ドライブに入っているスプレッドシートを対象にする場合はONにします。
  • f（動的値）をクリックすると任意で入力できます。

2. スプレッドシートID（必須）

  • 使用するスプレッドシートのIDです。
  • f（動的値）をクリックすると任意で入力できます。

3. シートID（必須）

  • 使用するシートのIDです。
  • f（動的値）をクリックすると任意で入力できます。

4. 使用する列の名前（必須）

  • 検索対象の列を指定します。
  • f（動的値）をクリックすると任意で入力できます。

5. 検索値（任意）

  • 空の場合はすべての行を返します。

5. 完全一致（必須）

  • 完全一致で探す場合はtrue、部分一致ならfalseです。
  • f（動的値）をクリックすると任意で入力できます。

4. 開始行（任意）

  • 検索を始める行番号を指定します。

5. 取得行数（任意）

  • 返す行数を指定します。
  • 指定されていない場合、デフォルトは1です。

6. ヘッダー行（必須）

  • どの行にヘッダーが含まれているか

7. キーにヘッダー名を使用（任意）

  • A/B/C… を実際の列のヘッダ(上で指定した行)にマップします。
  • f（動的値）をクリックすると任意で入力できます。

8. 失敗時に続ける（任意）

  • このオプションを有効にすると、このステップをスキップし、失敗した場合は正常にフローを継続します。

9.失敗時に再試行（任意）

  • 失敗したときに自動的に最大 4 回の試行を再試行します。