Ú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
headersmellett 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_headersmező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 |