この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。
英語に切り替える

Lead

見込みの、または潜在的な Opportunity を表します。

サポートされているコール

create()、delete()、describeLayout()、describeSObjects()、getDeleted()、getUpdated()、merge()、query()、retrieve()、search()、undelete()、update()、upsert()

項目

項目 詳細
Address
型
address
プロパティ
Filter、Nillable
説明
複合型の住所。参照のみ。複合住所項目についての詳細は、「住所複合項目」を参照してください。
AnnualRevenue
型
currency
プロパティ
Create、Filter、Nillable、Sort、Update
説明
リードの会社の年間収益。
City
型
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
リードの住所の市区郡。
CleanStatus
型
picklist
プロパティ
Create、Filter、Group、Nillable、Restricted picklist、Sort、Update
説明
レコードのクリーンアップ状況を Data.com との比較で示します。値は、Matched、Different、Acknowledged、NotFound、Inactive、Pending、SelectMatch、Skipped のいずれかです。
CleanStatus のいくつかの値は、異なる表示ラベルでリードレコードの詳細ページに表示されます。
  • Matched は 同期済み として表示される
  • Acknowledged は レビュー済み として表示される
  • Pending は 未比較 として表示される
Company
型
string
プロパティ
Create、Filter、Group、Sort、Update
説明
必須。リードの会社。

個人取引先レコードタイプが有効化されており、Company の値が null の場合、リードは個人取引先に変換されます。

メモ

CompanyDunsNumber
型
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
Data Universal Numbering System (D-U-N-S) Number は、Dun & Bradstreet データベース内の、それぞれ事業が異なる一意の各事業所に割り当てられた一意の 9 桁の番号です。D-U-N-S Number は、事業の識別と追跡のための世界標準として世界中の産業と組織で使用されます。最大 9 文字です。

この項目は、Data.com プロスペクタまたは Data.com クリーンアップを使用する組織でのみ使用できます。

メモ

ConnectionReceivedId
型
reference
プロパティ
Filter、Group、Nillable、Sort
説明
組織とこのレコードを共有した PartnerNetworkConnection の ID。この項目は、Salesforce to Salesforce が有効な場合にのみ使用できます。
ConnectionSentId
型
reference
プロパティ
Filter、Group、Nillable、Sort
説明
このレコードを共有した PartnerNetworkConnection の ID。この項目は、Salesforce to Salesforce が有効な場合にのみ使用できます。API バージョン 15.0 以降では、ConnectionSentId 項目はサポートされていません。ConnectionSentId 項目は使用できますが、値は Null です。レコードを接続に転送するには、新しい PartnerNetworkRecordConnection を使用します。
ConvertedAccountId
型
reference
プロパティ
Filter、Group、Nillable、Sort
説明
Lead が変換される Account を示すオブジェクト参照 ID。
ConvertedContactId
型
reference
プロパティ
Filter、Group、Nillable、Sort
説明
Lead が変換される Contact を示すオブジェクト参照 ID。
ConvertedDate
型
date
プロパティ
Filter、Group、Nillable、Sort
説明
この Lead が変換された日付。
ConvertedOpportunityId
型
reference
プロパティ
Filter、Group、Nillable、Sort
説明
Lead が変換される Opportunity を示すオブジェクト参照 ID。
Country
型
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
リードの住所の国。
CountryCode
型
picklist
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
リードの住所の ISO 国コード。
CurrencyIsoCode
型
picklist
プロパティ
Create、Defaulted on create、Filter、Group、Nillable、Restricted picklist、Sort、Update
説明
複数の currency 機能を有効化している組織にのみ使用できます。組織で使用できる currency の ISO コードが指定されています。
Description
型
textarea
プロパティ
Create、Nillable、Update
説明
リードの説明。
Division
型
picklist
プロパティ
Filter、Group、Restricted picklist、Sort
説明
組織のデータの論理セグメント。組織でディビジョン権限が有効化されている場合にのみ使用可能です。
Email
型
email
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
リードのメールアドレス。
EmailBouncedDate
型
dateTime
プロパティ
Filter、Nillable、Sort、Update
説明
不達管理が有効化され、リードに送信されるメールが宛先不明で戻ってきた場合の、メールが返送された日時。
EmailBouncedReason
型
string
プロパティ
Filter、Group、Nillable、Sort、Update
説明
不達管理が有効化され、リードに送信されるメールが宛先不明で戻ってきた場合の、メールが返送された理由。
Fax
型
phone
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
リードの FAX 番号。
FirstName
型
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
リードの名。最大 40 文字です。
HasOptedOutOfEmail
型
boolean
プロパティ
Create、Defaulted on create、Filter、Update
説明
リードのメール送信が除外されているか (true)、否か (false) を示します。表示ラベルは [メール送信除外] です。
Industry
型
picklist
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
リードの業種。
IsConverted
型
boolean
プロパティ
Create、Defaulted on create、Filter、Group、Sort
説明
Lead が変換されているか (true)、否か (false) を示します。表示ラベルは [取引開始済み] です。
IsDeleted
型
boolean
プロパティ
Defaulted on create、Filter
説明
オブジェクトがごみ箱に移動したか (true)、否か (false) を示します。表示ラベルは Deleted です。
IsUnreadByOwner
型
boolean
プロパティ
Create、Defaulted on create、Filter、Group、Sort、Update
説明
true の場合、リードは割り当てられますが、参照されません。詳細は、「未読のリード」を参照してください。表示ラベルは [所有者未読フラグ] です。
Jigsaw
型
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
Data.com の取引先責任者の ID を参照します。リードのこの項目に値がある場合、その取引先責任者が Data.com からリードとしてインポートされたことを意味します。Data.com から取引先責任者 (リードに変換済み) がインポートされていない場合は、この項目の値は null です。最大 20 文字です。API バージョン 22.0 以降で使用できます。表示ラベルは Data.com Key です。

