Aldoc Sys versie 6 Koppelen met Aldoc Sys versie 6
Aldoc Atezet b.v. Bredaseweg 25 NL 4872 LA Etten-Leur Nederland
0
Algemeen Inleiding Aldoc Sys versie 6 wordt momenteel uitgebracht in twee vormen : 1. 2.
Als lokaal op een PC te installeren programma (verder de CD/DVD versie genoemd) Als Internet applicatie (verder de Internet versie genoemd)
Het is de betrachting van Aldoc om in beide gevallen dezelfde informatie aan te bieden. Er zijn uiteraard wel verschillen in de aard en frequentie waarbij bijwerkingen van zowel programmatuur als data doorgevoerd kunnen worden. In beide gevallen wordt er gewerkt met het Aldoc menusysteem. Grossiers die Aldoc Sys aan hun klanten aanbieden, kunnen een specifiek menu opstellen middels de CD/DVD versie. Datzelfde menu kan dan gebruikt worden in de Internet versie.
CD/DVD versie De CD/DVD versie kan zowel geïnstalleerd worden op een alleenstaande PC als op een bedrijfsnetwerk. In beide gevallen zal het hoofdprogramma op elke PC draaien. In geval gekozen werd voor een netwerkinstallatie op het bedrijfsnetwerk zullen de data centraal op een server bijgehouden worden, terwijl het programma op de individuele Pc’s blijft draaien. Let wel dat de CD/DVD versie op de harde schijf geïnstalleerd wordt. Tijdens het gebruik van Aldoc Sys zijn de cd’s of DVD niet meer nodig. Overigens moet u bij bestelling opgeven of u de levering met cd’s of met DVD wenst (het is niet beide). Hou er rekening mee dat er inmiddels hulpprogramma’s gebruikt worden die als service onder Windows worden geïnstalleerd. Dat impliceert dat zowel de lokale Pc’s als de server moeten draaien onder Microsoft Windows en verder aan de respectievelijke systeemvereisten moeten voldoen. De systeemvereisten kunnen evolueren. Daarbij wordt rekening gehouden met de apparatuur die in de handel verkrijgbaar is. Medio 2006 werden volgende versies van Windows ondersteund: Voor alleenstaande Pc’s en client Pc’s in een bedrijfsnetwerk: Windows NT4, 98, 98SE, ME, 2000(NT5.0), XP(NT5.1) en 2003(NT5.2) en voor servers in een bedrijfsnetwerk: Windows NT4, 2000(NT5.0), XP(NT5.1) en 2003(NT5.2). Dat betekent dat de ondersteuning voor Windows 95 weggevallen is, en er mag verwacht worden dat het geen jaren meer duurt eer hetzelfde geldt voor Windows NT4, 98, 98SE en ME. Windows Vista(NT6?) komt er dan wellicht bij als die uit de Bèta fase komt.
Internet versie Wat bij ons bekend is als de Internet versie (of ook wel de online versie) van Aldoc Sys, is een applicatie op een Microsoft Internet Information Server (verder IIS5 of IIS6 genoemd) en die door gebruikers benaderd kan worden met Microsoft Internet Explorer 6 (verder IE6 genoemd). Er zijn op dit moment meerdere servers in gebruik. De juiste URL die moet gebruikt worden, wordt door Aldoc of via een betrokken grossier meegedeeld. Omdat in eerste instantie gekozen werd voor Internet Explorer (en vervolgens “vanaf de volledige versie 6”), konden we gebruik maken van specifieke voordelen van die versie van browser. Mocht de toekomst uitwijzen dat ondersteuning van meerdere versies van browsers gewenst is, dan kan zullen ten gepaste tijde aanpassingen doorgevoerd worden. Bovenstaande impliceert voor de gebruikers dat Microsoft Windows NT4, 98, 98SE, ME, 2000(NT5.0), XP(NT5.1) of 2003(NT5.2) vereist is, omdat op die platformen Internet Explorer 6 beschikbaar is. De versie van IE6 zoals bij voorbeeld op PDA’s (met Windows CE, Windows Mobile, embedded Windows, Windows Automotive, …) ondersteunt ondermeer geen “reguliere expressies” en beschouwen we momenteel als “onvolledige” versies. De eerste tests met IE7 zoals beschikbaar op Windows Vista Bèta/CTP vallen gunstig uit. De server applicatie wordt ontwikkeld op Windows XP professional, maar de performantie wordt beoordeeld op Windows 2003 standaard editie. In 2005 heeft de applicatie nog gedraaid op een Windows 2000 server, maar omdat er inmiddels zo geen operationele servers meer zijn, wordt die situatie niet meer opgevolgd. Als operationele servers raden we Windows 2003 (32-bit of 64-bit) aan. Windows XP professional kan voor “binnenshuis” situaties.
1
Koppelen met Aldoc Sys CD/DVD Doelstelling Ten behoeve van Backoffice systemen zoals bedoeld voor voorraadbeheer, facturatie, offerte opmaak, … konden bepaalde gegevens uit Aldoc Sys geëxporteerd worden naar een bestand op de harde schijf. Daarvoor werden in de loop der jaren formaten bedacht en naderhand uitgebreid. Bijgevolg ondersteunen we momenteel een waaier bestandsformaten. De voornaamste worden verderop voorgesteld.
DDE – koppeling Voorlopig nog voor de Aldoc Sys CD/DVD en nooit voor de Internet versie, kan Dynamic Data Exchange (DDE) gebruikt worden. Met dien verstande dat er wel een bestand op de harde schijf wordt weggeschreven (in een bestandsformaat dat u verderop terugvindt).
Service: aldocdde Topic: type Middels een DDE Execute kunnen de volgende commando’s gegevens worden: handle=<windowhandle> de <windowhandle> wordt gebruikt na een export om uw applicatie de focus te geven. gettype De gebruiker kan een auto kiezen, waarna het bestand koppel.typ wordt weggeschreven. Aldoc Sys zal na de keuze weer in het opstartscherm gaan staan en eventueel uw applicatie de focus geven. plate=
kenteken mag met of zonder ‘-‘ Aldoc Sys gaat naar het onderdelen menu van de desbetreffende auto of laat de gebruiker (indien van toepassing) kiezen tussen meerdere autotypen. Koppel.typ wordt weggeschreven. Aangezien het mogelijk is dat Aldoc Sys meerdere types voorstelt voor één kenteken (dus niet één op één ), na selectie de unieke Aldoc autocode gebruiken en van dan af Aldoc Sys oproepen met: type= Aldoc Sys gaat naar het onderdelen menu van de desbetreffende auto. link=<path> naar <path> worden de koppelbestanden weggeschreven. (Het standaard pad is in de configuratie van Aldoc Sys per gebruiker in te stellen.)
Bestandsuitwisseling Binnen Aldoc Sys (versie CD/DVD) wordt de pakbon doorgezet naar andere lokaal geïnstalleerde pakketten middels de knop F3 “Transfer”. Het verzenden van de pakbon naar een derde partij kan ingesteld worden via het menu “Configuratie”. Bij Aldoc Sys (versie Internet) gaat de pakbon als bestelbon via de weg die ingesteld is in het menu dat aan de catalogus/login is gekoppeld.
2
Bestandsformaten Inleiding Vanouds heette het bestand dat Aldoc Sys op de harddisk wegzette ten behoeve van andere programma’s “koppel.txt”. In dat bestand werden records weggeschreven die gedacht werden samengesteld te zijn uit velden met vaste lengte. In die versies was er dus geen veldseparator en geen recordseparator. Onder MS-DOS werd de lokale standaard ASCII codetabel gebruikt, in de 32-bit versies van Windows wordt de lokale standaard ANSI codetabel gebruikt. Hieronder vindt u de nog steeds van toepassing zijnde bestandsnamen en record lay-out. Vindt u achter de bestandsnaam “(vervallen)”, dan betekent dat, dat we het gebruik van die record lay-out verder ontmoedigen, maar nog wel ondersteunen.
KOPPEL.TXT
(vervallen)
Dit is de oudste versie, gebruikt door de ALDOCSYS voor DOS. Art.nr. 18 Merknaam 25 Artikelomschrijving 35 Prijs 6 Aantal 3
KOPPEL2.TXT (vervallen) Deze versie is identiek aan KOPPEL.TXT, behalve het prijsveld dat werd uitgebreid ten bate van kleine munteenheden. Art.nr. Merknaam Artikelomschrijving Prijs Aantal
18 25 35 10 3
KOPPEL3.TXT (vervallen) Deze versie is identiek aan KOPPEL2.TXT, behalve dat elke regel eindigt met een "harde return" (in code CR/LF, decimaal 13/10).
LABOUR.TXT Omschrijving Job Tijd Prijs
75 50 6 12
(decimalen komma gescheiden) (decimalen komma gescheiden)
KOPPEL.TYP Automerk Automodel Model opmerking Autotype Motortype Begindatum Einddatum Merk code Model code
5 20 15 60 43 15 7 7 5 5
3
KOPPEL6.TXT Dit is het koppelbestand voor de pakbon vanaf Aldoc Sys versie 6. Vanaf deze versie worden “lijnen” weggeschreven in het bestand. Dat wil zeggen dat de recordseparator CR/LF (in decimale notatie: 13/10) is. Daarnaast vindt u op de eerste positie op elke lijn een code (verder prefix genoemd) die het type record aanduidt. Volgende prefixen worden gebruikt: C= beschrijving van een autotype / voertuig P= beschrijving van een onderdeel A= opgave van de alternatieve artikelnummers L= beschrijving van de werkplaatstijd T= vrije tekst Let op: niet alle recordtypes zijn even lang. Voor recordtype A is de recordlengte onbepaald. Voor record met prefix C=voertuig Prefix C 1 5 Automerk 20 Automodel 15 Model opmerking 60 Autotype 43 Motortype 15 Begindatum 7 Einddatum 7 Merk code 5 Model code 5 CR/LF 2 Voor de record met prefix P=Onderdeel Prefix P 1 Art.nr. 18 Merknaam 25 Artikelomschrijving 35 Prijs 10 Aantal 3 CR/LF 2 Voor de record met prefix A=Alternatieve artikelnummers Dit record volgt meteen op het P record waar het betrekking op heeft. De alternatieve artikelnummers zijn puntkomma (;) gescheiden. Prefix A 1 Artikelnummers onbepaald CR/LF 2 Voor de record met prefix L=Werkplaatstijd Prefix L 1 Omschrijving 75 Job 50 Tijd 6 (decimalen komma gescheiden) Prijs 12 (decimalen komma gescheiden) CR/LF 2 Voor de record met prefix T=Vrije tekst Prefix T 1 Tekst 255 CR/LF 2
4
Het XML-bestand Het nadeel van de vorige bestanden is dat men op voorhand moet weten welke velden gebruikt gaan worden. In een XML-bestand kan men de veldbeschrijvingen mee opnemen in elke “record”. Dat maakt het bestand uiteraard langer. Er is vooreerst een voordeel omwille van het feit dat per record de “niet gebruikte velden” niet vernoemd moeten worden. Daarnaast is er een enorm strategisch voordeel in de evolutie van de gegevensuitwisseling. Doordat de velden die niet toepasselijk zijn, niet vernoemd moeten worden, hoeven we niet zuinig te zijn op mogelijk mee te geven velden. In het verleden werden de velden die zelden gebruikt c.q. nuttig waren, weggelaten om de efficiëntie te verhogen. Als XML berichten worden uitgewisseld, dan wordt van het systeem aan de ontvangende kant meestal verwacht dat velden die hem/haar onbekend zijn, genegeerd worden. Dat laat de verzender toe om nieuwe velden te introduceren, als er maar rekening gehouden wordt met het feit dat niet alle potentiële ontvangers iets zinvols (kunnen) uitrichten met die bijkomende velden. Hieronder een voorbeeld van het voorstel dat momenteel bij Aldoc ter discussie ligt: <Application>AldocSys 6 20040228143057 [BdC2006-843] A00666 Garage G. Arage George Arage Straat 123 9999 Stadcity 076-7676767 076-7676768 20135 Volkswagen Passat Variant 2.0 TDI 13-GG-NN <Part> <SupDescr>PartMakers NV/SA 78-1234 Ding Truc Bidule Chose 1575 EuroCent <Mode>FOB 2 <Job> 03:15 120 Euro <Mode>19%BTWi Test Test Test 78-1234 0078-01234A 0078-01234B 0078-01234C
5
Data-uitwisseling tussen Aldoc Sys en andere systemen Inleiding De belangrijkste gegevens die uitgewisseld moeten worden, betreffen de bestellingen die een partij wil doorgeven aan een andere partij. Voor onze toepassing denke men aan het garage-bedrijf dat bestelt bij een grossier van autoonderdelen, of aan een filiaal van een grossier dat bestelt bij een centrale, of aan een grossier die bestelt bij een fabrikant. Op dit moment kan vanuit Aldoc Sys (versie CD/DVD) een bestand verstuurd worden naar een andere partij waar Aldoc Direct geïnstalleerd is. Aldoc Direct is ons systeem dat aan de ontvangende kant het bericht opvangt. Het formaat van dat bericht is nauw verwant aan de hoger beschreven formaten voor het koppelbestand. Als verzendmethode raden we FTP aan. Maar email zou ook kunnen. Van Aldoc Sys (versie Internet) wordt iets gelijkaardigs gedaan van op de server naar weer een partij die Aldoc Direct heeft. Er is nu een alternatief. Als de betrokken webserver bij de grossier in zijn bedrijfsnetwerk is geïntegeerd, dan kan een bestand direct naar een directory weggeschreven worden ter verwerking.
Berichten veilig bewaren Aldoc Sys (versie CD/DVD) wordt lokaal op de Pc geïnstalleerd. Het operating system Windows gaat er dan van uit dat die programmatuur vertrouwd wordt, en derhalve de berichten lokaal op de harde schijf mag wegschrijven. Deze versie van Aldoc Sys kan dan ook gemakkelijk data beschikbaar stellen in het bedrijfsnetwerk. Aldoc Sys (versie Internet) werkt via de Internet Explorer, en berichten worden op de server bewaard. Van daaruit kunnen ze verzonden worden naar een partij die over een FTP-server of een Aldoc Direct of iets dergelijks beschikt. Op de lokale pc kunnen die berichten maar beschikbaar komen indien de gebruiker 1. ofwel daar telkens weer expliciet de toestemming voor geeft. 2. ofwel ook een server heeft (bij voorbeeld een ftp-server) . 3. ofwel bereid is alles als email bericht te ontvangen. 4. ofwel een ander programma bij installeert dat dan vertrouwd wordt (bij voorbeeld Aldoc Direct)
6