Sun Java System Communications Express 6 2005Q4 管理指南

設定託管網域

與網域相關的可配置參數儲存在下列檔案中:

部署 Communications Express 以後,依預設,這些檔案將被複製到 uwc-deployed-path/WEB-INF/domain 目錄中。

針對特定使用者的階段作業,將按照下列順序搜尋與網域相關的特性檔案:

Procedure託管網域

步驟
  1. uwc-deployed-path/WEB-INF/domain/user\qs domain/property-files

  2. uwc-deployed-path/WEB-INF/domain/property-files

建立託管網域

此節描述建立託管網域需要執行的步驟。

Procedure若要針對特定網域指定與網域相關的特性:

步驟
  1. uwc-deployed-path/WEB-INF/domain 下,使用網域名稱建立一個目錄。

    例如:uwc-deployed-path/WEB-INF/domain/domain-name

  2. uwc-deployed-path/WEB-INF/domain 目錄下與網域相關的配置檔案複製到該目錄中。請參閱設定託管網域一節,以取得與網域相關的參數清單。

  3. 按照以下小節所述,自訂 uwc-deployed-path/WEB-INF/domain/domain-name 目錄中的特性檔案。

  4. 若要依據 Communications Express 之網域特定 URL 建構 Access Manager 登入 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 將建構如下 IS 登入 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

  5. 請在 Access Manager 配置中進行下列變更:

    1. 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

    2. [服務配置] -> [平台] 下,在 [cookie 網域] 中的 [附加 cookie 網域] 欄位中增加 virtualdomain.com

配置託管網域的參數

下列各節描述可在 Communications Express 中配置的網域設定:

配置 uwcdomainconfig.properties 檔案中的參數

uwcdomainconfig.properties 檔案用於維護與行事曆和通訊錄相關的使用者喜好設定的預設值,這些設定可根據網域一一配置。當新的使用者第一次存取 Communications Express 中的行事曆及通訊錄時,會將這些使用者喜好設定預設值動態地指定給他們。

表 6-1 列出了應用程式中的預設使用者喜好設定。

表 6–1 uwcdomainconfig.properties 檔案中的預設使用者喜好設定

參數 

預設值 

說明 

uwc-user-attr-sunUCDefaultApplication 

 

指定您登入後要顯示的頁面。 

部署 Messenger Express 以後,依預設,[郵件] 頁面將顯示為登入頁面。否則,將顯示 [行事曆] 頁面。如果未部署行事曆,則使用者將進入 [通訊錄] 頁面。 

uwc-user-attr-sunUCDefaultEmailHandler 

uc, desktop 

指定從應用程式傳送電子郵件訊息的預設電子郵件用戶端。 

您可以將預設電子郵件用戶端設定為 Messenger Express 或瀏覽器郵件用戶端。

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 

指定建立行事曆的時區。

您可從下列區域選擇任何有效的時區: 

[南/北美洲]、[歐洲/非洲]、[亞太地區]。 

表 6–2 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 

指定一天從幾點開始。 

uwc-user-attr-icsExtendedUser Prefs-ceDayTail 

18 

指定一天到幾點結束。 

uwc-user-attr-icsExtendedUser Prefs-ceInterval 

PT1H0M 

(一小時) 

指定劃分一天的間隔時間。 

在日及週檢視中,一天劃分成半小時或一小時的時間單位。 

您可以將預設的劃分值變更為 PT0H30M (半小時) 

uwc-user-attr-icsFirstDay 

在行事曆中指定一週的第一天。根據預設值,週日 (1) 被視為一週的第一天,週六 (7) 被視為一週的最後一天。 

uwc-user-icsExtendedUserPrefs -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 uwcdomain.properties 檔案中的預設通訊錄喜好設定

參數 

預設值 

說明 

uwc-user-sunAbExtended UserPrefs-abName 

個人通訊錄 

指定預設通訊錄的名稱。 

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 

指定通訊錄第二欄中顯示的值。 

您可以將欄的顯示名稱設定為: 

顯示名稱、公司、職稱、主要電話、工作電話、家庭電話、傳真電話、呼叫器電話、主要電子郵件、電子郵件 2、電子郵件 3、家庭地址、工作地址、Web URL 1、Web URL 2、行事曆 URL、可用性位址、生日、週年紀念日、組織部門、編輯、檢視行事曆

