Interface IApplicationConfiguration

All Superinterfaces:
IConfiguration
All Known Implementing Classes:
DefaultApplicationConfiguration

public interface IApplicationConfiguration extends IConfiguration
This interface defines the methods that should be implemented by an object defining an application specific configuration.
Since:
6.0
Author:
O. Kerpershoek, F. van der Meer
  • Method Details

    • cachingEnabled

      boolean cachingEnabled()
      Indicating if models should be cached on the server.
      Returns:
      a boolean indicating if application models should be cached.
    • wrapFailedElements

      boolean wrapFailedElements()
      This method returns a boolean indicating if elements that fail expansion should be replaced by failed element objects, or that the cause of the failure should be thrown as an exception.
      Returns:
      a boolean indicating if elements that fail expansion should be replaced by failed element objects.
    • outputFailedMasks

      boolean outputFailedMasks()
      This method returns a boolean indicating if failed masks must be included in the expanded element, or that the cause of the failure should be thrown as an exception.
      Returns:
      a boolean indicating if mask that fails should be included in the expanded element.
    • getApplicationMode

      ApplicationMode getApplicationMode()
      This method returns the application mode the application should run in.
      Returns:
      the application mode the application should run in.
    • isContextImmutableFor

      boolean isContextImmutableFor(String name)
      This method returns a boolean indicating if the context of a container should be read-only during the expand phase.
      Parameters:
      name - The container type name for which the immutable setting is requested.
      Returns:
      a boolean indicating if the context of a container should be read-only during the expand phase.
    • getValueFormatDefinitions

      ValueFormatDefinition[] getValueFormatDefinitions()
      This method returns an array containing value format definitions that were added in the application configuration. Normally all the value formats should be specified in Studio, but the application configuration may choose to add custom value formats to override the default format from studio.
      Returns:
      An array containing value format definitions that were added in the application configuration.
    • getFormatName

      String getFormatName(String languageCode, DataType type)
      This method should return the value format name of the format defined in Studio that should be used to convert values of this type for the specified language.
      Parameters:
      languageCode - The language code for which the format name is requested.
      type - The data type for which the format name is requested.
      Returns:
      The name of the value format that should be used for this language type combination.
    • isTargetDownCastingEnabled

      boolean isTargetDownCastingEnabled()
      Represents the down casting function for decision tables, since studio 5 allows one for correctly defining decision-tables. This feature is a configuration option for users wanting to enable backwards compatibility.

      Historical background:
      The 4.2 model allows rules to be defined with source attributes that belong to a more specific entity than the entity of the target attributes. In order to 'correctly' handle these rules the target attributes need to be down-casted to the more specific entity type.

      The default recommended value for this function is false.
      Returns:
      A boolean indicating the old down-casting feature should be enabled.
    • getParserVersion

      String getParserVersion()
      This method returns the version of the parser that should be used. At the moment there are two parser versions available:
      • Version 6.x and lower, which will accept most expressions including various obsolete R4 constructions.
      • Version 7.x or higher, which will accept only valid R6 expressions and additions made for R7.
      Returns:
      The version of the parser that should be used.
    • getConnectionManager

      IConnectionManager getConnectionManager()
      This method may return an application specific connection manager. The connection manager will be available in the context of the services and containers to request predefined connections.
      Returns:
      an application specific connection manager.
    • getRuleDefinitions

      RuleDefinition[] getRuleDefinitions(String moduleName)
      This method returns an array containing definitions of the custom business rules for the application. The rule factory is used to locate the actual implementation of the rules. Once the custom business rules can be defined in studio, this method will become obsolete.
      Parameters:
      moduleName - The name of the module that contains the rules.
      Returns:
      an array containing definitions of the custom business rules for the application.
    • getProcessCaseDao

      IProcessCaseDao getProcessCaseDao()
      This method returns the case DAO that should be used by the process engine. By default an in-memory DAO will be used. This method is only relevant for applications using a process engine, and will probably be deprecated once the process engine can be configured separate from the applications using it.
      Returns:
      The case DAO that should be used by the process engine.
    • getTraceDao

      ITraceDao getTraceDao()
      This method returns the trace DAO that should be used by the trace engine. By default an in-memory DAO will be used.
      Returns:
      The trace DAO that should be used by the trace engine.
    • getTimelineCreator

      ITimelineCreator getTimelineCreator()
      This method returns the timeline DAO that should be used by the trace engine. By default an in-memory DAO will be used.
      Returns:
      The timeline DAO that should be used by the trace engine.