HTransactionDébut (Fonction)

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Version :

Accueil | Connexion | Français (générique)

Aide / WLangage / Gestion des bases de données / HFSQL / Gestion des transactions / Fonctions WLangage

Application réseau (base de données ISAM)
Blocage des enregistrements
Cas d'erreurs
Fichiers temporaires créés lors de la transaction (base de données ISAM)
Manipulations d'enregistrements pendant une transaction
Transactions et contexte HFSQL indépendant
OLE DB et Connecteurs Natifs

WINDEV

WEBDEV

WINDEV Mobile

Autres

Voir Aussi

HTransactionDébut (Fonction)

En anglais : HTransactionStart

Non disponible avec ce type de connexion

Démarre une transaction sur les tables (HFSQL ou accédées via Connecteur Natif) et crée le fichier des transactions.

Quelles sont les informations enregistrées dans la table des transactions? Chaque fois qu'une fonction WLangage effectue une modification sur une table ou d'index pendant la transaction, les anciennes valeurs de l'enregistrement et l'opération effectuée sont mémorisées dans la table des transactions.

Cette fonction propose deux modes de fonctionnement des transactions:

La transaction peut être démarrée sur une connexion: dans ce cas, seuls les fichiers associés à cette connexion sont mis en transaction. Ce mode est nécessaire pour gérer les niveaux d'isolation des transactions.
La transaction peut être démarrée sur toutes les connexions HFSQL existantes ou à venir. Dans ce cas, la fonction HTransactionDébut démarre à la fois une transaction HFSQL Classic (ISAM) et une transaction HFSQL Client/Serveur.

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

Remarque: Cette fonction est équivalente à la fonction HTransaction.

Exemple

MaConnexion1 est une Connexion
// Début de la transaction sur les tables associées à la connexion MaConnexion1
HTransactionDébut(MaConnexion1)
// Code permettant de préparer la commande à ajouter
// ...
QUAND EXCEPTION DANS
	// Ajout de la commande
	HAjoute(Commande) 
	// Validation de l'ajout
	HTransactionFin(MaConnexion1)
FAIRE
	// Suppression des lignes de commandes
	HTransactionAnnule(MaConnexion1)
FIN

// Début de la transaction sur les tables Commande et LigneCde
HTransactionDébut("C:\Temp\Transaction.trs", "Commande,LigneCde,-Client")

// Code permettant de préparer la commande à ajouter
// ...

QUAND EXCEPTION DANS
	// Ajout de la commande
	HAjoute(Commande) 
	// Validation de l'ajout
	HTransactionFin() 
FAIRE
	// Suppression des lignes de commandes
	HTransactionAnnule() 
FIN

Syntaxe

Débuter une transaction Client/Serveur sur une connexion spécifique Masquer les détails

<Résultat> = HTransactionDébut(<Connexion> [, <Liste des tables>])

<Résultat> : Booléen

Vrai si la transaction a débuté,
Faux en cas de problème. La fonction HErreurInfo permet d'obtenir plus de renseignements sur l'erreur.

<Connexion> : Chaîne de caractères ou variable de type Connexion

Nom de la connexion à manipuler. Cette connexion correspond:
soit au nom de la connexion définie sous l'éditeur de schémas des données ou grâce aux fonctions HDécritConnexion ou HOuvreConnexion.
soit au nom d'une variable de type Connexion.
Si ce paramètre correspond à la constante hAccèsHF7, la transaction est réalisée sur les tables HFSQL ISAM.

<Liste des tables> : Chaîne de caractères optionnelle

Liste de noms logiques d'une ou de plusieurs tables à prendre en compte dans la transaction ou non (dans ce cas le nom de la table est précédé du signe "-").
Si ce paramètre n'est pas précisé Toutes les tables manipulées pendant la transaction seront prises en compte dans la transaction.
Si toutes les tables sont préfixées par le signe "-"
Par exemple: "-Client, -Produit" Toutes les tables spécifiées dans la liste et manipulées pendant la transaction ne seront pas prises en compte par la transaction.
Toutes les tables non précisées dans la liste seront prises en compte et manipulées durant la transaction.
Si aucune table de la liste n'est préfixée par le signe "-"
Par exemple: "Client, Produit" Toutes les tables spécifiées dans la liste et manipulées durant la transaction seront prises en compte dans la transaction.
Toutes les tables non spécifiées et manipulées durant la transaction ne seront pas prises en compte dans la transaction.
Si certaines tables sont préfixées par "-" et d'autres non
Par exemple: "-Client, Produit" (équivalent à "Produit") Toutes les tables dans la liste préfixées par "-" et manipulées durant la transaction ne seront pas prises en compte dans la transaction.
Toutes les tables dans la liste non préfixées par "-" et manipulées durant la transaction seront prises en compte dans la transaction.
Les fichiers non mentionnés dans la liste seront exclus de la transaction.
Ce paramètre est ignoré. Toutes les tables associées à la connexion sont en transaction sur le serveur natif.

