Importera kunduppgifter till FFB från externt system

(Denna text riktar sig till systemadministratörer/systemansvariga)

Konventioner: för att referera till viss nod xml inklusive dess föräldrar används följande skrivsätt: root/child1/child2
Börjar alltså alltid från rotnoden och använder / som separator mellan noderna

I FFB är det under vissa förutsättningar, möjligt att kontinuerligt läsa över kunduppgifter från ett annat systems kundregister, t ex ert lokala cirkulationssystem.

För att denna möjlighet skall kunna utnyttjas, måste vissa krav uppfyllas av det exporterande systemet:

Aktivering

För att kontinuerlig import av kunduppgifter skall aktiveras i FFB, måste ett antal inställningar ändras och anpassas efter just de specifika förhållanden som gäller för respektive FFB-installation. En standardinstallation av FFB är inte färdig att användas för import av kunduppgifter

Anpassning och ändring av inställningar för kundimport kan utföras av Databib Aqua AB, Bibliotekscentrum eller av FFB-systemets ägare förutsatt att tillräcklig kompetens finns på plats. Med tillräcklig kompetens avses här god kännedom om XML-formatet, förmåga att redigera XML-filer, god kännedom om det system som utgör importkälla och detta systems databas

FFB:s startmeny

För att varningstexten Aktuellt system ej aktiverat för import skall försvinna från FFB:s startmeny, skall följande ändring utföras:

Styrning av kundimport

Hur kundimporten skall ske styrs av ett antal inställningar i filen PsImp.xml. PsImp.xml finns lagrad i undermappen tx under FFB:s huvudmapp. Xml-koden i filen är kommenterad med detaljerade instruktioner. Här ges endast översiktlig information.

PsImp.xml kan redigeras med en enkel texteditor, t ex Notepad. Tag dock alltid för vana att spara en kopia av den ursprungliga filen under ett annat namn, så att du lätt kan återgå till originalet om så skulle behövas. Var också noga med att alltid ladda in filen i Internet explorer efter att du redigerat den, för att kontrollera att XML-syntaxen är korrekt. Minsta formella fel i PsImp.xml får kundimportprogrammet att krascha

Importgränssnitt

Import från externt system kan ske antingen i direktkontakt med källsystemets databas via Ado/Odbc eller via http-kommunikation och xml-format. För Ado/Odbc krävs ingen särskild anpassning eller programvara på källsidan. För http via xml krävs att särskild rutin finns på serversidan, vilken tar emot http-anrop med querystring i form av sql-fråga. Fn är http-varianten endast möjlig mot Mikromarc via ett serverscript som tagits fram av Tomas Vaedelund, Bibliotekscentrum, Växjö. Ado/Odbc är möjligt mot vilket system som helst som tillåter direktåtkomst till databasen för externa program och vars databas är tillräckligt kompatibel med FFB när det gäller kunduppgifter.

Vilket importgränssnitt som skall gälla, anges i noden psimp/importinterface med 1 för ado/odbc och 2 för http/xml (centraldrift)

Sql-frågor

PsImp.xml levereras med kompletta sql-frågor både för ado/odbc och http/xml gränssnitten. Dessa är utformade att fungera mot Mikromarc. Om import skall ske från ett annat källsystem, måste frågorna modifieras från grunden. Emellertid, kan användare också ha behov av att modifiera även de färdiga frågorna för Mikromarc, t ex kan ha behov av att begränsa urvalet av kunder som skall importeras, undanta fler fält från överskrivning i FFB etc. Detta är i hög grad möjligt för den som väl behärskar Sql, källans databas och har god förståelse av strukturen i PsImp.xml. Nödvändiga instruktioner finns i kommentarerna till xml-koden.

OBS! Separata definitioner för Sql-frågor för respektive gränssnitt.

Sql för http-gränssnittet måste utformas annorlunda än för ado/odbc p g a att importen lämpligen sker i tvåstegsoperationer, för att inte riskera minnesbrist vid stora importtabeller. Se vidare kommentarer i psmimp.xml