Run Filter In Process

By default, Filter runs independently from the calling application process. This is called out-of-process filtering. Out-of-process filtering protects the stability of the calling application in the rare case when a malformed document causes Filter to fail. You can configure Filter to run in the same process as the calling application. This is called in-process filtering. However, OpenText strongly recommends that you run Filter out-of-process whenever possible.

To run Filter in process

  • In the Java API, set one of the following flags when you instantiate the Filter object.

    FILTERFLAG_DETECTINPROCESS Enables in-process file format detection.
    FILTERFLAG_INPROCESS Enables in-process filtering, extraction, and file format detection.

    For example:

    Filter objFilter = new Filter("YOUR_KEYVIEW_LICENSE", Filter.CHARSET_UTF8, Filter.FILTERFLAG_INPROCESS);
  • In the formats.ini configuration file, set the following parameters in the [FilterSDK_Config] section. (This is an alternative approach - you do not need to do this if you have configured this feature through the API).

    default_inprocess

    To perform filtering, extraction, and file format detection in-process, set this parameter to 1.

    The default value is 0.

    default_detect_inprocess

    This parameter can be used to override the value of default_inprocess for file format detection. To perform file format detection in-process, but run filtering out-of-process, set this parameter to 1 and default_inprocess to 0.

    The default value is the value of default_inprocess.