Application URL alias
The application URL alias allows application users to open multiple Pega applications in a single browser. The application URL alias appears after the servlet or the context root. The application alias is defined in the application definition. The application URL alias should abide by the following guidelines.
- Format
- Use only alpha numeric characters in the application URL alias. The application URL is case-sensitive, and it does not support unicode characters.
- Uniqueness
- The application URL alias defined in one application cannot be used by any other application. Multiple versions of the same application can use the same alias to provide continuity between versions.
- Compatibility
- Pega applications built prior to Pega 8.4 do not support the application URL alias. Therefore, the application identifier is used in URL component for compatibility reasons. These applications can still be launched using the application identifier until you define an alias in the application definition rule. The best practice is to define an application URL alias as soon as you start using Pega 8.4 or when designing your application.
- Alias changes
- Do not change an application URL alias after deploying your application. Email links and bookmarks use the alias and will break if the alias is changed. When an application URL is not defined, the application identifier is used to generate URLs. For existing applications when the application URL alias is not defined, the application identifier can be used to launch that application. For existing applications, when the application URL alias is defined, URLs using both the application identifier and the application alias will launch the desired application but without a redirect to to the application alias, provided that application identifier is not used by another application.
- Character requirements
- The application identifier can include periods and underscore characters. The application URL alias does not support these characters and they will be removed. The application identifier is truncated to eight characters. The application URL alias is also limited to eight characters. The application identifier is generated from the application name and the first letter is capitalized.
- Multiple access groups in one application
- When an operator has multiple access groups for the same application, the access group listed first in the operator definition is used to launch the session.
- Validation during import
- Designer Studio only validates uniqueness during development. If you import an application from a different environment, there is no validation.