Récupérer la ligne de la table sélectionnée

Cette action permet de récupérer les numéros des lignes sélectionnées ou les valeurs des champs sélectionnés dans l'objet Table de la base de données du formulaire. Les valeurs sont stockées dans une variable nouvelle ou existante. Récupérer la ligne de la table sélectionnée fonctionne comme une partie de l'action Sélectionner la ligne de la table .

À 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 sélectionner les valeurs à stocker dans une variable.

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

  • Numéros de lignes sélectionnées: Stocke les numéros des lignes sélectionnées dans Variable des lignes sélectionnées.

  • Contenu du champ de la table pour les lignes sélectionnées: Stocke la valeur associée au champ pour les lignes de la table sélectionnées.

    • Champ de la table: Définit le champ de la table dans lequel on récupère les valeurs pour les stocker dans la Variable des lignes sélectionnées.

  Note

  Si plusieurs lignes sont sélectionnées, les valeurs stockées (numéros de lignes ou valeurs des champs) sont séparées par des virgules. Pour activer la sélection de plusieurs lignes, ouvrir Propriétés de l'objet Table de la base de données > Paramètres et activer Sélection de plusieurs lignes.

  Note

  Si les valeurs stockées (numéros de ligne ou valeurs de champ) contiennent des virgules, elles sont entourées de guillemets.

• Variable des lignes sélectionnées: Choisit ou crée une variable pour stocker la valeur du Champ de la table ou des Numéros de lignes sélectionné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.