Commande Shell

Commande

• Source : Définit la source de la commande qui est envoyée.

  • Commande(s) intégrée(s) :

  • Valeur : Utilisez la zone de saisie prévue pour saisir les données que vous souhaitez que l'action utilise. Autrement, vous pouvez ajouter une variable pour définir les données ou ajouter un caractère spécial à la valeur saisie.

  • Importer : Ouvre la boîte de dialogue Ouvrir un fichier où rechercher et sélectionner un fichier contenant le script que vous voulez. Le contenu du fichier est importé dans la zone de saisie Valeur.

  • Exporter : Ouvre la boîte de dialogue Enregistrer le fichier pour vous permettre d'enregistrer le contenu de la zone de saisie Valeur dans un fichier externe. Vous pouvez enregistrer la valeur dans un nouveau fichier ou remplacer le contenu d'un fichier existant.

  • Modifier la valeur intrinsèque : Ouvre la boîte de dialogue Valeur pour où vous pouvez éditer la valeur de la source intégrée.

  • Variable :

    • Variable : Saisissez la variable que vous souhaitez utiliser pour la source. Autrement, cliquez sur pour sélectionner une variable récemment utilisée ou cliquez sur Plus de variables pour ouvrir la boîte de dialogue Insérer une variable.

  • Fichier externe :

    • Emplacement : Indique le système de fichiers ou l’emplacement où se trouve le dossier source. Les systèmes ou emplacements de fichiers peuvent comprendre un dossier de stockage temporaire, des systèmes de fichiers locaux ou sur réseau, Librarian voire un emplacement de stockage sur le cloud. Pour en savoir plus sur les emplacements de stockage cloud pris en charge, consultez Administration Console Page de Stockage cloud.

    • Nom du fichier : Indique le chemin du fichier. Vous pouvez saisir l’emplacement du dossier ou cliquer sur Parcourir pour trouver, puis sélectionner le fichier que vous souhaitez (l’option Parcourir n’est pas disponible lorsque le paramètre Emplacement est défini sur Stockage temporaire). Autrement, vous pouvez ajouter une variable pour définir le fichier ou ajouter un caractère spécial à la valeur saisie.

    • Dernière révision publiée : Indique que l’action utilise la dernière révision publiée du fichier Librarian spécifié. Cette option n’est valable que lorsque le fichier Librarian est attribué à un flux de travail. Disponible quand l’option Emplacement est définie sur Librarian.

    • Codage de fichier : Définit la méthode d'encodage qui est utilisée par le fichier source.

• Exécuter par lot : Indique que le fichier spécifié est exécuté en tant que fichier de lot. Available when the Source value is set to External File and the Location value is set to Temporary Storage or Computer/Network.

  • Paramètres : Spécifie les paramètres qui sont transmis au fichier de lot. Disponible lorsque Exécuter par lot est sélectionné.

• Arrêter l'exécution si une commande de shell échoue : Indique que l'action cesse si une commande échoue. Si cette option n'est pas sélectionnée, les échecs de commande sont ignorés et l'action est toujours considérée comme réussie. Disponible lorsque Exécuter par lot n’est pas sélectionné.

• Attendre que toutes les commandes de shell se terminent : Indique que les commandes ne sont exécutées qu'après la réception d’une réponse. Si cette option n'est pas sélectionnée, les commandes sont exécutées sans attendre de réponse.

  • Délai d'exécution (secondes) : Spécifie le temps pendant lequel l'action attend que la commande s'exécute avant que l'action n’expire.

Sortie

Pour chacune des options suivantes, vous pouvez saisir la variable que vous souhaitez. Autrement, vous pouvez aussi ajouter une variable.

• Enregistrer la sortie et les erreurs de commande dans la variable : Indique la variable dans laquelle sont enregistrées la sortie et les erreurs de la commande.

• Enregistrer les erreurs de commande dans la variable : Indique la variable dans laquelle sont enregistrées les erreurs de la commande.

