SObjectType クラス

署名

public Schema.DescribeSObjectResult getDescribe()

戻り値

型: Schema.DescribeSObjectResult

署名

public sObject newSObject()

戻り値

型: sObject

例

「動的 DML」の例を参照してください。

署名

public sObject newSObject(ID id)

パラメータ

id

型: ID

戻り値

型: sObject

使用方法

引数として、データベースにある既存のレコードの ID を渡します。

新しい sObject を作成すると、返された sObject のすべての項目は null に設定されています。更新可能な項目を目的の値に設定し、データベースのレコードを更新できます。新しい値を設定した項目のみが更新され、それ以外のシステム項目ではないすべての項目は保持されます。

署名

public sObject newSObject(ID recordTypeId, Boolean loadDefaults)

パラメータ

recordTypeId

型: ID

作成する sObject のレコードタイプ ID を指定します。この sObject にレコードタイプが存在しない場合、null を使用します。この sObject にレコードタイプが存在し、null を指定した場合、デフォルトのレコードタイプが使用されます。

loadDefaults

型: Boolean

定義済みのデフォルト値をカスタム項目に入力するか (true)、否か (false) を指定します。

戻り値

型: sObject

使用方法

• デフォルト値が存在しない必須項目には、新しい sObject を挿入する前に値を指定してください。値が指定されていない場合、挿入でエラーが発生します。たとえば、Account Name 項目や主従関係項目がこれに該当します。
• 選択リストと複数選択リストではレコードタイプごとに特定のデフォルト値を使用できるため、このメソッドは指定されたレコードタイプに対応するデフォルト値を入力します。
• 項目に定義済みのデフォルト値が存在せず、loadDefaults 引数が true の場合、このメソッドは項目値が null の sObject を作成します。
• loadDefaults 引数が false の場合、このメソッドは項目値が null の sObject を作成します。
• このメソッドは、新しい sObject の参照のみのカスタム項目にデフォルト値を入力します。その後、これらの参照のみの項目を含む新しい sObject を挿入できますが、これらの項目は挿入後も編集できません。
• カスタム項目が一意としてマークされていてデフォルト値を指定した場合、複数の新しい sObject を挿入すると項目値が重複するため、実行時例外が発生します。

デフォルト項目値についての詳細は、Salesforce オンラインヘルプの「デフォルト項目値について」を参照してください。

例: デフォルト値での新しい sObject の作成

このサンプルでは、newSObject メソッドを使用して、カスタム項目にデフォルト値 (ある場合) を入力した取引先を作成します。また、指定するレコードタイプで 2 つ目の取引先を作成します。新しい取引先を挿入する前に、両方の取引先に対して、デフォルト値のない必須項目である Name 項目を設定します。