月度归档： 2018 年 1 月

DML语句

以下DML语句可用。

• insert
• update
• upsert
• delete
• undelete
• merge

每个DML语句接受一个单独的sObject或一个sObject的列表（或数组）。在sObjects列表上操作是处理记录的更有效的方法。

除了一对，所有这些陈述都是熟悉的数据库操作。 upsert和merge语句是Salesforce特有的，可以非常方便。

upsert DML操作创建新记录，并在单个语句中更新sObject记录，使用指定的字段确定现有对象的存在，或者在没有指定字段的情况下使用ID字段。

合并语句将最多三个相同sObject类型的记录合并到其中一个记录中，删除其他记录，并将所有相关记录重新归类。

ID字段自动分配到新记录

插入记录时，系统为每个记录分配一个ID。除了在数据库中保存ID值之外，还可以在用作DML调用中的参数的sObject变量上自动填充ID值。

这个例子展示了如何获得对应于插入客户的sObject的ID。

// 创建客户sObject
Account acct = new Account(Name='Acme', Phone='(415)555-1212', NumberOfEmployees=100);
// 通过使用DML插入客户
insert acct;

// 获取插入的sObject参数的新ID
ID acctID = acct.Id;
// 在调试日志中显示此ID
System.debug('ID = ' + acctID);

// 调试日志结果（在您的情况下ID将不同）
// DEBUG|ID = 001D000000JmKkeIAF

批量 DML

您可以在单个sObject上执行DML操作，也可以在sObjects列表上批量执行DML操作。执行批量DML操作是推荐的方法，因为它有助于避免触及限额，例如每个Apex交易的DML限制为150条语句。这个限制是为了确保公平地访问Force.com多租户平台中的共享资源。在sObjects列表上执行DML操作会计算为列表中所有sObjects的一个DML语句，而不是每个sObject的一个语句。

此示例通过在一次调用中插入联系人列表来批量插入联系人。该示例然后批量更新这些联系人。

1. 在开发者控制台中使用Anonymous Apex执行此代码段。

   // 创建联系人列表
   List<Contact> conList = new List<Contact> {
       new Contact(FirstName='Joe',LastName='Smith',Department='Finance'),
           new Contact(FirstName='Kathy',LastName='Smith',Department='Technology'),
           new Contact(FirstName='Caroline',LastName='Roth',Department='Finance'),
           new Contact(FirstName='Kim',LastName='Shain',Department='Education')};
               
   // 用一个DML调用批量插入所有联系人
   insert conList;
   
   // List来保存新的联系人进行更新
   List<Contact> listToUpdate = new List<Contact>();
   
   // 遍历列表并仅添加标题
   //  如果部门是财务部门
   for(Contact con : conList) {
       if (con.Department == 'Finance') {
           con.Title = 'Financial analyst';
           // Add updated contact sObject to the list.
           listToUpdate.add(con);
       }
   }
   
   // 将更新的联系人sObject添加到列表中。
   update listToUpdate;
   

2. 检查最近在您的组织中创建的联系人。
   两位在财务部门的联系人应该有他们的头衔，财务分析师。

插入记录

如果您有一个包含新记录和现有记录混合的列表，则可以使用upsert语句来处理对列表中所有记录的插入和更新。 Upsert有助于避免重复记录的创建，并且可以节省时间，因为您不必先确定哪些记录存在。

upsert语句通过比较一个字段的值来将sObjects与现有记录进行匹配。如果调用此语句时未指定字段，则upsert语句将使用sObject的ID将sObject与Salesforce中的现有记录进行匹配。或者，您可以指定一个字段用于匹配。对于自定义对象，请指定标记为外部标识的自定义字段。对于标准对象，可以指定任何idLookup属性设置为true的字段。例如，联系人或用户的电子邮件字段设置了idLookup属性。要检查字段的属性，请参阅Salesforce和Force.com的对象参考。

Upsert语法

upsert sObject | sObject[]

upsert sObject | sObject[]​​ field

upsert sObjectList Account.Fields.MyExternalId;

