Apex DML 操作

insertsObject

insert sObject[]

次の例では、「Acme」という名前の取引先を挿入しています。

updatesObject

update sObject[]

次の例では、「Acme」という名前の 1 つの取引先の BillingCity 項目を更新しています。

upsert sObject​​ [opt_field]

upsert sObject[]​​ [opt_field]

upsert ステートメントは、1 つの項目の値を比較して sObject と既存のレコードを照合します。このステートメントをコールするときに項目を指定しないと、upsert ステートメントは sObject の ID を使用して sObject と Salesforce の既存のレコードを照合します。または、照合に使用する項目を指定できます。カスタムオブジェクトの場合、外部 ID とマークされたカスタム項目を指定します。標準オブジェクトの場合、idLookup 属性が true に設定されている項目であれば指定できます。たとえば、取引先責任者またはユーザのメール項目の idLookup 属性は設定されています。項目の属性をチェックするには、『Salesforce のオブジェクトリファレンス』を参照してください。

また、sObject レコードが参照項目として設定されている場合、sObject レコードを更新/挿入するために外部キーを使用できます。詳細は、『Salesforce のオブジェクトリファレンス』の「データ型」を参照してください。

照合に使用する項目に Unique 属性が設定されていない場合、upsert によって誤って重複レコードが挿入されないように、コンテキストユーザは対象オブジェクトに対するオブジェクトレベルの「すべて表示」権限、または「すべてのデータの参照」権限が必要です。

upsert では、新規レコードを作成するか既存のレコードを更新するかを判別するために、sObject レコードの主キー (ID)、idLookup 項目、または外部 ID 項目を使用します。

• キーが一致しない場合、新規オブジェクトレコードが作成されます。
• キーが一度だけ一致したら、既存のオブジェクトレコードが更新されます。
• キーが複数回一致する場合は、エラーが生成され、オブジェクトレコードは挿入も更新もされません。

undelete sObject | ID

undelete sObject[] | ID[]

次の例では、「Universal Containers」という名前の取引先を復元しています。ALL ROWS キーワードは、削除されたレコードやアーカイブ済みの活動を含め、最上位リレーションと集計リレーションの両方にあるすべての行を照会します。

mergesObject sObject

merge sObject sObject[]

mergesObject ID

merge sObject ID[]

最初のパラメータは、他のレコードがマージされる主レコードを表します。2 番目のパラメータは、マージされてから削除される 1 つ以上の他のレコードを表します。これらのその他のレコードは、1 つの sObject レコードまたは ID、または 2 つの sObject レコードまたは ID のリストとして、merge ステートメントに渡すことができます。