Insérer un enregistrement de base de données

Connexion à la base de données

• Configuration base de données : Lance l’assistant de configuration de base de données, où vous pouvez vous connecter au système de bases de données relationnelles utilisées par l’action. Pour en savoir plus sur l’utilisation de l’assistant de Configuration de base de données, consultez la boîte de dialogue Configuration de base de données.

• Type de base de données : Affiche le type de base de données une fois que vous avez terminé le processus d'établissement de la connexion à la base de données.

• Emplacement : Affiche l’emplacement des fichiers de la base de données une fois que vous avez terminé le processus d'établissement de la connexion à la base de données.

Valeur d’enregistrement

Utilisez les onglets suivants pour définir les valeurs de l'enregistrement de base de données inséré :

• Assistant de commande d'insertion : Affiche les champs de base de données de la base de données connectée. Pour saisir une valeur pour un champ, cliquez pour cocher la case du champ, puis saisissez la valeur ou la variable que vous voulez dans la colonne Valeur. Pour utiliser la valeur par défaut d'un champ s'il en a un, ne cochez pas la case.

• Commande SQL : Affiche les valeurs que vous spécifiez dans l'onglet Assistant de commande d'insertion sous forme d'instruction SQL INSERT.

  • Activer l'édition des commandes SQL : Rend la zone de saisie de la commande SQL inscriptible, afin de pouvoir éditer la commande. Cette option est destinée aux utilisateurs avancés qui sont expérimentés dans la rédaction de leurs propres instructions SQL.

Les données binaires ne sont pas prises en charge pour l'action Insérer un enregistrement de base de données.

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.

    Contrôles de zone de saisie

    • Variable : Indique 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 que vous souhaitez utiliser pour les instructions conditionnelles. 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 tous les énoncés conditionnels (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 : Indique 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 lorsque cette option échoue, les autres actions continueront à être exécutées. Si elle n’est pas sélectionnée et que l'action échoue, le comportement résultant dépend de plusieurs facteurs, comme suit :

  L'action s'inscrit dans une action du Groupe

  • Si vous avez spécifié De manière séquentielle pour la propriété Exécuter les actions sur l’onglet Exécution du Groupe, aucune autre action n'est exécutée dans cette action de groupe. Aucune action en dehors de cette action du Groupe 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 Groupe, les erreurs sont ignorées et les autres actions dans ce Groupe sont exécutées. Aucune action en dehors de cette action du Groupe n'est affectée.

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

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