{"id":18433,"date":"2023-02-21T15:05:46","date_gmt":"2023-02-21T20:05:46","guid":{"rendered":"https:\/\/certek.com\/kb4\/?p=18433"},"modified":"2023-10-02T09:42:21","modified_gmt":"2023-10-02T13:42:21","slug":"item-alternate-codes","status":"publish","type":"ht_kb","link":"https:\/\/certek.com\/kb4\/knowledge-base\/item-alternate-codes\/","title":{"rendered":"Import Item Alternate Codes"},"content":{"rendered":"\n<p class=\"wp-block-ht-blocks-messages wp-block-hb-message wp-block-hb-message--withicon is-style-danger\">IMPORTANT:&nbsp;Before importing any files into Artisan\u2019s database, MAKE A BACKUP of your data in case you did not import what you wanted and want to go back to a previous point in time. Click&nbsp;<strong><a href=\"https:\/\/certek.com\/kb4\/back-up-your-data-options\/\" target=\"_blank\" rel=\"noreferrer noopener\">here<\/a><\/strong>&nbsp;to learn about your backup options.&nbsp;<\/p>\n\n\n\n<p>Artisan allows importing files for different types of records. Only RAW imports can be done. That is, the user needs to compile a file to meet a specific format we will describe below in this article. Once the file is in one of the recommended formats, then we can use the Raw Import Utility in Artisan to add records to the current database.<\/p>\n<h3><strong>What Are Item Alternate Codes?<\/strong><\/h3>\n<p>Item alternate codes are useful for products that have more than one UPC code. You can add these manually within the item record, or as we&#8217;re doing in this article, by importing them. Once they&#8217;re added, they&#8217;ll be located in the &#8220;Codes and Measures&#8221; tab. Whenever any of the alternate codes are scanned, Artisan will recognize this as belonging to the item record.<\/p>\n<hr \/>\n<h3><a id=\"steps-to-follow\"><\/a>Steps to Follow<\/h3>\n<p>1. Like with any other records we will be importing, the first thing we need to do is look at the proper column headers for this type of record. Artisan needs a specific code to identify the data being imported \u2013 and those codes are given to you in this article. If you import a file with column header names different from what is given in this article, Artisan will ignore the data under that column entirely. To avoid this from happening, make sure you use the column headers appropriately.<\/p>\n<p>2. Then, we work on the file to meet one of these formats. You can use any spreadsheet program \u2013 common programs are Microsoft Excel or Google Sheets. Make sure you save the file as one of these formats:<\/p>\n<ul>\n<li>Tex (Tab Delimited) *.txt<\/li>\n<li>CSV\u00a0(Comma Separated Values) *.CSV<\/li>\n<li>Database file *dbf<\/li>\n<li>Tagged Text *.ttx<\/li>\n<li>Excel Workbook *xls<\/li>\n<li>Excel Workbook *xlsx<\/li>\n<\/ul>\n<p>3. Lastly, we import the file using Artisan\u2019s Raw Import tool located at the top menu, \u201c<strong>File<\/strong>,\u201d and \u201c<strong>Import<\/strong>.\u201d<\/p>\n<p><a class=\"oceanwp-lightbox\" title=\"\" href=\"https:\/\/certek.com\/kb4\/wp-content\/uploads\/2015\/04\/2021-12-07_09h27_42.png\" data-rel=\"lightbox-image-bGlnaHRib3gtaW1hZ2UtYkdsbmFIUmliM2d0YVcxaFoyVXRNUT09\" data-rl_title=\"\" data-rl_caption=\"\"><img loading=\"lazy\" decoding=\"async\" class=\"size-full wp-image-8792 aligncenter\" src=\"https:\/\/certek.com\/kb4\/wp-content\/uploads\/2015\/04\/2021-12-07_09h27_42.png\" alt=\"\" width=\"200\" height=\"203\" \/><\/a><\/p>\n<hr \/>\n<h3><a id=\"import-codes-and-headers\"><\/a>Import Codes and Headers<\/h3>\n<table style=\"width: 100%; height: 116px;\">\n<tbody>\n<tr style=\"height: 29px;\">\n<td style=\"height: 29px;\"><strong>Artisan Excel Header<\/strong><\/td>\n<td style=\"height: 29px;\"><strong>Artisan Field Name<\/strong><\/td>\n<\/tr>\n<tr style=\"height: 29px;\">\n<td style=\"height: 29px;\">ALTCODE<\/td>\n<td style=\"height: 29px;\">Alternate Code<\/td>\n<\/tr>\n<tr style=\"height: 29px;\">\n<td style=\"height: 29px;\">BASEITEM<\/td>\n<td style=\"height: 29px;\">Item Record<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<hr \/>\n<h3><a id=\"how-to-import\"><\/a>How to Import<\/h3>\n<p><strong>IMPORTANT:<\/strong>\u00a0<strong>Before importing any files into Artisan\u2019s database, MAKE A BACKUP of your data in case you do not import what you wanted and want to go back to a previous point in time.<\/strong><\/p>\n<p>\u2013 Now that the file has been formatted according to the instructions above, you should have the file saved on the computer where you plan to do the import on.<\/p>\n<p>\u2013 The file must be closed when importing in Artisan. It cannot be open in another program.<\/p>\n<p>\u2013 The file must be saved using one of these file formats:<\/p>\n<ul>\n<li>Tex (Tab Delimited) *.txt<\/li>\n<li>CSV\u00a0(Comma Separated Values) *.CSV<\/li>\n<li>Database file *dbf<\/li>\n<li>Tagged Text *.ttx<\/li>\n<li>Excel Workbook *xls<\/li>\n<li>Excel Workbook *xlsx<\/li>\n<\/ul>\n<p><strong>1.<\/strong>\u00a0Go to Artisan and select \u201c<strong>File<\/strong>,\u201d and \u201c<strong>Import<\/strong>.\u201d<\/p>\n<p>Choose the type of record you are importing.<\/p>\n<p><a class=\"oceanwp-lightbox\" title=\"\" href=\"https:\/\/certek.com\/kb4\/wp-content\/uploads\/2015\/04\/2021-12-07_09h31_26.png\" data-rel=\"lightbox-image-bGlnaHRib3gtaW1hZ2UtYkdsbmFIUmliM2d0YVcxaFoyVXRNVGs9\" data-rl_title=\"\" data-rl_caption=\"\"><img loading=\"lazy\" decoding=\"async\" class=\" wp-image-8796 aligncenter\" src=\"https:\/\/certek.com\/kb4\/wp-content\/uploads\/2015\/04\/2021-12-07_09h31_26.png\" sizes=\"auto, (max-width: 653px) 100vw, 653px\" srcset=\"https:\/\/certek.com\/kb4\/wp-content\/uploads\/2015\/04\/2021-12-07_09h31_26.png 1008w, https:\/\/certek.com\/kb4\/wp-content\/uploads\/2015\/04\/2021-12-07_09h31_26-300x205.png 300w, https:\/\/certek.com\/kb4\/wp-content\/uploads\/2015\/04\/2021-12-07_09h31_26-768x525.png 768w\" alt=\"\" width=\"653\" height=\"446\" \/><\/a><\/p>\n<p><strong>2<\/strong>. Choose the file that has been created and select \u201c<strong>Open<\/strong>.\u201d<\/p>\n<p><a class=\"oceanwp-lightbox\" title=\"\" href=\"https:\/\/certek.com\/kb4\/wp-content\/uploads\/2015\/04\/ChooseFileImport.png\" data-rel=\"lightbox-image-bGlnaHRib3gtaW1hZ2UtYkdsbmFIUmliM2d0YVcxaFoyVXRNakE9\" data-rl_title=\"\" data-rl_caption=\"\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-2983\" src=\"https:\/\/certek.com\/kb4\/wp-content\/uploads\/2015\/04\/ChooseFileImport.png\" sizes=\"auto, (max-width: 689px) 100vw, 689px\" srcset=\"https:\/\/certek.com\/kb4\/wp-content\/uploads\/2015\/04\/ChooseFileImport.png 689w, https:\/\/certek.com\/kb4\/wp-content\/uploads\/2015\/04\/ChooseFileImport-300x179.png 300w\" alt=\"\" width=\"689\" height=\"410\" \/><\/a><\/p>\n<p>Once \u201c<strong>Open<\/strong>\u201d is selected, Artisan will start importing the items and a progress bar will be displayed.<\/p>\n<p><a class=\"oceanwp-lightbox\" title=\"\" href=\"https:\/\/certek.com\/kb4\/wp-content\/uploads\/2015\/04\/ImportProgressBar.png\" data-rel=\"lightbox-image-bGlnaHRib3gtaW1hZ2UtYkdsbmFIUmliM2d0YVcxaFoyVXRNakU9\" data-rl_title=\"\" data-rl_caption=\"\"><img loading=\"lazy\" decoding=\"async\" class=\" size-full wp-image-2984 aligncenter\" src=\"https:\/\/certek.com\/kb4\/wp-content\/uploads\/2015\/04\/ImportProgressBar.png\" sizes=\"auto, (max-width: 320px) 100vw, 320px\" srcset=\"https:\/\/certek.com\/kb4\/wp-content\/uploads\/2015\/04\/ImportProgressBar.png 320w, https:\/\/certek.com\/kb4\/wp-content\/uploads\/2015\/04\/ImportProgressBar-300x173.png 300w\" alt=\"\" width=\"320\" height=\"185\" \/><\/a><\/p>\n<p><strong>3.<\/strong>\u00a0If the file was correctly formatted, a confirmation message will be shown next with the number of records \u201c<strong>updated<\/strong>\u201d\u00a0and new records \u201c<strong>added<\/strong>.\u201d<\/p>\n<p><a class=\"oceanwp-lightbox\" title=\"\" href=\"https:\/\/certek.com\/kb4\/wp-content\/uploads\/2015\/04\/ImportSucess.png\" data-rel=\"lightbox-image-bGlnaHRib3gtaW1hZ2UtYkdsbmFIUmliM2d0YVcxaFoyVXRNakk9\" data-rl_title=\"\" data-rl_caption=\"\"><img loading=\"lazy\" decoding=\"async\" class=\" size-full wp-image-2985 aligncenter\" src=\"https:\/\/certek.com\/kb4\/wp-content\/uploads\/2015\/04\/ImportSucess.png\" sizes=\"auto, (max-width: 310px) 100vw, 310px\" srcset=\"https:\/\/certek.com\/kb4\/wp-content\/uploads\/2015\/04\/ImportSucess.png 310w, https:\/\/certek.com\/kb4\/wp-content\/uploads\/2015\/04\/ImportSucess-300x152.png 300w\" alt=\"\" width=\"310\" height=\"157\" \/><\/a><\/p>\n<hr \/>\n<h3><a id=\"revise-imported-records\"><\/a>Optional: Revise Imported Records (Recommended)<\/h3>\n<p>This step is not required as part of the import but ensures everything went well with your files and allows you to reverse the action if needed.<\/p>\n<p>It is good practice to check that the records were imported as intended. Artisan offers its user the ability to search for these records through a \u201c<strong>Power Search<\/strong>.\u201d<\/p>\n<p><strong>*<\/strong>If you are not familiar with the Power Search feature in Artisan, learn more about it in\u00a0<strong><a title=\"Using the Power Search Feature\" href=\"https:\/\/certek.com\/kb4\/using-the-power-search-feature\/\">this article<\/a><\/strong>.<\/p>\n<p><strong>1<\/strong>. In Artisan, go to any type of records you\u2019d like to search. In this example, we will use Item Records, but other records work in a similar way, just with different fields.<\/p>\n<p>Select the Vendor to narrow down the list of items. In this case, PAP \u2013 Papyrus is selected.<\/p>\n<p>Notice that there are 2,115 records for this vendor before importing any item.<\/p>\n<p>Under the Item Records Screen, select the\u00a0<strong>Power Search<\/strong>\u00a0tool on the right side of the window.<\/p>\n<p><a class=\"oceanwp-lightbox\" title=\"\" href=\"https:\/\/certek.com\/kb4\/wp-content\/uploads\/2015\/04\/2015-05-05_10h43_44.png\" data-rel=\"lightbox-image-bGlnaHRib3gtaW1hZ2UtMjM=\" data-rl_title=\"\" data-rl_caption=\"\"><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-3156\" src=\"https:\/\/certek.com\/kb4\/wp-content\/uploads\/2015\/04\/2015-05-05_10h43_44.png\" sizes=\"auto, (max-width: 600px) 100vw, 600px\" srcset=\"https:\/\/certek.com\/kb4\/wp-content\/uploads\/2015\/04\/2015-05-05_10h43_44.png 800w, https:\/\/certek.com\/kb4\/wp-content\/uploads\/2015\/04\/2015-05-05_10h43_44-300x211.png 300w\" alt=\"\" width=\"600\" height=\"422\" \/><\/a><\/p>\n<p><strong>2.<\/strong>\u00a0\u00a0After we imported our items, we received the following confirmation message (see image below)<\/p>\n<ul>\n<li>400 records added<\/li>\n<li>187 records updated<\/li>\n<\/ul>\n<p><a class=\"oceanwp-lightbox\" title=\"\" href=\"https:\/\/certek.com\/kb4\/wp-content\/uploads\/2015\/04\/Import-confirmation.png\" data-rel=\"lightbox-image-bGlnaHRib3gtaW1hZ2UtMjQ=\" data-rl_title=\"\" data-rl_caption=\"\"><img loading=\"lazy\" decoding=\"async\" class=\" size-full wp-image-3157 aligncenter\" src=\"https:\/\/certek.com\/kb4\/wp-content\/uploads\/2015\/04\/Import-confirmation.png\" sizes=\"auto, (max-width: 310px) 100vw, 310px\" srcset=\"https:\/\/certek.com\/kb4\/wp-content\/uploads\/2015\/04\/Import-confirmation.png 310w, https:\/\/certek.com\/kb4\/wp-content\/uploads\/2015\/04\/Import-confirmation-300x177.png 300w\" alt=\"\" width=\"310\" height=\"183\" \/><\/a><\/p>\n<p><strong>3.<\/strong>\u00a0Using the Power Search tool, follow the image below to query the database through filters. First, we will look at the new items added.<\/p>\n<p>Notice we chose \u201c<strong>Created On<\/strong>\u201d and picked the date. We can see that it shows 400 items that were created.<\/p>\n<p>You have the ability to use whatever field you want to query the database. You could use \u201c<strong>Created By,<\/strong>\u201d for example, and choose a user to see who added the items. Or, you can add even more filters to have a combination. Feel free to experiment with other fields to see the information retrieved.<\/p>\n<p><a class=\"oceanwp-lightbox\" title=\"\" href=\"https:\/\/certek.com\/kb4\/wp-content\/uploads\/2023\/02\/import.png\" data-rel=\"lightbox-image-7\" data-rl_title=\"\" data-rl_caption=\"\"><img loading=\"lazy\" decoding=\"async\" class=\"alignnone size-full wp-image-18479\" src=\"https:\/\/certek.com\/kb4\/wp-content\/uploads\/2023\/02\/import.png\" sizes=\"auto, (max-width: 900px) 100vw, 900px\" srcset=\"https:\/\/certek.com\/kb4\/wp-content\/uploads\/2023\/02\/import.png 900w, https:\/\/certek.com\/kb4\/wp-content\/uploads\/2023\/02\/import-300x187.png 300w, https:\/\/certek.com\/kb4\/wp-content\/uploads\/2023\/02\/import-768x480.png 768w\" alt=\"\" width=\"900\" height=\"562\" \/><\/a><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Artisan allows importing files for different types of records. Only RAW imports can be done. That is, the user needs to compile a file to meet a specific format we will describe below in this article. Once the file is in one of the recommended formats, then we can use&#8230;<\/p>\n","protected":false},"author":17,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"_eb_attr":"","_monsterinsights_skip_tracking":false,"footnotes":"","_members_access_role":[],"_members_access_error":""},"ht-kb-category":[324],"ht-kb-tag":[],"class_list":["post-18433","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-item-records"],"_links":{"self":[{"href":"https:\/\/certek.com\/kb4\/wp-json\/wp\/v2\/ht-kb\/18433","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/certek.com\/kb4\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/certek.com\/kb4\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/certek.com\/kb4\/wp-json\/wp\/v2\/users\/17"}],"replies":[{"embeddable":true,"href":"https:\/\/certek.com\/kb4\/wp-json\/wp\/v2\/comments?post=18433"}],"version-history":[{"count":12,"href":"https:\/\/certek.com\/kb4\/wp-json\/wp\/v2\/ht-kb\/18433\/revisions"}],"predecessor-version":[{"id":20785,"href":"https:\/\/certek.com\/kb4\/wp-json\/wp\/v2\/ht-kb\/18433\/revisions\/20785"}],"wp:attachment":[{"href":"https:\/\/certek.com\/kb4\/wp-json\/wp\/v2\/media?parent=18433"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/certek.com\/kb4\/wp-json\/wp\/v2\/ht-kb-category?post=18433"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/certek.com\/kb4\/wp-json\/wp\/v2\/ht-kb-tag?post=18433"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}