uwc-user-attr-sunAbExtended UserPrefs-abSearchDisplay Column3 

 

指定通訊錄第三欄中顯示的值。 

您可以將欄的顯示名稱設定為: 

顯示名稱、公司、職稱、主要電話、工作電話、家庭電話、傳真電話、呼叫器電話、主要電子郵件、電子郵件 2、電子郵件 3、家庭地址、工作地址、Web URL 1、Web URL 2、行事曆 URL、可用性位址、生日、週年紀念日、組織部門、編輯、檢視行事曆

uwc-user-attr-sunAbExtended UserPrefs-abSearchDisplay Column4 

edit 

指定通訊錄第四欄中顯示的值。 

您可以將欄的顯示名稱設定為: 

顯示名稱、公司、職稱、主要電話、工作電話、家庭電話、傳真電話、呼叫器電話、主要電子郵件、電子郵件 2、電子郵件 3、家庭地址、工作地址、Web URL 1、Web URL 2、行事曆 URL、可用性位址、生日、週年紀念日、組織部門、編輯、檢視行事曆

}配置 personalstore.properties 檔案

修改 personalstore.properties 檔案中的參數,以配置通訊錄存放區、公司目錄以及任何遠端目錄。

表 6-4 列出了儲存在 personalstore.properties 檔案中的設定。

表 6–4 儲存在 personalstore.properties 檔案中的配置設定

參數 

預設值 

說明 

db.defaultpsrootpattern 

ldap://piPStore Owner=%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 檔案

defaultps.xml 檔案包含使用者首次登入時在 LDAP 存放區中建立的個人通訊錄和公司通訊錄的預設定義。

每個通訊錄節點均包含一個為使用者建立的通訊錄定義,defaultps.xml 檔案常駐於這些使用者所在的網域之下。

以下是 defaultps.xml 中的 XML 區段範例,其中包含個人通訊錄和公司通訊錄定義。

個人通訊錄 XML


範例 6–1 包含個人通訊錄定義的 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\>

公司目錄 XML


範例 6–2 包含公司通訊錄定義的 XML 區段


<book booktype="abook"
bookremoteurl="ldap://corpdirectory"\>
<bookoc\>piRemoteBook</bookoc\>
<entry entryID="idirectory"\>
<displayname\>_Corporate Directory</displayname\>
<description\>_This is Corporate Directory</description\>
</entry\>
</book\>

Procedure公司通訊錄

對於公司和遠端通訊錄,在 personalstore.properties 檔案中應該存在相應的 xxx 實例。應該為 personalstore.properties 檔案中的 db.xxx.urlmatch 值指定 defaultps.xml 檔案中的 bookremoteurl 屬性值。

若要增加新的遠端通訊錄,需要增加下列項目:

步驟
  1. defaultps.xml 檔案中增加一個新通訊錄節點。

  2. personalstore.properties 檔案中增加一個新 xxx 實例。

  3. WEB-INF/config 下建立一個目錄,以儲存 db_config.propertiesxlate 檔案。


    備註 –

    xlate 檔案包含連絡人或群組的 LDAP 模式與通訊錄 XML 模式之間的欄位對映。


自訂全域 GUI

主題檔案包含 Communications Express 中出現的圖示邏輯名稱及其預設位置。如果要變更影像位置,請變更本檔案中指定的路徑。預設 theme.properties 檔案位於 uwc-deployed-path/WEB-INF/skin 中。

配置 uwcdomainconfig.properties 檔案中的語言

uwcdomainconfig.properties 檔案包含網域支援的語言清單。清單中的各種語言都用分號分隔。您可以定義 Communications Express 將為網域支援的語言清單。

例如,如果您計劃要在名為 siroe.com 的網域中支援 en (英文)、de (德語)、fr (法語) 和 ja (日文),則請將該網域 uwcdomainconfig.properties 檔案中的 supportedLanguages 設定為 supportedLanguages=en;fr;de;ja

siroe.comuwcdomainconfig.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 檔案的可用性會決定用於使用者階段作業的語言。