When you define report formats for use with NetLink or SouthWare WebView you may assign a HyperLink ID to a field. The HyperLink ID refers to a record that defines how to turn this field into an HTML hyperlink that will call a related page or program. You don’t have to insert the hyperlink text into your format because the text will be generated around the field when you run the report. There are several automatic default HyperLink IDs set up for certain fields - see the Automatic Default discussion below. The "smart" aspect of this feature uses the proper hyperlink tag depending on the type of output you are creating.
For example, when you output a customer number within an HTML report you may want to be able to click on the customer number and zoom to more details about the customer. If you use the "AR010001" HyperLink ID for the customer field in the report the system will automatically insert the HTML tags specified in the AR010001 HyperLink ID when you print the report. The link might zoom to a NetLink page or to a SouthWare program such as customer inquiry (AR-04).
The components of this feature include:
 |
The file of HyperLink ID records which define the tags to use (see RM-04-07) |
|
The ability to enter a HyperLink ID in the parameters for a ReportMate field |
HyperLink ID Records
(See RM-04-07 in the menu)
This program lets you define the hyperlink tags that will turn a ReportMate field into an HTML hyperlink. Several standard records are automatically set up the first time you use this program. You may then edit the tags in these records or add your own.
1. HyperLink ID:
Enter a unique ID (up to ten characters) for this Link format. Standard codes are defined for several of the standard Data Dictionary fields.
Automatic Default
You can define an automatic link default for a data dictionary field by creating a HyperLink ID of xxxxnnnn where xxxx is the file and nnnn is the field. When you insert a field in a ReportMate format the program checks this file for a record ID that matches the file/field of the inserted field. If it finds a matching record it will automatically insert the HyperLink ID for the field.
For example, the ID RS070007 will automatically default as the HyperLink ID when you use the field RS07 field 0007 on a report.
2. Description:
Enter a brief description of this tag that will help you identify it in search lists.
3. NetLink Start Tag:
Enter the starting HTML tag for the hyperlink that should be used when the ReportMate report is used by NetLink. This should be the complete starting tag including the URL being called and any data being sent.
Examples:
To call a NetLink request
<a href=@var_form_action_url_@?request_id=icustinfo&session_no=@var_session_no_@&cust_no=@var_DD_RS070007_@>
To call an object or program from SouthWare WebView
<a href=?@swobj=AR04&@cust_no=@var_DD_RS070007_@>
Data Dictionary Variables
The tag may include Data Dictionary variables that will be replaced with data when you run the report. Refer to the variable using the syntax:
@var_DD_xxxxnnnn_@
where xxxx is the Data Dictionary file and nnnn is the field number.
! Any fields you reference must be available from the primary file you use for your ReportMate report.
4. NetLink End Tag:
Enter the ending HTML tag for the hyperlink that should be used when the ReportMate report is used by NetLink. Normally this would just be </a> but the field allows up to 50 characters since you may have done some special font settings that you need to turn off.
5. WebView Start Tag:
Here you may enter an alternate tag if this link should be different when the report is viewed with SouthWare’s WebView. Typically this would be used when you want to call a SouthWare program for the zoom instead of calling another NetLink Web Page.
To reference a SouthWare program or object or reference number
Here is the link syntax to call a SouthWare function instead of a normal web URL:
<a href="http://?@swobj=xxxxx&datatosend">
where xxxxx is name of a SouthWare object, program, or menu reference and datatosend is any additional parameters such as link values to use.
For example, <a href="http://?@swobj=AR04&@cust_no=@var_dd_RS070007_@">
would call the program AR04 (customer inquiry) with a link value of the customer number in RS07 field 0007 (the customer on a sales order header).
Setting up link values
In a SouthWare WebView link you may dynamically change the link value used for a call by using one of the following data variables in the data sent:
|
@cust_no=value |
sets up customer link value |
|
@vend_no=value |
sets up vendor link value |
|
@stock_no=value |
sets up stock number link value |
|
@loc_no=value |
sets up location link value |
|
@service_no=value |
sets up service code link value |
|
@emp_no=value |
sets up employee number link value |
|
@sls_ord_no=value |
sets up sales order number link value |
|
@svc_ord_no=value |
sets up service order number link value |
|
@po_no=value |
sets up purchase order number link value |
|
@svc_ctr_no=value |
sets up service contract link value |
|
@job_no=value |
sets up job number link value |
|
@inv_no=value |
sets up invoice number link value |
6. WebView End Tag:
Here you may enter an alternate end tag if this link should be different when the report is viewed with SouthWare’s WebView.
7. Extract ID:
Here you may enter an Extract ID if this record is to be extracted with SouthWare’s Extract Packager as a part of a related set of records.
Entering a HyperLink ID in a ReportMate Format
In the field parameter options for a ReportMate field you may enter the HyperLink ID to be used. See the Automatic Default discussion above for an explanation of any automatic IDs that will default for fields. When you are outputting to NetLink data or HTML format the report will insert the appropriate tags as part of the output of the report.