Placeholders are primarily used for generic notes.ini variables (e.g. MC_DB=%notes_homeserver%!!panagenda\panagenda.nsf) and for a handful of special Actions in the Configuration database (e.g. Backup, Roaming, and Location and Connection Actions).
Placeholders are replaced when reading a corresponding notes.ini entry, respectively DURING THE EXECUTION of an Action.
NOTE that if resolving a placeholder fails, the respective Action is still executed.
Placeholders in notes.ini
explanation
Placeholder | Corresponding reference namespace/setting | |
|---|---|---|
| %notes_data% | notes:data_directory | Full path of HCL Notes data directory |
| %notes_shareddata% | notes:shareddata_directory | Shared data directory |
| %notes_client% | notes:client_directory | Full path of HCL Notes client directory |
| %os_system_root% | os:system_root | Operating system binaries directory (e.g. C:\Windows or /Applications) |
| %os_system% | os:system | The operating system folder |
| %os_program_files% | os:program_files | Operating system program files directory |
| %os_app_data% | os:app_data | Operating System Application Data Directory |
| %os_common_app_data% | os:common_app_data | Common application data directory |
| %os_local_app_data% | os:local_app_data | The users application data directory |
| %os_user_profile% | os:user_profile | Operating system user profile directory |
| %os_temp% | os:temp | The users temp directory |
| %env_*% | env:* | Replaced with the value of an operating system environment variable; available variables names and values depend on the respective target user's operating system environment. |
| %registry_*% | registry:* | For example %registry_HKEY_CURRENT_USER\Software\panagenda\subkey% will resolve the value of "subkey" in the key "HKEY_CURRENT_USER\Software\panagenda" |
Placeholders for the Backup & Roaming key
explanation
Placeholder | Corresponding reference namespace/setting | |
|---|---|---|
| %notes_user% %notes_user_abbreviated% %notes_user_common_name% | notes:user notes:user_abbreviated notes:user_common_name | In filesystem backup actions this often defines the folder name. To guarantee valid filesystem paths spaces are replaced with underscores, slashes with a exclamation marks |
| %notes_version% | notes:version | e.g. 11.0.1 |
| %notes_version_major% | notes:version_major | |
| %os_user% | os:user | Operating system user |
| %os_computer% | os:computer | Name of host machine; replaced with "Citrix" if os:citrix=1 (also applies to other terminal server types) |
| %os_computer_org% | os:computer_org | Name of host machine (Citrix server name on Citrix and alike) |
| %os_device_type% | os:device_type | the type of the computer, e.g. IPad Air 2 |
%os_user_hash% | Salted MD5 hash of os:user/os:computer/os:computer_org. Used in Application Usage action to anonymize data | |
%ini_custom_placeholder% | %ini_custom_placeholder% - gets replaced by contents of ini variable MC_custom_placeholder. This variable itself may contain placeholders. %mc_custom_placeholder% - gets replaced by contents of config variable mc:custom_placeholder. Subject to be used when so instructed by support | |
| %date_format_*% | %DATE_FORMAT_*%. Y=Year (4 digits), M=Month (1..12), W=Week (00..53), D=Day (01..31). replaced string also contains format prefix to avoid overlaps. example: %DATE_FORMAT_YW% = Y2017W37 |
Examples for Placeholders | |
|---|---|
| %notes_homeserver% | Used to generically point each user to her/his respective mail server for the MarvelClient Configuration database in notes.ini, e.g. MC_DB=%notes_homeserver%!!panagenda\panagenda.nsf |
| %LOOKUP_MAILFILE% | Used to lookup a user's mailfile path in the public adressbook |
Topics
- References - Namespaces
- References - Syntax
- References in References
- Special References to Desktop Icon Actions