test

Sun Java System Instant Messaging 7.2 管理指南

第 16 章 使用行事曆快顯提醒

Instant Messaging 與 Sun JavaTM System Calendar Server 整合，以提供給 Instant Messenger 使用者行事曆事件和作業的自動快顯提醒。

本節包含下列主題：

快顯提醒摘要

本章節以下列主題說明行事曆快顯提醒：

快顯提醒作業

使用者可以在其行事曆上接收即將來臨的事件與工作的 Instant Messenger 快顯提醒。若要啟用這些快顯提醒，必須執行下列項目：

啟用快顯後，當即將發生的事件或作業接近時， 在「事件通知系統」中設定的警示會導致 Calendar Server 傳送電子郵件通知，並讓 Instant Messaging 顯示快顯提醒。

快顯提醒的架構流程

若有配置，Instant Messaging 快顯提醒會遵循此架構流程：

  1. Instant Messaging JMS 訂閱者訂閱行事曆伺服器事件與「事件通知服務」(ENS) 中的通知。

  2. 行事曆伺服器會以 text/xml 或 text/calendar 格式向 ENS 發佈事件或工作通知。

  3. Instant Messaging JMS 訂閱者接收行事曆事件或工作通知，然後以 text/calendar 格式產生訊息。

  4. 如果該一般使用者在線上，Instant Messaging 伺服器會將該訊息傳送給行事曆所有者。

  5. 如果有可用的收件者，Instant Messenger 會根據訊息在一般使用者的桌面上產生 HTML 快顯提醒。

    如果收件者無法接收，Instant Messaging 伺服器會捨棄該訊息。

iim.conf 行事曆快顯配置參數

當您安裝 Instant Messaging 時，預設會將數個與行事曆代理程式搭配使用的參數新增至 iim.conf。當您執行 configure 公用程式時，您也可以啟用行事曆代理程式，並提供相關的配置資訊。但是，您可能要手動配置快顯，例如當您已自訂 Instant Messenger 的資源檔案時。如果您重新執行 configure，您需要重新部署資源檔案。如果您選擇手動配置 Instant Messaging 伺服器的行事曆快顯，而不是透過執行 configure 公用程式，則需要提供這些參數的值。如需 configure 公用程式的資訊，請參閱第 1 章, 安裝後配置 Instant Messaging。

表 16–1 列出的配置參數可用於配置 Instant Messaging 伺服器和行事曆代理程式來使用行事曆快顯。

表 16–1 iim.conf 參數可配置行事曆快顯

iim.conf 中的參數或部份

說明與適當值 

JMS 用戶部份

jms.consumers

警示名稱。 

設定此值為： 

cal_reminder

jms.consumer.cal_reminder.destination

警示目標。 

這必須和 iics.conf 檔案中 caldb.serveralarms.url 配置參數的值相同。例如：

enp:///ics/customalarm

jms.consumer.cal_reminder.provider

提供者的名稱。 

設定為 ens。

此名稱必須與 JMS 提供者部份中 jms.providers 參數內的名稱相同。

jms.consumer.cal_reminder.type

要設定的警示類型。設定此值為： 

topic

jms.consumer.cal_reminder.param

警示參數。如下所示設定此值 (包含引號)： 

"eventtype=calendar.alarm"

jms.consumer.cal_reminder.factory

註冊其本身以使用新行事曆提醒訊息的偵聽程式。 

設定此值為： 

com.iplanet.im.server.JMSCalendarMessageListener

在單行中輸入值： 

JMS 提供者部份

jms.providers

提供者的名稱。 

此值設定為 ens。

此值必須與 jms.consumer.cal_reminder.provider 參數的 JMS 用戶部份中所列的值相同。

jms.provider.ens.broker

ENS 的主機名稱和 ENS 用來偵聽內送請求的連接埠號碼。 

設定為 ics.conf 檔案參數 service.ens.port 中指定的連接埠。預設為 57997。

例如： 

jms.provider.ens.broker=cal.example.com:57997

jms.provider.ens.factory

用於建立主題連線物件的工廠類別。 

設定此值為： 

com.iplanet.ens.jms.EnsTopicConnFactory

Instant Messaging 一般參數

iim_agent.enable

啟用 Instant Messaging 的代理程式。根據預設，此參數設定為 False。

如下所示設定此值 (包含引號)： 

iim_agent.enable="true"

iim_agent.agent-calendar.enable

載入啟用 Calendar 代理程式的元件。 

如下所示設定此值 (包含引號)： 

iim_agent.agent-calendar.enable="true"

agent-calendar.jid

行事曆代理程式的 JID。

設定此值如下： 

agent-calendar.jid=calimbot.server .domain

agent-calendar.password

將此參數設定為行事曆代理程式連線到 Instant Messaging 伺服器所使用的密碼。 

設定此值如下： 

agent-calendar.password=password

iim_server.components

設定此值如下： 

iim_server.components=agent-calendar

