Sun Java System Instant Messaging 7.2 管理指南

自訂 Instant Messenger

Instant Messenger 可自訂。HTML 和 JNLP 檔案可自訂以符合組織的特定需求。如果您要為您的部署自訂資源檔案，您應執行 configure 公用程式 (如果您安裝後尚未執行)、自訂檔案，然後重新部署資源檔案。您必須先執行 configure 公用程式，因為 configure 會建立部份您可自訂的檔案。(如需重新部署的說明，請參閱重新部署資源檔案。)

您可以下列方式自訂 Instant Messenger 以符合您的需求：

本節說明如何修改 Instant Messaging 伺服器檔案來自訂 Instant Messenger。您可自訂的檔案均位於資源目錄 im-svr-base/html 目錄中。如需預設目錄位置的詳細資訊，請參閱表 3–1。

Instant Messenger 資源檔案

Instant Messenger 資源檔案位於稱做資源目錄或 im-svr-base/html 的目錄中。

表 15–1 包含資源目錄中 Instant Messenger 檔案的清單 (im-svr-base/html)。其中也包含這些檔案的說明與自訂資訊。在資源目錄中，/locale 子目錄在目錄路徑中一般表示為 lang，但是有可能特別表示為語言縮寫，例如 en_US、jp 與 fr_FR。

表 15–1 im-svr-base/html 中的 Instant Messenger 資源檔案


