index.html

---
layout: default
---
<div class="container">
  <div id="myCarousel" class="carousel slide row" data-ride="carousel">
    <!-- Indicators -->
    <ol class="carousel-indicators">
      <li data-target="#myCarousel" data-slide-to="0" class="active"></li>
      <li data-target="#myCarousel" data-slide-to="1"></li>
    </ol>

    <!-- Wrapper for slides -->
    <div class="carousel-inner zero-side-margin" aria-label="OData Description">
      <div class="item active">
        <img src="{{ '/assets/homepage_1.jpg' | prepend: site.baseurl | prepend: site.url }}" alt="Home">
        <div class="carousel-caption jumbotron transparent-background">
            <h1 class="text-center">OData - the best way to REST</h1>
            <p class="text-center">An <b>open protocol</b> to allow the creation and consumption of <b>queryable</b> and <b>interoperable RESTful APIs</b> in a <b>simple</b> and <b>standard</b> way.</p>
        </div>
      </div>
      <div class="item">
        <img src="{{ '/assets/homepage_2.jpg' | prepend: site.baseurl | prepend: site.url}}" alt="Blog" style="opacity:1.0">
        <div class="carousel-caption jumbotron" style="background-color: rgba(255,255,255,0.5)">
            <h1 class="text-center bottom-margin">Recent Posts</h1>
            <div class="row transparent-background">
              {% for post in site.posts %}
                {% if forloop.index < 5 %}
                <div class="col-md-3 text-left">
                  <h4><a href='{{post.url}}'>{{post.title}}</a></h4>
                  By <em>{{ post.author }}</em>
                </div>
                  {% endif %}
                {% endfor %}
            </div>
        </div>
      </div>

    </div>

    <!-- Left and right controls -->
    <a class="left carousel-control" href="#myCarousel" onclick="$('#myCarousel').carousel('pause');" role="button" data-slide="prev">
        <svg xmlns="https://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" class="bi bi-chevron-left" viewBox="0 0 16 16" aria-hidden="true">
            <path fill-rule="evenodd" d="M11.354 1.646a.5.5 0 0 1 0 .708L5.707 8l5.647 5.646a.5.5 0 0 1-.708.708l-6-6a.5.5 0 0 1 0-.708l6-6a.5.5 0 0 1 .708 0z" />
        </svg>
        <span class="sr-only">Previous</span>
    </a>
    <a class="right carousel-control" href="#myCarousel" onclick="$('#myCarousel').carousel('pause');" role="button" data-slide="next">
        <svg xmlns="https://www.w3.org/2000/svg" width="16" height="16" fill="currentColor" class="bi bi-chevron-right" viewBox="0 0 16 16">
            <path fill-rule="evenodd" d="M4.646 1.646a.5.5 0 0 1 .708 0l6 6a.5.5 0 0 1 0 .708l-6 6a.5.5 0 0 1-.708-.708L10.293 8 4.646 2.354a.5.5 0 0 1 0-.708z" />
        </svg>
        <span class="sr-only">Next</span>
    </a>
  </div>
  <div class="row">
<!--
      <div class="col-md-7">
        <p id="GeoResults"><iframe width=100% height=230px src="https://www.youtube.com/embed/wH5TUwzlaWI"></iframe></p>
      </div>
      <div class="col-md-5">
-->
          <p>OData (Open Data Protocol) is an <a href="https://www.oasis-open.org/news/pr/iso-iec-jtc-1-approves-oasis-odata-standard-for-open-data-exchange">ISO/IEC approved</a>, <a href="https://www.oasis-open.org/committees/tc_home.php?wg_abbrev=odata">OASIS standard</a> that defines a set of best practices for building and consuming RESTful APIs. OData helps you focus on your business logic while building RESTful APIs without having to worry about the various approaches to define request and response headers, status codes, HTTP methods, URL conventions, media types, payload formats, query options, etc. OData also provides guidance for tracking changes, defining functions/actions for reusable procedures, and sending asynchronous/batch requests.</p>
          <p>OData RESTful APIs are easy to consume. The OData metadata, a machine-readable description of the data model of the APIs, enables the creation of powerful generic client proxies and tools. </p>
<!--      
    </div> 
-->
  </div>

