Ouvrir la rubrique avec les liens de navigation

L'action Commande Shell exécute une commande shell pouvant être utilisée pour exécuter des commandes du système d'exploitation ou des utilitaires de tiers.

You can configure the following properties for the Shell Command action:

Action

• Nom : Indique le nom de l'action. Si vous le souhaitez, vous pouvez remplacer le nom par défaut en tapant un nouveau nom dans le champ.

• Description : Permet d'enregistrer une description de l'action.

• Exécuter une action : Permet de définir la fréquence d'exécution de l'action.

  • Toujours : Indique à Integration Service d'exécuter l'action à chaque exécution de l'intégration.

  • Jamais : Indique à Integration Service de ne pas exécuter l'action à l'exécution de l'intégration.

  • Sous conditions, en fonction de la variable : Indique à Integration Service d'exécuter l'action uniquement quand une variable sélectionnée répond à une condition spécifiée. Utilisez cette option dans les situations où une seule condition détermine l'exécution ou pas de l'action. Après avoir activé cette option, vous pouvez créer l'énoncé conditionnel 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'énoncé conditionnel. Autrement, vous pouvez aussi ajouter une variable pour la valeur de l'énoncé conditionnel.

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

    • Valeur : Définit la ou les valeurs à utiliser pour l'énoncé conditionnel. Pour certains opérateurs, par exemple Est nul et N'est pas égal à zéro, 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 : Définit les conditions selon lesquelles Integration Service doit exécuter l'action. Utilisez cette option pour les situations nécessitant plusieurs énoncés conditionnels. Après avoir activé cette option, vous pouvez créer l'expression conditionnelle dans la zone de saisie prévue en établissant les énoncés conditionnels souhaités. 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 accéder à un menu permettant de configurer votre expression conditionnelle d'une des manières suivantes :

      • Sélectionner un opérateur conditionnel différent : Les options du menu comprennent une liste d'opérateurs conditionnels. Sélectionnez l'opérateur conditionnel que vous souhaitez utiliser pour les énoncés conditionnels. Pour en savoir plus sur les opérateurs conditionnels pris en charge, veuillez 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'énoncés conditionnels au groupe actuel.

      • Supprimer le groupe : Disponible dans le menu lorsque celui-ci a été ouvert depuis un sous-groupe. Cliquez pour supprimer le sous-groupe.

      • Tout supprimer : Disponible dans le menu lorsque celui-ci a été ouvert depuis le sous-groupe du haut. Cliquez pour supprimer tous les énoncés conditionnels (y compris les sous-groupes).

    • : Visible juste à droite de chaque opérateur conditionnel de votre expression. Cliquez pour ajouter un énoncé conditionnel au groupe associé à cet opérateur.

    • : Visible en plaçant le curseur sur un énoncé conditionnel existant. Cliquez pour supprimer l'énoncé conditionnel.

    • Variable : Saisissez la variable que vous souhaitez utiliser pour l'énoncé conditionnel. Autrement, vous pouvez aussi ajouter une variable pour l'énoncé conditionnel.

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

    • Valeur : Définit la ou les valeurs à utiliser pour l'énoncé conditionnel. Pour certains opérateurs, par exemple Est nul et N'est pas égal à zéro, il n'est pas nécessaire de définir de valeur. Dans ces cas, le champ Valeur est masqué.

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

Commande

