ibm client application access 1.0.1 利⽤ガイド · 2017. 2. 20. · browser plugin...

© 2017 IBM Corporation

IBM Client Application Access 1.0.1 利⽤ガイド

2017/02/17

© 2017 IBM Corporation2

当資料について

• 当資料の記載内容は、正式な IBM のテストやレビューを受けておりません。内容について、できる限り正確を期すよう努めてはおりますが、いかなる明⽰または暗黙の保証も責任も負いかねます。本資料の情報は、使⽤先の責任において使⽤されるべきものであることを、あらかじめご了承ください。

• 当資料は、資料作成時点で公開されている情報を元に作成しています。掲載情報は不定期に変更されることもあります。他のメディア等に無断で転載する事はご遠慮ください。


Agenda

• IBM Client Application Access (ICAA) とは– Notes Browser Plug-in と ICAAの違い– Notesクライアントと ICAA との違い

• ICAA 1.0.1 の導⼊– ICAA のインストール– ICAA の設定– Auto Update Tool について

• ICAA 1.0.1 を利⽤する際の考慮点– アプリケーションの互換性について

• FAQ

• 参考⽂献


IBM Client Application Access (ICAA) とは


IBM Client Application Access (ICAA) とは

• これまでの IBM Notes Browser Plug-in (NBP) が名称変更され、新たに IBM Client Application Access (ICAA）となった

• IBM iNotes, IBM SmartCloud Notes Web, IBM VerseといったWebメールとDomino アプリケーションをシームレスに利⽤可能

• IBM Notes/Domino の軽量なクライアント


NBP から ICAA へ

• 2013年 IBM Notes Browser Plug-in 9.0 が IBM Notes/Domino 9.0 の新機能としてリリースü 2013年 IBM Notes Browser Plug-in 9.0.1 リリース

• 2015年6⽉ NBPをベースに、IBM Client Application Access 1.0 をリリース– IBM Notes/Dominoとは独⽴したコンポーネントとしてリリース– メールは IBM iNotes 以外にもIBM SmartCloud Notes, IBM Verseが利⽤可能に– Mac 64bit インストールモジュールの提供– JVMを含まないパッケージへ変更– Auto Update 機能の提供（クラウドユーザーのみ）ü 2015年10⽉ IBM Client Application Access 1.0.0.1 リリース

• 2016年５⽉ IBM Client Application Access 1.0.1 リリース– ブラウザ上で動作するプラグインから、スタンドアロンアプリケーションへ変更

§ ブラウザのプラグインサポートの廃⽌、ブラウザに依存したアプリケーション⾮互換に対応– 同じマシン上にNotesクライアントもインストール可能

ICAA 1.0.1 はブラウザから独⽴したスタンドアロンアプリケーション= ブラウザメールと併⽤するための軽量なNotesクライアント


（参考）IBM Notes Browser Plug-in (NBP) とは• ブラウザ内で動作するIBM Notes クライアント

– Webブラウザ⽤のプラグインをインストールする• 実体はNotesクライアントのため、現⾏のアプリケーションアーキテクチャーを

変更せずに継続利⽤することが可能

Webブラウザ

Browser PluginIBM Notes

IBM Dominoサーバー

NRPCアクセス

サーバー設定、アプリケーション設計は、変更不要

Browser PluginIBM NotesIBM Notes

Browser Plugin

Notesクライアントなので、notes.ini や IDファイル、names.nsf を使う

ブラウザの中で、IBM Notesクライアントが動作

これまで同様、Lotus Notesのプロトコルでアクセス(HTTPではない)

既存のアプリケーションが、そのまま動作する

※ICAA 1.0.0.1 まではアーキテクチャは同様


ICAA 1.0.1 の利⽤イメージ

Notesクライアントに近い画⾯イメージメールはブラウザで開く

Ｎｏｔｅｓステータスバー

Ｎｏｔｅｓクライアントのメニュー

ツールバー

メールを開くとiNotes/SC Notes Web/IBM Verse（ブラウザ）へ

レプリケーター、ワークスペース、Notesブックマークetc

ログインダイアログ

メイン画⾯


ICAA 1.0.1 の機能

• Notesクライアントが持つ機能ü 右クリックメニューやショートカットü プロパティボックス、ダイアログボックスなどü Notes URLを使ったアクセス、DBリンク、⽂書リンクü ローカルアプリケーション/複製ü ワークスペース、レプリケータページü Notesメニュー、ツールバー、ステータスバーなど△ スペルチェック（Windowsではサポートされない）× 添付ファイルビューアー

• Notesアプリケーションü フォーム、ビュー、エージェントなどの基本設計要素ü 未既読機能などのNotes DB標準機能△ Javaエージェント（OSのJVMを使⽤して利⽤可）× コンポジット・アプリケーション、XPages


NBP と ICAA – クライアントの特徴

NBP(ICAA 1.0)– クライアントは

ブラウザに集約– アプリケーションの

Web化対応は不要

ICAA 1.0.1 – Webメールと

Dominoアプリのシームレスな連携

– アプリケーションはNotesクライアントにより近い使⽤感

ブラウザ

ワークスペース

ブラウザ ICAA（スタンドアロン）

ワークスペース

Dominoアプリケーション

Dominoアプリケーション


NBP と ICAA の違いNBP ICAA

プラットフォーム Windows only Windows, Mac

アプリケーションタイプ

ブラウザベースアプリケーション

スタンドアロンアプリケーション

既存Notesクライアントとの共存

既存Notesクライアントと共存不可※

既存Notesクライアントと同⼀マシン上に共存可

（異なるバージョンで共存可）

メール IBM iNotesIBM iNotes

IBM SmartCloud NotesIBM Verse

Auto Update 機能 N/A Auto Update 機能有（クラウドユーザーのみ）

インストールパッケージ

2種類のパッケージ（JVMを含む/含まない）

1種類のみ（JVMはシステムにインストー

ル済みのものを使⽤）

1.0.1以降

1.0.1以降

※既存Notesクライアントを引き続き使⽤する場合はNotesクライアントを再インストールが必要。NBPのバージョンはNotesクライアントと同じことが前提。


Notesクライアントと ICAA の違い

• ICAA の実体は Notes Client Basic版相当• Notesクライアント Basic版との主な違い

– Sametime統合機能を持たない– メールは iNotes、IBM SmartCloud Notes Web,

IBM Verse

ICAA Notes Basic版 Notes Standard版

Notesクライアントデスクトップ(bookmarkなど)

NSF/DB/複製

LotusScript エンジン

Notesコア機能 (DB, Views, editor, Toolbars etc)


Sametime統合

NSF/DB/複製



JVM/Javaエージェント添付ファイルビューワーローカルヘルプ


Sametime統合

NSF/DB/複製



JVM/Javaエージェント添付ファイルビューワーローカルヘルプ

ExpeditorフレームワークJava プラグインコンポジットアプリケーションウィジェット

サイドバーアクティビティ統合フィードリーダーライブテキスト

インストーラーに含まれないもの- JVM（OS上のJVMを認識）- スペルチェッカー（OS機能を利⽤）- 添付ファイルビューアー- ローカルヘルプ

1.0.1以降


ICAA 1.0.1 の導⼊


ICAA 1.0.1 のシステム要件

• OS– Windows 7 Professional (32bit, 64bit), Windows 7 Enterprise (32bit, 64bit)– Windows 8 Professional (32bit, 64bit), Windows 8 Enterprise (32bit, 64bit)– Windows 8.1 Enterprise (32bit, 64bit)– Windows 10 Professional (32bit, 64bit), Windows 10 Enterprise (32bit, 64bit)– Mac OS X 10.9 (64bit), Mac OS X 10.10 (64bit), Mac OS X 10.11 (64bit)– Citrix XenApp 6.5, Citrix XenApp 7.5, Citrix XenApp 7.6

• IBM Domino– 過去バージョンのDominoサーバーのアプリケーションをサポート

（最新の拡張機能利⽤のため IBM Domino 9.0 以降を推奨）

• IBM Notes (ICAA と Notes のデュアルクライアントの場合)– IBM Notes 9.0 以降

サポートされるオペレーティングシステムhttp://www.ibm.com/support/knowledgecenter/ja/SS5SMW_1.0.1/topics/appacc_os_reqs_r.htmlサポートされる Domino バージョンhttp://www.ibm.com/support/knowledgecenter/ja/SS5SMW_1.0.1/topics/appacc_dom_reqs_r.html


ICAA のユーザータイプとインストール⽅法

• クラウドユーザー– 初回インストール時には、管理者がIBM Software Download Center（IBM

Connections Cloud内）からモジュールをダウンロードしてユーザーへ配布、もしくは、インストールを実施

– 更新およびアップグレードはクラウドの⾃動更新サービス（Auto Update Tool）によって⾏われる

• オンプレミスユーザー– Notesクライアントと同様、モジュールを配布しインストール


ICAA のインストール（1/3）• インストーラーの実⾏

– インストーラーは⽇本語パッケージを含むためLanguage Packの導⼊は必要なし– 指定箇所はライセンスの同意のみ– インストーラーのサイズ:108MB

Microsoft Windows へのインストールhttp://www.ibm.com/support/knowledgecenter/ja/SS5SMW_1.0.1/topics/appacc_install_t.htmlMac OS でのインストールhttp://www.ibm.com/support/knowledgecenter/ja/SS5SMW_1.0.1/topics/appacc_install_mac_t.html


ICAA のインストール（2/3）

• インストール完了後にMUIパックのインストールが開始される(MUI = Multilingual User Interface)

MUIパックのセットアップ完了まで確認



ICAA のインストール（1/3）

• インストールに関する補⾜– デフォルトのプログラムディレクトリ、データディレクトリ（インストーラーで指定不可）

§ 例）Windowsの場合プログラムディレクトリ：C:¥Program Files(x86)¥IBM¥ICAAデータディレクトリ(シングルユーザー)： C:¥Program Files(x86)¥IBM¥ICAA¥Dataデータディレクトリ(マルチユーザー)：C:¥Users¥[user]¥AppData¥Local¥IBM¥Notes¥Data

§ Notesクライアントがインストール済の場合、ICAAはNotesクライアントのデータディレクトリを参照する

– マルチユーザーインストール/シングルユーザーインストール§ ICAAのみインストールの場合は、マルチユーザーインストールとなる§ Notesクライアントがインストール済みの場合はNotesクライアントに従う

（通常シングルユーザー）

– インストーラーにJVMは含まれないため、OS の JVMを認識して使⽤する§ （Windows）Oracle JVM 1.6以降以外のJVMの場合は設定が必要（次項参照）



ICAA のインストール – JVMの設定（Windows）

• ICAAはマシン上の Oracle JVM 1.6以降を⾃動的に認識して使⽤（ただし32bit JVMのみ）

• 上記以外のJVMを使⽤する場合はnotes.iniへの設定が必要

JVMの設定⼿順1. ICAA の notes.ini ファイルを開く（ICAAプログラムフォルダ内）2. JVMDirectoryLocationパラメータを設定する

例）JVMDirectoryLocation=C:¥Program Files (x86)¥Java¥jre83. JavaOracleVMパラメータを設定する

§ Oracle JVMの場合は1, その他のJVMの場合は0を設定する

JVM のインストールと構成http://www.ibm.com/support/knowledgecenter/ja/SS5SMW_1.0.1/topics/appacc_install_java_t.html


（参考）ICAA のサイレントインストール

• [Windows] コマンドラインから、以下のコマンドを実⾏

– -s, -a, /s は必須パラメータ– デフォルトのプログラムディレクトリを変更可能（データディレクトリは不可）

• [Mac OS] ターミナルから、以下のコマンドを実⾏

＞setup.exe -s -a /s /v"SETMULTIUSER=1 PROGDIR=¥¥"%s¥¥" /qn“

Windows へのサイレントインストールhttp://www.ibm.com/support/knowledgecenter/ja/SS5SMW_1.0.1/topics/appacc_silent_install_t.htmlMac OS でのサイレントインストールhttp://www.ibm.com/support/knowledgecenter/ja/SS5SMW_1.0.1/topics/appacc_silent_install_mac_t.html

$ sudo installer -pkg IBM¥ Client¥ Application¥ Access¥ Installer.pkg -target /


（参考）デュアルクライアントのインストールの注意点

• NBP がインストールされている環境へICAAをインストールする場合– NBPはアンインストールされる（下図の確認画⾯が表⽰される）– データディレクトリはNotesデータディレクトリが利⽤される

• Notesクライアント9.0以降がインストールされている環境へICAAをインストールする場合– ICAAがインストールされている状態で、Notes クライアントのFixPackをインストール

することが可能– Notesクライアント9.0の場合、ICAAがインストールされている状態でNotesクライア

ントを9.0.1にアップグレードできない（ICAAのアンインストールが必要）

デュアルクライアントのインストールシナリオhttp://www.ibm.com/support/knowledgecenter/ja/SS5SMW_1.0.1/topics/appacc_coexist.html


ICAA の設定（1/2）

• ICAA のみインストールされている（Notesクライアントがセットアップされていない）環境では、初回起動時にセットアップを⾏う。

• オンプレミスユーザーの場合– 「IBM SmartCloud ユーザーです。」にチェックをしない（下図参照）– ユーザー名などを⼊⼒して設定を続ける

構成http://www.ibm.com/support/knowledgecenter/ja/SS5SMW_1.0.1/topics/appacc_config_top_r.html


ICAA の設定（2/2）

• クラウドユーザーの場合1. 「IBM SmartCloud ユーザーです。」にチェックを⼊れる（下図左参照）

§ ハイブリッドクラウドユーザーの場合には、「IBM Notes ID ファイルを持っています。」にチェックを⼊れる。（ハイブリッドクラウドユーザー：オンプレミスのDominoサーバーにアクセス可能なNotes IDファイルを持つユーザー）

2. Config.nsfのダウンロードを求めるダイアログが表⽰される。（下図右参照）3. Notes ID ファイルがある場合には、IDファイルを指定するダイアログが表⽰される。4. Config.nsfをダウンロード、設定する。（設定⽅法は下記リンクに記載）

構成http://www.ibm.com/support/knowledgecenter/ja/SS5SMW_1.0.1/topics/appacc_config_top_r.html


（参考）ICAA関連のnotes.iniパラメータ

設定設定内容設定値

BrowserUseHttpForiNotes iNotesへアクセスする際にセキュアなプロトコルを使⽤するかどうか

0: https（デフォルト）1: http

BrowserAllowiNotesMail IBM iNotes アイコン/メニューの表⽰/⾮表⽰を設定

0: ⾮表⽰（デフォルト）1: 表⽰

NBP_UseIBMVerse IBM Verse をデフォルトのメールクライアントとして使⽤するかどうか（[転送] や [ブックマークとして転送]等のアクション）

0: Verseを使⽤しない（デフォルト）1: Verseを使⽤する

CopyAsTableHTMLSetting [編集] > [コピー] > [表] オプションを使⽤して、Notes ビュー内で⽂書のリストをコピーした場合のデータ形式

0: DocURI (⽂書リンクアイコン) を持つHTML として表をコピー（デフォルト）1: 「Notes リンク」というテキストを含む HTML 表としてコピー2: HTML 表としてではなく Notes の表としてコピー

クライアント設定http://www.ibm.com/support/knowledgecenter/ja/SS5SMW_1.0.1/topics/appacc_ini_settings_r.html


Auto Update Tool によるアップグレード（クラウドユーザー）

• インストール済みの ICAA の新規リリース（メジャーリリース、hotfix, fix-pack）が使⽤可能になった場合に、管理者が介⼊することなく⾃動的にアップグレード、更新を⾏うことが可能

• デフォルトはサイレントインストールとなり、ユーザーは特に操作の必要なし– サイレントインストールを⾏わない場合は、ユーザーへのプロンプトが表⽰される

例）Mac OS、Windows

• アップグレードの対象バージョンやサイレントインストールを⾏うかどうかなど、いくつかの項⽬はカスタマイズ可能

IBM Client Application Access への更新のカスタマイズhttp://www.ibm.com/support/knowledgecenter/ja/SSPS94/hybrid/topics/cfg_controlling_auto_updates_icca.html


ICAA 1.0.1 を利⽤する場合の注意点


アプリケーションの互換性について

• ほとんどの Domino アプリケーション（関数）は Notesクライアントと同様に動作するが、⼀部の関数に動作の差異あり

• @関数、＠コマンドの制約– メール/カレンダーを直接操作するフロントエンド関数は動作しないが、バックエンド関

数（メール転送など）は動作する– Notes Client を操作する関数は動作する– Domino Designer, Domino Administrator の機能を呼び出す関数は動作しない– Sametime統合機能を呼び出す関数は動作しない


@関数、＠コマンドの制約：メール/カレンダー（1/2）

×メールDBのユーザーインターフェースを直接操作するフロントエンド関数は動作しない– メール/カレンダーを開く（MailOpen/OpenCalender/MailComposeMemo）– 開いたメールを操作する(MailScanUnread)– メールを設定する(ToolsSetupMail)

ü 下記のようなエラーメッセージが表⽰される

○メールDBを直接操作しないバックエンド関数は動作する– MailSend, MailForwordAsAttachmentなど


@関数、＠コマンドの制約：メール/カレンダー（2/2）

○メール転送関数は動作する– MailForwordü 転送メールはICAA以外（iNotes, Verse等）で開く

○アドレス帳を参照する関数する– MailAddressü ICAAで宛先選択ダイアログボックスが開く


@関数、＠コマンドの制約：Notesクライアント

○Notesクライアントを操作する関数は動作する

– Notesを終了する関数（ExitNotes, FileExit）

– Workspaceを操作する関数（WindowWorkspace, WorkspacePropertise, WorkspaceStackReplicaIcon, ViewRefreshUnRead, ViewShowServerNames, ViewShowUnread）

– ウィンドウの表⽰レイアウトを変更する関数（WindowCascade, WindowNext, WindowTile）ü表⽰イメージはBasic版と同様となる

– ウィンドウを開く関数（OpenInNewWindow）

– ブックマークを追加する関数（AddBookMark）üブックマークはNotes Client⽤ブックマーク（bookmark.nsf）に追加される

NBPでは⾮互換有


@関数、＠コマンドの制約：Designer

×Designerの機能を呼び出す関数は動作しない– Create*, Design*, AgentRun, AgentTestRun, AgentEdit, AgentLog– FormTestDocument, FormActions, InsertSubForm– Layout*, Navigatof*, PasteBitmap*, FolderProperties


○Designerがなくても動作する設計関連関数は動作する– CreateAgent, CreateView, CreateFolder, CreateSecsion, FolderCustomize– DesignRefresh, DesignReplace, DesignDocumentInfo– DebugLotusScript, AgentEnableDisable, AgentSetServerName, RunAgent,

RunScheduledAgents, ToolsRunMacro, ToolsRunBackgroundMacros※×DesignSynopsis（設計の⼀覧表⽰）は、ICAAに該当の機能がないため動作しない


@関数、＠コマンドの制約：Administrator

×Administratorの機能を呼び出す関数は動作しない– Admin*


○Administratorがなくても動作する管理系関数はICAAでも動作する– 認証系コマンド（AdminRegister*等）


@関数、＠コマンドの制約：Sametime統合機能

×Sametimeを呼び出す関数– @GetIMContactListGroupNames– AddToIMContactList– SendInstantMessage– ShowHideIMContactList


FAQ


FAQ (1/3)

Q. ICAAはどのように⼊⼿できますか？A. オンプレミスユーザーはPassport Advantageより⼊⼿可能です。

クラウドユーザーはクラウドサービスのダウンロードページから⼊⼿可能です。FixはFix Centralで⼊⼿できます。クラウドユーザーの場合、ユーザーが直接Auto Update Toolを通じて更新を⼊⼿可能です。

Q. Notesクライアント Basic版との違いは何ですか？A. Basic版に含まれるJVM、スペルチェッカー、添付ファイルビューアー、ローカルヘル

プは含まれません。また、Sametime統合機能は含まれません。メールは IBM iNotes, IBM SmartCloud Notes web, もしくは IBM Verseです。

Q. メールのローカルアーカイブは使⽤できますか？A. ICAA で新規にメールのローカルアーカイブを作成したり、アーカイブを実施すること

はできません。既存のローカルアーカイブを開くことは可能です。


FAQ (2/3)

Q. スペルチェッカーは使⽤できますか？A. Windows版のICAAでは、スペルチェックは利⽤不可です。

Q. ICAAをブラウザで開くことができますか？A. ICAAはブラウザでは利⽤できません。NBPがブラウザのプラグインであるのに対し、

ICAAはスタンドアロンアプリケーションとなっています。

Q. ICAAをインストール後に起動すると、メニューが英語になります。⽇本語に切り替えるにはどうしたらよいですか？A. ユーザープリファレンス(※1)から⼿動で⾔語を⽇本語に切り替えるか、ポリシー（※2）

を適⽤して変更してください。

※1 [File]–[Preference]–[User Preference]を開き[International]タブの Interface Language を “Japanese”に設定※2 notes.iniパラメータ”UserInterface=ja”を追加するデスクトップポリシー設定を作成


FAQ (3/3)

Q. Verse や iNotesとどのように連携することができますか？A. ICAA でメールデータベースを開くとVerse/iNotesを開きます。

⽂書の転送も可能です。また、Verse/iNotes⽂書リンクを開くと、ICAAで⽂書を開くことができます。

Q. ICAAでカレンダーを利⽤することはできますか？A. ICAA ではメール/カレンダーのデータベースは開くことができません。

カレンダーは、IBM iNotes, IBM SmartCloud Notes webで利⽤可能です。

Q. ICAAの⼗分なセキュリティを備えていますか？A. Notes ID ファイルやローカルデータベースの暗号化など、Notesクライアントと同等

のセキュリティは確保されています。


参考⽂献

• IBM Client Application Access V1.0.1 ヘルプhttp://www.ibm.com/support/knowledgecenter/ja/SS5SMW_1.0.1/topics/appacc_101_welcome.html

• Open Mic Webcast: IBM Client Application Access (ICAA) - 14 September 2016http://www-01.ibm.com/support/docview.wss?uid=swg27048526

• Interim Fixes & JVM patches for 9.0.1.x versions of IBM Notes, Domino, iNotes, Notes Browser Plug-in & ICAAhttp://www-01.ibm.com/support/docview.wss?uid=swg21657963

ibm client application access 1.0.1 利⽤ガイド · 2017. 2. 20. · browser plugin...

Documents