Sun Java System Calendar Server 6.3 管理指南

15.5 创建日历

本节介绍如何创建日历的概念性信息和说明。

本节包含以下主题：

15.5.1 使用 `cscal` 实用程序创建用户日历

本节包含以下主题和示例：

以下示例创建与前一个示例类似的日历，但它还将设置特定的访问控制设置以用于组计划：

cscal -n Hobbies -o jsmith -a "@@o^a^sfr^g" create Personal

字符串 -a "@@o^a^sfr^g" 为其他所有者授予对该日历的组件和日历属性的预定、空闲/繁忙和读取访问权限，以便进行组计划。

15.5.1.1 新建日历概述

要新建日历，使用 cscal 实用程序的 create 命令。LDAP 目录中必须已经存在用户条目或资源条目。有关向 LDAP 目录添加用户和资源的信息，请参阅第 14 章，管理用户、组和资源。

如果您的站点使用的是 LDAP 日历查找数据库 (Calendar Lookup Database, CLD) 插件，则必须按照用户条目或资源条目中的 icsDWPHost LDAP 属性中的指定，在同一后端服务器上为特定用户或资源创建所有日历。如果试图在不同的后端服务器上创建日历，cscal 实用程序将返回一条错误消息。有关 LDAP CLD 插件的信息，参见第 5 章，在 Calendar Server 版本 6.3 中配置跨多个计算机的日历数据库分发。

15.5.1.2 新建日历

要新建日历，至少要使用以下命令：

cscal -o uid  create calid

例如，对于唯一 ID 和日历 ID 为 jsmith 的用户 John Smith，命令将如下所示：

cscal -o jsmith create jsmith

命令具有以下部分：

cscal: 实用程序的名称。
-o: 该日历的主要所有者的唯一 ID (uid)。
create: 用于新建日历的命令。
calid: 将分配给该日历的日历 ID。

有关 cscal 实用程序的详细信息，参见 D.5 cscal（它也在本指南中）。

提示 –

默认访问控制设置由 ics.conf 文件中的 calstore.calendar.default.acl 定义。

15.5.1.3 为用户创建另一个日历

可为任意用户创建多个日历。但是，始终会将它们标识为默认日历的子日历。在新日历的全限定名称中，冒号分隔符的左边是默认日历的名称，右边则为新日历的名称。

以下示例演示了如何为用户 John Smith 创建另一个（非默认）日历，新日历的名称为 Personal：

cscal -o jsmith@sesta.com create Personal

命令的组成部分如下：

cscal

实用程序的名称。

-o jsmith@sesta.com

该日历的主要所有者的唯一 ID (uid)。

create

用于新建日历的命令。

Personal

要分配给该日历的日历 ID (calid) 的后半部分。

全限定日历 ID 为 jsmith@sesta.com:Personal。

15.5.1.4 使用可见名称来创建日历

本示例显示如何为在前一示例中创建的 Personal 非默认日历创建一个单独的可见名称 "Hobbies"。

cscal -o jsmith@sesta.com -n Hobbies create Personal

-o

jsmith@sesta.com 指定主要所有者的用户 ID。

-n

Hobbies 指定日历的可见名称。

Personal

John Smith 的该新附加日历的名称。

整个 calid 变为：jsmith@sesta.com: Personal。

15.5.1.5 使用其他属性来创建日历

以下示例通过与前一示例类似的步骤来新建日历 Personal，但它还会将日历与名为 sports 的类别关联起来，启用重复预订，并将 Ron Jones 指定为另一个所有者：

cscal -n Hobbies -o jsmith - g sports -k yes -y rjones create Personal

命令具有以下部分：

cscal

实用程序的名称。

-o jamsith@sesta.com

该日历的主要所有者的唯一 ID (uid)。

-g sports

该选项会将日历 Personal 与名为 sports 的类别关联起来。

-y

值 rjones@sestas.com 指定了日历的另一个所有者。

-k yes|no

此选项会在一段时间内启用或禁用事件的重复预订。

值为 yes 会启用重复预订。值为 no 会禁用重复预订。

create

用于新建日历的命令。

Personal

将分配给该日历的日历 ID。

15.5.2 为资源配置 Calendar Server

资源日历与可计划的事物相关联，如会议室、笔记本电脑、顶置光源投影仪以及其他设备。资源日历需要访问控制列表。

如表 15–3 所示，ics.conf 文件中的两个配置参数适用于资源日历：

