formContext.data.save (クライアント API 参照)
レコードを非同期で、保存操作の完了後にコールバック関数を実行するようにオプションが設定された状態で保存します。
予定、定期的な予定、またはサービス活動に関連するレコードの処理方法を制御するオブジェクトを設定することもできます。
構文
formContext.data.save(saveOptions).then(successCallback, errorCallback);
Parameters
| 件名 | タイプ | Required | Description |
|---|---|---|---|
saveOptions |
Object | いいえ | レコードを保存するオプションを指定するオブジェクト。 オブジェクトには、次のパラメーターがあります: - saveMode: (オプション) 番号。 保存イベントがどのように開始されたかを示す値を指定します。 サポートされるメッセージの一覧については、「getSaveMode メソッドの戻り値」を参照してください。
saveMode を設定しても、対応するアクションは実行されません。保存操作の理由に関する情報が OnSave イベント ハンドラーに提供されます。- useSchedulingEngine: (オプション) ブール値。
Create または Update メッセージではなく、Book または Reschedule メッセージを使用するかどうかを示します。 このオプションは、予定、定期的な予定、またはサービス活動レコードに対して使用される場合にのみ適用されます。メモ: useSchedulingEngine プロパティは統一インターフェイスではサポートされていません。 |
successCallback |
Function | いいえ | 処理が成功したときに呼び出す関数。 |
errorCallback |
Function | いいえ | 処理が失敗したときに呼び出す関数。 次のプロパティを持つオブジェクトが渡されます。 - errorCode: 数値。 エラー コード。- message: 文字列。 ローカライズされたエラー メッセージ。 |
ヒント
フォームを操作するときに、formContext.data.save メソッドを呼び出すには、preventDefault も呼び出して、ユーザーがフォームを保存するときに規定の保存操作がトリガーされないようにします。