Sun Java System Instant Messaging 7.2 管理ガイド

Instant Messenger のカスタマイズ

Instant Messenger は、カスタマイズ可能です。個々の組織の要求に応じて、HTML ファイルや JNLP ファイルをカスタマイズできます。リソースファイルの配備をカスタマイズする場合は、configure ユーティリティーを実行し (インストール後に実行していない場合)、ファイルのカスタマイズをしてから、再度リソースファイルを配備してください。configure によって、カスタマイズ可能なファイルの一部が作成されるので、最初に configure ユーティリティーを実行する必要があります。再配備の方法については、「リソースファイルの再配備」を参照してください。

ユーザー要件に応じて Instant Messenger をカスタマイズする方法としては、次のものがあります。

この節では、Instant Messenger のカスタマイズのために変更可能な Instant Messaging サーバーファイルについて説明します。カスタマイズ可能なファイルはすべて、リソースディレクトリである im-svr-base/html ディレクトリに格納されています。デフォルトのディレクトリの場所については、表 3–1 を参照してください。

Instant Messenger のリソースファイル

Instant Messenger リソースファイルは、リソースディレクトリ (im-svr-base/html) と呼ばれるディレクトリ内に格納されます。

表 15–1 に、リソースディレクトリ (im-svr-base/html) 内の Instant Messenger ファイルの一覧を示します。この表には、これらのファイルの説明とカスタマイズ情報も含まれています。リソースディレクトリ内には、ディレクトリパス内で一般的に「lang」と表現される /locale サブディレクトリが存在しています。実際には、en_USjafr_FR といった、各言語の略語として表現されます。

表 15–1 im-svr-base/html 内の Instant Messenger リソースファイル

ファイル 

説明 

カスタマイズ可能か 

lang/im.html

Java プラグイン版の Instant Messenger を起動するための初期ページです。 

可能 

im.html.template

im.html のテンプレート版です。

不可能。 

このファイルは、インストールプログラムによる im.html ファイル生成時に使用されます。

imdesktop.jar

im.html ファイルまたは im.jnlp ファイルによってダウンロードされるクライアント .jar ファイルです。

不可能 

lang/im.jnlp

Java Web Start 版の Instant Messenger を起動するために使用される .jnlp ファイルです。

可能 

im.jnlp.template

im.jnlp のテンプレート版です。

不可能 

imjni.jar

im.html ファイルまたは im.jnlp ファイルによってダウンロードされるクライアント .jar ファイルです。

不可能 

messenger.jar

im.html ファイルまたは im.jnlp ファイルによってダウンロードされるメインクライアント .jar ファイルです。

不可能 

icalendar.jar

カレンダリマインダの処理時に使用される icalendar パーサーです。

不可能 

imnet.jar

im.html ファイルまたは im.jnlp ファイルによってダウンロードされるクライアント .jar ファイルです。

不可能 

lang/imbrand.jar

このファイルには、カスタマイズ可能なプロパティー、スタイルシート、イメージ、背景、音声の各ファイルが含まれています。 

可能 

lang/imssl.html

Java プラグイン版の Instant Messenger を起動するための初期ページです。クライアントとマルチプレクサ間で従来の SSL を実行する場合に使用されます。このファイルは、TLS を介したクライアントとサーバー間の安全な通信には使用しないでください。

可能 

lang/imssl.jnlp

Java Web Start 版の Instant Messenger を起動するためのファイルです。このファイルは、クライアントとマルチプレクサ間で SSL を実行する場合に使用されます。 

可能 

jnlpLaunch.jsp

このファイルを使うと、Sun JavaTM System Access Manager にすでにログインしているエンドユーザーが、シングルサインオンと Java Web Start による Instant Messenger の起動を行うことができます。

可能 

pluginLaunch.jsp

このファイルを使うと、Sun Java System Access Manager にすでにログインしているエンドユーザーが、シングルサインオンと Java プラグインによる Instant Messenger の起動を行うことができます。 

可能 

index.html