Action

• Nom : Indique le nom de l'action. Vous pouvez remplacer le nom par défaut en saisissant un nouveau nom dans le champ.

• Description : Présente une description de l’action.

• Exécuter une action : Pour définir la fréquence à laquelle l'action doit être exécutée.

  • Toujours : Indique que l'action est exécutée à chaque fois que l'événement se produit.

  • Jamais : Indique que l'action n’est pas exécutée lorsque l'événement se produit.

  • Sous conditions, en fonction de la variable : Indique que l'action est uniquement exécutée lorsqu’une variable sélectionnée répond à une condition spécifiée. Utiliser cette option dans les situations où une seule condition détermine l'exécution de l'action. Après avoir sélectionné cette option, vous pouvez créer l'instruction conditionnelle dans la zone de saisie prévue à cet effet.

    Contrôles de zone de saisie

    • Variable : Saisissez la variable que vous souhaitez utiliser pour l'instruction conditionnelle. Saisissez la variable dans la zone de saisie. Cliquer sur pour voir une liste de variables récemment utilisées ou cliquer sur Plus de variables pour ouvrir la boîte de dialogue Insérer une variable.

    • [Opérateur relationnel]: Définit l'opérateur relationnel à utiliser pour l'énoncé conditionnel. Cliquez sur l'opérateur existant pour afficher une liste contenant d'autres opérateurs, puis cliquez sur celui que vous souhaitez utiliser. Pour en savoir plus, reportez-vous à la rubrique Opérateurs relationnels. Les opérateurs qui sont disponibles dans la liste dépendent de si vous avez sélectionné Texte ou Décimal pour l'option Type.

    • Valeur : Définit les valeurs à utiliser pour l'instruction conditionnelle. Pour ajouter une valeur, cliquez sur , cliquez sur <saisir une valeur>, saisissez la valeur souhaitée, puis appuyez sur Enter. Pour supprimer une valeur, utilisez le bouton secondaire de la souris pour cliquer dessus, puis cliquez sur Supprimer. Pour certains opérateurs, par exemple Est vide et N'est pas vide, il n'est pas nécessaire de définir de valeur. Dans ces cas, le champ Valeur n'est pas disponible.

    • Type : Indique si l'énoncé conditionnel évalue un texte ou une valeur décimale.

  • Sous conditions, en fonction de l'expression : Spécifie les conditions dans lesquelles l'action est exécutée. Utilisez cette option pour les situations nécessitant plusieurs énoncés conditionnels. Lorsque vous sélectionnez cette option, vous pouvez créer l'instruction conditionnelle dans la zone de saisie en créant les instructions conditionnelles de votre choix. Vous pouvez créer et éditer l'expression conditionnelle dans l'onglet Vue arborescente. Cliquez sur l'onglet Vue arborescente pour afficher une vue en lecture seule de l'expression conditionnelle.

    Contrôles de zone de saisie (onglet Vue arborescente)

    • [Opérateur conditionnel]: Définit l'opérateur conditionnel pour les énoncés conditionnels du groupe. L'opérateur conditionnel par défaut est And.

      Cliquez sur l'opérateur conditionnel existant pour afficher un menu que vous pouvez utiliser pour configurer votre expression conditionnelle d'une des manières suivantes :

      • And, Or, NotAnd, NotOr : Cliquez sur l'opérateur conditionnel dans la liste que vous souhaitez utiliser pour les énoncés conditionnels. Pour en savoir plus sur les opérateurs conditionnels pris en charge, consulter Opérateurs conditionnels.

      • Ajouter une condition : Cliquez pour ajouter un autre énoncé conditionnel au groupe actuel.

      • Ajouter groupe : Cliquez pour ajouter un sous-groupe d'instructions conditionnelles au groupe actuel.

      • Supprimer le groupe : Cliquez sur pour supprimer le sous-groupe. Disponible lorsque vous ouvrez le menu à partir d'un sous-groupe.

      • Tout supprimer : Cliquez pour supprimer toutes les instructions conditionnelles (y compris les sous-groupes). Disponible lorsque vous ouvrez le menu à partir du groupe supérieur.

    • : Ajoute une instruction conditionnelle au groupe associé à cet opérateur. Visible à droite de chaque opérateur conditionnel de votre expression.

    • :  Supprime l’instruction conditionnelle. Visible à droite d'une instruction conditionnelle existante lorsque vous pointez sur l'instruction.

    • Variable : Saisissez la variable que vous souhaitez utiliser pour l'instruction conditionnelle. Saisissez la variable dans la zone de saisie. Cliquer sur pour voir une liste de variables récemment utilisées ou cliquer sur Plus de variables pour ouvrir la boîte de dialogue Insérer une variable.

    • [Opérateur relationnel]: Définit l'opérateur relationnel à utiliser pour l'énoncé conditionnel. Cliquez sur l'opérateur existant pour afficher une liste contenant d'autres opérateurs, puis cliquez sur celui que vous souhaitez utiliser. Pour en savoir plus, reportez-vous à la rubrique Opérateurs relationnels. Les opérateurs qui sont disponibles dans la liste dépendent de si vous avez sélectionné Texte ou Décimal pour l'option Type.

    • Valeur : Définit les valeurs à utiliser pour l'instruction conditionnelle. Pour ajouter une valeur, cliquez sur , cliquez sur <saisir une valeur>, saisissez la valeur souhaitée, puis appuyez sur Enter. Pour supprimer une valeur, utilisez le bouton secondaire de la souris pour cliquer dessus, puis cliquez sur Supprimer. Pour certains opérateurs, par exemple Est vide et N'est pas vide, il n'est pas nécessaire de définir de valeur. Dans ces cas, le champ Valeur n'est pas disponible.

    • Type : Indique si l'énoncé conditionnel évalue un texte ou une valeur décimale.

