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

Picklist (連動選択リストを含む)

カスタムオブジェクトのカスタム項目、または取引先などの標準オブジェクトのカスタム項目または標準項目の選択リスト (または連動選択リスト) の定義を表します。

バージョン

カスタムオブジェクトのカスタム項目の選択リストは、API バージョン 12.0 以降で使用できます。取引先などの標準オブジェクトのカスタム項目または標準項目の選択リストは、API バージョン 16.0 以降で使用できます。API バージョン 27.0 以降では、カスタム項目のリリースに必要な場合は、選択リストの値が削除されます。

宣言的なメタデータファイルのサフィックスおよびディレクトリの場所

選択リストの定義は、カスタムオブジェクトと選択リストの定義が関連付けられた項目に含まれます。

項目

選択リストには次の項目が含まれます。

項目名	データ型	説明
controllingField	string	これが連動選択リストである場合、制御項目の fullName。連動選択リストは、制御選択リストまたはチェックボックスと連動して動作し、使用可能なオプションに検索条件を適用します。制御項目で選択した値は、連動項目に使用できる値に影響します。この項目は API バージョン 14.0 以降で使用できます。
picklistValues	PicklistValue[]	必須。選択リストの値のセットを表します。
sorted	boolean	必須。値を並び替えるか (`true`)、否か (`false`) を示します。

PicklistValue

このメタデータ型では選択リストの値を定義し、この値がデフォルト値であるかどうかを指定します。Metadata メタデータ型を拡張し、その fullName 項目を継承します。選択リストの値を使用する場合は、次の点に注意してください。

標準オブジェクトを取得する場合、カスタマイズされた選択リスト値のみでなく、すべての選択リスト値が取得されます。
標準選択リスト項目への変更をリリースする場合、必要に応じて選択リストの値が追加されます。
選択リストの値を無効として設定することはできませんが、選択リストの値が欠落しているときに update() コールを呼び出すと、欠落している値が無効になります。

