Insert hyperlink

REQ-190

Actors

Name

In addition to internal and external hyperlinks, you have a third option when editing a virtual page template, it is called Data and is available as a third card in the Insert hyperlink panel when editing virtual page templates.

Usually, a data hyperlink will be inserted into a column element TD of a table. In this case, the parent row element TR must be associated to a node, either a descendant of the primary or a secondary or external node type.

The dialog shows

  • Node type. This simply displays the node type of the parent element. You can change the node type, but you should rather do this using the context menu.
  • Template page. Only enter this, if you want a specific virtual page template be used for this node type. In most cases, you should omitt this. In that case, the template for the node type found in /jcr:system/nodes/templateInstances will be used.
  • Name property. You can select a property that shall be used as the text of the hyperlink from the properties of the node type.
  • Reference. Here you must specify, which type of relationship the node has to the primary node type, i.e. the base node type of the virtual page template.
    • -> this. This means, the target node of the hyperlink will reference the primary node.
    • this ->. In this case, the primary node references the hyperlink target node.
    • Subnode. There is no relationship by reference, the hyperlink target node is a descendant node of the primary node.
    • Select node. This does only make sense, if there is a relationship by reference.

      If selected, the virtual page editor will let the user select an existing node.

      If not selected, the user can enter the properties of the node into the table rows columns and the node will be created, if it does not yet exist. Note, that this option is one reason you have to specify a path for secondary queries in the Data binding view. If the system must create a new node, it must know where to do this.