EzGED Wiki

====== 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 source   : **qryid**\\
Valeur du paramètre source: 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 ressource 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 source   : **service**\\
Valeur du paramètre source: 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

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 ressource 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 source   : **url**\\
Valeur du paramètre source: 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

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|}}
EzGED Wiki

Outils pour utilisateurs

Outils du site

Outils de la page
