FAQ voor ontwikkelaars

Veelgestelde vragen vóór en tijdens de implementatie

Deze pagina beantwoordt de vragen die het vaakst opkomen wanneer een team EEV in software wil integreren zonder te verdwalen tussen het publieke contract, architectuurkeuzes, legacy-compatibiliteit en productuitrol.

Moet je EEV in één keer volledig implementeren?

Nee. Een geloofwaardige eerste versie kan zich richten op een duidelijke subset, bijvoorbeeld het lezen van ENTRY in .eev en .eevz, met eerlijke validatie en een canonieke writer die beperkt blijft tot de velden die de software echt begrijpt. Het belangrijkste is niet om meteen alles te ondersteunen, maar om exact te documenteren wat wel wordt ondersteund.

Waar begin je technisch gezien het best?

Het schoonste vertrekpunt is de eenvoudige tekstroute: de container detecteren, de ruwe tekst ophalen, één ENTRY parsen, een intern model opbouwen en daarna weer stabiele tekst uitschrijven. Compressie en certificering komen later als extra lagen, niet als een tweede kern.

Hoe ga je om met legacy-varianten?

Bij het lezen mag de parser tolerant zijn en bepaalde legacy-vormen naar het moderne interne model omzetten, met waarschuwingen. Bij het schrijven mag de canonieke writer die oude vormen niet automatisch opnieuw gebruiken. Breed lezen en schoon schrijven blijft de veiligste regel.

Moeten ENTRY en LIB als twee aparte formaten worden behandeld?

Niet echt. Het zijn twee containerstructuren binnen dezelfde familie. ENTRY beschrijft één enkele afdruk. LIB voegt een bibliotheekkader toe dat meerdere entries kan bevatten. Het is beter om zoveel mogelijk van de interne blokverwerking te delen en daar vervolgens een bibliotheeklaag omheen te zetten.

Wat moet een canonieke writer garanderen?

Hij moet deterministische, geordende, leesbare tekst produceren die coherent is met de beoogde versie van het publieke contract. Twee identieke exports moeten dezelfde uitvoer geven. Velden moeten in een stabiele volgorde verschijnen, met voorspelbare normalisatie van waarden en secties.

Moeten de oorspronkelijke ruwe regels bewaard blijven?

Alleen als het product ze echt nodig heeft voor inspectie of diff-tools. Voor de hoofdlogica is het beter om snel naar een schoon intern model toe te werken. Te lang vertrouwen op ruwe regels maakt de evolutie van parser en writer veel kwetsbaarder.

Gaat hashing alleen over gecomprimeerde bestanden?

Nee. Hashing hoort bij documentintegriteit, niet bij gecomprimeerd transport. Een bestand kan wel of niet gecomprimeerd zijn; de echte vraag is welke delen van het document beschermd zijn en hoe je controleert dat ze niet zijn gewijzigd.

Moet mijn tool EEVC-bestanden ondersteunen?

Het is nuttig om het lezen van reeds uitgegeven EEVC- of EEVCZ-bestanden te ondersteunen wanneer uw product gecertificeerd materiaal moet inspecteren of verifiëren. Deze website documenteert geen lokale aanmaak van EEVC; gebruik voor gecertificeerde verificatieworkflows eevc.link.

Welke productboodschap kun je beter vermijden?

Je kunt EEV beter niet presenteren als een simpele “verrijkte noot” of als een magische belofte die op zichzelf vertelt wat een geluid “doet”. Het formaat beschrijft en structureert trillingsgedrag fijnmazig; het vervangt noch luisteren, noch menselijk oordeel, noch interpretatiekaders.

Heeft de Open EEV-site zelf een database nodig?

Nee. De hier geleverde site is een lichte PHP-site met eenvoudige i18n. Hij kan direct naar de hostingruimte worden gekopieerd. Er is geen MySQL-database nodig en er hoeven geen SQL-commando’s te worden uitgevoerd.