View source for Getting started - Data Import

== Summary ==
The following article explains how to create a data import template so that you are able to import information from plain text files into the system.

== What is a Template? ==
A template tells Platinum: 

* What information you want to import. 
* Which part of the system you want to import data into e.g. the "Stock File", the "Vehicle Stock File", the "Accounts Transaction File" etc.
* Where the file is that holds the data you are importing.
* Which fields within the chosen system you are importing data into e.g. "Stock Code" field, "Stock Description" field, "Account Name" etc. 

== Process ==
Go to "Data Import". 
This will take you to a screen where you can search for existing Data Import templates or create a new one.

=== Template Code ===
{{Note|text=Each template should have a unique code e.g. {{DataValue|001}} or {{DataValue|STO}} (max. 3 character).}}
* Enter a code for the template and press {{KeyPress|Enter}}.
* Type a description for the template e.g. {{DataValue|Stock File Import}}.

=== Destination ===
{{Note|text=The Destination is the file you want to import data into. [[Data Import Destinations|Click here]] to view a list of possible destinations.}}
* Press {{KeyPress|S-F2}} to view a list of destinations then press the {{KeyPress|Up}}/{{KeyPress|Down}} key to scroll through the list and press {{KeyPress|F2}} to select the desired one. 
* Alternatively type in the destination file code.

=== Source File ===
{{Note|text=The Source File is the file containing the data you wish to import. Your Source file will usually contain a series of records. A record is each line or lines of information relating to the same Stock Code, Vehicle, Account etc. The Data Import program can read most Plain Text files e.g. {{FileExt|CSV}} (Comma Separated Variable) files and {{FileExt|TXT}} (Text) files. }}
* Enter the name of, and if necessary the Path to, the file which holds the data to be imported e.g. {{FilePath|C:\STOCKFILE.CSV}}.
* If you need to find a file, press {{KeyPress|C-F1}} and search for the file using the explorer window. 

Press {{KeyPress|Enter}} to move to the template import configuration.

=== Variables ===
{{Note|text=A variable tells the system which field to look at e.g. there is a variable for the Stock Code field, the Account Code field, the Vehicle Model field etc. Each field within a Destination File, into which you can import data, has a variable. The actual variable code will vary depending on the Destination File so for further information on Variables available for each Destination File [[Category:Data_Import|click here]].}}
* Select a variable by typing in the variable number or:
** Press {{KeyPress|F1}} or {{KeyPress|S-F1}} to cycle through the possible fields you can import into in the chosen destination file.
** Alternatively press {{KeyPress|F2}} to view a list of the available fields, use the {{KeyPress|UP}}/{{KeyPress|DOWN}} key to browse the list and press {{KeyPress|F2}} to select the variable.

Press {{KeyPress|Enter}} to move to the options column.

=== Options ===
You will find some variables have various letters and numbers in brackets alongside them, these are known as {{DataPrompt|options}}. {{DataPrompt|Options}} are available when you have a choice over where the data is imported on a single variable. 
For example when importing addresses into the Account Address File, {{DataValue|LDAD}}, variable 18, Account Address, options 1-5 are available to define into which line of the address you want to import. 

=== Expression ===
The {{DataPrompt|Expression}} is how you tell the system whereabouts in the source file it will find the required data and how it should be handled. 
The first part of the expression defines whether the imported data is text or numeric. {{DataValue|ST}} denotes that the data is to be text or a combination of text and numeric characters. {{DataValue|NU}} denotes that the imported data will be just numeric. It is important to specify the correct data type when importing to avoid errors - if you are unsure of what the type should be, the {{DataPrompt|Type}} field will show a {{DataValue|T}} for text or {{DataValue|N}} for numeric.

The most common files you will import from are of a delimited format where each value is separated using a delimiter character. The most commonly occurring of these is a {{FileExt|CSV}} file.

To import text values from a {{FileExt|CSV}} file, the following expression will be used :

{{Example|title=e.g.|text=text=ST{1(,)} }} 

This example will import the text string from column 1 of the source file where {{DataValue|,}} is the delimiter character.

To import numeric values from a {{FileExt|CSV}} file, the following expression will be used :

{{Example|title=e.g.|text=NU{2(,)} }} 

This example will import the numeric string from column 2 of the source file where {{DataValue|,}} is the delimiter character.

== More Information ==
Do be careful to check your template before you use it. It is worth taking ten lines out of your source file, creating a separate file and using this to check that everything is going to the correct place. It can save you an awful lot of bother if your template is not quite right. 

== See also ==
* [[Report Generator - Getting Started]]
* [[How do I export a Data Import template?]]
* [[How do I import a Data Import template?]]
* [[Useful Keys]]

{{KB_Tags|Get, start, Getting, Started, Getting Started, DATA, IMPORT, CREATE, CREATING}}
{{Guide}} {{KB_IM}} {{GStart}}