Visma Produkt Import v

Transkript

1 Visma Produkt Import v Till OpenCart 1.5.x Viktigt! Detta är den *ICKE OFFICIELLA* Visma Produkt Import tillägget till OpenCart. Denna produkt är inte resultatet av ett samarbete med företaget Visma och vi är heller inte certifierad Visma partner. Inga garantier finns att denna extension fungerar med just din konfiguration av OpenCart eller Visma Administration. Det ligger på dig (användaren) att testa importverktyget innan den används i ett skarpt läge. Vi tar inte ansvar för någon ekonomisk eller annan skada i samband med användandet av Visma Produkt Import tillägget.

2 Installationsanvisningar utan vqmod 1. Packa upp mappen upload och ftp a upp undermappen admin till rooten på din OpenCart installation (inga filer kommer att skrivas över). a. REDIGERA: admin/view/template/common/header.tpl b. HITTA: <li><a href="<?php echo $backup;?>"><?php echo $text_backup;?></a></li> c. EFTER, LÄGG TILL: <?php if (@$this->language->get('text_visma_import_menu')!= NULL) {?> <li><a href="<?php echo (((HTTPS_SERVER)? HTTPS_SERVER : HTTP_SERVER). 'index.php?route=tool/vismaproductimport&token='. $this->session->data['token']);?>"><?php echo $this->language->get('text_visma_import_menu');?></a></li> <?php }?> 2. Från backend: Gå till System->Användare->Användargrupper, Ändra Top Administrator. 3. Hitta tool/vismaproductimport i båda listorna. a. Bocka i checkrutorna i båda listorna och tryck sedan på Spara. 4. KLART: Visma Produkt Import finns nu i System->Visma Produkt Import i menyn. Installationsanvisningar om vqmod är installerat 1. Packa upp mappen upload och ftp a upp hela innehållet till rooten på din OpenCart installation (inga filer kommer att skrivas över). 2. Från backend: Gå till System->Användare->Användargrupper, Ändra Top Administrators. 3. Hitta tool/ vismaproductimport i båda listorna. a. Bocka i checkrutorna i båda listorna och tryck sedan på Spara. 4. KLART: Visma Produkt Import finns nu i System-> Visma Produkt Import i menyn. Vad är vqmod? vqmod (aka Virtual Quick Mod) är ett override system för att slippa ändra i core-filer när man lägger till funktionalitet i en redan befintlig lösning. Konceptet är ganska enkelt, istället för att behöva ändra direkt i filerna så skapas ändringarna som xml sök/ersätt script-filer. Läs mer:

3 Inledning Du kanske har ett stort antal artiklar i Visma Administration 500/100/2000/Avendo som du vill föra över till OpenCart? Ett annat scenario är kanske att du med jämna intervall vill uppdatera priser på artiklarna i OpenCart från en exportfil som är skapad i Visma Administration. Detta tillägg klarar det mesta och är ett mycket flexibelt verktyg för dig som vill spara tid och pengar på att rationalisera bort onödigt manuellt arbete. Hur det fungerar Från Visma Administration kan man exportera en XML-fil med alla produkter. Denna XML-fil kan man sedan importera från Visma Produkt Import i OpenCart. OBS: Importfilen inte innehåller inte alla nödvändiga data som t.ex. produktbild, detaljerad produktbeskrivning osv. En import av nya artiklar blir aldrig fulländad, utan du måste gå in i efterhand och komplettera viss information. Gör så här från Visma Administration 1. Välj Arkiv->Export->Register i Visma Administration 2. Bocka för Artikelregister 3. Tryck på Ok och spara ned XML-filen lokalt på datorn Gör så här från OpenCart 1. Gå in på System->Visma Produkt Import 2. Välj den från Visma sparade XML-filen för analysering 3. Tryck på Analysera knappen 4. Ställ in nödvändiga inställningar (se sida 5) 5. Tryck på Spara inställning knappen 6. Du har nu skapat din första importregel Gör så här för att köra importen 1. Välj samma XML-fil som du nyss analyserade igen 2. Tryck på Importera knappen 3. Vänta tills importen är klar, en dialogruta kommer att visas 4. Blev det några problem med importen så loggas dessa i en speciell loggtabell som du kommer åt genom att trycka på fliken Fellogg Varningar som skapas i felloggen Varningarna som loggas i felloggen är oftast inte systemkritiska fel utan oftast varningar och betyder inte att importen misslyckades på något vis, du kan dock behöva gå in på enskilda artiklar och justera vissa uppgifter. Exempel på varningar som inte är systemkritiska är 1. UTF-8 konvertering misslyckades för produktnamnet på produkten med artikelnr: <artikelnr> 2. Ett URL-alias med samma namn fanns redan, inget URL-alias skapades för produkten med artikelnr: <artikelnr> 3. Priset saknades i importfilen och uppdaterades inte för den aktuella produkten med artikelnr: <artikelnr> 4. Misslyckades att mappa kategori för produkten med artikelnr: <artikelnr> 5. Misslyckades att mappa tillverkare för produkten med artikelnr: <artikelnr>