Débuter une transaction Client/Serveur sur une connexion spécifique ou une transaction ISAM Masquer les détails

<Résultat> = HTransactionDébut(<Connexion> , <Fichier de transaction> , <Liste des tables>)

<Résultat> : Booléen

Vrai si la transaction a débuté,
Faux en cas de problème. La fonction HErreurInfo permet d'obtenir plus de renseignements sur l'erreur.

<Connexion> : Chaîne de caractères ou variable de type Connexion

Connexion à utiliser. Cette connexion correspond:
soit au nom de la connexion définie sous l'éditeur de schémas des données ou grâce aux fonctions HDécritConnexion ou HOuvreConnexion.
soit au nom d'une variable de type Connexion.
Si ce paramètre correspond à une chaîne vide ("") ou à la constante hAccèsHF7, la transaction est réalisée sur les tables HFSQL ISAM.

<Fichier de transaction> : Chaîne de caractères

Nom complet du fichier de transaction (utilisé pour enregistrer les opérations réalisées en transaction). Ce fichier sera automatiquement détruit lors de l'utilisation des fonctions HTransactionFin ou HTransactionAnnule.
Si ce nom correspond à une chaîne vide, le fichier de transaction sera créé dans le répertoire des tables de l'application et aura pour nom: <Nom Projet>_$TRS_OPERATION.TRS.
Ce paramètre n'est pas pris en compte. Ce paramètre est pris en compte uniquement pour les transactions HFSQL Classic (transactions ISAM).

<Liste des tables> : Chaîne de caractères

Liste de noms logiques d'une ou de plusieurs tables à prendre en compte dans la transaction ou non (dans ce cas le nom de la table est précédé du signe "-").
Si ce paramètre n'est pas précisé Toutes les tables manipulées pendant la transaction seront prises en compte dans la transaction.
Si toutes les tables sont pré-fixées par le signe "-"
Par exemple: "-Client, -Produit" Toutes les tables spécifiées dans la liste et manipulées pendant la transaction ne seront pas prises en compte par la transaction.
Toutes les tables non précisées dans la liste seront prises en compte et manipulées durant la transaction.
Si aucune table de la liste n'est pré-fixée par le signe "-"
Par exemple: "Client, Produit" Toutes les tables spécifiées dans la liste et manipulées durant la transaction seront prises en compte dans la transaction.
Toutes les tables non spécifiées et manipulées durant la transaction ne seront pas prises en compte dans la transaction.
Si certaines tables sont pré-fixées par "-" et d'autres non
Par exemple: "-Client, Produit" (équivalent à "Produit") Tous les tables dans la liste pré-fixées par "-" et manipulées durant la transaction ne seront pas prises en compte dans la transaction.
Toutes les tables dans la liste non préfixées par "-" et manipulées durant la transaction seront prises en compte dans la transaction.
Les tables non mentionnées dans la liste seront exclues de la transaction.
Ce paramètre est ignoré. Toutes les tables associées à la connexion sont en transaction sur le serveur natif.

Débuter une transaction ISAM et/ou Client/Serveur sur toutes les connexions HFSQL Client/Serveur (existantes ou à venir) Masquer les détails

<Résultat> = HTransactionDébut([<Fichier de transaction> [, <Liste des fichiers>]])

<Résultat> : Booléen

Vrai si la transaction a débuté,
Faux en cas de problème. La fonction HErreurInfo permet d'obtenir plus de renseignements sur l'erreur.

<Fichier de transaction> : Chaîne de caractères optionnelle

Nom complet du fichier de transaction (utilisé pour enregistrer les opérations réalisées en transaction). Ce fichier sera automatiquement détruit lors de l'utilisation des fonctions HTransactionFin ou HTransactionAnnule.
Si ce nom n'est pas spécifié ou correspond à une chaîne vide, le fichier de transaction sera créé dans le répertoire des tables de l'application et aura pour nom: <Nom Projet>_$TRS_OPERATION.TRS.
Ce paramètre n'est pas pris en compte. Ce paramètre est pris en compte uniquement pour les transactions HFSQL Classic (transactions ISAM).

