Rebus Web-import av kunder 2003-03-06: Åbergs DataSystem AB. Version 1. 2005-11-11: Senaste revidering. Import av kunder till Rebus kundregister från en web-sites SQL-databas görs genom att man i kundregistret klickar på knappen som ser ut så här. Klickar man på knappen så startas denna inmatningsbild: Importtyp: Här finns det i dagsläget tre typer av web-import. Det är gjort till olika kunder och det skiljer lite mellan dem. Typ 1: Häst & Sportresor Typ 2: Tjörnarps Buss Typ 3: Lotus Travel / Svensk-kinesiska resebyrån. Servernamn: Rebus behöver veta namnet eller IP-adressen till web-servern där hemsidan och SQL-databasen finns. UserID: Här anger man användarnamnet som ska användas för att logga in på web-serverns SQL-server. Password: Här anger man det lösenord som krävs för att logga in på web-serverns SQL-server.
MySQL: Om web-serverns databas körs på en Linux MySQL så måste det markeras här eftersom uppkopplingen då ska ske via ODBC istället för via OLEDB Provider. För att det ska fungera så måste MyODBC (3.51) installeras. Den kan hämtas från www.mysql.com och installeras på datorn eller också kan vi leverera den eftersom vi har hämtat den därifrån ("MyODBC-3.51.06.exe", 732 KB). Provider: Här ska man ange namnet på den OLEDB Provider som programmet ska använda för att koppla mot web-servern. För en normal Microsoft SQL-server så heter providern "sqloledb". Om man har annan databas på servern t.ex. Oracle så ska annan provider anges. Om man vill koppla mot en Linux MySQL så kan provider utelämnas eftersom man då måste bocka för föregående fält "MySQL" och kopplingen sker via MyODBC. Timeout: Ange i sekunder hur lång tid programmet ska försöka få kontakt med servern. Databas: Här anger man namnet på den SQL-databas som programmet ska öppna på web-servern. Tabellnamn: Här anger man namnet på den SQL-tabell som innehåller de kunder som registrerat sig via web-sidan och som man vill importera till Rebus kundregister. Auto-ID: Varje kund som ska skrivas in i Rebus kundregister måste ha en kund-id. Här kan man bestämma om programmet ska ta en automatisk ID eller om man vill använda kundens telefonnummer som kund-id. Hur den automatiska kund-id skapas har bestämts inne i Rebus grundinställningar. Basen är ett löpnummer som man kan formatera på olika sätt (nollutfylld eller inte) samt om man vill ha någon bokstav i första positionen eller inte. Exempel: A00123, Z123 eller enbart 123. Kategori: Varje ny kund som skrivs in i Rebus kundregister kan kategoriseras direkt med en kundkategori. Här väljer man vilken som ska användas. Web-import med typ 2 (Tjörnarps buss) och 3 (Lotus Travel / Svensk-kinesiska) saknar detta kategorival eftersom kategorin redan är angiven i web-databasen och alltså tas därifrån för varje importerad kund. Kategorifältet får inte vara längre än 8 tecken. "Hämta" När alla fält är inmatade korrekt klickar man på hämta-knappen och då försöker programmet koppla upp sig mot web-servern, logga in sig på SQL-servern samt öppna den angivna databasen och den angivna tabellen. Skulle det inte gå bra så kommer programmet att ge ett meddelande på vad som inte gick bra. Då handlar det nästan alltid om behörighetsproblem i webserver och/eller brandvägg. Vid inhämtningen så visas alla kunder som importeras i rutan till höger.
I de typer (1-3) som vi har i drift idag så innehåller tabellerna följande fält: Web-import typ 1 (Häst & Sportresor): Num Foretag Fornamn Efternamn Adress Postnummer Postaddress Land Telehem Telearb Fax Email Msgkund Agent Kategori (Uniknr) (Text, max 20 tecken) (Text, 64 KiloByte) 0=Normal kund, 1=Agent Agents ev. kategori Fältet "Num" är ett unikt löpnummer som vi endast använder som referens när vi ska radera posten från web-servern efter att vi skrivit in den i Rebus kundregister. Om fältet "Foretag" är tomt så betyder det att kunden är en privatperson och då används fälten "Fornamn" och "Efternamn" som kundens första namn. Kundens andra namn (attention) blir då tom. Om fältet "Foretag" inte är tomt så betyder det att kunden är ett företag och då läggs företagsnamnet som kundens första namn och fälten "Fornamn" och "Efternamn" som kundens andra namn (attention). Förnamn och efternamn slås ihop med efternamn först som i exemplet "Andersson, Sture". Företagsnamn och attention får i Rebus max innehålla 50 tecken. För att kontrollera om kunden redan finns i Rebus kundregister görs en sökning med företagsnamn, förnamn, efternamn och adress. Finns det en kund med exakt samma uppgifter så markeras den som en uppdatering genom att ändringsdatum på kundposten i Rebus sätts till dagens datum och kundkategorin för kunden skrivs. Postnummer och postadress slås ihop till ett fält i Rebus och får tillsammans ha max 50 tecken. Finns inte kunden sedan tidigare så skrivs en kundpost i Rebus med det kund-id som valts och alla uppgifter i kundposten som lästs från web-servern. Registreringsdatum och ändringsdatum sätts till dagens datum och kundkategorin skrivs. Fältet "MsgKund" skrivs i kundens informationsruta som kan innehålla mycket text. Om kundens land är "NORGE" eller "NORWAY" så sätts kundens valuta till NOK. Om land är "FINLAND" eller "SUOMI" så sätts kundens valuta till EUR. Om land är "DANMARK", "DENMARK" eller "DK" så sätts kundens valuta till DKK. Detta innebär att kunden vill ha bekräftelser och fakturor i sin egen valuta. Om "Agent"=0 så är det en normal kund och då används den kundkategori som valts i samband med web-importen. Om "Agent"=1 så är det t.ex. en finländsk agent som har registrerat och då har de själva angivit kategori på websidan, i det läget ska kundkategori tas från fältet "Kategori" i den framlästa posten. När kunden har skrivits i Rebus kundregister så raderas den från web-servern via referensfältet "Num" och så läses nästa post in och förfarandet upprepas.
Web-import typ 2 (Tjörnarps buss): Num (Uniknr) Fornamn Efternamn Adress Postnummer Postadress Telehem Email Msgkund (Text, 64 KiloByte) Fodelsear (Text 4) Kategori (Text 8) Fältet "Num" är ett unikt löpnummer som vi endast använder som referens när vi ska radera posten från web-servern efter att vi skrivit in den i Rebus kundregister. Kunden är alltid en privatperson och förnamn och efternamn slås ihop med efternamn först som i exemplet "Andersson, Sture". Kundens andra namn (attention) blir tom. För att kontrollera om kunden redan finns i Rebus kundregister görs en sökning med namn och adress. Finns det en kund med exakt samma uppgifter så markeras den som en uppdatering genom att ändringsdatum på kundposten i Rebus sätts till dagens datum och den valda kundkategorin för kunden skrivs. Postnummer och postadress slås ihop till ett fält i Rebus och får tillsammans ha max 50 tecken. Finns inte kunden sedan tidigare så skrivs en kundpost i Rebus med det kund-id som valts och alla uppgifter i kundposten som lästs från web-servern. Registreringsdatum och ändringsdatum sätts till dagens datum och kundkategorin skrivs. Fältet "MsgKund" skrivs i kundens informationsruta som kan innehålla mycket text. Fältet "Fodelsear" skrivs också in i kundens informationsruta. När kunden har skrivits i Rebus kundregister så raderas den från web-servern via referensfältet "Num" och så läses nästa post in och förfarandet upprepas.
Web-import typ 3 (Lotus travel / Svensk-kinesiska resebyrån): ID (Uniknr) Fornamn Efternamn Adress Postnummer Postadress Land Telehem Telearbete Email Msgkund (Text, 64 KiloByte) Katalog (Text 8) (Kundkategori-ID) Fältet "ID" är ett unikt löpnummer som vi endast använder som referens när vi ska radera posten från web-servern efter att vi skrivit in den i Rebus kundregister. Kunden är alltid en privatperson och förnamn och efternamn slås ihop med efternamn först som i exemplet "Andersson, Sture". Kundens andra namn (attention) blir tom. För att kontrollera om kunden redan finns i Rebus kundregister görs en sökning med namn och adress. Finns det en kund med exakt samma uppgifter så markeras den som en uppdatering genom att kundpostens ändringsdatum i Rebus sätts till dagens datum och kundkategorin för kunden skrivs. Ändrarsignatur blir den inloggade användaren. Postnummer och postadress slås ihop till ett fält i Rebus och får tillsammans ha max 50 tecken. Finns inte kunden sedan tidigare så skrivs en kundpost i Rebus med det kund-id som valts och alla uppgifter i kundposten som lästs från web-servern. Registreringsdatum och ändringsdatum sätts till dagens datum. Registrerings/ändrar-signatur blir den inloggade användaren. Kundkategorin kommer från web-databasen och fältet Katalog. Kunden väljer alltså en kategori på hemsidan och det lagras i fältet Katalog. Fältet "MsgKund" skrivs i kundens informationsruta som kan innehålla mycket text. När kunden har skrivits i Rebus kundregister så raderas den från web-servern via referensfältet "ID" och så läses nästa post in och förfarandet upprepas.
Generellt för alla import-typer: När alla kunder är inlästa så visas en ruta upp där det står hur många nya kunder som skrivits in samt hur många kunder som blivit uppdaterade. Alla nya kunder har fått dagens datum som registreringsdatum och kan listas ut via t.ex. kundetikett-rutinen. De visas dessutom med namn i formulärets högra ruta. Alla uppgifter angående server, lösenord m.m. som är inmatade i formuläret sparas och kommer att vara förskrivna nästa gång man går in på rutinen. Slutord: I stora drag så tror vi att den här proceduren kommer att fungera mot de flesta kunder, men vi kan bli tvungna att bygga fler varianter av import med tanke på att inte alla web-servrars tabeller innehåller just de här fälten och med just de namnen. Men vi förordar naturligtvis att använda någon av våra tre importtyper om det är möjligt.