Info*Engine Servlet
Info*Engine servlet 在 Info*Engine 與 web 伺服器之間提供一個介面。您可以使用 servlet 來透過 HTTP 或 HTTPS 直接呼叫 Info*Engine 任務。透過 Info*Engine servlet 呼叫任務時,「Info*Engine 虛擬資料庫」(VDB) 會在回應中轉換為 XML。
此表單還會為 SOAP RPC servlet 提供預設組態。SOAP (簡易物件存取通訊協定) 是協力廠商應用程式可以使用的輕量級 XML 通訊協定。Info*Engine SOAP servlet 會找到及處理在 Web 上發出之 Info*Engine SOAP 請求,進而讓您交換資訊並在遠端執行自訂 Info*Engine 企業任務。如需詳細資訊,請參閱 SOAP 服務。
如需有關此處未列出之屬性的資訊,以及使用可用表單按鈕及正確輸入屬性值的指示,請參閱
常用屬性與動作。
證明對應屬性
您可以指定要使用的證明檔,來透過伺服器設定認證對應。證明檔可以讓使用者以適用於一或多個轉接器的證明登入伺服器。
通常會在 wt.properties 檔案中而不是透過「內容管理」公用程式來配置證明對應內容。但是,在配置新轉接器時,您可以使用「內容管理」公用程式來設定某些認證對應內容。
認證對應程式
credentialsMapper
網站針對透過 Info*Engine 驗證使用者所建立之驗證任務的相對路徑。此路徑是已配置的任務根目錄的相對路徑。此內容為選用內容。
呼叫企業任務處理器以執行企業任務時,它會檢查 credentialsMapper 內容。如果已設定內容,任務處理器會在執行其已指派任務之前執行驗證對應任務。認證對應任務可將使用者名稱作為金鑰使用,利用此金鑰可從一或多個轉接器可存取的資訊系統中取得使用者特定認證資訊。然後可以利用這些認證資訊建立一個輸出群組。
如果未指定 credentialsMapper 內容,Info*Engine 不會在執行指定任務之前,執行以伺服器為基礎的驗證對應任務。
認證檔
credentialsFiles
網站所建立的用於儲存各個使用者驗證對應檔案之目錄的相對路徑。每個對應檔案的名稱都必須與傳遞到 Info*Engine 之已驗證的使用者名稱相符。此目錄路徑是已配置的任務根目錄的相對路徑。此內容為選用內容。
◦ 如果未指定此內容,Info*Engine 不會尋找驗證對應檔案。
◦ 如果已指定此內容,Info*Engine 會嘗試開啟並讀取對應於所提供之使用者名稱的驗證對應檔案
會在執行企業任務以及執行在 credentialsMapper 內容中命名的任務之前開啟檔案。
有效的認證時間
credentialsTimeToLive
此內容透過允許任務處理器從快取中讀取驗證資訊來改進效能。否則,任務處理器會在每次讀取驗證檔案或執行驗證對應任務時呼叫驗證資訊。
此內容的值為驗證資訊在進行重新整理之前快取的毫秒數。值必須是正整數,否則會略過此值。如果未定義內容,則不會快取驗證群組資訊,效能也會維持原來的效能。
任務編譯器屬性
您可以指定編譯器屬性,來設定已編譯任務的位置,以及需要新增至類別路徑的其他任何檔案。
任務根目錄
taskRootDirectory
XML 企業任務之根目錄的路徑。
Servlet 可以在其下找到所有 XML 企業任務的根檔案系統目錄。這可讓 servlet 本機編譯及執行任務。
如果在沒有任務處理器的情況下執行 servlet,此內容很有用。
Codebase
codebase
編譯後任務所在的目錄。
編譯器類別路徑
compiler.classpath
編譯任務時,要新增到類別路徑的其他 JAR 與類別檔。輸入標準 Java 類別路徑。針對 Windows 系統,請使用分號 (;) 來作為路徑分隔符號。針對 Unix 系統,請使用冒號 (:) 來作為路徑分隔符號。
程式庫目錄 n
compiler.libDirectoryn
如果已將其他 JAR 與類別檔新增至類別路徑,請使用此欄位來指定這些檔案所在的目錄。
n 的第一個值必須是 1,而且其值必須循序增加。
一般屬性
欲指定一般屬性,請使用以下欄位:
主目錄
home
Info*Engine 根安裝目錄。Info*Engine 的根安裝目錄與 Windchill 的根安裝目錄 (wt.home) 相同。
伺服器名稱
ieServerName
Servlet 使用之 Info*Engine 伺服器或任務處理器的名稱。依預設,會提供此值。
任務前綴
taskPrefix
參考 XML 企業任務之 URL 中使用的前綴。這個前綴可以協助 servlet 決定要將請求傳送至任務處理器還是範本處理器。預設值為 /infoengine/servlet/IE/tasks/。
Info*Engine servlet 為任務處理器提供以此前綴開頭的 URL。例如,如果使用預設前綴,會將 web 伺服器命名為 "myServer",且使用者要輸入下列 URL:
http://myServer/infoengine/servlet/IE/tasks/myTask.xml
Info*Engine servlet 會將 URL 交給任務處理器,然後由任務處理器找出及執行 "myTask.xml"。
您必須將前綴中的第一個項目設定為與您針對應用程式 URL 輸入的值相同。當將 servlet 引擎配置為與 Info*Engine servlet 一起執行時,會設定此項。若是 JRun 與 Tomcat servlet engine,Windchill 會為您設定前綴值與對應的 servlet 引擎設定。
|
PTC 建議您不要變更前綴的 /servlet/IE/tasks/ 部份。如果您變更前綴的這一部份,必須在 servlet 引擎中進行手動變更。如果要允許其他的 URL 參考前綴,可以在 web 伺服器中設定 URL 重新導向。
|
啟動任務 n
startupTaskn
您可以配置 Info*Engine 以在啟動時執行特定任務。例如,您可以自動產生「佇列」或「事件」訂閱。n 的第一個值必須是 1,而且其值必須循序增加,例如下列範例:
com.infoengine.startupTask1=msg/subscribeQueue.xml
當 Info*Engine 啟動時,此內容的值是啟動之任務的路徑。
XML 剖析器偵錯
request.xmlParser.debug
啟用 XML 剖析器偵錯。當針對偵錯目的剖析引入 XML 時,此選項會列印資訊。
請求偵錯
request.xmlStream.debug
啟用 XML 記錄請求。這會針對偵錯目的而列印引入 XML。
傳送郵件 Webject 屬性
傳送郵件 webject 會建立及傳送電子郵件訊息。配置傳送郵件 webject 屬性可讓您在執行 webject 時設定某些預設值。
預設郵件創始者
mail.originator
傳送郵件 webject 使用的預設創始者 (傳送訊息的電子郵件位址)。
與 FROM webject 參數對應。
預設 SMTP 伺服器
mail.smtp.server
傳送郵件 webject 使用的預設伺服器。
預設 SMTP 使用者名稱
mail.smtp.username
當連接至 SMTP 伺服器時提供的預設使用者名稱。
與 USERNAME 參數對應。
[預設 SMTP 密碼]
mail.smtp.password
與「預設 SMTP 使用者名稱」相關聯的預設密碼。
與 PASSWORD 參數對應。
屬性管理員屬性
管理基礎 URI
「內容管理」公用程式使用者介面的預設基礎 URI。此值可決定會將哪些服務、轉接器以及屬性集列在「內容管理」主頁上。
指定完整、合格的 LDAP URL,以指向可以進行配置的內容位置。
動態屬性組態
服務或轉接器的組態資訊可在服務或轉接器執行的同時更新,如此一來,您不需要重新啟動即可更新屬性。
「存留時間」屬性會指定在自動重新載入服務或轉接器屬性之前已經過的時間,單位為分鐘。屬性只會在受存取時自動重新載入。依預設,屬性不會過期。
其他屬性
如果未在表單上定義屬性,可以在「其他內容」欄位中進行新增。新增其他屬性時,屬性名稱格式為轉接器項目的名稱 (服務名稱) 後跟屬性名稱。例如:
<service_name>.dbuser
在適當的欄位中,指定服務或轉接器使用的屬性及該屬性的值。按一下新屬性名稱旁邊的「新增」可開啟文字方塊,您可以在其中修改屬性值。
如果值變得太長,而無法檢視其整體,則會顯示「編輯」動作。按一下「編輯」可開啟擁有較大文字區域的新瀏覽器視窗。