FME Flow:2025.1
Le service de téléchargement de données fournit aux utilisateurs la sortie d'unworkspace sous forme de fichier zip téléchargeable. En règle générale, le service permet aux utilisateurs de spécifier les couches de données, le format et le système de coordonnées pour le téléchargement.
Ce service est demandé via une URL ou un formulaire. Par exemple:
http://<hôte>/fmedatadownload/ <dépôt> / <espace de travail>.fmw?<paramètres>
Une page Web s'ouvre avec un lien vers un fichier zip contenant les résultats de l'workspace traduction. De plus, un email peut être envoyé avec un lien vers le fichier zip.
Le téléchargement est renvoyé sous forme de fichier zip (archive compressée) pour les raisons suivantes :
- Le résultat est un certain nombre d’ensembles de données de sortie (et pas seulement un seul ensemble de données).
- Les ensembles de données basés sur des dossiers ne sont pas constitués d'un seul fichier ; par exemple, le format ESRI Shape contient des fichiers avec l'extension .shp, .shx, .dbf et quelques autres.
- Même les ensembles de données basés sur des fichiers peuvent être constitués de plusieurs fichiers ; par exemple, un ensemble de données GML comprend à la fois un fichier GML et un fichier XSD (définition de schéma XML).
NoteLe fichier zip deworkspaceLes répertoires qui écrivent plusieurs ensembles de données dans un répertoire fanout sont composés de plusieurs dossiers contenant les ensembles de données distincts. Ces dossiers sont contenus dans un seul dossier dont le nom est basé sur le répertoire de destination Fanout.
FME Flowpeut également fournir une sortie qui n'est pas compressée en utilisant leDiffusion de données en continu service.
LeService de téléchargement de données fonctionne en conjonction avec le téléchargement de données, le streaming de données etSoumissionnaire d'emploi services de téléchargement de fichiers.
Exigences
Ce service fonctionne avec n'importe quelworkspace qui écrit un ou plusieurs fichiers. Aucun paramètre publié n'est requis. Il n'est pas possible d'exécuter un téléchargement de données sur unworkspace dont la destination est un format de base de données.
NoteVous souhaiterez peut-être publier certains paramètres de votreworkspace pour contrôler la traduction à partir de l'URL ou de la demande de formulaire. Par exemple, les types d'entités à lire, le système de coordonnées de sortie et le format (rédacteur générique) sont des paramètres généralement publiés lors de l'utilisation de ce service.
Paramètres de demande spécifiques au service
|
Nom |
Valeur |
Description |
|---|---|---|
|
opt_responseformat |
xml | json |
La langue de la réponse. Le texte doit être entièrement en minuscules. |
| opt_geturl | L'URL d'un ensemble de données | L'URL de l'ensemble de données source à utiliser pour la transformation |
| opt_showresult | vrai | faux | Si les réponses XML/JSON incluent le résultat de la transformation FME. La valeur par défaut est true si ce paramètre n'est pas présent. |
| opt_servicemode | synchronisation | asynchrone | planification |
Bascule entre les modes synchrone et asynchrone du service. Lorsque les tâches sont soumises de manière asynchrone (async), la réponse de réussite ou d'échec de soumission est renvoyée immédiatement. Lorsque l'option est définie sur synchrone (sync), la réponse n'est pas renvoyée tant que la tâche n'est pas terminée. Ou, planifie une demande de téléchargement de données pour qu'elle s'exécute à une heure de début spécifiée (une seule fois). Si un calendrier est spécifié, voir ci-dessous pour des paramètres supplémentaires. |
| opt_requesteremail | adresses e-mail séparées par des virgules | Adresses auxquelles les messages électroniques de notification sont envoyés. |
Directives de notification
Ce service prend en chargeDirectives de notification.
Exemple
Spécification de la rubrique du service de notification pour notifier lorsqu'un travail réussit ou échoue, respectivement.
http://localhost/fmedatadownload/Samples/austinApartments.fmw?&nm_jobsuccess_topic=DATADOWNLOAD_ASYNC_JOB_SUCCESS&nm_jobfailure_topic=DATADOWNLOAD_ASYNC_JOB_FAILURE
Planification d'une demande de téléchargement de données
En utilisantopt_servicemode=planification, vous pouvez planifier une demande de téléchargement de données pour qu'elle s'exécute une fois à une heure de début spécifiée. Les paramètres supplémentaires suivants sont requis :
| Nom | Valeur | Description |
|---|---|---|
| déclenchement | courir une fois | Indique que la tâche est planifiée pour s'exécuter une fois. Seulementcourir une foisest pris en charge. |
| commencer | <aaaa-MM-jj HH:mm:ss> | la date/heure d'exécution du travail. Si la date/heure est antérieure à l'heure actuelle, la tâche s'exécute immédiatement. |
| catégorie | <catégorie _nom> | Le nom de la catégorie générale ou du groupe auquel appartient la tâche. |
| nom | <nom du calendrier> | Le nom de la tâche. Les noms doivent être uniques au sein d'une catégorie. Une fois qu'une tâche planifiée pour s'exécuter une fois est terminée, elle est automatiquement supprimée. |
| description | <description> | La description de la tâche. |
Utilisation de données distantes lors d'une requête
Utilisation des données du corps HTTP POST comme ensemble de données du lecteur
Ce service Web peut recevoir des données et remplacer l'ensemble de données source via HTTP POST. Le contenu du corps de la requête POST sera enregistré dans un fichier temporaire qui sera utilisé comme ensemble de données du lecteur.workspace. S'il y a plus d'un lecteur dans leworkspace, vous devrez alors indiquer quel lecteur utilisera le fichier temporaire. Vous indiquez votre choix lors de la publication duworkspace en modifiant l'enregistrement du service.
Utilisation des données de HTTP GET comme ensemble de données de lecture
Ce service Web peut recevoir des données et remplacer l'ensemble de données du lecteur via HTTP GET. L'ensemble de données doit être spécifié sous forme d'URL et transmis au service par le paramètre « opt_geturl ». Les URL HTTP et FTP sont prises en charge. S'il y a plus d'un lecteur dans leworkspace, vous devrez alors indiquer quel lecteur utilisera le fichier temporaire. Vous indiquez votre choix lors de la publication duworkspace en modifiant l'enregistrement du service.
Par exemple, voici une demande de service qui utilise un ensemble de données KMZ distant :
http://<hôte>/fmedatadownload/Test/Viewer.fmw?opt_geturl=http://data.vancouver.ca/download/kml/elementary_school_boundaries.kmz
Éléments de réponse
Si le format de réponse est spécifié comme XML ou JSON, une réponse de service peut contenir les éléments indiqués dans le tableau suivant :
|
Élément |
Éléments enfants |
Valeur |
Description |
|---|---|---|---|
|
statutInfo |
message |
chaîne de message |
message d'échec de service |
|
statut |
succès | échec |
état du service |
|
|
mode |
synchronisation | asynchrone |
mode service |
|
|
Résultat de la transformation fme |
fmeServerResponse |
FME Flowpropriétés de réponse |
FME Flowréponse |
|
fmeEngineResponse |
Propriétés de réponse du moteur FME |
Réponse du moteur FME |
|
|
|
aucun |
Adresses e-mail |
Adresses e-mail des demandeurs |
|
URL |
aucun |
chaîne d'URL |
URL utilisée pour télécharger le jeu de données de résultats (ZIP) |
|
identifiant de travail |
aucun |
identifiant de travail |
L'identifiant du travail actuel |
Activation des notifications par e-mail
Le service de téléchargement de données peut envoyer des messages électroniques pour vous avertir lorsqu'une tâche se termine avec succès ou sans succès. Si une tâche se termine avec succès, l'e-mail fournit un lien cliquable ou un fichier zip pour télécharger les données.
Pour plus d'informations, voirConfigurationFME Flow pour envoyer des notifications par e-mail.