MetadataPackageVersion | Salesforce および Force.com のオブジェクトリファレンス

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

describeSObjects()、query()、retrieve()

項目

項目名	詳細
BuildNumber	型 int プロパティ Filter、Group、Nillable、Sort 説明バージョンのビルド番号。たとえば、2 つのベータバージョンをアップロードすると、ビルド番号は 1 と 2 になります。その後、ベータではないバージョンをアップロードすると、ビルド番号は 3 になります。新しいバージョンをアップロードすると、ビルド番号は 1 にリセットされます。
MajorVersion	型 int プロパティ Filter、Group、Nillable、Sort 説明パッケージバージョン番号の最初の番号。バージョン番号は、`x.y` 形式または `x.y.z` 形式です。`x` はメジャーバージョンを、`y` はマイナーバージョンを、`z` はパッチバージョンを表します。
MetadataPackageId	型 reference プロパティ Filter、Group、Nillable、Sort 説明 `033` から始まる 18 文字のパッケージ ID。
MinorVersion	型 int プロパティ Filter、Group、Nillable、Sort 説明パッケージバージョン番号の 2 番目の番号。バージョン番号は、`x.y` 形式または `x.y.z` 形式です。`x` はメジャーバージョンを、`y` はマイナーバージョンを、`z` はパッチバージョンを表します。
Name	型 string プロパティ Filter、Group、idLookup、Sort 説明パッケージバージョンの名前。
PatchVersion	型 int プロパティ Filter、Group、Nillable、Sort 説明パッケージバージョン番号の 3 番目の番号 (存在する場合)。バージョン番号は、`x.y` 形式または `x.y.z` 形式です。`x` はメジャーバージョンを、`y` はマイナーバージョンを、`z` はパッチバージョンを表します。
ReleaseState	型 picklist プロパティ Filter、Group、Nillable、Restricted picklist、Sort 説明パッケージバージョンがベータバージョンの場合、値は `Beta` になります。それ以外の場合、値は `Released` です。

使用方法

次に、実行できる API クエリの種別の例を示します。

クエリ	文字列
MetadataPackageID が 033D00000001xQlIAI のパッケージのすべてのパッケージバージョンを取得する	`SELECT Id, Name, ReleaseState, MajorVersion, MinorVersion, PatchVersion FROM MetadataPackageVersion WHERE MetadataPackageId = '033D00000001xQlIAI'`
特定の MetadataPackageID を持ち、メジャーバージョンが 1 より大きいパッケージのパッケージバージョンを取得する	`SELECT Id FROM MetadataPackageVersion WHERE MetadataPackageId ='033D00000001xQlIAI' AND MajorVersion > 1`
特定のMetadataPackageID を持つパッケージのリリース済みパッケージバージョンを取得する	`SELECT Id FROM MetadataPackageVersion WHERE MetadataPackageId = '033D00000001xQlIAI' AND ReleaseState = 'Released'`

Java コードサンプル

パッケージのバージョン 3.4.6 をすべての組織に転送するとします。アップグレードの対象となる組織を識別するコードを記述しましょう。この例は、MetadataPackageId が packageId と等しい MetadataPackageVersion に対する PackageSubscriber オブジェクトのリストを生成する方法を示しています。

このサンプルコードでは、Force.com Web Services Connector (WSC) を使用しています。

1// Finds all Active subscriber orgs that have the package installed
2String PACKAGE_SUBSCRIBER_ORG_KEY_QUERY = "Select OrgKey from PackageSubscribers where OrgStatus = 'Active' and InstalledStatus = 'I'";
3
4// Finds all MetadataPackageVersions lower than the version given, including the list 
5// of subscribers for each version
6String METADATA_PACKAGE_VERSION_QUERY = "Select Id, Name, ReleaseState, (%s) from"
7	+ " AND (MajorVersion < 3 OR (MajorVersion = 3 and MinorVersion < 4)"
8	+ " OR (MajorVersion = 3 and MinorVersion = 4 and PatchVersion < 6))";
9
10// conn is an EnterpriseConnection instance initialized with a ConnectionConfig object
11// representing a connection to the developer org of the package
12QueryResult results = conn.query(String.format(METADATA_PACKAGE_VERSION_QUERY, PACKAGE_SUBSCRIBER_ORG_KEY_QUERY, packageId));
13
14// This list will hold all of the PackageSubscriber objects that are eligible for upgrade
15// to the given version
16List<PackageSubscriber> subscribers = new ArrayList<>();
17for (SObject mpvso : results.getRecords()) {
18
19		// Cast the sObject to a MetadataPackageVersion
20		MetadataPackageVersion mpv = (MetadataPackageVersion) mpvso;
21
22		// Add subscribers to our list
23		if (mpv.getPackageSubscribers() != null) {
24			for (SObject psso : mpv.getPackageSubscribers().getRecords()) {
25				subscribers.add((PackageSubscriber) psso);
26			}
27	}
28}

次のステップ

PackagePushRequest を使用して転送要求を作成します。