Insert Link dialog

The dialog appears when you select a specified object in the design area, right-click it and select Link from the shortcut menu, or click the chooser button in the value cell of the Link property or Detail Report property in Report Inspector. It helps you to link the object to a report, a detail report, a website or an e-mail address as required.

Link Type

Specifies the type of the link target. It can be one of the following:

• Link to Report
• Master/Detail Report
• Link to URL
• Link to E-mail

Advanced

Displays the advanced settings. Available only for Link to Report and Master/Detail Report link types.

OK

Accepts the linking result and closes the dialog.

Cancel

Cancels the linking process and exits the dialog.

Help

Displays this help document.

Link to Report

It helps you to link the object to a report. See the dialog.

Report

Specifies the report in which the linked report tab is. Click the Browse button to select the desired report in the Select a Report dialog.

Report Tab

Specifies the linked report tab.

Target

Specifies the window or frame in which to load the linked report.

• <Server Setting>
  Loads the linked report according to setting of the Pop Up New Window for Links option in the Profile > Configure Profile > DHTML > Properties > Default tab on JReport Server.
• Same Frame
  Loads the linked report into the same frame as the primary report.
• Whole Window
  Loads the linked report into the full browser window.
• New Window
  Loads the linked report into a new window. This window is not named.
• Parent Frame
  Loads the linked report into the parent frame of the frame in which the primary report is.
• Other Frame
  Loads the linked report into some other specified frame. If the frame name does not exist, the linked report will be loaded into a new window.

Conditions tab

Specifies the link conditions between the primary report and the linked report.

• Components
  Specifies the components in the linked report that will be interlinked with the primary report.
  • 
    Adds a component in the linked report to be interlinked with the primary report.
  • 
    Edits the component in the linked report to be interlinked with the primary report.
  • 
    Removes the selected component from the Component in Report Tab box.
• Default Linked Component
  Specifies the default linked component in the linked report.
• Field Conditions
  Lists all the fields that are used in the link conditions between the primary report and the linked report.
  • Fields(Primary)
    Lists the selected fields of the primary report.
  • OP
    Specifies the operator to set up links between the primary report and linked report.
  • Fields(LinkedReport)
    Lists the DBFields in the datasets of the linked report which are of the same data type as the selected fields in the primary report.
  • 
    Adds a new field condition line to set up link between the primary report and the linked report.
  • 
    Removes the selected field condition.

Parameters tab

This tab is available when the linked report uses parameters. It helps you to assign values to the parameters of the linked report automatically.

• Parameters
  Lists all parameters contained in the datasets of the linked report.
• Value
  Lists all the DBFields, formulas, summaries and parameters in the datasets of the primary report which are of the same data type as the parameters of the linked report. Select the field the value of which you want to assign to parameter of the linked report from the drop-down list.

Pass style group information down to linked report

Specifies whether or not to apply the style group of the primary report to the linked report.

Master/Detail Report

It helps you to link a object to a detail report. See the dialog.

Report

Specifies the report in which the detail report tab is. Click the Browse button to select the desired report in the Select a Report dialog.

Report Tab

Specifies the target detail report tab.

Component

Specifies the component in the detail report tab that will be interlinked with the master report. Click to add the components. You can add more than one component as long as the components are based on the same dataset.

Target

Specifies the window or frame where to load the detail report.

• <Server Setting>
  Loads the detail report according to setting of the Pop up New Window for Links option in the Profile > Configure Profile > DHTML > Properties > Default tab on JReport Server.
• Same Frame
  Loads the detail report into the same frame as the master report.
• Whole Window
  Loads the detail report into the full browser window.
• New Window
  Loads the detail report into a new window, which is not named. If this is selected, the detail report will be opened independently when you click the trigger in JReport Viewer, that is to say the join and filter conditions you set between the master report and detail report will not be applied.
• Parent Frame
  Loads the detail report into the parent frame of the frame in which the master report is.
• Other Frame
  Loads the detail report into some other specified frame. If the frame name does not exist, the detail report will be loaded into a new window.

Anchor

Specifies the relationships between the master report and the detail report.

• Column in Detail
  Specifies the field in the detail report which will be used to link the detail report with the master.
• Op
  Specifies the operator.
• Column in Master
  Specifies the field in the master report.

Conditions tab

Specifies the conditions between the master report and the detail report.

• Field Conditions
  Lists all the fields that are used in the filter condition between the master report and the detail report.
  • Fields(MasterReport)
    Lists the selected fields of the master report.
  • OP
    Specifies the operator to set up conditions between the master report and detail report.
  • Fields(DetailReport)
    Lists the DBFields in the datasets of the detail report which are of the same data type as the selected fields in the master report.
  • More
    Specifies relations between two conditions. Can be AND or OR.

Parameters tab

This tab is only available when there is at least one parameter applied in the filters of the queries that the detail report uses. It helps you to assign values to the parameters of the detail report automatically.

• Parameters (Detail Report)
  Lists all parameters contained in the datasets of the detail report.
• Column (Master Report)
  Lists all the DBFields, formulas and summaries in the datasets of the master report which are of the same data type as the parameters of the detail report. Select the field the value of which you want to assign to parameter of the detail report from the drop-down list.

Use the same encoding and DB setting for the detail report as that of the master report

Specifies whether the detail report uses the same encoding and DB settings as per the master report.

Link to URL

It helps you to link the object to a location specified by a URL. See the dialog.

Hyperlink

Specifies the URL for the hyperlink that is linked to the object.

For page reports, you can create a formula to represent a URL to set the hyperlink. Give the formula a name and specify a URL as the content of the formula.

Target

Specifies the window or frame in which to load the location specified by the URL.

• <Server Setting>
  Loads the linked file according to setting of the Pop Up New Window for Links option in the Profile > Configure Profile > DHTML > Properties > Default tab on JReport Server.
• Same Frame
  Loads the linked file into the same frame as the link.
• Whole Window
  Loads the linked file into the full browser window.
• New Window
  Loads the linked file into a new window. This window is not named.
• Parent Frame
  Loads the linked file into the parent frame of the frame that contains the link.
• Other Frame
  Loads the linked file into some other specified frame. If the frame name does not exist, the linked file will be loaded into a new window.

Link to E-mail

It helps you to link the object to an e-mail address. See the dialog.

Hyperlink

Specifies the mail address that the object will be linked to.

For page reports, you can use the text boxes and drop-down list to compose e-mail address. For example, a field "Company" contains company names, you can input person name in the first text box, select "Company" from the drop-down list, and input ".com" in the second text box. With this, you can click the label at runtime so as to write an e-mail to the corresponding recipient. You can also type "person@company.com" into the first text box and leave the drop-down list and the second text box empty, and thus clicking the label (or any field value) will write an e-mail to the specific address.

For web reports or library components, enter the e-mail address in the text box directly.

Related topic:

• Binding a link to a label