Sélectionner une ligne de la table

Cette action permet de définir la ligne à sélectionner dans un objet Table de la base de données sur un formulaire. Elle fonctionne comme l'action Récupérer la ligne de la table sélectionnée .

À propos : Ce groupe identifie l'action sélectionnée.

• Nom : permet de définir un nom pour l'action. Cela permet de reconnaître plus facilement l'action dans la liste des actions de la solution. Par défaut, le nom de l'action provient de son type.
• Description : Informations personnelles sur l'action. Mettre une description qui explique l'objectif et le rôle de l'action dans la solution.
• Type d'action : Information en lecture seule sur le type d'action sélectionné.

Le groupe Table du Formulaire permet de choisir sur un formulaire un objet Table de la base de données, et de choisir le mode de sélection de la ligne de cette table.

• Table: Définit, sur le formulaire, l'objet Table de la base de données à utiliser avec cette action.

• Mode de sélection: Définit le mode de sélection de l'enregistrement de la base de données.

  • Première ligne: sélectionne la première ligne dans l'objet Table de la base de données.

  • Dernière ligne: sélectionne la dernière ligne dans l'objet Table de la base de données.

  • Numéro de ligne: Active la sélection personnalisée des lignes de la table de la base de données. Ces valeurs peuvent être définies à la main ou dynamiquement par une source de données. Pour sélectionner plusieurs lignes, saisir les numéros de ligne séparés par des virgules.

  • Valeur du champ: Sélectionne tous les enregistrements dans la table de la base de données avec les valeurs de données correspondantes.

    • Champ de la table: Champ de la base de données avec une ou plusieurs valeurs sélectionnées en cas de correspondance.

    • Valeur du champ: Valeur qui sélectionne la ligne (enregistrement) en cas de correspondance.

  Note

  Les options Numéro de ligne et Valeur du champ sélectionnent la ligne de la table quel que soit le tri des lignes de la table. Par exemple, Ligne numéro 3 reste sélectionné même si le tri de la table repositionne la ligne numéro 3 ailleurs dans la table.

  • Sélectionner toutes les lignes: Sélectionne toutes les lignes dans la table.

  • Désélectionner toutes les lignes: Désélectionne toutes les lignes dans la table.

  Note

  Plusieurs lignes sont sélectionnées si la table le peut. Sinon, seule la première ligne est sélectionnée.

Si une ligne de la table est sélectionnée, le numéro de cette ligne peut être stocké dans une variable. Pour activer cette option, utiliser l'option Stocker le numéro de la ligne sélectionnée dans la variable dans les propriétés de la table de la base de données.

Exécution d'une action et traitement d'erreur

Chaque action peut être soumise à condition. Une action conditionnelle ne fonctionne que quand les conditions fournies lui permettent de fonctionner. Pour définir ces conditions, cliquer sur Afficher les options d'exécution et de gestion des erreurs.

Options d'exécution existantes :

• Activée : Spécifie si l'action est activée ou désactivée. Seules les actions activées seront exécutées. Cette fonctionnalité est utilisable lors du test d'un formulaire.
• Condition : définit une expression de programmation d'une ligne qui doit fournir une valeur booléenne (vrai ou faux). Quand le résultat de l'expression est vrai, l'action s'exécute. Une condition permet d'éviter que l'action soit exécutée chaque fois.

Options de Traitement d'erreurs :

• Ignorer l'échec : Spécifie si une erreur doit être ignorée. Si elle est activée, l'exécution des actions continue même si l'action en cours a échoué.

  Remarque

  Les actions indentées qui dépendent de l'action actuelle ne seront pas exécutées en cas d'échec. L'exécution des actions continuera avec l'action suivante qui se trouve au même niveau que l'action actuelle. L'erreur est enregistrée dans le journal, mais elle n'interrompt pas l'exécution de l'action.

Exemple

À la fin de l'impression, il est possible d'envoyer la mise à jour du statut à une application externe en utilisant l'action Requête HTTP . Si l'action d'impression échoue, le déclencheur arrête le traitement des actions. Pour effectuer le rapport, même après un échec d'impression, l'action Imprimer l'étiquette doit avoir l'option Ignorer l'échec activée.

• Enregistrer l'erreur dans une variable : permet de définir une variable pour y enregistrer l'erreur. La raison de l'erreur est aussi enregistrée dans les variables internes ActionLastErrorId et ActionLastErrorDesc.