Sun Java System Instant Messaging 7.2 管理指南

弹出提示概述

本节中的以下主题包含关于“日历”弹出提示的信息:

弹出提示操作

对于用户日历中即将发生的事件和任务,用户可收到相应的 Instant Messenger 弹出提示。要启用这些弹出提示,必须具备以下条件:

启用弹出后,当事件或任务来临时,“事件通知系统”中设置的报警会导致“日历服务器”发送一封电子邮件通知,并让 Instant Messaging 显示一个弹出提示。

弹出提示体系结构流程

如果已配置,Instant Messaging 弹出提示会遵循以下体系结构流程:

  1. Instant Messaging JMS 订户在“事件通知服务”(ENS) 中订阅“日历”服务器事件和通知。

  2. “日历”服务器向 ENS 发布 text/xmltext/calendar 格式的事件或任务通知。

  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

报警的目的地。 

它必须与 ics.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 用户部分”列出的 jms.consumer.cal_reminder.provider 参数的值相同。

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

加载可启用“日历”代理的组件。 

按以下形式设置此值,包括引号: 

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