Automation Engine Script-Leitfaden > Funktionelle Gliederung > Script-Aufbau und -Prozessierung > :ATTACH_RES

:ATTACH_RES

Script-Anweisung: Diese Anweisung wird in Verbindung mit dem Storage-Objekt genutzt, um festzulegen, welche Ressourcen mit dem UNIX- oder Windows-Agenten verwendet werden sollen. Sie können sie in der Registerkarte Script eines Job-Objektes (JOBS) in Windows oder UNIX verwenden.

Syntax

:ATTACH_RES ObjectName, ResourceName, [Usage], [Variable]

Key

Beschreibung/Format

Objektname

Name des Storage-Objektes

Ressourcen-Name Name der Ressource, die Sie anhängen; d.h., zum Agenten transferieren möchten.
Verwendung

Erlaubte Werte:

  • "T": Aufgabenspezifisch; die Ressource wird über einen aufgabenspezifischen Cache transferiert.
  • "C": Mandantenweit; für den Transfer von Ressourcendateien wird ein mandantenweiter Cache verwendet.

Standardwert: "T"

Variable

(Optional) Für eine Storage-Ressource vom Typ Text wird direkt vor dem Transfer an den Agenten ein Ersatz der Automation EngineVariable durchgeführt.

Erlaubte Werte: "Y"[es] oder "N"[o]

Standardwert: "N"

Dieser Key darf nur für Ressourcen mit folgenden Attributen verwendet werden:
Type="Text" und Usage="Task-specific"

 

Verwenden Sie folgende Systemvariable mit :ATTACH_RES um Informationen über den absoluten Pfad von Ressourcen zu erhalten:

Variablenname Systemspeicherort
&$AGENT_RESOURCES_CLIENT# mandantenweites Cache-Verzeichnis
&$AGENT_RESOURCES_TASK# aufgabenspezifisches Cache-Verzeichnis

Wenn dem Storage-Objekt Ressourcen hinzugefügt werden, definiert dasAutomation Engine-System die Pfade. Sie sind jedoch für den Benutzer nicht sichtbar. Mithilfe dieser Variablen können Sie Einzelheiten im Report des Job-Objekts anzeigen.

Kommentare

Diese Script-Anweisung bestimmt, welche Ressourcen dem Storage-Objekt für den Transfer an den OS-Agenten (Windows oder Unix) hinzugefügt werden.

Der Agent erstellt für einen Job, in dem :ATTACH_RES spezifiziert ist, eine Liste aller Dateien, die transferiert werden sollen. Wenn der Transfer der aufgelisteten Dateien fehlschlägt, bricht der Agent den Job ab.

Während der Agent Informationen über Betriebssystem, Hardware und Plattform an das Automation Engine-System überträgt, überträgt das Automation Engine-System nur solche Ressourcen aus dem Storage-Objekt, die diesen Werten entsprechen.

Sie können mit :ATTACH_RES auch zunächst einmal die Ressourcen in ein spezielles Verzeichnis übertragen und die Dateien anschließend mithilfe eines externen Scripts kopieren.

Die Größe der Ressourcen begrenzt. Ab der Version 11 können Sie bis zu 71 MB (774448896 Byte) anhängen und transferieren.
Um einen niedrigeren Wert festzulegen, verwenden Sie MAXIMUM_STORE_RESOURCE_SIZE in der Systemvariable UC_SYSTEM_SETTINGS.

In einer Ressource vom Typ Text werden Systemvariable nur dann mit den entsprechenden Werten ersetzt, wenn die gleiche Systemvariable in der Registerkarte Script verwendet wird. Dies erfolgt aus Performancegründen.

Wenn Sie versuchen, eine Ressource vom Typ Text, deren Variablenersetzung auf Yes" festgelegt ist, in den mandantenweiten Cache zu transferieren, wird eine Fehlermeldung angezeigt.

Beispiele:

Im folgenden Beispiel werden alle Ressourcendateien im Storage-Objekt transferiert:

:ATTACH_RES "STORAGE12", "*"

In diesem Beispiel werden alle Ressourcen transferiert, deren Name mit dem Ausdruck "file" beginnt:

:ATTACH_RES "STORAGE12", "file*"

Im dritten Beispiel werden alle Ressourcen in einen mandantenweiten Cache transferiert:

:ATTACH_RES "STORAGE12", "*", C

In diesem Beispiel wird eine Variablenersetzung für alle transferierten Dateien ausgeführt:

:ATTACH_RES "STORAGE12", "*.ini", ,Y

In diesem Beispiel werden die oben erwähnten Systemvariablen für :ATTACH_RES verwendet, um eine .jar-file anzuhängen, die mit Java gestartet wird:

:ATTACH_RES "PCK.AUTOMIC_SIEBEL.PRV.STORE", "SIEBELTOOL.JAR", C
JAVA -JAR
"&$AGENT_RESOURCES_CLIENT#SIEBELTOOL.JAR" SIEBEL IMPORTBUSINESSOBJECT

 

Siehe auch

 

 


Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support

Copyright © 2016 Automic Software GmbH