formContext.data.save (クライアント API 参照)

レコードを非同期で、保存操作の完了後にコールバック関数を実行するようにオプションが設定された状態で保存します。

予定、定期的な予定、またはサービス活動に関連するレコードの処理方法を制御するオブジェクトを設定することもできます。

構文

formContext.data.save(saveOptions).then(successCallback, errorCallback);

注意

エンティティとテーブルの違いがわかりませんか？ Microsoft Dataverse で「開発者: 用語を理解する」を参照してください。

パラメーター

名前	種類​​	必須	内容
saveOptions	オブジェクト	無効	レコードを保存するオプションを指定するオブジェクト。 オブジェクトには、次のパラメーターがあります: - saveMode: (任意) 数値。 保存イベントがどのように開始されたかを示す値を指定します。 サポートされるメッセージの一覧については、「getSaveMode メソッドの戻り値」を参照してください。 saveMode を設定しても、対応するアクションは実行されません。保存操作の理由に関する情報が OnSave イベント ハンドラーに提供されます。 - useSchedulingEngine: (任意) ブール値。 Create または Update メッセージではなく、Book または Reschedule メッセージを使用するかどうかを示します。 このオプションは、予定、定期的な予定、またはサービス活動レコードに対して使用される場合にのみ適用されます。 メモ: useSchedulingEngine プロパティは統一インターフェイスではサポートされていません。
successCallback	Function	無効	処理が成功したときに呼び出す関数。
errorCallback	関数	無効	処理が失敗したときに呼び出す関数。 次のプロパティを持つオブジェクトが渡されます。 - errorCode: 数値。 エラー コード。 - message: 文字列。 ローカライズされたエラー メッセージ。

注意

フォームを操作するときに、formContext.data.save メソッドを呼び出すには、preventDefault も呼び出して、ユーザーがフォームを保存するときに規定の保存操作がトリガーされないようにします。

関連トピック

formContext.data.entity.save

formContext

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。