EmailRelay <CQDatabase> XML 區塊

EmailRelay <CQDatbase> XML 區塊包含 EmailRelay「PostOffice 中繼」模式用來建立與 IBM® Rational® ClearQuest® Web 伺服器通訊的屬性。需要有此通訊,才能輪詢 ClearQuest 資料庫中是否有新的 EmailPlus 電子郵件記錄。
如果您為多個 ClearQuest 使用者資料庫配置 EmailRelay 應用程式,則每一個使用者資料庫會有個別的 <repository> 區段。
註: 當您在「PostOffice 中繼」模式配置 EmailRelay 應用程式時,會忽略 <repository> 區段。
這個範例顯示如何使用 ClearQuest Web 伺服器參數:
<CQDatabase>
  <repository connection_timeout="30000" dbname="SAMPL" dbset="EmailPlus" is_enabled="yes" keyfile="" password="" payloaddumpdir="C:\EmailRelay" retries="3" socket_timeout="30000" url="http://your.cqweb.com/cqweb/oslc/" username="admin"/>
</CQDatabase>
表 1. <repository> XML 區塊屬性
屬性名稱 說明
connection_timeout 包含一個整數,指定 EmailRelay 會等待多久時間(毫秒)才會放棄與 ClearQuest Web 伺服器的連線要求。預設值為 30000,即 30 秒。如果 ClearQuest Web 伺服器的利用率很高,且 EmailRelay 報告連線逾時,則請增加此值。記住,傳送電子郵件的時間將會更久。
註: 為獲得最佳結果,connection_timeoutsocket_timeout 應設為相同值。
dbname 包含 ClearQuest 使用者資料庫名稱。您無法變更此屬性的值。會根據您傳遞至 -userdb 參數的參數自動產生此值。
dbset 包含 ClearQuest 主要資料庫名稱。您無法變更此屬性的值。會根據您傳遞至 -dbset 參數的參數自動產生此值。
is_enabled 包含 yesno 值。預設值為 yes。您可以暫時變更此屬性的值,以停止傳送此 ClearQuest 儲存庫的電子郵件。例如,當您執行批次更新時,您可以停止傳送電子郵件通知。
keyfile 包含金鑰檔名稱,其中具有將 password 屬性所儲存的使用者密碼解密的金鑰。您不需要變更此屬性的值。會根據 -relaycfgdir 參數的值自動產生此值。
重要: 如果您變更此屬性的值,例如檔名或目錄路徑,則您也必須對實體金鑰檔進行相同的變更。
password 包含 ClearQuest 使用者的加密密碼。
註: 您無法變更此屬性的值。會根據您傳遞至 -password 參數的參數自動產生此值。
payloadddumpdir 包含內容所傾出至的目錄。內容是指從 EmailPlus 套件接收的電子郵件資料。此屬性的值是以 -dumppayload 屬性的值為根據。您可以變更此屬性的值,以指定不同位置。
註: 這個屬性是選用的。唯有使用 -dumppayload 屬性時才會產生此屬性。只在進行 EmailRelay 應用程式問題的除錯時,才使用此屬性。
retries 包含大於 -1 的整數。此值代表連線嘗試失敗時試圖重新與 ClearQuest Web 伺服器進行通訊的次數。預設值為 3。您可以變更此屬性的值。如果 EmailRelay 應用程式和 ClearQuest Web 伺服器之間有通訊問題,請增加此屬性的值。
socket_timeout 包含一個整數,指定 EmailRelay 會等待多久時間(毫秒)才會放棄 ClearQuest Web 伺服器的 Socket 連線要求。預設值為 30000,即 30 秒。如果網路環境和 ClearQuest Web 伺服器的利用率很高,且 EmailRelay 報告連線逾時,則請增加此值。記住,傳送電子郵件的時間將會更久。
註: 為獲得最佳結果,connection_timeoutsocket_timeout 應設為相同值。
url 包含 EmailRelay 伺服器用來輪詢 ClearQueset 資料庫是否有新的 EmailPlus 電子郵件記錄的 URL。此屬性值是根據 -servername 屬性的值而自動產生。您可以變更此屬性的值。例如,當 ClearQuest Web 伺服器位置變更,而您想要此變更反映在 XML 區塊中,但不執行 cqemailrelay.pl Script 時,您可以變更此值。
username 包含 EmailRelay 應用程式連接到 ClearQuest Web 伺服器時,ClearQuest 使用的名稱。會根據您傳遞至 -password 屬性的參數自動產生此屬性的值。

意見