Folders and Placeholders
folders
For a GeoDMS project folders (and subfolders) with the following content are relevant:
- installed software
- project-specific configuration, data and documentation files
- project-specific (intermediate) results and exports.
placeholders
In GeoDMS configurations placeholders with logical names like sourcedatadir and localdatadir are used for folders.
They make configurations clear and easily transferable to other locations/machines. It is advised to use these placeholders, although physical path names are also allowed.
All placeholders used in a storageName or as the second argument of the expand function, starting and ending with a % character will be expanded, e.g. storagename = “%SourceDataDir%/brondata.csv”.
The last column in the next table presents the expanded values for a project folder: C:/prj/nl_later.
| Placeholder | Description | Default Value | Expanded Value (example) |
|---|---|---|---|
| %currentDir% | The folder of the root configuration file that is opened by the GUI. For shipped configurations, this is usually the cfg subfolder of the projDir | C:/prj/nl_later\cfg | |
| %exeDir% | The folder in which the software is installed. | non-overridable | C:/Program Files/ObjectVision/GeoDMS |
| %programFiles32% | The folder that contains the (32-bit) programs, known as the value of %env:Program Files (x86)% or if that is empty (such as on 32-bit platforms): the value of %env:Program Files% (see %env:xxx% below). | non-overridable | c:/Program Files |
| %projDir% | The full name of the project-specific folder containing the (original) configuration, data and documentation folders. non-overridable | %currentDir%.. | C:/prj/nl_later |
| %projBase% | Parent of the projDir. non-overridable | %projDir%.. | C:/prj |
| %configDir% | The directory in which the config.ini and a set of configuration files are located. By default this is a subfolder of the projDir with as name the project name. | %currentDir%\%projName% | C:/prj/nl_later/cfg/nl_later |
| %dataDir% | The base folder containing the project-specific primary data files, often also organised in subfolders. | %sourceDataProjDir%\data | C:/prj/nl_later/data |
| %localdatadir% | The default base folder used for the project-specific localDataProjDirs. The local data folder is written to the Windows Registry (HKE_CURRENT_USER/Software/ObjectVision/DMS). | C:/LocalData | C:/LocalData |
| %LocalDataProjDir% | The folder used for the project-specific (intermediate) results and exports. Views are exported to this folder unless otherwise configured in an ExportSettings container of a view definition. | %localDataDir%/%projName% | C:/LocalData/nl_later |
| %sourcedatadir% | c:/SourceData | ||
| %sourceDataProjDir% | %sourceDataDir%/%projName% | ||
| %CalcCacheDir% | The folder used for the for project-specific (intermediate) results. | %localDataProjDir%/ CalcCache | C:/LocalData/nl_later/CalcCache |
| %DateTime% | Resolves %DateTime% placeholder to current time in local system time using the format: YYYY-m-D_H-M-S (available since GeoDMS 8.044) | non-overridable |
When a configuration is opened, the GeoDMS considers the folder that contains the root configuration file as currentDir. The physical paths for the other logical folders in the configuration are derived from this path but can be overruled by entries in the ConfigSettings container.
There are also other placeholders that refer to other parts of the execution environment and sometimes based on the context of usage:
| Placeholder | Description |
|---|---|
| %projName% | folder name of %projName% |
| %env:xxx% | is expanded to the value of the environment variable with the name xxx. |
| %storageBaseName% | is expanded to the base name of a storage (excluding the filename extension) |
| %geoDmsVersion% | |
| %osversion% | |
| %username% | |
| %computername% | |
| %XXX% | (for XXX not matching any of the above) if XXX is defined as parameter |