シート内で指定した値を検索して、合致したセルの番地をリスト形式で返します。

設定方法（簡単）

①「spreadsheet/値の取得」カテゴリにある「値の検索」アクションをクリックします。

② 対象シート 参照設定：シートタイプのアクション結果を参照し、設定します。

設定方法（便利）

③ 検索値（任意）：検索したい文言や値を指定します。

④ 検索値 参照設定（任意）：テキストタイプのアクション結果を参照し、設定します。

⑤ シート全体を指定：検索する対象範囲をシート全体とするかを指定できます。

⑥ 全ての結果を取得（任意）：一致する結果が複数あった場合に全てを取得するかを選択します。いいえの場合最初に一致した結果だけを返します。

⑦ 数式を検索（任意）：数式を数式のまま検索したい場合「はい」にします。「いいえ」の場合は数式により生成されている値を検索対象とします。

⑧ 戻り値にラベルを付ける（任意）：アクションが返す値の各要素に任意のラベル（名称）を付けることが出来ます。後続アクションからの参照時にこのラベルを指定してデータを操作することが出来ます。

オプション設定

以下の設定項目は任意です。

⑨ 正規表現：正規表現を使って検索値を記述するかどうかを指定します。

⑩ エラーを無視

関連アクション

対象シートに設定できるスプレッドシートの１シートタイプの戻り値をもつアクションは下記になります。

• spreadsheet/シートをシート名で指定
• spreadsheet/シートをシートIDで指定
• spreadsheet/シートの追加
• spreadsheet/シートのコピー

アクション使用例

◆spreadsheet内で、特定の値がいくつあるかを数えるシナリオを作成します。

以下のようなデータを用意し、0の数を数えます。

<全体図>

「spreadsheetを開く」→「シートをシートIDで指定」→「値の検索」→「スクリプトを実行」

<各アクション詳細>

・spreadsheetを開く

シナリオアカウント：シナリオアカウントで設定したアカウントを選択します。

対象ファイル：spreadsheetのリンクを貼り付けます。

・シートをシートIDで指定

spreadsheet：「spreadsheetを開く」を参照します。

シートID：対象シートのIDを入力します。

・値の検索

対象シート：「シートをシートIDで指定」を参照します。

検索値：0

シート全体を指定：いいえ

検索の開始基準を指定：A1

縦方向の検索範囲：空行を跨いでデータの連続範囲を選択

横方向の検索範囲：複数選択しない

全ての結果を取得：はい

・スクリプトを実行

引数：{"data":[値の検索]}

JavaScript：data.length;