Release notes 2.14

Oversikt

Tre store leveranser preger denne releasen: det nye Public API, en gjennomgripende omskriving av forpakning, og første versjon av webhook-støtte. I tillegg kommer en rekke forbedringer innen integrasjoner og brukeropplevelse. 

Public API

Med versjon 2.14 er feed®s offentlige REST-API klar for produksjonsbruk.

Dette er et ekte REST-API. Ressurser har egne URL-er, operasjoner gjøres med riktige HTTP-metoder, og hvert endepunkt gjør én ting. Det er ingen magiske "gjør alt"-endepunkter der man sender inn en stor blob og håper på det beste.

En av de viktigste konseptuelle endringene fra tidligere integrasjoner er at importkode er borte. Importkode var tidligere en egendefinert identifikator som snek seg inn overalt og som ekstern kode måtte forholde seg til og holde styr på. I det nye APIet er alle ressurser identifisert av publicId, en UUID som tildeles av feed® og brukes konsekvent på tvers av alle endepunkter. Ekstern kode forholder seg til denne, og ingenting annet.

Hva dekkes? APIet gir nå full tilgang til alle sentrale ressurser i feed®:

• Produkter: hent, opprett og oppdater produkthode, attributter, varianter, relasjoner, medier, status, maler, EPD-data, ETIM-klasser og forpakning

• Strukturer: administrer strukturer, strukturnoder og produkter i strukturer

• Referansedata: datakatalog og datakataloglinjer, mediaroller, attributter og attributtgrupper, enheter (UOM), filtyper, filkategorier, aktive språk og ETIM-klasseversjoner

• Automatisering: konfigurasjon og kjøringer av eksterne jobber

Alle listeendepunkter støtter paginering og sortering, og sortNo er standardsortering der det er relevant. HTTP-statuskoder er standardisert: 404 ved ikke funnet, 409 ved duplikat, 422 ved valideringsfeil. Swagger-dokumentasjonen er oppdatert med tydeligere beskrivelser av nullability og obligatoriske felter, og feilmeldinger er gjort mer beskrivende og strukturerte.

Dokumentasjon finnes her: feed® API v2 - Utviklerguide 

Forpakning - komplett omskriving

Forpakningsfunksjonaliteten er fullstendig skrevet om. Tidligere var forpakninger begrenset til sine faste felt som det ikke gikk an å endre på i tillegg til attributter, mens det nå er blitt gjort om til attributter slik at forpakningsstamdataen kan vedlikeholdes enklere. Den gamle løsningen hadde begrensninger i datamodellen som gjorde videre utvikling vanskelig. Den nye arkitekturen gir et renere skille mellom forpakningshode og forpakningsattributter, og et solid grunnlag for fremtidige utvidelser.

En av de synlige endringene for brukere er at forpakningens navn nå er et oversettbart felt, slik at navn kan vedlikeholdes på tvers av språk på lik linje med andre tekstfelter i systemet. Forpakningsdata er eksponert i public APIet med egne endepunkter, GraphQL-endepunktet er oppdatert til å støtte den nye modellen, og WooCommerce- og NOBB-integrasjonene er justert til å fungere korrekt mot den nye datastrukturen. 

Webhooks

Første versjon av webhook-funksjonaliteten er også med i versjon 2.14. Brukere kan nå administrere webhook-filtre direkte i grensesnittet og opprette, redigere og slette filtre uten behov for manuell konfigurasjon. Payload-formatet er oppdatert slik at product_id nå sendes som produktets publicId, i tråd med resten av public APIet. Webhook-prosessering kjøres innenfor korrekt transaksjonsscope, og tilgangsstyringen er justert slik at brukere av type superbruker og administrator har tilgang. 

WooCommerce

Støtte for numeriske variantattributter (heltall og desimaltall) er implementert, slik at produkter med tallbaserte variantegenskaper nå kan synkroniseres korrekt til WooCommerce.

NOBB

En rekke feil i NOBB-integrasjonen er rettet: synkronisering av produktstatus er gjort mer robust, lagring til historikktabellen fungerer korrekt, og lazy loading-problemer på konfigurasjonsobjekter er løst. Det er også lagt til støtte for tilpasset forpaknings-mapping i NOBB, og manglende migrasjonsskript for forpakningsfelt er på plass.