DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Gestion des transactions / Fonctions WLangage
  • Cas particuliers
  • Manipulations d'enregistrements pendant une transaction
  • Transactions et contexte HFSQL indépendant
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Transforme tous les enregistrements "en transaction" en enregistrements "Normaux" si ces enregistrements n'appartiennent pas à une transaction actuellement en cours. Si un enregistrement du fichier de données spécifié est considéré comme étant en transaction, mais n'appartient à aucune transaction en cours, il est automatiquement libéré.
Attention : cette fonction est une fonction avancée. Cette fonction doit être utilisée lorsqu'il est impossible d'annuler les transactions qui ont échoué (fichiers de transaction supprimés par exemple).
Exemple
// Libère tous les enregistrements en transaction susceptibles d'être utilisés
HTransactionLibère(Client)
Syntaxe

Libération d'un fichier de données Masquer les détails

<Résultat> = HTransactionLibère([<Fichier de données>])
<Résultat> : Booléen
  • Vrai si l'opération est effectuée,
  • Faux en cas de problème. La fonction HErreurInfo permet d'obtenir plus de renseignements sur l'erreur.
<Fichier de données> : Chaîne de caractères optionnelle
Nom du fichier de données HFSQL Classic ou Client/Serveur pour lequel les enregistrements en cours de transaction doivent être libérés.
Si ce paramètre n'est pas spécifié, la fonction HTransactionLibère manipule le dernier fichier de données utilisé.
AndroidWidget AndroidiPhone/iPadWidget IOSMac Catalyst Seuls les fichiers de données HFSQL Client/Serveur peuvent être manipulés.

Libération d'un enregistrement d'un fichier de données Masquer les détails

<Résultat> = HTransactionLibère([<Fichier de données>, ] <Numéro de l'enregistrement>)
<Résultat> : Booléen
  • Vrai si l'opération est effectuée,
  • Faux en cas de problème. La fonction HErreurInfo permet d'obtenir plus de renseignements sur l'erreur.
<Fichier de données> : Chaîne de caractères optionnelle
Nom du fichier de données HFSQL Classic ou Client/Serveur pour lequel l'enregistrement en cours de transaction doit être libéré.
Si ce paramètre n'est pas spécifié, la fonction HTransactionLibère manipule le dernier fichier de données utilisé.
AndroidWidget AndroidiPhone/iPadWidget IOSMac Catalyst Seuls les fichiers de données HFSQL Client/Serveur peuvent être manipulés.
<Numéro de l'enregistrement> : Entier
Numéro de l'enregistrement à libérer.
Si ce paramètre est égal à 0 ou à la constante hNumEnrEnCours, la fonction HTransactionLibère va manipuler l'enregistrement en cours.
Remarques

Cas particuliers

  • Cette fonction peut être utilisée uniquement pour des fichiers de données au format HFSQL. Pour tous les autres types de fichier de données, cette fonction est sans effet et renvoie Vrai.
  • Les enregistrements ne pouvant pas être lus (enregistrements bloqués par exemple) sont ignorés.
  • AndroidWidget AndroidiPhone/iPadWidget IOSMac Catalyst La gestion des transactions est disponible uniquement pour les bases de données HFSQL Client/Serveur.
  • Cette fonction peut être utilisée pour libérer les transactions effectuées sur des fichiers de données présents dans un cluster HFSQL.

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 (ou la fonction HTransaction) pour démarrer une transaction dans le nouveau contexte.
Composante : wd300hf.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 04/06/2024

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