檔案	說明	是否可自訂？
`lang/im.html`	啟動 Instant Messenger Java Plug-In 版本的初始頁面。	是
`im.html.template`	`im.html` 的範本版本。	否。這個檔案由安裝程式所使用以產生 `im.html` 檔案。
`imdesktop.jar`	用戶端 `jar` 檔案，由 `im.html` 或 `im.jnlp` 檔案下載。	否
`lang/im.jnlp`	`.jnlp` 檔案用於啟動 Instant Messenger 的 Java Web Start 版。	是
`im.jnlp.template`	`im.jnlp` 的範本版本。	否
`imjni.jar`	用戶端 `jar` 檔案，由 `im.html` 或 `im.jnlp` 下載。	否
`messenger.jar`	要用戶端 `jar` 檔案，由 `im.html` 或 `im.jnlp` 下載。	否
`icalendar.jar`	`icalendar` 剖析器用於處理行事曆提醒。	否
`imnet.jar`	用戶端 `jar` 檔案，由 `im.html` 或 `im.jnlp` 下載。	否
`lang/imbrand.jar`	這個檔案包含可自訂的屬性、樣式表、影像、背景與聲訊檔案。	是
`lang/imssl.html`	啟動 Instant Messenger Java Plug-In 版本的初始頁面。用於在用戶端和多重訊號組合器之間執行舊有 SSL。不要使用此檔案透過 TLS 在用戶端和伺服器之間進行安全通訊。	是
`imssl.html.template`	`imssl.html` 的範本版本。	否
`lang/imssl.jnlp`	此檔案會啟動 Instant Messenger 的 Java Web Start 版本。此檔案用於在用戶端和多重訊號組合器之間執行 SSL。	是
`imssl.jnlp.template`	`imssl.jnlp` 的範本版本。	否
`jnlpLaunch.jsp`	如果一般使用者已登入 Sun Java^TM System Access Manager，此檔案可用於允許單次登入和使用 Java Web Start 啟動 Instant Messenger。	是
`pluginLaunch.jsp`	如果一般使用者已登入 Sun Java System Access Manager，此檔案可用於允許單次登入和使用 Java Plug-In 啟動 Instant Messenger。	是
`index.html`	LDAP 部署的軟體資訊頁面。它包含至 `im.html` 與 `im.jnlp` 的連結，與至 `windows.htm`、`solaris.htm` 與 `quickref.htm` 的文件連結。您可以為站點需求自訂此網頁。	是
`index.html.template`	`index.html` 的範本版本。	否
`lang/imhelp/SunONE.jpg`	由 `quickref.htm`、`solaris.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 applet 和 Java Web Start 應用程式。如果您正在執行 Instant Messenger applet，則需要修改 im.html 檔案。im.html 檔案由 index.html 呼叫，並呼叫 Instant Messenger applet。im.html 檔案會在您執行 configure 公用程式時產生，並包含指向多重訊號組合器的 applet 引數。

備註 –

引數“<PARAM NAME="server" VALUE="servername"> ”代表 im.html 檔案中的 Instant Messaging 多重訊號組合器及其連接埠。如果您變更 iim_mux.listenport 參數的預設值，則必須將 servername 的值變更為 host.domain :port。

使用 Sun Java System Access Manager SSO 啟動 Instant Messenger

若要透過 Sun Java System Access Manager 使用單次登入 (SSO) 來啟動 Instant Messenger，可使用 IMLaunch.jsp。這個檔案位於資源目錄中。

Sun Java System Access Manager 和 Instant Messenger 必須配置以使用相同的 Web 容器來啟用 SSO。

若要啟動 Instant Messenger，可在 Web 瀏覽器中輸入以下內容：

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 Plug-In 啟動 Instant Messenger。

自訂應用程式 (Java Web Start)

若您使用 Java Web Start 執行 Instant Messenger，則可以修改 im.jnlp、imres.jnlp 與 imres.jar 檔案以自訂使用者介面。下列為可以在這些檔案中進行的修改：

imbrand.jar - 此檔案包含影像與聲訊檔案，以及可自訂的屬性。您需要 Java Developers Kit 1.3 (JDK) 以使用 jar 指令從 imres.jar 檔案擷取內容。如需 imbrand.jar 內容的詳細資訊，請參閱imbrand.jar 的內容。

使用以下指令擷取 imbrand.jar：
jar xvf imbrand.jar
這個指令會建立複製資源檔案的目錄樹狀結構。當您在 .jar 檔案中修改個別檔案時，必須維護這個目錄的結構。

您可以取代 .gif 檔案或 .wav 檔案的版本，而不需變更檔案名稱，然後使用以下 jar 指令將已變更的檔案置回目錄：
jar -uf imbrand.jar com/Sun/im/client/images/*.gif
這個指令會使用已修改的 .gif 檔案更新 imbrand.jar 檔案。相同的可能性也會發生於聲訊檔案 (.wav 檔案)。
im.jnlp - 這個檔案可以呼叫 Instant Messenger 應用程式的 Java Web Start 版本。您可以修改檔案中的程式碼庫、標題、供應商和說明。

範例 15–1 顯示含有可採用粗體類型自訂 HTML 編碼的 im.jnlp 檔案。

範例 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 參數的預設值，則必須將 servername 的值變更為 host.domain :port。

`imbrand.jar` 的內容

本章節中的表格列出 imbrand.jar 檔案中的檔案，並提供每個檔案的說明 (若有的話)。imbrand.jar 檔案也包含您可用來更名 Instant Messenger 的影像和音訊檔案。本章節包含以下表格：

表 15–2 – 配置用於配置 Instant Messenger 的檔案。
表 15–3 – 聊天階段作業時可使用的表情圖案。
表 15–4 – Windows 應用程式使用的圖示。
表 15–5 – 所有平台上的應用程式使用的圖示。
表 15–6 – 工具列中使用的圖示。
表 15–7 – 連絡人清單中使用的圖示。
表 15–8 – 連絡人清單描述線上狀態資訊的圖示。
表 15–9 – 狀態列中用於描述線上狀態資訊的圖示。
表 15–10 – 可用的背景。
表 15–11 – 用來表示警示和狀態或配置變更的聲音。

表 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 應用程式圖示 – Windows


檔案名稱	說明
`im_app_icon_16.png`	Windows 的標題列圖示
`im_app_icon_24.png`	Windows 的標題列圖示
`tray_icon.ico`	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 線上狀態圖示 - 連絡人清單


檔案名稱	說明
`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 線上狀態圖示 - 狀態列


