IBM Sametime 9 構成とアプリ開発 - テクてく Lotus 技術者夜会 年年 7 月 25 日 東京ソフトウェア開発研究所第 一 ECM 製品開発 小野充志 日本アイ ビー エム株式会社 ICS 事業部 ICS 第 一テクニカルセールス 別当類 2014 IBM Corp

Transcription

1 IBM Sametime 9 構成とアプリ開発 - テクてく Lotus 技術者夜会 年年 7 月 25 日 東京ソフトウェア開発研究所第 一 ECM 製品開発 小野充志 日本アイ ビー エム株式会社 ICS 事業部 ICS 第 一テクニカルセールス 別当類

2 ご説明順序 本 日ご紹介する開発のイメージ Sametime Proxy SDK を利利 用するための最 小構成 IBM Sametime のユーザー管理理の考え 方 IBM Sametime でアプリ開発! 2

3 本 日ご紹介する開発のイメージ 3

4 こんなことをやってみます Sametime Browser Client Toolkit を利利 用して 既存の Web アプリケーションに IBM Sametime の機能を統合してみます 画 面はイメージです

5 Sametime Proxy SDK を利利 用するための最 小構成 5

6 最低限必要となるもの 下記より抜粋 ( 基本的には Limited Use 版で inotes からチャット機能を利利 用する場合と同じ構成をとる )

7 構成概要 Domino Server チャット関連の接続 管理理 用の経路路 Web アプリケーション Sametime Community Server LDAP Server WAS 管理理者 Sametime Proxy Server Sametime System Console DB2 Web からチャット プレゼンスにアクセスする場合は Sametime Proxy サーバーを経由 サーバー管理理は SSC(Sametime System Console ) から 行行う ユーザー認証および ユーザーやグループの検索索は LDAP ディレクトリーを使 用

8 IBM Sametime の ユーザー管理理の考え 方 8

9 前提 IBM Sametime 9.0 より 導 入するコンポーネントにかかわらず Sametime System Console( 以後 SSC) サーバーの導 入が必須 認証 方法にかかわらず SSC からの管理理のために LDAP サーバーが必須 LDAP サーバーは Sametime Community サーバーと同居は不不可 Domino LDAP を利利 用し Domino ベースの Web サーバー ( IBM inotes サーバーなど ) を連携させる場合でも 同居は実環境では 非推奨

10 例例 :Xpages アプリと ST の機能を統合する場合の構成 Web Application Server(XPages) LDAP クライアント ( ブラウザアクセス ) Sametime Community Server Sametime System Console Sametime Proxy Server DB2 Server Web Application Server 上 Community Server 上の Domino ディレクトリは認証には使 用しない

11 参考資料料として IBM Notes/Domino 9.0 と IBM Sametime 9.0 チャット機能連携のポイント tech/2014_ nd9_ st9_ Integrateguide.html 11

12 IBM Sametime でアプリ開発! 12

13 IBM Sametime SDK とは? Sametime を拡張 連携するための開発ツールキット 主に以下の 3 つの機能を提供 Sametime サーバー の機能拡張 Sametime クライアント の機能拡張 他アプリケーション との連携 今回は Web アプリケーションとの連携にフォーカス!

14 IBM Sametime SDK を詳しく知りたい 方は? わかりやすい developerworks 記事があります! Lotus Sametime 8.5 の Web Browser Client lot- st85webbrowserclient/ 前回 (2014/5) のテクてく技術者編の資料料も参考になります まずはぜひご 一読を!

15 Web アプリケーションとの連携には 最新の Sametime Browser Client Toolkit がおすすめ Sametime Proxy SDK とも呼ばれます Sametime Proxy SDK

16 IBM Sametime SDK の 入 手 方法 IBM developerworks のダウンロードサイトから無料料で ダウンロード可能 ( 要 IBM ID)

17 IBM Sametime SDK のモジュール構成 各ツールキットごとにフォルダが分かれており それぞれのツールキットごとにドキュメントやサンプルを提供 Sametime Proxy SDK は st9sdk\client\stproxy フォルダ Sametime Proxy SDK

18 Sametime Proxy SDK のドキュメント Sametime Proxy SDK の doc フォルダ以下の PDF st9sdk\client\stproxy\doc\stbrowsersdk.pdf 120 ページあり 各 API の使い 方が詳細にまとめられている