• Source : Définit la source de la commande à envoyer.

  • 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. Alternatively, you can add a variable to specify the data, or add a special character to the value you have entered.

  • Importer : Ouvre la boîte de dialogue Ouvrir un fichier où rechercher et sélectionner un fichier contenant les données souhaitées. 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.

  • Variable :

    • Variable : Tapez la variable que vous souhaitez utiliser pour la source. Autrement, vous pouvez aussi ajouter une variable.

  • Fichier externe :

    • Emplacement : Indique le système de fichiers où se trouve le dossier source. Les systèmes ou emplacements de fichiers peuvent comprendre des systèmes de fichiers locaux ou sur réseau, Librarian, voire un emplacement de stockage sur le cloud. For more information about supported cloud storage locations, see Administration Console's Cloud Storage Page.

    • Nom du fichier : Indique le chemin du fichier. Vous pouvez taper l'emplacement du dossier et le nom du fichier ou cliquer sur Parcourir pour localiser et sélectionner le fichier souhaité. Autrement, vous pouvez aussi ajouter une variable pour définir le fichier de votre choix ou ajouter un caractère spécial à la valeur saisie.

    • Codage de fichier : Définit le codage utilisé par le fichier source.

• Arrêter l'exécution si une commande de shell échoue : Specifies that the action stops if a command fails. Autrement, les échecs de commandes sont ignorés et l'action est toujours considérée comme étant réussie.

• Attendre que toutes les commandes de shell se terminent : Specifies that the commands are not executed until after a response is received. Otherwise, the commands are executed without waiting for a response.

  • Délai d'exécution (secondes) : Specifies the amount of time the action allows for command execution before the action times out and exits.

Sortie

• Envoyer la sortie de commande au journal de messages : Logs the shell command output to the message log.

• Enregistrer la sortie et les erreurs de commande dans la variable : Indique la variable dans laquelle enregistrer la sortie et les erreurs de la commande. Enter the desired variable in the text box. Autrement, vous pouvez aussi ajouter une variable.

• Enregistrer les erreurs de commande dans la variable : Indique la variable dans laquelle enregistrer les erreurs de la commande. Enter the desired variable in the text box. Autrement, vous pouvez aussi ajouter une variable.

Tester Commande Shell

• Test : Exécute l'action. Le volet Message affiche des informations sur la réussite ou l'échec de l'action.

  Le bouton Tester n'exécute que l'action et pas l'intégration. Par conséquent, même si l'action est configurée pour utiliser une intégration, elle s'exécutera sans les données correspondantes. Pour en savoir plus sur le test des intégrations, consultez Utiliser le volet de test.

Paramètres de connexion

• Hériter de l'action parente : Lorsque cette option est activée, l'action hérite des identifiants de compte utilisateur définis sur la page de propriétés Actions. Autrement, si l'action fait partie d'une action Grouper, elle héritera des identifiants de compte utilisateur définis sur la page de propriétés Grouper de l'action parente directe.

• Spécifier les identifiants d'utilisateur : Lorsque cette option est activée, l'action s'exécute en utilisant les identifiants spécifiés.

Erreur de traitement et diagnostic

• Ignorer les erreurs et continuer à exécuter les actions : Lorsque cette option est activée, si l'action échoue, les autres actions continueront à être exécutées.

  Si elle est désactivée, quand l'action échoue, le comportement adopté dépend des scénarios suivants : Si vous avez sélectionné Séquentiellement pour la propriété Exécuter les actions de la page de propriétés hiérarchique Actions ou Grouper de l'action sélectionnée, aucune autre action de ce groupe ne sera exécutée. Si vous avez sélectionné En parallèle pour la propriété Exécuter les actions de la page de propriétés hiérarchique Actions ou Grouper de l'action sélectionnée, les actions de ce groupe ne sont pas affectées ; les erreurs sont ignorées et les autres actions du groupe sont exécutées. Si l'action sélectionnée fait partie d'une action Grouper, les actions hors de ce groupe ne sont pas affectées.

• Réessayer en cas d'échec : Lorsque cette option est activée, si l'action échoue, Integration Service tente de l'exécuter à nouveau.

• Nombre maximum de nouvelles tentatives : Indique le nombre maximum de tentatives de réexécution de l'action par Integration Service. Disponible quand l'option Réessayer en cas d'échec est activée.

• Intervalle de nouvelles tentatives : Indique le temps d'attente après l'échec de l'action avant de tenter sa réexécution par Integration Service. Disponible quand l'option Réessayer en cas d'échec est activée.