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

listMetadata()

このコールは組織のメタデータコンポーネントに関するプロパティ情報を取得します。queries パラメータで指定されている条件に一致したコンポーネントのデータが返されます。queries 配列には各コールに対する最大 3 つの ListMetadataQuery クエリを含めることができます。このコールは、CustomObject や ApexClass などの最上位の型、および CustomField や RecordType などの子の型の両方のすべてのメタデータ型をサポートします。

構文

使用方法

このコールは、retrieve() コールの package.xml の個々のコンポーネントを識別する場合、または組織の特定のメタデータ型の概要が必要な場合に役立ちます。たとえば、組織の CustomObject コンポーネントまたは Layout コンポーネントのすべての名前のリストが返されるようにこのコールを使用できます。さらに、この情報を使用して後続の retrieve() コールを実行し、これらのコンポーネントのサブセットが返されるようにすることができます。package.xml の使用についての詳細は、「メタデータのリリースと取得」を参照してください。

これは、結果が 1 つのコールで返される同期コールです。これは、結果を取得するために少なくとも 1 つの後続のコールが必要な retrieve() などの非同期コールと異なります。

メモ

権限

クライアントアプリケーションは、「すべてのデータの編集」権限でログインしている必要があります。

サンプルコード —Java

以下のサンプルコードでは、カスタムオブジェクトの情報を表示します。このコードは、SOAP バインドがすでに確立されていることを前提としています。

引数

名前 説明
queries ListMetadataQuery[] 目的のコンポーネントを指定するオブジェクトのリスト。
asOfVersion double 要求のリストを表示するメタデータの API バージョン。この項目に値を指定しない場合、ログイン時に指定したデフォルトの API バージョンになります。この項目を使用してデフォルトを上書きし、他の API バージョンを設定できます。これにより、たとえば、ログイン時に指定した API バージョンより後のバージョンで追加されたメタデータ型のメタデータのリストを表示できます。この項目は、API バージョン 18.0 以降で使用できます。