Table des matières

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:

chemins_depots.json
{
	"rows" : [
		{"description": "Répertoire Foo", "chemin": "D:\\test\\foo"},
		{"description": "Répertoire Bar", "chemin": "D:\\test\\bar"}
	]
}

Paramètres requis

  1. qryid / service / url ⇒ le nom du paramètre et la valeur attendue dépend du type de ressource
  2. desc_field ⇒ Indique le nom de la propriété de l'item (issu du JSON) qui contient la description du chemin.
  3. 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:

{
	"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
}

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:

{
	"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
}

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:

chemins_depots.json
{
	"rows" : [
		{"description": "Foo sur disque D:", "chemin": "D:\\test\\foo"},
		{"description": "Bar sur disque D:", "chemin": "D:\\test\\bar"}
	]
}

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: