Package com.orchestranetworks.ui

Interface UILabelRendererForHierarchyContext

All Superinterfaces:
UIBodyWriter, UILabelRendererContext, UIResourceLocator
public interface UILabelRendererForHierarchyContext extends UILabelRendererContext, UIResourceLocator
Provides a context for displaying a hierarchy node.

Warning: if the node is a root node, the container parent node for orphan nodes, or an enumeration node, it does not correspond to a table record (that is, method getOccurrence() returns null).

See Also:

  • Method Details

    • getOccurrence

      Adaptation getOccurrence()
      Returns the current record being displayed.

      Warning: this method returns null if the current node is a root node, the container parent node for orphan nodes, or an enumeration node.

      Specified by:
      getOccurrence in interface UILabelRendererContext

    • getEnumerationValue

      Object getEnumerationValue()
      Returns the current enumeration value if this is an enumeration node. Otherwise, this method returns null.
      See Also:

    • getHierarchyNode

      HierarchyNode getHierarchyNode()
      Returns the current hierarchy node being displayed.

    • getLabelFromDefaultPattern

      String getLabelFromDefaultPattern()
      Returns the localized label, as specified by the current hierarchy configuration.

      If the configuration does not specify a label pattern, this method returns the localized label according to the default pattern.

      The default pattern is looked up on the elements <defaultLabel [xml:lang="..."]>, which are specified by the table definition.

      Specified by:
      getLabelFromDefaultPattern in interface UILabelRendererContext
      See Also:

    • isEnumerationNode

      boolean isEnumerationNode()
      Returns true if the current node is an enumeration node, false otherwise. An enumeration corresponds to an xs:enumeration element in the data model.

      In this case, the method getOccurrence() returns null.

      See Also:

    • isOrphansParent

      boolean isOrphansParent()
      Returns true if the current node is the container parent node of orphan nodes, false otherwise.

      In this case, the method getOccurrence() returns null.

    • isRoot

      boolean isRoot()
      Returns true if the current node is the root of the hierarchy, false otherwise.

      In this case, the method getOccurrence() returns null.

    • isTarget

      boolean isTarget()
      Returns true if the current record is a target table record, false otherwise.

      The target table is the table from which the hierarchy was built.

    • isTerminal

      boolean isTerminal()
      Returns true if the current record has no children in the hierarchy, false otherwise.

    • isDefaultLinkEnabled

      boolean isDefaultLinkEnabled()
      Returns true if using the default behavior for node selection, false otherwise.

      Default is true.

      Since:
      5.2.0
      See Also:

    • setDefaultLinkEnabled

      void setDefaultLinkEnabled(boolean isDefaultLinkEnabled)
      Sets whether or not to use the default behavior for node selection.

      If false, any selection links must be explicitly generated using this label renderer, for example by adding specific HTML a tags with the href attribute.

      Default is true.

      Since:
      5.2.0
      See Also:

    • setDefaultIconDisplayed

      void setDefaultIconDisplayed(boolean isDefaultIconDisplayed)
      Sets whether or not to use the default icon for hierarchy nodes.

      If false, the content of the line shifts left to where the icon would have been. It is then possible to add a custom icon by adding an img HTML tag. The recommended icon size is 16x16 px. For proper vertical alignment, set vertical-align: -3px;.

      For example: <img src="path/of/my/icon/redBullet16x16.png" style="vertical-align: -3px;"/>

      Default is true.

      Since:
      5.4.1

    • getURLForSelectingCurrentNode

      String getURLForSelectingCurrentNode()
      Returns the URL for selecting the hierarchy node of the current record.
      Since:
      5.2.0

    • getURLForAjaxComponent

      String getURLForAjaxComponent(String ajaxComponentName)
      This inherited method is not supported.
      Specified by:
      getURLForAjaxComponent in interface UIResourceLocator
      Parameters:
      ajaxComponentName - name of the Ajax component declared either in the data model or in the module.
      Throws:
      UnsupportedOperationException - if called.
      Since:
      5.2.0
      See Also:

    • getURLForAjaxComponent

      String getURLForAjaxComponent(String ajaxComponentName, Map<String,String> parameters)
      This inherited method is not supported.
      Specified by:
      getURLForAjaxComponent in interface UIResourceLocator
      Parameters:
      ajaxComponentName - name of the Ajax component declared either in the data model or in the module. If the Ajax component is declared in the module, the name should be prefixed by the module's name and '@' for example module_name@ajax_component_name.
      parameters - map defining HTTP parameters that are passed in the Ajax request. It maps HTTP parameter names with their values.
      Throws:
      UnsupportedOperationException - if called.
      Since:
      5.2.0
      See Also:

    • addPreviewLink

      void addPreviewLink(String aURL, String aLabel)
      Adds a preview link to the node. Clicking on the link displays the the specified URL in a standard modal inner pop-up.

      Recommendations concerning the specified URL:

      Note:

      Parameters:
      aURL - the URL of the page to open.
      aLabel - the label of the link.
      Since:
      5.2.2
      See Also: