Version 21 introduces an updated URL schema that is more straightforward and consistent. The overall structure takes the form
The most notable improvement is a simplification to the format of the base URL. Unlike with earlier versions, with v21 it is no longer necessary to specify the system name and client number using a hash link like #AE_PROD:0500. Instead, the system and client now form part of the base URL, just after the host name and awi. In AWI v21, the base URL takes the form
The rest of the AWI URL is separated from the base URL by a single at character (@). The portion of the URL after the at symbol indicates the AWI perspective.
Each AWI Perspective has its own path
The portion of the path immediately after the perspective determines the view within that perspective.
URL parameters are separated from the main body of the URL by a single question mark character (?). When multiple parameters are specified, subsequent parameters are separated from each other by a single ampersand character (&).
The valid parameters depend on the perspective and view — e.g., the folder parameter of the explorer view in the table above.
The AE documentation page Structure of the URLs describes additional parameters.
When viewing or editing an object in the Process Assembly perspective, the navigation parameter specifies the particular properties sheet to display. Sheets are the tabs and sub-tabs of the object viewer/editor.
There are many different sheets; the available sheets depend on the object type.
Login parameters let you provide some or all of the details required to log in to the AWI if you are not already logged in.
For single sign-on to work in a fully automated way, the parameters department, logintype, and autologin must be specified.
There is also a name parameter, applicable only with logintype=AE, ; this can be used in conjunction with the password parameter if parameter_login.with_password=true is set in configuration.properties. This undocumented property is disabled by default. It is not recommended to save passwords in URLs.
If single sign-on and parameterized login are enabled, one can use carefully constructed URLs that will log the user in to the AWI automatically and navigate to a particular object, task, or view.
By combining parameters, you can also create deep links almost any location within the AWI. This makes it easy to save bookmarks and share links with colleagues. Here's an example from our wiki page. We added AWI icons to improve readability.
This discussion is based on the earlier document AWI v12.3 URLs.