Executing ExtraView Functions

From within an ExtraView screen, you may want to add a new issue or edit an existing issue. This is typically driven by the “Display as URL” data dictionary function. This places a button on a form beside the field described in the data dictionary when you are on the add or edit screens. The “Display as URL” function can be used to open URL’s both external to ExtraView and internal to ExtraView.

The reasons for doing this are various and typically related to integrating ExtraView with other enterprise applications.
It is possible to execute many different URLs within ExtraView with this technique, but some may have unpredictable results, according to the context of the request you are making. This documentation does not attempt to offer an exhaustive list of supported functions, but lists the most useful functions. Please contact ExtraView support if your requirement goes beyond this list and you have problems getting the desired functionality.

Adding an Issue

Syntax

http://www.myserver.com/evj/ExtraView/evSignon
?p_action=doAddDisplay
&p_option=Display
&p_close_win=true
&ev_menu=off
&p_ddname_1=value
... ...
&p_ddname_n=value

Notes

Use the name of your server installation in place of http:www.myserver.com/evj/ExtraView

If the optional parameter p_close_win has a value of true, then the add window will be closed when the issue is successfully updated by the user. If you set p_close_win to true, it is recommended that you also set ev_menu to off.

The optional parameter ev_menu=off will suppress the navigation bar within the new window that is opened to add the issue.

You may populate fields on the add screen that is generated, by using the convention p_ddname=value. Note that you should escape text fields containing special characters. For example, to add the title field to a new issue, you may use a parameter such as:

p_short_descr=This%20is%20the%20title%20of%20the%20issue

If the user is signed on when the command is issued, a new edit window will be opened immediately. If the user is not signed on, then the user is first taken to the sign on screen where they must sign on, before being allowed to edit the issue.

Editing an Issue

Syntax

http://www.myserver.com/evj/ExtraView/evSignon
?p_action=doEditDisplay
&p_option=Display
&p_id=nnnnn
&p_from_action=search
&p_from_option=search
&p_close_win=true
&ev_menu=off

Notes

Use the name of your server installation in place of http:www.myserver.com/evj/ExtraView

Replace nnnnn with the issue number you want to edit

If the optional parameter p_close_win has a value of true, then the edit window will be closed when the issue is successfully updated by the user.

The optional parameter ev_menu=off will suppress the navigation bar within the new window that is opened to edit the issue.

If the user is signed on when the command is issued, a new edit window will be opened immediately. If the user is not signed on, then the user is first taken to the sign on screen where they must sign on, before being allowed to edit the issue.

The Email Drilldown Link

This is a special case of a drilldown used by ExtraView, providing the drilldown from within the body of an email to ExtraView. It is provided here for completeness, as it can often be used for other purposes.

Syntax

http://www.myserver.com/evj/ExtraView/evSignon
?p_action=doEditDisplayEmail
&p_option=Display
&p_id=nnnnn
&p_from_action=email
&p_from_option=email
&p_close_win=true
&ev_menu=off

Notes

Use the name of your server installation in place of http:www.myserver.com/evj/ExtraView.

Replace nnnnn with the issue number you want to edit.

If the optional parameter p_close_win has a value of true, then the edit window will be closed when the issue is successfully updated by the user.

The optional parameter ev_menu=off will suppress the navigation bar within the new window that is opened to edit the issue.

If the user is signed on when the command is issued, a new edit window will be opened immediately. If the user is not signed on, then the user is first taken to the sign on screen where they must sign on, before being allowed to edit the issue.

Running a Detailed Report

This function will allow you to send a URL to ExtraView, and immediately run a detailed report for an issue. If you are not signed on as a user, ExtraView will take you first to the sign on screen to authenticate your user details. You must know the id of the issue you want to display to be able to use this function.

Syntax

http://www.myserver.com/evj/ExtraView/evSignon
?p_option=search.SearchReportDetailDisplay
&p_action=doRunDetailed
&id=nnnnn

Running a Column Report

This function will allow you to send a URL to ExtraView, and immediately run an existing saved column report. If you are not signed on as a user, ExtraView will take you first to the sign on screen to authenticate your user details. You must know the report_id of the report you want to run to be able to use this function. You will need to execute the API command get_reports, to see the report_id for the report you want to run.

Syntax

http://www.myserver.com/evj/ExtraView/evSignon
?p_option=search.SearchReportDisplay
&p_action=doRunReport
&report_id=nn

Pop-up List of User Details

The purpose of this local function is to allow the administrator to program a user list or user pop-up field with the ability to pop-up a new child window, with the complete details of the user whose name is selected in the user list.

An example of how to use this function is to provide a pop-up window for the ORIGINATOR of issues within ExtraView. To achieve this, set the following text (on a single line) into the data dictionary URL field for the ORIGINATOR field:

?p_option=admin.UserAccountsDisplay
&p_action=showUserDetails&
p_user_id=$$NAME$$

Now select Yes as the value for the field Display as URL.

Update the field in the data dictionary.

A link button will now appear by the ORIGINATOR field on both the add and edit screens as shown here.

When you press the link button, a window will pop up that shows the user’s details, similar to the following.