Parameter im Herunterladedienst anpassen
Vordefinierter Delegate
Windchill bietet einen vordefinierten Mechanismus, um zusätzliche Informationen zum CAD-Dokument als benutzerdefinierte Systemparameter zu übergeben.
Legen Sie zum Anpassen der Parameter die serverseitige Einstellung > auf Standortebene fest.
• Der Wert ist eine Liste zusätzlicher Attribute von Objekten, die zu dem CAD-Dokument gehören und die im CAD-Tool als Parameter oder Eigenschaften angezeigt werden.
• Der Wert ist eine kommagetrennte Liste von Paaren aus CAD-Eigenschaften und Windchill Attributen im folgenden Format:
<name_of_CAD_property>:<relatedObjectCode>.<WindchillAttributeName>
Dabei gilt:
|
Wert
|
Beschreibung
|
Zulässige Werte
|
|
name_of_CAD_property
|
Dies ist der Name des Parameters oder der Eigenschaft im CAD-Tool.
|
PART_REVISION
|
|
relatedObjectCode
|
Dies ist die Zeichenfolge, die verwendet wird, um das zugehörige Objekt zu identifizieren.
|
• docMaster
◦ associatedPart
◦ relatedECN
|
|
WindchillAttributeName
|
Dies ist der logische Name oder der interne Name des Attributs in Windchill für das zugehörige Objekt.
|
• Soft-Type-Attribute für CAD-Dokument-Master
• Teileattribute
◦ Soft-Type-Attribut für das zugehörige Teil des Typs "Boolesch", "Datum", "Ganzzahl", "Reell", "Reell mit Einheiten" oder "Zeichenfolge"
◦ lifeCycleState
◦ lifecycleTemplate.name
◦ name,
◦ number
◦ orgid
◦ view.identity
• Für zugehörige ECN
◦ number
◦ orgid
◦ resolutionDate
|
 |