<!--
  <div id="CustomerQuotation" class="carousel slide row" data-ride="carousel">
      <ol class="carousel-indicators">
        <li data-target="#myCarousel" data-slide-to="0" class="active"></li>
        <li data-target="#myCarousel" data-slide-to="1"></li>
        <li data-target="#myCarousel" data-slide-to="2"></li>
      </ol>

      <div class="carousel-inner" role="listbox">
        <div class="item active" style="background-color:orange; color:black; padding:50px;">
                <h1>"Blah blah blah blah blah"</h1>
                <h2 class="text-right">-- Author Name, author title, company</h2>
        </div>

        <div class="item" style="background-color:orange; color:black; padding:50px;">
          <h1>"Blah blah blah blah blah"</h1>
          <h2 class="text-right">-- Author Name, author title, company</h2>
        </div>

        <div class="item" style="background-color:orange; color:black; padding:50px;">
          <h1>"Blah blah blah blah blah blah blah blah"</h1>
          <h2 class="text-right">-- Author Name, author title, company</h2>
        </div>

      </div>
  </div>
  <div>
      <h2 class="text-center">OData has a rich <strong>Ecosystem</strong>. <strong><a href='/ecosystem/'>Click Here</a></strong> to find more!</h2>
  </div>
-->
  <!-- customer logos
  <div class="row icon">
    <div class="col-md-2">
      <img src="/assets/ODataLogo-150.png" alt="Icon1">
    </div>
    <div class="col-md-2">
      <img src="/assets/ODataLogo-150.png" alt="Icon1">
    </div>
    <div class="col-md-2">
      <img src="/assets/ODataLogo-150.png" alt="Icon1">
    </div>
    <div class="col-md-2">
      <img src="/assets/ODataLogo-150.png" alt="Icon1">
    </div>
    <div class="col-md-2">
      <img src="/assets/ODataLogo-150.png" alt="Icon1">
    </div>
    <div class="col-md-2">
      <img src="/assets/ODataLogo-150.png" alt="Icon1">
    </div>
  </div>