4 Skapa en importregel och kör en import (steg 1) Det första du måste gör är att skapa en importregel. Eftersom inte Visma Administration exporterar data som artikelgrupper och tillverkare i klartext utan bara deras ID så måste dessa uppgifter mappas mot motsvarande kategorier och tillverkare i OpenCart. 1. Välj en från Visma Administration exporterad XML-produktfil. 2. Tryck på Analysera knappen.

5 Skapa en importregel och kör en import (steg 2) Ett formulär kommer att skapas enligt bilden nedan. 1. Fyll i namnet på regeln, du kan döpa den till: Import av artiklar. 2. Välj Lägg till nya produkter och uppdatera befintliga som åtgärd. 3. Nya fält kommer nu att expanderas: a. Välj butik artiklarna kommer att importeras till (om du har flera). b. Språk ska vara svenska om du vill att produktnamn osv. ska vara kopplad till svenska språket. c. Välj vad du vill på Momsklass, Ej i lager, Längdenhet, Viktenhet och Kräver frakt. 4. Klicka på Välj alla under rutan Uppdatera dessa fält. 5. Ange ett önskat prispåslag (ett heltal mellan 1 och 500) som kommer att beräknas från inpriset i filen. 6. Nästa steg är att koppla alla tillverkare från Visma Administration till motsvarande i OpenCart. OBS: Du bör ha lagt upp dessa i förväg då dessa ej kan importeras. a. Klicka på Visa alla för att expandera alla tillverkare. b. Koppla alla tillverkare genom att välja rätt i motsvarande lista. 7. Du ska nu återupprepa punkt 6, fast med kategorier denna gång. 8. När alla formulärfält är ifyllda, tryck på knappen Spara inställning

6 Skapa en importregel och kör en import (steg 3) Du har nu skapat en importregel som ser ur som på bilden nedan ungefär. En ny knapp syns nu som heter Radera inställning. Trycker du på den så tar du bort den regel som du för tillfället står på. OBS: Du kan inte redigera en inställning i den här första versionen av Visma Produkt Import.

7 Skapa en importregel och kör en import (steg 4) Nu är det dags att köra själva importen, artiklarna kommer att importeras med de gällande regler för just den inställning du för tillfället står på. När importen är klar kommer en dialogruta upp. Uppstod några fel eller varningar när importen kördes så har dessa loggats i loggtabellen och du kommer åt dessa genom att klicka på fliken Fellogg. Vill du ta bort alla loggade fel så tryck på Töm loggen knappen.