Für Soft-Type-Attribute sind Werte, die an das CAD-Tool gesendet werden, die Anzeigewerte, wie sie auf der Informationsseite des Objekts angezeigt werden. Anzeigewerte verwenden die Einstellungen für die Attributhandhabung und die Typ- und Attributverwaltung, unterstützen jedoch keine komplexen Darstellungsanpassungen mithilfe von Datendienstprogrammen zum Rendern.
|
Diese Funktion kann nur verwendet werden, wenn kein benutzerdefinierter serverseitiger Delegate CustomModeledAttributesDelegate vorhanden ist, der zum Einfügen von Parametern verwendet werden kann (siehe nächster Abschnitt unten für "Benutzerdefinierter Delegate").
Für das zugeordnete Teil:
• Diese Funktion unterstützt Teile, die zu dem CAD-Dokument gehören, mit einem Besitzer, beitragendem Bild, Bild und beitragendem Inhalt.
• Die ausgewählte Teileversion ähnelt der Teiletabelle auf der Informationsseite für das CAD-Dokument.
• Die neueste Revision jedes Teils wird zurückgegeben.
• Es kann mehr als ein Teil zurückgegeben werden, wenn das System so konfiguriert ist, dass mehrere Build-Zuordnungen zulässig sind, wobei die serverseitige Einstellung > > auf Ja festgelegt sein muss. In diesem Fall werden die Informationen für jedes zugehörige Teil in einem durch Trennzeichen getrennten Format zurückgegeben. Das verwendete Trennzeichen wird durch die serverseitige Einstellung > definiert.
Für die zugehörige Änderungsnachricht:
• Wenn die Revision des CAD-Dokuments als betroffenes Objekt oder Ergebnisobjekt in der Änderungsnachricht enthalten ist:
◦ Wenn die Revision des CAD-Dokuments als betroffenes Objekt oder Ergebnisobjekt in der Änderungsnachricht enthalten ist:
◦ Das verwendete Trennzeichen wird durch die serverseitige Einstellung > definiert.
Benutzerdefinierter Delegate
Wenn Ihr Geschäftsprozess erfordert, dass andere Attribute an das CAD-Tool kommuniziert werden, stellt Windchill einen serverseitigen Delegate bereit, der nach dem Download zum Einfügen von Parametern in ein Creo Parametric Modell verwendet werden kann. Mit diesem Mechanismus lassen sich Informationen vom Server an Creo Parametric weitergeben, wo sie dann wie andere Creo Parametric Parameter verwendet werden können (z.B. zum Platzieren von Information in Zeichnungsformularen). Mit "PTC" oder "PROI" beginnende Parameter gelten als vom System reservierte Parameter, die nicht durch die Anpassung übertragen werden können. Werden solche Parameter bei der Anpassung hinzugefügt, werden sie vom Herunterladedienst ignoriert.
|
|
Diese Funktionalität ist bei allen Windchill Workgroup Manager verfügbar, die in CAD-Tools von Drittanbietern integriert werden können.
|
|
|
Die angepassten Parameter werden beim Herunterladen für den Client bereitgestellt, und – im Gegensatz zu Systemparametern wie PTC_WM_ITERATION – nicht in der Creo Parametric Sitzung oder dem lokalen Cache aktualisiert, nachdem eine Windchill Operation (z.B. Einchecken) ausgeführt wurde.
|
Wenn einem angepassten Parameter z.B. der Wert der CAD-Dokumentnummer zugewiesen ist, wird dieser Wert beim Herunterladen des Modells für den Client bereitgestellt. Wird das CAD-Dokument später neu nummeriert, wird der Wert in der Creo Parametric Sitzung oder im Client-Cache nicht automatisch aktualisiert.
Der Delegate-Mechanismus des Windchill Dienstes wird verwendet, um die Anpassung zu ermöglichen. Die folgenden Schritte bieten einen Überblick über den Anpassungsprozess:
1. Erstellen Sie eine Java-Klasse, die die Schnittstelle ModeledAttributesDelegate implementiert. Die Schnittstellendefinition lautet folgendermaßen:
package com.ptc.windchill.uwgm.proesrv.c11n;
import java.util.Collection;
import java.util.HashMap;
import wt.util.WTException;
public interface ModeledAttributesDelegate
{
/*
Implement this API to return list of parameters added by
customization along with it's type (customization profile of the
server). For example "WT_CADDOC_NUMBER" custom parameter will
be of type "String.class" (the java class)
*/
// getAvailableAttributes() returns
// HashMap<String, Object> which contains
// HashMap<Attribute name, Attribute type>
HashMap getAvailableAttributes();
/*
This is the API, invoked by the download service on download, to
be implemented for the customization. Create and return a
HashMap where key is input object and value is HashMap of
parameter name - value pairs that must be propagated to Pro/E
part represented by the EPMDocument (input object). Use the
getCADName() API on the EPMDocument to identify the Pro/E part
*/
// getModeledAttributes(Collection docs) returns
// HashMap<input object, HashMap<Attribute name, Attribute
value> HashMap getModeledAttributes(Collection docs) throws
WTException;
}
import java.util.Collection;
import java.util.HashMap;
import wt.util.WTException;
public interface ModeledAttributesDelegate
{
/*
Implement this API to return list of parameters added by
customization along with it's type (customization profile of the
server). For example "WT_CADDOC_NUMBER" custom parameter will
be of type "String.class" (the java class)
*/
// getAvailableAttributes() returns
// HashMap<String, Object> which contains
// HashMap<Attribute name, Attribute type>
HashMap getAvailableAttributes();
/*
This is the API, invoked by the download service on download, to
be implemented for the customization. Create and return a
HashMap where key is input object and value is HashMap of
parameter name - value pairs that must be propagated to Pro/E
part represented by the EPMDocument (input object). Use the
getCADName() API on the EPMDocument to identify the Pro/E part
*/
// getModeledAttributes(Collection docs) returns
// HashMap<input object, HashMap<Attribute name, Attribute
value> HashMap getModeledAttributes(Collection docs) throws
WTException;
}
2. Die von PTC bereitgestellten benutzerdefinierten Systemattribute sind standardmäßig im DefaultModeledAttributesDelegate verfügbar. Sie können jedoch die Datei "site.xconf" (in <Windchill>) ändern und die folgende Eigenschaft hinzufügen, um die Verfügbarkeit des Anpassungsdiensts auf dem Server anzugeben:
<Service context="default"
name="com.ptc.windchill.uwgm.proesrv.c11n.ModeledAttributesDele
gate" targetFile=codebase/service.properties">
<Option cardinality="singleton"
requestor="java.lang.Object"
serviceClass="com.ptc.windchill.uwgm.proesrv.c11n.CustomerXYZModeledAttributesDelegate"/>
</Service>
name="com.ptc.windchill.uwgm.proesrv.c11n.ModeledAttributesDele
gate" targetFile=codebase/service.properties">
<Option cardinality="singleton"
requestor="java.lang.Object"
serviceClass="com.ptc.windchill.uwgm.proesrv.c11n.CustomerXYZModeledAttributesDelegate"/>
</Service>
Verwenden Sie anschließend das xconfmanager-Tool, um die Änderungen auf die Datei service.properties anzuwenden (xconfmanager -p).
Geben Sie den Pfad Ihrer Klasse als Wert für serviceClass an (d.h. ersetzen Sie "com.ptc.windchill.uwgm.proesrv.c11n.DefaultModeledAttributesDelegate" durch den Pfad Ihrer Klasse).
3. Starten Sie den Methodenserver neu.