====== 2.1 OData osnove ======

OData((OData - Open Data Protocol: https://www.odata.org/)) (Open Data Protocol) je na REST((Representational State Transfer: https://de.wikipedia.org/wiki/Representational_State_Transfer)) temelječ standard za podatkovne poizvedbe, ki ga je razvil OASIS((OASIS Open: https://www.oasis-open.org/)).

===== Zakaj OData? =====

  * Naravna podpora v [[.:anwender:excel:start|Excel]], [[.:anwender:powerbi:start|Power BI]], [[.:anwender:access:start|Access]]
  * Standardizirana sintaksa poizvedb((OData Query Options: https://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part2-url-conventions.html))
  * Samodejni metapodatki (shema) v obliki CSDL((Common Schema Definition Language: https://docs.oasis-open.org/odata/odata-csdl-json/v4.01/odata-csdl-json-v4.01.html))

===== OData različica =====

Data Gateway podpira **OData v4.01**((OData Version 4.01 Specification: https://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-protocol.html)).

===== Service Document =====

<code>
GET /odata/demo
</code>

Navede vse razpoložljive Entity Sets (tabele/poglede).

===== Metapodatki =====

<code>
GET /odata/demo/$metadata
</code>

Vrne shemo v obliki EDMX((Entity Data Model XML: https://docs.oasis-open.org/odata/odata-csdl-xml/v4.01/odata-csdl-xml-v4.01.html)).

===== Poizvedba Entity Set =====

<code>
GET /odata/demo/Customers
GET /odata/demo/Customers?$top=10
GET /odata/demo/Customers?$filter=Country eq 'Germany'
</code>

===== Query Options =====

^ Možnost ^ Opis ^ Primer ^
| $filter | Filtrira rezultate | $filter=Price gt 100 |
| $select | Izbere stolpce | $select=Name,Price |
| $orderby | Razvrsti rezultate | $orderby=Name desc |
| $top | Omeji število | $top=10 |
| $skip | Preskoči vnose | $skip=20 |
| $count | Prešteje rezultate | $count=true |
| $expand | Naloži razmerja | $expand=Orders |

===== Naprej =====

  * [[.:entwickler:odata:filter|Sintaksa filtra]] za kompleksne poizvedbe
  * [[.:entwickler:odata:paging|Paging]] za velike količine podatkov

===== Viri =====

  * [[https://www.odata.org/|OData.org - uradna spletna stran]]
  * [[https://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part1-protocol.html|OData v4.01 specifikacija (OASIS)]]
  * [[https://docs.oasis-open.org/odata/odata/v4.01/odata-v4.01-part2-url-conventions.html|OData URL konvencije]]