A lekérdezési paraméterek beállítása

Ismerje meg a lekérdezési paraméterekkel való munka alapjait a HTTP-csatlakozófunkciókban az API dokumentációval összhangban.

A lekérdezési paraméterek lehetővé teszik a csatlakozófüggvények eredményeinek finomítását és testre szabását. A paraméterek segítségével rendezhet, szűrhet, korlátozásokat állíthat be, eltolhat egy indexet és még sok mást. Ez a cikk a Tulip Table API paramétereit használja, de más API-k eltérő paraméterkövetelményekkel rendelkezhetnek. Ellenőrizze a dokumentációt, hogy a helyes szintaxist és specifikációkat használja.

Szűrőkkel történő lekérdezés

A szűrők nagyon hasznosak lehetnek ahhoz, hogy csak az Önt érdeklő adatokat nyerje ki. Ezek a szűrők néha kicsit trükkösek lehetnek a szintaxisukkal. Az alábbiakban a rekordok GET-kérelmének példáján, majd egy teljes példán keresztül ismertetjük, hogy az egyes szűrők hogyan alakulnak.

Az egyénimezők mezőnevei elé mindig egy ötjegyű karakterlánc-azonosító kerül. Ezeket legkönnyebben egy GET all kérés után lehet megtalálni, hogy ellenőrizni lehessen a mező valódi nevét.

• Pl. "mező"="maytq_scrap_count"

Az argumentumértékek gyakran egyszerűek. Ha szöveges értékről van szó, mindenképpen tegye idézőjelbe.

• Pl. "arg":15

Egyeztesse a használni kívánt függvénytípussal.

• Pl. "functionType": "greaterThan"

Egy teljes kérés erre a célra valahogy így nézhet ki:

{"field": "maytq\_scrap\_count", "arg":15, "functionType": "greaterThan"}]&filterAggregator=any

Hogyan találja meg a lekérdezési paramétereket a dokumentációban

A kérelemhez rendelkezésre álló lekérdezési paraméterek megtalálásához navigáljon az API dokumentációjához. Ha a Tulip Table API-t használja, a dokumentációt a következő címen találja: your-instance.tulip.co/apiDocs.Válassza ki a használni kívánt kérést, majd görgessen le a Paraméterek fülre.

Minden egyes módszer saját paraméterkészlettel rendelkezik, azonban nem minden kéréshez tartoznak paraméterek. Győződjön meg róla, hogy a dokumentációban előzetesen megjegyzi, hogy mi áll rendelkezésre.

A lekérdezési paraméterek szintaxisa

A paraméterek szintaxisának lekérdezése a lekérdezési karakterlánc formátumára támaszkodik. Ez a formátum értékeket rendel a megadott paraméterekhez, maga a lekérdezési karakterlánc pedig az URL része.

A Csatlakozófunkció-szerkesztőben kattintson a Paraméter hozzáadása gombra egy új lekérdezési paraméter létrehozásához.

Egy lekérdezési paraméter két részből áll: egy kulcsból és egy értékből. A kulcs a paraméter neve, az érték pedig az az információ, amely a paramétert az eredményekhez beállítja.

A lekérdezési paraméterek szintaxisában a Dot Notation használatos, amely meghatározza a paraméter pontos típusát. Győződjön meg arról, hogy az írásmód megfelel a másik rendszer API-szabványának.

Közös paraméterek alkalmazása a csatlakozófüggvényekhez

Ahhoz, hogy egy paramétert beállítson a csatlakozófüggvényéhez, először azonosítsa a használni kívánt paramétert az API dokumentációban. A paramétereknek eltérő követelményei vannak, ezért nézzük át, hogy ezek hogyan néznek ki.

:::(Info) (MEGJEGYZÉS)A folytonosság kedvéért az alábbi példák mindegyikében ugyanazt a kérést API Call fogjuk használni. Ez az a GET-kérés, amely a Tulip Table API-n keresztül lekérdezi egy tulip Table-ben lévő rekordok listáját. Más, Ön által használt API-k eltérő specifikációkkal rendelkeznek a paraméterekre vonatkozóan, mindenképpen nézze meg az API dokumentáció követelményeit.:::

Korlátok

A korlátok egy kijelölt felső határt állítanak be a visszaküldött eredményekre. Vegye figyelembe, hogy egyes korlátok alapértelmezett beállításokkal rendelkeznek, ezért mindenképpen nézze meg az API dokumentációját a kezdeti érték megértéséhez.

PéldaAcsatlakozó függvény futtatásakor legfeljebb 70 rekordot szeretnénk kapni. Szerencsére a limit alapértelmezett értéke ebben a kérésben 10, a legmagasabb pedig 100. A lekérdezési paraméter szintaxisának a következőképpen kell kinéznie:

