Přejít na obsah
Flexideo
Skip to main content

Požadavek sql-query

Obálka pro sadu SQL dotazů.

Na základě znalosti struktury dokumentových tabulek databáze je možné odesílat SQL dotazy do databáze. Jedná se výhradně o příkazy SELECT.

Obálka jednoho nebo více uzlů s SQL SELECT dotazem.

Základní typ(y) uzlu(ů): sql-query;

  <request>
   <sql-query>
    <select ... {string}</select> *
   </sql-query>
  </request>

Atributy​

Požadavek sql-query neobsahuje žádné atributy.

Potomci​

Odpověď​

Struktura odpovědi na požadavek sql-query vrácená v obálce response:

  <response>
   <sql-query-result>
    <result ... /> *
    <error ... /> ?
   </sql-query-result>
  </response>

Atributy​

Odpověď sql-query-result neobsahuje žádné atributy.

Potomci​

Výraz pro identifikaci chyb v odpovědi serveru: sql-query-result[error] (odkaz na popis detailu: error).

Další info​

Je pravidlem, že obsah atributu type není v rámci sql-query duplicitní. Každý select je tedy v rámci jednoho požadavku atributem type jednoznačně identifikovatelný. Tato identifikace je pak serverem přenášena i do výsledků požadavků. Atributy user a setting slouží pro identifikaci v rámci statistik - doplnit.

Další informace viz. též příklady dotazů a identifikace chyb.

Uzel select​

Obsahuje zápis SQL výrazu SELECT pro získání dat z databáze.

Jde o uzel obsahující text TYP HODNOTY: string;

  <select
   type="{string}"
   setting="{number}"
   user="{number}"
   >
   {string}
  </select>

Atributy​

  • type - Typový název - Název bez mezer a diakritiky s možností pomlček a podrtřítek sloužící pro identifikaci položky.(typ: string)

  • setting - Setting id - Jedinečný celočíselný identifikátor položky.(typ: number)

  • user - číslo uživatele - User ID pro správnou identifikaci souboru nastavení (statistiky).(typ: number)

Potomci​

Uzel select neobsahuje žádné další elementy. Uzel může obsahovat prostý text.

Uzel result​

  <result
   type="{string}"
   >
   <row ... /> *
  </result>

Atributy​

  • type - Typový název - Název bez mezer a diakritiky s možností pomlček a podrtřítek sloužící pro identifikaci položky.(typ: string)

Potomci​

Uzel row​

  <row/>

Atributy​

Uzel row nabízí možnost uvést libovoný atribut.

Potomci​

Uzel row neobsahuje žádné další elementy, ani žádné jiné číselné či řetězcové hodnoty. Uzel nemá povolen prázdný obsah.

Uzel error​

Popis uzlu error, který je potomkem uzlu sql-query-result je umístěn v popisu typových uzlů.

Bližší popis viz. error.