Ouvrir la rubrique avec les liens de navigation

L'action Script d'impression BTXML permet d'envoyer à BarTender un script BarTender XML pour traiter le code et réaliser les tâches définies par ce code.

You can configure the following properties for the Print BTXML Script 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.

Script

• Source : Indique la source du script BTXML.

  • Script intégré :

  • Valeur : Utilisez la zone de saisie prévue pour saisir le modèle que vous souhaitez que l'action utilise. Autrement, vous pouvez aussi ajouter une variable pour définir le modèle 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 souhaité. 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.

Remplacements par l'option d'impression

• Invite de saisie de données : Lorsque cette option est activée, les formulaires de saisie de données et les requêtes du document sont ouverts pour permettre à l'utilisateur de saisir des données avant d'envoyer le travail d'impression à l'imprimante.

Options de vérification

• Mettre le travail d'impression en file d'attente et poursuivre immédiatement : Envoie le travail au planificateur d'impression et réalise l'action immédiatement. When this option is selected, no "response" option is available.

• Vérifier que le travail d'impression a été traité avant de poursuivre : Envoie le travail au planificateur d'impression et attend la confirmation de traitement du travail d'impression avant de réaliser l'action.

  • Placer la réponse dans la variable : Définit la variable qui retournera la réponse de l'action. Saisissez le nom de variable souhaité. Autrement, vous pouvez aussi ajouter une variable.

Tester Script d'impression BTXML

• 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.

• Renvoyer les travaux d'impression ayant échoué : Lorsque cette option est activée, les travaux d'impression ayant échoué sont renvoyés au spouleur d'impression.

• Nombre maximum de nouvelles tentatives : Indique le nombre maximum de renvois des travaux d'impression ayant échoué. Disponible quand l'option Renvoyer les travaux d'impression ayant échoué est activée.

• 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.

Related Integration Builder Example

• Print Document Using BTXML Over a Network Socket (links to the BarTender Support Center)