• Présentation des transactions : Qu'est-ce qu'une transaction, utiliser les transactions selon ses besoins, etc.
• Principe : gestion des transactions sur des fichiers HFSQL et cas particuliers.
• Manipuler les transactions par programmation.
• Gestion des cas particuliers (panne de courant, rétablir la cohérence de la base de données, etc).
• Gestion avancée : les fichiers créés lors d'une transaction, gestion de l'identifiant du poste.

La gestion des transactions est disponible uniquement pour les bases de données HFSQL Client/Serveur.

Mettre en place la gestion des transactions

1. Si vos fichiers de données sont protégés par mot de passe, ouvrez tous les fichiers de données utilisés pendant la transaction avant le début de la transaction ou spécifiez les différents mots de passe à l'aide de la fonction HPasse.
   Si vos fichiers de données ne sont pas protégés par mot de passe, les fichiers de données manipulés après la fonction HTransactionDébut (ou la fonction HTransaction) seront automatiquement mis en transaction.
2. Commencez la transaction avec la fonction HTransactionDébut ou avec la fonction HTransaction.
3. Effectuez vos opérations. Toutes les opérations d'écriture sur les fichiers de données en transaction sont automatiquement enregistrées dans le fichier de transaction. Attention : les traitements réalisés sont relativement plus lents (puisque chaque opération est enregistrée dans un fichier de données spécifique).
4. Annulez si nécessaire les opérations réalisées pendant la transaction (fonction HTransactionAnnule).
5. Spécifiez la fin de la transaction avec la fonction HTransactionFin : la transaction est validée.

• Le mode d'isolation des transactions est le mode "READ UNCOMMITED".
• Le mode d'isolation des transactions est défini avec la fonction HTransactionIsolation. Le mode d'isolation par défaut est le mode "READ UNCOMMITED".
• Les transactions ne sont pas disponibles sur des fichiers de données Hyper File 5.5.

Utiliser des Transactions courtes

Effectuer une seule transaction à la fois

Aucune interface utilisateur (fenêtre, état, page,...) ne doit être utilisée entre le début et la fin d'une transaction.

L'annulation d'une transaction peut parfois échouer car l'annulation d'une transaction peut provoquer des violations de contraintes d'intégrité et/ou de doublon.

• Un fichier de données manipulé par une transaction contient une clé unique.
• Un poste A effectue une transaction pendant laquelle un enregistrement de ce fichier de données est supprimé.
• Dans le même temps, un poste B ajoute un nouvel enregistrement dans le même fichier de données avec la même valeur de clé unique que l'enregistrement supprimé par le poste A.
• L'annulation de la transaction à cet instant provoquera une erreur de doublon sur la clé unique.

• Un fichier de données CLIENT manipulé est relié à un autre fichier de données COMMANDES (liaison sur une clé)
• Un poste A effectue une transaction pendant laquelle un enregistrement est ajouté dans le fichier de données CLIENT.
• Dans le même temps, un poste B ajoute un nouvel enregistrement dans le fichier de données COMMANDES relié à l'enregistrement ajouté dans le fichier de données CLIENT.
• L'annulation de la transaction à cet instant provoquera une erreur d'intégrité, car l'enregistrement ajouté dans le fichier de données COMMANDES n'aura plus de liaison avec l'enregistrement supprimé dans le fichier de données CLIENT (l'ajout dans le fichier de données CLIENT aura été annulé).

• Si vous utilisez des clés uniques de type identifiant automatique, les erreurs de doublons ne surviendront pas.
• Si vous manipulez les clés uniques vous-mêmes (vous n'utilisez pas d'identifiants automatiques), prévoyez une valeur unique pour tous les postes lors d'ajouts (fonction HAjoute) ou lors de modifications (fonction HModifie) d'enregistrements.
  Rappel : Par défaut, pour chaque enregistrement posant problème, le moteur HFSQL propose la gestion assistée des erreurs : une fenêtre permet de corriger les conflits de doublons.

