• Erreur de doublons.
• Erreur d'intégrité.
• Erreur de mot de passe.
• Erreur de conflit de modification et d'état lors du conflit de modification.
• Erreur de blocage.
• Erreur de saisie obligatoire.
• Réindexation en cours.
• Reconnexion automatique au serveur HFSQL.

• Soit de gérer cette erreur par une fenêtre/page spécifique ou par une procédure (pour plus de détails, consultez le paragraphe Gérer une erreur HFSQL par une procédure).
• Soit de débrancher l'assistance et de gérer l'erreur par programmation (comme en WINDEV 5.5).

En WEBDEV, la gestion assistée des erreurs n'est pas disponible pour les pages statiques, les pages semi-dynamiques, les pages PHP, les pages AWP et les pages Ajax.

Dans les applications iPhone ou iPad, il est uniquement possible de personnaliser la gestion des erreurs avec la fonction HSurErreur. Par défaut, aucune fenêtre de gestion des erreurs ne s'affiche : il est nécessaire de traiter l'erreur dans tous les cas.

Dans les applications Java, Android ou Android Widget, il est uniquement possible de personnaliser l'erreur de reconnexion automatique au serveur HFSQL avec la fonction HSurErreur. Par défaut, seule la fenêtre de reconnexion automatique au serveur HFSQL s'affiche. Pour toutes les autres erreurs, il est nécessaire de traiter l'erreur.

Principe

Remarques

• Les erreurs de doublons
  Attention : Certaines erreurs de doublons peuvent ne pas être reconnues comme telles par l'accès OLE DB. Ces erreurs ne seront pas gérées comme des erreurs de doublons mais seront considérées comme des erreurs fatales. Exemple : l'analyse WINDEV et la description de la base externe ne sont pas en phase et la description du fichier dans l'analyse ne contient pas toutes les clés uniques du fichier de données définies sur la base de données.
• Les erreurs de saisie obligatoire
  Attention : l'erreur de saisie obligatoire apparaît uniquement si le provider OLE DB indique que la rubrique est associée à la propriété "NULL interdit". Dans le cas contraire, l'erreur sera traitée comme une erreur fatale.

Erreur de doublons

• Cause de l'erreur
  L'utilisateur ajoute un enregistrement pour lequel la valeur d'une clé unique existe déjà.
  Par exemple, le numéro du département, ainsi que son nom, sont définis comme clés uniques du fichier Cedex dans l'analyse. L'ajout d'un département avec un numéro déjà utilisé provoque une erreur de doublons.
• Gestion assistée par défaut disponible en WINDEV, WINDEV Mobile et WEBDEV
  Si une erreur de doublons est détectée, une fenêtre/page s'affiche, demandant à l'utilisateur de modifier la valeur de l'enregistrement provoquant l'erreur.
  
• Traitement de l'erreur
  Vérifiez le résultat de la fonction HErreurDoublon après chaque fonction HFSQL pouvant provoquer une erreur de doublons (HAjoute ou HModifie par exemple). Le libellé exact de l'erreur peut être connu avec la fonction HErreurInfo.

Erreur d'intégrité

• Cause de l'erreur
  L'utilisateur tente d'ajouter un enregistrement en ne respectant pas les contraintes d'intégrité définies entre les fichiers au niveau de l'analyse.
  Par exemple, les fichiers CEDEX, DEPARTEMENT et REGION sont liés entre eux au niveau de l'analyse. Ces liaisons répondent à des contraintes d'intégrité relationnelles. L'ajout d'un département sans avoir créé la région correspondante entraîne une erreur d'intégrité.
• Gestion assistée par défaut disponible en WINDEV, WINDEV Mobile et WEBDEV
  Lorsque une erreur d'intégrité est détectée, une fenêtre ou une page s'affiche, demandant à l'utilisateur d'annuler l'opération ou de modifier les données saisies.
• Traitement de l'erreur
  Vérifiez le résultat de la fonction HErreurIntégrité après chaque fonction HFSQL pouvant provoquer une erreur d'intégrité (HAjoute ou HModifie par exemple). Le libellé exact de l'erreur peut être connu avec la fonction HErreurInfo.

Erreur de mot de passe

• Cause de l'erreur
  Le programme tente de manipuler un fichier protégé par mot de passe (ouverture, première lecture, ...). Le mot de passe n'a pas été spécifié par programmation : une erreur de mot de passe survient.
