検索実行
目的 
検索モードに切り替わり、設定されていてスクリプトステップに保存されている1つまたは複数の検索条件に一致するレコードが検索されます。
構文 
検索実行 [記憶する]
オプション 
[検索条件の指定] オプションを選択するか、または [指定...] をクリックして、検索条件を作成および管理します。作成した検索条件は、スクリプトステップに保存されます。
  •
[作成...] Windows または [新規 ...] Mac OS をクリックすると [検索条件を編集] ダイアログボックスが開き、ここで検索の条件を定義します。
  •
一覧で検索条件を選択して [編集...] をクリックすると、選択した検索条件が開きます。
  •
一覧で1つまたは複数の検索条件を選択して [複製] をクリックすると、選択した検索条件が複製されます。
  •
一覧で1つまたは複数の検索条件を選択して [削除] をクリックすると、選択した検索条件が削除されます。
[検索条件を編集] ダイアログボックスでは、検索条件を作成したり編集したりすることができます。
  •
[処理] では、[レコードの検索] または [レコードを対象外に] を選択して、この検索条件でレコードを検索するか、それとも対象外にするかを指定します。レコードを検索した場合、レコードは対象レコードに追加されます。レコードを対象外にした場合は除外されます。 1つの検索条件で実行できるのは、レコードを検索するか、または対象外にするかのいずれかです。同じ [検索実行] スクリプトステップでレコードの検索とレコードを対象外にする処理の両方を行う必要がある場合は、複数の検索条件を使用します。
  •
[次の場合にレコードを検索する:](または [次の場合のレコードを対象外に:])には、現在のテーブル内にあるフィールドの一覧が表示されます。検索条件を作成するには、まずこの一覧からフィールドを選択します。
  •
関連テーブルからフィールドを選択するには、一覧の一番上にある現在のテーブル名をクリックして、目的の関連テーブルを選択します。次に、関連テーブルの新しい一覧から関連フィールドを選択します。
  •
[繰り返し] の数を変更して、繰り返しフィールドの特定のセルを指定します。
  •
[条件] 領域には、選択したフィールドに対する検索条件を入力します。
  •
[演算子] をクリックして、さらに詳しく検索条件を指定します。レコードの検索を参照してください。
  •
[追加] をクリックすると、指定した条件が検索条件に追加されます。
  •
既存の条件を変更するには、ダイアログボックスの上部から変更するフィールドと条件が含まれる行を選択して、フィールドや検索条件を変更します。[変更] をクリックして変更を保存します。
  •
互換性 
このスクリプトステップは、Web 公開および FileMaker Server のスケジュールスクリプトでもサポートされています。
説明 
検索条件を作成していない場合、このスクリプトステップは最後に実行された検索条件が実行されます。
検索モードに切り替えの後で [検索実行] スクリプトステップを使用すると、スクリプトが一時停止し、検索を実行する前に検索条件を入力することができます。
 
スクリプトを実行しても、検索条件に一致するレコードが見つからなかった場合は、スクリプトの停止、現在の対象レコードがない状態でのスクリプトの継続、または検索条件の変更を行うことができます。エラー処理Get ( 最終エラー )を使用して、このような状況を処理するスクリプトを設定できます。次に例を示します。
次のスクリプトは、検索を実行した結果、条件を満たすレコードが見つからなかった場合に、カスタムダイアログを表示します。ユーザは、このダイアログボックスで検索条件を修正するか、またはブラウズモードに戻るかを選択できます。
エラー処理 [オン]
検索実行 [記憶する]
If [Get ( 最終エラー ) > 0]
カスタムダイアログを表示 ["レコードが見つかりません。検索条件を変更する場合は [OK] をクリックしてください。
[キャンセル] をクリックすると、ブラウズモードに戻ります。"]
If [Get ( 最終メッセージ選択 ) = 1]
検索条件を変更
Else
ブラウズモードに切り替え []
End If
End If
関連項目 
対象レコードの絞り込み
対象レコードの拡大
スクリプトステップリファレンス(名前順)
スクリプトステップリファレンス(種類順)