Klasse Subreport

java.lang.Object
com.inet.report.ReportComponent
com.inet.report.Element
com.inet.report.AbstractFontElement
com.inet.report.Subreport
Alle implementierten Schnittstellen:
BorderProperties, FontProperties, GeneralProperties, NodeParser, com.inet.report.ReferenceHolder, SubreportProperties, TextProperties, Serializable, Cloneable
public class Subreport extends AbstractFontElement implements SubreportProperties, TextProperties, com.inet.report.ReferenceHolder, BorderProperties
Engines cannot hold more than one datasource, so if you need a report that uses data from two or more datasources, you have to use Subreport objects in the report.

Example:
You have one database to store private data of your employees. In another database (a table in the same database should also work, but no subreports are required here) you store the sales of each of your shops. So, if you want to create a report, that displays all sales according to the employee you have to create some fields in the main report that shows the employees and a subreport that have some fields to show the sales. To realize the representation of sales according to employees insert a SubreportLink using the employee id field in the main report (i.e. Employees.Id) and the employee id in the subreport (i.e. Sales.Employee-Id). Now each employee will be followed by its sales, where the sales were shown in a single object - the Subreport object.

This class is part of the RDC.
Siehe auch:

  • Methodendetails

    • copy

      public Object copy() throws ReportException
      Creates a serializable copy of this Element. The returned Object is not an instance of Element. This method is used from i-net Designer for Copy and Paste.
      Setzt außer Kraft:
      copy in Klasse Element
      Gibt zurück:
      A serializable Object.
      Löst aus:
      ReportException - If accessing properties of this Element causes any errors.
      Siehe auch:

    • getEngine

      public Engine getEngine()
      Returns the engine object belonging to this subreport. This is different to the super method of Element. Will return null if this subreport no longer belongs to a main report.
      Setzt außer Kraft:
      getEngine in Klasse Element
      Gibt zurück:
      Engine The engine of the subreport.
      Seit:
      6.0
      Siehe auch:

    • addSubreportLink

      public SubreportLink addSubreportLink(Field mainRptField, Field subRptField) throws ReportException
      Adds a new subreport link to the set and returns it.
      Parameter:
      mainRptField - The Field in the main report whose values will be used for the PromptField in the subreport.
      subRptField - The Field in the subreport whose values will be used to compare with the values of the PromptField.
      Gibt zurück:
      The created SubreportLink object.
      Löst aus:
      ReportException - If an error occurred while creating the sub report link.
      Seit:
      6.0

    • addSubreportLink

      public SubreportLink addSubreportLink(Field mainRptField, Field subRptField, boolean generatePrompt) throws ReportException
      Adds a new subreport link to the set and returns it.
      Parameter:
      mainRptField - The Field in the main report whose values will be used for the PromptField in the subreport.
      subRptField - The Field in the subreport whose values will be used to compare with the values of the PromptField.
      generatePrompt - If true a PromptField which is used for this link is generated automatically. If set to false a PromptField has to be set with SubreportLink.setPromptField(PromptField).
      Gibt zurück:
      The created SubreportLink object.
      Löst aus:
      ReportException - If an error occurred while creating the sub report link.
      Seit:
      6.0

    • removeSubreportLink

      public void removeSubreportLink(int idx)
      Removes the subreport link at the specified index.
      Parameter:
      idx - The 0-based index of the SubreportLink object that should be removed.
      Seit:
      6.0
      Siehe auch:

    • getSubreportLink

      public SubreportLink getSubreportLink(int idx)
      Gets the subreport link at the specified index.
      Parameter:
      idx - The 0-based index of the subreport that should be returned.
      Gibt zurück:
      The SubreportLink object at the specified position.
      Seit:
      6.0
      Siehe auch:

    • getSubreportLinkCount

      public int getSubreportLinkCount()
      Returns the number of subreport links in the set
      Gibt zurück:
      The number of subreport links.
      Seit:
      6.0

    • setOnDemand

      public void setOnDemand(boolean onDemand)
      Specifies whether on demand is enabled or not.
      Angegeben von:
      setOnDemand in Schnittstelle SubreportProperties
      Parameter:
      onDemand - when true on demand is enabled

    • isOnDemand

      public boolean isOnDemand()
      Returns true if on demand is enabled else false.
      Angegeben von:
      isOnDemand in Schnittstelle SubreportProperties
      Gibt zurück:
      whether on demand is enabled
      Seit:
      7.0

    • setOnDemandLinkLabel

      public void setOnDemandLinkLabel(String lab)
      If on demand is enabled, the element is shown in the report as a line of text. Specify this text with this method.
      Angegeben von:
      setOnDemandLinkLabel in Schnittstelle SubreportProperties
      Parameter:
      lab - - the text as String

    • setOnDemandLinkLabel

      public void setOnDemandLinkLabel(FormulaField lab)
      If on demand is enabled, the element is shown in the report as a line of text. Specify this text with this method.
      Angegeben von:
      setOnDemandLinkLabel in Schnittstelle SubreportProperties
      Parameter:
      lab - - a FormulaField whose return value specifies the text.

    • getOnDemandLinkLabel

      public FormulaField getOnDemandLinkLabel()
      Returns a FormulaField whose return value specifies the text that is shown instead of the element content when on demand is enabled.
      Angegeben von:
      getOnDemandLinkLabel in Schnittstelle SubreportProperties
      Gibt zurück:
      FormulaField

    • setOnDemandTabLabel

      public void setOnDemandTabLabel(String lab)
      If on demand is enabled and the element is activated, it is shown in an extra tab or window. Specify the name of this tab with this method.
      Angegeben von:
      setOnDemandTabLabel in Schnittstelle SubreportProperties
      Parameter:
      lab - - the name as String

    • setOnDemandTabLabel

      public void setOnDemandTabLabel(FormulaField lab)
      If on demand is enabled and the element is activated, it is shown in an extra tab or window. Specify the name of this tab with this method.
      Angegeben von:
      setOnDemandTabLabel in Schnittstelle SubreportProperties
      Parameter:
      lab - - a FormulaField whose return value specifies the name.

    • getOnDemandTabLabel

      public FormulaField getOnDemandTabLabel()
      Returns a FormulaField whose return value specifies the name of the tab which is showing the activated element if on demand is enabled.
      Angegeben von:
      getOnDemandTabLabel in Schnittstelle SubreportProperties
      Gibt zurück:
      FormulaField

    • getPropertyFormulas

      public List<FormulaField> getPropertyFormulas()
      Returns a list with all property formulas that are set for this report element. This includes property formulas for any type of sub-component but excludes formulas for any descendant ReportComponent of this one. To get the property formulas for descendant ReportComponent use ReportComponent.getSubComponents()
      Setzt außer Kraft:
      getPropertyFormulas in Klasse AbstractFontElement
      Gibt zurück:
      List of property formulas

    • setReferences

      public final void setReferences()
      FOR INTERNAL USE ONLY
      Angegeben von:
      setReferences in Schnittstelle com.inet.report.ReferenceHolder
      Setzt außer Kraft:
      setReferences in Klasse Element

    • resetReferences

      public final void resetReferences()
      FOR INTERNAL USE ONLY
      Angegeben von:
      resetReferences in Schnittstelle com.inet.report.ReferenceHolder
      Setzt außer Kraft:
      resetReferences in Klasse ReportComponent

    • getGlyphOrientation

      public int getGlyphOrientation()
      Returns the glyph orientation. This is the rotation of every individual character in the line. The default value is GLYPH_DEFAULT, that is, the glyphs point towards the source of the given block progression. Use the GLYPH constants for the orientation.
      Angegeben von:
      getGlyphOrientation in Schnittstelle TextProperties
      Gibt zurück:
      glyph orientation
      Siehe auch:

    • setGlyphOrientation

      public void setGlyphOrientation(int orientation)
      Sets the orientation of the glyphs. This is the rotation of every individual character in the line. The default value is GLYPH_DEFAULT, that is, the glyphs point towards the source of the given block progression. Use the GLYPH constants for the orientation.
      Angegeben von:
      setGlyphOrientation in Schnittstelle TextProperties
      Parameter:
      orientation - Orientation to be set for the glyphs (i.e. the rotation of every individual character of the line of text)
      Siehe auch:

    • setGlyphOrientationFormula

      public void setGlyphOrientationFormula(FormulaField formula)
      Sets the formula whose return value determines the glyph orientation. This is the rotation of every individual character in each line. This formula should return one of the formula constants GlyphDefault, GlyphLeft, GlyphRight, or GlyphDown.
      Angegeben von:
      setGlyphOrientationFormula in Schnittstelle TextProperties
      Parameter:
      formula - the formula whose return value determines the glyph orientation

    • getGlyphOrientationFormula

      public FormulaField getGlyphOrientationFormula()
      Returns the formula whose return value determines the glyph orientation. This is the rotation of every individual character in each line. This formula should return one of the formula constants GlyphDefault, GlyphLeft, GlyphRight, or GlyphDown.
      Angegeben von:
      getGlyphOrientationFormula in Schnittstelle TextProperties
      Gibt zurück:
      the formula whose return value determines the glyph orientation

    • setTextRotation

      public void setTextRotation(int rotation)
      Sets the value of the property 'text rotation'. This property defines a final rotation of the entire element after the text is laid out. For example, to have a text element have vertical text running from top to bottom and each line run from right to left, you'd set a glyph orientation of GLYPH_LEFT and a text rotation of ROTATE_270.
      Angegeben von:
      setTextRotation in Schnittstelle TextProperties
      Parameter:
      rotation - The new value of the property 'text rotation'. Rotation is done counter-clockwise.
      Seit:
      5.4
      Siehe auch:

    • getTextRotation

      public int getTextRotation()
      Returns the value of the property 'text rotation'. This property defines a final rotation of the entire element after the text is laid out. For example, to have a text element have vertical text running from top to bottom and each line run from right to left, you'd set a glyph orientation of GLYPH_LEFT and a text rotation of ROTATE_270.
      Angegeben von:
      getTextRotation in Schnittstelle TextProperties
      Gibt zurück:
      The value of the property 'text rotation'.
      Seit:
      5.4
      Siehe auch:

    • getTextRotationFormula

      public FormulaField getTextRotationFormula()
      Returns the formula whose return value determines the property 'text rotation'. This property defines a final rotation of the entire element after the text is laid out. This formula should return one of the formula constants Rotate0, Rotate90, Rotate180, or Rotate270.
      Angegeben von:
      getTextRotationFormula in Schnittstelle TextProperties
      Gibt zurück:
      formula whose return value determines the property 'text rotation'.
      Siehe auch:

    • setTextRotationFormula

      public void setTextRotationFormula(FormulaField formula)
      Sets the formula whose return value determines the property 'text rotation'. This property defines a final rotation of the entire element after the text is laid out. This formula should return one of the formula constants Rotate0, Rotate90, Rotate180, or Rotate270.
      Angegeben von:
      setTextRotationFormula in Schnittstelle TextProperties
      Parameter:
      formula - formula whose return value determines the property 'text rotation'.
      Siehe auch:

    • isSuppressIfBlank

      public boolean isSuppressIfBlank()
      Returns true if "suppress if blank" is enabled else false. A subreport is blank if all sections are suppressed or have no height. If the subreport is suppressed, the border and background will not be printed.
      Angegeben von:
      isSuppressIfBlank in Schnittstelle SubreportProperties
      Gibt zurück:
      whether "suppress if blank" is enabled
      Siehe auch:

    • setSuppressIfBlank

      public void setSuppressIfBlank(boolean suppress)
      Specifies whether "suppress if blank" is enabled or not. A subreport is blank if all sections are suppressed or have no height. If the subreport is suppressed, the border and background will not be printed.
      Angegeben von:
      setSuppressIfBlank in Schnittstelle SubreportProperties
      Parameter:
      suppress - whether to suppress the display of this subreport if it is blank
      Siehe auch:

    • parseElement

      public NodeParser parseElement(com.inet.report.parser.XMLTag group, String tag, Attributes atts, Map<String,Object> parserMap) throws FatalParserException
      FOR INTERNAL USE ONLY FOR INTERNAL USE ONLY FOR INTERNAL USE ONLY FOR INTERNAL USE ONLY Internal method for reading report XML

      Parses an XML node with the given information, and returns either a sub-element which was created as a result, or null if no sub-element was created, i.e. the information was applied to the ReportComponent itself. Note that the parsing is highly tolerant, i.e. exceptions are intercepted and suppressed if at all possible.

      Angegeben von:
      parseElement in Schnittstelle NodeParser
      Setzt außer Kraft:
      parseElement in Klasse AbstractFontElement
      Parameter:
      group - XMLTag of the current node to be parsed, or null if there is no such current group. An XMLTag is a group of nodes bundled together, usually it is a Properties node such as CommonProperties, BorderProperties, etc.
      tag - The XMLTag to be parsed
      atts - The set of attributes in the current XMLTag
      parserMap - The map of current Parser.
      Gibt zurück:
      The NodeParser sub-element if one needed to be created, or null if none was created.
      Löst aus:
      FatalParserException - if an exception occurs which causes the report to not be able to be read: causes the abortion of the reading of the report.

    • parseText

      public void parseText(String textData, Map<String,Object> parserMap)
      FOR INTERNAL USE ONLY FOR INTERNAL USE ONLY FOR INTERNAL USE ONLY Internal method for reading report XML

      This method is called if text was encountered in the context of this node. (Examples would be a formula's text or a text element's text)

      Angegeben von:
      parseText in Schnittstelle NodeParser
      Setzt außer Kraft:
      parseText in Klasse Element
      Parameter:
      textData - text encountered and to be stored
      parserMap - The map of current Parser.

    • parseEndElement

      public void parseEndElement(com.inet.report.parser.XMLTag group, String tag, Map<String,Object> parserMap) throws FatalParserException
      FOR INTERNAL USE ONLY Internal method for reading report XML

      Receive notification of the end of an XML tag.

      Angegeben von:
      parseEndElement in Schnittstelle NodeParser
      Setzt außer Kraft:
      parseEndElement in Klasse ReportComponent
      Parameter:
      group - XMLTag of the current node to be parsed, or null if there is no such current group.
      tag - The XMLTag to be parsed
      parserMap - The map of current Parser.
      Löst aus:
      FatalParserException - if an exception occurs which causes the report to not be able to be read: causes the abortion of the reading of the report.

    • getSubComponents

      public List<? extends ReportComponent> getSubComponents()
      Returns all ReportComponents that are descendants of this one. E.G. this will return all Element of a Section. But it's as well useful for CrossTabs or Text elements which have additional elements. NOTE: This does not return any ReportComponent of the sub-engine!
      Angegeben von:
      getSubComponents in Klasse ReportComponent
      Gibt zurück:
      a list with all sub components which can be empty as well; will be null if the component has no descendants