====== AddTranslationFromFile ======

Translate the value of a field based upon the current value of the field, where the current value can be loaded multiple times using the contents of a file.

===== Phase =====
This instruction is used by the TapeTrack Import Engine.

===== Syntax =====
''AddTranslationFromFile(field, filterfile, translation);''

^ Variable ^ Type ^ Description ^ Min Length ^ Max Length ^
|field| String | The field to be translated.|1|128|
|filterfile | String | A file containing filter values 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>See the notes section for [[engine/import/addtranslation|AddTranslation]].</note>

===== Example =====

Append L3 to each VOLUME field if the value matches a pattern within a record of c:\data\LTO3Volumes.txt.

<code>
AddTranslationFromFile(VOLUME, "c:\data\LTO3Volumes.txt", "*L3");
</code>

===== See Also =====

[[engine:import|Import Engine Functions]] \\
[[cli:sync_fields|Sync Engine Fields]] \\
[[cli:tmss10sync|TMSS10Sync]]

{{tag> import_engine sync_engine}}