You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@olingo.apache.org by mi...@apache.org on 2015/08/12 09:49:08 UTC
svn commit: r1695437 -
/olingo/site/trunk/content/doc/odata4/tutorials/sqo_es/tutorial_sqo_es.mdtext
Author: mibo
Date: Wed Aug 12 07:49:08 2015
New Revision: 1695437
URL: http://svn.apache.org/r1695437
Log:
Added note for issue OLINGO-741
Modified:
olingo/site/trunk/content/doc/odata4/tutorials/sqo_es/tutorial_sqo_es.mdtext
Modified: olingo/site/trunk/content/doc/odata4/tutorials/sqo_es/tutorial_sqo_es.mdtext
URL: http://svn.apache.org/viewvc/olingo/site/trunk/content/doc/odata4/tutorials/sqo_es/tutorial_sqo_es.mdtext?rev=1695437&r1=1695436&r2=1695437&view=diff
==============================================================================
--- olingo/site/trunk/content/doc/odata4/tutorials/sqo_es/tutorial_sqo_es.mdtext (original)
+++ olingo/site/trunk/content/doc/odata4/tutorials/sqo_es/tutorial_sqo_es.mdtext Wed Aug 12 07:49:08 2015
@@ -409,17 +409,21 @@ The complete `readEntity(...)` method ca
As of OData v4 spec, the expand can also be further refined with system query options
-Example:
-<http://localhost:8080/DemoService/DemoService.svc/Categories?$expand=Products($top=1)>
+Some samples:
-A common use case would be the following request, where all products are displayed along with their corresponding category, but only the interesting properties:
-<http://localhost:8080/DemoService/DemoService.svc/Products?$select=Name,Description&$expand=Category($select=Name)>
+ * Expand an navigation with only the first entity:
+ * <http://localhost:8080/DemoService/DemoService.svc/Categories?$expand=Products($top=1)>
+ **NOTE:** In current `4.0.0-beta-03` version of Olingo is a minor bug which prevents the expand of a navigation which has the same name as an EntitySet (see [OLINGO-741](https://issues.apache.org/jira/browse/OLINGO-741)).
+ Hence above link will work with latest SNAPSHOT version or the final `4.0.0` release.
-With respect to the system query options that are applied to the expand, multiple options are allowed, which are separated by semicolon, e.g.
-<http://localhost:8080/DemoService/DemoService.svc/Categories(1)?$expand=Products($top=1;$select=Name)>
+ * A common use case would be the following request, where all products are displayed along with their corresponding category, but only the interesting properties:
+ * <http://localhost:8080/DemoService/DemoService.svc/Products?$select=Name,Description&$expand=Category($select=Name)>
-The $select option can itself define a list of comma-separated properties:
-<http://localhost:8080/DemoService/DemoService.svc/Categories(1)?$expand=NavToProducts($top=1;$select=Name,Description)>
+ * With respect to the system query options that are applied to the expand, multiple options are allowed, which are separated by semicolon, e.g.
+ * <http://localhost:8080/DemoService/DemoService.svc/Categories(1)?$expand=Products($top=1;$select=Name)>
+
+ * The $select option can itself define a list of comma-separated properties:
+ * <http://localhost:8080/DemoService/DemoService.svc/Categories(1)?$expand=NavToProducts($top=1;$select=Name,Description)>
**Implementation**
@@ -455,6 +459,9 @@ After building and deploying your servic
* <http://localhost:8080/DemoService/DemoService.svc/Products(1)?$expand=Category>
* <http://localhost:8080/DemoService/DemoService.svc/Products(1)?$expand=Category>
* <http://localhost:8080/DemoService/DemoService.svc/Categories(1)?$expand=Products>
+ **NOTE:** In current `4.0.0-beta-03` version of Olingo is a minor bug which prevents the expand of a navigation which has the same name as an EntitySet (see [OLINGO-741](https://issues.apache.org/jira/browse/OLINGO-741)).
+ Hence above link will work with latest SNAPSHOT version or the final `4.0.0` release.
+ * <http://localhost:8080/DemoService/DemoService.svc/Categories(1)?$expand=*>
* Using `$select` and $expand
* <http://localhost:8080/DemoService/DemoService.svc/Products(1)?$select=Name&$expand=Category>