Personalizzazione del naming service
Predefinito
Quando l'utente crea un documento CAD utilizzando le azioni di salvataggio e caricamento di Creo, viene progettato un delegato predefinito per fornire i valori di nome e numero del documento CAD.
 |
Il naming service può essere utilizzato solo con l'azione di caricamento.
|
Viene illustrato di seguito l'ordine di precedenza utilizzato dal sistema per le regole di denominazione e per le personalizzazioni.
• Nome:
a. Personalizzato: personalizzazione del naming service.
b. PTC_COMMON_NAME: nome comune esplicitamente assegnato tramite la finestra Creo Parametric > .
c. Basato su parametro: parametro nome ( > > > = <parametro stringa>).
d. Basato su nome: nome del file. La preferenza > > > ha effetto solo se il nome è assegnato in base al nome del file (Nome CAD)
• Numero:
a. Personalizzato: personalizzazione del naming service.
b. Numerazione automatica: quando la preferenza > > è impostata su Non sincronizzare nome file e numero, le regole di inizializzazione oggetto vengono utilizzate per generare un numero.
c. Basato su parametro: parametro numero ( > > > )
d. Basato su nome: la preferenza > > > ha effetto solo se il numero è assegnato in base al nome del file [Nome CAD].
|
|
Il nome del file può essere numerato automaticamente quando vengono configurate le regole di inizializzazione oggetto.
|
Per ulteriori informazioni sulle regole di denominazione e numerazione, vedere Denominazione e numerazione gestite da regole.
Naming service personalizzato con delegato
Il naming service utilizza il meccanismo di delega del servizio Windchill per consentire all'utente di creare un delegato Java con priorità rispetto a qualsiasi comportamento predefinito per fornire un valore per il nome o il numero del documento CAD.
Per personalizzare il naming service, attenersi alla procedura descritta di seguito.
1. Creare una classe Java che implementi l'interfaccia EPMDocumentNamingDelegate. La definizione dell'interfaccia è la seguente:
package com.ptc.windchill.uwgm.proesrv.c11n;
public interface EPMDocumentNamingDelegate
{
public void validateDocumentIdentifier(DocIdentifier
docIdentifier);
}
public interface EPMDocumentNamingDelegate
{
public void validateDocumentIdentifier(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;
}
public DocIdentifier(String modelName, String
docName, String docNumber, HashMap params)
{
m_modelName = modelName;
m_docName= 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 **/
public HashMap getParameters()
{
return m_parameters;
}
}
import java.util.HashMap;
public class DocIdentifier
{
{
private String m_modelName;
private String m_docName;
private String m_docNumber;
private HashMap m_parameters;
}
public DocIdentifier(String modelName, String
docName, String docNumber, HashMap params)
{
m_modelName = modelName;
m_docName= 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 **/
public HashMap getParameters()
{
return m_parameters;
}
}
2. Implementare nella nuova classe la logica aziendale per la denominazione/numerazione dell'EPMDocument nel metodo:
public void validateDocumentIdentifier(DocIdentifier docIdentifier)
◦ L'oggetto DocumentIdentifier contiene informazioni sul nome e sul numero dell'EPMDocument che verrà creato dal servizio di caricamento.
Utilizzare DocIdentifier.getModelName() per ottenere il nome CAD dell'EPMDocument rappresentato da questo oggetto DocIdentifier.
◦ È possibile utilizzare gli appositi parametri di Creo Parametric per impostare la numerazione/denominazione dell'EPMDocument.
Utilizzare DocIdentifier.getParameters() per ottenere i parametri associati.
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.
3. Modificare il file site.xconf contenuto in <Windchill> in modo da aggiungere la proprietà riportata di seguito per indicare la disponibilità del servizio di personalizzazione nel server.
<Service context="default" name="com.ptc.windchill.uwgm.proesrv.c11n.EPMDocumentNamingDelegate" targetFile="codebase/service.properties">
<Option cardinality="singleton" requestor="wt.epm.EPMDocument" serviceClass="com.ptc.windchill.uwgm.proesrv.c11n.EPMDefaultDocument NamingDelegate"/>
</Service>
<Option cardinality="singleton" requestor="wt.epm.EPMDocument" serviceClass="com.ptc.windchill.uwgm.proesrv.c11n.EPMDefaultDocument NamingDelegate"/>
</Service>
Utilizzare quindi lo strumento xconfmanager per applicare le modifiche al file service.properties (eseguire -xconfmanager p).
Utilizzare il percorso della classe al posto del valore di serviceClass , ovvero sostituire com.ptc.windchill.uwgm.proesrv.c11n.EPMDefaultDocumentNamingDelegate con il percorso della classe.
4. Riavviare il method server.