Beispiel Konfiguration

Die COP Job Aktion "com.cop.job.COPJobDataExport" exportiert alle Metadaten eines Elementes (Einzelteil, Baugruppe) und dessen Kindern (Einzelteile, Dokumente) in eine Datei.

Datenexport Aktionen können wie folgt ausgeführt werden:

·manuell über die Aktion "COPDataExportAction"

·automatisiert mit COP Job (zum Beispiel nach einem bestimmten Statuswechsel)

Beispiel 1 - Stückliste exportieren

<Job>

<Name>XmlDataExport</Name>

<Action>com.cop.job.COPJobDataExport</Action>

<MessageOnSucceed>Die Daten von Artikel %NAME% wurden in %OUTPUTPATH% exportiert.</MessageOnSucceed>

</Job>

</COPJob>

<Name catalog="awm_stda" msg_num="251">MASTERDATA</Name>

<ActionMenuSection>1.0

com.cop.action.COPDataExportAction

<Job>XmlDataExport</Job>

<DisplayName catalog="cop" msg_num="1063">XML Export</DisplayName>

</Action>

</ActionMenuSection>

</Class>

Der Datenexport wird manuell mit Aktion com.cop.action.COPDataExportAction ausgelöst . COPDataExportAction führt den Job "XmlDataExport" aus (<Job>XmlDataExport</Job>). Die Anzeige im rechte Maustasten-Menü ist der Text 1063 aus dem Message Katalog "cop.msg" oder "XML Export" (<DisplayName>).

COP JAR exportiert alle Metadaten des Elementes und dessen Unterbaugruppen, -teile und Dokumente als XML (<OutputFormat> ) in den Ordner C:\temp\xml\subdir (<OutputDir>). Der Ordner subdir besteht aus den ersten 3 Zeichen (%NAME%{0,3}) des Attrbutes NAME des betreffenden Elementes. Falls der Ordner nicht existiert, erzeugt COP JAR diesen (<OutputDirCreate>).

COP JAR exportiert die Metadaten in die Datei %NAME%.xml (<OutputFileName>), wobei COP JAR den Platzhalter %NAME% durch den Attributwert NAME des

aktuelle exportierten Element ersetzt.

COP JAR exportiert jeweils die Metadaten der höchsten Version der Dokumente (<HighestRevision>). COP JAR gibt die Stückliste des Elementes aus, wobei eine sog. flache Stückliste (<BomMode>) erstellt wird.

COP JAR zeigt nach dem Export eine Meldung an, dass das XML erfolgreich erstellt wurde (<MessageOnSucceed>).

Beispiel 2

<Job>

<Name>XmlDataExport</Name>

<Action>com.cop.job.COPJobDataExport</Action>

<OutputDir>\\erpserver\exchange</OutputDir>

<Class>

<Name>MASTERDATA</Name>

<Attribute>DESCRIPTION</Attribute>

<Attribute>QUANTITY_DMS</Attribute>

</Class>

<Class>

<Name>DRAWING_2D</Name>

<Attribute>VERSION</Attribute>

<Attribute>SHEET</Attribute>

</Class>

<Class>

<Name>MODEL_3D</Name>

<Export>false</Export>

</Class>

</Job>

COP JAR exportiert nur die Metadaten von Elementen der Klassen MASTERDATA und DRAWING_2D (<Class>). Alle anderen Klassen sind ausgeschlossen, wobei die Klasse MODEL_3D explizit ausgeschlossen ist (<Export>).

COP JAR exportiert von Stammdaten (MASTERDATA) nur die Werte der Attribute NAME, DESCRIPTION und QUANTITY_DMS (<Attribute>). Alle anderen Stammdaten-Attribute exportiert COP JAR nicht.

COP JAR exportiert von den Zeichnungen (DRAWING_2D) nur die Werte der Attribute NAME, VERSION, SHEET und ELID. Alle anderen Zeichnungsattribute exportiert COP JAR nicht.