19 Sametime Proxy SDK のサンプル Sametime Proxy SDK の samples フォルダ以下 サンプルは JSP だが JSP でなくても Proxy SDK は利利 用可能 文字列列中の < > で囲まれた箇所を書き換えて使 用 tunnel.html は API 使 用時に必要となるので コピーして再利利 用 <YourProxyServer> の部分を Sametime サーバーの ホスト名に書き換え

20 サンプル :example1 Sametime Web Client の既存のポップアップ画 面をそのまま別ウインドウで開くサンプル この 方式は SDK がなくてもすぐ使えます

21 サンプル :example2 UI ウィジェットを使ったサンプル sametime.livename ウィジェット

22 Sametime Proxy SDK のアーキテクチャ 3 層構造 カスタム Web アプリ UI UI ウィジェット (Dojo) 主に使うのはこの 2 つ VP (Virtual Place) ベース コンポーネント (JavaScript) REST API Sametime Proxy Server Sametime Community Server ブラウザ クライアント HTTP

23 UI ウィジェット 1 sametime.dock sametime.userinfo sametime.awareness sametime.businesscard sametime.buddylist sametime.livename sametime.quickfind sametime.livenamephoto

24 UI ウィジェット 2 sametime.webclient sametime.chat

25 Sametime Proxy SDK を使うには Sametime Proxy SDK を 自分のアプリケーションの中で 使 用するためのステップは以下の 2 つ 1. お決まりのスクリプトを HTML 内に組み込む 使 用する Sametime Proxy サーバーなどの設定 Dojo Toolkit および Sametime Proxy SDK のライブラリのロード ログイン処理理のコーディング 2. あとは API を使って 自由にコーディング! UI ウィジェットを使う? UI ウィジェットは使わずにベース コンポーネントだけ使う?

26 お決まりのスクリプト これをテンプレートとして 必要な部分だけ適宜修正して 自分のアプリケーションの HTML の header に追加すれば OK!

27 スクリプトの解説 1: 設定部分 各種設定値を定義する部分 stproxyconfig:sametime Proxy SDK ライブラリのための設定 server:sametime 9.0 Proxy サーバーのアドレス tunneluri:openajaxhub がクロスドメインリクエスト送信に使う tunnel.html ファイルの URL isconnectclient:sametime Connect Web API でリクエストを投げているかどうか ( 今回は使っていないので false) djconfig:dojo Toolkit のための設定 parseonload: UI ウィジェットを Declarative 方式で使うときは true

28 ( 補 足 ) tunnel.html の役割 ブラウザの same- origin ポリシー により 通常はクロスドメインのリクエストを投げることができないので それを回避するため仕組み Web アプリと同じサーバーにデプロイしておく必要あり tektek.lotus.com greenhouse.lotus.com VP (Virtual Place) Web アプリ tunnel.html HTTP Sametime Proxy Server Sametime Community Server ブラウザ 参考 :OpenAjax Hub

29 スクリプトの解説 2: ライブラリのロード部分 JavaScript ライブラリをロード Dojo Toolkit Sametime Web Client が使っている Dojo を利利 用する場合は以下の URL でロード http(s)://<st9proxy>/stwebclient/latest/dojo.blue/dojo/dojo.js 自分のアプリケーションですでに Dojo をロードしている場合は不不要 XPages などの場合はこちらに相当 ( 詳細は後述 ) Sametime Proxy SDK の JavaScript ライブラリ ライブラリの URL は以下 http(s)://<st9proxy>/stwebclient/latest/include.js 後ろの以下のパラメータを指定可能 widget: どの UI ウィジェットを読み込むかを指定 ( 詳細は次ページ ) auto:dock ウィジェットを初期化時に 自動でロードするかどうかを指定

30 ( 補 足 ) include.js の widget パラメータ Sametime Proxy SDK の JavaScript ライブラリである include.js に付与する widget パラメータには以下を指定できます widgets: すべての UI ウィジェット (Dojo クラスあり ) widgetslight: すべての UI ウィジェット (Dojo クラスなし ) livename:livename ウィジェット (Dojo クラスあり ) livenamelight:livename ウィジェット (Dojo クラスなし ) 指定なし : ベース コンポーネントだけをロード

