メタデータ API 開発者ガイド
jカスタムメタデータ型 (CustomObject)
詳細は、『Custom Metadata Types Implementation Guide』を参照してください。
ファイルのサフィックスおよびディレクトリの場所
カス��ムメタデータ型は、カスタムオブジェクトとして定義され、オブジェクトフォルダに保存されます。カスタムメタデータ型のサフィックスには __mdt を使用します (カスタムオブジェクトの場合の __c の代わりに)。カスタムメタデータ型の項目名のサフィックスにはその他のカスタム項目と同様に __c を使用します。カスタムメタデータ型の項目名は、属するカスタムメタデータ型の名前を使用してドット修飾する必要があります。
カスタムメタデータ型の名前は、それらの名前空間内で一意である必要があります。すべてのカスタムメタデータ型は、CustomMetadata 名前空間に属しており、必要に応じて 2 番目の名前空間に属することができます。組織では、各自の名前空間や他の組織の名前空間が含まれるカスタムメタデータ型を使用できます。
バージョン
カスタムメタデータ型のコンポーネントは、API バージョン 31.0 以降で使用できます。
特別なアクセスルール
カスタムメタデータ型を作成するには、「Apex 開発」権限が必要です。管理パッケージ開発者のみが、管理パッケージのカスタムメタデータ型に新しい項目を追加できます。管理カスタムメタデータ型をインストールするユーザは、新しいカスタム項目を追加できません。
項目
カスタムメタデータ型には、次の CustomObject 項目を含めることができます。
カスタムメタデータ型の項目をインデックス付けができる一意の項目にするには、項目を Unique および ExternalId としてマークします。
| 項目名 | データ型 | 説明 |
|---|---|---|
| description | string | カスタムメタデータ型の説明。この項目には、最大で 1,000 文字を含めることができます。 |
| fields | CustomField[] | カスタムメタデータ型の 1 つ以上のカスタム項目を表します。 |
| gender | Gender | オブジェクトを表す名詞の性別を示します。この項目は、語の性別に基づいて、異なる処理が必要となる言語に使用されます。 |
| label | string | Salesforce の [設定] ユーザインターフェース全体でオブジェクトを表す表示ラベル。カスタムメタデータ型は、Force.com ホームページおよびパッケージ化のユーザインターフェースの、最近使用したオブジェクトのリストにのみ表示されます。 |
| pluralLabel | string | 表示ラベル値の複数形。 |
| startsWith | StartsWith (string 型の列挙) | 名詞が母音、子音、または特殊文字で開始されているかを示します。この項目は、語の最初の文字に基づいて、異なる処理が必要となる言語に使用されます。 |
| visibility | SetupObjectVisibility (string 型の列挙) | この項目が存在する場合、このコンポーネントはカスタムオブジェクトではなくカスタム設定またはカスタムメタデータ型です。この項目はカスタム設定またはカスタムメタデータ型の表示設定を返します。有効な値は次のとおりです。
デフォルト値は、Public です。 |
宣言的なメタデータの定義のサンプル
サンプルアプリケーションは、2 つの架空の組織の協力に基づいています。Picklists R Us は、Salesforce1 Platform 向けに、選択リストに関連する機能を備えた再利用可能な拡張機能を開発しています。TravelApp, Inc. は、Picklists R Us 製の選択リスト機能を採用した宇宙旅行アプリケーションを開発しています。Galactic Tours は、これらの組織の顧客です。Galactic Tours ではその組織に、Picklists R Us のパッケージと TravelApp, Inc. の拡張をインストールします。
この例では、Picklists R Us は、オブジェクトフォルダに ReusablePicklistOption__mdt.object という名前のファイルとこれらのコンテンツをリリースして、Reusable Picklist カスタムメタデータ型を作成します。