Upsert使用sObject记录的主键（ID），idLookup字段或外部ID字段来确定是否应该创建新记录或更新现有记录：

• 如果密钥不匹配，则创建一个新的对象记录。
• 如果密钥匹配一次，则更新现有对象记录。
• 如果密钥匹配多次，则会生成错误，并且不会插入或更新对象记录。

这个例子显示了upsert如何更新一个现有的联系人记录，并在一个呼叫中插入一个新的联系人。这个upsert调用更新现有的Josh联系人并插入一个新的联系人Kathy。

1. 在开发者控制台的“执行匿名”窗口中执行此代码段。

   //插入Josh联系人
   Contact josh = new Contact(FirstName='Josh',LastName='Kaplan',Department='Finance');       
   insert josh;
   
   // Josh's 的记录已被插入
   //   所以变量josh现在有一个ID
   //   将用于通过upsert匹配记录
   josh.Description = 'Josh\'s record has been updated by the upsert operation.';
   
   // 创建Kathy联系人，但不要将其保存在数据库中
   Contact kathy = new Contact(FirstName='Kathy',LastName='Brown',Department='Technology');
   
   // 列举以保持新联系人upsert
   List<Contact> contacts = new List<Contact> { josh, kathy };
   
   // 调用upsert
   upsert contacts;
   
   // 结果：Josh被更新，Kathy被创建。

2. 检查组织中的所有联系人。
   您的组织只有一个Josh Kaplan记录，而不是两个，因为upsert操作找到了现有记录并进行了更新，而不是创建新的联系人记录。凯西·布朗的一个联系记录也将在那里。或者，您可以指定一个字段用于匹配记录。此示例使用Contact上的电子邮件字段，因为它具有idLookup属性集。该示例插入Jane Smith联系人，并创建第二个Contact sObject，使用相同的电子邮件填充它，然后使用电子邮件字段进行匹配以调用upsert以更新联系人。

1. 在开发者控制台的“执行匿名”窗口中执行此代码段。

   Contact jane = new Contact(FirstName='Jane',
                            LastName='Smith',
                            Email='jane.smith@example.com',
                            Description='Contact of the day');
   insert jane;
   
   // 1.使用idLookup字段的Upsert
   // 创建第二个sObject变量。
   // 这个变量没有任何ID设置。
   Contact jane2 = new Contact(FirstName='Jane',
                            LastName='Smith',  
                            Email='jane.smith@example.com',
                            Description='Prefers to be contacted by email.');
   // 通过使用idLookup字段进行匹配来提升联系人。
   upsert jane2 Contact.fields.Email;
   
   // 确认联系人已更新
   System.assertEquals('Prefers to be contacted by email.',
                      [SELECT Description FROM Contact WHERE Id=:jane.Id].Description);
   

2. 检查组织中的所有联系人。

   您的组织将只有一个Jane Smith联系更新后的描述。

删除记录

您可以使用delete语句删除持久记录。删除的记录不会从Force.com永久删除，但是它们可以从恢复位置放置在回收站中15天。

此示例显示如何删除姓氏为Smith的所有联系人。如果您已经为批量DML运行了样本，那么您的组织应该与Smith的姓氏有两个联系。在开发人员控制台中使用匿名Apex执行此代码段，然后验证是否没有与姓氏Smith的联系人。

Contact[] contactsDel = [SELECT Id FROM Contact WHERE LastName='Smith']; 
delete contactsDel;

DML语句异常

如果DML操作失败，则返回DmlException类型的异常。您可以在代码中捕获异常以处理错误情况。

这个例子产生了一个DmlException，因为它试图插入一个没有必需的Name字段的客户。 catch块中捕获到异常。

try {
    // 这会导致异常
    //   不提供必需的名称字段。
    Account acct = new Account();
    // 插入客户
    insert acct;
} catch (DmlException e) {
    System.debug('A DML exception has occurred: ' +
                e.getMessage());
}

• Database.insert()
• Database.update()
• Database.upsert()
• Database.delete()
• Database.undelete()
• Database.merge()

