Sektion |
Action |
Muss Feld |
nein |
Typ |
Text (String) |
Standardwert |
|
Beschreibung
Die Aktion "com.cop.job.COPJobCopyValue " kopiert bestimmte Attributwerte auf andere Elemente. Damit erreichen sie u.a., dass Benennungen von Stammdaten, 2D Zeichnungen und 3D Modelle immer gleich sind.
COPjar kopiert den Wert des konfigurierten Attributs (SourceAttribute) auf Elemente der Zielklasse (TargetClass). Die Zielelemente sind Kinder (children) oder Eltern (parents) des zu verarbeitenden Elementes. COPjar kopiert den Wert in das Zielattribut (TargetAttribute), sofern das Zielelement einen gültigen Status (TargetValidState) hat.
Folgende Tags konfigurieren die Aktion "com.cop.job.COPJobCopyValue":
Tag |
Beschreibung |
Definiert die Klasse des Quellelementes. COPjar kopiert nur Werte von Elementen, die der in <QuellClass> konfiguriert Klasse angehören. Beispiel: <QuellClass>MASTERDATA</QuellClass> |
|
Definiert das Attribut, dessen Wert auf das Zielelement übertragen wird. |
|
Definiert ob das zu verarbeitende Element das Quellelement ist. Ist <IsSource> gleich true, dann kopiert COPjar den Wert des Attribut <SourceAttribute> des aktuell zu verarbeitende Elementes auf das Zielelement. |
|
Definiert die Zielklassen. COPjar kopiert nur Werte auf Elemente, die einer Klasse zugehören, die in <TargetClass> konfiguriert sind. In <TargetClass> können mehrere durch Komma getrennte Klassennamen konfiguriert sein. Beispiel: <TargetClass>DRAWING_2D, MODEL_3D</TargetClass> |
|
COPjar überträgt den Wert in dieses Zielattribut. |
|
COPjar überträgt den Wert, falls das Zielelement diesen Status hat. |
|
Definiert ob, das aktuell zu verarbeitende Element das Zielelement ist. Ist <IsTarget> gleich true, dann kopiert COPjar den Wert aus dem Attribut <SourceAttribute> des Quellelements in das Attribut <TargetAttribute> vom Zielelement. |
|
Diese Tag gibt COPjar vor, welche Beziehungen die Zielelement zum Quellelement haben müssen.
<Relatives>children</Relatives> COPjar überträgt Werte nur auf direkte Kinder des Quellelements. Zum Beispiel 2D Zeichnungen oder 3D Modelle von Stammdaten.
<Relatives>parents</Relatives> COPjar überträgt Werte direkte Eltern des Quellelements. Zum Beispiel Stammdaten von 3D Modellen. |
|
Falls <ToUpperCase> gleich true ist, dann überträgt COPjar den Wert in Grossbuchstaben. |
|
Falls <ToLowerCase > gleich true ist, dann überträgt COPjar den Wert in Kleinbuchstaben. |
|
Falls <Overwrite> gleich true ist, dann überschreibt COPjar das Zielattribut mit dem Wert des Quellattributs. |
Beispiel 1 - Wert von DESCRIPTION (Beschreibung) der Stammdaten auf die 2D Zeichnungen und 3D Modelle übertragen
Ziel:
Sobald ein PDM Anwender die Beschreibung (Attribut DESCRIPTION) von Stammdaten ändert, dann soll die Beschreibung auf alle Zeichnungen und 3D Modelle übertragen werden.
Definition des COP Jobs:
<COPJobs>
<Job>
<Name>CopyDescriptionToChildren</Name>
<Action>com.cop.job.COPJobCopyValue</Action>
<IsSource>true</IsSource>
<SourceAttribute>DESCRIPTION</SourceAttribute>
<TargetClass>DRAWING_2D,MODEL_3D</TargetClass>
<TargetAttribute>DESCRIPTION</TargetAttribute>
<TargetValidState>work</TargetValidState>
<Relatives>children</Relatives>
<Overwrite>true</Overwrite>
</Job>
</COPJobs>
Den Job ausführen, sobald das Stammdatenattribut DESCRIPTION geändert wird:
<Class extends="DMMasterdata">
<Name>MASTERDATA</Name>
...
<PostApplyListener>com.cop.biz.MasterdataPostApplyListener</PostApplyListener>
...
<Attribute>
DESCRIPTION
<Visible>true</Visible>
<COPJobOnAttributeValueChange>CopyDescriptionToChildren</COPJobOnAttributeValueChange>
</Attribute>
</Class>
In diesem Anwendungsbeispiel führt COPjar den Job "CopyDescriptionToChildren" mit dem aktuellen Element (in diesem Fall Stammdaten) aus, sobald das Stammdatenattribut DESCRIPTION geändert wird (<COPJobOnAttributeValueChange>). COPjar kopiert den Wert des Stammdatenattributs DESCRIPTION (<SourceAttribute>) des aktuellen Elementes (<IsSource>) auf alle Elemente der Klasse DRAWING_2D und MODEL_3D (<TargetClass>), die direkt dem aktuellen Element untergeordnet (<Relatives>children</Relatives>) und in Arbeit (<TargetValidState>) sind. COPjar kopiert den Wert des Stammdatenattributs DESCRIPTION in das Attribut DESCRIPTION (<TargetAttribute>) der Zielelemente. COPjar überschreibt das Attribut DESCRIPTION (<Overwrite>) in den Zielelementen.
Mit folgende Konfiguration kopiert COPjar beim Speichern einer neuen 2D Zeichnung oder eines neuen 3D Modelles die Beschreibung der Stammdaten automatisch auf die Zeichnung oder auf das 3D Modell.
<Class extends="DMMasterdata">
<Name>MASTERDATA</Name>
...
<PostApplyListener>com.cop.biz.MasterdataPostApplyListener</PostApplyListener>
<COPJobOnStructuredChange>CopyDescriptionToChildren</COPJobOnStructuredChange>
...
</Class>
In diesem Anwendungsbeispiel führt COPjar den Job "CopyDescriptionToChildren" mit dem aktuellen Element (in diesem Fall Stammdaten) aus, sobald sich die Struktur des Elementes ändert (<COPJobOnStructuredChange>).
Siehe auch
(c) 2018 COP Informatik AG www.copag.ch