====== Adding and Maintaining Barcode Administrations ======

Barcode Administration is used to create and maintain [[concepts:barcode_rule|Barcode Rules]]. 

Without Barcode Administration Rules set, [[concepts:barcode|Barcodes]] cannot be read while using the [[desktop:scan_window|Desktop Scanning Window]]. 

Each [[concepts:barcode_rule|Barcode Rule]] defines which characters in a given [[concepts:barcode|Barcode]] correspond with the [[object:customer|Customer-ID]], [[object:media|Media-ID]], and [[object:volume|Volume-ID]].

TapeTrack has, by default, several Barcode Rules when installed that encompass most generic barcode formats.

Any unique Barcode formats you may use in your operations may need a custom Barcode Rule to be added. 

===== Barcode Administration =====

To add, view or modify a [[concepts:barcode_rule|Barcode Rule]] open the Barcode Administration window by selecting ''Administration'' -> ''Barcode Administration''.

{{:technote:master_barcode_admin.gif}}
==== Add a Barcode Rule ====

[[concepts:barcode_rule|Barcode Rules]] are used to identify [[object:volume|Volumes]] and route them to a specific [[object:customer|Customer]] or [[object:media|Media Type]]. 

When a [[concepts:barcode|Barcode]] is scanned, [[desktop:master|TapeTrack TapeMaster]] will go through the [[concepts:barcode_rule|Barcode Rule]] List from top to bottom to identify which rule must be followed to properly identify and direct that [[object:volume|Volume]].

Once a matching Barcode Rule is found, the search of the Barcode Rule list will terminate and the matching rule will be applied.
To add a [[concepts:barcode_rule|Barcode Rule]] right-click in the Barcode Administration window, hover the cursor over ''Insert'' and select ''After'', ''Before'', or ''At End'' or press the **Insert (INS)** key on the keyboard.

{{:technote:master_barcode_admin_add_new.gif}}

Double-click the rule ID for the [[concepts:barcode_rule|Barcode Rule]] called * *New* * to set parameters.

{{:technote:master_barcode_admin_new_edit.gif}}

==== Edit Barcode Window ====

The Edit Barcode window has four parameters:
  * ''[[#General Details]]''
  * ''[[#Scope]]''
  * ''[[#Editing]]''
  * ''[[#Elements]]''

{{:master:tapemaster_barcode_edit.png}}
 
=== General Details ===

  * ''Enabled'': When set to "True," the [[concepts:barcode_rule|Barcode Rule]] is active and will be used when trying to parse [[object:volume|Volume-ID's]].  ''False'' sets the [[concepts:barcode_rule|Barcode Rule]] to inactive and is skipped when trying to parse [[object:volume|Volume-ID's]].
  * ''Barcode Description'': A brief description of the [[concepts:barcode_rule|Barcode Rule]].

=== Scope === 

  * ''Barcode Pattern'':  The Barcode Pattern uses TapeTrack Filters to define what this type of Barcode looks like. For example, "???.???.??????L[3-5]" would look for a 16 character Barcode with periods in character positions 4 and 8, an L in character position 15 and any number between 3 and 5 inclusive in character position 16. If a scanned Barcode does not meet this pattern, the next [[concepts:barcode_rule|Barcode Rule]] on the list will be referenced.
  * ''User Pattern'': Many enterprises include [[object:customer|Customer-IDs]] in their [[object:user|User-IDs]] or have various other patterns to define a [[object:user|User]]. If this is the case, use TapeTrack Filters to enter patterns of [[object:user|Users]] that should have access to this rule. Using the asterisk (*) will make this [[concepts:barcode_rule|Barcode Rule]] available to all [[object:user|Users]].
  * ''Range Start / Range End'': Setting a range will set the Scope of the [[concepts:barcode_rule|Barcode Rule]] to a specific range of numbers or letters. For example, a Range of 000500L4 to 000750L4 will only apply this [[concepts:barcode_rule|Barcode Rule]] to [[object:volume|Volumes]] 000500L4 - 000750L4. [[object:volume|Volumes]] below 000499L4 and above 000751L4 will require additional [[concepts:barcode_rule|Barcode Rules]].
  * 
**Editing**

The Editing subsection can be set to exclude or remove specific characters from a Barcode.
  * ''Edit Mask'': The Edit Mask will use 0's or 1's to determine which characters defined by the aforementioned Scope are to be used in [[desktop:master|TapeTrack TapeMaster]]. For example, if a Barcode is "BWIX.LTOX.000234L4" using the Edit Mask "000100001000000000" the "X" in character position 4 and character position 9 will be removed so that [[desktop:master|TapeTrack TapeMaster]] receives the Barcode as "BWI.LTO.000234L4".
  * ''Strip characters'': Similarly, the Strip Characters tool will remove specified characters in the Barcode. For example, if the letter is "X" is used in the Strip Characters field, Barcode "BWIX.LTOX.000234L4" will have the "X" characters removed so that the Barcode is received in [[desktop:master|TapeTrack TapeMaster]] as "BWI.LTO.000234L4".

=== Elements ===

  * ''Use substrings'': When set to ''True'' for a [[object:customer|Customer-ID]], [[object:media|Media-ID]] or [[object:volume|Volume-ID]], fields will appear to set "Substring First Character" and "Substring Last Character". These fields are used to set the range of the Barcode that corresponds with the specified Object-ID. For example, in Barcode "BWI.LTO.000234L4" the [[object:volume|Volume-ID]] begins with character 9 and ends with character 16, so the Substring First Character would be 9 and the Substring Last Character would be 16.
  * ''Literals'': When "Use Substrings" is set to "false" for a [[object:customer|Customer-ID]], [[object:media|Media-ID]] or [[object:volume|Volume-ID]], a field will appear that allows for the definition of literals. A "literal," in this context, is a [[object:customer|Customer-ID]], [[object:media|Media-ID]] or [[object:volume|Volume-ID]] that can be assumed when the above Scope is used.


<- ^ master:advanced|Advanced Usage ^ master:admin_zone|Adding and Maintaining Zones ->