Communications Express 支持组织的托管域结构。
本章介绍了为启用托管域而对 Communications Express 进行的更改。
本部分介绍了为启用托管域(也称为虚拟域)而对 Communications Express 进行的更改。
要在日历中启用托管域配置,必须在 uwc-deployed-path/WEB_INF/config/uwcauth. properties 文件中将 virtual domain.mode 参数设置为 "y",并为托管域配置 Calendar Server。有关如何为托管域配置 Calendar Server 的信息,请参阅 Calendar Server 管理指南的第 5 章“设置托管域”。
要置备域并了解在 Sun Java System LDAP Schema v.1 的组织树中创建托管域条目的方法,请参阅 iPlanet Messaging Server 5.2 Provisioning Guide 中的第 2 章 "Provisioning Domains"。
有关如何为每个域自定义邮件客户端界面的信息,请参阅 Sun Java System Communications Express Customization Guide 中的第 8 章 "Customizing Communications Express for a Specific Domain"。
可以修改以下文件以启用托管域。
uwc-deployed-path/WEB-INF/domain/personalstore.properties 文件
uwc-deployed-path/WEB-INF/domain/defaultps/defaultps.xml 文件
与域相关的可配置参数存储在以下文件中:
uwcdomainconfig.properties
personalstore.properties
defaultps/defaultps.xml
lang/il8n.properties。例如 en/i18n.properties。
部署 Communications Express 时,默认情况下将这些文件复制到 uwc-deployed-path/WEB-INF/domain 目录中。
对于特定用户的会话,按以下顺序搜索与域相关的属性文件:
uwc-deployed-path/WEB-INF/domain/user\qs domain/property-files
uwc-deployed-path/WEB-INF/domain/property-files
本部分介绍了创建托管域时需要执行的步骤。
在 uwc-deployed-path/WEB-INF/domain 下创建一个包含域名的目录。
例如:uwc-deployed-path/WEB-INF/domain/domain-name
将 uwc-deployed-path/WEB-INF/domain 目录下与域相关的配置文件复制到该目录。有关与域相关的参数列表,请参阅设置托管域部分。
按照以下各部分的说明,自定义 uwc-deployed-path/WEB-INF/domain/domain-name 目录中的属性文件。
要使 Access Manager 登录 URL 可以根据 Communications Express 特定于域的 URL 来构建,请将全限定虚拟主机名 uwc.isvirtualhostname 设置为 Access Manager 的虚拟主机名。
例如,在
ce.virtualdomain.com.isvirtualhostname=is.virtualdomain.com
并从 http://ce.virtualdomain.com/uwc 访问 Communications Express 时,
Access Manager URL 将显示为
http://is.virtualdomain.com/amserver/UI/Login。
如果没有将全限定虚拟主机名映射至 Access Manager 的虚拟主机名,则 Communications Express 将根据在 uwcauth.identity.login.url 中配置的静态 Access Manager 登录 URL 来构建 Access Manager 登录 URL。
例如,如果在 uwcauth.identity.login.url=http://siroe.com:85/amserver/UI/Login 中并且从某个特定于域的 URL(例如 http://ce.varrius.com:80/uwc)访问 Communications Express,则 Communications Express 会将 Access Manager 登录 URL 构建为:
http://siroe.varrius.com:85/amserver/UI/Login
其中,域为 varrius.com。
如果域为 ce.varrius.com,则 Communications Express 会将 Access Manager 登录 URL 构建为:http://siroe.ce.varrius.com:85/amserver/UI/Login。
在 Access Manager 配置中进行以下更改:
在 AMconfig.properties 中定义 FQDN 映射。AMconfig.properties 文件的默认位置为:/etc/opt/SUNWam/config/AMconfig.properties
例如,如果通过 is.virtualdomain.com 虚拟主机访问 Access Manager,则 FQDN 映射将显示为:
com.sun.identity.server.fqdnMap[is.virtualdomain.com]= is.virtualdomain.com
在 Cookie 域(位于服务配置 -> 平台下)的其他 Cookie 域字段中添加 virtualdomain.com。
以下部分介绍了可以在 Communications Express 中为域配置的设置:
uwcdomainconfig.properties 文件维护与日历和通讯录相关的用户首选项的默认值,可以基于每个域来配置这些首选项。这些默认用户首选项值是新用户第一次在 Communications Express 中访问日历和通讯录时为其动态分配的。
表 6–1 uwcdomainconfig.properties 文件中的默认用户首选项
参数 |
默认值 |
描述 |
---|---|---|
uwc-user-attr-sunUCDefaultApplication |
指定您登录后显示的页面。 部署 Messenger Express 后,默认情况下将“邮件”页显示为登录页。否则显示“日历”页。如果未部署日历,用户将进入“通讯录”页。 |
|
uwc-user-attr-sunUCDefaultEmail Handler |
uc、desktop |
指定用于从应用程序中发送电子邮件的默认电子邮件客户端。 |
uwc-user-attr-sunUCDateFormat |
M/D/Y |
指定日期中的日、月和年的显示顺序。 可用选项为: M/D/Y、D/M/Y、Y/M/D |
uwc-user-attr-sunUCDateDelimiter |
/ |
分隔符是分隔日期中的日、月和年的字符。 您可以将分隔符指定为逗号 (,)、正斜杠 (/) 或连字符 (-)。 |
uwc-user-attr-sunUCTimeZone |
America/ Los_Angeles |
您可以从以下区域中选择任何有效的时区: 北美和南美地区、欧洲和非洲以及亚洲和太平洋周边。 |
在 uwcdomainconfig.properties 文件中配置参数列出了与日历应用程序相关的用户首选项。
参数 |
默认值 |
描述 |
---|---|---|
uwc-user-attr-icsExtendedUser Prefs-ceDefaultView |
dayview |
日视图、周视图、月视图和年视图。 |
uwc-user-attr-icsExtendedUser Prefs-ceShowCompletedTasks |
false |
指定完成的任务是否出现在日历的“任务”窗格中。 如果您希望完成的任务出现在日历的“任务”窗格中,请将默认值更改为 "true"。 |
uwc-user-attr-icsExtendedUser Prefs-ceDefaultCategory |
业务 |
可用类别为: “周年纪念日”、“约会”、“生日”、“业务”、“早餐”、“课程”、“电话会议”、“晚餐”、“假日”、“午餐”、“会议”、“其他”、“个人”、“研讨会”、“培训”、“旅行”、“休假”和“会谈”。 |
uwc-user-attr-icsExtendedUser Prefs-ceDayHead |
9 |
指定一天的开始时间(以小时表示)。 |
uwc-user-attr-icsExtendedUser Prefs-ceDayTail |
18 |
指定一天的结束时间(以小时表示)。 |
uwc-user-attr-icsExtendedUser Prefs-ceInterval |
PT1H0M (一小时) |
指定一天中划分的时间段。 在“日”和“周”视图中,将一天划分为半小时或一小时的时间段。 您可以将默认划分值更改为 PT0H30M(半小时)。 |
uwc-user-attr-icsFirstDay |
1 |
您可以将一周中的某一天指定为日历中周的第一天。默认情况下,将星期日 (1) 作为一周中的第一天,而将星期六 (7) 作为一周中的最后一天。 |
uwc-user-icsExtendedUser Prefs-ceWeekEndDays |
1 和 7 |
在日历视图中指定周末是一周中的哪几天。 默认情况下,星期日 (1) 是一周中的第一天,星期六 (7) 是一周中的最后一天。 逗号分隔的数字列表表示一周中作为周末的那几天。 |
uwc-user-attr-icsExtendedUser Prefs-ceIncludeWeekendIn Views |
false |
允许或禁止在日历的“周”和“月”视图中显示周末。 如果应该在日历的“周”和“月”视图中显示周末,则将默认值设置为 "true"。 |
uwc-user-attr-icsExtendedUser Prefs-ceSingleCalendarTZISD |
true |
指定是否应该用日历的时区来显示日历。 如果不希望用日历的时区来查看日历,则将默认值更改为 "false"。在这种情况下,将按“全局选项”选项卡中指定的时区来显示所有日历。 |
uwc-usr-attr-icsExtendedUser Prefs-ceDefaultAlarmStart |
PT0H30M |
指定在事件或任务前多长时间(默认小时和分钟数〕发送提醒。 |
uwc-user-attr-icsExtendedUser Prefs-ceNotifyEnable |
false |
指定在创建新的事件时是否向内部被邀请人发送电子邮件(包含 ical 附件)。 有效值为:false、true。 |
表 6–3 uwcdomainconfig.properties 文件中的默认通讯录首选项
参数 |
默认值 |
描述 |
---|---|---|
uwc-user-sunAbExtended UserPrefs-abName |
Personal Address Book |
指定默认通讯录的名称。 |
uwc-user-attr-sunAbExtended UserPrefs-abDescription |
This is the personal address book |
为默认通讯录指定简短描述。 |
uwc-user-attr-sunAbExtended UserPrefs-abEntriesPerPage |
25 |
指定在页面上显示的最大通讯录条目数。可用选项为:25、50、75。 |
uwc-user-attr-sunAbExtended UserPrefs-abSearchDisplay Column1 |
displayname |
指定要在第一列中显示的值。默认情况下,第一列显示联系人或组的名称。 |
uwc-user-attr-sunAbExtended UserPrefs-abSerchDisplay Column2 |
primaryemail |
指定要在通讯录的第二列中显示的值。 您可以将显示列名称设置为: displayname、company、title、primaryphone、workphone、homephone、faxphone、pagerphone、primaryemail、email2、email3、homeaddress、workaddress、weburl1、weburl2、calendarurl、freebusyurl、birthday、anniversary、ou、edit、viewcalendar。 |
uwc-user-attr-sunAbExtended UserPrefs-abSearchDisplay Column3 |
指定要在通讯录的第三列中显示的值。 您可以将显示列名称设置为: displayname、company、title、primaryphone、workphone、homephone、faxphone、pagerphone、primaryemail、email2、email3、homeaddress、workaddress、weburl1、weburl2、calendarurl、freebusyurl、birthday、anniversary、ou、edit、viewcalendar。 |
|
uwc-user-attr-sunAbExtended UserPrefs-abSearchDisplay Column4 |
edit |
指定要在通讯录的第四列中显示的值。 您可以将显示列名称设置为: displayname、company、title、primaryphone、workphone、homephone、faxphone、pagerphone、primaryemail、email2、email3、homeaddress、workaddress、weburl1、weburl2、calendarurl、freebusyurl、birthday、anniversary、ou、edit、viewcalendar。 |
修改 personalstore.properties 文件中的参数,以配置通讯录存储、公司目录以及任何远程目录。
表 6-4 列出了 personalstore.properties 文件中存储的设置。
表 6–4 personalstore.properties 文件中存储的配置设置
参数 |
默认值 |
描述 |
---|---|---|
db.defaultpsrootpattern |
ldap: //piPStoreOwner= %U,o=%D, o=PiServerDb |
指定用于为用户动态构建 psRoot 值的模式。psroot 标识用户条目存放的位置。 %U = 用户的 uid ("jsmith") %D = 用户的域 ("siroe.com") %O = 域的最重要部分 ("siroe") |
db.xxx.class |
com.iplanet.iabs. ldap.plug.iLDAP |
指定实现插件的 java 类名称。例如,LDAP 插件。 |
db.xxx.urlmatch |
按以下格式指定 URL: ldap://host:port/DN 基于此参数来标识 xxx 实例。 该值应与 defaultps.xml 文件中存储的 "bookremoteurl" 属性对应。 |
|
db.xxx.configpath |
指定包含此实例 LDAP 信息的配置目录的路径。 如果此路径是相对路径,则它相对于此文件的位置。 |
|
db.xxx.wildcardsearch |
指定在通配符搜索中提供的最小字符数。 |
|
db.xxx.randompaging |
false |
指定插件是否支持随机访问以及是否必须从第一页来访问每一页。 如果为 false,则搜索过程继续进行搜索,直至找到正确的页为止。 |
db.xxx.corporatedir |
false |
对于公司目录,此值应该为 true。 |
db.useUserPsRoot |
false |
将值设置为 true 以使用用户的 psRoot 值。如果设置为 false,则使用 defaultserver 值。 |
defaultps.xml 文件包含用户首次登录时在 LDAP 存储中创建的个人和公司通讯录的默认定义。
每个通讯录节点都包含一个为用户创建的通讯录定义,defaultps.xml 文件位于这些用户所在的域之下。
以下列举了 defaultps.xml 中的 XML 部分,其中包含个人通讯录和公司通讯录的定义。
<book booktype="abook"\> <bookoc\>piLocalBook</bookoc\> <entry entryID="pab"\> <displayname\>_Personal Address Book</displayname\> <description\>_This is your Personal Address Book</description\> </entry\> </books\> |
<book booktype="abook" bookremoteurl="ldap://corpdirectory"\> <bookoc\>piRemoteBook</bookoc\> <entry entryID="idirectory"\> <displayname\>_Corporate Directory</displayname\> <description\>_This is Corporate Directory</description\> </entry\> </book\> |
对于公司通讯录和远程通讯录,personalstore.properties 文件中应存在相应的 xxx 实例。应该将 defaultps.xml 文件中 bookremoteurl 属性的值指定给 personalstore.properties 文件中的 db.xxx.urlmatch。
要添加新的远程通讯录,需要添加以下项:
在 defaultps.xml 文件中添加新的通讯录节点
在 personalstore.properties 文件中添加新的 xxx 实例。
在 WEB-INF/config 下创建一个目录,以存储 db_config.properties 和 xlate 文件。
xlate 文件包含联系人或组的 LDAP Schema 和通讯录 XML Schema 之间的字段映射。
主题文件包含在 Communications Express 中显示的图标的逻辑名称及其默认位置。可通过更改此文件中指定的路径来更改图像的位置。默认的 theme.properties 文件位于 uwc-deployed-path/WEB-INF/skin 下。
uwcdomainconfig.properties 文件包含某个域所支持的语言列表。列表中的每种语言用分号隔开。您可以定义 Communications Express 为域支持的语言列表。
例如,如果计划在名为 siroe.com 的域中支持 en(英语)、de(德语)、fr(法语)和 ja(日语),则将该域的 uwcdomainconfig.properties 文件中的 supportedLanguages 设置为 supportedLanguages=en;fr;de;ja。
siroe.com 的 uwcdomainconfig.properties 文件应位于:
WEB-INF/domain/siroe.com/uwcdomainconfig.properties
您还必须在相应的 i18n.properties 文件中定义可本地化的字符串。例如,
uwc-common-options-preferredLanguage-en=English
uwc-common-options-preferredLanguage-de=German
uwc-common-options-preferredLanguage-fr=French
uwc-common-options-preferredLanguage-ja=Japanese
siroe.com 的 i18n.properties 文件将位于:
WEB-INF/domain/siroe.com/locale/i18n.properties
如果用户的 LDAP 条目中没有 preferredLanguage 属性,则域的 preferredLanguage 属性、浏览器提供的标题值和 i18.properties 文件的可用性将决定用户会话中使用的语言。