Szűrők

A szűrők a paraméter megadott információi alapján választják szét és finomítják az eredményeket.

A szűrők három részből állnak, amelyeket külön paraméterekben kell megírni:

• Mező - a táblázat oszlopának neve.
• Function Type - az összehasonlító függvény típusa
• Argumentum - az az érték, amellyel az eredményeket összehasonlítja

Minden szűrő 3 részből áll, és minden teljes szűrő egy Object. Az egyes kulcsok megírásához a pontjelölést használva adja meg a paraméter típusát ('filter'), a szűrő számát (0-tól n-ig) és a szűrő részét ('field', 'functionType' vagy 'arg'). A szűrő mindhárom részéhez kell paramétert adni.

PéldaMegakarjuk győződni arról, hogy a csatlakozófüggvény eredményei csak egy adott mező (eubmc_value) értékeit mutatják, amely megegyezik a függvény megadott bemeneti értékével (consumable). Mivel ez az első szűrőnk a függvény paramétereiben, a szűrő száma 0. Ez azt jelenti, hogy ennek a szűrőnek minden kulcsa 'filter.0'-val kezdődik. Ennek a szűrőnek a szintaxisának a következőképpen kell kinéznie:

Rendezés

Az eredmények rendezése a nézetet a paraméter információi alapján rangsorolja. A rendezett eredmények határozzák meg, hogy melyek kerülnek bele az összesítésbe. Többféle rendezési funkciót is használhat, azonban az opciók sorrendje határozza meg a rendezési prioritást.

A rendezési függvényeknek két része van:

• sortBy - az a mező, amely alapján az eredményeket rendezni kívánja.
• sortDir - a rendezés iránya, növekvő (asc) vagy csökkenő (desc).

Minden egyes rendezési függvény 3 részből áll. Az egyes kulcsok írásához pontjelöléssel írjuk le a paraméter típusát ('sortOptions'), a rendezési számot (0-tól n-ig) és a rendezési argumentumot ('sortBy' vagy 'sortDir'). A rendezési függvény mindhárom részének kell paraméter, hogy működjön.

PéldaAcsatlakozó függvény eredményeit a legfrissebb frissített mező szerint szeretnénk növekvő sorrendben rendezni. Mivel ez az első rendezési függvényünk, a rendezési szám 0. Ez azt jelenti, hogy a rendezés mindkét kulcsa 'sortOptions.0'-val kezdődik. A sortBy kulcs értéke egy speciális érték ('_updatedAt'), amely az API dokumentációból származik a frissített mezők rendezéséhez. Ezeknek a paramétereknek a szintaxisának a következőképpen kell kinéznie:

Offsets

Az eltolások határozzák meg, hogy a visszaadott eredmény milyen indexről induljon. Ezt a paramétert a lapozáshoz használjuk, nem pedig a rekordok sorrendjére, amelyet a rendezési paraméterek határoznak meg. A paraméter értékének egy 0-nál nagyobb vagy azzal egyenlő egész számnak kell lennie.

PéldaMégcsak az 5. pozíció utáni rekordokat szeretnénk megtekinteni, hogy ne a felső 5 találatot lássuk. A lekérdezési paraméter szintaxisának a következőképpen kell kinéznie:

Szűrő aggregátorok

A szűrőaggregátorok határozzák meg, hogy a paraméterekben lévő szűrők hogyan kombinálódnak. A két választható érték az 'any' és az 'all'. Az 'all' érték azt jelenti, hogy az összes szűrőnek tartalmaznia kell egy rekordot ahhoz, hogy a rekord bekerüljön az eredmények közé. Az "any" érték azt jelenti, hogy legalább az egyik szűrőnek meg kell egyeznie egy rekorddal ahhoz, hogy az szerepeljen az eredmények között. Az alapértelmezett érték az 'all', függetlenül attól, hogy beállította-e a paramétert vagy sem.

PéldaEgysor szűrő van a lekérdezési paraméterekben, de csak az egyik szűrőnek kell igaznak lennie ahhoz, hogy a rekordok megfeleljenek a kérésünknek. A lekérdezési paraméter szintaxisának a következőképpen kell kinéznie:

Több szűrő

Bizonyos esetekben előfordulhat, hogy a táblázatban több szűrőt is ellenőrizni kell. Ebben az esetben többszöröseket adhatunk a szűrők objektumhoz. Ez valahogy így nézhet ki:

},{"field": "maytq\_scrap\_count", "arg":15, "functionType": "greaterThan"},{"field": "maytq\_scrap\_reason", "arg": "scratch", "functionType": "equal"}]

További olvasmányok

• A HTTP-konnektorok áttekintése
• Hogyan hozzunk létre és konfiguráljunk egy HTTP-csatlakozó funkciót?
• A táblázat API használata