項目名	データ型	説明
allowEmail	boolean	この値によりユーザが見積 PDF をメール送信できるか (`true`)、否か (`false`) を示します。この項目は見積の Status 項目にのみ関連します。この項目は API バージョン 18.0 以降で使用できます。
closed	boolean	この値が完了の状況に関連付けられるか (`true`)、否か (`false`) を示します。この項目はケースおよび ToDo の標準項目の Status にのみ関連します。この項目は API バージョン 16.0 以降で使用できます。
color	string	レポートおよびダッシュボードのグラフで色が使用されている場合、選択リスト値に割り当てられている色を示します。色は、16 進形式で表記されます (#FF6600 など)。色が指定されていない場合、グラフ作成時に動的に割り当てられます。この項目は API バージョン 17.0 以降で使用できます。
controllingFieldValues	string[]	この選択リスト値にリンクしている制御項目の値のリスト。制御項目は、チェックボックスまたは選択リストにすることができます。この項目は API バージョン 14.0 以降で使用できます。リストの値は項目のデータ型によって異なります。 `Checkbox`: `checked` または `unchecked`。 `Picklist`: 制御項目の選択リスト値の fullName。
converted	boolean	この値が取引開始済みの状況に関連付けられるか (`true`)、否か (`false`) を示します。この項目はリードの標準項目の [リード状況] にのみ関連します。詳細は、Salesforce オンラインヘルプの「評価済みリードの取引開始」を参照してください。この項目は、API バージョン 16.0 以降で使用できます。
cssExposed	boolean	この値がセルフサービスポータルで使用可能か (`true`)、否か (`false`) を示します。この項目はケースの標準項目の [原因] にのみ関連します。セルフサービスは、顧客にオンラインサポートチャネルを提供します。これにより、顧客は、カスタマサービス担当者に連絡しなくても各自の疑問を解消できます。セルフサービスについての詳細は、Salesforce オンラインヘルプの「セルフサービスの設定」を参照してください。 Spring '12 リリースから、新しい組織ではセルフサービスポータルを利用できなくなります。既存の組織は、引き続きセルフサービスポータルを使用できます。メモこの項目は API バージョン 16.0 以降で使用できます。
default	boolean	必須。この値が指定されている選択リストのデフォルトの選択リスト値であるか (`true`)、否か (`false`) を示します。
description	string	カスタム選択リスト値の説明。この項目は商談の標準項目の Stage にのみ関連します。カスタマイズされている選択リスト値に関する説明を記載すると、これを作成した理由の履歴を追跡できるので便利です。この項目は API バージョン 16.0 以降で使用できます。
forecastCategory	ForecastCategories (string 型の列挙)	この値が売上予測分類に関連付けられるか (`true`)、否か (`false`) を示します。この項目は商談の標準項目の Stage にのみ関連します。以下に示した有効な文字列値を含む、売上予測分類についての詳細は、Salesforce オンラインヘルプの「売上予測分類の使用」を参照してください。 Omitted Pipeline BestCase Forecast Closed この項目は API バージョン 16.0 以降で使用できます。
fullName	string	API アクセスの一意の識別子として使用される名前。fullName には、アンダースコアと英数字のみを使用できます。一意であること、最初は文字であること、空白は使用しない、最後にアンダースコアを使用しない、2 つ続けてアンダースコアを使用しないという制約があります。この項目は、Metadata コンポーネントから継承されています。
highPriority	boolean	この値が優先度が高い項目であるか (`true`)、否か (`false`) を示します。この項目は ToDo の標準項目の Priority にのみ関連します。ToDo についての詳細は、Salesforce オンラインヘルプの「ToDo の使用についての考慮事項」を参照してください。この項目は、API バージョン 16.0 以降で使用できます。
probability	int	この値が確度割合であるか (`true`)、否か (`false`) を示します。この項目は商談の標準項目の Stage にのみ関連します。この項目は API バージョン 16.0 以降で使用できます。
reverseRole	string	パートナーの相手側から見たロールの名前に対応する選択リスト値。ロールが「下請け」の場合、相手側から見たロールは「元請け」となります。Salesforce でパートナーロールを取引先に割り当てると、相手側から見たパートナーとの関係が��成され、両方の取引先で他方をパートナーとして表示できます。この項目は、パートナーロールにのみ関連します。詳細は、Salesforce オンラインヘルプの「パートナーの項目」を参照してください。この項目は、API バージョン 18.0 以降で使用できます。
reviewed	boolean	この値がレビュー済み状況に関連付けられるか (`true`)、否か (`false`) を示します。この項目はソリューションの標準項目の Status にのみ関連します。商談についての詳細は、Salesforce オンラインヘルプの「ソリューションの作成」を参照してください。この項目は、API バージョン 16.0 以降で使用できます。
won	boolean	この値が完了または成立の状況に関連付けられるか (`true`)、否か (`false`) を示します。この項目は商談の標準項目の Stage にのみ関連します。この項目は API バージョン 16.0 以降で使用できます。

Java のサンプル

次のサンプルでは選択リストを使用します。レコードタイプおよびプロファイルを含む選択リストを使用する完全なサンプルについては、「Profile」を参照してください。

1public void setPicklistValues() {
2  // Create a picklist
3  Picklist expenseStatus = new Picklist();
4  PicklistValue unsubmitted = new PicklistValue();
5  unsubmitted.setFullName("Unsubmitted");
6  PicklistValue submitted = new PicklistValue();
7  submitted.setFullName("Submitted");
8  PicklistValue approved = new PicklistValue();
9  approved.setFullName("Approved");
10  PicklistValue rejected = new PicklistValue();
11  rejected.setFullName("Rejected");
12  expenseStatus.setPicklistValues(new PicklistValue[]
13      {unsubmitted, submitted, approved, rejected});
14  
15  CustomField expenseStatusField = new CustomField();
16  expenseStatusField.setFullName(
17      "ExpenseReport__c.ExpenseStatus__c");
18  expenseStatusField.setLabel("Expense Report Status");
19  expenseStatusField.setType(FieldType.Picklist);
20  expenseStatusField.setPicklist(expenseStatus);
21  try {
22    AsyncResult[] ars =
23    metadataConnection.create(new Metadata[] {expenseStatusField});
24  } catch (ConnectionException ce) {
25    ce.printStackTrace();
26  }
27}

宣言的なメタデータの定義のサンプル

次のサンプルでは、カスタムオブジェクトの連動選択リストを含む選択リストの使用例を示します。isAmerican__c チェックボックスでは manufacturer__c 選択リストに表示されるメーカーのリストを制御します。また、manufacturer__c チェックボックスでは model__c 選択リストに表示されるモデルのリストを制御します。

1<?xml version="1.0" encoding="UTF-8"?>
2<CustomObject xmlns="http://soap.sforce.com/2006/04/metadata">
3    <deploymentStatus>Deployed</deploymentStatus>
4    <enableActivities>true</enableActivities>
5    <fields>
6        <fullName>isAmerican__c</fullName>
7        <defaultValue>false</defaultValue>
8        <label>American Only</label>
9        <type>Checkbox</type>
10    </fields>
11    <fields>
12        <fullName>manufacturer__c</fullName>
13        <label>Manufacturer</label>
14        <picklist>
15            <controllingField>isAmerican__c</controllingField>
16            <picklistValues>
17                <fullName>Chrysler</fullName>
18                <controllingFieldValues>checked</controllingFieldValues>
19                <default>false</default>
20            </picklistValues>
21            <picklistValues>
22                <fullName>Ford</fullName>
23                <controllingFieldValues>checked</controllingFieldValues>
24                <default>false</default>
25            </picklistValues>
26            <picklistValues>
27                <fullName>Honda</fullName>
28                <controllingFieldValues>unchecked</controllingFieldValues>
29                <default>false</default>
30            </picklistValues>
31            <picklistValues>
32                <fullName>Toyota</fullName>
33                <controllingFieldValues>unchecked</controllingFieldValues>
34                <default>false</default>
35            </picklistValues>
36            <sorted>false</sorted>
37        </picklist>
38        <type>Picklist</type>
39    </fields>
40    <fields>
41        <fullName>model__c</fullName>
42        <label>Model</label>
43        <picklist>
44            <controllingField>manufacturer__c</controllingField>
45            <picklistValues>
46                <fullName>Mustang</fullName>
47                <controllingFieldValues>Ford</controllingFieldValues>
48                <default>false</default>
49            </picklistValues>
50            <picklistValues>
51                <fullName>Taurus</fullName>
52                <controllingFieldValues>Ford</controllingFieldValues>
53                <default>false</default>
54            </picklistValues>
55            <picklistValues>
56                <fullName>PT Cruiser</fullName>
57                <controllingFieldValues>Chrysler</controllingFieldValues>
58                <default>false</default>
59            </picklistValues>
60            <picklistValues>
61                <fullName>Pacifica</fullName>
62                <controllingFieldValues>Chrysler</controllingFieldValues>
63                <default>false</default>
64            </picklistValues>
65            <picklistValues>
66                <fullName>Accord</fullName>
67                <controllingFieldValues>Honda</controllingFieldValues>
68                <default>false</default>
69            </picklistValues>
70            <picklistValues>
71                <fullName>Civic</fullName>
72                <controllingFieldValues>Honda</controllingFieldValues>
73                <default>false</default>
74            </picklistValues>
75            <picklistValues>
76                <fullName>Prius</fullName>
77                <controllingFieldValues>Toyota</controllingFieldValues>
78                <default>false</default>
79            </picklistValues>
80            <picklistValues>
81                <fullName>Camry</fullName>
82                <controllingFieldValues>Toyota</controllingFieldValues>
83                <default>false</default>
84            </picklistValues>
85            <sorted>false</sorted>
86        </picklist>
87        <type>Picklist</type>
88    </fields>
89....
90</CustomObject>

次のサンプルでは、商談の標準項目の Stage の使用例を示します。

1<?xml version="1.0" encoding="UTF-8"?>
2<CustomObject xmlns="http://soap.sforce.com/2006/04/metadata">
3    <fields>
4        <fullName>StageName</fullName>
5        <picklist>
6            <picklistValues>
7                <fullName>Prospecting</fullName>
8                <default>false</default>
9                <forecastCategory>Pipeline</forecastCategory>
10                <probability>10</probability>
11            </picklistValues>
12            <picklistValues>
13                <fullName>Qualification</fullName>
14                <default>false</default>
15                <forecastCategory>Pipeline</forecastCategory>
16                <probability>10</probability>
17            </picklistValues>
18            <picklistValues>
19                <fullName>Needs Analysis</fullName>
20                <default>false</default>
21                <forecastCategory>Pipeline</forecastCategory>
22                <probability>20</probability>
23            </picklistValues>
24            ...
25        </picklist>
26    </fields>
27<CustomObject>

メタデータ API 開発者ガイド