Kaip paruošti NT katalogą iš svetainės, API ar Excel
Šaltinio pasirinkimas, pavyzdinių įrašų patikra, saugi API autentifikacija ir praktinis pirmo katalogo importo planas.
Atnaujinta:
Rinkitės prižiūrimą šaltinį, o ne patogiausią failą
Geriausias pradinis šaltinis yra tas, kuriame jūsų komanda patikimai prižiūri objektų faktus. Tai gali būti vieša svetainė, jau turimas duomenų API, Excel eksportas arba JSON. Prieš jungdami katalogą įsitikinkite, kad galite jį pateikti ir turite teisę naudoti aprašymus bei nuotraukas. Techninė prieiga savaime nesuteikia publikavimo teisių.
Nuspręskite, ar perduodate visą katalogą, vieną projektą, ar pasirinktą objektų grupę. Šį pasirinkimą užrašykite kartu su tikėtinu įrašų skaičiumi. Dešimt sėkmingai gautų objektų nėra viso šimto objektų katalogo patikra. Pirmo bandymo tikslas — patikrinti struktūrą ir faktus, o ne kuo greičiau gauti didžiausią skaičių.
Slinkite lentelę į šoną, kad matytumėte visus stulpelius.
| Šaltinis | Ką paruošti |
|---|---|
| Svetainė | Tikslų viešą HTTPS katalogo arba projekto adresą |
| Esamas API | Duomenų adresą, laukų aprašą ir reikalingą autentifikaciją |
| Excel / CSV | Vieną aiškią lentelę, stabilų ID ir vienodus stulpelius |
| JSON | Objektų sąrašą su nuosekliais laukų tipais |
Svetainės peržiūra ir API duomenys
Svetainės atveju rinkitės puslapį, kuriame matomas reikalingas projektas ar katalogas. Bendras įmonės pradinis puslapis gali padėti atpažinti prekės ženklą, bet nebūtinai parodo visus objektus. FindEstate pavadinimo, nuotraukos ar ekrano vaizdo peržiūra yra atskira nuo viso katalogo duomenų gavimo. Jos sėkmė nepatvirtina importuotų įrašų skaičiaus.
Esamam API iš anksto pasitikrinkite, ar atsakymas puslapiuojamas, kaip pateikiama kaina ir kaip atskiriami nebeaktyvūs įrašai. Prisijungęs savininkas FindEstate gali pateikti palaikomą Bearer, Basic arba API rakto antraštės autentifikaciją. Slapčių reikšmių nedėkite į URL, aprašymą ar įkeliamą viešą lentelę. Suteikite tik konkrečiam šaltiniui reikalingą prieigą, o ne visos sistemos administratoriaus teises.
Excel ir CSV: paprasta lentelė patikimesnė už maketą
Vienoje eilutėje laikykite vieną objektą, o pirmoje — vienareikšmius stulpelių pavadinimus. Atsisakykite sujungtų langelių, tarpinių antraščių ir komentarų tarp objektų. Identifikatorius laikykite tekstu, kad neprapultų pradžios nuliai. Kainos ir ploto stulpeliuose nenaudokite valiutos ženklų ar paaiškinimų vietoje skaičių; matavimo vienetus aprašykite atskirai.
Prieš eksportuodami sukurkite patikrintą reikšmių kopiją, jei lentelėje yra formulių. FindEstate paprastas importas gali atmesti darbaknygę, kuriai reikia kelių lapų ar formulių peržiūros. Dabartinė vietinio failo ar įklijuoto JSON riba yra 2 MiB ir 100 įrašų vienam pateikimui. Didesnę apimtį suderinkite prieš importą; pakartotinių failų nelaikykite garantuotu esamo katalogo atnaujinimo būdu.
- Patikrinkite pasikartojančius ID ir tuščias eilutes.
- Atskirkite kainą, valiutą, plotą ir sandorio tipą.
- Nežinomo fakto nekeiskite nuliu ar kito objekto reikšme.
- Nuotraukų ir šaltinio nuorodos turi vesti į tinkamus viešus išteklius.
Atskirkite API skaitymą nuo duomenų siuntimo
Yra du skirtingi API scenarijai. Pirmu FindEstate skaito jūsų jau turimą šaltinį. Antru jūs norite siųsti struktūruotus duomenis į FindEstate priėmimo sąsają. Pirmojo šaltinio autentifikacijos raktas ir antrojo katalogui išduotas pateikimo raktas nėra pakeičiami vienas kitu. Dokumentacijoje ir komandos susitarimuose aiškiai nurodykite kryptį.
Šios publikacijos metu FindEstate struktūruoto pateikimo raktą ir sutartį galima paruošti, tačiau išorinis klientų duomenų priėmimo adresas dar neprijungtas. Jei sąsaja rodo laukiamą adresą, duomenų nesiųskite į spėjamą endpointą. Rakto sukūrimas nėra įvykęs importas. Pirmiausia gaukite patvirtintą adresą, sutartį ir aiškų bandymo patvirtinimą.
Priimkite rezultatą pagal pavyzdžius
Pirmam bandymui parinkite kelis skirtingus įrašus: įprastą objektą, kitokio tipo objektą ir įrašą su sąmoningai nežinomu lauku. Po importo palyginkite ID, sandorio tipą, kainą, valiutą, plotą ir nuorodas su originalu. Įsitikinkite, kad nežinoma reikšmė nebuvo pakeista spėjimu, o vieno objekto nuotrauka nepriskirta kitam.
Patikrinkite bendrą gautų įrašų skaičių ir atskirai peržiūrėkite nepilnus bei paslėptus objektus. Trūkstamus faktus taisykite tik turėdami jų šaltinį. Importas sukuria darbo medžiagą; viešam naudojimui dar reikalingi atskiri teisių, peržiūros ir platinimo sprendimai. Baigę turėsite patikrintą katalogo pagrindą, kurį galima nuosekliai prižiūrėti, o ne vien sėkmingai įkeltą failą.