31 スクリプトの解説 3: ログイン Login API を使ったログイン処理理 Sametime Proxy SDK の API を使うためには通常ログインが必要 Login API はいくつか種類がある stproxy.login.loginbytoken:sso の Token を使った認証 stproxy.login.loginbypassword: ユーザー名 & パスワードでの認証 stproxy.login.loginasanon:anonymous 認証

32 UI ウィジェットを使うには Dojo のウィジェットを使うには 2 つの 方式があります 1. Declarative ( 宣 言的 ) 方式 HTML の中の dojotype 属性で UI ウィジェットのクラスを指定 2. Programmatic( プログラム的 ) 方式 JavaScript で UI ウィジェットを使 用

33 Declarative 方式の場合 JavaScript 部分 djconfig の parseonload を true に HTML 部分 dojotype 属性で使 用する UI ウィジェットのクラスを指定 ウィジェットに必要なパラメータがある場合はそれも属性で指定 例例 : sametime.livename ウィジェットは userid が必須

34 Programmatic 方式の場合 JavaScript 部分 UI ウィジェットを new して DOM に appendchild します Login 後でないと正常に動作しない場合があるので Login の API の引数に callback 関数をセットし その中で処理理をするのが 一般的です

35 ベース コンポーネントを使 用するには JavaScript で stproxy.xxx の API を使 用 UI ウィジェットを使 用しないのであれば include.js のロードで widget パラメータは不不要 例例 : サンプルの example8 LiveNameModel を使って UI を 自分で作成している例例

36 XPages で Sametime Proxy SDK を使うには XPage に Sametime Proxy SDK を組み込む場合の注意点は以下です XPage はデフォルトで 自動的に Dojo Toolkit のライブラリを読み込むので Sametime Web Client が提供している Dojo Toolkit を別途読み込む必要はありません Sametime Proxy SDK は Dojo 1.5 をベースに開発されていますが Domino 9.0.x は Dojo になっているため バージョンの 非互換により 一部の UI ウィジェットが動作しない場合があります 非互換をできるだけ防ぐために include.js の widget パラメータに widgetslight もしくは livenamelight を指定しましょう これを指定すれば多くのウィジェットは動作します なお Domino は Dojo ベースなので 非互換はほとんどなく正常に動作します

37 XPage の場合のお決まりのスクリプト 先に紹介したスクリプトを XPage 用に書き換えただけ Dojo のロードは不不要 include.js の widget パラメータに注意

38 XPage で UI ウィジェットを使 用する例例 例例 : ビュー コントロールの列列で LiveName ウィジェットを Declarative 方式で使 用する場合 データに計算結果の値を指定して LiveName ウィジェットを使 用 コンテンツタイプは HTML に変更更

39 XPage で LiveName ウィジェットを使った例例

40 参考資料料 IBM developerworks IBM Collaboration Solutions : Developer toolkits Lotus Sametime 8.5 の Web Browser Client lot- st85webbrowserclient/ IBM Notes/Domino Application Development Wiki XPages Extension Library の Social Enabler Sametime コントロールの使い 方 10.lotus.com/ldd/ddwiki.nsf/dx/ Japanese_ How_ to_ use_ Social_ Enabler_ Sametime_ controls_ of_ XPa ges_ Extension_ Library

41 業務利利 用イメージ : IBM インサイドセールス ( 外向け Web ページ ) 41

42 ありがとうございました

43 特記事項 当資料料は 日本 IBM のテストやレビューを受けておりません 内容について できる限り正確を期すよう努めてはおりますが いかなる明 示または暗黙の保証も責任も負いかねます 本資料料の情報は 使 用先の責任において使 用されるべきものであることを あらかじめご了了承ください 掲載情報は不不定期に変更更されることもあります 他のメディア等に無断で転載する事はご遠慮ください 本資料料の著作権は 日本アイ ビー エムにあります 非営利利 目的の個 人利利 用の場合において 自由に使 用してもかまいませんが 営利利 目的の使 用は禁 止させていただきます IBM, IBM Connections, Lotus, Notes, Domino, Sameitme は International Business Machines Corporation の 米国およびその他の国における商標 その他 記載された社名および製品名は それぞれ各社の商標または登録商標です