与DML语句不同，数据库方法有一个可选的allOrNone参数，允许您指定操作是否应该部分成功。当此参数设置为false时，如果在部分记录集上发生错误，则成功的记录将被提交，并且将为失败的记录返回错误。另外，部分成功选项也不会引发异常。

这是你如何调用allOrNone设置为false的插入方法。

Database.insert(recordList, false);

Database.SaveResult[] results = Database.insert(recordList, false);

Database.insert(recordList);

Database.insert(recordList, true);

示例：以部分成功插入记录

我们来看看使用数据库方法的例子。此示例基于批量DML示例，但是用Database方法替换了DML语句。用部分成功选项调用Database.insert（）方法。列表中的一个联系人没有任何有意使用的字段，并且会导致错误，因为如果没有所需的姓氏字段，则无法保存联系人。三个联系人被提交，没有任何字段的联系人会产生错误。本示例的最后一部分遍历返回的结果并将调试消息写入调试日志。

1. 在开发者控制台的“执行匿名”窗口中执行此示例。

   // 创建联系人列表
   List<Contact> conList = new List<Contact> {
           new Contact(FirstName='Joe',LastName='Smith',Department='Finance'),
           new Contact(FirstName='Kathy',LastName='Smith',Department='Technology'),
           new Contact(FirstName='Caroline',LastName='Roth',Department='Finance'),
           new Contact()};
               
   // 用一个DML调用批量插入所有联系人
   Database.SaveResult[] srList = Database.insert(conList, false);
   
   // 遍历每个返回的结果
   for (Database.SaveResult sr : srList) {
       if (sr.isSuccess()) {
           // 操作成功，所以得到处理记录的ID
           System.debug('Successfully inserted contact. Contact ID: ' + sr.getId());
       } else {
           // 操作失败，所以得到所有的错误
           for(Database.Error err : sr.getErrors()) {
               System.debug('The following error has occurred.');
               System.debug(err.getStatusCode() + ': ' + err.getMessage());
               System.debug('Contact fields that affected this error: ' + err.getFields());
   	 }
       }
   }
   

2. 验证调试消息（使用过滤器的DEBUG关键字）。
   应该报告一个故障，应该插入三个联系人。

你应该使用DML语句还是数据库方法？

• 如果希望在批量DML处理期间发生的任何错误作为立即中断控制流的Apex异常（通过使用try。。catch块）引发，请使用DML语句。这种行为类似于大多数数据库过程语言中处理异常的方式。
• 如果要允许批量DML操作的部分成功，请使用Database类方法 – 如果记录失败，则DML操作的其余部分仍可能成功。然后您的应用程序可以检查被拒绝的记录，并可能重试该操作。使用此表单时，您可以编写不会抛出DML异常错误的代码。相反，您的代码可以使用适当的结果数组来判断成功或失败。请注意，数据库方法还包括一个支持抛出异常的语法，类似于DML语句。

插入相关记录

如果已经在两个对象之间定义了关系（例如查找或主从关系），则可以插入与现有记录相关的记录。记录通过外键ID与相关记录相关联。例如，如果插入新联系人，则可以通过设置AccountId字段的值来指定联系人的相关客户记录。

此示例显示如何通过在联系人上设置AccountId字段来将联系人添加到客户（相关记录）。联系人和客户通过查找关系链接。

1. 在Developer Console的Anonymous Apex窗口中执行此代码段。

   Account acct = new Account(Name='SFDC Account');
   insert acct;
   
   // 一旦插入客户，sObject将填充一个ID。
   // 得到这个ID。
   ID acctID = acct.ID;
   
   // 添加一个联系人到这个客户。
   Contact mario = new Contact(
       FirstName='Mario',
       LastName='Ruiz',
       Phone='415.555.1212',
       AccountId=acctID);
   insert mario;
   

2. 检查组织中的联系人。

   新客户（SFDC客户）已创建，并在客户的“联系人”相关列表中包含Mario Ruiz联系人。

更新相关记录

// 查询与客户关联的联系人。
Contact queriedContact = [SELECT Account.Name 
                          FROM Contact 
                          WHERE FirstName = 'Mario' AND LastName='Ruiz'
                          LIMIT 1];