LDAP 配備用のスプラッシュ (初期) ページです。im.htmlim.jnlp へのリンクが含まれているほか、windows.htmsolaris.htm、および quickref.htm へのマニュアルリンクも含まれています。このページはサイトの要件に応じてカスタマイズ可能です。

可能 

index.html.template

index.html のテンプレート版です。

不可能 

lang/imhelp/SunONE.jpg

quickref.htmsolaris.htm、および windows.htm によって使用されるイメージです。

置換可能。ただし変更は不可能 

quickref.html

solaris.html

windows.html

lang/imhelp/ 内に格納されたこれらのファイルには、Instant Messenger の入門レベルのマニュアルが含まれています。

可能 

lang/imhelp

Instant Messenger のオンラインヘルプディレクトリです。 

不可能 

imwebex.jar

 

 

msgrinstall.jar

 

 

index.html ファイルと im.html ファイルのカスタマイズ

Sun Java System Access Manager なしの配備で Instant Messenger を使用している場合、index.html ファイルと im.html ファイルの「静的な」部分を変更することで、完全にカスタマイズされたユーザーインタフェースを実現できます。これらの HTML ファイルには、テキストと、それらのテキストの書式や処理方法を記述したマークアップの両方が含まれています。マークアップは一連のタグを使って実装されており、それらのタグは、ヘッダ、インデント、フォントサイズ、およびフォントスタイルに対する書式を指定しています。

変更可能なページ要素のいくつかを、次に示します。

index.html から、Instant Messenger のアプレットと Java Web Start アプリケーションを起動できます。Instant Messenger アプレットを実行する場合は、im.html ファイルを変更してください。im.html ファイルは、index.html から呼び出され、Instant Messenger のアプレットを起動します。im.html ファイルは、configure ユーティリティーの実行時に生成されます。また、このファイルには、マルチプレクサを指し示すアプレット引数が含まれています。


注 –

im.html ファイル内の引数「<PARAM NAME="server" VALUE="servername"> 」は、Instant Messaging のマルチプレクサとそのポートを表しています。iim_mux.listenport パラメータのデフォルト値を変更した場合、値 servernamehost.domain :port に変更する必要があります。


Sun Java System Access Manager SSO による Instant Messenger の起動

Instant Messenger クライアントを Sun Java System Access Manager によるシングルサインオン (SSO) を使って起動するには、IMLaunch.jsp を使用します。このファイルは、リソースディレクトリ内に格納されています。

Sun Java System Access Manager および Instant Messenger を同じ Web コンテナを使用するように設定して SSO を有効にする必要があります。

Instant Messenger を起動するには、ブラウザに次のように入力します。


codebase/IMLaunch.jsp?server=multiplexor-hostname:muliplexor-port

または


codebase/IMLaunch.jsp?server=www.example.com:5222

ここで、

codebase は、Instant Messenger リソースのダウンロード元のコードベースです。たとえば、http://www.example.com などです。

multiplexor-hostname は、マルチプレクサのホスト名です。たとえば、http://www.company22.com などです。

muliplexor-port は、マルチプレクサがクライアントから受信する要求を待機するポートの番号です。たとえば、5222 などです。

IMLaunch.jsp は、Java Web Start または Java プラグインを使って Instant Messenger を起動するときに使用されます。

アプリケーションのカスタマイズ (Java Web Start)

Java Web Start を使って Instant Messenger を実行する場合、im.jnlpimres.jnlpimres.jar の各ファイルを変更することで、ユーザーインタフェースをカスタマイズできます。これらのファイルに対して行うことができる変更を次に示します。


例 15–1 im.jnlp ファイルのサンプル


