Personalizzazione del naming service
Il naming service utilizza il meccanismo di delega del servizio Windchill per consentire di specificare quanto segue per la creazione del nuovo documento CAD.
• Impostare un numero per il documento CAD.
• Impostare un nome per il documento CAD.
 |
Il naming service può essere utilizzato solo con l'azione di caricamento.
|
|
|
La personalizzazione del naming service di caricamento può essere utilizzata nelle versioni precedenti a Windchill 10.0 per generare nome e numero mediante il codice personalizzato. Nelle versioni precedenti a Windchill 10.0, non sarà tuttavia possibile utilizzare i parametri in una richiesta di caricamento per la personalizzazione del naming service.
|
Viene illustrato di seguito l'ordine di precedenza utilizzato dal sistema per le regole di denominazione e per le personalizzazioni.
• Nome
a. Personalizzazione del naming service.
b. Parametro impostato per la denominazione (Parametro di denominazione).
c. Nome file (preferenza Elimina estensione file da nome) viene applicato solo se il nome è assegnato in base al nome di file (Nome CAD).
• Numero
a. Personalizzazione del naming service.
b. Parametro impostato per la numerazione (Parametro di numerazione).
c. Nome file (preferenza Elimina estensione file da numero) viene applicato solo se il nome è assegnato in base al nome di file (Nome CAD).
Se le regole di denominazione e numerazione standard di Windchill non soddisfano le specifiche esigenze aziendali, è possibile personalizzare il servizio in modo da assegnare un nome e un numero a un documento CAD in base a questa logica personalizzata. Per personalizzare il naming service, attenersi alla procedura descritta di seguito.
1. Creare una classe Java che implementa l'interfaccia EPMDocumentNamingDelegate. La definizione dell'interfaccia è la seguente:
package com.ptc.windchill.uwgm.proesrv.c11n;
public interface EPMDocumentNamingDelegate
{
public void validateDocumentIdentifier
(DocIdentifier docIdentifier);
(DocIdentifier docIdentifier);
}
La definizione di Class DocIdentifier è la seguente:
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. Implementare nella nuova classe la logica aziendale per la denominazione/numerazione dei documenti CAD (EPMDocument) utilizzando il metodo riportato di seguito.
public void validateDocumentIdentifier(DocIdentifier docIdentifier)
◦ L'oggetto DocumentIdentifier contiene le informazioni sul nome e sul numero del documento CAD che viene creato dal servizio di caricamento.
Utilizzare il seguente comando per ottenere il nome CAD del documento CAD rappresentato dall'oggetto DocIdentifier:
DocIdentifier.getModelName()
◦ Per impostare la numerazione/denominazione del documento CAD, è possibile utilizzare i parametri designati dell'applicazione CAD.
Utilizzare il seguente comando per ottenere i parametri associati:
DocIdentifier.getParameters()
Utilizzare i metodi set sull'oggetto DocIdentifier per impostare i nuovi valori del nome e del numero. Il servizio di caricamento utilizza questi suggerimenti, se applicabili. L'implementazione di esempio si trova nella seguente posizione:
<Windchill home>/codebase/com/ptc/windchill/uwgm/proesrv/
c11n/EPMDefaultDocumentNamingDelegate.java
c11n/EPMDefaultDocumentNamingDelegate.java
3. Modificare il file site.xconf (reperibile in <Windchill>) per aggiungere la seguente proprietà per indicare la disponibilità del servizio di personalizzazione sul server:
<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>
Utilizzare quindi lo strumento xconfmanager per applicare le modifiche al file service.properties:
xconfmanager –p
Utilizzare il percorso della classe al posto del valore di serviceClass, ovvero sostituire quanto segue con il percorso della classe:
com.ptc.windchill.uwgm.proesrv.c11n.EPMDefaultDocumentNami ngDelegate
4. Riavviare il method server.