Newer Version Available

This content describes an older version of this product. View Latest

TPM_Promotion.Record

This APEX class provides a wrapper to Promotion SObject Records. Each instance wraps an SObject Record related to the parent TPM_Promotion and provide methods to manipulate them in order to flag them for insertion or deletion. It also provides methods to extract the underlying SObject records so updates can be made.

The content in this Consumer Goods Cloud Trade Promotion Management documentation is confidential and may be viewed only by customers or partners as authorized by Salesforce, and copying and further distribution is prohibited without prior written consent from Salesforce. The content is the highly confidential and proprietary information of Salesforce and is protected under the confidentiality obligations of your Agreement with Salesforce. Accordingly, the content may be used only as necessary in order to implement the Consumer Goods Cloud Trade Promotion Management functionality.

The content in this documentation is being released as a preview, and is not generally available and may contain errors. Salesforce is providing this documentation as-is, and makes no representations or warranties as to the accuracy of the content contained in this documentation. Salesforce reserves the right to update and revise this documentation, and content describing features of Consumer Goods Cloud Trade Promotion Management may be modified, added, or removed. If Salesforce distributes or releases updated versions of this documentation, you acknowledge and agree that you will delete and destroy any prior versions of this documentation.

Important

Namespace

1cgcloud

Example Implementation

1cgcloud.TPM_Promotion tpmPromotion;
2
3// Append the object to create a wrapper
4cgcloud.TPM_Promotion.Record myRecord = tpmPromotion.append(new MyRecord__c());
5
6// Set field values using a Map
7myRecord.setField(new Map<String, Object> {
8    'IsNew' => true, // The record is new
9    'IsDeleted' => false, // The record is not flagged for deletion
10    'MyField1__c' => 'Hello',
11    'MyField2__c' => 'World!'
12});
13
14// Extract the SObject
15MyRecord__c rec = (MyRecord__c) myRecord.getRecord();
16
17myRecord.isNew(); // true
18myRecord.isDeleted(); // false
19myRecord.getId(); // A temporary SFDC Id
20rec.Field1__c; // 'Hello'
21rec.Field2__c; // 'World!'

TPM_Promotion.Record Methods

The following are methods for TPM_Promotion.Record.

global Boolean isDeleted

Indicates if the record is flagged for deletion or if it will be updated during save.

API Version

55

Signature

global Boolean isDeleted()

global Boolean isNew

Indicates if the record is new or already exists in the database.

API Version

55

Signature

global Boolean isNew()

global Id getId

Returns the temporary id for the wrapped record. Promotion save process uses temporary id’s for records that are not still committed to the database.

API Version

55

Signature

global Id getId()

global SObject getOriginalRecord

Returns the original SObject record as stored in the database. If the record is new, this method returns null.

API Version

55

Signature

global SObject getOriginalRecord()

global SObject getRecord

Returns the wrapped SObject record. The returned record field values can be updated.

API Version

55

Signature

global SObject getRecord()

Example

1cgcloud.TPM_Promotion.Record myRecord;
2
3// Extract the SObject
4MyRecord__c rec = (MyRecord__c) myRecord.getRecord();
5
6// Fields can be changed and they'll be saved during promotion save
7rec.MyField1__c = 'Hello';
8rec.MyField2__c = 'World!;

global void setFields

Sets the fields passed in the map as fields for the wrapped SObject record. The IsNew and IsDeleted fields will map to the is New() and is Deleted() methods. If a key in the map is not an SObject field, it will be ignored.

API Version

55

Signature

global void setFields(Map<String, Object> fieldValues)

Example

1cgcloud.TPM_Promotion tpmPromotion;
2
3// Append the object to create a wrapper
4cgcloud.TPM_Promotion.Record myRecord = tpmPromotion.append(new MyRecord__c());
5
6// Set field values using a Map
7myRecord.setField(new Map<String, Object> {
8    'IsNew' => true, // The record is new
9    'IsDeleted' => false, // The record is not flagged for deletion
10    'MyField1__c' => 'Hello',
11    'MyField2__c' => 'World!'
12});
13
14// Extract the SObject
15MyRecord__c rec = (MyRecord__c) myRecord.getRecord();
16
17myRecord.isNew(); // true
18myRecord.isDeleted(); // false
19myRecord.getId(); // A temporary SFDC Id
20rec.Field1__c; // 'Hello'
21rec.Field2__c; // 'World!'

global void setIsDeleted

Sets the record to be deleted or to update the existing one.

API Version

55

Signature

global void setIsDeleted(Boolean value)

global void setIsNew

Sets the record to be inserted as a new record or to update the existing one.

API Version

55

Signature

global void setIsNew(Boolean value)