Richtlijnen Certificering 1.0/1.0 Dienstbeschrijving Richtlijnen Certificering Bestandsnaam : Richtlijnen Certificering Bestandsnummer : CI/0019 Datum laatste wijziging : 1 oktober 2009 Documentversie/release : 1.0/1.0 Documentstatus : Definitief
Copyright Florecom, 2009 Alle rechten voorbehouden. Niets uit deze uitgave mag worden verveelvoudigd, opgeslagen in een geautomatiseerd gegevensbestand, of openbaar gemaakt, in enige vorm of op enige wijze, hetzij elektronisch, mechanisch, door fotokopieën, opnamen of enig andere manier, zonder voorafgaande schriftelijke toestemming van stichting Florecom. Voor toestemming neemt u contact op met: Stichting Florecom, Postbus 205, 1430 AE Aalsmeer. Disclaimer Florecom besteedt de uiterste aandacht aan de informatie die zij via haar website en FTP-site verspreidt. Florecom kan echter niet instaan voor de juistheid, volledigheid en tijdigheid van die informatie. Aan de informatie op de website en FTP-site kunnen dan ook geen rechten worden ontleend. Florecom sluit alle aansprakelijkheid uit voor enigerlei schade, direct of indirect en van welke aard dan ook, die voortvloeit uit of in enig opzicht verband houdt met het gebruik van deze sites of de daarop geplaatste informatie, danwel met de onmogelijkheid om deze sites of de daarop geplaatste informatie op enig moment te raadplegen. Verwijzingen naar andere websites en hyperlinks zijn slechts opgenomen ter informatie van de bezoeker van deze site. Florecom staat niet in voor de inhoud of betrouwbaarheid, in welk opzicht dan ook, van die websites en hyperlinks. Florecom behoudt zich alle rechten voor met betrekking tot de op deze sites geplaatste informatie. Openbaarmaking langs andere weg of bewerking van die informatie is niet toegestaan zonder voorafgaande toestemming van Florecom. Pagina 2 1 oktober 2009
Inhoud Wijzigingsblad 4 1. Inleiding 5 2. Hoe wordt er getest? 6 2.1 Florecom Test Centre 6 2.1.1 Testniveau 1 6 2.1.2 Testniveau 2 6 2.1.3 Testniveau 3 6 2.1.4 Testniveau 4 6 3. Wat wordt getest? 7 3.1 Inleiding 7 3.2 Criteria voor certificering 7 3.2.1 Edifact berichten 7 3.2.2 XML Berichten 8 4. Checklist: Proces Aanvragen Florecom Certificaat 9 Pagina 3 1 oktober 2009
Wijzigingsblad Versie Auteur Wijzigingen 0.1 C. Ilbrink Initiële versie 0.2 F. Dechering Review 1.0 C. Ilbrink Definitieve versie Pagina 4 1 oktober 2009
1. Inleiding Dit document bevat de richtlijnen voor het behalen van een Florecom certificaat voor softwareleveranciers, een nieuw product van Florecom. Aanleiding voor dit product is de wens van softwareleveranciers om een certificaat te ontvangen na een succesvolle implementatie van één of meerdere Florecom standaarden. Een wens die is uitgesproken door een meerderheid van software leveranciers tijdens de XML Breakfastbriefing (HortiFair, 15 oktober 2008) n.a.v. een presentatie van het Florecom Test Centre. Hoofdstuk 2 bevat een beschrijving van hoe er wordt getest. Daarna volgt een hoofdstuk dat beschrijft wat er wordt getest. Het laatste hoofdstuk bevat een praktische checklist met daarin de te volgen stappen voor het behalen van een Florecom certificaat. Pagina 5 1 oktober 2009
2. Hoe wordt er getest? 2.1 Florecom Test Centre Het Florecom Test Centre is een applicatie die het mogelijk maakt om de berichtuitwisseling tussen ebusiness systemen te testen. De applicatie is beschikbaar via de URL http://testcentre.florecom.org. Toegang kan worden aangevraagd via het e-mailadres info@florecom.nl. Het Test Centre kan zowel gebruikt worden voor het testen van EDIFACT berichten als voor XML berichten. Hierbij kan het initiatief voor de berichtuitwisseling liggen bij het Test Center of bij de te testen applicatie m.a.w. het Test Centre kan een dienst simuleren (server) of een dienst raadplegen (client). In het geval van het testen van een server applicatie, is het vereist dat deze applicatie een antwoord teruggeeft op een bericht van het Test Centre anders valt er voor het Test Centre niets testen. Het Test Center test alle aangeboden berichten op vier niveaus van niveau 1 t/m niveau 4. Pas als alle niveaus succesvol zijn doorlopen wordt het bericht goedgekeurd. Als alle berichten in het scenario zijn goedgekeurd wordt het scenario goedgekeurd. Het certificaat wordt pas uitgereikt indien alle relevante scenario s succesvol zijn doorlopen. 2.1.1 Testniveau 1 Op het eerste niveau wordt de syntax van een bericht gecontroleerd. XML berichten worden gecontroleerd op de XML syntax (well-fomedness) en EDIFACT berichten worden gecontroleerd op de EDI syntax. Een syntax fout is fataal en houdt in dat het bericht niet geïnterpreteerd kan worden door de achterliggende applicaties. 2.1.2 Testniveau 2 Het tweede niveau controleert de structuur van het bericht. XML berichten worden gevalideerd aan de hand van het Florecom berichtschema. Edifact berichten worden gevalideerd aan de hand van de EDIFACT specificatie. Voorbeelden van validatie fouten zijn ontbrekende elementen of het niet nakomen van de volgorde van de elementen. 2.1.3 Testniveau 3 Op dit niveau wordt gecontroleerd of er aan de volgorde van opeenvolgende berichten binnen een scenario wordt voldaan. Het scenario voert de regie over de te verzenden en ontvangen berichten. Indien de te testen applicatie deze regels niet naleeft ontstaat een testniveau 3 fout. 2.1.4 Testniveau 4 Op dit niveau wordt een inhoudelijke controle uitgevoerd (o.a. business rules). De inhoudelijke specificatie worden beschreven in de invulinstructie van het bericht voor een specifieke toepassing in combinatie met de Florecom berichtspecificatie. Voorbeelden zijn het juiste gebruik van: De Florecom referentietechniek; VBN productcodes met de daarbij behorende verplicht sorteerkenmerken; Bedrijf- en locatiecoderingen; Eisen aan en beperkingen op de inhoud van elementen; Pagina 6 1 oktober 2009
3. Wat wordt getest? 3.1 Inleiding Florecom richt zicht op de uitwisseling van elektronische berichten tussen partijen in de sierteeltketen. Daarom beperkt de certificering zich tot de Florecom interfaces van de met elkaar communicerende sierteelt systemen. Applicatie Certificering Florecom Certificering Applicatie Certificering Florecom Interface Florecom Interface Sierteelt applicatie Sierteelt applicatie Interface X Interface Y Bovenstaand figuur beschrijft de scope van Florecom certificering. Het betreft dat deel van de applicatie die verantwoordelijk is voor de uitwisseling van, de door Florecom gestandaardiseerde, berichten met een andere sierteeltapplicatie. De inhoudelijke verwerking van het bericht vindt plaats in de sierteeltapplicatie en valt buiten de scope van de Florecom certificering. Een Florecom certificaat garandeert dat de uitgewisselde berichten op syntactisch en semantisch niveau voldoen aan de keten-, proces-, bericht- en transportspecificaties van Florecom en haar communities. 3.2 Criteria voor certificering 3.2.1 Edifact berichten De certificatie van Edifact berichten vindt plaats aan de hand van de volgende specificaties die zijn gepubliceerd op de website van Florecom (www.florecom.nl) onder Downloads met als keuze: Berichten, Alle in productie: Certificaat Bericht EDIFACT Community: Order Aanbod 2.3 QUOTES Systematiek voor een koper Order 1.3 ORDERS applicatie Order response 1.3 ORDRSP Voor ieder bericht zijn twee typen documenten beschikbaar. De functionele procesbeschrijving (FPB) en de convention manual (CM). De FPB is een functionele beschrijving van het proces waarbinnen het bericht gebruikt wordt. De CM is een technische beschrijving van het bericht en bevat tot op detail de invulinstructie van het bericht. Beiden documenten zijn gebruikt voor het opstellen van de testscripts. Florecom heeft meerdere berichtstandaarden gepubliceerd, maar daar zijn nog geen testscripts voor beschikbaar in het Test Centre. Deze worden op verzoek ontwikkeld en beschikbaar gesteld. Pagina 7 1 oktober 2009
3.2.2 XML Berichten De specificatie van de XML berichten is gedocumenteerd aan de hand van de Florecom documentatie methodiek (zie figuur). Deze methodiek biedt een kapstok, waarmee de XML standaarden op verschillende niveaus zijn beschreven: sierteeltketen, proces, bericht en transport. De gehele verzameling van documenten heeft een versienummer in de vorm Florecom XML Library versie x.y. Voor het certificeren van XML berichten is dit versienummer van belang aangezien het Florecom certificaat wordt uitgegeven voor een specifieke versie van de Florecom XML Library. De XML documentatie is gepubliceerd op de website http://sdk.florecom.org en is alleen toegankelijk voor geregistreerde gebruikers. Stuur een e-mail naar info@florecom.nl voor toegang tot deze Software Development Kit (SDK) website. De volgende XML berichten zijn momenteel beschikbaar voor certificering: Certificaat Community: FloraHolland Etrade Bericht (functioneel) Bericht (technisch) Opvragen van aanbod. GetSupply 0.2 Plaatsen van een order. PutOrder 0.2 Commercieel Aanbieden van beelden aan een beeldbank. putimages 0.1 Logistiek Plaatsen van een transportopdracht. Delivery 0.1 Ophalen van een label (sticker). Labelsrequest 0.3 Financieel Versturen van een factuur of dagafschrift Industry Process Message Transport Commercial Scenario s Code List Conventions Glossary Industry Description Logistic Scenario s Community Business Rules Generic Message Conventions Florecom XML Library UN/CEFACT Core Component Library (UN/CCL) Messaging Protocols Transport Protocols Financial Scenario s Reference Conventions CrossIndustryInvoice 0.6 Pagina 8 1 oktober 2009
4. Checklist: Proces Aanvragen Florecom Certificaat # Vereiste gegevens en activiteiten Bron 1 Eigenaar (bedrijfsgegevens) van de te testen applicatie Klant 2 Contactpersoon (commercieel) Klant 3 Contactpersoon (tester) Klant 4 Naam van de testen applicatie Klant 5 Korte beschrijving van de applicatie voor op de website van Klant Florecom. 6 Versienummer van de te testen applicatie waarop het certificaat wordt uitgegeven. Dit versienummer bepaald de functionaliteit van de applicatie en bestaat over het algemeen uit een combinatie van de eerste twee cijfers in het versienummer, bijvoorbeeld 1.2 van een applicatie met versienummer 1.2.4.1. Dit houdt in dat er service releases uitgegeven mogen worden zonder dat het certificaat vervalt. Uiteraard geldt dat deze updates geen invloed mogen hebben op de berichtuitwisseling. Het Test Center kan gebruikt worden voor het tussentijds testen van de Florecom interface. Klant 7 Soort Certificaat: Commercieel: de volgende Florecom berichten (indien geïmplementeerd) voldoen aan de gestelde specificaties: o EDIFACT: Quotes o EDIFACT: Orders o EDIFACT: EKT o EDIFACT: Htrans o XML: Supply o XML: Image o XML: Order Logistiek: de volgende Florecom berichten (indien geïmplementeerd) voldoen aan de gestelde specificaties: o EDIFACT: Desadv o EDIFACT: Flowav o EDIFACT: Delsmg o EDIFACT: Htrans o XML: Delivery Financieel: de volgende Florecom berichten (indien geïmplementeerd) voldoen aan de gestelde specificaties: o EDIFACT: Invoic o EDIFACT: Delsmg o XML: Invoice Community: Er zijn certificaten beschikbaar voor de volgende communities: o Florecom Order Systematiek o FloraHolland Etrade o FloraHolland Aftellend Klokaanbod o FloraHolland Beeldbank 8 Versienummers van de te testen Florecom berichten. Voor EDIFACT volstaat een referentie naar de gebruikte convention manuals. Voor XML volstaat het gebruikte versienummer van de Florecom XML Library. 9 Wijze van testen (E-mail of Webservices). Bij e-mail verstuur en ontvangt het Test Center berichten via SMTP. Bij webservices verstuur en ontvangt het Test Center berichten via HTTP. Bij gebruik van e-mail om berichten met het Test Centre uit te Klant Klant Klant Pagina 9 1 oktober 2009
wisselen zijn de volgende aanvullende gegevens nodig: E-mail adres die de te testen applicatie gebruikt voor het aanbieden van e-mails aan het Test Centre; E-mail adres waar het Test Centre het antwoordbericht naar toe stuurt. Indien het Test Centre wordt gebruikt om de webservice van een applicatie te testen, zijn de volgende aanvullende gegevens nodig: URL van de webservice van de te testen applicatie; Gebruikersnaam en wachtwoord voor toegang tot de webservice (basic authentication); 10 Gewenste testperiode (=ingangsdatum overeenkomst) Klant 11 Gebruikersovereenkomst Florecom Certificaat Florecom 12 Toegang (gebruikersnaam en wachtwoord) tot het Florecom Test Florecom Centre (http://testcentre.florecom.org). 13 Testen Klant 14 Controleren van de testresultaten Florecom 15 Uitreiken van het certificaat Florecom 16 Publiceren van het certificaat op de website van Florecom Florecom 17 Hertesten van de applicatie bij relevante wijzigingen in de applicatie. Klant Pagina 10 1 oktober 2009