1 Algemene inrichting van import acties binnen Vision. Deze beschrijving is bedoeld als ondersteuning van de importeer functie om externe gegevens op ...
Algemene inrichting van import acties binnen Vision. Deze beschrijving is bedoeld als ondersteuning van de importeer functie om externe gegevens op diverse plaatsen in Vision te importeren. Specifieke eigenschappen en aandachtspunten zijn per import apart beschreven in individuele bijbehorende documenten.
XSL stylesheet Bij import en export acties kunnen er stylesheets toegepast worden. Een stylesheet wordt geschreven in de programmeer taal XSLT. Wat is een stylesheet? Stylesheets kunt u zien als een vertaal slag tussen het extern bestandsformaat en wat Vision nodig heeft om het te begrijpen. De import functionaliteit binnen Vision is altijd een specifiek XML opbouw. De stylesheet zorgt ervoor dat u een ander bestandsformaat kunt omzetten naar de benodigde XML structuur. Voorbeeld XSL stylesheet Bij vision worden er een paar standaard stylesheets beschikbaar gesteld. Deze kunt u via de Voorbeeld XSL stylesheet bestand downloaden. Indien u specifieke modules bezit is het mogelijk dat u toegang heeft tot meer Voorbeeld stylesheets. Voorbeeld stylesheets zijn standaard geblokkeerd. Maatwerk stylesheets Bepaalde import modules hebben niet echt een standaard stylesheet omdat deze per definitie niet een standaard formaat gegeven kan worden. Hiervoor worden maatwerk stylesheets gemaakt. Deze worden door een specialist gemaakt en ingesteld bij u wanneer van toepassing. Toepassing stylesheets Een gebruikelijke toepassing van stylesheets is het kunnen importeren van een .csv bestand. Dit is een ; (punt-komma) gescheiden bestand die de stylesheet ombouwt naar een .XML die Vision begrijpt en dus kan inlezen.
INFO-GROEN software b.v.
Telefoon 0172-235444
KvK nummer 28086573
Pagina 5 van 10
Importprofiel Een importprofiel is de daadwerkelijke keuze optie die je kan gebruiken zodra je op het import scherm kom. Alle import opties binnen Vision zijn te benaderen via de Nieuw Extra knop: importeer scherm. Hier kunt u een profiel kiezen:
. Als u hierop klikt komt de optie importeer na voren. Als u hierop klikt komt op het
De profiel keuzes en volgorde wordt allemaal ingesteld in de Importprofiel tabel. Te vinden bij Onderhoud Importprofiel. Hieronder vind u een ingesteld voorbeeld van een importprofiel.
INFO-GROEN software b.v.
Telefoon 0172-235444
KvK nummer 28086573
Pagina 6 van 10
Importprofiel velden: A - Naam : B - Volgorde :
Hier kunt u de naam van het profiel instellen. Dit is voor de voorkeur volgorde waarin dit profiel getoond wordt in de keuze lijst op het importeer scherm. C - Tabelnaam : Hier stelt u in onder welke tabel de importprofiel beschikbaar moet komen. (Werkt alleen op tabellen voor plaatsen waar import acties uitgevoerd kunnen worden. ) D - XSL stylesheet : Hier geeft u aan of de importprofiel gebruik moet maken van een XSL stylesheet. Let op! Als u hier niets instelt wordt de default Vision XML formaat toegepast. E - Filter bestandextensie : Op het import scherm geeft u aan welke bestand u wilt importeren. Met deze optie kunt u een filtering instellen die dan alleen maar bepaalde bestanden toont. Bijvoorbeeld .csv of .xml. F - Volgnummer : Dit is een lopende teller die bij houdt hoe vaak deze import uitgevoerd is. G - Succes directory : Hier kunt u een map locatie aangeven waarbij een succesvolle import actie het bestand naar gekopieerd wordt. H - Fout directory : Hier kunt u een map locatie aangeven waarbij een foutieve import actie het bestand naar gekopieerd wordt. I - Verwijderen na import : Hier kunt u aangeven of het originele bestand na een import actie wil laten verwijderen. J - Geen logging van overgeslagen records : Hiermee kunt u het import log gedrag aansturen zodat erbij de log bestand geen onverwerkt regels getoond worden.
INFO-GROEN software b.v.
Telefoon 0172-235444
KvK nummer 28086573
Pagina 7 van 10
Import scherm Dit is het scherm waarin u de daadwerkelijke import actie uit gaat uitvoeren. Voor specifieke kolom volgordes en aandachtspunten voor het betreffende profiel moet u de omschrijving doorlezen die betrekking daarop heeft. Hier wordt alleen een algemene uitleg gegeven van wat alles betekent. A - Profiel ) : B - Bestandsnaam ) : C - Bestand kiezen ) : D - Tabelnaam ) :
E - Toevoegen ) :
F- Veranderen ) :
G - Lege waarden ) :
H - OK ) : I - Sluit ) :
INFO-GROEN software b.v.
Telefoon 0172-235444
Hier kunt u de gewenste import profiel kiezen. Dit is waar het te importeren bestandslocatie en naam in komt te staan. Met dit knop kunt u het gewenste te importeren bestand kiezen. Dit zijn gerelateerde tabellen waarvan of waarin gerelateerd informatie wordt ingelezen of opgeroepen voor controle functies tijdens de import. Hiermee geeft u aan dat indien er een nieuw record wordt geïmporteerd wordt in deze tabel, dan mag dat ook aangemaakt worden. Hiermee geeft u aan dat indien er een match is met een bestaande record, dan mag dat gemuteerd worden. Hiermee geeft u aan dat ook lege waarden geïmporteerd mogen worden. Hierdoor is het mogelijk bepaalde velden leeg te maken bij een import. Deze knop start de import. Let op! Dit kan niet afgebroken worden. Hiermee sluit u de Importeer scherm.
KvK nummer 28086573
Pagina 8 van 10
Importlog In de importlog tabel kunt u terug kijken welke import acties er allemaal geweest zijn. Zowel succesvolle als gefaalde. De importlog is terug te vinden bij: Onderhoud Importlog Ieder importlog regel bevat de volgende informatie: - Welke importprofiel gebruikt is. - Welke tabel op geïmporteerd is. - Wanneer de import heeft plaats gevonden. - Welke bestand is geïmporteerd met waar het stond. - En indien het mislukt is een foutcode met een foutmelding van de oorzaak. Per import wordt ook bijgehouden als er iets is overgeslagen / niet meegenomen in de import en de reden ervoor.
INFO-GROEN software b.v.
Telefoon 0172-235444
KvK nummer 28086573
Pagina 9 van 10
Batchjob import acties Het is ook mogelijk binnen Vision automatische import acties in te stellen. Dit wordt vaak toegepast bij bedrijven die een externe systeem hebben die per dag of per x-aantal uren een bestand exporteert die Vision weer moet importeren. De uitleg hoe u een batchjob moet instellen kunt u terug vinden op de docuwiki van Vision. (Zoek op de term: Batch job) De import actie volgt dezelfde logica als die van het handmatig importeren alleen in sommige gevallen is misschien meer informatie nodig bij de import. Altijd dit soort zaken overleggen met een consultant.