SOAP API 開発者ガイド
jPackageVersionHeader
インストールされた管理パッケージのパッケージバージョンを指定します。パッケージバージョンは、パッケージでアップロードされる一連のコンポーネントを特定する番号です。バージョン番号の形式は majorNumber.minorNumber.patchNumber (例: 2.1.3) です。メジャー番号とマイナー番号は、毎回のメジャーリリース時に指定した値に増えます。patchNumber は、パッチリリースにのみ生成および更新されます。一連のコンポーネントのほか、パッケージバージョンには特定の動作が含まれています。公開者は、パッケージバージョンを使用して後続のパッケージバージョンをリリースすることにより、管理パッケージのコンポーネントを適切にアップグレードできます。そのパッケージを使用する既存の顧客のインテグレーションに影響を与えることもありません。
管理パッケージには、異なる内容および動作のさまざまなバージョンを指定できます。このヘッダーを使用して、API クライアントに参照される各パッケージに使用されるバージョンを指定できます。パッケージのバージョンが指定されていない場合、API クライアントは [設定] の の [バージョン設定] セクションで選択されているパッケージのバージョンを使用します。このヘッダーは、API バージョン 16.0 以降で使用できます。
関連する API コール
convertLead()、create()、delete()、describeGlobal()、describeLayout()、describeSObject()、describeSObjects()、describeSoftphoneLayout()、describeTabs()、merge()、process()、query()、retrieve()、search()、undelete()、update()、upsert()
サンプルコード —Java
このサンプルでは、PackageVersionHeader を使用して 1 つのインストール済みパッケージのパッケージバージョンを設定します。次に、executeAnonymous Apex メソッドを使用してこのメソッドに渡されるコードを実行します。
1swfobject.registerObject("clippy.codeblock-0", "9");
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17public void PackageVersionHeaderSample(String code) throws Exception
18{
19 _PackageVersionHeader pvh = new _PackageVersionHeader();
20 PackageVersion pv = new PackageVersion();
21 pv.setNamespace("installedPackageNamespaceHere");
22 pv.setMajorNumber(1);
23 pv.setMinorNumber(0);
24 // In this case, we are only referencing one installed package.
25 PackageVersion[] pvs = new PackageVersion[]{pv};
26 pvh.setPackageVersions(pvs);
27
28 apexBinding.setHeader(new SforceServiceLocator().getServiceName().getNamespaceURI(),
29 "PackageVersionHeader", pvh);
30 // Execute the code passed into the method.
31 ExecuteAnonymousResult r = apexBinding.executeAnonymous(code);
32 if (r.isSuccess()) {
33 System.out.println("Code executed successfully");
34 }
35 else {
36 System.out.println("Exception message: " + r.getExceptionMessage());
37 System.out.println("Exception stack trace: " + r.getExceptionStackTrace());
38 }
39}