Calendar Server API 和 SDK

Calendar Server 包括以下 API 和 SDK：

• Web 行事曆存取協定 (WCAP)

• Calendar Server API (CSAPI)

• 事件通知服務 (ENS) API

• 代理認證 SDK (authSDK)

Web 行事曆存取協定 (WCAP)

Calendar Server 支援 WCAP 3.0，WCAP 3.0 是一個基於指令的高階協定，允許與用戶端進行通訊。WCAP 指令 (副檔名為 .wcap) 可讓用戶端獲得、修改和刪除行事曆元件、使用者喜好設定、行事曆特性以及其他行事曆資訊 (例如時區)。WCAP 元素 (例如時間、字串和參數) 通常遵循 RFC 2445、RFC 2446 和 RFC 2447 規格。

WCAP 使用以下格式在 HTTP 訊息中傳回輸出行事曆資訊：

• 標準 RFC 2445 iCalendar 格式 (text/calendar)

• XML 格式 (text/xml)

透過 WCAP 指令，使用 login.wcap 登入的 Calendar Server 管理員具有以下能力：

• 置換 WCAP 指令的存取控制

  管理員可以使用 WCAP 指令讀取 (擷取)、替代 (儲存) 或刪除其他使用者的行事曆。若要使管理員擁有此權限，ics.conf 檔案中的以下參數必須設定為 "yes"：

  service.admin.calmaster.overrides.accesscontrol="yes"

• 擷取和修改任何使用者的喜好設定

  管理員可以使用 get_userprefs.wcap 和 set_userprefs.wcap 來擷取和修改任何使用者的喜好設定。若要使管理員擁有此權限，ics.conf 檔案中的以下參數必須設定為 "yes"：

  service.admin.calmaster.wcap.allowmodifyuserprefs="yes"

如需更多資訊，請參閱「Sun Java System Calendar Server 6 2005Q4 Developer’s Guide」。

Calendar Server API (CSAPI)

Calendar Server API (CSAPI) 可讓您自訂 Calendar Server 的功能範圍 (例如使用者登入認證、存取控制和行事曆查找)。例如，依預設，Calendar Server 會使用 LDAP 目錄伺服器中的項目認證使用者並儲存使用者喜好設定。CSAPI 可讓您透過實作不基於 LDAP 目錄伺服器的另一個認證機制，置換預設 Calendar Server 認證。

如需有關 CSAPI 的資訊，請參閱「Sun Java System Calendar Server 6 2005Q4 Developer’s Guide」。

事件通知服務 (ENS) API

事件通知服務 (ENS) 是一個警示派送程式，它會偵測警示佇列中的事件，並將這些事件的通知傳送給其訂閱者。ENS API 可讓程式設計師修改 Calendar Server 使用的發佈和訂閱功能，以執行訂閱事件、取消訂閱事件以及通知事件訂閱者之類的功能。ENS API 由這些特定 API 組成：已發佈的 API、訂閱者 API 以及發佈和訂閱派送程式 API。

如需有關 ENS API 的資訊，請參閱「Sun Java System Communications Services 6 2005Q4 Event Notification Service Guide」。

代理認證 SDK (authSDK)

Calendar Server 所提供的 authSDK 可用於認證使用者。您可以透過 authSDK 將現有的入口網站服務與 Calendar Server 整合，從而讓使用者無需重新認證即可存取各種應用程式。authSDK 包含封裝在 DLL/共用物件程式庫和標頭檔案中的功能。

Calendar Server 和 authSDK 之間建立的連線會形成一種信任關係。如果使用者登入並成功地認證至 authSDK，則 Calendar Server 會接受代理程式所產生的憑證，並提供其功能。

如需有關 authSDK 的資訊，請參閱「Sun Java System Calendar Server 6 2005Q4 Developer’s Guide」。