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 目錄中的特性檔案。
若要依據 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。
請在 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-sunUCDefaultEmailHandler |
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-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 檔案中的參數,以配置通訊錄存放區、公司目錄以及任何遠端目錄。
表 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 檔案包含使用者首次登入時在 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 實例。應該為 personalstore.properties 檔案中的 db.xxx.urlmatch 值指定 defaultps.xml 檔案中的 bookremoteurl 屬性值。
若要增加新的遠端通訊錄,需要增加下列項目:
在 defaultps.xml 檔案中增加一個新通訊錄節點。
在 personalstore.properties 檔案中增加一個新 xxx 實例。
在 WEB-INF/config 下建立一個目錄,以儲存 db_config.properties 和 xlate 檔案。
xlate 檔案包含連絡人或群組的 LDAP 模式與通訊錄 XML 模式之間的欄位對映。
主題檔案包含 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 檔案的可用性會決定用於使用者階段作業的語言。