Differences

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

--- engine:import:addtranslation [2019/02/27 01:26] – Scott Cunliffe
+++ engine:import:addtranslation [2025/01/21 22:07] (current) – external edit 127.0.0.1
@@ Line 1: / Line 1: @@
-addtranslation
+====== AddTranslation ======
-==== AddTranslation ====
 Translate the value of a field based upon the current value of the field.
-==== Phase ====
+===== Phase =====
 This instruction is used by the TapeTrack Import Engine.
-==== Syntax ====
+===== Syntax =====
-**AddTranslation**//(field, filter, translation);//
-//string field;//
+''AddTranslation(field, filter, translation);''
-//string filter;//
-//string translation;//
+^ Variable ^ Type ^ Description ^ Min Length ^ Max Length ^
+|field| String | The field to be translated.| 1|128|
+|filter| String | A filter to compare against the current field value.|1|256|
+|translation| String | The new value of the field. This can either be a new literal value, or the original value with a prefix or suffix.|1|256|
 <notetip>
@@ Line 19: / Line 20: @@
 record.</note>
 <notetip>
-Although an AddTranslation2 is functionally equivalent to a AddTranslation with the same
+Although an [[engine:import:addtranslation2|AddTranslation2]] is functionally equivalent to a AddTranslation with the same
-field and field2 values, AddTranslation entries are processed first, and then AddTranslation2
+field and field2 values, AddTranslation entries are processed first, and then [[engine:import:addtranslation2|AddTranslation2]]
 entries are processed a 2nd time. This allows you to translate the value of the field2
 comparison field first, and then translate the value of the field based upon the translated value
@@ Line 30: / Line 31: @@
 to drop.</note>
-|field| The field to be translated.|
-|filter| A filter to compare against the current field value.|
-|translation| The new value of the field. This can either be a new literal value, or the original value with a prefix or suffix.|
-==== Example ====
-**AddTranslation: Append L3 to each VOLUME field if the value
-starts with a zero.**
-<sxh>AddTranslation(VOLUME, "0*", "*L3");</sxh>
-==== Example ====
+===== Example =====
-**AddTranslation: Truncate a VOLUME field to 6 characters when the Volume-ID starts with an A.**
+Append L3 to each VOLUME field if the value starts with a zero.
-<sxh>AddTranslation(VOLUME, "A*", "~~~~~~");</sxh>
+<code>AddTranslation(VOLUME, "0*", "*L3");</code>
+Truncate a VOLUME field to 6 characters when the Volume-ID starts with an A.
+<code>
+AddTranslation(VOLUME, "A*", "~~~~~~");
+</code>
+Remove the first 3 characters from a [[object:volume|Volume-ID]] A12345678 and add suffix L4
+<code>
+AddTranslation(VOLUME, "A*", "^^^~~~~~~L4");
+</code>
+===== See Also =====
+[[engine:import|Import Engine Functions]] \\
+[[cli:sync_fields|Sync Engine Fields]] \\
+[[cli:tmss10sync|TMSS10Sync]]
-==== Example ====
+{{tag> import_engine sync_engine}}
-**AddTranslation: Remove the first 3 characters from a Volume-ID A12345678 and add suffix L4
-<sxh>AddTranslation(VOLUME, "A*", "^^^~~~~~~L4");</sxh>