-->
  <div class="row floating-box">
    <div class="col-md-6 margin-bottom">
      <h2 class="text-left theme-font">Tools</h2>
      <table>
        <tr>
          <td width="40%"><img src="{{'/assets/vs_code_for_odata.gif' | prepend: site.baseurl | prepend: site.url}}" alt="Visual Studio Code for OData" width = 90%></td>
          <td>
            <h3><a href="https://marketplace.visualstudio.com/items?itemName=stansw.vscode-odata ">Visual Studio Code for OData</a></h3>
            <p>OData for Visual Studio Code is a Visual Studio Code extension that adds rich support for the OData query language</p>
          </td>
        </tr>
        <!--
          <tr>
          <td width="40%"><img src="{{'/assets/odata_validator.jpg' | prepend: site.baseurl | prepend: site.url}}" alt="odata_validator" width = 90%></td>
          <td>
            <h3><a href="https://services.odata.org/validation/">OData Validator</a></h3>
            <p>A tool to enable OData service authors to ensure that their service interoperates well with any OData client. It also enables consumers to test OData services.</p>
          </td>
        </tr>
        -->
        <tr>
          <td width="40%"><img src="{{'/assets/xodata_tool.jpg' | prepend: site.baseurl | prepend: site.url}}" alt="xodata" width="90%"></td>
          <td>
            <h3><a href="https://pragmatiqa.com/xodata/">XOData</a></h3>
            <p>XOData is a generic online OData API/Service visualizer and explorer. It assists in rapid prototyping, verification, testing, and documentation of OData APIs. With XOData Chrome App it's also possible to explore OData Services deployed locally or on private networks.</p>
          </td>
        </tr>
      </table>
    </div>
    <div class="col-md-6">
      <h2 class="text-left theme-font">Resources</h2>

      <div class="row">
        <div class="col-md-4">
          <img src="{{'/assets/howtouse-03.png' | prepend: site.baseurl | prepend: site.url}}" alt="Getting Started" width="120px">
        </div>
        <div class="col-md-8">
          <h4><a href="/getting-started/"> Getting Started </a></h4>
          <p>To get started, take a look at <a href="/getting-started/understand-odata-in-6-steps/">Understanding OData in 6 steps</a>. And then the <a href="/getting-started/basic-tutorial/">Basic Tutorial</a>, <a href="/getting-started/advanced-tutorial/">Advanced Tutorial</a> and <a href="/getting-started/learning-odata-on-postman/">Postman Tutorial</a> will provide practical samples to learn OData.</p>
        </div>
      </div>
      <div class="row">
        <div class="col-md-4">
          <img src="{{'/assets/howtouse-01.png' | prepend: site.baseurl | prepend: site.url}}" alt="Documentation" width="120px">
        </div>
        <div class="col-md-8">
          <h4><a href="/documentation/">Standard</a></h4>
          <p>OData v4 is standardized by OASIS, including <a href="https://docs.oasis-open.org/odata/odata/v4.0/odata-v4.0-part1-protocol.html">Protocol Specification</a>, <a href="https://docs.oasis-open.org/odata/odata/v4.0/odata-v4.0-part2-url-conventions.html">URL Conversions</a>, <a href="https://docs.oasis-open.org/odata/odata/v4.0/odata-v4.0-part3-csdl.html">Common Schema Definition Language</a>, <a href="https://docs.oasis-open.org/odata/odata-json-format/v4.0/odata-json-format-v4.0.html">JSON Format Specification, <a href="https://docs.oasis-open.org/odata/odata/v4.0/errata02/os/complete/abnf/">ABNF</a>, <a href="https://docs.oasis-open.org/odata/odata/v4.0/errata02/os/complete/vocabularies/">Standardized Vocabularies</a>, and <a href="https://docs.oasis-open.org/odata/odata-data-aggregation-ext/v4.0/odata-data-aggregation-ext-v4.0.html">Aggregation Extension</a>. OData v4 can also be ordered from ISO/IEC as <a href="https://www.iso.org/iso/catalogue_detail.htm?csnumber=69208">ISO/IEC 20802-1:2016</a> (OData 4.0 Protocol) and <a href="https://www.iso.org/iso/catalogue_detail.htm?csnumber=69209">ISO/IEC 20802-2:2016</a> (OData 4.0 JSON Format)</p>
        </div>
      </div>
      <div class="row">
        <div class="col-md-4">
          <img src="{{'/assets/howtouse-02.png' | prepend: site.baseurl | prepend: site.url}}" alt="Libraries" width="120px">
        </div>
        <div class="col-md-8">
          <h4><a href="/libraries/">Libraries</a></h4>
          <p>There are several of libraries to facilitate building and consuming OData service. <a href="https://odata.github.io/RESTier/">Restier</a> is the main library for .NET framework. <a href="https://olingo.apache.org/">Apache Olingo</a> is for Java platform to build OData service.</p>
        </div>
      </div>
      <div class="row">
        <div class="col-md-4">
          <img src="{{'/assets/howtouse-04.png' | prepend: site.baseurl | prepend: site.url}}" alt="Presentations" width="120px">
        </div>
        <div class="col-md-8">
          <h4><a href="{{'/odata-services/' | prepend: site.baseurl | prepend: site.url}}">Sample Services</a></h4>
          <p>There are several OData sample services to help you practice with OData API. <a href="https://services.odata.org/TripPinRESTierService/">TripPin Service</a> is the main sample service.</p>
        </div>
      </div>
    </div>
  </div>
  </div>
</div>

<script>
  $(function(){
    var myCarousel = $("#myCarousel");

    $('#myCarousel.slide').carousel({
        interval: 5000,
        pause: "hover"
    });
    
    $('input').focus(function(){
       myCarousel.carousel('pause');
    }).blur(function() {
      myCarousel.carousel('cycle');
    });

    var carousel = document.getElementById('myCarousel');

    var liveRegion = document.createElement('span');
    liveRegion.setAttribute('aria-live', 'polite');
    liveRegion.setAttribute('aria-atomic', 'true');
    liveRegion.setAttribute('class', 'live-region sr-only');
    carousel.appendChild(liveRegion);

    var headers = $(myCarousel).find('div.carousel-inner > div > div > h1');

    myCarousel.on('slid.bs.carousel', function () {
      var activeSlide = $('#myCarousel > div.carousel-inner > div.active > div > h1');
      var captionText = activeSlide.text();
      var position =  headers.index(activeSlide) + 1
      liveRegion.textContent = 'Slide ' + position + ' of ' + headers.length + ' - ' + captionText;
    });
});
</script>