HErrorStatusModification (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

This content has been translated automatically. Click here to view the French version.

Help / WLanguage / Managing databases / HFSQL / HFSQL functions

Modification conflict and status of the record

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

HErrorStatusModification (Function)

In french: HErreurEtatModification

Not available with this kind of connection

Returns the status of a record during a modification conflict.

This function must be used only when a modification conflict is not automatically managed (in a procedure or window called to process the modification conflict (HOnError)). HOnError is not available when using stored procedures.

Example

// Code d'une procédure appelée pour le traitement d'un conflit de modification
NomFichier is string = HErrorInfo(hErrFile)
// Affiche l'état de l'enregistrement original
Trace(HErrorStatusModification(NomFichier, hRecRead))
// Affiche l'état de la rubrique de l'enregistrement du fichier
Trace(HErrorStatusModification(NomFichier, hRecFile))
// Affiche l'état de la rubrique de l'enregistrement utilisateur
Trace(HErrorStatusModification(NomFichier, hRecUser))

Syntax

<Result> = HErrorStatusModification(<Data file> , <Record to process>)

<Result>: Integer constant

Displays the status of the record.
hStateActive The record is active
hStateCrossed The record is crossed
hStateDel The record is deleted
hStateInvalid Record status not found (error)

<Data file>: Character string

Name of the data file used.

<Record to process>: Integer constant.

Used to specify the record in which the value of the item must be read.
hRecFile Status of the record in the data file.
hRecRead Status of the source record (read before running HModify).
hRecUser Status of the current record during the call to HModify.

Remarks

Modification conflict and status of the record

When using an application in network, conflicts may occur because of conflicting data entered by the different users. For example:

1. The user X edits the form for the "California" state.

2. The user Y edits the form for the "California" state.

3. The user X renames the state to "California_01".

4. The user Y modifies the name of the state and saves it. A modification conflict occurs during this backup.

A conflict of modification status occurs when the form is deleted by the user X for example.

The different cases are presented in the table below:


Record read	Addition	Crossed	Deleted
Record on disk	Addition	Crossed	Deleted
Addition	Modification conflict	Modification conflict	Modification conflict
Crossed	Modification status conflict	Modification conflict	Modification conflict
Deleted	Modification status conflict	Modification status conflict	XXXX

For more details, see HFSQL error handling help.

Component: wd300hf.dll