<?xml version="1.0" encoding="utf-8"?>
<!-- Instant Messenger -->
<jnlp
  spec="1.0+"
  codebase="http://im.i-zed.com:80/im"
  href="en/im.jnlp">
  <information>
    <title>Instant Messaging</title>
    <vendor>I-Zed.com</vendor>
    <homepage href="http://www.I-zed.com/"/>
    <description>I-Zed’s Sun Java System Instant Messenger</description>
    <description kind="short">Instant Messenger</description>
    <icon href="CompanyLogo.gif"/>
    <offline-allowed/>
  </information>
  <security>
    <all-permissions/>
  </security>
  <resources>
    <j2se version="1.3+">
      <resources>
        <jar href="en/imres.jar"/>
        <jar href="en/imbrand.jar"/>
      </resources>
    </j2se>
    <jar href="messenger.jar"/>
    <jar href="imdesktop.jar"/>
    <jar href="imnet.jar"/>
    <jar href="icalendar.jar"/>
    <nativelib href="imjni.jar"/>
  </resources>
  <application-desc main-class="com.iplanet.im.client.iIM">
    <argument>server=im.i-zed.com:45222</argument>
    <argument>help_codebase=http://im.i-zed.com:80/im/en</argument>
  </application-desc>
</jnlp>


注 –

im.jnlp ファイル内の引数 <argument> servername</argument> は、Instant Messaging マルチプレクサのホストとポートを表しています。iim_mux.listenport パラメータのデフォルト値を変更した場合、servernamehost.domain :port に変更する必要があります。


imbrand.jar の内容

この節に記載されている表は、imbrand.jar ファイル内のファイルを一覧に示し、各ファイルの説明を可能なかぎりまとめたものです。imbrand.jar ファイル内に含まれるイメージファイルと音声ファイルを使えば、Instant Messenger の外観をカスタマイズすることもできます。この節には、次の表が記載されています。

表 15–2 設定ファイル

ファイル 

説明 

brand.properties

 

chat-styles.css

 

bgstyles.properties

背景セットの拡張に使用する背景設定ファイルです。 

表 15–3 絵文字

ファイル名 

説明 

emo_alarm.png

警戒の感情を視覚的に表現します 

emo_angel.png

天使のような感情を視覚的に表現します 

emo_angry.png

怒りの感情を視覚的に表現します 

emo_balloons.png

風船の束を視覚的に表現します 

emo_beermug.png

ビアマグを視覚的に表現します 

emo_cake.png

バースデーケーキを視覚的に表現します 

emo_calendar.png

カレンダを視覚的に表現します 

emo_canworms.png

厄介な表情を視覚的に表現します 

emo_clown.png

ピエロの顔を視覚的に表現します 

emo_cool.png

クールな感情を視覚的に表現します 

emo_dead.png

まいった表情を視覚的に表現します 

emo_devil.png

悪魔のような感情を視覚的に表現します 

emo_dont-tell.png

秘密にしてもらいたい感情を視覚的に表現します 

emo_embarrassed.png

恥ずかしい感情を視覚的に表現します 

emo_exclamation.png

感嘆符を視覚的に表現します 

emo_flower.png

花を視覚的に表現します 

emo_ghost.png

幽霊を視覚的に表現します 

emo_goldstar.png

ゴールドスターを視覚的に表現します 

emo_grin.png

ニヤッとした感情を視覚的に表現します 

emo_kiss.png

キスを視覚的に表現します 

emo_laughing.png

笑いの感情を視覚的に表現します 

emo_lifepreserver.png

救助を視覚的に表現します 

emo_lightning.png

雷雲と稲妻を視覚的に表現します 

emo_lovestruck.png

愛情を視覚的に表現します 

emo_martini.png

マティーニのグラスを視覚的に表現します 

emo_money.png

山積みのコインを視覚的に表現します 

emo_musicnote.png

音符を視覚的に表現します 

emo_nerd.png

おたくを視覚的に表現します 

emo_nottalking.png

そっぽを向いた様子を視覚的に表現します 

emo_phone.png

受話器を視覚的に表現します 

emo_present.png

贈り物を視覚的に表現します 

emo_psychoknife.png

ナイフを視覚的に表現します 

emo_rathole.png

怪しい様子を視覚的に表現します 

emo_sad.png

悲しい感情を視覚的に表現します 

emo_sick.png

病気を視覚的に表現します 

emo_sleep.png

