:ATTACH_RES

Instruction de script : Cette instruction est utilisée en conjonction avec l'objet Stockage pour spécifier les ressources à utiliser avec l'agent UNIX ou Windows. Vous pouvez l'utiliser dans un script de l'onglet Traitement des objets Job (JOBS) sous Windows ou UNIX.

Syntaxe

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

Clé	Description / format
ObjectName	Nom de l'objet Stockage
ResourceName	Nom de la ressource à joindre, autrement dit celle que vous souhaitez transférer à l'agent.
Usage	Valeurs autorisées : "T": Tâche spécifique ; la ressource sera transférée via un cache spécifique à la tâche "C": Ensemble du client ; utilise un cache client pour transférer les fichiers de ressources Valeur par défaut : "T"
Variable	(optionnel) Effectue un remplacement de variable Automation Engine pour une ressource de stockage de type texte, juste avant le transfert vers l'agent. Valeurs autorisées : "Y"[es] ou "N"[o] Valeur par défaut : "N" Cette clé ne peut être utilisée que sur les ressources ayant les attributs suivants : Type="Text" and Usage="Task-specific"

Vous pouvez utiliser les variables système suivantes avec :ATTACH_RES pour obtenir des informations sur les chemins de ressources absolus :

Nom de la variable	Emplacement système
&$AGENT_RESOURCES_CLIENT#	répertoire cache client
&$AGENT_RESOURCES_TASK#	répertoire cache tâche

Les ressources étant jointes à l'objet Stockage, les chemins sont définis dans le système Automation Engine, sans être visibles à l'utilisateur. Ces variables vont vous permettre d'afficher certains détails dans le rapport de l'objet Job.

Cette instruction de script détermine les ressources à joindre à l'objet Stockage pour le transfert vers l'agent SE, sous Windows ou UNIX.

L'agent crée une liste de tous les fichiers à transférer pour un job, là où :ATTACH_RES est spécifié. En cas d'échec du transfert des fichiers listés, l'agent interrompt le job.

Étant donné que l'agent transfère les informations relatives au SE, au matériel et à la plateforme au système Automation Engine, le système Automation Engine ne transfère que les ressources de l'objet Stockage qui correspondent à ces valeurs.

Vous pouvez également transférer les ressources dans un répertoire spécial, en utilisant d'abord :ATTACH_RES, puis copier les fichiers via un script externe.

La taille des ressources est limitée. À partir de la version 11, vous pouvez joindre et transférer jusqu'à 71 Mo (74448896 octets).
Pour définir une limite minimale, utilisez la clé MAXIMUM_STORE_RESOURCE_SIZE de la variable système UC_SYSTEM_SETTINGS.

Dans une ressource de type texte, les variables système ne sont remplacées par leurs valeurs correspondantes que si la même variable système est utilisé dans l'onglet Traitement. Cela à des fins de performances.

Si vous tentez de transférer des ressources de type texte avec "Yes" pour le remplacement de variable dans le cache client, un message d'erreur s'affiche.

Exemples

L'exemple suivant illustre le transfert de tous les fichiers de ressources contenus dans l'objet Stockage :

:ATTACH_RES "STORAGE12", "*"

Dans cet exemple, le transfert porte sur toutes les ressources dont le nom commence par l'expression "file"

:ATTACH_RES "STORAGE12", "file*"

Le troisième exemple illustre le transfert de toutes les ressources dans un cache client.

:ATTACH_RES "STORAGE12", "*", C

Cet exemple montre un remplacement de variable pour tous les fichiers transférés :

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

Dans cet exemple, les variables système susmentionnées pour :ATTACH_RES sont utilisées pour joindre un fichier .jar ensuite lancé avec Java :

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

Voir aussi :

Stockage
Enregistrement des interpréteurs externes