// 更新联系人的电话号码
queriedContact.Phone = '(415)555-1213';

// 更新相关的客户行业
queriedContact.Account.Industry = 'Technology';

// 拨打两个不同的电话
// 1. 此通话是更新联系人的电话。更新queriedContact;
// 2. 这个电话是更新相关客户的行业领域。
update queriedContact.Account; 

删除相关记录

删除操作支持级联删除。如果删除父对象，则只要每个子记录可以被删除，就会自动删除它的子对象。

例如，删除先前创建的客户（SFDC客户）也会删除其相关联系人。

1. 在Developer Console的Anonymous Apex窗口中执行此代码段。

   Account[] queriedAccounts = [SELECT Id FROM Account WHERE Name='SFDC Account'];
   delete queriedAccounts;

2. 检查您的组织中的客户和联系人。
   您会看到客户及其相关联系人都被删除了。

关于事物

DML操作在事务中执行。事务中的所有DML操作都可以成功完成，或者如果在一个操作中发生错误，则整个事务将回滚，并且不会向数据库提交任何数据。事务的边界可以是触发器，类方法，匿名代码块，Apex页面或自定义Web服务方法。例如，如果触发器或类创建两个客户并更新一个联系人，并且联系人更新由于验证规则失败而失败，则整个事务将回滚，并且Salesforce中的所有客户都不会持久化。

创建sObject变量

要创建一个sObject，你需要声明一个变量并将其分配给一个sObject实例。变量的数据类型是sObject类型。

以下示例创建一个类型为Account的sObject变量，并将其分配给名称为Acme的新客户。

Account acct = new Account(Name='Acme');

sObject和字段名称

sObjects的名称对应于相应的标准或自定义对象的API名称。同样，sObject字段的名称对应于相应字段的API名称。

对象和字段的API名称可能与标签不同。例如，“雇员”字段具有“雇员”标签，并在“客户记录”页面上显示为“雇员”，但其API名称为“NumberOfEmployees”。要在Apex中访问此字段，您需要使用该字段的API名称：NumberOfEmployees。

以下是用于自定义对象和自定义字段的API名称的一些规则的亮点。

对于自定义对象和自定义字段，API名称始终以__c后缀结尾。对于自定义关系字段，API名称以__r后缀结尾。例如：

• 具有Merchandise 标签的自定义对象具有Merchandise__c的API名称。
• 描述标签的自定义字段的API名称为Description__c。
• 具有Items标签的自定义关系字段具有Items__r的API名称。

另外，标签中的空格在API名称中用下划线代替。例如，Employee Seniority的自定义字段名称具有Employee_Seniority__c的API名称。

查找对象和字段名称

要查找在Apex中使用的标准对象及其字段的名称，请参阅Salesforce和Force.com的对象参考。

对于自定义对象，请在您的组织中查找对象和字段API名称。从“设置”中，在“快速查找”框中输入对象，然后选择“对象”，然后单击对象的名称。

创建sObjects和添加字段

在插入Salesforce记录之前，必须首先在内存中创建它作为sObject。与其他任何对象一样，sObject使用新的运算符创建：

Account acct = new Account();

Account acct = new Account(Name='Acme');

Account acct = new Account(Name='Acme', Phone='(415)555-1212', NumberOfEmployees=100);

Account acct = new Account();
acct.Name = 'Acme';
acct.Phone = '(415)555-1212';
acct.NumberOfEmployees = 100;

此示例显示如何将通用的sObject变量分配给任何Salesforce对象：客户和名为Book__c的自定义对象。

sObject sobj1 = new Account(Name='Trailhead');
sObject sobj2 = new Book__c(Name='Workbook 1');

将泛型对象转换为特定的对象类型

当你处理通用的sObjects时，你有时需要将你的sObject变量转换为特定的sObject类型。这样做的好处之一就是能够使用点符号访问字段，这在通用的sObject上是不可用的。由于sObject是所有特定sObject类型的父类型，因此可以将通用sObject转换为特定的sObject。这个例子展示了如何将一个通用的sObject转换为Account。