Falls im Tag <Class> keine Tags <Attribute> konfiguriert sind, dann exportiert COP JAR alle Attribute.

Beispiel 3

<Job>

<Name>XmlDataExport</Name>

<Action>com.cop.job.COPJobDataExport</Action>

<BomMode>structure</BomMode>

<Class>

<Name>MASTERDATA</Name>

<Attribute>DESCRIPTION</Attribute>

<Attribute>QUANTITY_DMS</Attribute>

<Attribute>PART_ASSEMBLY</Attribute>

</IfMatch>

<ClassName>DRAWING_2D</ClassName>

</HasChild>

</Condition>

</Class>

<Class>

<Name>DRAWING_2D</Name>

<Attribute>VERSION</Attribute>

<Attribute>SHEET</Attribute>

</Class>

</Job>

COP JAR exportiert die Metadaten sämtlicher Stammdaten des zu exportierenden Elementes (Baugruppe o.ä), wobei COP JAR nur die mit <Attribute> konfigurierten Attribute exportiert.

COP JAR exportiert nur Stammdaten, die die konfigurierte Bedingung (<Condition>) erfüllen. Mindestens eine der beiden Bedinungen muss erfüllt sein (<Operator>):

1.Das Attribut PART_ASSEMBLY muss den Wert true haben (<IfMatch>), d.h. das aktuelle Element muss eine Baugruppe sein.
oder

2.Die Stammdaten müssen mindestens eine Zeichnung (<ClassName>) referenzieren, die freigegeben (<Released>) ist.

Beispiel 4

<Job>

<Name>XmlDataExport</Name>

<Action>com.cop.job.COPJobDataExport</Action>

<BomMode>structure</BomMode>

<Class>

<Name>MASTERDATA</Name>

</Class>

<Class>

DRAWING

<Value>%NAME%-%SHEET%-%VERSION%</Value>

</PseudoAttribute>

</Class>

</Job>

COP JAR exportiert alle Attribute sämtlicher Stammdaten und Zeichnungen des zu exportierenden Elementes (Baugruppe o.ä).

COP JAR erzeugt beim Export von Zeichnungen jeweils ein sog. Pseudo-Attribut (<PseudoAttribute>), d.h. ein in der Klasse nicht real existierendes Attribut. Der Name des Pseudo-Attributes lautet "FULL_NAME" (<DisplayName>). Den Wert des Pseudo-Attributs setzt COP JAR aus den Attributewerten NAME, SHEET und VERSION zusammen (<Value>), jeweils getrennt durch einen Bindestrich. <Value> kann auch Platzhalter enthalten.

COP JAR exportiert die Daten als strukturierte Stückliste (<BomMode>).

Beispiel 5

<Job>

<Name>XmlDataExport</Name>

<Action>com.cop.job.COPJobDataExport</Action>

<BomMode>structure</BomMode>

<Class>

<Name>MASTERDATA</Name>

</Class>

<Class>

<DisplayName>DESCRIPTION_EN</DisplayName>

<Value>

<ClassName>COP_CATALOG</ClassName>

<Attribute>DESCRIPTION_EN</Attribute>

<SelectAttribute>DESCRIPTION_DE</SelectAttribute>

<SelectValue>%DESCRIPTION%</SelectValue>

</Lookup>

</Value>

</PseudoAttribute>

</Class>

</Job>

COP JAR erzeugt beim Export von Zeichnungen jeweils ein sog. Pseudo-Attribut (<PseudoAttribute>), d.h. ein in der Klasse nicht real existierendes Attribut. Der Name des Pseudo-Attributes lautet "DESCRIPTION_EN" (<DisplayName>). Den Wert für das Pseudo-Attributs liest COP JAR aus der Datenbank-Tabelle COP_CATALOG (<Lookup>). COP JAR sucht in der Datenbank-Tabelle COP_CATALOG den Datensatz, dessen Attribut DESCRIPTION_DE (<SelectAttribute>) gleich dem Attributwert DESCRIPTION (<SelectValue>) des zu exportierenden Elementes ist. COP JAR überträgt den Attributwert DESCRIPTION_EN (<Attribute>) des gefundenen Datensatzes in der Tabelle COP_CATALOG.

