|
|
|
|
|
<Source>.Enregistre (Fonction) En anglais : <Source>.Save Modifie l'enregistrement courant s'il existe, sinon ajoute un nouvel enregistrement. FEN_Client.VersFichier()
Client.Enregistre()
Syntaxe
<Résultat> = <Source>.Enregistre([<Options>])
<Résultat> : Booléen - Vrai si l'ajout ou la modification a été effectuée,
- Faux en cas d'erreur.
<Source> : Type correspondant à la source spécifiée Nom du fichier de données, de la vue ou de la requête manipulé. <Options> : Constante optionnelle de type entier Permet de paramétrer :- l'influence de l'ajout ou de la modification sur le parcours en cours.
- le mode de calcul de l'identifiant automatique. Pour plus de détails, consultez Gestion de l'identifiant automatique lors d'un ajout.
- le mode de blocage de l'enregistrement ajouté ou modifié.
- la gestion des doublons.
- la gestion de l'intégrité.
| | hAffecteParcours | Influence de l'ajout/modification sur le parcours : L'ajout ou la modification affecte le parcours. Par exemple, la fonction <Source>.LitSuivant utilisée après la fonction <Source>.Enregistre positionne sur l'enregistrement suivant l'enregistrement ajouté/modifié. La constante hAffecteParcours est prioritaire sur la constante hEcritureDéfaut. | hBlocageEcriture | Mode de blocage de l'enregistrement ajouté ou modifié : Blocage en écriture : l'enregistrement ajouté ou 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 | Mode de blocage de l'enregistrement ajouté ou modifié : Blocage en lecture/écriture : l'enregistrement ajouté ou 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.
| hBlocageNon (valeur par défaut) | Mode de blocage de l'enregistrement ajouté ou modifié : Aucun blocage : l'enregistrement ajouté ou modifié ne sera pas bloqué.
| hEcritureDéfaut (valeur par défaut) | Influence de l'ajout ou de la modification sur le parcours : L'ajout ou la modification n'affecte pas le parcours en cours. Par exemple, la fonction <Source>.LitSuivant utilisée après la fonction <Source>.Enregistre positionne sur l'enregistrement suivant l'enregistrement en cours avant l'ajout ou la modification. La constante hAffecteParcours est prioritaire sur la constante hEcritureDéfaut. | hFixeIDAuto | Mode de calcul de l'identifiant automatique : L'identifiant automatique n'est pas calculé lors de l'ajout : la valeur de l'identifiant sera celle mémorisée au moment de l'ajout. La prochaine valeur de l'identifiant calculée par le moteur HFSQL correspondra à la plus grande valeur de l'identifiant dans le fichier +1. Si les constantes hFixeIDAuto et hForceIDAuto sont utilisées en même temps, une erreur WLangage est générée. | hForceIDAuto | Mode de calcul de l'identifiant automatique : L'identifiant automatique n'est pas calculé lors de l'ajout. L'identifiant correspond :- soit à la valeur affectée à la rubrique par programmation (par exemple CLCLEUNIK = 7)
- soit à la valeur par défaut de l'identifiant spécifiée dans l'éditeur d'analyses (si le fichier de données vient d'être ouvert, sans lecture d'enregistrement)
- soit à la valeur de l'identifiant présent en mémoire (valeur de l'identifiant pour le dernier enregistrement lu dans le fichier de données).
Après l'ajout de l'enregistrement, le prochain identifiant automatique calculé par défaut par le moteur HFSQL sera calculé sans tenir compte de la valeur ajoutée par hForceIDAuto. Si les constantes hFixeIDAuto et hForceIDAuto sont utilisées en même temps, une erreur WLangage est générée. | hIgnoreDoublon | Mode de gestion des doublons : Ignore le contrôle des doublons pour cette opération, même si le contrôle automatique des doublons est branché (fonction <Source>.GèreDoublon). Si les constantes hIgnoreDoublon et hVérifieDoublon sont utilisées en même temps, une erreur WLangage est générée.
| hIgnoreIntégrité | Mode de gestion de l'intégrité : Ignore le contrôle d'intégrité sur cette opération d'ajout, même si le contrôle de l'intégrité automatique est branché (fonction <Variable Connexion>.GèreIntégrité). Si les constantes hIgnoreIntégrité et hVérifieIntégrité sont utilisées en même temps, une erreur WLangage est générée.
| hRecalculeIDAuto | Mode de calcul de l'identifiant automatique : L'identifiant automatique de l'enregistrement sera recalculé lors de l'écriture. Cette constante est prioritaire sur les constantes hForceIDAuto et hFixeIDAuto.
| hVérifieDoublon | Mode de gestion des doublons : Contrôle les doublons pour cette opération, même si le contrôle des doublons est débranché (fonction <Source>.GèreDoublon). Si les constantes hIgnoreDoublon et hVérifieDoublon sont utilisées en même temps, une erreur WLangage est générée.
| hVérifieIntégrité | Mode de gestion de l'intégrité : Contrôle l'intégrité de l'opération même si le contrôle de l'intégrité automatique est débranché (fonction <Variable Connexion>.GèreIntégrité). Si les constantes hIgnoreIntégrité et hVérifieIntégrité sont utilisées en même temps, une erreur WLangage est générée.
|
Classification Métier / UI : Code métier
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|