Version de WDScript : 2.0.5+

Modifie l'enregistrement spécifié dans le fichier courant, la requête ou la vue. Les index correspondant à toutes les clés utilisées ont mis à jour automatiquement. Les mémos sont ajoutés si nécessaire si la gestion des mémos est activé.

Syntaxe

HModifie([<Nom du fichier>] [,<Enregistrement> [, <Options>]])

<Nom du fichier> : Chaîne de caractères optionnelle (avec guillemets) contenant le nom du fichier, de la vue ou de la requête manipulé. Si ce nom n'est pas spécifié, la fonction va manipuler le dernier fichier utilisé.

<Enregistrement> : Entier optionnel mis pour le numéro de l'enregistrement à modifier. L'enregistrement chargé en mémoire est ré-écrit sur l'enregistrement spécifié.
Si ce numéro est supérieur au nombre d'enregistrements dans le fichier, des enregistrements supprimés intermédiaires seront créés pour que la lecture séquentielle du fichier (fonction HLit) soit cohérente.
Si ce paramètre n'est pas spécifié (est égal à 0 ou à la constante hNumEnrEnCours), la fonction HModifie va modifier l'enregistrement en cours dans le fichier.
Attention : Il ne faut pas confondre le numéro d'enregistrement avec l'identifiant automatique associé à l'enregistrement. Dans une utilisation normale, ces deux numéros ne sont pas identiques. Le numéro d'enregistrement peut être connu par la fonction HNumEnr.
Pour utiliser le paramètre <Options>, il est nécessaire de préciser le paramètre <Enregistrement>.

<Options> : Constante optionnelle mis pour paramétrer l'influence de la modification sur le parcours en cours ou le mode de calcul de l'identifiant automatique.
Remarque : pour utiliser ce paramètre, il est nécessaire de préciser le paramètre <Enregistrement>.

* Influence de l'ajout sur le parcours du fichier
- hEcritureDéfaut (valeur par défaut) : La modification n'affecte pas le parcours en cours.
- hAffecteParcours : La modification affecte le parcours.
Si les deux constantes sont précisées, hAffecteParcours est prioritaire sur hEcritureDéfaut.

* Mode de calcul de l'identifiant automatique
- hForceIdAuto : L'identifiant automatique n'est pas calculé lors de la modification, la valeur de l'identifiant sera celle mémorisée au moment de la modification.
- hFixeIdAuto : L'identifiant automatique n'est pas calculé lors de la modification, la valeur de l'identifiant sera celle mémorisée au moment de modification. La prochaine valeur de l'identifiant calculée par le moteur Hyper File correspondra à la plus grande valeur de l'identifiant dans le fichier +1.
- hRecalculeIdAuto : L'identifiant automatique de l'enregistrement sera recalculé lors de la modification. Cette option est prioritaire sur les options hForceIdAuto et hFixeIdAuto.
Si les trois constantes sont utilisées en même temps, une erreur W-Langage est générée.

* Mode de blocage de l'enregistrement modifié
- hBlocageNon (par défaut) : même si la fonction HDébutVerrou a été utilisée, l'enregistrement modifié ne sera pas bloqué.
- hBlocageEcriture : l'enregistrement modifié sera bloqué en écriture. Cet enregistrement pourra être lu par une autre application mais ne pourra pas être modifié par une autre application. Seule l'application en cours pourra le modifier, ou le débloquer.
- hBlocageLectureEcriture : l'enregistrement modifié sera bloqué en lecture et en écriture. Cet enregistrement ne pourra ni être lu ni être modifié par une autre application. Seule l'application en cours pourra le modifier, le lire ou le débloquer.

* Mode de gestion des doublons
- hIgnoreDoublon : Ignore le contrôle des doublons pour cette opération, même si le contrôle automatique des doublons est branché.
- HVérifieDoublon : Contrôle les doublons pour cette opération, même si le contrôle des doublons est débranché.
Si les deux constantes sont utilisées en même temps, une erreur W-Langage est générée.

* Mode de gestion de l'intégrité
- hIgnoreIntégrité : Ignore le contrôle d'intégrité sur cette opération , même si le contrôle de l'intégrité automatique est branché.
- hVérifieIntégrité : Contrôle l'intégrité de l'opération même si le contrôle de l'intégrité automatique est débranché.
Si les deux constantes sont utilisées en même temps, une erreur W-Langage est générée. Ces constantes n'ont aucun effet sur la modification en cascade.

Remarque

Aucune

Exemple

<wdscript>
// Récupération des informations d'un formulaire
action est une chaîne = GetFormField("_ACTION")
key est un entier long
si action <> "" alors	
	si action~="M" ou action~="S" alors
		key  = GetFormField("CLE")		
		HLitRecherche("PERSONNE", "IDPERSONNE", key)
	fin
	si action = "S" alors
		si HFound alors HSupprime("PERSONNE")
	sinon
		PERSONNE.NOM = GetFormField("NOM")
		PERSONNE.PRENOM = GetFormField("PRENOM")
		PERSONNE.AGE = GetFormField("AGE")
		si action = "M" alors
			HModifie("PERSONNE")
		sinon
			HAjoute("PERSONNE")
		fin
	fin
fin
</wdscript>

Commentaires

Les commentaires doivent si possible être postés en anglais. Ils sont soumis à la modération avant d'être publiés.

Ajouter votre commentaire