• Gestion assistée par défaut disponible en WINDEV, WINDEV Mobile et WEBDEV
  Lorsque une erreur de mot de passe est détectée, une fenêtre ou une page s'affiche permettant à l'utilisateur de saisir le mot de passe du fichier.
  
  
• Traitement de l'erreur
  Vérifiez le résultat de la fonction HErreurMotDePasse après chaque fonction HFSQL pouvant provoquer une erreur de mot de passe (HOuvre par exemple ou dès la première fonction HFSQL manipulant le fichier). Le libellé exact de l'erreur peut être connu avec la fonction HErreurInfo.

Erreur de conflit de modification et de conflit d'état de modification

• Cause de l'erreur
  Lors de l'utilisation d'une application en réseau, des conflits peuvent survenir suite à la saisie de données contradictoires par différents utilisateurs.
  Par exemple :
  1. L'utilisateur X édite la fiche du département "Cantal".
  2. L'utilisateur Y édite la fiche du département "Cantal".
  3. L'utilisateur X renomme le département en "Cantal_01".
  4. L'utilisateur Y modifie le nom du département ("Cantal_02") et enregistre. Lors de cet enregistrement, il y a un conflit de modification.
     Un conflit de modification apparaît.
     Un conflit d'état de modification apparaît par exemple si l'utilisateur X supprime la fiche.
     Les différents cas sont récapitulés dans le tableau suivant :
     

     Actif	Conflit de modification	Conflit de modification	Conflit de modification
     Enregistrement lu	Actif	Rayé	Supprimé
     Enregistrement sur disque
     Rayé	Conflit d'état de modification	Conflit de modification	Conflit de modification
     Supprimé	Conflit d'état de modification	Conflit d'état de modification	XXXX

• Gestion assistée par défaut disponible en WINDEV, WINDEV Mobile et WEBDEV
  • En cas de conflit lors de la modification d'un enregistrement, une fenêtre apparaît proposant à l'utilisateur les différentes valeurs possibles pour l'enregistrement :
    • la valeur lue dans le fichier (avant modification).
    • la valeur modifiée par un autre utilisateur.
    • la valeur saisie par l'utilisateur en cours.
      L'utilisateur peut alors choisir la valeur de la rubrique qui sera enregistrée.
      
  • En cas de conflit d'état lors de la modification d'un enregistrement, une fenêtre apparaît proposant à l'utilisateur :
    • soit de réactiver les données supprimées.
    • soit de laisser les données dans leur état.
      L'utilisateur peut alors choisir la valeur de la rubrique qui sera enregistrée.
      
• Traitement de l'erreur
  • Pour les erreurs de conflits de modification, vérifiez le résultat de la fonction HErreurModification après chaque fonction HFSQL pouvant provoquer cette erreur (par exemple HModifie). Le libellé exact de l'erreur peut être connu avec la fonction HErreurInfo.
  • Pour les erreurs de conflit d'état de modification, vérifiez le résultat de la fonction HErreurEtatModification après chaque fonction HFSQL pouvant provoquer cette erreur (par exemple HModifie). Le libellé exact de l'erreur peut être connu avec la fonction HErreurInfo.

Erreur de blocage

• Cause de l'erreur
  Dans une application réseau, il est possible de bloquer un enregistrement ou un fichier, pour effectuer des opérations spécifiques par exemple.
  Lorsqu'un poste du réseau tente d'accéder à un enregistrement bloqué, une erreur de blocage apparaît.
• Gestion assistée par défaut disponible en WINDEV, WINDEV Mobile et WEBDEV
  En cas d'erreur de blocage, la gestion des blocages (vérification si le fichier est bloqué, traitement du blocage) est automatiquement réalisée par le moteur HFSQL.
  Une fenêtre/page apparaît indiquant à l'utilisateur que l'enregistrement ou le fichier est bloqué et lui proposant de retenter l'opération ou de l'annuler. En cas d'annulation, l'application continue de s'exécuter normalement.
  
  
• Traitement de l'erreur
  Vérifiez le résultat de la fonction HErreurBlocage après chaque fonction HFSQL pouvant provoquer une erreur de blocage.

Saisie obligatoire (base de données accédée par OLE DB)

• Cause de l'erreur
  Certaines rubriques du fichier manipulées attendent obligatoirement une valeur. Si cette valeur n'a pas été renseignée, une erreur de saisie obligatoire apparaît.
