4D v14.3
SET UPDATE FOLDER
- 4D Language Reference
-
- 4D Environment
-
- Application file
- Application type
- Application versionUpd
- BUILD APPLICATION
- CHECK MEMORY LEAKS
- Compact data file
- COMPONENT LIST
- CREATE DATA FILE
- Data file
- FLUSH BUFFERS
- Get 4D folder
- Get database localization
- Get database parameter
- Get last update log pathNew
- Get memory leaks
- GET MEMORY STATISTICSUpd
- GET SERIAL INFORMATION
- Get table fragmentation
- Is compiled mode
- Is data file locked
- NOTIFY RESOURCES FOLDER MODIFICATION
- OPEN ADMINISTRATION WINDOW
- OPEN DATA FILE
- OPEN SECURITY CENTER
- OPEN SETTINGS WINDOW
- PLUGIN LIST
- QUIT 4D
- RESTART 4DNew
- SET DATABASE LOCALIZATION
- SET DATABASE PARAMETERUpd
- SET UPDATE FOLDERNew
- Structure file
- VERIFY CURRENT DATA FILE
- VERIFY DATA FILE
- Version typeUpd
- ADD DATA SEGMENT
- DATA SEGMENT LIST
SET UPDATE FOLDER
| SET UPDATE FOLDER ( folderPath {; silentErrors} ) | ||||||||
| Parameter | Type | Description | ||||||
| folderPath | String |
|
Pathname of folder (package under OS X) containing updated application | |||||
| silentErrors | Boolean |
|
False (default) = report errors visibly, True = do not report them | |||||
The SET UPDATE FOLDER command specifies the folder containing the update of the current merged 4D application. This information is stored in the 4D session until the RESTART 4D method is called. If the application is exited manually, this information is not kept.
This command is intended to be used in an automatic update process for a merged application (server or single-user). For more information, refer to the Finalizing and deploying final applications section in the Design Reference manual.
Note: This command only works with 4D Server or a single-user application merged with 4D Volume Desktop.
In the folderPath parameter, pass the complete pathname for the folder of the new version of the merged application (folder containing the my4DApp.exe application under Windows or the my4DApp.app package under OS X), created by the 4D application builder.
Note: We recommend that you use the same names for the files in the new version of the application as the ones in the original, since the application folder is replaced during the update. If you use different names for these files, any stored shortcuts and/or paths will no longer work.
If the parameters are valid, the update is placed "on hold" in the session until the RESTART 4D command is called. If you executed SET UPDATE FOLDER several times before calling RESTART 4D, the last valid call is taken into account.
In case of anomaly, an error is generated; the silentErrors parameter determines whether or not these errors are displayed (see below).
You can pass an empty string ("") in the folderPath parameter to reset the update information for the current session.
The optional silentErrors parameter specifies how errors are reported during the update:
- When you pass False or when this parameter is omitted, errors are recorded in the update journal and displayed in a warning dialog box.
- If you pass True, errors are simply recorded in the update journal.
Exception: if the journal file cannot be created, a warning dialog box is displayed, regardless of the value of the silentErrors parameter. For more information, refer to the description of the Get last update log path command.
If the command is executed correctly, the OK system variable is set to 1; otherwise, it is set to 0. You can intercept any errors generated by the command using a method installed using the ON ERR CALL command.
You created a "MyUpdates" folder on your disk, where you placed a new version of the "MyApp" application. You do not want to display errors. To prepare the update, you write:
// Windows syntax
SET UPDATE FOLDER("C:\\MyUpdates"+Folder separator+"MyApp";True)
// OS X syntax
SET UPDATE FOLDER("MacHD:MyUpdates"+Folder separator+"MyApp.app";True)
Product: 4D
Theme: 4D Environment
Number:
1291
Created: 4D v14
Get last update log path
RESTART 4D
4D Language Reference ( 4D v14 R2)
4D Language Reference ( 4D v14 R3)
4D Language Reference ( 4D v14.3)
4D Language Reference ( 4D v14 R4)
