Interface FileEventDefinition

    • Method Detail

      • getDirectory

        String getDirectory()
        Get the value for Directory. (Directory containing files to match.) This value is mandatory, and therefore will not be null if this object has been retrieved from the database.
        Returns:
        the field
        Throws:
        ObjectNotAttachedToSessionException - This will be thrown if this method is called while the object is not attached to a session.
      • getPattern

        String getPattern()
        Get the value for Pattern. (Pattern for files to match.) This value is mandatory, and therefore will not be null if this object has been retrieved from the database.
        Returns:
        the field
        Throws:
        ObjectNotAttachedToSessionException - This will be thrown if this method is called while the object is not attached to a session.
      • getMoveDirectory

        String getMoveDirectory()
        Get the value for MoveDirectory. (Directory or Filename specification that the detected file for this FileEvent will be renamed to. If the specification does not contain substitution variables, it must indicate an existing directory. If it does contain substitution variables, the resulting path must indicate a directory and a non-null file part that does not exist yet, or just a non-null file part that does not exist yet. In the last case the file will remain in the same directory, but with a new filename. The following substitutions can take place:
        • ${BaseDirectory} will be replaced by the base directory of the detected file.
        • ${BaseName} will be replaced by the base filename of the detected file.
        • ${CurrentDateTime} will be replaced by the date/time the file was detected, in a string format YYYYMMDDHHMMSS.
        • ${CurrentTimeStamp} will be replaced by the timestamp the file was detected, in a numeric format containing the milliseconds since 1970.
        • ${DateTime} deprecated in favor of ${CurrentDateTime}.
        • ${Dot} will be replaced by a dot if the detected file had an extension, and nothing otherwise.
        • ${Extension} will be replaced by the extension of the detected file.
        • ${FileName} will be replaced by the name of the detected file (including extension).
        • ${FileDateTime} will be replaced by the modification date/time that the detected file has, in a string format YYYYMMDDHHMMSS.
        • ${FileTimeStamp} will be replaced by the modification timestamp that the detected file has, in a numeric format containing the milliseconds since 1970.
        • ${Name} will be replaced by the base filename plus extension of the detected file.
        • ${TimeStamp} deprecated in favor of ${CurrentTimeStamp}.
        • ${UniqueId} will be replaced by the unique id of the file event.
        )
        Returns:
        the field
        Throws:
        ObjectNotAttachedToSessionException - This will be thrown if this method is called while the object is not attached to a session.
      • getPollInterval

        Long getPollInterval()
        Get the value for PollInterval. (Polling interval for new files, specified in seconds.) This value is mandatory, and therefore will not be null if this object has been retrieved from the database.
        Returns:
        the field
        Throws:
        ObjectNotAttachedToSessionException - This will be thrown if this method is called while the object is not attached to a session.
      • isCheckLock

        boolean isCheckLock()
        Get the value for CheckLock. (Check whether the file in use before raising the event. This is a very expensive operation on UNIX systems, so use of this option on such systems is discouraged. It is recommended that you use the minimum file size and file age or file stability criteria instead.)
        Returns:
        the field
        Throws:
        ObjectNotAttachedToSessionException - This will be thrown if this method is called while the object is not attached to a session.
      • isOverwriteFile

        boolean isOverwriteFile()
        Get the value for OverwriteFile. (Allow deletion if the file already exists in the move directory?)
        Returns:
        the field
        Throws:
        ObjectNotAttachedToSessionException - This will be thrown if this method is called while the object is not attached to a session.
      • getRaiseComment

        String getRaiseComment()
        Get the value for RaiseComment. (Comment that will be set as RaiserComment on a newly raised file event. The following substitutions can take place:
        • ${CurrentDateTime} will be replaced by the date/time (agent) at which the file was detected, in a string format YYYYMMDDHHMMSS.
        • ${CurrentTimeStamp} will be replaced by the timestamp (agent) at which the file was detected, in a numeric format containing the milliseconds since 1970.
        • ${FileDateTime} will be replaced by the modification date/time (agent) that the detected file has, in a string format YYYYMMDDHHMMSS.
        • ${FileTimeStamp} will be replaced by the modification timestamp (agent) that the detected file has, in a numeric format containing the milliseconds since 1970.
        • ${filename} will be replaced by the full path of the detected file.
        • ${finalPath} will be replaced by the new path of the detected file (after the move).
        • ${server} will be replaced by the detected file.
        • ${ServerDateTime} will be replaced by the modification date/time (central server) that the detected file has, in a string format YYYYMMDDHHMMSS.
        • ${ServerTimeStamp} will be replaced by the modification timestamp (central server) that the detected file has, in a numeric format containing the milliseconds since 1970.
        ) This value is mandatory, and therefore will not be null if this object has been retrieved from the database.
        Returns:
        the field
        Throws:
        ObjectNotAttachedToSessionException - This will be thrown if this method is called while the object is not attached to a session.
      • getMinimalSize

        Long getMinimalSize()
        Get the value for MinimalSize. (Minimum size of the file in bytes before the event is raised.) This value is mandatory, and therefore will not be null if this object has been retrieved from the database.
        Returns:
        the field
        Throws:
        ObjectNotAttachedToSessionException - This will be thrown if this method is called while the object is not attached to a session.
      • getMinimalAge

        Long getMinimalAge()
        Get the value for MinimalAge. (Minimum age of the file in seconds before the event is raised. A negative value is also allowed, in which case the system will check that the file timestamp does not change for the number of seconds indicated.) This value is mandatory, and therefore will not be null if this object has been retrieved from the database.
        Returns:
        the field
        Throws:
        ObjectNotAttachedToSessionException - This will be thrown if this method is called while the object is not attached to a session.
      • setDirectory

        void setDirectory​(String newDirectory)
        Set the value for Directory. (Directory containing files to match.) This value is mandatory.
        Parameters:
        newDirectory - the new value for Directory. If this is null, then the object cannot be persisted.
        Throws:
        ObjectNotAttachedToSessionException - This will be thrown if this method is called while the object is not attached to a session.
      • setPattern

        void setPattern​(String newPattern)
        Set the value for Pattern. (Pattern for files to match.) This value is mandatory.
        Parameters:
        newPattern - the new value for Pattern. If this is null, then the object cannot be persisted.
        Throws:
        ObjectNotAttachedToSessionException - This will be thrown if this method is called while the object is not attached to a session.
      • setMoveDirectory

        void setMoveDirectory​(String newMoveDirectory)
        Set the value for MoveDirectory. (Directory or Filename specification that the detected file for this FileEvent will be renamed to. If the specification does not contain substitution variables, it must indicate an existing directory. If it does contain substitution variables, the resulting path must indicate a directory and a non-null file part that does not exist yet, or just a non-null file part that does not exist yet. In the last case the file will remain in the same directory, but with a new filename. The following substitutions can take place:
        • ${BaseDirectory} will be replaced by the base directory of the detected file.
        • ${BaseName} will be replaced by the base filename of the detected file.
        • ${CurrentDateTime} will be replaced by the date/time the file was detected, in a string format YYYYMMDDHHMMSS.
        • ${CurrentTimeStamp} will be replaced by the timestamp the file was detected, in a numeric format containing the milliseconds since 1970.
        • ${DateTime} deprecated in favor of ${CurrentDateTime}.
        • ${Dot} will be replaced by a dot if the detected file had an extension, and nothing otherwise.
        • ${Extension} will be replaced by the extension of the detected file.
        • ${FileName} will be replaced by the name of the detected file (including extension).
        • ${FileDateTime} will be replaced by the modification date/time that the detected file has, in a string format YYYYMMDDHHMMSS.
        • ${FileTimeStamp} will be replaced by the modification timestamp that the detected file has, in a numeric format containing the milliseconds since 1970.
        • ${Name} will be replaced by the base filename plus extension of the detected file.
        • ${TimeStamp} deprecated in favor of ${CurrentTimeStamp}.
        • ${UniqueId} will be replaced by the unique id of the file event.
        ) This value is optional.
        Parameters:
        newMoveDirectory - the new value for MoveDirectory.
        Throws:
        ObjectNotAttachedToSessionException - This will be thrown if this method is called while the object is not attached to a session.
      • setPollInterval

        void setPollInterval​(Long newPollInterval)
        Set the value for PollInterval. (Polling interval for new files, specified in seconds.) This value is mandatory.
        Parameters:
        newPollInterval - the new value for PollInterval. If this is null, then the object cannot be persisted.
        Throws:
        ObjectNotAttachedToSessionException - This will be thrown if this method is called while the object is not attached to a session.
      • setCheckLock

        void setCheckLock​(boolean newCheckLock)
        Set the value for CheckLock. (Check whether the file in use before raising the event. This is a very expensive operation on UNIX systems, so use of this option on such systems is discouraged. It is recommended that you use the minimum file size and file age or file stability criteria instead.)
        Parameters:
        newCheckLock - the new value for CheckLock.
        Throws:
        ObjectNotAttachedToSessionException - This will be thrown if this method is called while the object is not attached to a session.
      • setOverwriteFile

        void setOverwriteFile​(boolean newOverwriteFile)
        Set the value for OverwriteFile. (Allow deletion if the file already exists in the move directory?)
        Parameters:
        newOverwriteFile - the new value for OverwriteFile.
        Throws:
        ObjectNotAttachedToSessionException - This will be thrown if this method is called while the object is not attached to a session.
      • setRaiseComment

        void setRaiseComment​(String newRaiseComment)
        Set the value for RaiseComment. (Comment that will be set as RaiserComment on a newly raised file event. The following substitutions can take place:
        • ${CurrentDateTime} will be replaced by the date/time (agent) at which the file was detected, in a string format YYYYMMDDHHMMSS.
        • ${CurrentTimeStamp} will be replaced by the timestamp (agent) at which the file was detected, in a numeric format containing the milliseconds since 1970.
        • ${FileDateTime} will be replaced by the modification date/time (agent) that the detected file has, in a string format YYYYMMDDHHMMSS.
        • ${FileTimeStamp} will be replaced by the modification timestamp (agent) that the detected file has, in a numeric format containing the milliseconds since 1970.
        • ${filename} will be replaced by the full path of the detected file.
        • ${finalPath} will be replaced by the new path of the detected file (after the move).
        • ${server} will be replaced by the detected file.
        • ${ServerDateTime} will be replaced by the modification date/time (central server) that the detected file has, in a string format YYYYMMDDHHMMSS.
        • ${ServerTimeStamp} will be replaced by the modification timestamp (central server) that the detected file has, in a numeric format containing the milliseconds since 1970.
        ) This value is mandatory.
        Parameters:
        newRaiseComment - the new value for RaiseComment. If this is null, then the object cannot be persisted.
        Throws:
        ObjectNotAttachedToSessionException - This will be thrown if this method is called while the object is not attached to a session.
      • setMinimalSize

        void setMinimalSize​(Long newMinimalSize)
        Set the value for MinimalSize. (Minimum size of the file in bytes before the event is raised.) This value is mandatory.
        Parameters:
        newMinimalSize - the new value for MinimalSize. If this is null, then the object cannot be persisted.
        Throws:
        ObjectNotAttachedToSessionException - This will be thrown if this method is called while the object is not attached to a session.
      • setMinimalAge

        void setMinimalAge​(Long newMinimalAge)
        Set the value for MinimalAge. (Minimum age of the file in seconds before the event is raised. A negative value is also allowed, in which case the system will check that the file timestamp does not change for the number of seconds indicated.) This value is mandatory.
        Parameters:
        newMinimalAge - the new value for MinimalAge. If this is null, then the object cannot be persisted.
        Throws:
        ObjectNotAttachedToSessionException - This will be thrown if this method is called while the object is not attached to a session.
      • setProcessServer

        void setProcessServer​(ProcessServer newProcessServer)
        Set the value for ProcessServer. This value is mandatory.
        Parameters:
        newProcessServer - is the object to set ProcessServer to. Which process server should watch for a particular file event. If this is null, then the object cannot be persisted.