Differences

This shows you the differences between two versions of the page.

--- concepts:scan-file [2018/03/19 02:52] – created Scott Cunliffe
+++ concepts:scan-file [2025/01/21 22:07] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
-====== Scan File ======
+====== Scan-File ======
-A scan file is a listing of volume ID's that, through TapeTrack parsing, is converted in to a Scan-map of fully qualified barcodes for input into command line processes such as repository reconciliation.
+A Scan-File is a listing of [[:object:volume|Volume-ID's]] that, through TapeTrack parsing, is converted in to a [[:concepts:scan-map|Scan-map]] of [[concepts:qualified_barcode|Fully Qualified Barcodes]] for input into [[cli:introduction|Command Line processes]].
+The TapeTrack Scan-File Format allows you to specify lists of TapeTrack compatible Barcodes, along with comments and Barcode defaults.
+[[variable:start|Environmental Variables]] will also be resolved before processing any [[concepts:barcode|Barcodes]] defaults or [[object:volume|Volume]] [[concepts:barcode|Barcodes]].
+The syntax supports:
+  * [[concepts:barcode|Barcodes]]: that are to be parsed according to TapeTrack [[subsystem:barcode|Barcode Logic]].
+  * [[object:customer|Customer-ID]]/[[object:media|Media-ID]] defaults: that set the [[object:customer|Customer-ID]] and/or [[object:media|Media-ID]] where those values can not be determined by TapeTrack [[subsystem:barcode|Barcode Parsing]].
+  * Comments: that are to be ignored by any processing logic (any line starting with a #).
+===== Scan-File =====
+Scan files can either be [[:object:volume|Volume-ID's]] ready to process or passed in via a definition file (.ttidef) that translates an input file to extract the [[:object:volume|Volume-ID's]].
+==== Direct Input ====
-==== Scan File ====
 {{reports:reports_tmss10reconcile_tapemaster_scanfile.png}}
+==== Translated Input File ====
+Instead of passing a data file directly to the TapeTrack process as a scan file, a definition file is specified as the Scan file to interpret the input file for processing.
+=== Input File - input.csv ===
+<code>
+TSMLIB_1,718315,Private,LG1SACTSM12,Data,1,058,LTO
+TSMLIB_1,718868,Private,LG1SACTSM12,Data,1,028,LTO
+TSMLIB_1,721008,Private,LG1SACTSM12,,1,083,LTO
+TSMLIB_1,721264,Private,LG1SACTSM12,Data,1,036,LTO
+TSMLIB_1,722685,Private,LG1SACTSM12,Data,1,052,LTO
+TSMLIB_1,722723,Private,LG1SACTSM12,,1,079,LTO
+TSMLIB_1,724335,Private,LG1SACTSM12,Data,1,066,LTO
+TSMLIB_1,724525,Private	LG1SACTSM12,,1,082,LTO
+</code>
+=== Definition File ===
+<code>
+# Set the input file
+#
+SetFile("input.csv");
+#
+# Set the Customer-ID and Media-ID
+#
+SetLiteral(CUSTOMER, "US01");
+SetLiteral(MEDIA, "LTO");
+#
+# Set the delimiter to a CSV
+#
+SetCSVDelimiter(",");
+#
+# Extract the Volume-ID from the 2nd column
+#
+Extract(VOLUME, 2, 8, 0);
+#
+# Add the suffix to the Volume-ID
+#
+AddTranslation(VOLUME, "L?????", "*L5");
+</code>