XINA Import Helper

XINA Import Helper is a utility for importinggenerating the XINA API actions as JSON files.files for an archive directory. The following XINA action files will be generated:

• Cancel any existing task(s) for the archive
• Delete the archive if it already exists in XINA
• Import the file archive
• Run the mining task on the archive to extract the data

The output files can then be imported into XINA using XINA Import. This application is distributed as a Java jar file and requires Java 17 or greater to run. The recommended OpenJDK build is available here.

Latest Version

XINA Import Helper 11.2.3

Download

Windows

 java -jar "path to xina_import.xina-import-helper.jar" ^
      [additional arguments...]

MacOS, Linux

 java -jar "path to xina_import.xina-import-helper.jar" \
      [additional arguments...]

Argument	Info	Default
-host <hostname>	the XINA Tunnel host	"localhost"
-post <port>	the XINA Tunnel port	41746
-okmove <path>	if set, move files to path to after successful import	none (files are not moved)
-oktrash	if set, move files to OS trash after successful import	false
-okdelete	if set, permanently delete files after successful import	false
-ermove	if set, move files to path to after failed import	none (errors stop import)
-dir <path>	path to directory containing files to import
-watch <path>	path to directory to watch for files to import
-recursive	if true in dir or watch mode, searches directory recursively for JSON files	false

XINA Import has three modes of operation:

File List

JSON files can be listed explicitly. They will be imported in the specified order.

 java -jar "path to xina_import.jar" \
      "path to JSON file" \
      "path to JSON file"...

Directory

If the -dir argument is used, XINA Import will attempt to import all *.json files in the specified directory in alphanumeric order.

Note: the directory is now queried after each imported file, so at one of -okmove, -oktrash, or -okdelete must be specified in this mode, or the same file would be imported repeatedly in an infinite loop.

 java -jar "path to xina_import.jar" \
      -dir "path to directory" \
      -okmove "path to different directory"

Watch

If the -watch argument is used, XINA Import will attempt to import all *.json files in the specified directory in alphanumeric order. Once complete, the directory is watched for any new JSON files, which are imported as they become available. As with directory mode, a -ok* argument is required to prevent the same file from being imported repeatedly.

 java -jar "path to xina_import.jar" \
      -watch "path to directory" \
      -okmove "path to different directory"

Previous Versions

XINA Import 10.1.0

Download

Windows

 java -jar "path to xina_import.jar" ^
      [additional arguments...]

MacOS, Linux

 java -jar "path to xina_import.jar" \
      [additional arguments...]

Argument	Info	Default
-host <hostname>	the XINA Tunnel host	"localhost"
-post <port>	the XINA Tunnel port	41746
-okmove <path>	if set, move files to path to after successful import	none (files are not moved)
-oktrash	if set, move files to OS trash after successful import	false
-okdelete	if set, permanently delete files after successful import	false
-ermove	if set, move files to path to after failed import	none (errors stop import)
-dir <path>	path to directory containing files to import
-watch <path>	path to directory to watch for files to import
-recursive	if true in dir or watch mode, searches directory recursively for JSON files	false

XINA Import has three modes of operation:

File List

JSON files can be listed explicitly. They will be imported in the specified order.

 java -jar "path to xina_import.jar" \
      "path to JSON file" \
      "path to JSON file"...

Directory

If the -dir argument is used, XINA Import will attempt to import all *.json files in the specified directory in alphanumeric order.

Note: the directory is now queried after each imported file, so at one of -okmove, -oktrash, or -okdelete must be specified in this mode, or the same file would be imported repeatedly in an infinite loop.

 java -jar "path to xina_import.jar" \
      -dir "path to directory" \
      -okmove "path to different directory"

Watch

If the -watch argument is used, XINA Import will attempt to import all *.json files in the specified directory in alphanumeric order. Once complete, the directory is watched for any new JSON files, which are imported as they become available. As with directory mode, a -ok* argument is required to prevent the same file from being imported repeatedly.

 java -jar "path to xina_import.jar" \
      -watch "path to directory" \
      -okmove "path to different directory"

XINA Import 9.2.0

Download

Usage

Windows

 java -Dlog4j.configurationFile="path to log4j2.xml" ^
      -jar "path to xina_import.jar" ^
      [additional arguments...]

MacOS, Linux

 java -Dlog4j.configurationFile="path to log4j2.xml" \
      -jar "path to xina_import.jar" \
      [additional arguments...]

Argument	Info	Default
-host <hostname>	the XINA Tunnel host	"localhost"
-post <port>	the XINA Tunnel port	41746
-movejson <path>	directory to move JSON files to after import	none (files are not moved)
-movefile <path>	directory to move other files to after import	none (files are not moved)
-deljson	if set, permanently delete JSON files after import	false
-delfile	if set, permanently delete other files after import	false
-dir <path>	path to directory containing files to import
-watch <path>	path to directory to watch for files to import
-recursive	if true in dir or watch mode, searches directory recursively for JSON files	false

XINA Import has three modes of operation:

File List

JSON files can be listed explicitly. They will be imported in the specified order.

 java -jar "path to xina_import.jar" \
      "path to JSON file" \
      "path to JSON file"...

Directory

If the -dir argument is used, XINA Import will attempt to import all *.json files in the specified directory in alphabetical order. It is recommended to include -movejson or -deljson to track progress, in case the import is interrupted.

 java -jar "path to xina_import.jar" \
      -dir "path to directory" \
      -movejson "path to different directory"

Watch

If the -watch argument is used, XINA Import will attempt to import all *.json files in the specified directory in alphabetical order. Once complete, the directory is watched for any new JSON files, which are imported as they become available. It is required to include -movejson or -deljson, as otherwise files would be continuously re-imported.

 java -jar "path to xina_import.jar" \
      -watch "path to directory" \
      -movejson "path to different directory"