Version 1.27.0

Updated PlaceholderResolver.setFromItem to use a generalized method for adding placeholders based on related items (top level, parent, ancestor, etc). Making it easier to add placeholders for related items. This method is now used to add the following related item placeholders (some were already present previously, many are new):

{top_level_guid} - The GUID of the associated top level item
{top_level_name} - The name (via Item.getLocalisedName) of the associated top level item
{top_level_kind} - The kind (via ItemType.getKind.getName) of the associated top level item
{top_level_type} - The localised (human friendly) name of the mime type attributed to the associated top level item.
{top_level_mimetype} - The mime type of the associated top level item.
{top_level_short_date} - The short format (YYYYMMDD) item date of the associated top level item.
{top_level_long_date} - The long format (YYYYMMDD-HHMMSS) item date of the associated top level item.
{top_level_year} - The item date year (YYYY) of the associated top level item.
{top_level_month} - The item date month (MM) of the associated top level item.
{top_level_day} - The item date day (DD) of the associated top level item.
{parent_guid} - The GUID of the associated parent item
{parent_name} - The name (via Item.getLocalisedName) of the associated parent item
{parent_kind} - The kind (via ItemType.getKind.getName) of the associated parent item
{parent_type} - The localised (human friendly) name of the mime type attributed to the associated parent item.
{parent_mimetype} - The mime type of the associated parent item.
{parent_short_date} - The short format (YYYYMMDD) item date of the associated parent item.
{parent_long_date} - The long format (YYYYMMDD-HHMMSS) item date of the associated parent item.
{parent_year} - The item date year (YYYY) of the associated parent item.
{parent_month} - The item date month (MM) of the associated parent item.
{parent_day} - The item date day (DD) of the associated parent item.
{container_guid} - The GUID of the associated nearest ancestor container item
{container_name} - The name (via Item.getLocalisedName) of the associated nearest ancestor container item
{container_kind} - The kind (via ItemType.getKind.getName) of the associated nearest ancestor container item
{container_type} - The localised (human friendly) name of the mime type attributed to the associated nearest ancestor container item.
{container_mimetype} - The mime type of the associated nearest ancestor container item.
{container_short_date} - The short format (YYYYMMDD) item date of the associated nearest ancestor container item.
{container_long_date} - The long format (YYYYMMDD-HHMMSS) item date of the associated nearest ancestor container item.
{container_year} - The item date year (YYYY) of the associated nearest ancestor container item.
{container_month} - The item date month (MM) of the associated nearest ancestor container item.
{container_day} - The item date day (DD) of the associated nearest ancestor container item.

Version 1.26.0

Enhancements to CustomExporter and PlaceholderResolver (which it relies on):

• Added a few new default placeholders associated with date time (such as when exported was started)
• CustomExporter callbacks for forwarding progress and logging to elsewhere
• Support for setSkipNativesSlipsheetedItems
• Fix for situation where extension could be doubled up on final file
• Support for dropping zero byte text files produced by Nuix when product TEXT is exported, Note this needs 2 switches passed to Nuix at startup to even make zero byte exported text possible:
  • -Dnuix.export.text.outputMetadataWhenNoText=FALSE
  • -Dnuix.processing.itemPlaceholders.documentHasNoText=""
• Support for skipping export of item which Nuix determines it cannot reach the binary for (as determined by whether item.getBinary.getBinaryData.getLength throws an exception or not).

Version 1.25.0

Fixed encoding issues with CustomExporter, DatLoadFileWriter, DatLoadFileReader, SimpleTextFileWriter and SimpleTextFileReader that could occur depending on the system's default encoding and whether file.encoding has been configured to something like UTF-8. Now various places explicitly specify UTF-8 so that system default is not assumed.

Added some new default placeholder values that can be set in PlaceholderResolver which are then made available to CustomExporter:

{case_name} - The name assigned to the case, as obtained by calling Case.getName
{case_guid} - The GUID assigned to the case, as obtained by calling Case.getGuid
{investigator} - The investigator associated to the case, as obtained by calling Case.getInvestigator
{date_short} - The datetime of invocation, formatted YYYYMMDD
{date_long} - The datetime of invocation, formatted YYYYMMdd-HHmmss
{date_year} - The datetime of invocation, as 4 digit year
{date_month} - The datetime of invocation, as 2 digit month
{date_day} - The datetime of invocation, as 2 digit day of the month
{nuix_version} - The Nuix version as defined in NUIX_VERSION

Version 1.24.0

Improved Case Search Traversal Logic

The method CaseUtility.findCaseDirectories was updated to traverse the file system a little more intelligently. Now when a case.fbi2 is located (which should be root of a Nuix case) traversal will not continue to search any of that case's sub-directories. This should result in an overall faster case directory search and in some instances prevent specific issues around large numbers of files within a case directory causing issues when traversal is over a network share.

What's Changed

• Smarter traversal while searching for case.fbi2 files by @JuicyDragon in #23

Full Changelog: v1.23.0...v1.24.0

Version 1.23.0

A release has not been made in some time, so this release is mostly to keep releases up to date with code in the repository.

Note this should address an issue regarding batch load date filtering you may have encountered with the script Intersection Report were you to use the prior release JAR with it.

Full Changelog: v1.22.2...v1.23.0

Version 1.22.2

Fixed issue with the ZipHelper class creating incorrect zip entries in some instances due to missing file separator.

Full Changelog: v1.22.1...v1.22.2

Version 1.22.0

Maintenance release, no major changes made

Version 1.21.0

Main loop in BulkRedactor now uses a parallel stream to provide configurable concurrency.

Version 1.20.0

• Added method FormatUtility.escapeTagForSearch which helps escape a tag name for use in a Nuix query string.
• Added setting to AnnotationRepository that can enable always creating tag on import and not only when there are matching items to apply the tag to.
• Added optional logic to ProfileDigester allowing it to attempt to use existing digest values already written to a custom metadata field on an item in place of generating a new digest from the specified metadata profile. Care should be taken when using this setting as the logic only checks that the value is present, a String and not empty, but will not know what profile was used to generate the existing value!

Version 1.19.0

RegexScanner Updates

Can now configure whether pattern matching uses Pattern.MULTILINE flag via method RegexScanner.setMultiline(boolean). Default is false, as was the case before this was added. When set to true, multi-line regular expressions will be possible against text which has multiple lines.

Can now configure whether pattern matching uses Pattern.DOTALL flag via method RegexScanner.setDotal(boolean). Default value is false (as was the case before this was added). When set to true, the . (dot) character matches any character, including a line terminator.