ネーミングサービスのカスタマイズ
ネーミングサービスでは、Windchill サービス代理メカニズムを使用して、作成する新しい CAD ドキュメントの次の設定を指定できます。
• CAD ドキュメントの番号の設定
• CAD ドキュメントの名前の設定
 |
ネーミングサービスはアップロード操作でのみ使用できます。
|
|
|
Windchill 10.0 より前でも、アップロード時のネーミングサービスのカスタマイズを使用して、カスタムコードを使用する名前と番号を生成できます。ただし、Windchill 10.0 より前のリリースでは、ネーミングサービスのカスタマイズで使用するためのパラメータが、アップロードリクエストに表示されません。
|
ネーミングポリシーとカスタマイズに使用される優先順位は以下のとおりです。
• 名前
1. ネーミングサービスのカスタマイズ
2. ネーミングのパラメータセット (ネーミングパラメータ)。
3. ファイル名 (「名前からファイル拡張子をドロップ」プリファレンス) は、名前がファイル名 (CAD 名) に基づいて割り当てられている場合にのみ有効です。
• 番号
1. ネーミングサービスのカスタマイズ
2. 番号付けのパラメータセット (「番号付けパラメータ」)。
3. ファイル名 (「番号からファイル拡張子をドロップ」プリファレンス) は、名前がファイル名 (CAD 名) に基づいて割り当てられている場合にのみ有効です。
標準の Windchill ネーミングおよび番号付けポリシーが会社のニーズに対応していない場合は、サービスをカスタマイズして、カスタムロジックに基づいて CAD ドキュメントに名前と番号を割り当てることができます。ネーミングサービスをカスタマイズするには、以下の手順を使用します。
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; }
docName; 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. 新しいクラスで、以下のメソッドを使用して、CAD ドキュメント (EPMDocument) をネーミング/番号付けするビジネスロジックを実装します。
public void validateDocumentIdentifier(DocIdentifier docIdentifier)
◦ DocumentIdentifier オブジェクトは、アップロードサービスで作成される CAD ドキュメントの CAD ドキュメント名および番号情報を持っています。
次のコマンドを使用して、この DocIdentifier オブジェクトが表現する CAD ドキュメントの CAD 名を取得します。
DocIdentifier.getModelName()
◦ CAD アプリケーション指定のパラメータを使用して CAD ドキュメントの番号付け/ネーミングを設定することができます。
次のコマンドを使用して、関連パラメータを取得します。
DocIdentifier.getParameters()
DocIdentifier で set メソッドを使用して、新しい名前/番号値を設定します。アップロードサービスでは、適切な場合はこれらの値を使用します。実装例は次の場所にあります。
<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. メソッドサーバーを再起動します。