Bestimmte Konfigurationen (Tags) können Platzhalter für Attribute und Systeminformationen enhalten. COPjar ersetzt zur Laufzeit die Platzhalter durch die entsprechenden Werte.
Platzhalter beginnen und enden mit einem Prozentzeichen (%).
Beispiel
<Job>
<Name>xml_data_export</Name>
<Action>com.cop.job.COPJobDataExport</Action>
<OutputDir>\\erpserver\dataexchange\%NAME%{0,3}</OutputDir>
<OutputFileName>%NAME%-%VERSION%.xml</OutputFileName>
</Job>
Beispiel
<COPJobs>
<Job>
<Name>createpdf</Name>
<Action>com.cop.job.COPJobCOPDok</Action>
<Config>action=convert;converter.config=pdf</Config>
<Export>
<Dir>
\\fileserver\export\%NAME%{0,3,0}
<Create/>
</Dir>
<FileName>%NAME%-%SHEET%{0,2,0}-%VERSION%{0,2,0}.pdf</FileName>
</Export>
</Job>
</COPJobs>
Beschreibung
Im ersten Beispiel exportiert der COPjar die Metadaten des aktuellen Elements in das Dateisystem. Der Zielordner ist im Tag <OutputDir> festgelegt. COPjar ersetzt den Platzhalter %NAME%{0,3} durch den Namen des Elementes (Wert des Attributs NAME), wobei COPjar nur die ersten 3 Ziffern des Namens verwendet. Der Name der Zieldatei ist im Tag <OutputFileName> definiert. COPjar ersetzt den Platzhalter %NAME%-%VERSION% durch den Namen und der Version des Elements.
Existiert zum Beispiel im PDM System der Artikel "47110815" mit der Version "a". COPjar exportiert die Daten in die Datei \\erpserver\dataexchange\471\47110815-a.xml.
Im zweiten Beispiel exportiert COPjar (resp. COP Dok) eine Zeichnung als PDF in den Ordner \\fileserver\export\%NAME%{0,3,0}. %NAME%{0,3,0} wird durch die ersten drei Ziffern des Zeichnungsnamen (oder Nummer) ersetzt (%NAME%{0,3,0}). Falls das Attribut NAME aus weniger als 3 Ziffern besteht, werden eine entsprechende Anzahl 0 vorangestellt (%NAME%{0,3,0}) , so dass der Zielordner aus mindestens 3 Ziffern besteht. Das Gleiche gilt für die Blattnummer und Version im Dateinamen.
Zum Beispiel wird die Zeichnung 4711, Blatt 2, Version B nach \\fileserver\export\4711\4711-02-0B.pdf exportiert.
Es können alle Attribute des aktuellen Elements verwendet werden (%NAME%, %VERSION%, %STATE% etc.).
Ungültige Zeichen
Falls Platzhalter für die Definition von Ordnern und Dateinamen verwendet werden, entfernt COPjar alle ungültigen Zeichen aus dem Wert des Platzhalters. Die ungültigen Zeichen sind vom Betriebsystem (Windows) vorgegeben. Dies sind die Zeichen: \ / * ? : " | < >
(c) 2018 COP Informatik AG www.copag.ch