Package ch.ivyteam.ivy.application

Interface IApplication

All Superinterfaces:
IActivity, IAttributeStore<Object>, ICustomPropertyProvider, ISystemEventDispatcher
public interface IApplication extends IActivity, IAttributeStore<Object>, ISystemEventDispatcher, ICustomPropertyProvider
API:
This is a public API.

  • Field Details

    • SYSTEM_APPLICATION_NAME

      static final String SYSTEM_APPLICATION_NAME
      System application name
      See Also:
      API:
      This public API is available in Java.

    • DESIGNER_APPLICATION_NAME

      static final String DESIGNER_APPLICATION_NAME
      The name of the application on the designer (is always the same)
      See Also:
      API:
      This public API is available in Java.

  • Method Details

    • getId

      long getId()
      Gets the identifier of the application
      Returns:
      the identifier
      API:
      This public API is available in Java.

    • getName

      String getName()
      Returns the name of the application
      Returns:
      name
      Throws:
      PersistencyException - if persistency access fails
      API:
      This public API is available in Java.

    • getDescription

      @Deprecated(since="11.2", forRemoval=true) default String getDescription()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Returns the description
      Returns:
      description
      Throws:
      PersistencyException - if persistency access fails
      API:
      This public API is available in Java.

    • setDescription

      @Deprecated(since="11.2", forRemoval=true) default void setDescription(String description)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Sets the description
      Parameters:
      description - The description of the application
      Throws:
      PersistencyException - if persistency access fails
      API:
      This public API is available in Java.

    • getFileDirectory

      String getFileDirectory()
      Returns the directory where the files of the application are stored (in this directory, there are different directories for each project and then in each directory different directories for each version...)
      Returns:
      the directory where the files of the application are stored
      Throws:
      PersistencyException - if persistency access fails
      API:
      This public API is available in Java.

    • getFileArea

      File getFileArea()
      Gets the directory where the persistent files that can be accessed with the IvyScript File type are stored for this application. The returned location is relative to the application's general file directory, which is accessible with getFileDirectory().
      Returns:
      persistent file area directory
      Throws:
      PersistencyException - if persistency access fails
      See Also:
      API:
      This public API is available in Java.

    • getSessionFileArea

      default File getSessionFileArea()
      Gets the directory where the temporary IvyScript Files for the current session are stored.
      Returns:
      temporary file area directory for current session
      API:
      This public API is available in Java.

    • setOwnerName

      @Deprecated(since="11.2", forRemoval=true) default void setOwnerName(String ownerName)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Sets the owner name
      Parameters:
      ownerName - The new owner name
      Throws:
      PersistencyException - if persistency access fails
      API:
      This public API is available in Java.

    • getOwnerName

      @Deprecated(since="11.2", forRemoval=true) default String getOwnerName()
      Deprecated, for removal: This API element is subject to removal in a future version.
      Gets the owner name
      Returns:
      owner name
      Throws:
      PersistencyException - if persistency access fails
      API:
      This public API is available in Java.

    • findProcessModel

      IProcessModel findProcessModel(String processModelName)
      Finds a process model by its name
      Parameters:
      processModelName - Name of the process model
      Returns:
      process model or null if no process model with the name exists
      Throws:
      PersistencyException - if persistency access fails
      API:
      This public API is available in Java.

    • findProcessModel

      IProcessModel findProcessModel(Object identifier)
      Finds a process model by its identifier
      Parameters:
      identifier - process model identifier
      Returns:
      process model or null
      Throws:
      PersistencyException - if persistency access fails
      API:
      This public API is available in Java.

    • findProcessModelVersion

      IProcessModelVersion findProcessModelVersion(String processModelVersionUrl)
      Finds a process model version with the procesModelVersionUrl or procesModelUrl
      Parameters:
      processModelVersionUrl - of the process model version
      Returns:
      process model version or null
      Throws:
      PersistencyException - if persistency access fails
      API:
      This public API is available in Java.

    • createProcessModel

      @Deprecated(since="11.2", forRemoval=true) default IProcessModel createProcessModel(String processModelName, String description)
      Deprecated, for removal: This API element is subject to removal in a future version.
      Creates a new process model within the application
      Parameters:
      processModelName - The process model name
      description - Description of the process model
      Returns:
      created process model or null if processModelName isn't unique
      Throws:
      PersistencyException - if persistency access fails
      API:
      This public API is available in Java.

    • deleteProcessModel

      void deleteProcessModel(String processModelName)
      Deletes a process model
      Parameters:
      processModelName - The name of the process model
      Throws:
      PersistencyException - If db access fails
      PersistencyException - if persistency access fails
      API:
      This public API is available in Java.
      Security:
      SESSION OWNS ProcessModelDelete PERMISSION OR OWNS ProcessModelDelete@SYSTEM PERMISSION

    • getProcessModels

      List<IProcessModel> getProcessModels()
      Gets all process models
      Returns:
      unmodifiable list with all process models
      Throws:
      PersistencyException - if persistency access fails
      API:
      This public API is available in Java.

    • getProcessModelsSortedByName

      List<IProcessModel> getProcessModelsSortedByName()
      Gets all process models sorted by the name of the process models
      Returns:
      unmodifiable list with all process models sorted by name
      Throws:
      PersistencyException - if persistency access fails
      API:
      This public API is available in Java.

    • isSystem

      boolean isSystem()
      Returns true if this application is the system application
      Returns:
      true if system application, otherwise false
      Throws:
      PersistencyException - if persistency access fails
      API:
      This public API is available in Java.

    • isSystemProvided

      @Deprecated(since="7.4", forRemoval=true) default boolean isSystemProvided()
      Deprecated, for removal: This API element is subject to removal in a future version.
      use isSystem()
      API:
      This public API is available in Java.

    • getSecurityDescriptor

      ISecurityDescriptor getSecurityDescriptor()
      Gets the security descriptor of the application
      Returns:
      the security descriptor
      Throws:
      PersistencyException - if persistency access fails
      API:
      This public API is available in Java.

    • getSecurityContext

      ISecurityContext getSecurityContext()
      Gets the security context of this application
      Returns:
      security context
      Throws:
      PersistencyException - if persistency access fails
      API:
      This public API is available in Java.

    • getLibraries

      List<ILibrary> getLibraries()
      Gets all liberaries
      Returns:
      list with libraries. Maybe empty, never null.
      Throws:
      PersistencyException - if persistency access fails
      API:
      This public API is available in Java.

    • getBusinessCalendarSettings

      IBusinessCalendarSettings getBusinessCalendarSettings()
      Returns the IBusinessCalendarSettings to access IBusinessCalendarConfigurations
      Returns:
      never null
      API:
      This public API is available in Java.

    • setBusinessCalendar

      void setBusinessCalendar(IBusinessCalendar calendar)
      Defines the IBusinessCalendar for this IApplication. This influences the IDefaultBusinessCalendar determination when calling ivy.cal.
      Parameters:
      calendar - may be null.
      API:
      This public API is available in Java.

    • current

      static IApplication current()

      Gets the current application.

      Will return null if called out of scope. The scope is set if you call this method from an ivy process or any supported ivy environment. It is not set in non supported ivy environments (e.g. if you start your own threads, etc.).

      Returns:
      current application or null if out of scope
      Since:
      9.1
      API:
      This public API is available in Java.