CustomObject
カスタムオブジェクトを作成または更新するときには関連するすべての項目を指定する必要があります。オブジェクトの単一の項目を更新することはできません。カスタムオブジェクトの詳細は、Salesforce ヘルプの「組織固有の情報の保存」を参照してください。
また、このメタデータ型を使用して、取引先などの標準オブジェクトのカスタマイズを行うこともできます。例については、『メタデータ API 開発者ガイド』の「package.xml マニフェストファイルのサンプル」に記載されている、標準オブジェクトに関するセクションを参照してください。
すべてのメタデータコンポーネントには fullName 項目があり、すべてのカスタムオブジェクトで完全に指定されている必要があります。
たとえば、標準オブジェクトおよびカスタムオブジェクトの完全に指定された名前はそれぞれ次のようになります。
1Account
2MyCustomObject__c外部オブジェクトの完全に指定された名前は次のようになります。
1MyExternalObject__xカスタムオブジェクトを作成する Java のサンプルコードについては、「ステップ 3: Java サンプルコードの説明」を参照してください。
宣言的なメタデータファイルのサフィックスおよびディレクトリの場所
カスタムオブジェクト名には、自動的に __c が追加されます。カスタムオブジェクトまたは標準オブジェクトファイルのファイルサフィックスは .object です。
外部オブジェクト名には、自動的に __x が追加されます。外部オブジェクトファイルのファイルサフィックスは、.object です。
カスタムオブジェクト、標準オブジェクト、および外部オブジェクトは、対応するパッケージディレクトリの objects フォルダに保存されます。
バージョン
カスタムオブジェクトは API バージョン 10.0 以降で使用できます。外部オブジェクトは API バージョン 32.0 以降で使用できます。
項目
別途記載がない限り、すべての項目は作成可能、除外可能で、null にすることもできます。
| 項目名 | 項目の型 | 説明 |
|---|---|---|
| actionOverrides | ActionOverride[] |
オブジェクトの override アクションのリスト。 この項目は、API バージョン 18.0 以降で使用できます。 |
| allowInChatterGroups | boolean |
このカスタムオブジェクト種別のレコードを Chatter グループに追加できるかどうかを示します。 この項目は、API バージョン 34.0 以降で使用できます。 |
| businessProcesses | BusinessProcess[] |
オブジェクトに関連付けられたビジネスプロセスのリスト。 この項目は、API バージョン 17.0 以降で使用できます。 |
| compactLayoutAssignment | string |
オブジェクトに割り当てられたコンパクトレイアウト。 この項目は、API バージョン 29.0 以降で使用できます。この項目は API バージョン 42.0 以降の外部オブジェクトで使用できます。 |
| compactLayouts | CompactLayout[] |
オブジェクトに関連付けられたコンパクトレイアウトのリスト。 この項目は、API バージョン 29.0 以降で使用できます。この項目は API バージョン 42.0 以降の外部オブジェクトで使用できます。 |
| customHelp | string | オブジェクトのヘルプコンテンツがカスタマイズされている場合に、ヘルプコンテンツが含まれる Sコントロール。この項目は、API バージョン 14.0 以降で使用できます。 |
| customHelpPage | string | オブジェクトのヘルプコンテンツがカスタマイズされている場合に、ヘルプコンテンツが含まれる Visualforce ページ。この項目は、API バージョン 16.0 以降で使用できます。 |
| customSettingsType | CustomSettingsType (string 型の列挙) |
この項目が存在する場合、このコンポーネントはカスタムオブジェクトではなくカスタム設定です。この項目はカスタム設定の型を返します。有効な文字列値は次のとおりです。
この項目は、API バージョン 17.0 以降で使用できます。 |
| customSettingsVisibility | CustomSettingsVisibility (string 型の列挙) |
この項目が存在する場合、このコンポーネントはカスタムオブジェクトではなくカスタム設定です。この項目はカスタム設定の表示を返します。有効な文字列値は次のとおりです。
この項目は、API バージョン 17.0 から 33.0 で使用できます。バージョン 34.0 以降では、この項目の代わりに visibility 項目を使用します。 |
| dataStewardGroup | string | API バージョン 47.0 で削除されました。 |
| dataStewardUser | string | API バージョン 47.0 で削除されました。 |
| deploymentStatus | DeploymentStatus (string 型の列挙) | オブジェクトのリリース状況を示します。 |
| deprecated | boolean | 将来の使用のために予約されています。 |
| description | string | オブジェクトの説明。最大 1000 文字です。 |
| enableActivities | boolean | 活動のオブジェクトが有効になっているか (true)、否か (false) を示します。 外部オブジェクトでは使用できません。 |
| enableBulkApi | boolean |
有効な場合、オブジェクトは、利用状況の追跡のための Enterprise Application オブジェクトとして分類されます。 有効な場合、enableSharing および enableStreamingApi も有効にする必要があります。 この項目は、API バージョン 31.0 以降で使用できます。 |
| enableDivisions | boolean | ディビジョンのオブジェクトが有効になっているか (true)、否か (false) を示します。『Salesforce オブジェクトリファレンス』の「ディビジョン」を参照してください。. |
| enableEnhancedLookup | boolean | 高度なルックアップのオブジェクトが有効になっているか (true)、否か (false) を示します。API バージョン 28.0 以降では、この項目を Account、Contact、および User オブジェクトにも使用できます。高度なルックアップにより、ルックアップダイアログインターフェースが更新され、検索結果の絞り込み、並び替え、およびページ操作と検索結果列のカスタマイズが可能になります。高度なルックアップについての詳細は、Salesforce ヘルプの「高度なルックアップの有効化」を参照してください。 |
| enableFeeds | boolean |
フィード追跡のオブジェクトが有効になっているか (true)、否か (false) を示します。詳細は、Salesforce ヘルプの「Chatter フィード追跡のカスタマイズ」を参照してください。 この項目は、API バージョン 18.0 以降で使用できます。 |
| enableHistory | boolean | 履歴追跡のオブジェクトが有効になっているか (true)、否か (false) を示します。API バージョン 29.0 以降では標準オブジェクトにも使用できます。取引先オブジェクトの履歴追跡には、個人取引先の履歴追跡が含まれます。 |
| enableLicensing | boolean | このオブジェクトが Salesforce によってライセンスされており、ユーザに権限セットライセンスが必要か (true)、否か (false) を示します。この項目は、API バージョン 45.0 以降で使用できます。 |
| enableReports | boolean | レポートのオブジェクトが有効になっているか (true)、否か (false) を示します。外部オブジェクトは、API バージョン 38.0 以降でサポートされています。 |
| enableSearch | boolean | オブジェクトのレコードが SOSL 検索および Salesforce 検索で検索可能かどうかを示します。ユーザインターフェースの [検索を許可] に対応します。 デフォルトで、新しいカスタムオブジェクトの検索は無効になっています。この項目は API バージョン 35.0 以降のカスタムオブジェクトで使用できます。 デフォルトでは、新規外部オブジェクトの検索は無効になっています。ただし、外部データソースを検証して同期し、自動的に外部オブジェクトを作成することができます。外部データソースの検索が有効になっていると、同期によって常に外部オブジェクトの検索が有効になります (その逆もあります)。この項目は API バージョン 37.0 以降の外部オブジェクトで使用できます。 |
| enableSharing | boolean | 有効な場合、オブジェクトは、利用状況の追跡のための Enterprise Application オブジェクトとして分類されます。 有効な場合、enableBulkApi および enableStreamingApi も有効にする必要があります。 この項目は、API バージョン 31.0 以降で使用できます。 |
| enableStreamingApi | boolean | 有効な場合、オブジェクトは、利用状況の追跡のための Enterprise Application オブジェクトとして分類されます。 有効な場合、enableBulkApi および enableSharing も有効にする必要があります。 この項目は、API バージョン 31.0 以降で使用できます。 |
| eventType | PlatformEventType (string 型の列挙) |
この項目はプラットフォームイベントにのみ適用されます。イベント種別を示します。値は次のとおりです。
この項目は、API バージョン 41.0 以降で使用できます。 |
| externalDataSource | string |
必須で、外部オブジェクトでのみ使用可能です。外部オブジェクトのデータが保存される外部データソースの名前です。データソースは ExternalDataSource コンポーネントで表されます。 この項目は、API バージョン 32.0 以降で使用できます。 |
| externalName | string |
必須で、外部オブジェクトでのみ使用可能です。外部オブジェクトのデータが含まれる、外部データソース内のテーブルの名前です。 この項目は、API バージョン 32.0 以降で使用できます。 |
| externalRepository | string | Salesforce Connect の外部オブジェクトでのみ使用できます。ユーザインターフェースの [表示 URL の参照項目] に対応します。 外部オブジェクトの [表示 URL] 標準項目値は、外部システムから自動的に生成されます。たとえば、Salesforce Connect の OData 2.0 アダプタでは、OData プロデューサで定義された link href に基づいた値になります。デフォルト値は、同じ外部オブジェクトのカスタム項目の値で上書きできます。項目名を選択し、カスタム項目の値が有効な URL であることを確認します。 この項目は、API バージョン 32.0 以降で使用できます。 |
| externalSharingModel | SharingModel (string 型の列挙) |
外部ユーザのアクセスレベルを決定する、オブジェクトの外部組織の共有設定を示します。 この項目は、API バージョン 31.0 以降で使用できます。 |
| fields | CustomField[] | オブジェクトの 1 つ以上の項目を表します。 |
| fieldSets | FieldSet | このオブジェクトに存在する項目セットを定義します。 |
| fullName | string |
Metadata から継承されるこの項目は、このメタデータ型の WSDL で定義されます。作成時、更新時、または削除時に指定する必要があります。コールにおけるこの項目の例を確認するには、「createMetadata()」を参照してください。 この値は null にできません。 |
| gender | Gender | オブジェクトを表す名詞の性別を示します。これは、語の性別に基づいて、異なる処理が必要となる言語に使用されます。 |
| household | boolean | この項目は、Salesforce for Wealth Management でのみ使用できるリレーショングループという機能をサポートします。詳細は、Salesforce ヘルプの「Salesforce for Wealth Management」を参照してください。 |
| historyRetentionPolicy | HistoryRetentionPolicy | 将来の使用のために予約されています。 |
| indexes | Index[] | カスタム Big Object のインデックスを定義します。 |
| label | string | Salesforce ユーザインターフェース全体でオブジェクトを表す表示ラベル。 オブジェクトの表示ラベルは、組織の標準オブジェクト、カスタムオブジェクト、外部オブジェクト全体で一意にすることをお勧めします。 |
| listViews | ListView[] | オブジェクトに関連付けられた 1 つ以上のリストビューを表します。 |
| namedFilter | NamedFilter[] | ルックアップ検索条件に関連付けられたメタデータを表します。ルックアップ検索条件の定義を作成、更新、または削除するには、このメタデータ型を使用します。このコンポーネントは API バージョン 30.0 で削除されました。それより前の API バージョンでのみ使用できます。ルックアップ検索条件に関連付けられたメタデータは、CustomField コンポーネントの lookupFilter 項目によって表されるようになりました。 この項目は、API バージョン 17.0 以降で使用できます。 この項目は API バージョン 30.0 で削除されました。それより前のバージョンでのみ使用できます。ルックアップ検索条件に関連付けられたメタデータは、CustomField コンポーネントの lookupFilter 項目によって表されるようになりました。 |
| nameField | CustomField | カスタムオブジェクトの場合、必須です。外部オブジェクトの場合、代わりに、CustomField コンポーネントの isNameField を true に設定することで名前項目を指定できます。 このオブジェクトの名前が保存されている項目。すべてのカスタムオブジェクトには名前が必要です。この名前は、通常文字列型または自動採番型です。 カスタムオブジェクトのレコードに付けられる識別子。この名前は、ページレイアウト、関連リスト、ルックアップダイアログ、検索結果、およびタブホームページの主要リストに表示されます。デフォルトでは、カスタムオブジェクトのページレイアウトに必須項目としてこの項目が追加されます。 |
| pluralLabel | string |
label 値の複数形です。 オブジェクト名をローカライズできるようにするには、カスタムオブジェクトに特定のバージョンの表示ラベルが必要です。 |
| profileSearchLayouts | ProfileSearchLayouts | オブジェクトのユーザプロファイルの検索結果レイアウトを表します。プロファイル固有のレイアウトを使用すると、ユーザプロファイルごとにオブジェクトの検索結果レイアウトを異なるものにできます。API バージョン 47.0 以降で利用できます。 |
| publishBehavior | PlatformEventPublishBehavior (string 型の列挙) | この項目はプラットフォームイベントにのみ適用されます。プラットフォームイベントメッセージが Lightning プラットフォームトランザクションでいつ公開されるかを示します。この項目は、Apex、プロセスビルダー、Flow Builder などの Lightning プラットフォーム (ただし Salesforce API は除く) で公開されたイベントメッセージに適用されます。有効な値は、次のとおりです。
この項目を指定しない場合、使用されるデフォルト値は PublishImmediately です。 この項目は、API バージョン 46.0 以降で使用できます。 |
| recordTypes | RecordType[] | このオブジェクトに定義された 1 つ以上のレコードタイプの配列。 |
| recordTypeTrackFeedHistory | boolean |
フィード追跡のレコードタイプが有効になっているか (true)、否か (false) を示します。この項目を true に設定するには、関連付けられた CustomObject の enableFeeds 項目も true に設定されている必要があります。詳細は、Salesforce ヘルプの「Chatter フィード追跡のカスタマイズ」を参照してください。 この項目は、API バージョン 19.0 以降で使用できます。 |
| recordTypeTrackHistory | boolean |
このレコードタイプの履歴追跡が有効になっているか (true)、否か (false) を示します。recordTypeTrackHistory を true に設定するには、関連付けられたカスタムオブジェクトの enableHistory 項目も true に設定されている必要があります。 この項目は、API バージョン 19.0 以降で使用できます。 |
| searchLayouts | SearchLayouts | オブジェクトの検索レイアウト関連リスト情報。 |
| sharingModel | SharingModel(enumeration of type string) | オブジェクトの組織の共有設定を示します。 |
| sharingReasons | SharingReason[] | オブジェクトが共有されている理由。 |
| sharingRecalculations | SharingRecalculation[] | オブジェクトに関連付けられたカスタム共有の再適用のリスト。 |
| startsWith | StartsWith (string 型の列挙) | 名詞が母音、子音、または特殊文字で開始されているかを示します。これは、語の最初の文字に基づいて、異なる処理が必要となる言語に使用されます。有効な値は、「StartsWith」にリストされています。 |
| validationRules | ValidationRule[] | オブジェクトの 1 つ以上の入力規則の配列。 |
| visibility | SetupObjectVisibility (string 型の列挙) | この項目は、カスタムオブジェクト、カスタム設定、またはカスタムメタデータ型の表示設定を返します。有効な値は次のとおりです。
デフォルト値は、Public です。 この項目は、API バージョン 34.0 以降で使用できます。カスタム設定の場合、customSettingsVisibility 項目の代わりにこの項目が使用されます。 |
| webLinks | WebLink[] | このオブジェクトに定義された 1 つ以上の Web リンクの配列。 |
MktDataModelAttributes
この種別は、CustomObject の Data Cloud サブタイプです。
| 項目名 | 項目の型 | 説明 |
|---|---|---|
| creationType | DefinitionCreationType | 省略可能。このオブジェクトが顧客によって追加されたのか、標準分類の一環として追加されたのか。 |
| dataModelTaxonomy | string | 省略可能。モデルが標準の Data Cloud モデルの場合は、このオブジェクトが開始されたデータモデルへの参照。現在、次の文字列のみがサポートされています。creationType が Standard の場合は Reference で、creationType が Custom の場合は View です。 |
| isEnabled | boolean | 省略可能。True は、データモデルオブジェクトが有効になっていることを示します。 |
| isSegmentable | boolean | 省略可能。True は、データモデルオブジェクトをセグメンテーションの対象として使用できることを示します。 |
| objectCategory | string | 必須。オブジェクトカテゴリへの参照。モデリングでは、この値は Profile、Engagement、Other になります。 |
| referenceEntityGroup | string | 省略可能。これが標準オブジェクトの場合は、参照モデルのオブジェクトのエンティティグループ。 |
| referenceEntityName | string | 省略可能。これが標準オブジェクトの場合は、参照モデルのオブジェクトの名前。 |
| referenceEntitySubjectArea | string | 省略可能。これが標準オブジェクトの場合は、参照モデルのオブジェクトの主題領域。 |
MktDataLakeAttributes
これは、CustomObject の Data Cloud サブタイプです。
| 項目名 | 項目の型 | 説明 |
|---|---|---|
| creationType | DefinitionCreationType | 省略可能。このオブジェクトが顧客によって追加されたのか、標準分類の一環として追加されたのか。 |
| isEnabled | boolean | 省略可能。True は、ランディングオブジェクトが有効になっていることを示します。 |
| objectCategory | string | 必須。オブジェクトカテゴリへの参照。ランディングでは、これらは Profile、Engagement、Other になります。 |
宣言的なメタデータのその他のコンポーネント
CustomObject の定義には、カスタムオブジェクトで宣言的なメタデータについて定義されているその他のコンポーネントを含めることができます。CustomObject に定義されているコンポーネントは、次のとおりです。
宣言的なメタデータの定義のサンプル
1<?xml version="1.0" encoding="UTF-8"?>
2<CustomObject xmlns="http://soap.sforce.com/2006/04/metadata">
3 <deploymentStatus>Deployed</deploymentStatus>
4 <description>test object with one field for eclipse ide testing</description>
5 <fields>
6 <fullName>Comments__c</fullName>
7 <description>add your comments about this object here</description>
8 <inlineHelpText>This field contains comments made about this object</inlineHelpText>
9 <label>Comments</label>
10 <length>32000</length>
11 <type>LongTextArea</type>
12 <visibleLines>30</visibleLines>
13 </fields>
14 <label>MyFirstObject</label>
15 <nameField>
16 <label>MyFirstObject Name</label>
17 <type>Text</type>
18 </nameField>
19 <pluralLabel>MyFirstObjects</pluralLabel>
20 <sharingModel>ReadWrite</sharingModel>
21</CustomObject>Salesforce Connect の外部オブジェクトのメタデータ定義を次に示します。
1<?xml version="1.0" encoding="UTF-8"?>
2<CustomObject xmlns="http://soap.sforce.com/2006/04/metadata">
3 <actionOverrides>
4 <actionName>CancelEdit</actionName>
5 <type>Default</type>
6 </actionOverrides>
7 <actionOverrides>
8 <actionName>Delete</actionName>
9 <type>Default</type>
10 </actionOverrides>
11 <actionOverrides>
12 <actionName>Edit</actionName>
13 <type>Default</type>
14 </actionOverrides>
15 <actionOverrides>
16 <actionName>Follow</actionName>
17 <type>Default</type>
18 </actionOverrides>
19 <actionOverrides>
20 <actionName>List</actionName>
21 <type>Default</type>
22 </actionOverrides>
23 <actionOverrides>
24 <actionName>New</actionName>
25 <type>Default</type>
26 </actionOverrides>
27 <actionOverrides>
28 <actionName>SaveEdit</actionName>
29 <type>Default</type>
30 </actionOverrides>
31 <actionOverrides>
32 <actionName>Tab</actionName>
33 <type>Default</type>
34 </actionOverrides>
35 <actionOverrides>
36 <actionName>View</actionName>
37 <type>Default</type>
38 </actionOverrides>
39 <deploymentStatus>InDevelopment</deploymentStatus>
40 <description>Products</description>
41 <enableFeeds>false</enableFeeds>
42 <externalDataSource>OData</externalDataSource>
43 <externalIndexAvailable>false</externalIndexAvailable>
44 <externalName>Products</externalName>
45 <fields>
46 <fullName>DiscontinuedDate__c</fullName>
47 <description>DiscontinuedDate</description>
48 <externalDeveloperName>DiscontinuedDate</externalDeveloperName>
49 <externalId>false</externalId>
50 <isFilteringDisabled>false</isFilteringDisabled>
51 <isNameField>false</isNameField>
52 <isSortingDisabled>false</isSortingDisabled>
53 <label>DiscontinuedDate</label>
54 <required>false</required>
55 <type>DateTime</type>
56 </fields>
57 <fields>
58 <fullName>ID__c</fullName>
59 <description>ID</description>
60 <externalDeveloperName>ID</externalDeveloperName>
61 <externalId>false</externalId>
62 <isFilteringDisabled>false</isFilteringDisabled>
63 <isNameField>false</isNameField>
64 <isSortingDisabled>false</isSortingDisabled>
65 <label>ID</label>
66 <precision>18</precision>
67 <required>false</required>
68 <scale>0</scale>
69 <type>Number</type>
70 <unique>false</unique>
71 </fields>
72 <fields>
73 <fullName>Name__c</fullName>
74 <description>Name</description>
75 <externalDeveloperName>Name</externalDeveloperName>
76 <externalId>false</externalId>
77 <isFilteringDisabled>false</isFilteringDisabled>
78 <isNameField>false</isNameField>
79 <isSortingDisabled>false</isSortingDisabled>
80 <label>Name</label>
81 <length>128</length>
82 <required>false</required>
83 <type>Text</type>
84 <unique>false</unique>
85 </fields>
86 <fields>
87 <fullName>Price__c</fullName>
88 <description>Price</description>
89 <externalDeveloperName>Price</externalDeveloperName>
90 <externalId>false</externalId>
91 <isFilteringDisabled>false</isFilteringDisabled>
92 <isNameField>false</isNameField>
93 <isSortingDisabled>false</isSortingDisabled>
94 <label>Price</label>
95 <precision>16</precision>
96 <required>false</required>
97 <scale>2</scale>
98 <type>Number</type>
99 <unique>false</unique>
100 </fields>
101 <fields>
102 <fullName>Products__c</fullName>
103 <externalDeveloperName>Products</externalDeveloperName>
104 <externalId>false</externalId>
105 <isFilteringDisabled>false</isFilteringDisabled>
106 <isNameField>false</isNameField>
107 <isSortingDisabled>false</isSortingDisabled>
108 <label>Products</label>
109 <length>20</length>
110 <referenceTo>Products__x</referenceTo>
111 <relationshipLabel>Products</relationshipLabel>
112 <relationshipName>Products</relationshipName>
113 <type>ExternalLookup</type>
114 </fields>
115 <fields>
116 <fullName>Rating__c</fullName>
117 <description>Rating</description>
118 <externalDeveloperName>Rating</externalDeveloperName>
119 <externalId>false</externalId>
120 <isFilteringDisabled>false</isFilteringDisabled>
121 <isNameField>false</isNameField>
122 <isSortingDisabled>false</isSortingDisabled>
123 <label>Rating</label>
124 <precision>18</precision>
125 <required>false</required>
126 <scale>0</scale>
127 <type>Number</type>
128 <unique>false</unique>
129 </fields>
130 <fields>
131 <fullName>ReleaseDate__c</fullName>
132 <description>ReleaseDate</description>
133 <externalDeveloperName>ReleaseDate</externalDeveloperName>
134 <externalId>false</externalId>
135 <isFilteringDisabled>false</isFilteringDisabled>
136 <isNameField>false</isNameField>
137 <isSortingDisabled>false</isSortingDisabled>
138 <label>ReleaseDate</label>
139 <required>false</required>
140 <type>DateTime</type>
141 </fields>
142 <label>Products</label>
143 <pluralLabel>Products</pluralLabel>
144 <searchLayouts>
145 <customTabListAdditionalFields>ExternalId</customTabListAdditionalFields>
146 <lookupDialogsAdditionalFields>ExternalId</lookupDialogsAdditionalFields>
147 <lookupPhoneDialogsAdditionalFields>ExternalId</lookupPhoneDialogsAdditionalFields>
148 <searchResultsAdditionalFields>ExternalId</searchResultsAdditionalFields>
149 <searchResultsAdditionalFields>DisplayUrl</searchResultsAdditionalFields>
150 <searchResultsAdditionalFields>ID__c</searchResultsAdditionalFields>
151 </searchLayouts>
152</CustomObject>マニフェストファイル内のワイルドカードのサポート
このメタデータ型では、package.xml マニフェストファイル内のワイルドカード文字 * (アスタリスク) は、項目セットとレコードタイプではサポートされますが、他のコンポーネントではサポートされません。マニフェストファイルの使用についての詳細は、「zip ファイルを使用したメタデータのリリースと取得」を参照してください。