Die Konfiguration mit <Lookup> kann zum Beispiel verwendet werden, um bestimmte Werte aus einem Benennungskatalog zu exportieren (siehe auch COP Katalog).

Beispiel 6

<Job>

<Name>XmlDataExport</Name>

<Action>com.cop.job.COPJobDataExport</Action>

<Class>

<Name>MASTERDATA</Name>

<Value>PRE-ASSEMBLY</Value>

</IfMatch>

</Condition>

</Inseparable>

</Class>

</Job>

COP JAR exportiert alle Attribute sämtlicher Stammdaten des zu exportierenden Elementes (Baugruppe o.ä).

Falls der Wert des Attributes TYPE (<Attribute>) einer Baugruppe gleich "PRE-ASSEMBLY" (<Value>) ist, dann betrachtet COP JAR die betreffende Baugruppe als untrennbar und exportiert die Kinder (Unterbaugruppen und -teile) nicht (<Inseparable>). In diesem Fall verwendet COP JAR dann den Tag <Part> statt <Assembly>.

Beispiel 7

<Job>

<Name>XmlDataExport</Name>

<Action>com.cop.job.COPJobDataExport</Action>

<Class>

<Name>MASTERDATA</Name>

<Attribute>QUANTITY_DMS</Attribute>

<Attribute>QUANTITY_DMS</Attribute>

</IfMatch>

<Attribute>QUANTITY_DMS</Attribute>

</IfMatch>

<Attribute>QUANTITY_DMS</Attribute>

</IfMatch>

</Condition>

</Replace>

</Class>

</Job>

COP JAR ersetzt während dem Export den Wert des Attributs QUANTITY_DMS durch "1.0", falls das Attribut QUANTITY_DMS leer oder den Wert "0.0" oder "0" enthält (<Replace>).

Beispiel 8

<Job>

<Name>XmlDataExport</Name>

<Action>com.cop.job.COPJobDataExport</Action>

<Class>

<Name>MASTERDATA</Name>

</Class>

</SendTo>

</Job>

COP JAR exportiert die Stammdaten (Stückliste) in eine temporäre XML Datei und startet nach dem Export Microsoft Excel und übergibt die exportierte XML Datei.

Beschreibung

Folgende Tags konfigurieren die Aktion "com.cop.job.COPJobDataExports":

Tag	Beschreibung
OutputFormat	Der Tag <OutputFormat> definiert das Ausgabeformat (xml u.a.).
OutputDir	Der Tag <OutputDir> definiert den Ausgabeordner (Ziel-Verzeichnis).
OutputDirCreate	Der Tag <OutputDirCreate> legt fest, ob COP JAR den Ausgabeorder (vgl. OutputDir) erstellen soll, falls dieser nicht vorhanden ist. Der Tag kann Platzhalter für bestimmte Attribute enthalten.
OutputFileName	Der Tag <OutputFileName> definiert den Namen der Ausgabedatei. Der Tag kann Platzhalter für bestimmte Attribute enthalten.
HighestRevision	Der Tag <HighestRevision> legt fest, ob COP JAR nur die höchste Version eines Dokumentes ausgegeben soll.
BomMode	Der Tag <BomMode> legt fest, ob COP JAR die Stückliste ausgeben soll und in welchem Format (flache Stückliste, Strukturstückliste).
ShowResult	Der Tag <ShowResult> legt fest, ob COP JAR nach dem efolgreichen Export eine Rückmeldung an den Benutzer geben soll. COP JAR meldet Fehler immer.
SendTo	COP JAR startet nach dem erfolgreichen XML Export die mit <SendTo> konfigurierte Applikation.