====== URL d'accès ======
<url_site_ezged>/apps/ezuploader/

Exemple: http://localhost/ezged/apps/ezuploader/

====== Paramétrage ======

Le passage des paramètres de l'application s'effectue via la query string (paramètres dans l'URL).
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 d'un contenu JSON valide:
<file json chemins_depots.json>
{
	"rows" : [
		{"description": "Répertoire Foo", "chemin": "D:\\test\\foo"},
		{"description": "Répertoire Bar", "chemin": "D:\\test\\bar"}
	]
}
</file>

===== Paramètres requis =====

  - **qryid** / **service** / **url** => le nom du paramètre et la valeur attendue dépend du type de ressource 
  - **desc_field** => Indique le nom de la propriété de l'item (issu du JSON) qui contient la description du chemin.
  - **value_field** => Indique le nom de la propriété de l'item (issu du JSON) à lire pour avoir le chemin

===== Types de ressources =====

==== Requête EzGED ====
Nom du paramètre    : **qryid**\\
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

Le contenu de la réponse au format json:
<code>
{
	"errorcode": 0,
	"errormsg": "ok",
	"rows": [
		{
			"DEPOTCOLD_ID": 4,
			"DEPOTCOLD_DESC": "Répertoire foo dans ocr/wait",
			"type": "row",
			"DEPOTCOLD_DIR": "foo"
		},
		{
			"DEPOTCOLD_ID": 3,
			"DEPOTCOLD_DESC": "Répetoire bar dans ocr/wait",
			"type": "row",
			"DEPOTCOLD_DIR": "bar"
		},
		{
			"DEPOTCOLD_ID": 2,
			"DEPOTCOLD_DESC": "Répertoire exemple1",
			"type": "row",
			"DEPOTCOLD_DIR": "D:\\exemple1"
		},
		{
			"DEPOTCOLD_ID": 1,
			"DEPOTCOLD_DESC": "Répertoire exemple2",
			"type": "row",
			"DEPOTCOLD_DIR": "D:\\GED\\exemple2\\"
		}
	],
	"count": 4
}
</code>

==== Service EzGED ====

Nom du paramètre : **service**\\
Valeur du paramètre : chaîne d'appel d'un service ezged.

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
des lanceurs COLD de type "Répertoire local".

Contenu de la réponse au format json:
<code json>
{
	"errorcode": 0,
	"errormsg": "ok",
	"rows": [
		{
			"COLDSCNTHROWER_ID": 130,
			"COLDSCNTHROWER_PORT": 0,
			"COLDSCNTHROWER_PASSWORD": "",
			"COLDSCNTHROWER_PROTO": 4,
			"COLDSCNTHROWER_HOST": "",
			"COLDSCNTHROWER_USER": "",
			"COLDSCNTHROWER_PATTERN": "/.*\\.(?!txt).*/",
			"COLDSCNTHROWER_PATH": "C:\\nchp\\var\\spool\\ezged\\instance\\ocr\\wait\\one",
			"COLDSCNTHROWER_DESC": "Indexeur One",
			"COLDSCNTHROWER_OLDERTHANINSEC": 0,
			"type": "coldscnthrower"
		},
		{
			"COLDSCNTHROWER_ID": 136,
			"COLDSCNTHROWER_PORT": 0,
			"COLDSCNTHROWER_PASSWORD": "admin",
			"COLDSCNTHROWER_PROTO": 4,
			"COLDSCNTHROWER_HOST": "",
			"COLDSCNTHROWER_USER": "admin",
			"COLDSCNTHROWER_PATTERN": "*.*",
			"COLDSCNTHROWER_PATH": "F:\\nchp\\var\\spool\\ezged\\instance\\ocr\\wait\\test",
			"COLDSCNTHROWER_DESC": "Lanceur Test",
			"COLDSCNTHROWER_OLDERTHANINSEC": 0,
			"type": "coldscnthrower"
		}
	],
	"count": 0
}
</code>

==== Autre ressource ====

Nom du paramètre : **url**\\
Valeur du paramètre : l'url à appeler.

/!\ 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

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:
<file json chemins_depots.json>
{
	"rows" : [
		{"description": "Foo sur disque D:", "chemin": "D:\\test\\foo"},
		{"description": "Bar sur disque D:", "chemin": "D:\\test\\bar"}
	]
}
</file>

====== Intégration dans l'interface utilisateur ======

En suivant les indications ci-dessus pour la construction de l'URL d'appel de l'application
vous pouvez créer un lien dans l'interface EzGED vers l'application.
Ainsi vous aurez une zone d'upload accessible depuis l'interface EzGED.

Captures d'écrans:\\
{{::integration_ezuploader_param.png?600|}}

{{:integration_ezuploader.png?600|}}