#avFrameworkManager.avCheckConnectionメソッドはフィルターおよびコマンド・ハンドラー・コードで使用できます。
このメソッドは、接続を使用する操作(検索や保存など)の直前に、コマンド・ハンドラーまたはフィルター内でサーバー接続のチェックに使用します。
このメソッドを起動するとサーバー・チェック・ファンクションがサーバー上に呼び出されるので、起動する頻度がパフォーマンスに与える影響を考慮し、さらにテストで確認することを
お勧めします。例えば、100データベース行を挿入するループが反復するごとに、このメソッドを起動することをお勧めします。
メソッド：avCheckConnection
パラメータ：
名前 | 使用方法 | クラス | 説明 | 省略値 |
|---|---|---|---|---|
Server | 入力－任意 | アルファベット－32文字以内 | チェックするサーバー(ユーザー・オブジェクト名/サーバーのタイプ) | 現在のサーバー |
AttemptReconnect | 入力－任意 | ブール値 | 接続に失敗したことが検出されると、再接続を試行 | TRUE |
IssueMessages | 入力－任意 | ブール値 | 接続の失敗をユーザーに通知するメッセージを発行 FALSEに設定されている場合は、ActionOnFailパラメータが無視され、ユーザーとの通信は試行されません。 | TRUE |
ActionOnFail | 入力－任意 | ブール値 | 再接続の試行が失敗したときの対応。ABORTまたはNOTIFY/RETRY
| サーバー値 (サーバー・プロパティで設定) |
OfflineOK | 入力－任意 | ブール値 | TRUEに設定されており、ユーザーがこのサーバーに接続したことがない(例：オフラインで作業している、またはシステムがローカル・データベースを使用するように定義されている)場合は、avCheckConnectionがOKを返します。 FALSEに設定されており、ユーザーがこのサーバーに接続したことがない場合は、avCheckConnectionがERを返します。 | TRUE |
ReturnValue | 出力 - オプション | アルファベット－ 2 文字以内 | 通常はOK(接続中)またはER(未接続)。ただし、ファンクションIIPの接続テストのコードを記述して、他の値を返すようにすることができます。 |