<Liste des fichiers> : Chaîne de caractères optionnelle

Liste de noms logiques d'une ou de plusieurs tables à prendre en compte dans la transaction ou non (dans ce cas le nom de la table est précédé du signe "-").
Si ce paramètre n'est pas précisé Toutes les tables manipulées pendant la transaction seront prises en compte dans la transaction.
Si toutes les tables sont pré-fixées par le signe "-"
Par exemple: "-Client, -Produit" Toutes les tables spécifiées dans la liste et manipulées pendant la transaction ne seront pas prises en compte par la transaction.
Toutes les tables non précisées dans la liste seront prises en compte et manipulées durant la transaction.
Si aucune table de la liste n'est pré-fixée par le signe "-"
Par exemple: "Client, Produit" Toutes les tables spécifiées dans la liste et manipulées durant la transaction seront prises en compte dans la transaction.
Toutes les tables non spécifiées et manipulées durant la transaction ne seront pas prises en compte dans la transaction.
Si certaines tables sont pré-fixées par "-" et d'autres non
Par exemple: "-Client, Produit" (équivalent à "Produit") Tous les tables dans la liste pré-fixées par "-" et manipulées durant la transaction ne seront pas prises en compte dans la transaction.
Toutes les tables dans la liste non préfixées par "-" et manipulées durant la transaction seront prises en compte dans la transaction.
Les tables non mentionnées dans la liste seront exclues de la transaction.

Remarques

Application réseau (base de données ISAM)

En réseau, le fichier de transactions peut être créé aussi bien sur un disque local que sur une unité réseau.

Si le fichier de transactions est installé sur un poste local, il ne contiendra que les informations de transactions réalisées par le poste en cours. Dans ce cas, le fichier de transactions est supprimé lors de la terminaison de la transaction.
Si le fichier de transactions est installé sur une unité réseau (installation conseillée), le fichier des transactions contiendra les informations de transactions de plusieurs postes. Chaque poste est identifié par un numéro unique. Dans ce cas, le fichier de transactions est supprimé lors de la terminaison de la dernière transaction.

Blocage des enregistrements

Les enregistrements ajoutés, modifiés ou supprimés dans une transaction sont bloqués en écriture.

Cas d'erreurs

Imbrication de transactions: Il est impossible d'imbriquer les transactions (c'est-à-dire d'appeler la fonction HTransactionDébut dans une transaction). Dans ce cas, l'erreur 70031 est générée.
Une erreur fatale est affichée dans les cas suivants:
- Une transaction est débutée sur toutes les connexions alors qu'il existe au moins une connexion en transaction.
- Une transaction sur une connexion est débutée après avoir commencé une transaction sur toutes les connexions.
- Une transaction sur toutes les connexions est débutée alors qu'il existe au moins une connexion dont le mode d'isolation n'est pas "Read Uncommitted".

Fichiers temporaires créés lors de la transaction (base de données ISAM)

Lors de la transaction, des fichiers temporaires (extension ".TRX") sont créés dans le répertoire contenant les tables (fichiers ".FIC"). Ces fichiers temporaires ne doivent pas être supprimés. Dans le cas contraire, les données manipulées par la transaction pourraient être endommagées.

Remarque: Ces fichiers temporaires sont automatiquement détruits à la fin de la transaction.

Manipulations d'enregistrements pendant une transaction

Pendant une transaction, il est nécessaire de suivre certaines règles lors de la manipulation des enregistrements. Pour plus de détails, consultez Transactions: Manipuler les enregistrements lors d'une transaction.

Transactions et contexte HFSQL indépendant

Lors de la copie de contexte, si une transaction est en cours sur le premier contexte, le nouveau contexte n'est pas en transaction. Il faut rappeler la fonction HTransactionDébut pour démarrer une transaction dans le nouveau contexte.

OLE DB et Connecteurs Natifs

Seules les syntaxes avec connexion sont prises en compte par les Accès Natifs qui gèrent les transactions. Il est également possible d'utiliser la fonction SQLTransaction.

Composante: wd300hf.dll

Voir Aussi

Version minimum requise

Version 9

Documentation également disponible pour…

Commentaires

Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 27/03/2025

Signaler une erreur ou faire une suggestion | Aide en ligne locale