ibm client application access 1.0 利用ガイド · – windows 7 professional / enterprise...

© 2017 IBM Corporation

IBM Client Application Access 1.0 利用ガイド

2018/1/17

© 2018 IBM Corporation2

当資料について• ICAA 1.0 とは当資料作成時の最新版である ICAA 1.0.1.2 です。

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

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


もくじ• IBM Client Application Access (ICAA) とは

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

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

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

• FAQ• 参考⽂献


IBM Client Application Access (ICAA) とは


IBM Client Application Access (ICAA) とは• IBM Notes/Domino ⽤「Notes を軽量化したクライアント」

– アプリケーションとしてDominoを使うことを⽬的– Domino Utility Server 組み合わせ時にクライアント・ライセンス取得不要 (サーバー課⾦

のみ)

• IBM iNotes、IBM SmartCloud Notes Web、IBM Verse、IBM mail support for Microsoft Outlook (IMSMO) などの (Web) メール・クライアントと Domino アプリケーションをシームレスに利⽤可能


ICAA 1.0 の利⽤イメージ

Notes Basic クライアントと基本的に同じ画⾯メールDBは開けない (ブラウザで開く)

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

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

ツールバー

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

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

ログインダイアログ

メイン画⾯


ICAA 1.0 の機能• Notesクライアントが持つ機能

右クリックメニューやショートカットプロパティボックス、ダイアログボックスなどNotes URLを使ったアクセス、DBリンク、⽂書リンクローカルアプリケーション/複製ワークスペース、レプリケータページNotesメニュー、ツールバー、ステータスバーなどスペルチェック

× 添付ファイルビューアー

• Notesアプリケーションフォーム、ビュー、エージェントなどの基本設計要素未既読機能などのNotes DB標準機能

△ Javaエージェント（OSのJVMを使⽤して利⽤可）× コンポジット・アプリケーション、Xpages× Domino Deisgner 機能


Notesクライアントと ICAA の違い• ICAA の⺟体は Notes Client Basic• Notesクライアント Basic 版との主な違いは下図の通り。

– アプリからのメールは送信は可だがメールDBは開けない(メールDBからのメール新規作成ができない)。

ICAA Notes Basic版 Notes Standard版

• メール送信• Notesクライアントデスクトップ

(ワークスペース、ブックマークなど)• NSF/DB/複製• LotusScript エンジン• Notesコア機能

(DB、ビュー、エディター、ツールバーなど)

• メールDBへのアクセス• JVM/Javaエージェント• 添付ファイルビューワー• ローカルヘルプ• Sametime クライアント

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

• サイドバー• アクティビティ統合• フィードリーダー• Live Text







• メールDBへのアクセス• JVM/Javaエージェント• 添付ファイルビューワー• ローカルヘルプ• Sametime クライアント

• インストーラーに含まれないもの- JVM (OS上のJVMを認識)- 添付ファイルビューアー- ローカルヘルプ- Sametime クライアント

• 無効化されるもの- メールDBへのアクセス


ICAA 1.0 の導⼊


ICAA 1.0 のシステム要件• OS

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

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

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

• IBM Notes (ICAA と Notes を共存する場合)– IBM Notes 9.0 以降サポートされるオペレーティングシステムhttps://www.ibm.com/support/knowledgecenter/ja/SS5SMW_1.0.1/topics/appacc_os_reqs_r.htmlサポートされる Domino バージョンhttps://www.ibm.com/support/knowledgecenter/ja/SS5SMW_1.0.1/topics/appacc_dom_reqs_r.html

https://www.ibm.com/support/knowledgecenter/ja/SS5SMW_1.0.1/topics/appacc_os_reqs_r.html

https://www.ibm.com/support/knowledgecenter/ja/SS5SMW_1.0.1/topics/appacc_os_reqs_r.html


ICAA のユーザータイプとインストール⽅法• クラウドユーザー

– 初回インストール時には、管理者がIBM Software Download Center（IBM Connections Cloud内）からモジュールをダウンロードしてユーザーへ配布、もしくは、インストールを実施

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

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


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

– ICAA 1.0.1.2 の英語版インストーラー実⾏後、⽇本語 Language Pack インストーラーを実⾏

– 指定箇所はライセンスの同意のみ– インストーラーのサイズ: 合計約110MB (本体 78MB + ⾔語パック 31MB)

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

http://www.ibm.com/support/knowledgecenter/ja/SS5SMW_1.0.1/topics/appacc_install_t.html

