Må en hente ut alle produkter?

Nei, en må ikke hente alle produktene. Det er mange måter å filtrere en eksport av produkter slik at kun de ønskede produktene blir returnert. 

  • søkefiltre (eks. “freeText”, “showInactive”, “missingEtimForVersion”) er effektive å bruke for å utelukke irrelevante produkter.
  • Det er mulig å spesifisere i en liste med produkter en ønsker å eksportere. Dette kan en ved å enten angi en komma separeret liste med hvilke “importCode”, “productNo” eller "altProductNo" en ønsker.
  • En kan søke etter produkter som matcher angitt produktnavn eller beskrivelse ( name eller alternativeName)
  • En kan også filtrere resultatet til å kun matche produkter med angitt produkteier, status, produktmal, varegruppe eller leverandør ved å angi liste med tilhørende "importCodes" for disse
    • productOwnerImportCodes
    • productStatusImportCodes
    • productTypeImportCodes
    • productGroupImportCodes
    • supplierImportCodes

Se swagger dokumentasjonen for utfyllende informasjon om hvordan filtrere hvilke produkter en ønsker å eksportere.

Må en hente ut all informasjon på produkter?

Nei, en kan velge å ekskludere informasjon en ikke trenger fra respons.  Dette er anbefalt for å oppnå raskere respons, redusere belastning på feed® server og redusere datamengde som må transporteres.

  • query parameter “excludeData” benyttes for å filtrere bort informasjon en ikke trenger. Som standard så returneres komplett informasjon om produktet, men ved å legge inn hvilken informasjon man ikke trenger her kan en redusere datamengde og øke ytelse betraktelig.
    Følgende verdier kan ekskluderes: PRODUCT_HEAD, ATTRIBUTE, TEXT, MEDIA, RELATION, LINKED_TO, VARIANT, STRUCTURE, PACKAGING, ETIM.
    Hvis en legger inn alle de overnevnte som filter vil en få ut en respons som kun inneholder en liste med identifiers for de produkter en har eksportert. Dette er en rask måte å hente ut id for produkter hvis en kun skal gjøre et oppslag for å verifisere om et produkt finnes. 

I tillegg kan en redusere datamengde betydelig, spesielt hvis en har mange attributter av type "dataregister" eller eksporterer ETIM data ved å velge å ikke inkludere tilgjengelig/lovlige valg på disse utover hva som er faktisk angitt som verdi.

  • query parameter "includeOptions" lik "false" kan benyttes for å kun hente ut valgt verdi på en attributt med tilhørende liste av lovlige verdier. 
    Denne bør benyttes hvis en ikke trenger å hente ut informasjon om hvilke øvrige verdier (options) en attributt kan ha.

Kan en hente ut informasjon om et slettet produkt?

  • Man kan få med slettede produkter ved å sette “includeDeleted” til true.

Hvordan kan en kun hente det som er endret siden sist (delta export)?

For å kun hente det som er endret må en sette et gitt tidsintervall og sette flagget “changesOnly”. Om det ikke blir satt en “exportTo” dato vil det bli tatt utgangspunkt i at det skal gjelde frem til og med i dag. Det anbefales å primært hente data med “changesOnly” for å forhindre uthenting av produkter gjentatte ganger helt unødvendig.

Ref params: “changesOnly”, “exportFrom”, “exportTo”.

Er “basedata” det samme som produkt?

Basedata er ikke det samme som et produkt, men er det som definerer hva et produkt inneholder. Basedata er de stamdata som kunde har opprettet for egendefinerte felter i feed®, det er dette som definerer hvilken informasjon, relasjoner, roller, produktmaler og statuser som er tilgjengelig på et produkt i feed®. Via basedata eksport kan en hente ut attributter, tekster, statuser, relasjoner og mye mer. Se swagger dokumentasjon for ytterligere informasjon.

Jeg får feilmelding 401: Unauthorized. Hva gjør jeg?

Feilmeldingen er vanlig ved feil eller mangel på autentisering. Eks. en bearer token er utgått. Du kan sjekke denne siden: https://confluence.isys.no/display/FB/Autentisering.

Kan man hente ut produkter fra en spesifikk mappe i en struktur?

Ja, det er mulig å hente ut en bestemt mappe med “importCode”, men en får ikke en liste med alle produktene i undermappene. En må derfor traversere nedover i alle undermapper for å få tak i produktene til de tilhørende mappene. 

Ref api: “/export/structure/structures/{importCode}”.

Hva kommer ut i en struktur eksport?

Når du gjør en struktur eksport, vil du få ut informasjon om hvilke produkter, media og attributter som er der, men ikke all informasjon om de. For å få ut denne informasjonen må du gjøre produkt/media eksport. 

Hvordan kan jeg vite hva som kommer ut i en eksport?

I swagger dokumentasjon vil du se et eksempel på hvordan en vellykket eksport vil se ut. Swagger dokumentasjon er tilgjengelig på https://<host URL>/export/swagger-ui/
<host URL> er adressen til din feed installasjon.

  • No labels