Program Overview: Visual Streamline FAQ How does the program Map Import, located in: Inventory > Global Changes, work? This program enables users the flexibility to use their own excel spreadsheet, and map the excel columns to the software. This program replaces the Export Template program that required users to use a predefined template. The new Product Import Program can be used to do the following: Import NEW inventory items Modify existing inventory items Import new Supplier Info records Modify existing Supplier Info records Due to the technical setup required on site, and the flexibility of this program, training is recommended. If you are interested in proceeding, please contact support to arrange a training date and time. Page 1 of 10 Created Document Name Last Updated 17-Mar-2010 R:\WP6DOC\SISL\SUPPORT\FAQ Attachments\Map Product Import.doc 21-Apr-2015
Program Functionality: Visual Streamline FAQ The new Product Import Program can be called from: Inventory > Master Files > Import Products. Or if you are not able to find it in this location, it can also be called from: Inventory Global Changes depending on the build of the software that you are currently running. Go to Inventory > Master files > Import Products Select the option labeled Map Import Page 2 of 10
Click the option for New and the system will display a screen similar to the one above, which will be blank. Mapping Desc - Enter the name of the map in this field Mapping Type - If you are updating the product file, select Products, if you are updating the supplier file within a product, select supplier. Import File This uses a UNC naming format. You need to export your excel spreadsheet into a text file. To do this, open the excel file, and click File > Save As. Select the file type.txt this will create the importable tab delimited text file. In version 709.0000 or higher you are able to park in the Import File field, and hit F5 to locate the file (the browse will start in the directory defined in the Mapping Defaults), and the system will automatically convert the path to a UNC name for you. ***This utilizes a 3rd party tool for conversion and is not guaranteed to work at all sites. Therefore, if you are on a prior version of the software, or if the conversion program does not work on your site and it tells you that the file path must be UNC name, then you are not able to use the F5 locate, and you must manually enter the path, and it must be entered as a UNC name. The UNC name can be selected by pressing F5 and then instead of selecting drive letters look for My Network Places and go to the appropriate server and find the file under the corresponding server for that drive. For example, in my file above if you look at the print screen, I have \\sislrdp01\streamline\ this is drive T:\ but I have simply replaced T:\ with the server name. At times your users might still have a problem due to security reasons. If this happens, you must ensure that the folder you are accessing is accessible in the UNC location; therefore the file needs to be copied in there first. For further assistance on UNC formats, please see your tech department for assistance. Max Columns the max number of columns does not need to be equal to the number of columns in the spreadsheet. However if you receive errors when you import, then it is best to remove all extra columns and only include the columns that you are importing as sometimes the extra columns will cause the import to fail. It is therefore a recommendation to work with a clean file that does not contain any extra columns that are not mapped, but it is not a requirement. Field Delimiter This should be set to TAB, as we create a tab delimited text file. Row Delimiter Should be CR/LF Page 3 of 10
Database Column Name Once you are finished with the header part of the screen, you can begin to define the map fields. I have shown a sample of my text file which contains the following information in the order listed: Product ID, Product line, Description, Average Lead Time. The purpose of this file, is to update the average lead time on my products. However since I also have the Description as a field on the spreadsheet, and since that field is before the field that is required, it must be defined in my map details. Fields to the left can t be ignored; however fields to the right can be ignored. So basically what this means is that if you want to import the 4 th column, all 3 columns to the left of the 4 th column must also be imported as well. Simply click on the down arrow box to select the column that you want to map, and assign the correct position for that field from the file. If you notice I am mapping Product ID as column 1, product line as column 2, description as column 3 and finally the Average lead time as column 4. This corresponds with my text file above. There are reserved characters that can t be used. The reserve characters are: Comma, Asterisk, and Question Mark. If any of these characters are found in the text file, when you attempt to import, you will receive an error indicating bad character. Once you are finished, click on SAVE to save the map. The system will then take you back to the Import Mapping screen, and you will now see the map that you have created. Before you import the map, you may want to change the DEFAULTS to reflect the location of the import file, if the location of the file is to become the default location. Click on the Defaults button. The system will display the screen shown below. Enter the same path using the UNC name as you did on the map details, then click SAVE. Page 4 of 10
The system will take you back to the Import Mapping screen, where you are now ready to import. Click on the Import button. The screen below will be displayed, asking you to confirm the import. Click YES. At this point if the import is not successful for whatever reasons, there will be a db error displayed. These errors are coming directly from the data source, and need to be investigated by the user performing the import. Page 5 of 10
Once the import is finished, it will create a record in the Import Log file as shown in the screenshot below. Note the updated status check box, is not checked at this point. It has simply brought the data from the file into a file within the software. You need to update the import log file that has been created, into the actual product master file. Click on the Details button. The system will then display the following screen. This screen will list all the items that are on the file that will be imported. There is a record type located on the right hand side of the screen, that indicates whether or not the item is a new record or if updates are being made to existing records. Proceed to update, by clicking on the Update button. Page 6 of 10
The confirmation screen shown below will be displayed. Click Yes to proceed. The system will then update the flag on the right hand side Updated you will now see a check mark next to each of the items to indicate that the items have been updated into the master files, and the changes have been made Page 7 of 10
Note the average lead time field has now been updated with the value of 11 based on our original file. Page 8 of 10
Trouble Shooting: Visual Streamline FAQ Due to the flexibility this program provides, there are many procedural things that might occur in the data and setup that can cause different error messages upon importing. A list of the most common errors and suggestions on what to look for is included below: Issue # 1: Unable to add the path/location, it keeps telling me that the path needs to be a UNC format. See below for detailed instructions on how to setup UNC. Here is how to determine a UNC location: 1.Open a windows explorer from Start -> MyComputer -> Right Click -> Explore 2.Locate(single click on it) the mapped folder on the folder view. In this example it reads Streamline on sql2. Sql2 here is the starting(server name) part of the UNC name. Streamline is the shared folder. 3.Put 2 backslashes followed by server name in the address of windows explorer and click Go button on the right end of the address bar. (\\sql2) 4. In the list of files part of the windows explorer you should notice shared folder Streamline. Double click on it and continue double clicking (selecting) folders until you find the folder of the file. 5. Copy/paste the location from address bar into UNC location in the Inventory import program setup. Page 9 of 10
Issue # 2: When importing I am getting a db error that says check bad character Check your file for Commas, Asterisks, and Question Marks in the product id, description 1, and description 2 fields. If used, this will result in bad character on the import. Issue # 3: I am getting a db error when I import that says check max number of columns and ensure that your file is properly mapped to each database field. a) You do not have the same number of columns in your file, as you have in your map. b) You might have exceeded a field s number of allowable characters. For example, the description field might be too long. Issue # 4: I am getting a db error that says: Cannot do a bulk load because file can t be open or access is denied a) Ensure that the user that is logged into windows has access to the shared folder. Users performing imports need to have both read and write authority to the shared folder. Please see your tech support for further support regarding access and authority to files on the server. b) You have inserted headers into the file, there can t be any headers, so if they exist, they must be deleted. c) You have a different location entered into the Global DEFAULTS tab. Ensure that DEFAULTS points to the same location as your file in the map details. (this is no longer the case, as the DEFAULT is only used to initiate a browse and to store temporary files). Issue # 5 I am seeing odd data that has been imported into certain fields, this data that I am seeing was not on my excel, or text file. Where did it come from? Excel exports any columns that have seen any modifications, even though they are left blank eventually. For example, if your map is defined as 4 columns, anything found after the 4 th column has been imported as data content of the 4 th column, into whatever field the 4 th column is mapped to. Issue #6 I am receiving a DB error that says Error converting data type varchar to numeric Check your Excel file for odd characters in a field that should be numeric. For example, commas in the price field or another reason could be a blank mandatory field. Another reason that this error could be coming up is extra tabs in the TEXT file. Review your text file and delete any extra tabs found. Issue #7 I am receiving a DB error that says Invalid Rowset # Specified. You have two columns listed/mapped in the wrong order. Example: Prod ID and Part Number fields mixed up. Issue #8 I am receiving an error that says Please check import files for duplicate entries and missing data Check for Brackets that are used in the part number filed. Issue # 9 I am receiving an error that says trying to insert duplicate record in table products but this error only comes up when I attempt to UPLOAD the file to streamline, not when I import. Check your system to see if it contains lower case product codes. If so, this will result in this error. Use the program to change inventory master files if you find lower case products. Page 10 of 10