Jigsaw 項目は、インポートエラーのトラブルシューティングと訂正されたデータの再インポートをサポートするために、API に表示されています。Jigsaw 項目の値を変更しないでください。

重要

LastActivityDate
型
date
プロパティ
Filter、Group、Nillable、Sort
説明
値は、次のいずれかのうち、最新のものになります。
  • レコードに対して記録された直近の行動の期日。
  • レコードに関連付けられた ToDo のうち直近に完了したものの期日。
LastName
型
string
プロパティ
Create、Filter、Group、Sort、Update
説明
必須。リードの姓。最大 80 文字です。
LastReferencedDate
型
date
プロパティ
Filter、Nillable、Sort、Update
説明
現在のユーザがこのレコードに関連するレコードを最後に表示したときのタイムスタンプ。
LastViewedDate
型
date
プロパティ
Filter、Nillable、Sort、Update
説明
現在のユーザがこのレコードを最後に表示したときのタイムスタンプ。この値が null の場合、このレコードは参照 (LastReferencedDate) されただけで、表示はされていない可能性があります。
緯度
型
double
プロパティ
Create、Filter、Nillable、Sort、Update
説明
Longitude と一緒に使用して、住所の正確な地理位置情報を指定します。許容値は、–90 ~ 90 (小数点以下 15 桁まで) の数値です。
経度
型
double
プロパティ
Create、Filter、Nillable、Sort、Update
説明
Latitude と一緒に使用して、住所の正確な地理位置情報を指定します。許容値は、–180 ~ 180 (小数点以下 15 桁まで) の数値です。
LeadSource
型
picklist
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
リードが取得されるソース。
MasterRecordId
型
reference
プロパティ
Filter、Group、Nillable、Sort
説明
このオブジェクトが結合の結果として削除された場合、この項目には保存されたレコードの ID が入力されます。他の理由でこのオブジェクトが削除された場合、または削除されていない場合、値は null となります。

Apex トリガを使用してマージイベントで削除されたレコードを判断する場合、この項目の値は Trigger.old でのみ保持されるレコードの ID となります。Trigger.new では、値は null となります。

メモ

MiddleName
型
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
リードのミドルネーム。最大 40 文字です。この項目を有効化するには、Salesforce カスタマーサポートにご連絡ください。
MobilePhone
型
phone
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
リードの携帯電話番号。
Name
型
string
プロパティ
Filter、Group、Sort
説明
FirstName、MiddleName、LastName、Suffix の連結です。最大 121 文字です。
NumberOfEmployees
型
int
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
リードの会社の従業員数。表示ラベルは [従業員数] です。
OwnerId
型
reference
プロパティ
Create、Defaulted on create、Filter、Group、Sort、Update
説明
リードの所有者の ID。
PartnerAccountId
型
reference
プロパティ
Filter、Nillable
説明
このリードを所有するパートナーユーザのパートナー取引先の ID。PRM 機能が有効な場合、またはコミュニティが有効になっていて、パートナーポータルライセンスを所有している場合にのみ使用できます。

