SObject クラス

署名

public Void addError(String errorMsg)

パラメータ

errorMsg

型: String

レコードにマークを付けるエラーメッセージです。

戻り値

型: Void

使用方法

before insert トリガおよび before update トリガの Trigger.new、および before delete トリガの Trigger.old で使用すると、アプリケーションインターフェースにエラーメッセージが表示されます。

「トリガ」および「トリガの例外」を参照してください。

Visualforce コントローラで使用すると、生成されたメッセージが、そのページのエラーコレクションに追加されます。詳細は、『Visualforce 開発者ガイド』の「入力規則と標準コントローラ」を参照してください。

例

署名

public Void addError(String errorMsg, Boolean escape)

パラメータ

errorMsg

型: String

レコードにマークを付けるエラーメッセージです。

escape

型: Boolean

カスタムエラーメッセージ内の HTML マークアップがエスケープされるか (true)、否か (false) を示します。このパラメータは Lightning Experience と Salesforce モバイルアプリケーションの両方で無視され、HTML は常にエスケープされます。escape パラメータは Salesforce Classic でのみ適用されます。

戻り値

型: Void

使用方法

エスケープ文字は、\n、<、>、&、"、\、\u2028、\u2029、\u00a9 です。このため、HTML マークアップは表示されず、その代わりに、Salesforce ユーザインターフェースにテキストとして表示されます。

例

署名

public Void addError(Exception exceptionError)

パラメータ

exceptionError

型: System.Exception

レコードにマークを付けるエラーメッセージを含む例外オブジェクトまたはカスタム例外オブジェクトです。

戻り値

型: Void

使用方法

before insert トリガおよび before update トリガの Trigger.new、および before delete トリガの Trigger.old で使用すると、アプリケーションインターフェースにエラーメッセージが表示されます。

「トリガ」および「トリガの例外」を参照してください。

Visualforce コントローラで使用すると、生成されたメッセージが、そのページのエラーコレクションに追加されます。詳細は、『Visualforce 開発者ガイド』の「入力規則と標準コントローラ」を参照してください。

例

署名

public Void addError(Exception exceptionError, Boolean escape)

パラメータ

exceptionError

型: System.Exception

レコードにマークを付けるエラーメッセージを含む例外オブジェクトまたはカスタム例外オブジェクトです。

escape

型: Boolean

カスタムエラーメッセージ内の HTML マークアップがエスケープされるか (true)、否か (false) を示します。このパラメータは Lightning Experience と Salesforce モバイルアプリケーションの両方で無視され、HTML は常にエスケープされます。escape パラメータは Salesforce Classic でのみ適用されます。

戻り値

型: Void

使用方法

例

署名

public Void addError(String errorMsg)

パラメータ

errorMsg

型: String

戻り値

型: Void

使用方法

「トリガ」および「トリガの例外」を参照してください。

例

署名

public Void addError(String errorMsg, Boolean escape)

パラメータ

errorMsg

型: String

レコードにマークを付けるエラーメッセージです。

escape

型: Boolean

カスタムエラーメッセージ内の HTML マークアップがエスケープされるか (true)、否か (false) を示します。このパラメータは Lightning Experience と Salesforce モバイルアプリケーションの両方で無視され、HTML は常にエスケープされます。escape パラメータは Salesforce Classic でのみ適用されます。

戻り値

型:

使用方法

例

署名

public void addError(String fieldName, String errorMsg)

パラメータ

fieldName

型: String

sObject の項目名。

errorMsg

型: String

追加するエラーメッセージ。エラーメッセージ文字列内の HTML 特殊文字は常にエスケープされます。

戻り値

型: void

使用方法

項目名が空の文字列または null の場合、エラーは sObject に関連付けられ、特定の項目には関連付けられません。

例

署名

