Ci-dessous, les différences entre deux révisions de la page.
Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente | ||
ezuploader [2020/04/29 13:17] florian |
ezuploader [2023/03/17 09:56] (Version actuelle) |
||
---|---|---|---|
Ligne 7: | Ligne 7: | ||
Le passage des paramètres de l'application s'effectue via la query string (paramètres dans l'URL). | Le passage des paramètres de l'application s'effectue via la query string (paramètres dans l'URL). | ||
- | La ressource doit retourner du JSON (le nom de la propriété racine contenant la liste des items doit être "rows"). | + | La ressource sur laquelle s'appuie l'application pour peupler la liste des destinations doit fournir un contenu au format JSON (le nom de la propriété racine contenant la liste des items doit être "rows"). |
- | Exemple de retour JSON valide: | + | Exemple d'un contenu JSON valide: |
<file json chemins_depots.json> | <file json chemins_depots.json> | ||
{ | { | ||
"rows" : [ | "rows" : [ | ||
- | {"description": "Foo sur disque D:", "chemin": "D:\\test\\foo"}, | + | {"description": "Répertoire Foo", "chemin": "D:\\test\\foo"}, |
- | {"description": "Bar sur disque D:", "chemin": "D:\\test\\bar"} | + | {"description": "Répertoire Bar", "chemin": "D:\\test\\bar"} |
] | ] | ||
} | } | ||
Ligne 21: | Ligne 21: | ||
===== Paramètres requis ===== | ===== Paramètres requis ===== | ||
- | - **qryid** / **service** / **url** => le nom du paramètre et la valeur attendue dépend du type de source | + | - **qryid** / **service** / **url** => le nom du paramètre et la valeur attendue dépend du type de ressource |
- | - La description de la destination => paramètre **desc_field** qui indique le nom de la propriété de l'item à lire pour avoir la description. | + | - **desc_field** => Indique le nom de la propriété de l'item (issu du JSON) qui contient la description du chemin. |
- | - La chemin de destination => paramètre **value_field** qui indique le nom de la propriété de l'item à lire pour avoir le chemin | + | - **value_field** => Indique le nom de la propriété de l'item (issu du JSON) à lire pour avoir le chemin |
===== Types de ressources ===== | ===== Types de ressources ===== | ||
==== Requête EzGED ==== | ==== Requête EzGED ==== | ||
- | Nom du paramètre source : **qryid**\\ | + | Nom du paramètre : **qryid**\\ |
- | Valeur du paramètre source: un identifiant de requête ezged. | + | Valeur du paramètre : un identifiant de requête ezged. |
Exemple: http://localhost/ezged/apps/ezuploader/?qryid=721&desc_field=DEPOTCOLD_DESC&value_field=DEPOTCOLD_DIR | Exemple: http://localhost/ezged/apps/ezuploader/?qryid=721&desc_field=DEPOTCOLD_DESC&value_field=DEPOTCOLD_DIR | ||
- | Le contenu de la ressource au format json: | + | Le contenu de la réponse au format json: |
<code> | <code> | ||
{ | { | ||
Ligne 70: | Ligne 70: | ||
==== Service EzGED ==== | ==== Service EzGED ==== | ||
- | Nom du paramètre source : **service**\\ | + | Nom du paramètre : **service**\\ |
- | Valeur du paramètre source: chaîne d'appel d'un service ezged. | + | Valeur du paramètre : chaîne d'appel d'un service ezged. |
- | Exemple: http://localhost/ezged/apps/ezuploader/?service=coldscnthrower/loadall&coldscnthrowerproto=4&desc_field=COLDSCNTHROWER_DESC&value_field=COLDSCNTHROWER_PATH | + | Exemple: http://localhost/ezged/apps/ezuploader/?service=coldscnthrower/loadall&coldscnthrowerproto=0&desc_field=COLDSCNTHROWER_DESC&value_field=COLDSCNTHROWER_PATH |
On appelle ici le service //coldscnthrower/loadall&coldscnthrowerproto=4// qui permet d'obtenir la liste | On appelle ici le service //coldscnthrower/loadall&coldscnthrowerproto=4// qui permet d'obtenir la liste | ||
des lanceurs COLD de type "Répertoire local". | des lanceurs COLD de type "Répertoire local". | ||
- | Contenu de la ressource au format json: | + | Contenu de la réponse au format json: |
<code json> | <code json> | ||
{ | { | ||
Ligne 117: | Ligne 117: | ||
==== Autre ressource ==== | ==== Autre ressource ==== | ||
- | Nom du paramètre source : **url**\\ | + | Nom du paramètre : **url**\\ |
- | Valeur du paramètre source: l'url à appeler. | + | Valeur du paramètre : l'url à appeler. |
/!\ Attention: la ressource doit être relative au site ezged. | /!\ Attention: la ressource doit être relative au site ezged. | ||
Exemple: http://localhost/ezged33/apps/ezuploader/?url=resources/chemins_depots.json&desc_field=description&value_field=chemin | Exemple: http://localhost/ezged33/apps/ezuploader/?url=resources/chemins_depots.json&desc_field=description&value_field=chemin | ||
+ | |||
+ | Va lire la liste des chemins déclarés dans le fichier chemins_depots.json qui se trouve dans le répertoire resources (lui-même dans www qui est la racine du site ezged) | ||
Contenu de la ressource au format json: | Contenu de la ressource au format json: | ||
Ligne 134: | Ligne 136: | ||
</file> | </file> | ||
- | ==== Intégration dans l'interface utilisateur ==== | + | ====== Intégration dans l'interface utilisateur ====== |
En suivant les indications ci-dessus pour la construction de l'URL d'appel de l'application | En suivant les indications ci-dessus pour la construction de l'URL d'appel de l'application |