http://www.ibm.com/support/knowledgecenter/ja/SS5SMW_1.0.1/topics/appacc_install_t.html


ICAA のインストール（2/2）• インストールに関する補⾜

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

例）Windowsの場合プログラムディレクトリ： C:¥Program Files(x86)¥IBM¥ICAAデータディレクトリ(シングルユーザー)：C:¥Program Files(x86)¥IBM¥ICAA¥Dataデータディレクトリ(マルチユーザー)： C:¥Users¥<user>¥AppData¥Local¥IBM¥Notes¥DataNotesクライアントがインストール済の場合、ICAAはNotesクライアントのデータディレクトリを参照する

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

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


ICAA のサイレントインストール• [Windows] コマンドラインから、以下のコマンドを実⾏

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

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

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

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


ICAA のインストール – JVMの設定（Windows）• ICAAはマシン上の Oracle JVM 1.6以降を⾃動的に認識して使⽤

（ただし32bit JVMのみ）• 上記以外のJVMを使⽤する場合はnotes.iniへの設定が必要

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

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

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

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


（参考）デュアルクライアントのインストールの注意点• Notesクライアント9.0以降で可能。

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

– Notesクライアント9.0の場合、ICAAがインストールされている状態でNotesクライアントを9.0.1にアップグレードできない（ICAAのアンインストールが必要）

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


Notes 8.5 から ICAA への移⾏• Notes 8.5 のアンインストールが必要 (共存不可)• アンインストール後、残ったDBやIDなどを引き継いでICAAをセットアップ可能

– setup -s -a /v"REUSE_INI=C:¥<Notes_directory>¥notes.ini“Notes 8.5 をマルチユーザーセットアップしていた場合のみ、Data フォルダーを以下に移動した上でインストールする。• C:¥ユーザー¥<username>¥AppData¥Local¥IBM¥Notes¥Data

• notes.ini を引き継ぐため、ユーザー操作によるセットアップ不要で、すぐに利⽤可能。

Windows 上での Notes データの IBM Client Application Access へのマイグレーションhttps://www.ibm.com/support/knowledgecenter/ja/SS5SMW_1.0.1/topics/appacc_migrate_data.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）• クラウドユーザーの場合

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

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


（参考）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 を利⽤する場合の注意点


アプリケーションの互換性について• ほとんどの 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）に追加される


@関数、＠コマンドの制約：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はどのように⼊⼿できますか？

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

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

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

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

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

• Q. アプリケーションからのメール送信は可能ですか?– 可能です。但し、メールDBのメール・フォームを使ってメールを新規作成する仕組みに

なっている場合には利⽤できません。メールDBへのアクセスが制限されているためです。


FAQ (2/3)• Q. ICAAをブラウザで開くことができますか？

– ICAAはブラウザでは利⽤できません。NBPがブラウザのプラグインであるのに対し、ICAAはスタンドアロンアプリケーションとなっています。

• Q. ICAAをインストール後に起動すると、メニューが英語になります。⽇本語に切り替えるにはどうしたらよいですか？

– ユーザープリファレンス(※1)から⼿動で⾔語を⽇本語に切り替えるか、ポリシー（※2）を適⽤して変更してください。※1 [File]–[Preference]–[User Preference]を開き[International]タブの Interface Language を “Japanese”に設定

– ※2 notes.iniパラメータ”UserInterface=ja”を追加するデスクトップポリシー設定を作成


FAQ (3/3)• Q. Verse や iNotesとどのように連携することができますか？

– ICAA でメールデータベースを開くとVerse/iNotesを開きます。⽂書の転送も可能です。また、Verse/iNotes⽂書リンクを開くと、ICAAで⽂書を開くことができます。

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

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

• Q. ICAAの⼗分なセキュリティを備えていますか？– 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 2016 (英語)– http://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 & ICAA (英語)– http://www-01.ibm.com/support/docview.wss?uid=swg21657963

http://www.ibm.com/support/knowledgecenter/ja/SS5SMW_1.0.1/topics/appacc_101_welcome.html

http://www.ibm.com/support/knowledgecenter/ja/SS5SMW_1.0.1/topics/appacc_101_welcome.html

http://www-01.ibm.com/support/docview.wss?uid=swg27048526


参考: Notes Browser Plugin (NBP)


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 まではアーキテクチャは同様


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クライアントと同じことが前提。

ibm client application access 1.0 利用ガイド · – windows 7 professional / enterprise...

Documents