resource.default.acl: 默认访问控制列表。
resource.allow.doublebook: 允许或禁止重复预订的参数。

要更改这些参数（如表 15–3 中所示）的默认值，请编辑 ics.conf 文件。对默认值所做的更改只能应用到新的资源日历，而不能更改现有资源日历的值。

对于 Schema 版本 1，使用 Calendar Server 实用程序 cscal 更改现有资源日历的值。csresource 实用程序没有 modify 命令。

对于 Schema 版本 2，使用 Delegated Administrator 实用程序的 commadmin resource modify 命令。Delegated Administrator 控制台不允许您更改日历资源的这些值。

注 –

Calendar Server 通知软件不会向资源发送通知，而是仅向用户发送通知。

表 15–3 ics.conf 文件中的资源日历配置参数


参数	说明和默认值
`resource.default.acl`	此参数决定创建资源日历时使用的默认访问控制权限。默认权限由以下访问控制列表 (ACL) 指定： `"@@o^a^r^g;@@o^c^wdeic^g;@^a^rsf^g"` 此 ACL 将授予所有日历用户读取、调度和空闲/繁忙访问该日历（包括组件和属性）的权限。要更改资源的权限，在使用 `csresource` 实用程序的 create 命令创建日历时使用 `-a` 选项。
`resource.allow.doublebook`	此参数决定资源日历是否允许重复预订。重复预订允许资源日历同时具有多个预定的事件。默认值为 `"no"`—不允许重复预订。要启用资源日历的重复预订功能，请在使用 `csresource` 实用程序的 create 命令创建日历时使用 `-k` 选项。
`resource.invite.autoprovision`	默认值为 `"yes"`。
`resource.invite.autoaccept`	默认值为 `"yes"`。

15.5.3 创建资源和资源日历

提示 –

如果 ics.conf 参数 resource.invite.autoprovision 的值为 "yes"，则会在首次邀请时创建资源日历。也就是说，如果该资源尚没有默认日历，则在邀请中首次对其进行预定时，会创建资源日历。

要创建资源，使用以下方法之一：

Calendar Server 实用程序（Schema 版本 1）

使用 csresource create

此实用程序创建了资源的 LDAP 条目和默认日历。

如果已存在该资源的 LDAP 条目，csresource 将仅创建日历。而不会创建重复的 LDAP 条目。

例如，可以使用以下命令创建日历 ID 为 aud100、可见名称为 Auditorium 且具有默认设置的资源 LDAP 条目和日历：

csresource -m aud100@siroe.com -c aud100 create Auditorium

Delegated Administrator 实用程序和 Calendar Server 实用程序

使用两个命令的组合：

Delegated Administrator 实用程序命令 commadmin resource create，用于创建 LDAP 条目。
Calendar Server 实用程序命令 csresource create，用于创建默认日历。

Delegated Administrator 控制台

要使用控制台创建 LDAP 资源，请从“组织列表”选择此资源将驻留的组织。从此组织的“日历资源”页，单击“新建”以显示“新建日历资源向导”。

有关 Delegated Administrator 实用程序的更多信息，参见《Sun Java System Communications Services 6 2005Q4 Delegated Administrator Guide》。

有关 Delegated Administrator 控制台的更多信息，请参见联机帮助。

有关 csresource 的更多信息，参见附录 D，Calendar Server 命令行实用程序参考。

15.5.4 允许重复预订资源日历

默认情况下，Calendar Server 不允许对资源日历进行重复预订（resource.allow.doublebook 参数）。此默认值用于防止资源（例如房间和设备）的预定冲突。但是，如果您要允许对资源日历进行重复预订，可以在创建日历时将 csresource -k 选项设置为 "yes"。

以下命令创建资源 LDAP 条目和日历，但 -k 选项允许对日历进行重复预订，-o 选项指定 bkamdar 作为日历的所有者，而 -y 选项指定 jsmith@sesta.com 作为另一个所有者：

csresource -m aud100@siroe.com -c aud100 -k yes
    -o bkamdar -y jsmith@sesta.com create Auditorium

15.5.5 限制对资源日历的访问

要控制可以预定特定资源的人员，请考虑限制对资源日历具有写入权限的用户。例如，您可能只希望几个特定用户预定会议室或设备。

如果不为资源日历指定所有者，则其值将由 ics.conf 文件中的 service.siteadmin.userid 参数指定。