// 将一个通用的sObject转换为一个Account
Account acct = (Account)myGenericSObject;
// 现在，您可以使用点符号来访问客户上的字段Account
String name = acct.Name;
String phone = acct.Phone;

告诉我更多…

与特定的sObjects类型不同，通用sObjects只能通过newSObject（）方法创建。而且，只能通过put（）和get（）方法访问通用sObject的字段。

在这个单元中，你已经学习了什么sObjects以及如何使用它们。但是，创建一个sObject并不会将其作为记录保存在数据库中。要将sObject保存为记录，并用它来做其他事情，请使用数据操作语言（DML）。要检索记录，请使用Salesforce对象查询语言（SOQL）。查看以后的单元，了解DML和SOQL。

Apex 语言亮点

像其他面向对象的编程语言一样，这些是Apex支持的一些语言结构：

• 类，接口，属性和集合（包括数组）。
• 对象和数组表示法。
• 表达式，变量和常量。
• 条件语句（if-then-else）和控制流语句（for循环和while循环）。

与其他面向对象的编程语言不同，Apex支持：

• 作为Apex的云开发是在云中存储，编译和执行的。
• 触发器，类似于数据库系统中的触发器。
• 数据库语句，允许您直接进行数据库调用和查询语言来查询和搜索数据。
• 事务和回滚。
• 全局访问修饰符，它比public修饰符更宽松，并允许跨命名空间和应用程序访问。
• 自定义代码的版本。

另外，Apex是一个不区分大小写的语言。

开发工具

您可以使用Salesforce用户界面直接在浏览器中编写Apex并访问调试信息。打开您的名字下的开发者控制台或快速访问菜单（设置齿轮图标）。

您也可以使用Eclipse的Force.com IDE插件在客户端上编写Apex。请参阅Salesforce Developer网站上的Force.com IDE。

• 诸如Integer，Double，Long，Date，Datetime，String，ID，Boolean等原语。
• 一个sObject，或者作为一个通用的sObject或者一个特定的sObject，比如一个Account，Contact或者MyCustomObject__c（你将在后面的单元中学到更多关于sObjects的知识）。
• 收藏品包括：
  • 基元，sObjects，用户定义的对象，从Apex类创建的对象或集合的列表（或数组）
  • 一组原语
  • 从基元到基元，sObject或集合的映射
• 一个键入的值列表，也被称为枚举
• 用户定义的Apex类
• 系统提供的Apex类

Apex收藏：列表

列表包含对象的有序集合。 Apex中的列表与数组同义，两者可以互换使用。

以下两个声明是等价的。 colors变量是使用List语法声明的。

List<String> colors = new List<String>();

String[] colors = new List<String>();

// 创建一个列表并向其中添加元素
List<String> colors = new List<String> { 'red', 'green', 'blue' };

// 创建元素后，将元素添加到列表中
List<String> moreColors = new List<String>();
moreColors.add('orange');
moreColors.add('purple');

// 从列表中获取元素
String color1 = moreColors.get(0);
String color2 = moreColors[0];
System.assertEquals(color1, color2);

// 遍历列表来读取元素
for(Integer i=0;i<colors.size();i++) {
    // Write value to the debug log
    System.debug(colors[i]);
}

保存一个Apex类

将EmailManager类保存在您的组织中：

