Les objets de variables Backend exécutent une commande sur un système d'exploitation et renvoient le résultat sous forme de valeurs affichées en colonnes.
Les objets de variables Backend exécutent une commande sur un système d'exploitation et renvoient le résultat sous forme de valeurs affichées en colonnes. L'objetLes activités et déroulements que contrôle l'Automation Engine sont représentés à l'aide d'objets (voir aussi Tâche). variable définit la répartition des colonnes. Il est possible de saisir plusieurs commandes pour différents systèmes d'exploitation, noms de systèmes et versions dans une variable. La commande correcte pour cet agent"Programme permettant l'exécution de Traitements sur des systèmes cible comme un ordinateur ou des solutions d'entreprise. Egalement un type d'objet distinct dans l'Automation Engine. [Anciennement appelé ""Exécuteur de tâches"".]" est automatiquement sélectionnée et exécutée lors de la résolution de la variable.
Les systèmes d'exploitation UNIX et Windows sont pris en charge. Le système d'exploitation peut être sélectionné via la fenêtre Commandes.
Le privilège "Créer et modifier les variables Backend" est nécessaire pour configurer et modifier les objets VARA de type Backend.
Le code retour est automatiquement défini à 1 si une commande Windows aboutit à une erreur. Cela veut dire que lorsque vous utilisez l'objet VARA à l'intérieur d'un scriptEgalement un type d'objet distinct dans l'Automation Engine., ce dernier s'interrompra. Afin d'éviter cette situation, vous pouvez ajouter ''& set ERRORLEVEL=0'' à la fin de la commande Windows.
Par exemple : cmd /c dir /b /o:d C:\temp\*.xml & set ERRORLEVEL=0
Cette commande liste les fichiers d'un répertoire. Le code retour est toujours 0 peu importe que les fichiers soient trouvés ou pas. Ainsi vous pouvez être sûr que les tâches utilisant cette variable ne seront pas interrompues.
Les paramètres VAR_TIMEOUT ( UC_HOSTCHAR_DEFAULT - Host Characteristics) et BACKENDVAR_MAX_ROWS (UC_SYSTEM_SETTINGS) sont également disponibles pour les variables Backend.
Les variables PromptSet sont prises en charge dans les champs de sélection destinés aux types de variables BACKEND, EXEC, FILELIST, SEC_SQLI, SEC_SQL, SQLI, SQL, et XML. L'utilisation de variables PromptSet est nécessaire pour la création de Recharger dynamiquement les dialogues PromptSet.
Spécification des paramètres des variables
Champ |
Description |
---|---|
Type |
Ce champ en lecture seule affiche le type de variable "Backend". Vous déterminez le type de variable au moment de la création de l'objet. Il ne peut être modifié une fois la variable définie. |
Agent |
Agent sur lequel la commande sera exécutée. Vous pouvez inclure des variables PromptSet ici, en utilisant la fonction Rechargement dynamique pour les invites de zones de listes modifiables. Lorsque des variables PromptSet sont utilisées dans des objets variable dynamiques et que vous cliquez sur Aperçu, vous obtiendrez une erreur. La raison en est que les variables PromptSet n'existent pas dans l'objet variable dynamique. Cependant, les variables PromptSet seront résolues lorsque les objets incluant des PromptSet sont exécutés. Les pour la variable Backend utilisent les variables PromptSet &AGENT# pour leur agent spécifié et &LOGIN# pour leur login. |
Tâches de l'agent |
Ce paramètre déploie l'agent de la tâcheObjet exécutable qui a déjà été exécuté. qui accède à l'objet variable. Si cette option est définie, c'est l'agent de la tâche qui est utilisé. L'agent de la variable est utilisé lorsque la tâche ne possède pas d'agent (par ex. pour les objets script). Si aucun agent n'est défini sur ces deux emplacements, une erreur survient lors de l'exécutionDurée d'exécution d'une Tâche. C'est la période entre le début et la fin de la Tâche. La période d'activation n'en fait pas partie (voir aussi Activation et Démarrage). de la variable. |
LoginDonnées de connexion pour les systèmes cible. Egalement un type d'objet distinct dans l'Automation Engine. |
Objet Login pour la connexion à l'ordinateur de l'agent. Vous pouvez inclure des variables PromptSet ici, en utilisant la fonction Rechargement dynamique pour les invites de zones de listes modifiables. Lorsque des variables PromptSet sont utilisées dans des objets variable dynamiques et que vous cliquez sur Aperçu, vous obtiendrez une erreur. La raison en est que les variables PromptSet n'existent pas dans l'objet variable dynamique. Cependant, les variables PromptSet seront résolues lorsque les objets incluant des PromptSet sont exécutés. Les pour la variable Backend utilisent les variables PromptSet &AGENT# pour leur agent spécifié et &LOGIN# pour leur identification. |
Tâches du Login |
Ce paramètre déploie le Login de la tâche utilisant la variable. Si cette option est définie, l'objet Login de la tâche est utilisé. Si la tâche ne possède pas d'objet Login (par ex. pour les objets script), c'est le login de la variable qui est utilisé. Si aucun objet Login n'est défini sur ces deux emplacements, une erreur survient lors de l'exécution de la variable. |
Spécification des paramètres Données et format
Champ |
Description |
---|---|
Type de données |
Le type de données détermine le format de la valeur des variables. Les objets variable avec la source "Backend" sont toujours créés avec le type de données "texte". Celui-ci ne peut pas être modifié. Chaîne de caractères alphanumérique Les espaces en fin de chaîne sont tronqués. Les espaces en début de chaîne sont conservés. Si la case Limiter la longueur n'est pas cochée, aucune limite ne sera appliquée à la longueur de la chaîne de caractères. |
Limiter la longueur |
Applique un nombre maximal de caractères. Si cette option est désactivée, la valeur est illimitée. La colonne clé des objets VARA a une limite maximale de 200 caractères. Cette limite existe toujours et il est impossible de l'augmenter ou de la désactiver. La colonne de résultats des variables dynamiques est illimitée. La longueur dépend des colonnes de valeurs. Cette limite se réfère à la première colonne de valeurs pour les variables statiques et dynamiques. La clé ou la colonne de résultat n'est pas vérifiée. Les valeurs qui dépassent la longueur maximale sont exclues. |
Majuscules |
Les minuscules dans les valeurs de variable sont automatiquement transformées en majuscules. Cela ne concerne que la première colonne de valeurs. |
Format du résultat |
Définition du contenu de la colonne résultat. La première colonne affichée dans l'aperçu est la colonne de résultat. La colonne de résultat peut se composer d'une combinaison de colonnes de valeurs et de tout caractère, ceci est déterminé par le format du résultat. Les numéros de colonne qui sont indiqués entre accolades { } dans le champ Format de résultat sont remplacés par la valeur de la colonne concernée. Par exemple : Si aucun format du résultat n'est indiqué, la colonne de résultat correspond à la première colonne de valeurs. Les valeurs de la colonne de résultat doivent respecter les limitations de la variable (valeur min., valeur max.et limiter le texte à) ou correspondre au format de sortie ou au type de données. Sinon, la colonne de résultat ne contient aucune valeur. |
Spécification du paramètre Accès au script
Vous pouvez spécifier un comportement à adopter lorsque le code est introuvable, via les cases d'option Si code introuvable.
Pour : |
Choisir : |
---|---|
Affiche un message d'erreur si un objet tente d'accéder par script à un élément absent lors de l'exécution. | Renvoie une erreur |
N'utilise pas le résultat du format de sortie si " " | Retourne les valeurs initiales |
Commandes
Table de définition des commandes par système d'exploitation Les images ci-dessous montrent des commandes Windows et Linux/UNIX.
Sous Windows, il ne s'agit pas de lignes batch. Ceci signifie que le programme spécifique à exécuter doit être défini.
Exemples :
Lister les répertoires : cmd /c dir C:\temp
Exécuter un ping : ping localhost -n 10
Il est possible d'enregistrer des commandes pour plusieurs systèmes d'exploitation dans la même variable. Le système utilise automatiquement les commandes du système d'exploitation de l'agent approprié lors de la résolution des variables.
Dans les colonnes Nom d'OS et Version, il est possible de filtrer les noms (par ex. un UNIX déterminé) et la version du système d'exploitation. La ligne appropriée pour l'agent spécifié est automatiquement utilisée lors de l'exécution de la variable.
La première ligne qui correspond au système d'exploitation, nom d'OS et version de l'agent est utilisée.
Notez qu'une variable de type Backend ne peut exécuter qu'une seule commande.
UNIX : L'utilisateurDans Automation Engine, un utilisateur se réfère à une instance d'un objet utilisateur, mais c'est en général une personne qui travaille avec les produits Automic. Chaque utilisateur a son identifiant et un ensemble de droits d'accès aux différentes parties du système Automation Engine et à la suite de produits. Ces droits d'accès se présentent sous la forme d'autorisations et de privilèges dans Automation Engine, de rôles utilisateurs dans Decision, de droits EventBase et de droits des objets pour l'application Web ARA. Vous pouvez les gérer en central avec les fonctions de gestion des utilisateurs d'AWI. Reportez-vous aussi à la gestion des droits des utilisateurs. indiqué dans l'objet Login requiert les autorisations correspondantes pour exécuter la commande. Linux: Les droits "root" sont requis pour les commandes "chkconfig" et "runlevel".
Colonne |
Description |
---|---|
Nom d'OS |
Filtre sur le nom du système d'exploitation Il est possible d'utiliser le caractère générique *. Il s'agit d'un caractère de remplacement pour un nombre de caractères au choix. Le nom d'OS fait référence au nom du système d'exploitation de l'agent qui est affiché dans la colonne de la Supervision systèmeFenêtre de l'Interface Utilisateur contenant des informations sur le système AE. > Agent > SW. |
Version |
Filtre sur la version du système d'exploitation La version fait référence à la version du système d'exploitation de l'agent qui est affiché dans la colonne de la Supervision système > Agent > SW. |
Commande |
Commande du système d'exploitation. Vous pouvez inclure des variables PromptSet ici, en utilisant la fonction Rechargement dynamique pour les invites de zones de listes modifiables. Lorsque des variables PromptSet sont utilisées dans des objets variable dynamiques et que vous cliquez sur Aperçu, vous obtiendrez une erreur. La raison en est que les variables PromptSet n'existent pas dans l'objet variable dynamique. Cependant, les variables PromptSet seront résolues lorsque les objets incluant des PromptSet sont exécutés. Sous Windows, seules les commandes Powershell sont prises en charge. |
Format de colonne |
Définition de la répartition du résultat dans les colonnes. Syntaxe :
Nom de la colonne : Nom de la colonne défini par l'utilisateur Le point-virgule (;) ne doit être utilisé qu'entre des colonnes. Un point-virgule n'est pas nécessaire à la fin de la définition. Vous devez définir au moins une valeur de colonne (minimum requis). Par exemple : L'exemple ci-dessus divise la sortie de la commande en deux colonnes : |
Travailler dans les tables Commande
Pour : | Procédez comme suit : |
---|---|
Ajouter une ligne à un tableau |
Cliquez sur |
Éditer une cellule dans une ligne du tableau |
Cliquez sur la cellule du tableau et modifiez sa valeur. |
Supprimer une ou plusieurs lignes du tableau |
Cochez la case de la ou des lignes, puis cliquez sur |
Supprimer toutes les lignes du tableau |
Cochez la case de l'en-tête de colonne, puis cliquez sur |
Couper une ou plusieurs lignes et les coller dans le presse-papiers AWIProduit Automic : interface Web, simple et claire, qui permet l'+char(39)+'accès aux différentes fonctionnalités d'+char(39)+'Automation Engine. |
Cochez la case de la ou des lignes, puis cliquez sur |
Copier une ou plusieurs lignes et les coller dans le presse-papiers AWI |
Cochez la case de la ou des lignes, puis cliquez sur |
Coller la ou les lignes du pesse-papiers AWI en bas du tableau. |
Cliquez sur ![]() |
Aperçu des commandes
Pour exécuter la commande cliquez sur Aperçu. La commande s'exécute sur l'ordinateur spécifié et les résultats s'affichent.
Des objets variable prédéfinis de type BACKEND sont fournis dans le clientEnvironnement indépendant pour la création et l'exécution d'objets dans un système AE. Le nom d'un client est un nombre de quatre chiffres à saisir lors de la connexion d'un utilisateur au système AE. Les utilisateurs et leurs droits y sont aussi définis.Egalement un type d'objet distinct dans l'Automation Engine. 0 (dossier UC _RB_VARIABLES) :
Nom d'objet | Système d'exploitation | Fonction | Colonnes |
---|---|---|---|
UC_RB_VARA_PROCESSLIST | Windows, Linux, AIX, SunOS, HP-UX |
Liste les processus actifs. La longueur maximale du nom du processus peut différer en fonction du système UNIX correspondant. Ajustez la longueur de la colonne de l'objet variable, si nécessaire. |
ProcessID Nom du processus |
UC_RB_VARA_SERVICES_PAUSED | Windows, Linux, AIX, SunOS, HP-UX | Liste tous les services suspendus. | Nom du service |
UC_RB_VARA_SERVICES_RUNNING | Windows, Linux, AIX, SunOS, HP-UX | Liste tous les services en cours. | Nom du service |
UC_RB_VARA_SERVICES_STOPPED | Windows, Linux, AIX, SunOS, HP-UX | Liste tous les services arrêtés. | Nom du service |
UC_RB_VARA_USERLIST | Windows, Linux, AIX, SunOS, HP-UX |
Liste tous les utilisateurs du système d'exploitation Windows : Active DirectoryActive Directory (AD) est à la fois le service de répertoire Microsoft'+char(39)+'s et un terme générique pour les services d'identification des réseaux Windows. pour Powershell doit être installé sur l'ordinateur approprié |
Nom du compte utilisateur |
Ces objets variable peuvent être utilisés pour des Recharger dynamiquement les dialogues PromptSet. Leur agent spécifié est le nom de la variable &AGENT# et leur login est &LOGIN#. Utilisez ces noms pour les variables PromptSet des éléments requis.
Dans les objets PromptSet, vous pouvez sélectionner directement les objets variables prédéfinis comme variables de référence. Il n'est pas nécessaire de les créer auparavant dans leur client.
Les objets VariableEnregistre ou fournit les valeurs dynamiques de l'exécution. Egalement un type d'objet distinct dans Automation Engine. comportent les options Appliquer l'agent de la tâche / Appliquer le Login de la tâche et utilisent l'agent / le Login de la tâche (si disponible) à laquelle l'objet PromptSet est attribué.
Le tableau ci-dessus présente également les systèmes d'exploitation pour lesquels les commandes sont spécifiées dans la variable. Selon l'agent et son système d'exploitation, la commande correcte est exécutée.