Importer les données dans la table

Cette action lit les données formatées en CSV dans un fichier texte et les importe dans une base de données SQL.

Note

Avant d'utiliser cette action, il faut d'abord paramétrer la connexion à la base de données SQL. Cette action ne marche pas avec des bases de données sur fichiers de type Microsoft Access, ou des fichiers de données comme Microsoft Excel, ou des fichiers de texte brut. Utiliser une base de données sur serveur SQL comme Microsoft SQL Server.

À 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é.

Les règles suivantes s'appliquent à cette action:

  • La table doit déjà exister dans la base de données SQL.

  • La table doit contenir une CLE PRIMAIRE.

  • La première ligne d'un fichier texte doit contenir les noms de champs.

  • Le nom des champs du fichier texte doit correspondre au nom des champs de la table de la base de données.

  • Si le fichier texte ne contient pas de données pour certains champs, il sera écrit NUL dans la base de données. Si le champ n'accepte pas la valeur NUL, il sera écrit une chaîne vide ("").

  • Les valeurs de paramétrage pour les champs auto-incrémentés sont ignorées. La base de données fournira les valeurs pour ce type de champ.

  • Si la valeur provenant du fichier texte ne correspond pas à la structure du champ, l'action sera annulée et un message d'erreur s'affichera. Par exemple, si on tente de mettre une valeur alphanumérique dans un champ numérique.

  • En filtrant les enregistrements sur le formulaire pour afficher uniquement les enregistrements répondant à certaines conditions, on importera seulement soit les enregistrements qui n'apportent aucune valeur correspondant au filtre, soit ceux qui apportent la même valeur que celle du filtre défini avec le formulaire.

  • Seuls les filtres avec les conditions "égal" , pas plus grand que", "moins que", "contient" ou similaires sont autorisés.

  • Si le fichier texte contient des champs non définis dans la base de données SQL, l'importation va les ignorer. Seuls les champs connus seront importés.

Le groupe Paramètres sélectionne la table.

  • Table permet de choisir une table prédéfinie dans un menu déroulant ou crée une nouvelle table en utilisant l'assistant Base de données.

Le groupe Structure du fichier texte spécifie les paramètres de la base de données texte:

  • Séparateur: Spécifie le délimiteur dans le fichier de données. Sélectionner un délimiteur prédéfini, ou en introduire un personnalisé.

  • Délimiteur: spécifie le délimiteur du texte. Sélectionner un délimiteur prédéfini, ou en introduire un personnalisé.

  • Encodage du fichier: Spécifie le mode d'encodage utilisé dans le fichier de données. Auto définit automatiquement l'encodage. Si nécessaire, sélectionner le type d'encodage préféré dans le menu déroulant.

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.