Service de téléchargement de données

Vous pouvez télécharger des données sources ou d’autres ressources basées sur des fichiers pourFME Flowworkspaces.

Dans leFME FlowInterface utilisateur Web, le téléchargement de fichiers est disponible pour tousworkspace avec un paramètre publié qui représente un fichier utilisé par leworkspace. Pour plus d'informations, voirTéléchargement de fichiers de données.

NoteLorsque vous travaillez avec des fichiers .zip, nous vous recommandons d'utiliser des utilitaires zip modernes qui prennent en charge les noms de fichiers Unicode. Si les noms de fichiers ne sont pas en Unicode, vous pouvez spécifier DEFAULT_ZIP_CODEPAGEpropriété d'application Web.

Une fois les données téléchargées, les utilisateurs peuvent sélectionner les données téléchargées pour leworkspace à utiliser.

Durée de conservation des fichiers téléchargés

Par défaut, les fichiers sont supprimés un jour après leur téléchargement. Pour modifier, mettez à jour la tâche Delete_DataUpload_Files sur la page Nettoyage du système de l'interface utilisateur Web. Pour plus d'informations, voir NettoyageFME Flow Journaux et autres fichiers .

Éléments de la demande

Méthodes de requête prises en charge

Les méthodes suivantes sont disponibles pour interagir avec le service de téléchargement de données. Les méthodes prises en charge pour l'envoi de fichiers sont PUT et POST. La méthode HTTP GET est prise en charge pour parcourir les fichiers déjà téléchargés.

Seul le stockage volatile est pris en charge et toutes les demandes doivent être associées à unFME Flowworkspace.

Demande	Description de la demande	Méthode HTTP	URI cible
Télécharger un seul fichier	Téléchargez un fichier à l’aide de la méthode HTTP PUT.	METTRE	http://host[:port]/fmedataupload/<dépôt>/<espace de travail>/<nom de fichier>
Télécharger un seul fichier ou plusieurs fichiers	Téléchargez un ou plusieurs fichiers à l'aide d'un simple formulaire de soumission utilisant HTTP POST.	POSTE	http://host[:port]/fmedataupload/<dépôt>/<espace de travail>
Parcourir les fichiers téléchargés	Obtenez une liste de tous les fichiers téléchargés pour une session en effectuant une requête GET, soit vers le même URI utilisé pour télécharger les fichiers à l'origine, soit, dans le cas d'archives, ajoutez à cela un fichier d'archive et/ou un chemin de fichier dans l'archive pour obtenir une liste des fichiers qui s'y trouvent. Utilisez le composant de chemin facultatif à la fin pour afficher le contenu d'un sous-dossier dans un fichier d'archive. Pour signaler uniquement le contenu racine du fichier d'archive, omettez le chemin facultatif.	OBTENIR	http://host[:port]/fmedataupload/<repository>/<workspace>/<archive file name>/[<filename or path within archive>]

Demande

Description de la demande

Méthode HTTP

URI cible

Télécharger un seul fichier

Téléchargez un fichier à l’aide de la méthode HTTP PUT.

METTRE

http://host[:port]/fmedataupload/<dépôt>/<espace de travail>/<nom de fichier>

Télécharger un seul fichier ou plusieurs fichiers

Téléchargez un ou plusieurs fichiers à l'aide d'un simple formulaire de soumission utilisant HTTP POST.

POSTE

http://host[:port]/fmedataupload/<dépôt>/<espace de travail>

Parcourir les fichiers téléchargés

Obtenez une liste de tous les fichiers téléchargés pour une session en effectuant une requête GET, soit vers le même URI utilisé pour télécharger les fichiers à l'origine, soit, dans le cas d'archives, ajoutez à cela un fichier d'archive et/ou un chemin de fichier dans l'archive pour obtenir une liste des fichiers qui s'y trouvent.

Utilisez le composant de chemin facultatif à la fin pour afficher le contenu d'un sous-dossier dans un fichier d'archive. Pour signaler uniquement le contenu racine du fichier d'archive, omettez le chemin facultatif.

OBTENIR

http://host[:port]/fmedataupload/<repository>/<workspace>/<archive file name>/[<filename or path within archive>]

Paramètres de la demande

Nom	Valeur	Description
opt_fullpath	vrai \| faux Par défaut : faux	Lorsque cette option est activée, la réponse du service inclut le chemin physique ou absolu de chaque fichier que le moteur FME peut utiliser.
opt_namespace	<valeur>	Si spécifié, les téléchargements sont placés dans un dossier nommé <valeur>. Si non spécifié, les téléchargements sont placés dans un dossier nommé d'après le nom du téléchargementutilisateur. NoteSi une application utilise un seuljeton se connecter àFME Flow, nous vous recommandons de spécifier un identifiant de session, un nombre aléatoire ou un GUID pour distinguer les téléchargements individuels et empêcher plusieurs utilisateurs de télécharger des fichiers avec des noms de fichiers en conflit vers le même référentiel/workspace emplacement.
opt_extractarchive Ce paramètre n'est pas disponible dans HTTP GET car l'extraction d'archives est une opération et non un indicateur d'état.	vrai \| faux Par défaut : faux	Lorsqu'il est activé, le service extrait les fichiers zip téléchargés et renvoie le contenu du fichier à l'intérieur des fichiers zip. Dans ce cas, les noms de fichiers sont des chemins logiques relatifs au conteneur des fichiers zip. Par exemple, un fichier SHAPE nommé roads.shp à l'intérieur d'un fichier roads.zip est renvoyé sous la forme roads.zip/roads.shp. Si la valeur est fausse et que le chemin demandé inspecte le contenu d'un fichier zip ou d'une archive, une réponse d'erreur est générée. Si la valeur est fausse et que le chemin demandé est valide, mais que opt_pathlevel est égal à 2 ou plus, un niveau de chemin de 1 est implicite.
opt_responseformat	xml \| json Par défaut : xml	Définit la langue de la réponse. Le texte doit être entièrement en minuscules.
opt_pathlevel	-1 \| 0 \| n Par défaut : 1	Spécifie le nombre de niveaux de récursivité à utiliser pour afficher les informations sur les fichiers et les dossiers. Une valeur de -1 spécifie une récursivité complète aussi profonde soit-elle. Une valeur de 0 signifie qu'aucune information n'est renvoyée. Tout autre nombre positif indique le nombre de niveaux de récursivité. Par exemple, une valeur de 1 demande uniquement les fichiers dans le chemin demandé ; c'est-à-dire uniquement les enfants du chemin demandé et non les descendants.

Éléments de réponse

Élément	Éléments enfants	Valeur	Description
statutInfo	statut	succès \| échec	L'état du service.
fichier, dossier, archive	nom	chaîne	Le nom du fichier qui a été téléchargé.
	taille	entier long	La taille en octets du fichier téléchargé. L'élément de taille ne s'applique pas aux dossiers et est absent sous les éléments de dossier.
	chemin	chaîne	Le chemin absolu ou physique du fichier (qui est utilisé par un moteur FME).
session	aucun	chaîne	Un identifiant de session qui est toujours inclus dans le corps de la réponse. La valeur est la valeur du paramètre de demande opt_namespace, s'il est spécifié, ou le nom de l'utilisateur qui télécharge.