Sun Java System Calendar Server 6 2005Q4 管理指南

第 20 章使用 Instant Messaging 弹出式提醒通知

与 Sun Java System Instant Messaging 6.0（或更高版本）集成的 Calendar Server 可以为日历事件和任务提供自动弹出式提醒通知。

本章介绍了以下内容:

弹出式提醒通知概述

本节包含以下主题：

弹出式提醒通知操作

用户可以在其日历上接受到即将举行的事件和任务的 Instant Messenger 弹出式提醒通知。要启用弹出式提醒通知，必须完成以下两件任务：

管理员必须配置 Calendar Server 和 Instant Messaging Server 以允许弹出式提醒通知。
最终用户必须在 Communications Express 的“选项”选项卡中指定电子邮件提醒通知，该通知将在“事件通知系统”中设置一个警报。
最终用户必须在 Instant Messenger 中启用日历提醒通知。

启用了弹出式提醒通知后，即将发生的事件或任务临近时，Event Notification System 中设置的警报将使 Calendar Server 发送电子邮件通知并使 Instant Messaging 显示弹出式提醒通知。

Calendar Server 管理员可以选择为最终用户配置电子邮件提醒通知或弹出式提醒通知，也可以选择同时配置这两项。例如，要关闭电子邮件提醒通知，可在 ics.conf 文件中设置以下参数：

caldb.serveralarms.binary.enable= "no"

弹出式提醒通知构建流程

如果配置了 Instant Messaging 弹出式提醒通知，它将遵循下面的构建流程：

Instant Messaging JMS 订户在事件通知服务 (ENS) 中订阅 Calendar Server 事件和通知。
Calendar Server 将事件或任务通知以 text/xml 或 text/calendar 格式发送给 ENS。
Instant Messaging JMS 订户接收日历事件或任务通知，然后生成 text/calendar 格式的消息。
Instant Messaging Server 将消息发送给日历属主（如果最终用户在线）。
如果收件人在线，Instant Messenger 将根据该消息在最终用户的桌面上生成 HTML 弹出式提醒通知。

配置弹出式提醒通知

本节包括以下配置说明：

配置 Instant Messaging Server

配置 Instant Messaging 弹出式提醒通知所需的以下较高级别任务列表可以为您提供方便。要配置 Instant Messaging，请参阅以下站点上可用的 Instant Messaging 文档：

http://docs.sun.com/coll/1309.2 和 http://docs.sun.com/coll/1390.2

步骤

安装新软件包 SUNWiimag。

使用 Instant Messaging 弹出式提醒通知之前，必须首先使用 Java Enterprise System 安装程序安装 Instant Messaging 软件包。

在已安装 Instant Messaging 的计算机中，转到以下目录：

cd /etc/opt/SUNWiim/default/config

编辑下表中所示的 iim.conf 文件中的一个或多个参数。

显示的参数值假定您要为事件和任务都启用弹出式提醒通知。如果 iim.conf 文件中尚不存在这些参数，则先添加它们。

参数	说明和要使用的适当值
JMS Consumers 部分
`jms.consumers`	警报名称。将该值设置为 `cal_reminder`。
`jms.consumer.cal_reminder.destination`	警报目标。将该值设置为 enp:///ics/customalarm
`jms.consumer.cal_reminder.provider`	提供者名称。设置为 `ens`。提供者名称必须与 JMS Providers 部分中的 `jms.providers` 的名称相同。
`jms.consumer.cal_reminder.type`	要设置的警报的类型。将该值设置为 `topic`。
`jms.consumer.cal_reminder.param`	警报参数。将该值设置为 `"eventtype=calendar.alarm"`（包括引号）
`jms.consumer.cal_reminder.factory`	C++ 工厂名称。将该值设置为： com.iplanet.im.server. JMSCalendarMessageListener
JMS Providers 部分
`jms.providers`	提供者名称。将该值设置为 `ens`。该值必须与 JMS Consumers 部分中列出的 `jms.consumer.cal_reminder.provider` 的值相同。
`jms.provider.ens.broker=cal.example.com`	ENS 侦听的端口号。设置为 `ics.conf` 文件参数 `service.ens.port` 中指定的端口。默认值为 57997。
`jms.provider.ens.factory`	要使用的 C++ 工厂。设置为 `com.iplanet.ens.jms.EnsTopicConnFactory`
Calendar Server 常见参数
`iim_agent.enable`	启用 Calendar 代理。按如下所示设置该值（包括引号）： `iim_agent.enable="true"`
`iim_agent.agent-calendar.enable`	装入启用 Calendar 代理的组件。按如下所示设置该值（包括引号）： `iim_agent.agent-calendar.enable="true"`
`agent-calendar.jid`	Calendar 代理的 JID。按如下所示设置该值： `agent-calendar.jid=calimbot.server.domain`
`agent-calendar.password`	Calendar 代理密码。按如下所示设置该值： `agent-calendar.password=password`
`iim_server.components`	按如下所示设置该值： `iim_server.components=agent-calendar`

转到 imadmin 命令行实用程序所在的目录：

cd /opt/SUNWiim/sbin

使用 imadmin 启动 Calendar 代理：

imadmin start agent-calendar

Calendar 代理是 Instant Messaging 的一个组件，可以为 Calendar Server 用户提供弹出式功能。使用 Instant Messaging 提供的工具，可以启动、停止、重新启动 Calendar 代理或检查它的状态，也可以通过日志文件监视它的活动。

注 –
如果有包含 stop、start 和 refresh 命令的脚本，则可将 Calendar 代理加入其中。

有关 imadmin 和 Calendar 代理的更多信息，请参见《Sun Java System Instant Messaging 7 2005Q1 管理指南》。

配置 Calendar Server

开始之前

确认下表中所示的 ics.conf 参数具有所示的值。如果它们不具有这些值，或者您要对它们进行自定义设置，则按以下步骤操作：

步骤

以有权更改此配置的管理员身份登录。

转至 /etc/opt/SUNWics5/cal/config 目录。

通过复制和重命名旧的 ics.conf 文件来保存该文件。

编辑 ics.conf 参数的值，如下表所示：

参数	说明和默认值
caldb.serveralarms	启用要排队的日历警报。默认值为 `"yes"`（启用）。
caldb.serveralarms.contenttype	警报内容的输出格式。默认值为 `"text/xml"`。
caldb.serveralarms.dispatch	启用要分发的日历警报。默认值为 `"yes"`。
caldb.serveralarms.dispatchtype	要分发的服务器警报的类型。默认值为 `"ens"`。
caldb.serveralarms.url	这是检索警报内容的警报的 URL。默认值为 `"enp:///ics/customalarm"`。

将此文件另存为 ics.conf。

重新启动 Calendar Server。

cal_svr_base/SUNWics5/cal/sbin/start-cal

配置 Instant Messenger

要接收 Calendar Server 事件和任务的弹出式提醒通知，最终用户必须按以下方式配置 Instant Messenger：

步骤

在“主”窗口中，从“工具”菜单中选择“设置”。

在“设置”窗口中，单击“警报”选项卡。

选中“显示日历提醒通知”选项。

单击“确定”。

第 20 章 使用 Instant Messaging 弹出式提醒通知