• Gestion assistée par défaut disponible en WINDEV, WINDEV Mobile et WEBDEV
  En cas de valeur non renseignée, la gestion de saisie obligatoire est automatiquement réalisée par le moteur HFSQL.
  Une fenêtre apparaît indiquant à l'utilisateur que la rubrique doit être renseignée et lui propose de saisir la valeur de la rubrique.
  
• Traitement de l'erreur
  Le numéro d'erreur associé à ce problème est 70710 : Valeur de rubrique obligatoire.
  Ces numéros d'erreurs peuvent être connus avec la fonction HErreur.

Réindexation en cours

• Cause de l'erreur
  Le fichier manipulé est actuellement en cours de réindexation. Il est impossible de manipuler le fichier (lecture, écriture, ...) pendant cette réindexation.
• Gestion assistée par défaut disponible en WINDEV, WINDEV Mobile et WEBDEV
  Une fenêtre apparaît indiquant que le fichier est en cours de réindexation (appelée aussi réorganisation). Cette fenêtre est affichée pendant toute la durée de la réindexation et ne peut être fermée. Une jauge de progression indique l'état de la réindexation.
  
  
  
  Remarque : Pour éviter les effets de clignotement, les fenêtres de réindexation livrées (fenêtre automatique ou maintenance par un autre poste) s'affichent uniquement si la réindexation risque de durer plus de 2 secondes. Dans ce cas, les fenêtres de ré-indexation apparaissent au bout de 0.7 secondes. Ce mécanisme n'est pas appliqué sur les fenêtres utilisées par la fonction HSurErreur. Pour intégrer ce mécanisme dans vos fenêtres personnalisées, consultez le code de la fenêtre "Reindexation.wdw" livrée dans le répertoire "\HyperFileSQL - Fenêtres assistance automatique".
• Traitement de l'erreur
  Le numéro d'erreur associé à ce problème est 70720 : Une ré-indexation est en cours sur le fichier
  Ces numéros d'erreurs peuvent être connus avec la fonction HErreur.

Reconnexion automatique au serveur HFSQL

• Cause de l'erreur
  L'application a perdu une ou plusieurs connexions à un ou plusieurs serveurs HFSQL. Les causes peuvent être par exemple :
  • perte de la liaison GPRS,
  • intervention sur le réseau,
  • mise à jour du serveur,
  • crash de la machine serveur,
  • mise en veille de la machine cliente.
• Gestion assistée par défaut disponible en WINDEV, WINDEV Mobile et WEBDEV
  Lorsque l'application cliente n'a plus accès au serveur, une fenêtre/page s'affiche automatiquement, informant que la connexion avec le serveur n'est pas disponible. Cette fenêtre tente une reconnexion à intervalle de temps régulier. Lorsque le serveur est à nouveau disponible, la reconnexion est automatiquement réalisée et la fenêtre disparaît. L'utilisateur peut continuer à utiliser l'application.
  Pour mettre en place la reconnexion automatique, il suffit de :
  • recompiler l'application cliente (version supérieure à 15).
  • installer le serveur HFSQL Client/Serveur (version supérieure à 15).
• Traitement de l'erreur
  Cette erreur est une erreur fatale.

• L'application possède une transaction en cours.
• L'application a bloqué un fichier (en lecture/écriture).
• L'application a bloqué un fichier en lecture/écriture et une autre application a modifié un enregistrement de ce fichier pendant la période où l'application n'était pas connectée.
• Le blocage a été effectué par une des fonctions suivantes : HPremier, HSuivant, HPrécédent ou HDernier.

Les différentes solutions

• soit d'utiliser des procédures personnalisées.
  Une procédure spécifique de votre application est automatiquement exécutée dès qu'une erreur HFSQL est rencontrée.
  Remarque : Il est possible de définir une procédure pour chaque fichier et chaque type d'erreur.
• soit d'utiliser des fenêtres ou des pages personnalisées : les fenêtres et pages standard du moteur HFSQL sont remplacées par des fenêtres ou pages de votre application.
  Remarque : Il est possible de définir une fenêtre/page pour chaque fichier et chaque type d'erreur.

Présentation

Mise en place

• 70700 : Conflit de modification
• 70710 : Valeur de rubrique obligatoire
• 70720 : Une ré-indexation est en cours sur le fichier