Hva er teksten/koden som returneres fra “/import/import”?

Dette er en GUID som brukes til å identifisere den bestemte importen. Ved å sende koden til “/import/{guid}/status” vil en få nåværende status på importen.

Eksempel på GUID-struktur: xxxxx-xxxxx-xxxxx-xxxxx-xxxxx.

Må det sendes med begge “identifiers”?

Nei, det er nok å sende en av dem for å identifisere hvilket produkt det gjelder. Gitt at produktet eksisterer fra før. Det er anbefalt å bruke “importCode” ettersom dette er en unik verdi. “productNo” er ikke en unik verdi og kan derfor ha flere produkter med samme verdi.
Vær oppmerksom hvis en utfører operasjoner som krever et unikt produkt, f.eks oppdatering, vil feile hvis en benytter "productNo" som identifier og angitt verdi ikke er unik. 

Hva er “importMode”?

“importMode” er et felt som gir feed® indikasjon om en spesifikk import skal kunne opprette, oppdatere eller slette produkter avhengig av om de eksisterer fra før. 

Disse verdiene kan “importMode” ha:

  • CREATE_OR_UPDATE
    • Her vil import forsøke å oppdatere et produkt forutsatt at en identifier er satt i input og unikt identifiserer et produkt i feed®. Hvis identifier treffer flere produkter vil oppdatering feile. Hvis identifier ikke får noen treff vil import opprette et nytt produkt.
  • CREATE
    • Her vil import alltid forsøke å opprette et nytt produkt. Hvis "allowDuplicate" er satt til "false" vil opprettelse feile hvis angitt "productNo" allerede finnes. hvis "allowDuplicate" er satt til true vil det opprettes et nytt (duplikat) produkt med samme "productNo".
      Det vil aldri utføres oppdatering av eksisterende produkter når denne modus angis.
  • UPDATE
    • Her vil import alltid forsøke å redigere et eksisterende produkt. Hvis identifier treffer flere produkter vil oppdatering feile. Hvis identifier ikke får noen treff vil det gis en advarsel om at produkt ikke er funnet. 
      Det vil aldri opprettes nye produkter når denne modus angis.

 Hva er “importCode” for et produkt?

“importCode” for et produkt er en unik intern ID’en for et produkt i feed® installasjonen. Dette kan en f.eks. få med i en export av produkter. En kan ikke bestemme eller endre “importCode” for et produkt i feed®.
Denne er med i API eksporter og en kan også se hvilken "importCode" et produkt har ved å se på siffer i siste del av URL når en er inne på et produkt i web-grensesnittet. 

I eksempel over er "importCode" for produktet en er inne på = 2.

Hvordan kan jeg vite hva som er gyldig input i en import?

Se dokumentasjon av input (og output) i swagger dokumentasjonen til det endpoint du benytter. Swagger dokumentasjon er tilgjengelig på https://<host URL>/import/swagger-ui/
<host URL> er adressen til din feed installasjon.

Må det sendes med alle felt for et produkt når kun et felt skal oppdateres?

Nei, det holder å sende kun de feltene en ønsker å oppdatere.

Hvor lang tid tar det å importere et produkt?

Det er ikke mulig å gi en konkret tid. Ettersom dette er avhengig av mange faktorer som f.eks. antall felt, spesifikt hvilke felt, jobbene som kjører på feed® serveren fra før av, mm.

Hvorfor vises ikke feilmeldinger i “/import/{guid}/status”?

For å få ut mer informasjon om advarsler eller feilmeldinger for importerte eller forsøkt importerte produkter kan en sende med parametret “incudeDeviationReport” lik "true".  Som standard returneres bare en oversikt over progresjon og antall advarsler og feil.

Kan man se innsendt JSON i “/import/{guid}/status”?

Ja, ved å sette "includeImportJSON" lik "true", kan man få ut JSON fra importen.

Hvorfor finnes det to forskjellige import og export endepunkter for media?

“/import/media” er faset ut og erstattet med “/media/import”. Hvis en benytter førstnevnte bør en oppdatere integrasjon til å benytte korrekt media API for dette. Utfasede endpoints ( [deprecated] ) vil kunne bli utilgjengelig på fremtidig tidspunkt, men det vil sendes ut varsel om dette.

Er det mulig å importere strukturer via API?

Ja, det er innført egne endpoints i import API for å opprette og vedlikeholde strukturer i feed®.  Se swagger dokumentasjon for ytterligere detaljer om hva som er mulig.

  • No labels