ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

New WINDEV, WEBDEV and WINDEV Mobile 2025 feature!
This content has been translated automatically.  Click here  to view the French version.
Help / WLanguage / Managing databases / HFSQL / Managing replications / WLanguage functions
WINDEV
WindowsLinuxJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac Catalyst
Others
Stored procedures
Adds a data file to a universal replication.
Warning The corresponding physical file must exist on the subscriber workstation.
Example
HRplAddFile("P:\MSG\MSG.RPM", "Paris", "NewAddFile")
Syntax
<Result> = HRplAddFile(<Master replica directory> , <Identifier> , <List of tables to replicate>)
<Result>: Boolean
  • True if the data file(s) have been added to the replication,
  • False otherwise.
<Master replica directory>: Character string
Directory where the master replica description file ("rpm" file) was created (HCreateMasterReplica). This directory can be a network directory or a UNC path.
If this parameter corresponds to an empty string (""), the description file will be searched for in the current directory of HFSQL data files (defined in the data model editor or through programming).
Warning: This directory must be accessible when HRplAddFileis executed.
<Identifier>: Integer or character string
Subscriber replica identifier. This identifier was returned by HCreateSubscriberReplica. This identifier will be used by HCreateMovableReplica.
<List of tables to replicate>: Character string
This list has the following format:
<TableName>[+TAB+<NameDateItem>]
[+<CR>+<TableName>[+TAB+<NameDateItem>]]...
Caution: Table order is important. The order of the tables is the order of the dependencies for the tables.
If the records of file 1 are linked to the records of file 2 and if the record must be found in file 2 in order for the addition in file 1 to comply with the integrity rules, then file 1 must be positioned first in the list.
For example, for the "Customer", "Orders" and "Order line" files (that are linked by links whose cardinalities are (0,n) - (1,1)), the "Customer" file must be positioned first (a customer must exist to add an order), then the "Orders" file (an order must exist to add an order line) and finally the "Order line" file.
The name of Date item is mandatory for the databases not in HFSQL format. This item must correspond to an item of the data file updated during an addition or during a modification. This operation must be performed by the application.
Business / UI classification: Business Logic
Component: wd300rpl.dll
Minimum version required
  • Version 2025
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 01/31/2025

Send a report | Local help