API バージョン 15.0 以前を使用してリードをアップロードしており、バッチのいずれかのリードにパートナーユーザが所有者として指定されている場合、バッチ内のすべてのリードの [パートナー取引先] 項目が、パートナーユーザが所有者であるかどうかに関係なく、パートナーユーザの取引先に設定されます。バージョン 16.0 では、[パートナー取引先] 項目は、リードを所有するパートナーユーザの該当する取引先に設定されます。リードの所有者がパートナーユーザでない場合、この項目は空白になります。

メモ

Phone
型
phone
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
リードの電話番号。
PhotoUrl
型
url
プロパティ
Filter、Group、Sort
説明

リードと関連付けられたソーシャルネットワークプロファイルの画像を要求するための URL を生成するために Salesforce インスタンス (https://na1.salesforce.com/ など) の URL と組み合わせるパス。生成された URL から、リードのソーシャルネットワークプロファイルの画像への HTTP リダイレクト (コード 302) が返されます。

組織で [ソーシャル取引先と取引先責任者] が有効になっていないか、要求ユーザに対して [ソーシャル取引先と取引先責任者] が無効になっている場合は、空白になります。

PostalCode
型
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
リードの住所の郵便番号。表示ラベルは [郵便番号] です。
Rating
型
picklist
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
リードの評価。
RecordTypeId
型
reference
プロパティ
Create、Filter、Nillable、Update
説明
このオブジェクトに割り当てられるレコードタイプの ID。
Salutation
型
picklist
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
リードの敬称。
State
型
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
リードの住所の都道府県。
StateCode
型
picklist
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
リードの住所の ISO 都道府県コード。
Status
型
picklist
プロパティ
Create、Defaulted on create、Filter、Group、Sort、Update
説明
変換されたリードの状況コード。状況コードは、Status に定義され、LeadStatus オブジェクトごとに API に表示されます。
Street
型
textarea
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
リードの住所の地名、番地。
Suffix
型
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
リードの名前サフィックス。最大 40 文字です。この項目を有効化するには、Salesforce カスタマーサポートにご連絡ください。
Title
型
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
CFO や CEO など、リードの役職。
Website
型
url
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
リードの Web サイト。

リードデータをインポートし、CreatedDate など、監査項目に値を設定する必要がある場合、Salesforce に連絡してください。これらの項目を自身で設定する必要がない限り、監査項目は API 操作時に自動的に更新されます。

メモ

変換済みのリード

リードが Account、Contact、Opportunity (オプション) に変換されたことを示す特別な状況があります。クライアントアプリケーションは、convertLead() コールを使用してリードを変換することができます。また、ユーザはユーザインターフェースを使用してリードを変換することもできます。リードが変換されると、参照のみになります。変換されたリードは、更新または削除できません。ただし、変換されたリードレコードをクエリすることはできます。

リードには、変換された状況を示すいくつかの項目があります。これらの項目は、ユーザインターフェースでリードを変換する場合に設定されます。

  • ConvertedAccountId
  • ConvertedContactId
  • ConvertedDate
  • ConvertedOpportunityId
  • IsConverted
  • Status

個人取引先レコードタイプが有効化されており、Company の値が null の場合、リードは個人取引先に変換されます。

メモ

未読のリード

リードには、リード所有者が参照していないまたは編集していないことを示す特別な状況があります。ユーザインターフェースでは、ユーザが割り当てられているがまだ処理されていないリードを知っておくことは役に立ちます。リード所有者がまだリードを参照も編集もしていない場合、IsUnreadByOwner 項目が true になります。リード所有者がリードを少なくとも一度は参照または編集している場合は false となります。

リード状況選択リスト

Status の値は、ユーザインターフェースで定義されているように、リード状況選択リストの変換された状況または変換されていない状況に対応します。選択リストでリードの状況値を取得するには、クライアントアプリケーションは、LeadStatus をクエリできます。

API によって、Status をリードが変換済みであることを示す状況値のいずれかに変更して、リードを変換することはできません。評価済みリードを取引先、取引先責任者、商談に変換する際に、リードに対して、変換済みであることを示す状況のタイプを 1 つ選択できます。こうしたタイプを割り当てられたリードは、レポートに含めることはできますが、[リード] タブには表示されなくなります。

使用方法

リードを更新する、または convertLead() を使用して変換するには、リードに対する「編集」権限でクライアントアプリケーションにログインしている必要があります。

リードを作成、更新、または更新/挿入すると、クライアントアプリケーションは、ユーザインターフェースで設定された割り当てルールに基づいて、リードを 1 つ以上の User レコードに自動的に割り当てることができます。

この機能を使用するために、クライアントアプリケーションは、create または update で使用する AssignmentRuleHeader に次のオプションのいずれか (両方ではない) を設定する必要があります。

項目 データ型 詳細
assignmentRuleId reference 使用する割り当てルールの名前。無効な割り当てルールの場合があります。指定されていない場合および useDefaultRule が true の場合、デフォルトの割り当てルールが使用されます。

指定された割り当てルールの ID を検索するには、AssignmentRule オブジェクトをクエリし (RuleType="leadAssignment" を指定)、返される AssignmentRule レコードを反復し、使用する割り当てルールを検索してその ID を取得し、AssignmentRuleHeader のこの項目に取得した ID を設定します。

useDefaultRule boolean ルールに基づいた割り当てのデフォルトルールを使用するか (true)、否か (false) を示します。デフォルトのルールは、ユーザインターフェースで割り当てられます。

Java のサンプル

次の Java のサンプルでは、新しく作成されたリードを自動的にどのように割り当てるかを示しています。

1swfobject.registerObject("clippy.codeblock-0", "9");
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17package com.doc.samples; 
18import java.net.MalformedURLException; 
19import java.net.URL; 
20import java.rmi.RemoteException; 
21import javax.xml.rpc.ServiceException;
22
23import com.sforce.soap.enterprise.LoginResult; 
24import com.sforce.soap.enterprise.QueryResult; 
25import com.sforce.soap.enterprise.SaveResult; 
26import com.sforce.soap.enterprise.SforceServiceLocator; 
27import com.sforce.soap.enterprise.SoapBindingStub; 
28import com.sforce.soap.enterprise._AssignmentRuleHeader; 
29import com.sforce.soap.enterprise._SessionHeader; 
30import com.sforce.soap.enterprise.fault.LoginFault; 
31import com.sforce.soap.enterprise.fault.UnexpectedErrorFault; 
32import com.sforce.soap.enterprise.sobject.Lead; 
33import com.sforce.soap.enterprise.sobject.SObject; 
34
35public class LeadAssignment
36{
37
38  static LeadAssignment _leadAssignment;
39
40  public static void main(String[] args)
41  { 
42    _leadAssignment = new LeadAssignment(); 
43    try { 
44      _leadAssignment.CreateLead(); 
45    } catch (Exception e) { 
46      e.printStackTrace(); 
47    } 
48  } 
49
50  public void CreateLead() throws UnexpectedErrorFault, LoginFault, 
51    RemoteException, ServiceException
52  { 
53    //Create the proxy binding and login 
54    SoapBindingStub binding = (SoapBindingStub) new SforceServiceLocator().getSoap();
55    LoginResult lr = binding.login("user@domain.net", "secret"); 
56 
57    //Reset the binding to use the endpoint returned from login 
58    binding._setProperty(SoapBindingStub.ENDPOINT_ADDRESS_PROPERTY, 
59        lr.getServerUrl());
60 
61    //Create the session id header, and add it to the proxy binding 
62    _SessionHeader sh = new _SessionHeader(); 
63    sh.setSessionId(lr.getSessionId()); 
64    binding.setHeader(
65        new SforceServiceLocator().getServiceName().getNamespaceURI(),
66        "SessionHeader", sh );
67 
68    //Create a new case and assign various properties 
69    Lead lead = new Lead(); 
70 
71    lead.setFirstName("Joe"); 
72    lead.setLastName("Smith"); 
73    lead.setCompany("ABC Corporation"); 
74    lead.setLeadSource("API"); 
75    //The lead assignment rule will assign any new leads that 
76    //have "API" as the LeadSource to a particular user 
77 
78    //Create the assignment rule header and add it to the proxy binding 
79    _AssignmentRuleHeader arh = new _AssignmentRuleHeader(); 
80 
81    //In this sample we will look for a particular rule and if found 
82    //use the id for the lead assignment. If it is not found we will 
83    //instruct the call to use the current default rule. You can't use 
84    //both of these values together. 
85    QueryResult qr = binding.query("Select Id From AssignmentRule where Name = " +
86       "'Mass Mail Campaign' and RuleType = 'leadAssignment'"); 
87    if (qr.getSize() == 0) { 
88      arh.setUseDefaultRule(new Boolean(true)); 
89    } else { 
90      arh.setAssignmentRuleId(qr.getRecords(0).getId()); 
91    } 
92 
93    binding.setHeader(
94        new SforceServiceLocator().getServiceName().getNamespaceURI(),
95            "AssignmentRuleHeader", arh); 
96 
97    // Every operation that results in a new or updated case, will 
98    // use the specified rule until the header is removed from the 
99    // proxy binding. 
100    SaveResult[] sr = binding.create(new SObject[] {lead}); 
101    for (int i=0;i<sr.length;i++) { 
102      if (sr[i].isSuccess()) {
103        System.out.println("Successfully created lead with id of: " + 
104          sr[i].getId().getValue() + ".");
105      }
106      else {
107        System.out.println("Error creating lead: " + 
108          sr[i].getErrors(0).getMessage());
109      }
110    } 
111 
112    // This call effectively removes the header, the next lead will 
113    // be assigned to the default lead owner. Remember to add the 
114    // session header back in. 
115    binding.clearHeaders(); 
116    binding.setHeader(
117        new SforceServiceLocator().getServiceName().getNamespaceURI(),
118            "SessionHeader", sh); 
119 
120  }
121}

C# のサンプル

次の C# のサンプルでは、新しく作成されたリードを自動的にどのように割り当てるかを示しています。

1swfobject.registerObject("clippy.codeblock-1", "9");
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17using System;
18using System.Collections.Generic;
19using System.Text;
20using LeadAssignment.sforce;
21
22namespace LeadAssignment
23{
24    class LeadAssignment
25    {
26        private SforceService binding;
27
28        private static readonly string Username = "ENTERUSERNAME";
29        private static readonly string Password = "ENTERPASSWORD";
30
31        /// <summary>
32        /// Create the proxy binding and login
33        /// </summary>
34        private LeadAssignment()
35        {
36            this.binding = new SforceService();
37            LoginResult lr = binding.login(LeadAssignment.Username, LeadAssignment.Password);
38
39            // Reset the binding to use the endpoint returned from login
40            this.binding.Url = lr.serverUrl;
41
42            // Create the session ID header and add it to the proxy binding
43            this.binding.SessionHeaderValue = new SessionHeader();
44            this.binding.SessionHeaderValue.sessionId = lr.sessionId;
45        }
46
47        [STAThread]
48        static void Main(string[] args)
49        {
50            LeadAssignment leadAssignment = new LeadAssignment();
51            try
52            {
53                leadAssignment.CreateLead();
54            }
55            catch (Exception e)
56            {
57                Console.WriteLine(e.Message);
58                Console.WriteLine(e.StackTrace);
59                Console.WriteLine(e.InnerException);
60            }
61        }
62
63        public void CreateLead()
64        {
65            // Create a new Lead and assign various properties
66            Lead lead = new Lead();
67
68            lead.FirstName = "John";
69            lead.LastName = "Brown";
70            lead.Company = "ABC Corporation";
71            lead.LeadSource = "Advertisement";
72            // Setting the lead source for a pre-existing lead assignment rule. This 
73            // rule was created outside of this sample and will assign any new leads
74            // that have "Advertisement" as the LeadSource to a particular user
75
76            // Create the assignment rule header and add it to the proxy binding
77            AssignmentRuleHeader arh = new AssignmentRuleHeader();
78
79            // In this sample we will look for a particular rule and if found
80            // use the id for the lead assignment. If it is not found we will
81            // instruct the call to use the current default rule. Both these
82            // values can't be used together.
83            QueryResult qr = binding.query("Select Id from AssignmentRule where Name = " +
84                "'Mass Mail Campaign' and SobjectType = 'lead'");
85            if (qr.size == 0)
86            {
87                arh.useDefaultRule = true;
88            }
89            else
90            {
91                arh.assignmentRuleId = qr.records[0].Id;
92            }
93            binding.AssignmentRuleHeaderValue = arh;
94
95            // Every operation that results in a new or updated lead will use the
96            // specified rule until the header is removed from the proxy binding
97            SaveResult[] sr = binding.create(new sObject[] { lead });
98            foreach (SaveResult s in sr)
99            {
100                if (s.success)
101                {
102                    Console.WriteLine("Successfully created Lead with ID: {0}", s.id);
103                }
104                else
105                {
106                    Console.WriteLine("Error creating Lead: {0}", s.errors[0].message);
107                }
108            }
109
110            // This call effectively removes the header. The next lead will be assigned
111            // to the default lead owner.
112            binding.AssignmentRuleHeaderValue = null;
113        }
114    }
115}
116