public void addError(Schema.SObjectField fieldToken, String errorMsg

パラメータ

fieldToken

型: Schema.SObjectField

sObject インスタンスの項目。

errorMsg

型: String

追加するエラーメッセージ。エラーメッセージ文字列内の HTML 特殊文字は常にエスケープされます。

戻り値

型: void

使用方法

このメソッドを使用して、標準オブジェクトまたはカスタムオブジェクトの指定された項目トークンにエラーを追加します。fieldToken が null の場合、エラーは sObject に関連付けられ、特定の項目には関連付けられません。

例

署名

public void addError(String fieldName, String errorMsg, Boolean escape)

パラメータ

fieldName

型: String

sObject の項目名。

errorMsg

型: String

追加するエラーメッセージ。

escape

型: Boolean

カスタムエラーメッセージ内の HTML マークアップがエスケープされるか (true)、否か (false) を示します。このパラメータは Lightning Experience と Salesforce モバイルアプリケーションの両方で無視され、HTML は常にエスケープされます。escape パラメータは Salesforce Classic でのみ適用されます。

戻り値

型: void

使用方法

項目名が空の文字列または null の場合、エラーは sObject に関連付けられ、特定の項目には関連付けられません。

エスケープ文字は、\n、<、>、&、"、\、\u2028、\u2029、\u00a9 です。このため、HTML マークアップは表示されず、その代わりに、Salesforce ユーザインターフェースにテキストとして表示されます。

例

署名

public void addError(Schema.SObjectField fieldToken, String errorMsg, Boolean escape)

パラメータ

fieldToken

型: Schema.SObjectField

sObject インスタンスの項目。

errorMsg

型: String

追加するエラーメッセージ。

escape

型: Boolean

カスタムエラーメッセージ内の HTML マークアップがエスケープされるか (true)、否か (false) を示します。このパラメータは Lightning Experience と Salesforce モバイルアプリケーションの両方で無視され、HTML は常にエスケープされます。escape パラメータは Salesforce Classic でのみ適用されます。

戻り値

型: void

使用方法

このメソッドを使用して、標準オブジェクトまたはカスタムオブジェクトの指定された項目トークンにエラーを追加します。fieldToken が null の場合、エラーは sObject に関連付けられ、特定の項目には関連付けられません。

エスケープ文字は、\n、<、>、&、"、\、\u2028、\u2029、\u00a9 です。このため、HTML マークアップは表示されず、その代わりに、Salesforce ユーザインターフェースにテキストとして表示されます。

例

署名

public Void clear()

戻り値

型: Void

例

署名

public SObject clone(Boolean preserveId, Boolean isDeepClone, Boolean preserveReadonlyTimestamps, Boolean preserveAutonumber)

パラメータ

preserveId

型: Boolean

(省略可能) 元のオブジェクトの ID を重複で保持するか削除するかを指定します。true に設定すると、ID は重複する ID にコピーされます。デフォルトは false であるため、ID はクリアされます。

isDeepClone

型: Boolean

(省略可能) メソッドで SObject 項目の完全コピーを作成するか参照のみを作成するかを決定します。

• true に設定すると、メソッドは SObject の完全コピーを作成します。リレーション項目など、SObject のすべての項目はメモリ内に複製されます。その結果、コピーした SObject の項目に変更を行っても、元の SObject は影響されません。
• false に設定すると、メソッドは SObject 項目の浅いコピーを作成します。コピーされたすべてのリレーション項目は元の SObject を使用します。その結果、コピーされた SObject でリレーション項目を変更すると、元の SObject の対応する項目も変更され、元の SObject で変更するとコピーされた SObject も変更されます。デフォルトは、false です。

preserveReadonlyTimestamps

型: Boolean

(省略可能) 参照のみのタイムスタンプ項目を重複で保持するか削除するかを指定します。true に設定すると、参照のみの項目 CreatedById、CreatedDate、LastModifiedById、および LastModifiedDate は重複項目にコピーされます。デフォルトは false であるため、値はクリアされます。

preserveAutonumber

型: Boolean

(省略可能) 元のオブジェクトの自動採番項目を複製で保持するか削除するかを指定します。true に設定すると、自動採番項目はコピーされたオブジェクトにコピーされます。デフォルトは false であるため、自動採番項目はクリアされます。

戻り値

型: SObject (同じデータ型)

使用方法

例

署名

public Object get(String fieldName)

パラメータ

fieldName

型: String

戻り値

型: Object

使用方法

詳細は、「動的 SOQL」を参照してください。

例

署名

public Object get(Schema.sObjectField field)

パラメータ

field

型: Schema.SObjectField

戻り値

型: Object

使用方法

詳細は、「動的 SOQL」を参照してください。

例

署名

public Id getCloneSourceId()

戻り値

型: Id

使用方法

A を B にコピーし、B を C にコピーし、C を D にコピーすると、B と C と D のすべてがコピー元である A を参照します。

例

署名

public List<Database.Error> getErrors()

戻り値

型: List<Database.Error>

署名

public Database.DMLOptions getOptions()

戻り値

型: Database.DMLOptions

例

署名

public Map<String,Object> getPopulatedFieldsAsMap()

戻り値

型: Map<String,Object>

項目名とそれに対応する値の対応付け。

使用方法

次の例では、SOQL クエリの後に getPopulatedFieldsAsMap() メソッドで返された対応付けを反復処理します。

次の例では、SObject の項目が明示的に設定された後に getPopulatedFieldsAsMap() メソッドで返された対応付けを反復処理します。

次の例は、関連オブジェクトに getPopulatedFieldsAsMap() メソッドを使用する方法を示します。

バージョン管理動作の変更

API バージョン 39.0 以降の場合、getPopulatedFieldsAsMap は、SObject に設定されたすべての値を返します。これは、レコードのクエリ後に値が設定された場合も当てはまります。この動作は、SObject を生成したクラスのバージョンではなく、このメソッドをコールする Apex クラスのバージョンによって決まります。API バージョン 20.0 で SObject を照会した後、API バージョン 40.0 でクラスのこのメソッドをコールすると、一連の項目がすべて取得されます。

署名

public SObject getSObject(String fieldName)

パラメータ

fieldName

型: String

戻り値

型: SObject

例

署名

public SObject getSObject(Schema.SObjectField fieldName)

パラメータ

fieldName

型: Schema.SObjectField

戻り値

型: SObject

例

署名

public SObject[] getSObjects(String fieldName)

パラメータ

fieldName

型: String

戻り値

型: SObject[]

使用方法

詳細は、「動的 DML」を参照してください。

例

署名

public SObject[] getSObjects(Schema.SObjectType fieldName)

パラメータ

fieldName

型: Schema.SObjectType

戻り値

型: SObject[]

署名

public Schema.SObjectType getSObjectType()

戻り値

型: Schema.SObjectType

使用方法

詳細は、apex_dynamic_describe_objects_understanding を参照してください。

例

署名

public String getQuickActionName()

戻り値

型: String

例

署名

public Boolean hasErrors()

戻り値

型: Boolean

署名

public Boolean isClone()

戻り値

型: Boolean

例

署名

public Void isSet(String fieldName)

パラメータ

fieldName

型: String

戻り値

型: Boolean

使用方法

isSet メソッドは、項目に特定のユーザが組織権限またはその他の特殊なアクセス権によってアクセス可能であるかどうかを確認しません。

例

署名

public Void isSet(Schema.SObjectField field)

パラメータ

field

型:SObjectField クラス

戻り値

型: Boolean

使用方法

isSet メソッドは、項目に特定のユーザが組織権限またはその他の特殊なアクセス権によってアクセス可能であるかどうかを確認しません。

例

署名

public Object put(String fieldName, Object value)

パラメータ

fieldName

型: String

value

型: Object

戻り値

型: Object

例

署名

public Object put(Schema.SObjectField fieldName, Object value)

パラメータ

fieldName

型: Schema.SObjectField

value

型: Object

戻り値

型: Object

例

署名

public SObject putSObject(String fieldName, SObject value)

パラメータ

fieldName

型: String

value

型: SObject

戻り値

型: SObject

例

署名

public SObject putSObject(Schema.SObjectType fieldName, SObject value)

パラメータ

fieldName

型: Schema.SObjectType

value

型: SObject

戻り値

型: SObject

署名

public Void recalculateFormulas()

戻り値

型: Void

使用方法

このメソッドは、クロスオブジェクト数式を再計算しません。クロスオブジェクト数式項目と非クロスオブジェクト数式項目の両方があるオブジェクトでこのメソッドをコールすると、非クロスオブジェクト数式項目のみが再計算されます。

各 recalculateFormulas コールは、SOQL クエリの制限に含まれます。「実行ガバナと制限」を参照してください。

署名

public Void setOptions(database.DMLOptions DMLOptions)

パラメータ

DMLOptions

型: Database.DMLOptions

戻り値

型: Void

例