1.6.2 Parameters specifiable in basic URLs
This subsection describes the types of parameters you can specify in basic URLs, and the format to use when specifying these parameters.
- Organization of this subsection
(1) Format of parameters specifiable in basic URLs
- Use the following format when specifying parameters in basic URLs:
-
basic-URL?parameter-name-1=parameter-value[[¶meter-name-2=parameter-value]...]
Separate the basic URL and the first parameter with a question mark (?), and separate each subsequent parameter with an ampersand (&). You can specify multiple parameters by connecting them with ampersands (&) in this way.
By adding parameters to the end of the basic URL, you can control which window appears when a user logs in to Navigation Platform. You can also use parameters to integrate plugins and custom windows.
In the following circumstances, because the basic URL already contains parameters, specify an ampersand (&) instead of a question mark (?) as the character that connects the basic URL to its parameters:
-
When accessing the Operational Content Editing Window
-
When accessing a custom window
-
When performing single sign-on using the Cosminexus integrated user management framework
(2) List of parameters specifiable in basic URLs
The table below lists the parameters you can specify in a basic URL. The types of parameter you can specify depends on the window you are accessing.
Parameter name |
Parameter value |
Description |
Whether parameter can be used |
||
---|---|---|---|---|---|
Operational Content Execution Window |
Operational Content Editing Window |
Custom window (new window) |
|||
contentId |
Operational Content ID |
Directly opens the Operational Content associated with the specified ID. Whether the Operational Content opens as editable or read-only depends on the status of the specified Operational Content. Operational Content IDs are case sensitive. You can acquire Operational Content IDs by using a menu command in the Operational Content Editing Window. If the Get URL menu appears in the Operational Content Execution Window, you can acquire a URL with the Operational Content ID already specified in the contentId parameter. |
Y |
Y |
N |
open_editor |
true |
Directly opens the Operational Content Editing Window after login. If you omit this parameter, the Operational Content Execution Window appears after login. The user can then switch to the Operational Content Editing Window by clicking the Editing Window View menu command. |
N |
Y |
N |
start_editor |
true |
Displays the Editing Window View and Execution Window View menu commands. When this parameter is specified, the user can switch between the Operational Content Execution Window and the Operational Content Editing Window. You cannot use this parameter in the execution environment. |
Y |
Y |
N |
ucnpCloseBtn |
close_only |
Specifies the behavior of the button used to exit Navigation Platform windows. If you specify close_only, a Close button is displayed that closes the window without logging you out. |
Y |
Y |
N |
logout_close |
Specifies the behavior of the button used to exit Navigation Platform windows. If you specify logout_close, a Close button is displayed that logs you out before closing the window. |
Y |
Y |
N |
|
logout |
Specifies the behavior of the button used to exit Navigation Platform windows. If you specify logout, a Logout button is displayed that logs you out and returns you to the login window. |
Y |
Y |
N |
|
ucnpOptions |
Values used by a User Plugin (I/O Plugin or Suspend/Resume Plugin) |
This parameter provides values to be used by plugins. If you need to use a character in a parameter value that cannot be used in a URI, specify the value as a URL-encoded string. You can find out the values a plugin uses by contacting the user who developed the plugin. For details about how the values of this parameter are used in a plugin, see the Hitachi Navigation Platform Development Guide. The following describes the characters you can specify in a value of this parameter, and the maximum length of the value:
|
Y |
N |
N |
ucnpUserData |
Values used by a custom window (new window) |
This parameter provides values for use by custom windows (new windows). You can find out the values used by the new window by contacting the user who developed the window. For details about how the values of this parameter are used in the new window, see the Hitachi Navigation Platform Development Guide. |
N |
N |
Y |
ucnpUserPageId |
Name of Custom Window Plugin |
Displays a custom window (new window) after login. |
N |
N |
Y |
- Legend:
-
Y: Can be used.
N: Cannot be used.