TEST

1. 【A5】ノーツコソーシアムXPages研究会
中間成果発表（その１)
-初めてのXPagesではまった落とし穴とその解決方法-
2014/11/18
アクロス株式会社
矢森隆嗣
1

2. • このパートではXPages研究会の中で、
【Step1】まずは、失敗例、困ったこと事例を集めて・・・
2
で議論した中で特に関心が高かったもの、初心者が陥りやすいものを取りまとめて
みました。

3. 本パートのスピーカー
矢森隆嗣
3
アクロス株式会社

4. 本パートの目次
1.XPagesってこんなもの
2.初めてのXPages（困惑編）
4

5. 1.XPagesってこんなもの
XPagesDayをご参加の皆様!
こんなことは知ってらぁ！という声が聞こえてくる
のを承知で、おさらいします。
5

6. 1.XPagesってこんなもの
6
・Notes Domino8.5から提供されている、Domino上で動作する
Webアプリケーションを開発するための技術
・Webアプリケーションを構築のためさまざまなコントロールが提供され、
従来のフォーム・ビューなどによるノーツクライアントアプリケーションの構築に
近い感覚で開発が可能
・JavaScript、Cssのほか、JavaScriptを使用してノーツオブジェクトを操作を可
能とするServerSideJavaScript(SSJS)や@関数が使用できるので、
Lotus Scriptや式言語の知識がある方になじみやすい
・今までに蓄積されたノーツDBのデータをWeb上で利用するための1stチョイス

7. 2.初めてのXPages（困惑編）
最近でこそXPagesの開発も実績を積ませていただいておりますが、
初めてXPagesの開発に手を染めたころは・・・
これ、どうすればいいの？？？ (＠_＠;)
うまくいかない～！！（>_<）
の連続で試行錯誤や調査などずいぶん遠回りをしました。
7

8. 2.初めてのXPages（困惑編）
8
アクロス株式会社での経験をノーツコンソーシアムXPages研究会で
発表しましたところ・・・
「やっぱりみんなハマるんだねぇ・・・」
とうなずきが多かったものをピックアップ、XPages研究会メンバーの
ナレッジを追加してご紹介します。
XPagesを始める、始めたばかりの方へのちょっとしたHowToとして、
皆様の一助になれば幸いです。

9. 2.初めてのXPages（困惑編）
メニュー
1. 当然必要ですよね、JavaScript。
クライアントサイド（CSJS）とサーバーサイド（SSJS)ってどう違うの？使い分けは？
2. なんかエラーでた。デバッグってどうやろう。
3. 既存のフォームに仕込まれた＠式が使いたいんだけど。
4. 競合ってどう処理するの？
5. URLでファイルダウンロードリンクを貼りたい。
でもファイル形式によってダウンロードしたり、開いたり。ダウンロードしたいんだけど・・・
6. ロードバランサーなどで代表アドレスがあると・・・
9

10. 2.初めてのXPages（困惑編）
1.当然必要ですよね、JavaScript。
サーバーサイド（SSJS)とクライアントサイド（CSJS）ってどう違うの？使い分けは？
■SSJS：
サーバーにて処理される。
LS的にノーツオブジェクトが使えるので、文書とか他のDBとか参照するなどはこっち。
エラーチェックで使うときはユーザインターフェイスに注意。アラートぐらいはできるが、YES/NOなど返り
値が取れない。
■CSJS:
クライアントで処理される。レスポンスよく、サーバー負荷が低い。
でもSSJSでないとできないこともあり。
SSJSと混在してエラーチェックで使用するとCSJS→SSJSの順で処理される関係上、
画面上の並び順とエラーチェックの順序が異なりユーザの混乱を招く可能性も・・・
10

11. 2.初めてのXPages（困惑編）
2. なんかエラーでた。デバッグってどうやろう。
11
■CSJS：
・IEなりFirefox、Chromeなりの開発者ツールとか使えばデバッガーもある。

12. 2.初めてのXPages（困惑編）
2. なんかエラーでた。デバッグってどうやろう。（つづき）
■SSJS：
・ひとまずXspプロパティの「XPage実行時のエラーページを表示」をOnに。
詳細なエラーメッセージが表示されます。これは最低限！
12

13. 2.初めてのXPages（困惑編）
2. なんかエラーでた。デバッグってどうやろう。（つづき）
■SSJS：
13
・処理中の変数の確認などはview.postscript(“alert(…)”)で表示することにより可能。
サーバーコンソールが使えるならば、サーバーのnotes.iniに
“Debug_Console=1”を追加して_dumpでコンソールに出力して確認する方法も・・・
（サーバの負荷に注意！）

14. 2.初めてのXPages（困惑編）
2. なんかエラーでた。デバッグってどうやろう。（つづき）
■SSJS：（つづき）
・Domino9から搭載されたSSJSデバッガーを使用することも出来ます。
SSJSデバッガーは変数のほか、セッション変数などの参照も出来ます。
サーバNotes.iniに設定する必要があります。
注意事項：
(1)同一サーバー上で一人しかデバッガーは使用できない。
(2)サーバへの負荷が高い、かつデバッグしている際は他の
ユーザが利用できない。
＞運用サーバーで開発している場合、
または1サーバーを共有で開発している場合は
Designerのプレビューでも利用できる（はず）。
14

15. 2.初めてのXPages（困惑編）
3. 既存のフォームに仕込まれた＠関数が使いたいんだけど。
→データソースの「フォーム検証の実行」を設定すれば、
オープン時/保存時/両方のタイミングで＠関数が計算されます！
15

16. 2.初めてのXPages（困惑編）
4. 競合ってどう処理するの？
16
→ 「すべてのプロパティ」– 「データ」のconCurrencyMode のオプション設定に
より対応可能。
try - catch でトラップして、exceptionにて「もう一度修正してください」などの
メッセージで回避のほか、「先勝ち」、「後勝ち」、
および「競合文書を作成する」を設定可能。

17. 2.初めてのXPages（困惑編）
5. URLでファイルダウンロードリンクを貼りたい。
でもファイル形式によってダウンロードしたり、開いたり。
ダウンロードしたいんだけど・・・
→ XPages以前では以下の形式のURLでアクセスができました。
でも動作がファイルによって違う！
http://ホスト名/DBファイルパス/0/ドキュメントID/$FILE/ファイル名
XPagesなら以下のURLならファイルがダウンロードになります。
17
http://ホスト名/DBファイルパス/xsp/.ibmmodres/domino/OpenAttachment
/DBファイルパス/DocumentID/ファイルが添付されているフィールド名
/ファイル名

18. 2.初めてのXPages（困惑編）
6. ロードバランサーなどで代表アドレスがあると・・・
facesContextで今表示されているURLが取れない。
→CSJSで取得して、連携するとかちょっと工夫がいる。
18
context.redirectToPageにて相対パス指定でページ移動するとき、
そのイベントのサーバーオプションが「部分更新」だと代表アドレスでなくて
サーバー名に・・・「全体更新」にすると代表アドレスになる。

19. 3.続いて・・・
19