自訂命名服務
命名服務使用 Windchill 服務委派機制，讓您為要建立的新動態文件指定下列各項：
• 為動態文件設定編號。
• 為動態文件設定名稱。
 |
在 Windchill 10.0 之前可以在上載中使用命名服務自訂來透過自訂程式碼產生名稱與編號。但是，在 Windchill 10.0 之前的發行版本中，您無法在上載請求中將參數用於命名服務自訂。
|
|
|
命名服務只適用於上載動作。
|
系統用於命名原則與自訂的優先順序如下所示。
• 名稱
1. 命名服務自訂。
2. 針對命名設定的參數 (命名參數)。
3. 檔案名稱 (只有在根據檔案名稱 (應用程式名稱) 指派了名稱的情況下，「上載去除名稱副檔名」偏好設定才有效)。
• 編號
1. 命名服務自訂。
2. 針對編號設定的參數 (編號參數)。
3. 檔案名稱 (只有在根據檔案名稱 (應用程式名稱) 指派了名稱的情況下，「上載去除編號副檔名」才有效)。
如果 Windchill 命名與編號原則無法滿足您公司的需求，您可以自訂命名與編號服務來根據自訂將名稱與編號指派給動態文件。請使用下列步驟自訂命名服務：
1. 建立實行介面 EPMDocumentNamingDelegate 的「Java 類別」。介面定義如下。
package com.ptc.windchill.uwgm.proesrv.c11n;
public interface EPMDocumentNamingDelegate
{
public void validateDocumentIdentifier
(DocIdentifier docIdentifier);
(DocIdentifier docIdentifier);
}
類別 DocIdentifier 的定義如下：
package com.ptc.windchill.uwgm.proesrv.c11n;
import java.util.HashMap;
public class DocIdentifier
{
private String m_modelName;
private String m_docName;
private String m_docNumber;
private HashMap m_parameters;
private String m_docName;
private String m_docNumber;
private HashMap m_parameters;
public DocIdentifier(String modelName, String docName,
String docNumber, HashMap params)
String docNumber, HashMap params)
{ m_modelName = modelName; m_docName= docName;
m_docNumber= docNumber;
m_parameters= params; }
m_docNumber= docNumber;
m_parameters= params; }
/** get the CAD Name for the model **/
public String getModelName()
{ return m_modelName; }
/** get the EPMDocument name for the model **/
public String getDocName()
{ return m_docName; }
/** set the EPMDocument name for the model **/
public void setDocName(String docname)
{ m_docName = docname; }
/** set the EPMDocument number for the model **/
public void setDocNumber(String docnumber)
{ m_docNumber = docnumber; }
/** get the EPMDocument number for the model **/
public String getDocNumber()
{ return m_docNumber; }
/** get the Pro/E designated parameters for the model.
These are name-value pairs indexed by the name **/
These are name-value pairs indexed by the name **/
public HashMap getParameters()
{ return m_parameters; }
}
2. 在新類別中，使用以下方法針對命名/編號動態文件 (EPMDocument) 實行企業邏輯：
public void validateDocumentIdentifier(DocIdentifier docIdentifier)
◦ DocumentIdentifier 物件擁有將由「上載服務」建立的動態文件的動態文件名稱與編號資訊。
使用
DocIdentifier.getModelName()
取得此 DocIdentifier 物件所代表的動態文件的「CAD 名稱」。
◦ 指派了參數的編寫應用程式可以用來設定動態文件編號/命名。
使用
DocIdentifier.getParameters()
取得關聯參數。
使用 DocIdentifier 上的設定方法來設定新名稱/編號值。如果可行，「上載服務」會使用這些建議。您可以在下列位置找到範例實行：
<Windchill home>/codebase/com/ptc/windchill/uwgm/proesrv/
c11n/EPMDefaultDocumentNamingDelegate.java
c11n/EPMDefaultDocumentNamingDelegate.java
3. 編輯 site.xconf 檔案 (位於 <Windchill> 中) 來新增下列屬性，以指示伺服器上自訂服務的可用性：
<Service context="default" name="com.ptc.windchill.uwgm.proesrv.c11n.
EPMDocumentNamingDelegate" targetFile="codebase/service.properties">
EPMDocumentNamingDelegate" targetFile="codebase/service.properties">
<Option cardinality="singleton" requestor="wt.epm.EPMDocument"
serviceClass="com.ptc.windchill.uwgm.proesrv.c11n.EPMDefaultDocument
NamingDelegate"/>
serviceClass="com.ptc.windchill.uwgm.proesrv.c11n.EPMDefaultDocument
NamingDelegate"/>
</Service>
然後使用 xconfmanager 工具將變更套用至 service.properties 檔案·(執行
xconfmanager -p
)
使用您類別的路徑來取代 serviceClass 的值 (也就是使用您類別的路徑來取代
com.ptc.windchill.uwgm.proesrv.c11n.EPMDefaultDocumentNami ngDelegate
)。
4. 重新啟動應用伺服器。