Class PromptValue

  • All Implemented Interfaces:
    java.io.Serializable
    Direct Known Subclasses:
    RangePromptValue

    @JsonData
    public abstract class PromptValue
    extends java.lang.Object
    implements java.io.Serializable
    Abstract super class of a prompt value
    Since:
    9.2
    See Also:
    Serialized Form
    • Field Summary

      Fields 
      Modifier and Type Field Description
      static java.text.Format DATEFORMAT
      formatter to use for dates (will use multiple fall backs)
      static java.text.Format DATETIME_FOUR_DIGIT_YEAR_NO_SECONDS
      formatter to use for datetimes with 4-digit years but without showing seconds
      static java.text.Format DATETIME_FOUR_DIGIT_YEAR_WITH_SECONDS
      formatter to use for datetimes with 4-digit years and seconds
      static java.text.Format DATETIMEFORMAT
      formatter to use for datetimes (will use multiple fall backs)
      static java.text.NumberFormat NUMBERFORMAT
      formatter to use for numbers
      static java.text.NumberFormat NUMBERFORMAT_ENGLISH
      needed for format with english decimal points
      static java.text.Format TIMEFORMAT
      formatter to use for times (will use multiple fall backs)
    • Constructor Summary

      Constructors 
      Constructor Description
      PromptValue​(int type)
      Creates a prompt values of the given type initialized with the default value of its type
      PromptValue​(java.lang.String description, int type)
      Creates a prompt values of the given type initialized with the default value of its type
    • Method Summary

      All Methods Instance Methods Abstract Methods Concrete Methods 
      Modifier and Type Method Description
      java.lang.String getDescription()
      Returns the description of the parameter field that has been set using API or i-net Designer dialog.
      abstract java.lang.Object getSQLTypedValue()
      this method returns the value of this promptvalue using an SQL compatible type.
      abstract java.lang.String getStringRepresentation()
      Returns a string representation of the value of this prompt.
      int getType()
      Get value type of the prompt, see the value type constants in PromptData
      abstract java.lang.Object getValue()
      Returns the value of this prompt - its type will depend on which value type this PromptValue has: String for STRING
      Double for NUMBER and CURRENCY
      Boolean for BOOLEAN
      Date for DATE and DATETIME
      Time for TIME
      byte[] for BINARY
      boolean isOnlyDescription()
      If true only the description will be displayed in the report dialog.
      void setDescription​(java.lang.String description)
      Set the description of the parameter field that can be used with API or in the prompt request dialog.
      void setOnlyDescription​(boolean onlyDescription)
      Sets the appearance of this value in the prompt dialog.
      java.lang.String toString()
      Creates a formated string representation of this prompt value with its decription and value.
      • Methods inherited from class java.lang.Object

        clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
    • Field Detail

      • NUMBERFORMAT

        public static java.text.NumberFormat NUMBERFORMAT
        formatter to use for numbers
      • NUMBERFORMAT_ENGLISH

        public static java.text.NumberFormat NUMBERFORMAT_ENGLISH
        needed for format with english decimal points
      • DATEFORMAT

        public static final java.text.Format DATEFORMAT
        formatter to use for dates (will use multiple fall backs)
      • DATETIME_FOUR_DIGIT_YEAR_WITH_SECONDS

        public static final java.text.Format DATETIME_FOUR_DIGIT_YEAR_WITH_SECONDS
        formatter to use for datetimes with 4-digit years and seconds
      • DATETIME_FOUR_DIGIT_YEAR_NO_SECONDS

        public static final java.text.Format DATETIME_FOUR_DIGIT_YEAR_NO_SECONDS
        formatter to use for datetimes with 4-digit years but without showing seconds
      • DATETIMEFORMAT

        public static final java.text.Format DATETIMEFORMAT
        formatter to use for datetimes (will use multiple fall backs)
      • TIMEFORMAT

        public static final java.text.Format TIMEFORMAT
        formatter to use for times (will use multiple fall backs)
    • Constructor Detail

      • PromptValue

        public PromptValue​(int type)
        Creates a prompt values of the given type initialized with the default value of its type
        Parameters:
        type - type of this default value.
        Since:
        9.2
      • PromptValue

        public PromptValue​(java.lang.String description,
                           int type)
        Creates a prompt values of the given type initialized with the default value of its type
        Parameters:
        type - type of this default value.
        description - description of this prompt
        Since:
        9.2
    • Method Detail

      • getStringRepresentation

        public abstract java.lang.String getStringRepresentation()
        Returns a string representation of the value of this prompt.
        Returns:
        a string representation of the value of this prompt.
        Since:
        9.2
      • getValue

        public abstract java.lang.Object getValue()
        Returns the value of this prompt - its type will depend on which value type this PromptValue has: String for STRING
        Double for NUMBER and CURRENCY
        Boolean for BOOLEAN
        Date for DATE and DATETIME
        Time for TIME
        byte[] for BINARY
        Returns:
        the value of this prompt - its type will depend on which value type this PromptValue has.
        Since:
        9.2
      • toString

        public java.lang.String toString()
        Creates a formated string representation of this prompt value with its decription and value.
        Overrides:
        toString in class java.lang.Object
        Returns:
        String representation
        Since:
        9.2
      • getDescription

        public java.lang.String getDescription()
        Returns the description of the parameter field that has been set using API or i-net Designer dialog.
        Returns:
        description of the parameter field
        Since:
        9.2
      • setDescription

        public void setDescription​(java.lang.String description)
        Set the description of the parameter field that can be used with API or in the prompt request dialog.
        Parameters:
        description - of the parameter field
        Since:
        9.2
      • getType

        public int getType()
        Get value type of the prompt, see the value type constants in PromptData
        Returns:
        value type of the prompt, see the value type constants in PromptData
        Since:
        9.2
      • isOnlyDescription

        public boolean isOnlyDescription()
        If true only the description will be displayed in the report dialog. (only necessary if this prompt value represents a default value)
        Returns:
        whether only description is displayed
        Since:
        9.2
      • setOnlyDescription

        public void setOnlyDescription​(boolean onlyDescription)
        Sets the appearance of this value in the prompt dialog. (only necessary if this promtvalue represents a default value)
        Parameters:
        onlyDescription - whether only description shall be displayed
        Since:
        9.2
      • getSQLTypedValue

        public abstract java.lang.Object getSQLTypedValue()
        this method returns the value of this promptvalue using an SQL compatible type. The returned type could be.
        Returns:
        value of this promptvalue using an SQL compatible type.
        Since:
        9.2