1. 打开您的名字下的开发者控制台或快速访问菜单（设置齿轮图标）。
2. 在开发者控制台中，点击 File | New | Apex Class ，然后输入EmailManager作为类名称，然后单击OK。
3. 用EmailManager类的例子替换默认的类体。

   EmailManager类具有公共方法（sendMail（）），用于发送电子邮件并使用Apex类库的内置消息处理方法。另外，这个类有一个私有的帮助方法（inspectResults（）），它不能被外部调用，因为它是私有的，但只在类中使用。这个帮助方法检查电子邮件发送调用的结果，并由sendMail（）调用。

   public class EmailManager {
   
       // 公共方法
       public void sendMail(String address, String subject, String body) {
           // 创建一个电子邮件对象
           Messaging.SingleEmailMessage mail = new Messaging.SingleEmailMessage();
           String[] toAddresses = new String[] {address};
           mail.setToAddresses(toAddresses);
           mail.setSubject(subject);
           mail.setPlainTextBody(body);
           // 将此电子邮件传递给内置的sendEmail方法
           // 消息类的
           Messaging.SendEmailResult[] results = Messaging.sendEmail(
                                    new Messaging.SingleEmailMessage[] { mail });
           
           // 调用一个帮助器方法来检查返回的结果
           inspectResults(results);
       }
       
       // 辅助方法
       private static Boolean inspectResults(Messaging.SendEmailResult[] results) {
           Boolean sendResult = true;
           
           // sendEmail返回一个结果对象数组。
           // 遍历列表来检查结果。
           // 在这个类中，方法只发送一封邮件，
           // 所以我们应该只有一个结果。
           for (Messaging.SendEmailResult res : results) {
               if (res.isSuccess()) {
                   System.debug('Email sent successfully');
               }
               else {
                   sendResult = false;
                   System.debug('发生以下错误：' + res.getErrors());                 
               }
           }
           
           return sendResult;
       }
   
   }

4. 点击Ctrl + S保存你的课程。

   超越基础

   刚刚保存的类使用面向对象编程（OOP）。该类封装了与管理电子邮件有关的方法。为了成为OOP的一个完美的例子，类还将包含成员变量（属性）和访问器方法来访问这些属性，但为了简单起见，我们的类没有这些。

   Salesforce在您保存时编译您的类。

调用方法发送电子邮件

我们来调用公共方法。我们将使用匿名的Apex执行来执行此操作。匿名Apex允许您即时运行代码行，并且是调用Apex的一种便捷方式，尤其是测试功能。与任何其他Apex执行一样，也会生成调试日志结果。

1. 在开发者控制台中，点击 Debug | Open Execute Anonymous Window.
2. 在打开的窗口中，输入以下内容。用您的电子邮件地址替换“您的电子邮件地址”。

   EmailManager em = new EmailManager();
   em.sendMail('Your email address', 'Trailhead Tutorial', '123 body');
   

3. 点击 Execute.

   现在这个方法已经执行了，你应该在收件箱里收到一封电子邮件。查看你的电子邮件！

检查调试日志

调试日志对于调试代码很有用。当Apex方法执行时，调用会记录在调试日志中。而且，您可以将自己的调试消息写入日志，这有助于在出现错误时调试代码。由sendMail（）调用的inspectResults（）辅助方法使用System.debug（）方法将消息写入日志，以指示电子邮件发送操作是成功还是有错误。您可以在执行该方法时生成的调试日志中查找这些消息。

1. 在开发者控制台中，点击日志标签，然后双击列表中最近的日志。
2. 选择 Debug Only 来过滤日志，以便仅显示System.debug（）语句的日志行。
   

   注意

   另外，您可以通过在“筛选”字段中搜索任何关键字来筛选调试日志，或者通过选择任何其他选项来筛选调试日志。有关更多信息，请参阅日志检查器帮助。

   在过滤的日志视图中，您会看到以下消息，假设电子邮件发送没有错误。

   DEBUG|Email sent successfully

调用静态方法

因为我们类中的sendMail（）方法不能访问类成员变量，所以它不需要是一个实例方法。让我们通过添加静态关键字到它的声明来将其更改为静态方法。静态方法比实例方法更容易调用，因为它们不需要在类的实例上调用，而是直接在类名上调用。

1. 在开发人员控制台中，找到EmailManager类的打开选项卡，并将sendMail（）方法定义的第一行修改为以下内容（唯一的变化是添加的static关键字）。

   public static void sendMail(String address, String subject, String body) {

2. 按Ctrl + S保存该类。
3. 修改“执行匿名”窗口中的语句以调用类名称上的静态方法。

   EmailManager.sendMail('Your email address', 'Trailhead Tutorial', '123 body');
   

4. 点击 Execute.

   现在这个方法已经执行了，你可以像在前面的步骤一样检查你的电子邮件，以及可选的调试日志。