眠たい様子を視覚的に表現します 

emo_smiley.png

スマイルを視覚的に表現します 

emo_straightfaced.png

無表情な人物を視覚的に表現します 

emo_sunshining.png

太陽を視覚的に表現します 

emo_surprised.png

驚いた様子を視覚的に表現します 

emo_tongue-out.png

舌を出している人物を視覚的に表現します 

emo_violin.png

バイオリンを視覚的に表現します 

emo_whatever.png

無関心や軽視の様子を視覚的に表現します 

表 15–4 アプリケーションアイコン – Microsoft Windows

ファイル名 

説明 

im_app_icon_16.png

Microsoft Windows タイトルバーのアイコンです 

im_app_icon_24.png

Microsoft Windows タイトルバーのアイコンです 

tray_icon.ico

Microsoft Windows システムトレイのアイコンです 

表 15–5 アプリケーションアイコン – すべてのプラットフォーム

ファイル名 

説明 

logo_login_footer.png

「ログイン」ダイアログボックスの最下部に表示されるロゴです 

logo_register.png

「登録」ダイアログボックスに表示されるロゴです 

logo_sun.png

「ログイン」ダイアログボックスに表示される Sun のロゴです 

表 15–6 ツールバーアイコン

ファイル名 

説明 

tb_addcontacts.png

「連絡先を追加」ボタンのグラフィックです 

tb_alert.png

「アラートを送信」ボタンのグラフィックです 

tb_chat.png

「チャット」ボタンのグラフィックです 

tb_conf.png

「会議室を追加」ボタンのグラフィックです 

表 15–7 連絡先一覧アイコン

ファイル名 

説明 

cl_folder_closed.png

閉じられているフォルダを視覚的に表現します 

cl_folder_open.png

開かれているフォルダを視覚的に表現します 

表 15–8 Presence アイコン: 連絡先一覧

ファイル名 

説明 

cl_activeconf.png

連絡先一覧の会議室で利用中のものを示すアイコンです 

cl_away.png

連絡先一覧で不在ステータスを示すアイコンです 

cl_dnd.png

 

cl_idle.png

連絡先一覧でアイドルステータスを示すアイコンです 

cl_inactiveconf.png

連絡先一覧の会議室で未使用のものを示すアイコンです 

cl_offline.png

連絡先一覧でオフラインステータスを示すアイコンです 

cl_online.png

連絡先一覧でオンラインステータスを示すアイコンです 

cl_pending.png

連絡先一覧で保留中ステータスを示すアイコンです 

表 15–9 Presence アイコン: ステータスバー

ファイル名 

説明 

sb_away.png

ステータスバーで不在ステータスを示すアイコンです 

sb_dnd.png

 

sb_idle.png

ステータスバーでアイドルステータスを示すアイコンです 

sb_offline.png

ステータスバーでオフラインステータスを示すアイコンです 

sb_online.png

ステータスバーでオンラインステータスを示すアイコンです 

表 15–10 パレットの背景と背景スウォッチ

bgplt_tex_blue.gif

bgplt_tex_brown.gif

bgplt_tex_bubble_blue.gif

bgplt_tex_bubble_brown.gif

bgplt_tex_bubble_green.gif

bgplt_tex_bubble_grey.gif

bgplt_tex_bubble_orange.gif

bgplt_tex_bubble_purple.gif

bgplt_tex_bubble_ruby.gif

bgplt_tex_crackle_blue.gif

bgplt_tex_crackle_green1.gif

bgplt_tex_crackle_grey.gif

bgplt_tex_crackle_olive.gif

bgplt_tex_crackle_orange.gif

bgplt_tex_crackle_purple.gif

bgplt_tex_crackle_ruby.gif

bgplt_tex_gradation_blue.gif

bgplt_tex_gradation_brown.gif

bgplt_tex_gradation_green.gif

bgplt_tex_gradation_grey.gif

bgplt_tex_gradation_orange.gif

bgplt_tex_gradation_purple.gif

bgplt_tex_gradation_ruby.gif

