Navigation: COP Jobs > Action >

COPJobCopyValue

 

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

SourceClass

Definiert die Klasse des Quellelementes. COPjar kopiert nur Werte von Elementen, die der in <QuellClass> konfiguriert Klasse angehören.

Beispiel: <QuellClass>MASTERDATA</QuellClass>

SourceAttribute

Definiert das Attribut, dessen Wert auf das Zielelement übertragen wird.

IsSource

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.

TargetClass

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>

TargetAttribute

COPjar überträgt den Wert in dieses Zielattribut.

TargetValidState

COPjar überträgt den Wert, falls das Zielelement diesen Status hat.

IsTarget

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.

Relatives

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.

ToUpperCase

Falls <ToUpperCase> gleich true ist, dann überträgt COPjar den Wert in Grossbuchstaben.

ToLowerCase

Falls <ToLowerCase > gleich true ist, dann überträgt COPjar den Wert in Kleinbuchstaben.

Overwrite

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

·COP Job

·COPJobOnAttributeValueChange

·COPJobOnStructuredChange

 

 

(c) 2018 COP Informatik AG www.copag.ch