配置 Instant Messaging 快顯

本節包含下列配置說明：

Procedure使用 configure 公用程式配置 Instant Messaging Server 的行事曆快顯

  1. 執行 configure。

    如需關於 configure 公用程式的詳細資訊，參?完成配置檢核清單。

  2. 在 [行事曆代理程式] 配置畫面中，選取 [啟用行事曆代理程式] 核取方塊。

  3. 輸入 Notification Server 主機名稱和連接埠號碼。

    使用與 Calendar Server 上 ics.conf 檔案中 service.ens.port 參數所指定的連接埠號碼相同的連接埠號碼。

    您提供的值會結合在一起，並儲存為 iim.conf 中 jms.provider.ens.broker 參數的值。例如，如果您輸入 localhost 做為主機名稱，輸入 57997 做為連接埠號碼，則jms.provider.ens.broker 參數應設定如下：


    jms.provider.ens.broker=localhost:57997

  4. 輸入「行事曆警示 URL」。

    此 URL 是警示的目標。例如：


    enp:///ics/customalarm

    使用與 Calendar Server 上檔案 ics.conf 中的 caldb.serveralarms.url 參數所指定 URL 相同的 URL。

    您提供的值會儲存為 iim.conf 中 jms.consumer.cal_reminder.destination 參數的值。

  5. 按 [下一步] 並繼續配置。

    如需 configure 公用程式的詳細資訊，請參閱第 1 章, 安裝後配置 Instant Messaging。

Procedure手動配置 Instant Messaging Server 的行事曆快顯

開始之前

表 16–1 為彙整的資訊。

  1. 編輯 iim.conf 檔案中的一或多個參數，如表 16–1 所示。

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

    顯示的參數值假設您想要事件與工作的快顯提醒。若您的 iim.conf 中不存在這些參數，則新增。

  2. 使用 imadmin 啟動行事曆代理程式。


    imadmin start agent-calendar

    imadmin 指令行公用程式位在以下目錄中：

    im-svr-base/sbin

    其中 im-svr-base 是您安裝 Instant Messaging 的目錄。

Procedure配置 Calendar Server 的快顯

  1. 以具有變更配置權限的管理員身份登入行事曆伺服器主機。

  2. 變更為 cal-svr-base/SUNWics5/cal/config 目錄。

    其中 cal-svr-base 是您安裝 Calendar Server 的目錄。

  3. 藉由複製與重新命名來儲存舊的 ics.conf 檔案。

  4. 確認在下表中顯示的參數有顯示的值。否則，您必須修改這些參數。

    參數 

    說明與預設值 

    caldb.serveralarms

    啟用要佇列的行事曆警示。預設為 "1" (啟用)。

    caldb.serveralarms.contenttype

    警示內容的輸出格式。預設為 "text/xml"。

    caldb.serveralarms.dispatch

    啟用要派送的行事曆警示。預設為 "yes"。

    caldb.serveralarms.dispatchtype

    要派送的伺服器警示類型。預設為 "ens"。

    caldb.serveralarms.url

    這是警示擷取警示內容的 URL。預設為 "enp:///ics/customalarm"。

  5. 儲存 ics.conf 檔案。

  6. 重新啟動行事曆伺服器。

    cal-svr-base /SUNWics5/cal/sbin/start-cal

    其中 cal-svr-base 是您安裝 Sun Java System Calendar Server 的目錄。

Procedure配置 Instant Messenger 的行事曆快顯

  1. 在 Instant Messenger 主視窗中，選取 [工具] -> [設定]。

  2. 在 [設定] 視窗中按一下 [警示] 標籤。

  3. 核取 [顯示行事曆提醒] 選項。

  4. 按一下 [確定]。

    現在，當使用者在線上時，可透過 Instant Messenger 收到行事曆快顯。

在伺服器池中配置行事曆快顯

若要配置行事曆快顯在伺服器池部署中作業，您只需要在池中配置一個伺服器的行事曆代理程式。系統會為池中每個已配置的行事曆代理程式提供快顯。

管理行事曆代理程式

行事曆代理程式是一種 Instant Messaging 元件，可提供快顯功能給行事曆和 Instant Messaging 使用者。此外，使用隨 Instant Messaging 提供的工具，您可以啟動、停止、重新啟動或檢查行事曆代理程式的狀態，以及透過記錄檔監控其活動。如需管理行事曆代理程式元件的資訊，請參閱停止、啟動、重新整理與檢查 Instant Messaging 元件。如需行事曆代理程式記錄的資訊，亦請參閱第 13 章, 管理 Instant Messaging 的記錄。本節說明啟用和停用 Instant Messaging 代理程式。

Procedure啟用和停用 Instant Messaging 代理程式

  1. 開啟 iim.conf.

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

  2. 將 iim_agent.enable 參數設定為 true：

    iim_agent.enable="true"

  3. 儲存並關閉 iim.conf。

  4. 重新整理伺服器。


    imadmin refresh server