檔案名稱	說明
`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 外觀與感覺的影像與屬性。您可以透過修改 imbrand.jar 中的影像和特性，來自訂 Instant Messenger 的外觀。

更名 Instant Messenger

將 imbrand.jar 檔案複製到作業目錄。

例如：

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

變更為作業目錄。
cd working-directory

擷取 imbrand.jar 檔案。
jar xf imbrand.jar
這個指令會建立複製資源檔案的目錄樹狀結構。當您在 jar 檔案中修改個別檔案時，必須維護這個目錄結構。

或者，您可以擷取 imbrand.jar 中包含的單個檔案並放置在您指定的目錄結構下。例如，若僅擷取 brand.properties，請使用下列指令：
jar xf imbrand.jar com/sun/im/desktop/brand/brand.properties

使用已修改的 .gif 、.wav 和 .properties 檔案更新 imbrand.jar 檔案。

您可以更新 imbrand.jar 中的所有檔案，如下所示：

jar cf imbrand.jar .

若要使用單個已修改的檔案來更新 imbrand.jar 檔案，請使用下列指令：
jar uf imbrand.jar com/sun/im/desktop/brand/filename
其中，filename 是 imbrand.jar 中所包含檔案的名稱，例如 brand.properties。

將 imbrand.jar 複製到資源目錄。

例如：
cp imbrand.jar im-svr-base/html/lang/ .
備註 –
如果您支援部署中的多個語言環境，請按照程序為每個支援的語言環境更名 Instant Messenger。

自訂使用者名稱和群組名稱顯示

您可以透過變更用來顯示連絡人名稱的屬性，來自訂 Instant Messenger 顯示連絡人和群組名稱的方式。根據預設，Instant Messenger 使用屬性 cn 來代表使用者的顯示名稱。在您的部署中，您可能喜好使用 uid 或是其他屬性，而不使用 cn。

連絡人名稱會顯示為名字、姓氏。例如，Frank Smith、Mary Jones 等等。當有兩位一般使用者擁有相同的名與姓時，將不可能知道要將哪位一般使用者新增至連絡人清單。您可以自訂 Instant Messenger 在使用者搜尋的搜尋結果中顯示詳細資訊，並在 [聯絡人] 工具提示中顯示額外的資訊，以協助區分連絡人。例如，您可以在滑鼠置於連絡人之上時顯示連絡人的電話號碼：

變更用於顯示使用者名稱的屬性

開啟 iim.conf。

如需找到並修改 iim.conf 的說明，請參閱iim.conf 檔案語法。

指定一個屬性，用來將使用者名稱顯示成 iim_ldap.userdisplay 的值。

例如，若要使用 nickname 屬性，可如下設定 iim_ldap.userdisplay 屬性：

iim_ldap.userdisplay=nickname

儲存並關閉檔案。

變更用於顯示群組名稱的屬性

開啟 iim.conf。

如需找到並修改 iim.conf 的說明，請參閱iim.conf 檔案語法。

指定一個屬性，用來將使用者名稱顯示成 iim_ldap.groupdisplay 的值。

例如，若要使用 uid 屬性，可如下設定 iim_ldap.groupdisplay 屬性：

iim_ldap.groupdisplay=uid

儲存並關閉檔案。

在搜尋結果中自訂使用者名稱顯示

自 imbrand.jar 擷取檔案。

如需 imbrand.jar 的預設位置，請參閱表 15–1。

變更以下目錄：

com/sun/im/client/

開啟 brand.properties。

將 dialogs.searchresults.format 屬性新增至檔案。

以下列格式新增您要在搜尋結果中包含的屬性：

${attr:attribute-name }

其中 attribute-name 是 LDAP 屬性的名稱。

例如，若要包含 title 屬性，可新增如下行：

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

儲存變更並關閉檔案。

重新封裝 imbrand.jar。

新增使用者屬性至 iim.conf。

指定屬性做為 iim_ldap.userattributes 參數的值。以逗號分隔多個屬性，例如：

iim_ldap.userattributes=title,department,telephonenumber

如需找到並修改 iim.conf 的說明，請參閱iim.conf 檔案語法。

自訂工具提示內容

自 imbrand.jar 擷取檔案。

如需 imbrand.jar 的預設位置，請參閱表 15–1。

變更以下目錄：

com/sun/im/client/

開啟 brand.properties。

新增 contact.tooltip.format.html 屬性至該檔案。

指定您要在工具提示中顯示的屬性，此屬性會做為 contact.tooltip.format.html 的值。

例如，如果您要顯示連絡人的電話號碼或電子郵件地址，您可以輸入：

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

如需自訂 imbrand.jar 檔案內容的詳細資訊，請參閱自訂應用程式 (Java Web Start)。

儲存變更並關閉檔案。

重新封裝 imbrand.jar。

自訂 Instant Messenger

Instant Messenger 資源檔案

自訂 index.html 和 im.html 檔案

使用 Sun Java System Access Manager SSO 啟動 Instant Messenger

自訂應用程式 (Java Web Start)

範例 15–1 範例 im.jnlp 檔案

imbrand.jar 的內容

更名 Instant Messenger

更名 Instant Messenger

自訂使用者名稱和群組名稱顯示

變更用於顯示使用者名稱的屬性

變更用於顯示群組名稱的屬性

在搜尋結果中自訂使用者名稱顯示

自訂工具提示內容

自訂 `index.html` 和 `im.html` 檔案

範例 15–1 範例 `im.jnlp` 檔案

`imbrand.jar` 的內容