bgplt_tex_green.gif

bgplt_tex_orange.gif

bgplt_tex_pink.gif

bgplt_tex_purple.gif

bgplt_tex_weave_blue.gif

bgplt_tex_weave_brown.gif

bgplt_tex_weave_green.gif

bgplt_tex_weave_grey.gif

bgplt_tex_weave_orange.gif

bgplt_tex_weave_purple.gif

bgplt_tex_weave_ruby.gif

bgplt_tex_white.gif

bg_tex_bubble_blue.gif

bg_tex_bubble_brown.gif

bg_tex_bubble_green.gif

bg_tex_bubble_grey.gif

bg_tex_bubble_orange.gif

bg_tex_bubble_purple.gif

bg_tex_bubble_ruby.gif

bg_tex_crackle_blue.gif

bg_tex_crackle_green1.gif

bg_tex_crackle_grey.gif

bg_tex_crackle_olive.gif

bg_tex_crackle_orange.gif

bg_tex_crackle_purple.gif

bg_tex_crackle_ruby.gif

bg_tex_gradation_blue.gif

bg_tex_gradation_brown.gif

bg_tex_gradation_green.gif

bg_tex_gradation_grey.gif

bg_tex_gradation_orange.gif

bg_tex_gradation_purple.gif

bg_tex_gradation_ruby.gif

bg_tex_weave_blue.gif

bg_tex_weave_brown.gif

bg_tex_weave_green.gif

bg_tex_weave_grey.gif

bg_tex_weave_orange.gif

bg_tex_weave_purple.gif

bg_tex_weave_ruby.gif

表 15–11 サウンド

ファイル名 

説明 

alert.wav

アラートサウンドです 

alerttpc.wav

アラートサウンドです 

away.wav

ステータスを不在に変更する際のサウンドです 

receive.wav

メッセージを受信する際のサウンドです 

send.wav

メッセージを送信する際のサウンドです 

soundoff.wav

サウンドを無効にする際のサウンドです 

soundon.wav

サウンドを有効にする際のサウンドです 

Instant Messenger の外観のカスタマイズ

imbrand.jar ファイルには、Instant Messenger のルック & フィール (見た目と操作感) を制御するすべてのイメージとプロパティーが含まれています。Instant Messenger の外観をカスタマイズするには、imbrand.jar ファイル内のイメージとプロパティーを変更します。

ProcedureInstant Messenger の外観をカスタマイズする

  1. imbrand.jar ファイルを作業用ディレクトリにコピーします。

    たとえば、次のように入力します。


    cp im-svr-base/html/lang/imbrand.jar working-directory
    
  2. 作業用ディレクトリに移動します。


    cd working-directory 
    
  3. imbrand.jar ファイルを解凍します。


    jar xf imbrand.jar
    

    このコマンドを実行すると、ディレクトリツリーが作成され、そこにリソースファイルがコピーされます。imbrand.jar ファイル内の個々のファイルを変更する場合、このディレクトリ構造を保持する必要があります。

    また、imbrand.jar 内のファイルを個別に解凍し、指定したディレクトリ構造の中に格納することもできます。たとえば、brand.properties だけを解凍するには、次のコマンドを使用します。


    jar xf imbrand.jar com/sun/im/desktop/brand/brand.properties
    
  4. 変更された .gif.wav、および .properties の各ファイルを imbrand.jar に反映します。

    imbrand.jar 内のすべてのファイルを反映するには、次のコマンドを使用します。

    jar cf imbrand.jar .

    変更されたファイルを個別に imbrand.jar に反映するには、次のコマンドを使用します。


    jar uf imbrand.jar com/sun/im/desktop/brand/filename
    

    filenameimbrand.jar 内のファイル名です。たとえば、brand.properties などです。

  5. imbrand.jar をリソースディレクトリにコピーします。

    たとえば、次のように入力します。


    cp imbrand.jar im-svr-base/html/lang/ .
    

    注 –

    現在の配備で複数のロケールをサポートしている場合、Instant Messenger の外観のカスタマイズ手順を、それらのロケールごとに実行してください。