• 70031 : Opération non autorisée en transaction
  Vous utilisez une fonction non autorisée pendant une transaction. Par exemple, la fonction HTransactionDébut (ou la fonction HTransaction) est utilisée en cours de transaction.
• 70034 : La dernière transaction a échoué
  Vous tentez d'utiliser un enregistrement appartenant à une transaction qui a échoué (panne de courant, ...). Le programme est relancé sans avoir annulé la transaction. Dans ce cas, il est conseillé d'annuler la transaction qui a échoué (voir ci-dessous).
• 74020 : Le mot de passe du fichier de Transaction ne correspond pas au mot de passe du fichier d'origine
  Le fichier de données (en mode HFSQL Client/Serveur) et le fichier de transaction n'utilisent pas le même mot de passe.
• 70032 : Problème de mode d'insolation
  Cette erreur peut survenir dans les cas suivants :
  • Vous tentez d'utiliser la fonction HTransactionIsolation sur des fichiers de données qui ne sont pas au format Client/Serveur.
  • Vous tentez d'utiliser un mode d'isolation alors que la transaction n'est pas effectuée sur une connexion.
  • Vous tentez d'utiliser la fonction HTransactionIsolation alors que la transaction a déjà été débutée avec la fonction HTransactionDébut (ou la fonction HTransaction).

• Soit au premier appel de la fonction HTransactionDébut (ou de la fonction HTransaction).
• Soit avec la fonction HTransactionAnnule.
• Soit avec l'outil redistribuable WDTrans (ou WDOptimizer) pour une base ISAM.
• Soit avec le Centre de Contrôle HFSQL pour une base HFSQL Client/Serveur.

1. Testez le résultat de la fonction HTransactionInterrompue dans le code d'initialisation du projet par exemple.
2. Si la transaction a été interrompue, effectuez une des opérations suivantes pour rétablir la cohérence de la base de données :
   • Appel de la fonction HTransactionAnnule.
   • Appel des fonctions HTransactionDébut/HTransactionFin.
   • Lancement de l'outil WDTrans (ou WDOptimizer) pour une base ISAM.
   • Lancement du Centre de Contrôle HFSQL pour une base HFSQL Client/Serveur.

SI HTransactionInterrompue() = Vrai ALORS 
	SI Confirmer("La transaction effectuée par le poste " + H.TrsPoste + ...
		" a été interrompue. " + ...
		 "Voulez-vous rétablir la cohérence des fichiers de données ?") = Vrai ALORS
		// Annule les transactions interrompues
		 SI HTransactionAnnule() = Faux ALORS
			 Erreur("Impossible d'annuler la transaction")
		 FIN
	FIN
FIN

• le journal des opérations en transaction : Fichier temporaire au format HFSQL contenant les différentes opérations réalisées sur les fichiers de l'application pris en compte par la transaction. Ce fichier est créé par la fonction HTransactionDébut (ou par la fonction HTransaction). Par défaut, son nom est <Nom du projet>_$TRS_OPERATION.TRS. Ce nom est modifiable avec la fonction HTransactionDébut (ou avec la fonction HTransaction).
  Ce fichier s'appelle TRSOPERATION.TRS.
• le journal des valeurs : Fichier temporaire associé à chaque fichier de données pris en compte par la transaction. Ce fichier a pour nom <Nom du fichier de données>_$$_TRSVAL.TRX. Ce fichier contient pour chaque opération réalisée dans la transaction :
  • soit le contenu de l'enregistrement avant l'opération (lors d'une suppression par exemple)
  • soit le contenu de l'enregistrement après l'opération (lors d'un ajout par exemple)
    Ce fichier s'appelle <Nom du fichier de données>.TRX.

En HFSQL Client/Serveur, un fichier supplémentaire est créé : TRSOperationInfoClient.TRS.
Ce fichier contient les informations uniques permettant d'identifier la transaction (nom de client, poste, ...).