updateRecord(recordInput, clientOptions)

レコードを更新します。更新するレコードのレコード ID を recordInput に指定します。

updateRecord では、このユーザインターフェース API リソースが使用されますが、そのすべてのパラメータはサポートされません。

  • recordInput — (必須) レコードの更新に使用される RecordInput オブジェクト。オブジェクトを作成するには、generateRecordInputForUpdate(record, objectInfo) をコールします。項目とその値を渡して RecordInput オブジェクトを作成する方法もあります。**「使用方法」**セクションを参照してください。以下は、recordInput のプロパティです。

  • triggerOtherEmail — (省略可能) ケースで、組織外のユーザにメールを送信するかどうかを指定します。Salesforce で、このメールは、ケースの取引先責任者の作成、編集、削除によってトリガされます。デフォルト値は、false です。

  • triggerUserEmail — (省略可能) ケースまたはリードで、組織のユーザにメールを送信するかどうかを指定します。Salesforce ユーザインターフェースで、このメールはパスワードのリセット、ユーザの作成、ケース所有者の変更、ケースへのコメントの追加などのさまざまなイベントによってトリガされる場合があります。デフォルト値は、false です。

    ケース所有者の変更では、useDefaultRule=true も設定します。設定しないと、メールが送信されません。

  • useDefaultRule — ケースまたはリードで、デフォルト (有効) の割り当てルールを使用するかどうかを指定します。useDefaultRule を指定する場合は、assignmentRuleId を指定しないでください。デフォルト値は、false です。

    取引先責任者で、デフォルトのテリトリー割り当てルールを適用するかどうかを指定します。

    • allowSaveOnDuplicate — 重複レコードを保存するかどうかを指定します。デフォルト値は、false です。
    • apiName — レコードを作成するには、レコードの作成元のオブジェクトの API 参照名を指定します。レコードを更新するには、null を使用するか、このプロパティを渡さないでください。
    • fields — 項目名の項目値への対応付け。「レコードを更新する」を参照してください。
  • clientOptions — (省略可能) レコードを更新する前に競合がないかをチェックするには、const clientOptions = {'ifUnmodifiedSince' : lastModifiedDate} を渡します。レコードオブジェクトを返すワイヤサービスアダプタを介して lastModifiedDate を取得します。つまり、const lastModifiedDate = record.fields.LastModifiedDate.value; のように指定します。

更新されたレコードを使用して解決される Promise オブジェクト。このレコードには、レコードレイアウトの項目のデータが含まれます。

このワイヤアダプタを使用する前に、これより簡単な方法ではデータを更新できないことを確認します。レコードを操作するためのフォームを作成するには、lightning-record-*-form コンポーネントを検討してください。

カスタムフォームを作成するのは、必要なカスタマイズが lightning-record-*-form コンポーネントで可能な範囲を超える場合のみにしてください。

次の例では、レコードを更新するカスタムフォームを作成します。getSingleRecord Apex コントローラを使用して、単一の連絡先レコードの FirstName 項目と LastName 項目を読み込みます。(Name は複合項目です。名前を編集するには、FirstName 項目と LastName 項目を使用する必要があります。)

名前項目の一方または両方が空の場合は、カスタム動作として [連絡先の更新] ボタンが無効になります。Id 項目は参照専用で無効になっているため、ユーザが編集することはできません。

変更は updateRecord を使用して更新されます。クライアント側では、必須設定は適用されません。無効な項目のエラーを項目レベルで表示するには、reportValidity() をコールします。

lightning-record-*-form コンポーネントを使用すると、Salesforce スキーマに基づいてすべての項目が表示されます。たとえば、クライアント側では、必須項目に対する必須設定が自動的に処理されます。フォームの機能をカスタマイズするには、updateRecord を使用してください。たとえば、必須でない FirstName 項目をユーザが空白のままにすることを防止してデータの完全性を向上させたり、特定の項目が有効でないときにボタンを無効にしたりできます。

getSingleContact Apex メソッドは、単一の連絡先レコードを返します。

関連トピック