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
• promote
|
|
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
◦ partType
• Für zugehörige ECN
◦ number
◦ orgid
◦ resolutionDate
• Für promote
◦ number
◦ orgid
◦ approvers
◦ approveDates
◦ reviewers
◦ reviewDates
|
 |
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.
• Wenn mehr als eine Revision desselben Teils mit dem CAD-Dokument verknüpft ist, wird die neueste Revision jedes Teils 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 an der Änderungsnachricht als Ergebnisobjekt teilnimmt, werden die Attribute zu der Änderungsnachricht an den CAD-Parameter gesendet.
• Wenn die Revision des CAD-Dokuments an mehr als einer Änderungsnachricht teilnimmt, wird das verwendete Trennzeichen durch die serverseitige Einstellung > definiert.
• Die zurückgewiesenen Änderungsnachrichten werden nicht aufgelistet.
Für den Erhöhungsantrag:
• Wenn die Version des CAD-Dokuments am Erhöhungsantrag teilnimmt, werden die Attribute der Erhöhung an den CAD-Parameter gesendet.
• Wenn die Version des CAD-Dokuments an mehr als einem Erhöhungsantrag teilnimmt, wird das verwendete Trennzeichen durch die serverseitige Einstellung > definiert.
• Der zurückgewiesene Erhöhungsantrag wird nicht aufgelistet.
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). Parameter, die mit PTC oder PROI beginnen, werden als reservierte Systemparameter betrachtet und können nicht durch Anpassung übertragen werden. 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 wie "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>
Übernehmen Sie die Änderungen danach mit dem Tool xconfmanager für die Datei service.properties. (Führen Sie xconfmanager -p aus.)
Geben Sie den Pfad Ihrer Klasse als Wert für com.ptc.windchill.uwgm.proesrv.c11n.DefaultModeledAttributesDelegateserviceClass an (d.h. ersetzen Sie durch den Pfad Ihrer Klasse).
3. Starten Sie den Methodenserver neu.