Kihagyás

Új lista (new)

Új lista

URL: /list/new

Kérés:

{
    "name": "mylist",
    "code": "mylistcode",
    "expiration_date": "2021.01.01",
    "test": false,
    "spec_extcode" : 1,
    "spec_header1" : 2,
    "spec_header2" : 4,
    "disabled": false,
    "update_keyduplicate" : true,
    "headers": ["mycolumn1", "mycolumn2", "mycolumn3"],
    "col_visible": [true, true, false],
    "col_editable": [false, true, false],
    "col_hidden": [false, false, true],
    "plusinfo_headers": ["plusinfoname_1", "plusinfoname_2", "plusinfoname_3"]
}
Mező Típus Kötelezőség Leírás
name szöveg (120) kötelező Lista neve, egyedinek kell lennie!
code szöveg (40) opcionális Lista (külső rendszerbeli) kódja, ha van, akkor egyedinek kell lennie!
expiration_date dátum opcionális Lista lejáratának dátuma
test boolean opcionális, default: false Ha igaz, akkor ez csak egy teszt lista.
spec_extcode integer opcionális, default: 0 Lista külső kód oszlopsorszáma ha nem 0. Ha 0 vagy ha nincs megadva, akkor nincs külső kódként funkcionáló oszlopa a listának.
spec_header1 integer opcionális Az első speciális oszlop sorszáma, amelynek a fejléce a kliensben megjelenítésre kerül.
spec_header2 integer opcionális A második speciális oszlop sorszáma, amelynek a fejléce a kliensben megjelenítésre kerül.
disabled boolean opcionális, default: false Tiltott-e a lista
update_keyduplicate boolean opcionális, default: true Ha true, akkor létező kód esetén felülíródnak az adatok
headers tömb opcionális Fejlécek listája
col_visible tömb (boolean) opcionális, default: minden oszlop látszik Oszloponként megadja, hogy a tétel-listában megjelenik-e az oszlop
col_editable tömb (boolean) opcionális, default: egyik sem szerkeszthető Oszloponként megadja, hogy az oszlop szerkeszthető-e
col_hidden tömb (boolean) opcionális, default: egyik sem rejtett Oszloponként megadja, hogy az adatlapon a tartalom el van-e rejtve
plusinfo_headers tömb opcionális Plusz információk (ha nem elég az 50 oszlop) névlistája

Oszlop-beállítások

A col_visible, col_editable és col_hidden tömbök a headers-hez tartoznak, pozíció szerint: az első elem az első fejléchez tartozik, és így tovább. Mindhárom önállóan elhagyható.

  • Ha egy tömböt nem adsz meg, arra a beállításra az alapértelmezés érvényes: minden oszlop látszik, egyik sem szerkeszthető és egyik sem rejtett.
  • Ha megadod, akkor pontosan annyi elemet kell tartalmaznia, mint amennyi fejléc a headers-ben van, különben a kérés hibával tér vissza.
  • Az elemek kizárólag true / false értékek lehetnek. Bármi más — szám (1 / 0) vagy szöveg ("true") — hibával tér vissza.
  • A három tömb csak headers mellett adható meg; önmagukban hibát adnak.
  • Legfeljebb 50 oszlop beállítása tárolható; ennél több oszlop esetén használd a plusinfo_headers mezőt.

Válasz:

{
    "status": "ok",
    "lsid": 1 
}

Amennyiben a megadott code-al már létezik lista, akkor alapértelmezetten a meglévő lista íródik felül.

Mező Típus Leírás
lsid integer A létrehozott lista egyedi azonosítója