[CtEdit]CompileUnsuccessfulCommand
- Last UpdatedJul 19, 2023
- 2 minute read
Indicates to the compiler an optional command, script or batch file to execute after an unsuccessful compile. Generally this would be used to create a log file to show warnings or errors generated during a compile. To execute an optional application, script or batch file to execute after a successful compile use the parameter [CtEdit]CompileSuccessfulCommand.
Allowable Values:
Any valid command line containing replacement strings that represent possible information that the compiler can provide, including such information as project name, project path, INI path, bin path, etc. Enclose the replacement strings in ‘%’ characters, similar to DOS batch file notation. Use the escape character "^" if you want to include the ‘%’ character literally.
If an undefined replacement string is specified in the command line a compiler warning will be generated, and the application will not be called. Compiler warnings will also be generated if the compiler does not execute the command line successfully. However, any errors that occur when the command is executing will not be logged, as they will not be known to the compiler.
Allowable replacement strings
|
Replacement Strings |
Description |
|---|---|
|
CtEnvBinPath |
Path to the Bin folder of Plant SCADA |
|
CtEnvConfigPath |
Path to the config folder |
|
CtEnvDataPath |
Path to data folder |
|
CtEnvIncludeProjects |
List of include projects for the project being compiled |
|
CtEnvErrors |
Number of errors encountered during compile |
|
CtEnvIncludeProjectPaths |
List of the directory paths of the include projects for the project being compiled, in the same order as the projects are listed in CtEnvIncludeProjects |
|
CtEnvIniPath |
Path to the ini file |
|
CtEnvLogPath |
Path to log files |
|
CtEnvProject |
Name of the project that is being compiled |
|
CtEnvProjectPath |
Path to the project file that is being compiled |
Example:
This could be a notification - such as sending an email or network message to a person - or just a log entry to a text file as shown below:
-
Create a text file with the following content:
Echo %Date% %Time% '%CtEnvProject%' Compilation unsuccessful, [%1] >> "%CtEnvLogPath%\Log.txt"
-
Save the file as a command / batch file, example 'MyError.cmd'
-
Set the INI parameter to run the above file, including the path to where the file was saved. Pass the list of include projects as the first parameter to the command file.
CompileUnsuccessfulCommand=C:\Temp\MyError.cmd "%CtEnvIncludeProjects%"
A Log.txt file will be created and updated each time a project compile is unsuccessful.
The replacement strings can be used directly in the INI parameter value and can be accessed as application environment variables. The example demonstrates this method.