Erreur de traitement et diagnostic

• Ignorer les erreurs et continuer à exécuter les actions : Indique que si l'action échoue, les autres actions continueront à être exécutées. Lorsque cette option n’est pas sélectionnée et que l’action échoue, le comportement adopté dépend de plusieurs facteurs, comme suit :

  L'action s'inscrit dans une action du Grouper

  • Si vous avez spécifié De manière séquentielle pour la propriété Exécuter les actions sur l’onglet Exécution du Grouper, aucune autre action n'est exécutée dans cette action de Grouper. Aucune action en dehors de cette action du Grouper n'est affectée.

  • Si vous avez spécifié En parallèle pour la propriété Exécuter les actions sur l’onglet Exécution du Grouper, les erreurs sont ignorées et les autres actions dans ce Grouper sont exécutées. Aucune action en dehors de cette action du Grouper n'est affectée.

  L'action ne s'inscrit pas dans une action du Grouper

  • Si vous avez spécifié De manière séquentielle pour la propriété Exécuter les actions sur l’onglet Exécution de l’événement, aucune autre action n'est exécutée dans l’événement.

  • Si vous avez spécifié En parallèle pour la propriété Exécuter les actions sur l’onglet Exécution de l’événement, les erreurs sont ignorées et les autres actions dans l’événement sont exécutées.

• Réessayer en cas d'échec : Spécifie que si l'action échoue, BarTender essaie de l'exécuter à nouveau.

  • Nombre maximum de nouvelles tentatives : Indique le nombre maximum de tentatives de réexécution de l'action par BarTender. Disponible lorsque l'option Réessayer en cas d'échec est sélectionnée.

  • Intervalle de nouvelles tentatives : Indique la durée d'attente de BarTender après que l’action échoue avant de tenter de réexécuter l'action. Disponible lorsque l'option Réessayer en cas d'échec est sélectionnée.