Version 5.1
アカウントへのアクセス |
|---|
| |||||||||
|
|
Version 5.1 |
|||||||||||||||||||||||||||||||
|
|
MAPI は、メッセージングアプリケーションプログラミングインターフェイスの略称です。MAPI は、 Microsoft Windows オペレーティングシステムに内蔵のシステムコンポーネントとAPI で構成されてい ます。このコンポーネントとAPI、またアプリケーションが統合された形で処理が実行されます。
CommuniGate Pro のMAPI コネクタを使用することで、処理効率が向上します。つまり、MAPI コネク タを使った場合、Windows アプリケーションとグループウェアサーバー（また、その他のデータ格納 メカニズム） との間で直接、通信が行われることはなくなります。代わりに、アプリケーションから メッセージング要求（例えば、メールボックスの内容のリストの取得、ナンバーX のメッセージの取 り出しなど） がMAPI コンポーネントに送られます。その後、MAPI コンポーネントにより、インス トール済みの「コネクタ」モジュールを使って、メッセージング要求がExchange Server やローカルの 「パーソナルフォルダ」、またファックスサーバーなどに送信されます。
MAPI コネクタでは、追加の「コネクタ」を作成し、そのコネクタを介して各種のサーバーソフトウェ アとの間で通信を行うことができます。ただし、追加のコネクタを使うときには、データフォーマッ トの問題を解決しなければなりません。というのは、追加のコネクタを使った場合、Windows アプリ ケーションからMAPI を介してコネクタにデータオブジェクトが送信されますが、その場合、フォー マットとしてはいわゆる「MAPI オブジェクトフォーマット」が使用されるためです。このフォーマッ トは、どのインターネットフォーマットとも共通点がありません。CommuniGate Pro のMAPI コネク タには、このフォーマットを標準インターネットフォーマットに変換する機能があり、変換後のメッセージングオブジェクトは、標準のインターネットメッセージとしてCommuniGate Pro のメールボッ クスに格納されます。また、CommuniGate Pro のメールボックスのメッセージの取り出しの際には、 MAPI コネクタにより、自動的にメッセージのフォーマットがMAPI オブジェクトフォーマットに変換 され、変換後のオブジェクトがMAPI とWindows アプリケーション（Outlook など） に送られます。 データフォーマットの問題は、以上のようにして解決されます。
MAPI コネクタを使った場合、上記のようにメッセージは標準のインターネットフォーマットでメー ルボックスに格納されるため、メッセージは、POP3 メールクライアントやIMAP メールクライアン ト、またWebUser インターフェイスで読むことができます。
The CommuniGate Pro MAPI Connector also performs data conversion between proprietary
Microsoft "objects" data formats and the standard Internet data formats.
Because the standard Internet formats are used, messages stored with the CommuniGate Pro MAPI Connector
can be read using any standard POP3 or IMAP mail client, the CommuniGate Pro WebUser Interface, or any XIMSS-based client.
The CommuniGate Pro MAPI Connector uses TCP/IP networks and should be configured to connect to any non-TLS (clear text) IMAP port of your CommuniGate Pro server (the port 143 is the standard IMAP port).
The CommuniGate Pro MAPI Connector supports both clear text and secure (SSL/STARTTLS) connections, and it can use plain text and secure CRAM-MD5 login methods.
The CommuniGate Pro MAPI Connector contains two code parts (shared libraries).
The starter code part should be installed on Windows workstations. It provides
the configuration interface and it is used to connect to the CommuniGate Pro server.
The main MAPI Connector functionality is implemented as a shared library stored in the Server application directory, and it is called the server code part.
When the MAPI Connector starter code connects to the CommuniGate Pro Server, the Server
sends the server code part of the MAPI Connector to the client computer.
This method allows you to deploy "regular" MAPI Connector updates by updating your CommuniGate Pro
Server software only, without running the MAPI Connector Installer on all client workstations.
MAPI コネクタを使用する場合、各Windows ワークステーションにMAPI コネクタの共有ライブラリ （.dll） をインストールしなければなりません。インストールする場合、まず、MAPI コネクタアーカ イブをダウンロードし、アンパックします。アンパックすると、フォルダにSetup.exe ファイルが作 成されます。
Setup.exe アプリケーション（アンパック済み） を起動します。アップデートの場合も同様です。イン ストール後、場合によってはメールプロファイルを再構築するように指示されます。
MAPI コネクタのSetup.exe アプリケーションは、サイレントモード（ユーザーインターフェイスダイ アログボックスの表示なし） で起動することもできます。サイレントモードで起動する場合、次のコ マンドラインパラメータを指定します（パラメータによって処理内容は変わります）。
| /i | MAPI コネクタのインストールまたはアップグレード |
| /r | MAPI コネクタの削除 |
| /q | プロファイル設定なし |
| /Q | エラーメッセージの表示なし |
cgmxui32.inf ファイルを使って、MAPI コネクタ用のアカウント設定の定義、また共有アカウント の設定を自動的に行うことができます。このファイルはダウンロードして入手できます。ダウンロー ド後、必要に応じて内容を編集し、Setup.exe アプリケーションと同じディレクトリに置きます。 これで、Setup の実行（インストール）時に自動的に、このファイルが使用されます。
MAPI コネクタをWindows クライアントワークステーションにインストールした後、メールプロファ イルを作成します。このメールプロファイルにより、Outlook などのアプリケーションで、サービス としてCommuniGate Pro のMAPI サービスが使用されるようになります。
使用しているアプリケーションがOutlook 98 またはOutlook 2000 の場合、「グループウェア」モード
で動作していることを確認します。確認方法は、Outlook を起動し、［Tools］ メニューから
［Options］ コマンドを選択します。［Options］ ダイアログボックスが開きます。［Mail Services］ タブ
を選択し、［Reconfigure Mail Support］ ボタンをクリックします。クリック後、［E-mail Service
Options］ ダイアログボックスが開きます。ここで、［Corporate］ オプションまたは［Workgroup］ オ
プションが選択されていれば、グループウェアモードで動作していることを示しています。
注意: 上記のようにしてOutlook の動作モードを変更する場合、Microsoft Office インストールCDROM
が必要になることがあります。
［Mail］ コントロールパネルを開き、［Show Profiles］ ボタンをクリックします。メールプロファイル のリストが表示されます。MAPI コネクタのインストール後、メールプロファイルを再構築するよう に指示されることもありますが（上記を参照）、この指示が表示されたときには、古いメールプロ ファイルを選択し、［Remove］ ボタンをクリックします。これで、そのメールプロファイルが削除さ れます。
［Add］ ボタンをクリックし、新規のメールプロファイルを作成します。なお、使用しているOutlook や、インストールされた［Mail］ コントロールパネルによっては、ダイアログボックスがいくつか表 示されることがあります。［Additional Server Types］ オプションがあるダイアログボックスが表示さ れた場合、このオプションを選択します。その後、［CommuniGate Pro Server］ を「サービス （service）」または「追加サーバータイプ（additional server type）」として選択します。
同一のメールプロファイルには、サービスを複数追加することもできます。
メールプロファイルが作成され、そのメールプロファイルにCommuniGate Pro サービス（MAPI コネ クタ） が追加されると、MAPI コネクタの設定が可能になります。MAPI コネクタの設定は、下記の 手順で行います。MAPI コネクタの設定は、後日、変更することもできます。その場合、［Mail］ コントロールパネルを開き、メールプロファイルを開き、その後、CommuniGate Pro サーバーのサービス設定を開きます。また、MAPI コネクタの設定は、Outlook の［Tools］ メ ニューの［Services］ コマンドを使って変更することもできます。
［Add］ と［Remove］ の各ボタンを使って、CommuniGate Pro のアカウント（CommuniGate Pro で使わ れるアカウント） の追加と削除が可能です。例えば、別のドメインのアカウントにアクセスしたい場 合、アカウントの正式の名前（ アカウント名@ ドメイン名の形式） を指定します。
なお、ユーザーが別のドメインのアカウント（別のオーナーのアカウント、つまりフォリンメール ボックス） にアクセスする場合、そのユーザーに対して、別のドメインのアカウントのオーナーから メールボックスアクセス権が付与されていることが必要です。そうでない場合、ユーザーは、そのア カウントのメールボックスを開くことができません。フォリンメールボックスについては、詳しくは 「共有」のセクションの共有を参照してください。
［Synchronization］ の下のチェックボックスを使って、どのフォルダをダウンロードするか、また、メッ セージ全体または一部をダウンロードするかを設定できます。
ユーザーは、アクセスコントロールリストを使って、別のCommuniGate Pro ユーザーに対し、自分 のメールボックスに対するアクセス権を付与できます。
別のユーザーに自分のメールボックスへのアクセス権を設定する場合、Outlook のフォルダリストで メールボックスを選択します（ このメールボックスについてアクセス権を付与します）。その後、 ［Properties］ コマンドを選択すると、［Properties］ ダイアログボックスが開きます。このダイアログ ボックスで［Permissions］ タブを選択します。
［Add］ と［Remove］ の各ボタンを使ってそれぞれ、アクセス権を付与するアカウントをリスト（アク セスコントロールリスト） に追加または削除できます。
また、［Permissions］ の下の各チェックボックスを使って具体的なアクセス権（例えば、フラグの変
更、サブフォルダの作成など） を指定できます。メールボックスのアクセスコントロールリストにつ
いては、詳しくは「メールボックス」のセクションのメールボックスの説明を参照してください。
注意: デフォルトのメールボックス（フォルダ） ビューを指定する場合、ユーザーに管理者
（Admin） アクセス権が必要です。
フリー/ ビジー情報とは、ビジー、フリー、外出中といったユーザーの状態に関する情報をいいま す。フリー/ ビジー情報は通常、公開情報で、この情報をもとに他のユーザーは会議の予定を立てた りアポを取り付けたりできます。フリー/ ビジー情報は、ユーザーのカレンダーをもとにグループ ウェアクライアントアプリケーションによって自動的に収集され、収集後、フリー/ ビジースケ ジュールが作成されます。
フリー/ ビジー情報は、ユーザーのパーソナルファイルサイトに格納されます。フリー/ ビジー情報 は、公開情報とプライベート（個人） 情報で構成されています。公開情報は、標準のvCalendar フォーマットで、freebusy.vfb ファイルとしてパーソナルWeb サイトの最上位のディレクトリに 保存されます。一方、プライベート情報は、Microsoft オブジェクトデータフォーマットで、 freebusy.eml ファイルとしてパーソナルWeb サイトのprivate ディレクトリに格納されます。
注意: 公開情報（freebusy.vfb） と個人情報（freebusy.eml） はパーソナルWeb サイトに格納 されます。したがって、アカウントのパーソナルWeb サイトの制限（サイズやファイル数） を チェックし、フリー/ ビジー情報を格納する余裕があるかどうか確認しておくことが必要です。
上記の設計により、Outlook ユーザー、また各種カレンダークライアントユーザーは、HTTP を介し て別のユーザーのパーソナルWeb サイトにアクセスし、そのフリー/ ビジー情報を取り出すことが できます。フリー/ ビジー情報（公開情報） のURL の形式は、次の通りです。ユーザーは、Outlook アプリケーションで別のユーザーの電子メールアドレスを指定して、そのユー ザーのフリー/ ビジー情報を取り出すことができますが、上記の［Search］ フィールドの設定は、そ の処理で使われます。つまり、URL の%SERVER% がアクセス先のユーザーの電子メールアドレスの ドメイン部に、また%NAME% がユーザーの電子メールアドレスのユーザー名に置き換えられます。 例えば、電子メールアドレスがjohn@myserver.dom の場合、http://myserver.dom/~john/ freebusy.vfb というURL を使ってアカウントJohn のフリー/ ビジー情報が取り出されます。
注意: 上記の［Search］ フィールドのURL は、CommuniGate Pro サーバーのWebUser インターフェ イスの接続ポートが80 のときにだけ有効です。WebUser インターフェイスのポートが8100 （デフォ ルト） または非標準ポートの場合、［Search］ フィールドには、そのポートを指定しなければなりま せん。例えば、次のようになります（8100 の場合）。このURL は、同一のCommuniGate Pro サーバー（単一のドメイン） のユーザーにだけ有効です。
［Search］ フィールドのURL を使って、別のCommuniGate Pro サーバーのユーザー（ リモートユー ザー） のフリー/ ビジー情報を取り出すこともできます。その場合、［Search］ フィールドのURL を 上書きし、リモートユーザーのフリー/ ビジー情報ファイルにアクセスできるように設定しなければ なりません。この上書き（ リモートユーザーのフリー/ ビジー情報ファイルへのパスの指定） を行う 場合、そのユーザーのコンタクト（連絡先） レコードを作成した後、［Details］ タブを選択します。 続いて、このタブの［Internet Free-Busy Address］ フィールドにフリー/ ビジー情報ファイルのURL を入力します。なお、この設定については、詳しくはMicrosoft Outlook のマニュアルを参照してく ださい。
オフラインモードの場合、CommuniGate Pro サーバーに格納されているメッセージにはアクセスは行 われません。この場合、MAPI コネクタのローカルキャッシュに置かれているメッセージだけを使っ て作業を行うことになります。そのため、作業に必要なメッセージをローカルキャッシュに格納して おく必要があります。ローカルキャッシュには、メールボックス単位でメッセージを格納できます。 以下、ローカルキャッシュに関する設定について説明します。
Outlook の［Tools］ メニューから［Options］ オプションを選択し、［Options］ ダイアログボックスを 開きます。続いて、［CommuniGate Pro］ タブをクリックします。
オフラインモードで作業するときに使用するフォルダを選択します。選択後、［Download］ オプショ ンを使って、メッセージ全体を取り出すか、またはメッセージの一部を取り出すかを指定します。 ［Entire Message］ ラジオボタンを選択しておくと、メッセージ全体が取り出されます。この場合、左 側のリストのフォルダ名が太字で表示されます。［Header Only］ ラジオボタンを選択しておくと、 メッセージのヘッダだけが取り出されます。この場合、フォルダ名は太字にはなりません。
続いて、Outlook の［Tools］ メニューの［CommuniGate Pro Server］ サブメニューを使って、オフラ インモードの場合の同期に関する設定を行います。
［CommuniGate Pro Server］ サブメニューでは、同期処理の種類として次のいずれかを指定できます。 ここで指定した処理が、送受信処理の開始されたときに実行されます。
MAPI コネクタは、サーバーサイドルールに対応しています。したがって、サーバーサイドルールを 作成し、そのルールをアカウントに送信されるメッセージに使用することもできます。
Outlook の［Tools］ メニューの［CommuniGate Pro Server］ サブメニューから［Server Side Rules］ オ プションを選択します。選択後、ルールエディタウィンドウが開きます。
新規のルールを作成する場合、［New］ ボタンをクリックします。作成されたルールには、条件とアク ションは何も定義されていません。
条件とアクションは、［Add］ ボタンを使って追加できます。
サーバーサイドルールの設定は、自動メール処理ルールと同じです。作成と設定については、詳しく は「自動処理ルール」のセクションを参照してください。
MAPI コネクタは、ユーザーWebMail （WebUser インターフェイス） 設定をもとに動作します。その ため、MAPI アプリケーション（Microsoft Outlook など） とWebUser インターフェイスでは、特殊 メールボックス（送信済み、書きかけ、メモ、ゴミ箱、コンタクト/ 連絡先、カレンダー、タスクな ど） の名前は同じものが使われます。その結果、MAPI アプリケーションとWebUser インターフェイ スでは両方とも、削除されたメッセージはゴミ箱メールボックス（Trash またはDeleted） に格納さ れます。また、メインカレンダー（Main Calendar） も同じものが使用されます。
MAPI コネクタではまた、トレーラーの設定としてユーザードメインメールトレーラー（Domain Mail Trailer） 設定が使われます。MAPI コネクタを介して送信されるテキストメッセージのうち、非暗号 化で、かつ署名のないテキストメッセージにはすべて、この設定の内容が追加されます。
［Account Settings］ パネルで指定されている値もWebUser インターフェイス設定に格納されます。し たがって、WebUser インターフェイスとMAPI コネクタ（MAPI セッション） ではどちらも、From:、 Reply-To:、Organization の各フィールドの値は同じです。
MAPI コネクタを使用することで、Outlook ユーザーはCommuniGate Pro サーバーのリアルタイム （VoIP など） 機能を利用できるようになります。
例えば、Outlook ユーザーは、コンタクト（連絡先） に登録されている電話番号を使って電話をかけ ることができます。方法は簡単です。コンタクトデータを右クリックするとポップアップメニューが 表示されますので、［Call using CommuniGate Pro］ を選択するだけです。
そのほか、［Tools］ メニューの［CommuniGate Pro Server］ サブメニューを使って電話をかけること もできます。
［CommuniGate Pro Server］ サブメニューの場合、ダイアログが表示され、そこに相手の名前と電話番 号が表示されます。
［Start Call］ ボタンをクリックすると、コールが開始されます。同時に、SIP デバイス（複数あると きは全部） が動作を開始し、音が鳴ります。SIP デバイス（電話機） をとると、選択した電話番号に コールが実行されます。
ダイアログボックスの下部には、そのコールの状態が表示されます。
MAPI コネクタを使用している場合、サーバーワイドルールの使用が可能です。例えば、サーバーワ イドルールを使って受信メッセージを暗号化形式で保存するという操作が可能です。
また、サーバー上でクリアテキストで受信、保存されるメッセージのセキュリティを強化することも できます。
この操作を行いたい場合、Outlook 上でメッセージを選択し、右クリックします。ポップアップメ ニューが開きます。
ポップアップメニューで［Encrypt Message］ オプションを選択します。これで、MAPI コネクタから ユーザーのデフォルトの証明書（ユーザーの公開鍵が格納されています） がCommuniGate Pro サー バーに送信されます。送信後、その証明書を使って、このメッセージが暗号化されます。暗号化され たメッセージは、暗号化S/MIME 形式でCommuniGate Pro サーバーに保存されます。つまり、その メッセージが暗号化されて送られてきたのと同じです。
暗号化S/MIME 形式でCommuniGate Pro サーバーに保存されているメッセージは、MAPI クライアン ト（Outlook） で読むこともできますし、WebUser インターフェイスを使って読むこともできます。 ただし、その場合、Windows システムとWebUser インターフェイスの両方に同じ秘密鍵と証明書が インストールされていることが必要です。これは、WebUser インターフェイスで秘密鍵と証明書を 作成し、その秘密鍵と証明書をWindows システムにエクスポートすることで可能です。または、 Windows システムからエクスポートし、WebUser インターフェイスにインポートするという方法もあ ります。
MAPI コネクタは、MAPI アプリケーション（Microsoft Outlook） とCommuniGate Pro サーバーの間の 「仲介役」として動作します。問題が発生した場合、その原因は、クライアントアプリケーションにバ グがあるか、または、MAPI コネクタもしくはサーバーソフトウェアに問題があるかのいずれかです。 MAPI コネクタに問題があると思われるときには、その処理の詳細なログをとり、チェックすること ができます。このログは、必要であればStalker 社のテクニカルサポートに送付していただいても結構 です。
処理のログ記録など、MAPI コネクタ（CommuniGate Pro Service） のトラブルシューティングに関す る設定はMAPI コネクタの［Troubleshooting］ パネルで行えます。
MAPI コネクタソフトウェアは、基本的にスターターコードライブラリとサーバーコードライブラリ という2 つのコンポーネントで構成されています。スターターコードライブラリはデスクトップコン ピュータにあり、サーバーコマンドライブラリはCommuniGate Pro サーバーから取り出されて使用さ れます。［Troubleshooting］ パネルでは、この両方のコンポーネントに関する設定が可能です。
MAPI コネクタによるログ記録を有効にしたい場合、［Enable Logging］ オプションを選択します。 ［Maximum Log File Size］ オプションには、MAPI コネクタログファイルの最大サイズを指定します。こ のサイズの範囲で、直前のレコードが記録されます。
［Enable Logging］ オプションの下にある各チェックボックスを使って、MAPI コネクタのコンポーネン トの処理または機能を指定できます。ここで指定した処理や機能について、ログが記録されます。
［Show Me Log File］ ボタンをクリックすると、ファイルディレクトリウィンドウが開きます。このディ レクトリにログファイルが格納されます。このログファイルを電子メールでStalker 社のテクニカルサ ポートに送信することもできます。
ログファイルを削除する場合、［Delete Log File］ ボタンをクリックします。
［Compatibility］の下の各チェックボックスを使って、MAPI コネクタの互換性に関する設定を行えます。MAPI コネクタで使用されるプロトコルとAPI は、Microsoft から提供されているAPI を除き、インター ネット標準ではありません。こうしたAPI は、まだ洗練度が低いため、クライアント（Outlook） の機 能の中にはMAPI コネクタで実現できていない機能もあります。Stalker Software では、こういった問 題について研究しており、MAPI コネクタのアップデートも定期的に提供しています。
Stalker Software では、現在判明している問題やユーザーから報告された問題をKnown MAPI Problems サイトで公開しており、更新情報も紹介してあります。MAPI コネクタの機能に関して何か問題が あった場合、まず、このサイトをチェックしてください。