Új listatételek (bulknew)

Új listatételek

URL: /listitem/bulknew

Ezzel az operációval több listatételt lehet feltölteni egy kéréssel. Az így egyszerre feltölthető listatételek száma 5000. Ennél több listatétel feltöltését szét kell darabolni több kérésre. Mint minden kérésnél, ennél a kérésnél is érvényes korlát, hogy egy http kérés payload-ja nem lehet nagyobb, mint 10Mbyte. Ez azt jelenti, hogy különlegesen sok adatot tartalmazó listatételek esetén esetleg 5000-nél is kevesebb tételt lehet így feltölteni.

Kérés:

{
    "listitems":
    [
        {
            "lsid": 1,
            "notes": "",
            "disabled": false,
            "columns":
            [
                { "colnum": 1, "value": "abc" },
                { "colnum": 2, "value": "def"},
                {COLUMN3},
                {COLUMN4}...
            ],
            "contacts:"
            [
                {
                    "contact_num": 1,
                    "name": "Kovács János",
                    "phone": "1333333",
                    "email": "a@b.com",
                    "jpos": "operátor",
                    "notes": ""  
                },
                {CONTACT2},
                {CONTACT3}...
            ]
            "plusinfo": ["plusinfo1", "plusinfo2", "plusinfo3"]
        },
        {LISTITEM2},
        {LISTITEM3}...
    ]
}

A listitems tömb elemei ugyanolyan szerkezetűek, mint a /listitem/new operáció kérés objektuma. Ennek a részletes leírását lásd a /listitem/new operációnál.

Válasz:

{
    "status": "ok"
    "listitem_nums":
    [
        3,
        4,
        ...
    ]
}

A listitem_nums tömb a feltöltött listatételek CapITris-beli sorszámát tartalmazza pontosan olyan sorrendben, ahogy a feltöltendő listatételek tömbjében szerepeltek. A rendszer nem abortálódik néhány listatétel feltöltésének sikertelensége esetén: Azon listatételek helyén, amelyek feltöltése nem sikerült, 0-ás sorszám jelenik meg. Ha van olyan rekord, amelynek azért nem sikerül a beszúrása, mert a rekord egyedi azonosítója többször is megtalálható a rendszerben, ott -1 érték fog megjelenni. A status = ok akkor is, ha néhány listatétel feltöltése nem sikerült. A status csak akkor lesz error, ha legalább 100 listatétel feltöltése sikertelen. Ilyen esetben a feltöltés abortálódik és a válasz már nem is tartalmazza a listitem_nums tömböt.