ユーザー名およびグループ名表示のカスタマイズ

連絡先の名前の表示に使用される属性を変更して、Instant Messenger による連絡先の名前およびグループ名の表示方法をカスタマイズできます。デフォルトでは、Instant Messenger は、属性 cn を使用してユーザーの表示名を表します。現在の配備で、cn の代わりに uid またはそのほかの属性を使用することもできます。

連絡先の名前は、First Name Last Name として表示されます。たとえば、Frank SmithMary Jones のようになります。まったく同じ氏名を持つエンドユーザーが 2 人いた場合、どちらのエンドユーザーを連絡先一覧に追加すればよいか、判断がつきません。連絡先を区別できるように、Instant Messenger のユーザー検索結果内や連絡先ツールヒント内に追加情報が表示されるようにカスタマイズすることが可能です。たとえば、ある連絡先の上にマウスを置いたときに、その連絡先の電話番号が表示されるようにすることができます。

Procedureユーザー名の表示に使用される属性を変更する

  1. iim.conf を開きます。

    iim.conf の場所、およびこのファイルを変更する手順については、iim.conf ファイルの構文」を参照してください。

  2. ユーザー名の表示に使用する属性を、iim_ldap.userdisplay の値として指定します。

    たとえば、nickname 属性を使用するには、iim_ldap.userdisplay 属性を次のように設定します。

    iim_ldap.userdisplay=nickname

  3. ファイルを保存して閉じます。

Procedureグループ名の表示に使用される属性を変更する

  1. iim.conf を開きます。

    iim.conf の場所、およびこのファイルを変更する手順については、iim.conf ファイルの構文」を参照してください。

  2. グループ名の表示に使用する属性を、iim_ldap.groupdisplay の値として指定します。

    たとえば、uid 属性を使用するには、iim_ldap.groupdisplay 属性を次のように設定します。

    iim_ldap.groupdisplay=uid

    ファイルを保存して閉じます。

Procedure検索結果でのユーザー名表示をカスタマイズする

  1. imbrand.jar からファイルを解凍します。

    imbrand.jar のデフォルトの場所については、表 15–1 を参照してください。

  2. 次のディレクトリに移動します。

    com/sun/im/client/

  3. brand.properties を開きます。

  4. そのファイル内に dialogs.searchresults.format 属性を追加します。

  5. 検索結果に含める属性を次の形式で追加します。

    ${attr:attribute-name }

    attribute-name は LDAP 属性の名前です。

    たとえば、title 属性を含めるには、次の行を追加します。

    dialogs.searchresults.format=(${attr:title})

  6. 変更を保存してファイルを閉じます。

  7. imbrand.jar を再パッケージします。

  8. iim.conf にユーザー属性を追加します。

    iim_ldap.userattributes パラメータの値として属性を指定します。複数の属性はコンマで区切ります。たとえば、次のように入力します。

    iim_ldap.userattributes=title,department,telephonenumber

    iim.conf の場所、およびこのファイルを変更する手順については、iim.conf ファイルの構文」を参照してください。

Procedureツールヒントの内容をカスタマイズする

  1. imbrand.jar からファイルを解凍します。

    imbrand.jar のデフォルトの場所については、表 15–1 を参照してください。

  2. 次のディレクトリに移動します。

    com/sun/im/client/

  3. brand.properties を開きます。

  4. そのファイル内に contact.tooltip.format.html 属性を追加します。

  5. ツールヒント内に表示する属性を、contact.tooltip.format.html の値として指定します。

    たとえば、連絡先の電話番号および電子メールアドレスを表示する場合は、次のように入力します。

    contact.tooltip.format.html=mailto: ${attr:mail} tel: ${attr:telephonenumber}

    imbrand.jar ファイルのカスタマイズの詳細については、「アプリケーションのカスタマイズ (Java Web Start)」を参照してください。

  6. 変更を保存してファイルを閉じます。

  7. imbrand.jar を再パッケージします。