Salesforce1 モバイルアプリケーション開発者ガイド
jsforce.one での API バージョンの処理方法
デフォルトで、sforce.one では要求された Visualforce ページの API バージョンと同じバージョンが使用されます。たとえば、Visualforce ページに API バージョン 30.0 がある場合、sforce.one を使用する同ページの JavaScript では、デフォルトで sforce.one の API バージョン 30.0 が使用されます。
つまり、Visualforce ページが新しい API バージョンに更新されると、このページでは sforce.one の更新されたバージョンが自動的に使用されます。上記の例では、この Visualforce ページが API バージョン 31.0 に更新されると、sforce.one を使用するアプリケーション機能では sforce.one の API バージョン 31.0 が使用されます。
- Visualforce ページの API バージョンを前のバージョンに戻します。この作業ではコード変更は不要です。
- ページの機能のコードを更新して問題を修正します。これが最善の解決法ですが、デバッグが必要な場合があり、確実にコード変更が必要になります。
- 特定のバージョンの sforce.one を使用します。この解決法では、最小限のコード変更が必要になることが多くあります。
特定のバージョンの sforce.one の使用
特定のバージョンの sforce.one を使用するには、sforce.one.getVersion() 関数を使用して、API バージョン、および特定のバージョンの sforce.one を使用する必要のあるコールバック関数を入力します。このコールによって、適切なバージョンの sforce.one が自動的に読み込まれます。
1sforce.one.getVersion(versionString, callbackFunction);versionString はアプリケーションで必須の API バージョンです。必ず 2 桁数字、ピリオド、1 桁数字になります (例、30.0)。無効なバージョン文字列を使用したコールは、エラーを表示することなく失敗します。
callbackFunction は、特定のバージョンの sforce.one を使用する JavaScript 関数です。sforce.one.getVersion() は非同期で実行され、要求されたバージョンの sforce.one の読み込みが完了すると、コールバック関数がコールされます。コールバック関数は、指定された API バージョンの sforce.one オブジェクトであるパラメータを 1 つ受け取ります。グローバル sforce.one の代わりに、渡されたオブジェクトを使用して、アプリケーションで必須の API バージョンに適合する sforce.one にコールを実行します。
特定のバージョンの sforce.one の使用例
1<input type="button" value="Create Account" onclick="btnCreateAccount()" id="btnCreateAcct"/>Visualforce ページの API バージョンへのデフォルト設定
1<script>
2
3 function MyApp() {
4
5 this.createAccount = function() {
6
7 sforce.one.navigateToURL("/001/e");
8
9 };
10
11 }
12
13
14
15 var app = new MyApp();
16
17
18
19 function btnCreateAccount() {
20
21 app.createAccount();
22
23 }
24
25</script>アプリケーション機能は MyApp オブジェクト内で作成され、イベント (ボタンのクリック) が発生すると、イベント処理関数によりアプリケーション関数がコールされます。ベストプラクティスでは、アプリケーションイベント処理からアプリケーション機能を分離することで、バージョン固有の sforce.one バージョンを使用するための設定が整います。
特定の sforce.one API バージョンの使用 (単純)
1<script>
2
3 function MyApp(sfone) {
4
5 this.createAccount = function() {
6
7 sfone.navigateToURL("/001/e");
8
9 };
10
11 }
12
13
14
15 var app30 = null;
16
17
18
19 function btnCreateAccount() {
20
21 // Create our app object if not already defined
22
23 if(!app30) {
24
25 // Create app object with versioned sforce.one
26
27 sforce.one.getVersion("30.0", function(sfoneV30) {
28
29 app30 = new MyApp(sfoneV30);
30
31 app30.createAccount();
32
33 });
34
35 return;
36
37 }
38
39 app30.createAccount();
40
41 }
42
43</script>上記の例では、イベント処理関数が 1 つ目の例から拡張され、sforce.one のバージョン固有インスタンスの作成が含まれています。アプリケーションで複数のバージョンを合わせて使用する必要がある場合は、適切なバージョンと名前で複数の MyApp インスタンスを作成できます。ただし、複数のバージョンを使用すると扱いにくくなります。代わりに、次のアプローチをお勧めします。
特定の sforce.one API バージョンの使用 (最善)
1<script>
2
3 function MyApp(sfone) {
4
5 this.createAccount = function() {
6
7 sfone.navigateToURL("/001/e");
8
9 };
10
11 }
12
13
14
15 var app30 = null;
16
17
18
19 // Initialize app: get versioned API, wire up clicks
20
21 sforce.one.getVersion("30.0", function(sfoneV30) {
22
23 // Create app object with versioned sforce.one
24
25 app30 = new MyApp(sfoneV30);
26
27
28
29 // Wire up button event
30
31 var btn = document.getElementById("btnCreateAcct");
32
33 btn.onclick = btnCreateAccount;
34
35 });
36
37
38
39 // Events handling functions
40
41 // Can't be fired until app is defined
42
43 function btnCreateAccount() {
44
45 app30.createAccount();
46
47 }
48
49</script>このサンプルでは、アプリケーション初期化が空白とコメントのみで分離されていますが、より適切にカプセル化するために関数単位に分離することができます。
特定の sforce.one API バージョンの使用 (同期)
1<script src="/sforce/one/30.0/api.js"></script>
2
3<script>
4
5 function MyApp(sfone) {
6
7 this.createAccount = function() {
8
9 sfone.navigateToURL("/001/e");
10
11 };
12
13 }
14
15
16
17 var app = null;
18
19
20
21 sforce.one.getVersion("30.0", function(sfoneV30) {
22
23 app = new MyApp(sfoneV30);
24
25 });
26
27
28
29 // Events handling function
30
31 // Can't be fired until app is defined
32
33 function btnCreateAccount() {
34
35 app.createAccount();
36
37 }
38
39</script>同期モードが必要な場合もありますが、非同期バージョンをお勧めします。sforce.one ライブラリの正しいバージョンを手動で含めるのを忘れると、診断の難しいバグがコードに含まれます。