View source for Seon plugin seonplugin filecopy

== Zweck ==

Kopieren aller Dateien des Auftrags in ein definiertes Verzeichnis. Dabei gilt folgende Regelung:
*<[[Seon Core configuration#data_incoming_directory|data incoming directory]]>/<jobnummer> für eingehende Jobs
*<[[Seon Core configuration#data_outgoing_directory|data_outgoing_directory]]>/<jobnummer> für ausgehende oder unbekannte Jobs

== Voraussetzungen ==

* Datei <code>/etc/seon.conf</code> bzw. Konfigurationsdatei in der Umgebungsvariable <code>$Seon_CFGFILE</code> definiert. Über die Datenbank, die hier konfiguriert ist, wird das temporäre Verzeichnis sowie das Lizenzfile bezogen. 

== Konfiguration ==

Es kann ein Zielverzeichnis vergeben werden, wenn die Defaultwerte (s.o.) nicht genutzt werden sollen. Beachten Sie, dass für jede Hierarchie-Ebene an Adressinformation (also Firma, Standort, Abteilung oder Zielperson selbst) unterschiedlich sein kann. Das Zielverzeichnis kann Variablen enthalten, welche zur Laufzeit des Plugins aufgelöst werden.

Die nutzbaren Variablen sind:
*%j: Jobnummer
*%d: Tag der Joberzeugung (zweistellig)
*%m: Monat der Joberzeugung (zweistellig)
*%Y: Jahr der Joberzeugung (vierstellig)
*%H: Stunde der Joberzeugung (zweistellig, 24h-Format)
*%M: Minute der Joberzeugung (zweistellig)
*%S: Sekunde der Joberzeugung (zweistellig)
*%D: Richtung (derzeit entweder "<code>incoming</code>" oder "<code>outgoing</code>")
*%r: Empfänger-Firmenkurzname
*%s: Sender-Firmenkurzname
*%t: Empfänger Standortname
*%u: Empfänger Abteilungsname
*%v: Empfänger Vorname
*%w: Empfänger Nachname
*%x: Empfänger Adresscode
*%g: Sender Standortname
*%h: Sender Abteilungsname
*%i: Sender Vorname
*%J: Sender Nachname
*%k: Sender Adresscode

Seit Seon 3 Build 20140227 ist folgende Variable nutzbar:
*%e: Abhängig von der Auftrags-Richtung, ist diese Variable der Firmenkurzname des externen Kommunikationspartners:
**bei Eingangs-Aufträgen: Sender-Firmenkurzname (analog "<code>%s</code>")
**bei Ausgangs-Aufträgen (oder nicht definierbarer Auftrags-Richtung): Empfänger-Firmenkurzname(analog "<code>%r</code>")

== Beispiele ==
Alle Beispiele basieren auf einem Seon-Sendeauftrag mit der Nummer 76 von und an Firma "c-works"
 /opt/seon/tmp/%r/seon_job_%j/
wird zu:
 /opt/seon/tmp/c-works/seon_job_76

----
 /opt/seon/tmp/%D/%r/%j
wird zu:
 /opt/seon/tmp/outgoing/c-works/76
----
Ein SWAN-ähnliches Konstrukt wäre z.B.:
 /opt/seon/data/%Y/%m/%d/%j
welches aufgelöst wird zu:
 /opt/seon/data/2008/03/18/76

== Rückgabewerte ==
0: alles OK

1: Configfile (/etc/seon.conf bzw. Inhalt der Variable "<code>Seon_CFGFILE</code>") kann nicht gelesen werden oder die hier konfigurierte Datenbank kann nicht verbunden werden

2: Lizenzfehler

3: XML-Parameterfile kann nicht geparsed werden

4: Datei(en) konnten nicht kopiert werden