« Ressource (sdata) » : différence entre les versions
(→Filtre) |
Aucun résumé des modifications |
||
| Ligne 1 : | Ligne 1 : | ||
==Requête sur les entités | ==Requête sur les entités (GET)== | ||
<pre> | |||
GET http://localhost:8080/sdata/gentiers/ttiers('9D33A23CFA6A005500F6000000285DAE') | |||
Response: 200 OK | |||
{ | |||
"$baseUrl":"http://localhost:8080/sdata/l1000/gentiers/-/", | |||
"$title":"TTiers - -", | |||
"$updated":"2020-12-22T08:10:09.740Z", | |||
"$resources":[ | |||
{ | |||
"$url":"TTiers('9D33A23CFA6A005500F6000000285DAE')", | |||
"$title":"ABI Jardin", | |||
"$updated":"2010-03-23T15:37:46.000Z", | |||
"$etag":"9D33A23CFA6A005500F6000000285DAE-000002C60000421C", | |||
"$key":"9D33A23CFA6A005500F6000000285DAE", | |||
"$baseUrl":"http://localhost:8080/sdata/l1000/GenTiers/-/", | |||
"stamp":"000002C60000421C", | |||
.... Attribute list ... | |||
} | |||
] | |||
} | |||
</pre> | |||
===Paramètres de la requête=== | |||
{|class="wikitable" | {|class="wikitable" | ||
| Ligne 9 : | Ligne 31 : | ||
!Usage | !Usage | ||
|- | |- | ||
| | |select | ||
|liste d'attributs séparés par des virgules | |||
|Liste des attributs à retourner | |||
|- | |||
|where | |||
|Expression objet | |Expression objet | ||
|Filtre de la requête | |Filtre de la requête | ||
| Ligne 32 : | Ligne 58 : | ||
|lt,le,gt,ge | |lt,le,gt,ge | ||
|Pagination par clé : direction par rapport à startKey | |Pagination par clé : direction par rapport à startKey | ||
|} | |} | ||
| Ligne 48 : | Ligne 70 : | ||
where=code%20eq%20%27ABI%20007%27 | where=code%20eq%20%27ABI%20007%27 | ||
===Filtre=== | ====Select==== | ||
<pre> | |||
GET http://localhost:8080/sdata/gentiers/ttiers?select=code,caption | |||
</pre> | |||
====Filtre==== | |||
'''Opérateurs:''' | '''Opérateurs:''' | ||
| Ligne 125 : | Ligne 152 : | ||
|} | |} | ||
===Ordre de tri=== | ====Ordre de tri==== | ||
Tri ascendant : | Tri ascendant : | ||
| Ligne 135 : | Ligne 162 : | ||
orderby=code%20desc | orderby=code%20desc | ||
===Pagination par page=== | <pre> | ||
GET http://localhost:8080/sdata/gentiers/ttiers?orderBy=code%20desc | |||
/pre> | |||
====Pagination par page==== | |||
Utiliser orderBy, count et startIndex | Utiliser orderBy, count et startIndex | ||
<pre> | <pre> | ||
GET http://localhost:8080/sdata/gentiers/ttiers?type=application/json&select=code&orderby=code&count=10&startIndex=0 | |||
GET http://localhost:8080/sdata/gentiers/ttiers?type=application/json&select=code&orderby=code&count=10&startIndex=1 | |||
GET http://localhost:8080/sdata/gentiers/ttiers?type=application/json&select=code&orderby=code&count=10&startIndex=2 | |||
... | ... | ||
</pre> | </pre> | ||
===Pagination par clé=== | |||
====Pagination par clé==== | |||
Utiliser orderBy, startKey et keyDirection | Utiliser orderBy, startKey et keyDirection | ||
<pre> | <pre> | ||
GET http://localhost:8080/sdata/gentiers/ttiers?type=application/json&select=code&orderby=code&count=10&startKey=1B28EFFFF1C3000200F6000000230893&keyDirection=lt | |||
</pre> | |||
==Création d'entité (POST)== | |||
<pre> | |||
POST http://localhost:8080/sdata/gentiers/ttiers | |||
{ | |||
"code":"SYFRE1", | |||
"caption":"syfre 1", | |||
"sitesList":[ | |||
{ | |||
"code":"SITE1", | |||
"caption":"site1 de syfre1", | |||
"adresse":{ | |||
"nomRueVoie":"rue de la pompe", | |||
"ville":"Clichy", | |||
"codePostal":"92100", | |||
"pays":{ | |||
"$key":"9D33A23CFA6A005500150000001700FD" | |||
} | |||
} | |||
} | |||
] | |||
} | |||
</pre> | |||
==Modification d'entité (PUT)== | |||
<pre> | |||
PUT http://localhost:8080/sdata/gentiers/ttiers('9D33A23CFA6A005500F6000001E20018') | |||
{ | |||
"codeSIRET":"12345678" | |||
} | |||
</pre> | |||
==Suppression d'entité (DELETE)== | |||
<pre> | |||
DELETE http://localhost:8080/sdata/gentiers/ttiers('9D33A23CFA6A005500F6000001E20018') | |||
</pre> | </pre> | ||
[[Category:SData]] | [[Category:SData]] | ||
Version du 22 décembre 2020 à 08:41
Requête sur les entités (GET)
GET http://localhost:8080/sdata/gentiers/ttiers('9D33A23CFA6A005500F6000000285DAE')
Response: 200 OK
{
"$baseUrl":"http://localhost:8080/sdata/l1000/gentiers/-/",
"$title":"TTiers - -",
"$updated":"2020-12-22T08:10:09.740Z",
"$resources":[
{
"$url":"TTiers('9D33A23CFA6A005500F6000000285DAE')",
"$title":"ABI Jardin",
"$updated":"2010-03-23T15:37:46.000Z",
"$etag":"9D33A23CFA6A005500F6000000285DAE-000002C60000421C",
"$key":"9D33A23CFA6A005500F6000000285DAE",
"$baseUrl":"http://localhost:8080/sdata/l1000/GenTiers/-/",
"stamp":"000002C60000421C",
.... Attribute list ...
}
]
}
Paramètres de la requête
| Paramètre | valeur | Usage |
|---|---|---|
| select | liste d'attributs séparés par des virgules | Liste des attributs à retourner |
| where | Expression objet | Filtre de la requête |
| orderBy | Attribut de tri | Ordre de tri de la requête |
| count | Taille de page | Pagination : Taille de page |
| startIndex | Index de page | Pagination par page : Numéro de page (0 première) |
| startKey | Valeur de clé ou de tri | Pagination par clé : Clé de position |
| keyDirection | lt,le,gt,ge | Pagination par clé : direction par rapport à startKey |
Les valeurs passées en paramètre doivent être encodées en HTML
Exemple :
where=code eq 'ABI 007'
doit être encodée en :
where=code%20eq%20%27ABI%20007%27
Select
GET http://localhost:8080/sdata/gentiers/ttiers?select=code,caption
Filtre
Opérateurs:
| opérateur | équivalence | exemple | encoded |
|---|---|---|---|
| eq | = | where=code eq 'ABI 007' | where=code%20eq%20%27ABI%20007%27 |
| neq | <> | ||
| lt | < | ||
| le | <= | ||
| gt | > | ||
| ge | >= | ||
| like | like | where=code like 'ABI %' | where=code%20like%20%27ABI %25%27 |
| in | in |
Valeurs des paramètres:
Les valeurs des paramètres sont passées en littérale
| Type de donnée | exemple |
|---|---|
| Chaîne | code eq 'xxx' |
| boolean | flag eq true |
| numérique | value eq 1 |
| flottant | value eq 1.0 |
| date | $updated > '2020-12-21T00:00:00' |
Ordre de tri
Tri ascendant :
orderby=code
Tri descendant :
orderby=code%20desc
GET http://localhost:8080/sdata/gentiers/ttiers?orderBy=code%20desc /pre> ====Pagination par page==== Utiliser orderBy, count et startIndex <pre> GET http://localhost:8080/sdata/gentiers/ttiers?type=application/json&select=code&orderby=code&count=10&startIndex=0 GET http://localhost:8080/sdata/gentiers/ttiers?type=application/json&select=code&orderby=code&count=10&startIndex=1 GET http://localhost:8080/sdata/gentiers/ttiers?type=application/json&select=code&orderby=code&count=10&startIndex=2 ...
Pagination par clé
Utiliser orderBy, startKey et keyDirection
GET http://localhost:8080/sdata/gentiers/ttiers?type=application/json&select=code&orderby=code&count=10&startKey=1B28EFFFF1C3000200F6000000230893&keyDirection=lt
Création d'entité (POST)
POST http://localhost:8080/sdata/gentiers/ttiers
{
"code":"SYFRE1",
"caption":"syfre 1",
"sitesList":[
{
"code":"SITE1",
"caption":"site1 de syfre1",
"adresse":{
"nomRueVoie":"rue de la pompe",
"ville":"Clichy",
"codePostal":"92100",
"pays":{
"$key":"9D33A23CFA6A005500150000001700FD"
}
}
}
]
}
Modification d'entité (PUT)
PUT http://localhost:8080/sdata/gentiers/ttiers('9D33A23CFA6A005500F6000001E20018')
{
"codeSIRET":"12345678"
}
Suppression d'entité (DELETE)
DELETE http://localhost:8080/sdata/gentiers/ttiers('9D33A23CFA6A005500F6000001E20018')