HRplFilterProcedure (Function)

ONLINE HELP
WINDEV, WEBDEV AND WINDEV MOBILE

Version:

Home | Sign in | English

Help / WLanguage / Managing databases / HFSQL / Managing replications / WLanguage functions

WINDEV

WEBDEV

WINDEV Mobile

Others

See also

HRplFilterProcedure (Function)

In french: hRPlProcédureFiltre

Not available with these kinds of connection

Defines the WLanguage procedure that will be called whenever a replication operation is performed on a specific data file. This procedure is run by HCreateMovableReplica and HSynchronizeReplica.

Remark: This function can be used during the universal replication only.

Example

// The procedure validates the messages. 
// MessageValidation will be called for each replicated message
HRplFilterProcedure(Messages, "MessageValidation")
// Prepare to send messages to Paris (from MPL)
HCreateMovableReplica("P:\MSG\MSG.RPM", "Paris", "C:\Temp\MsgMPL.zip")

Syntax

<Result> = HRplFilterProcedure(<File name> , <Procedure name>)

<Result>: Boolean

True if the operation was performed,
False if a problem occurred (the specified tables and items do not exist for example). HError is used to identify the error.
Caution: <Result> is set to True even if the specified files/tables are not replicated.

<File name>: Character string

Name of the data file or table on which the procedure must be run.

<Procedure name>: Character string corresponding to a WLanguage procedure

Name of a WLanguage procedure found in the WINDEV application or in the WEBDEV website. This procedure must be created in your application. This procedure expects no parameter. This procedure is called before each operation performed on the destination file. Several variables can be used in this procedure. If this procedure returns False, the operation is not performed. This procedure is used to:
filter the records that must not be replicated.
manage the conflicts, by adjusting the values before a duplicate error occurs.

Component: wd300rpl.dll