6.2.5 deleteAll method
This method deletes all suspend information associated with the Operational Content in Suspend/Resume Plugins. This method deletes all suspend information associated with the Operational Content ID specified by the parameter.
If a user who creates Operational Content edits or deletes Operational Content, the user invokes this method to delete all the associated suspend information. If Operational Content is edited or deleted, the saved suspend information is disabled. Therefore, delete all suspend information associated with the Operational Content.
If this method throws the UCNPPluginException exception, Navigation Platform displays the message for the UCNPPluginException exception in the dialog box. A message ID is not appended to the message displayed in the dialog box.
Processing of this method must be implemented in the suspend/resume action controller class created by using the template plugin creation command.
- Organization of this subsection
(1) Format
public void deleteAll(String contentId, HttpSession session) throws UCNPPluginException;
(2) Arguments
(a) contentId
This argument indicates the Operational Content ID.
(b) session
This argument stores the current session. If this method is executed during publishing start processing of Operational Content in the publishing reservation status, the value is null. To execute the setAttribute() method for the HttpSession object acquired in a plugin, do not specify any of the following names for the name argument of the setAttribute() method:
-
Name beginning with "ucnp"
-
Name beginning with "java."
-
Name beginning with "javax."
-
Name beginning with "javax.portlet."
-
Name beginning with "hptl"
-
Name beginning with "com.cosminexus"
-
Name beginning with "jp.co.hitachi.soft.portal"
You can also acquire and use the URL request parameter. To use this parameter, you must acquire the ucnpOptions parameter by using the following key:
- ucnp.request.options key
-
This key is used to acquire the value of the ucnpOptions parameter specified for the URL from the session. By specifying this key in the HttpSession.getAttribute() method, you can acquire the URL decoded value of the ucnpOptions parameter. If the ucnpOptions parameter is not specified for the URL, null is returned.
For details about a specification example of the ucnp.request.options key, see the specification example of the inputFromNode method in 5.2 IIoPluginController (server processing implementation interface).
(3) Return values
None
(4) Exception
UCNPPluginException - An error occurred while, for example, suspend information was being deleted.
Navigation Platform displays the detailed message for the UCNPPluginException exception thrown by this method in the dialog box in the Operational Content Execution Window. For the UCNPPluginException exception to be thrown, set the message that helps users understand what kind of error occurred and what action to take. If the error message output by the Suspend/Resume Plugin contains many linefeeds, part of the message dialog box might not be displayed in the window because a JavaScript Alert is used to display the error message. Therefore, make sure that the error message size does not exceed the limit that can be displayed in the window.
(5) Invocation timing
The following table describes when Navigation Platform invokes this method and the suspend information to be deleted.
Invoked when: |
Suspend information to be deleted |
---|---|
The contents of Operational Content displayed in the Operational Content Execution Window change by operation on the Web browser. |
All suspend information associated with the target Operational Content |
A user who creates Operational Content deletes Operational Content in the Operational Content Editing Window. |
All suspend information associated with the deleted Operational Content |