8 Uppdatering av priser från prislista Från och med v1.5.0 så finns det möjlighet att importera priser från en Visma prislistefil (*.prl). Priserna på alla matchande produkter i databasen kommer att uppdateras (utan påslag) från filen. Ingen hänsyn tas till några speciella regler eller urval som är skapade i regeln utan priser importeras rakt av. Gör så här från Visma Administration 1. Välj Arkiv->Export->Prislista i Visma Administration 2. Se till att inställningen filens teckenformat är ANSI (checkrutan ska vara ibockad) 3. Bocka inte i några frivilliga fält 4. Exportera filen och spara lokalt på datorn Gör så här för importera filen från Visma Produkt Import i OpenCart 1. Välj en av regel-flikarna (vilken spelar ingen roll) 2. Välj textfilen du exporterade från Visma Administration 3. Tryck på importera knappen 4. En notifiering ska komma upp med antal produkter som uppdaterades Filens format 1. Filen måste vara en fastlängds textfil och måste avslutas med New Line (\n) i slutet på varje rad 2. Varje rad måste bestå av 64 tecken. 3. Artikel nr måste vara tecken 1 till Priset måste vara tecken 52 till 64 Uppdatering av lagerstatus från lagervärdeslista Från och med v1.5.0 så finns det möjlighet att uppdatera antal i lager från en rapport skapad i Visma. Fältet antal på alla matchande produkter i databasen kommer att uppdateras. Gör så här från Visma Administration 1. Välj Utskrift->Artiklar/Lager->Lagervärdeslista i Visma Administration 2. Klicka på knappen Inställningar a. Verifiera att inställningen TAB-separering är vald b. Verifiera att inställningen ANSI-teckenuppsättning. är vald 3. Vill du ha ett urval så kan du även ställa in villkor på de artiklar du vill ha ut (frivilligt) 4. Klicka på knappen Fil och spar ned filen lokalt på datorn Gör så här för importera filen från Visma Produkt Import i OpenCart 1. Välj en av regel-flikarna (vilken spelar ingen roll) 2. Välj textfilen du exporterade från Visma Administration 3. Tryck på importera knappen 4. En notifiering ska komma upp med antal produkter som uppdaterades Filens format Filen måste vara en TAB-separerad textfil och filen måste innehålla strängen I lager Det spelar ingen roll i vilken kolumn antal finns, bara det är samma som rubriken I lager. Teckenuppsättningen i filen måste även vara ANSI.

9 Historik v Genomfört ett kompatibilitetstest med OpenCart Utfört några få anpassningar till OpenCart x v1.5.5 Uppdaterade kod som skapade call by reference varningar i nyare versioner av PHP (5.3+). Genomfört ett kompatibilitetstest med OpenCart v1.5.4 BUGGFIX: Bättre felhantering om filen är för stor för att laddas upp. ÄNDRAT: Ändrat så att ingenting uppdateras på produkter där Artikelnr saknas i XML-filen BUGGFIX: Kategorimappningen uppdaterades oavsett vad man hade ställt in när man skapade importregeln. Detta gällde enbart om man hade valt Lägg till nya produkter och uppdatera befintliga som åtgärd. v1.5.3 NYTT: Produktimporten tömmer numera produkt-cachen efter en import. BUGGFIX: Ett SQL-felmeddelande kunde i vissa fall genereras när man körde en import för att uppdatera befintliga produkter. v1.5.2 BUGGFIX: Mappning på kategori blev fel om värdet i XML-filen inte var ett heltal. BUGGFIX: Mappning på tillverkare blev fel om värdet i XML-filen inte var ett heltal. BUGGFIX: När man körde med flera butiker så kom inte standardbutiken med som ett valbart alternativ i listan. OBS: Buggarna mappning på kategori och tillverkare är ett fel som följer med när man sparar importregeln, så importregler bör alltså sparas om, annars följer felet med. v1.5.1 BUGGFIX: Ett felmeddelande uppstod om man använde tabellprefix i OpenCart, fixat. v1.5.0 NYTT: Visma Produkt Import stödjer numera import av prislistefiler. NYTT: Visma Produkt Import stödjer numera import av lagervärdeslista. v1.2.0 NYTT: Lagt till filtreringsvillkor där man kan ange att <fält> är lika med, startar med, eller innehåller ett specifikt värde när man skapar importregeln. Detta för att lättare kunna styra vilka artiklar man vill importera/uppdatera från importfilen. v1.0.0 Första versionen