IGNFCollaboratifGetReportConnector
Ce Transformer permet de télécharger un signalement venant du site espacecollaboratif.ign.fr.
L'utilisateur peut posséder un compte sur l'Espace Collaboratif, l'utilisation de ce compte permet d'accéder aux signalements privés visibles de ce compte, en sus des signalement publics.
Note
L'utilisation d'IGNFCollaboratifGetReportConnector sans compte ne donne accès qu'aux signalements publics. Tous les paramètres de IGNFCollaboratifGetReportConnector sont pilotables par des attributs des features entrantes ou des paramètres utilisateurs du workbench. Les requêtes sont pour le moment sérialisées et ralenties à 1 par seconde.
Configuration
Ports d'entrée
Ports de sortie
Passthrough_data
Toutes les entités entrantes ressortent avec leurs géométries et attributs initiaux, non altérés.
Attributs en entrée ;
_signalement_id = numéro d'identifiant du signalement à télécharger.
Reports
Les requêtes de recherche de signalement peuvent retourner des signalements, qui sont alors décrits comme des entités de type fme_point de système de coordonnées géographique WGS84 (EPSG:4326) d'attributs:
signalement_id = identifiant du signalement créé ;
groupe_id = numéro d'identifiant EspaceCollaboratif du groupe dans lequel le signalement a été fait ;
auteur.id = numéro d'identifiant de l'auteur du signalement ;
auteur.username = pseudo de l'auteur du signalement ;
commune.insee = code insee de la commune ;
commune.nom = nom de la commune (en majuscules non accentuées) ;
departement.insee = numéro du département ;
departement.nom = nom du département (en majuscules non accentuées) ;
commentaire = description du signalement ;
theme = thème lié au signalement ;
attributs = attributs du signalement s'il y en a (JSON) ;
fichier_attache = pièce-jointe s'il y en avait une avec le signalement (JSON) ;
fichier_attache{}, liste complexe (terminologie FME) contenant les attributs:
fichier_attache{}.index = liste des pièces-jointes, numéro d'index de la pièce jointe ;
fichier_attache{}.id = liste des pièces-jointes, identifiant EspaceCollaboratif de la pièce-jointe ;
fichier_attache{}.nom_de_fichier = liste des pièces-jointes, nom de fichier de la pièce jointe (incluant l'extension) ;
fichier_attache{}.type_mime = liste des pièces-jointes, type MIME du fichier ;
fichier_attache{}.fichier_binaire = liste des pièces-jointes, la pièce jointe ;
date_creation = date de création du signalement ;
date_modif = date de dernière modification du signalement ;
date_cloture = date de la clôture du signalement ;
statut = état du signalement ;
reponse = réponse au signalement s'il y en a une (JSON) ;
reponse{}, liste complexe (terminologie FME) contenant les attributs:
reponse{}.index = liste des réponses, numéro d'index de la réponse (ordre chronologique) ;
reponse{}.date = date de la réponse ;
reponse{}.auteur.username = username de l'auteur de la réponse ;
reponse{}.auteur.id = numéro d'identifiant de l'auteur de la réponse ;
reponse{}.contenu = contenu de la réponse ;
reponse{}.statut.code = statut (code) à l'issue de la réponse ;
reponse{}.statut.description = statut (description) à l'issue de la réponse ;
croquis_xml = croquis s'il y en a un (XML) ;
croquis = croquis s'il y en a un (JSON).
Rejected
Les entités/requêtes invalides ou en erreurs ressortent par ce port non altérées mais avec des attributs supplémentaires :
Attributs en entrée ;
fme_rejection_code = code de l'erreur ;
fme_rejection_message = description de l'erreur ;
_signalement_id = numéro d'identifiant du signalement qui était à télécharger.
Note
Ni le login ni le mot de passe ne sont percolés.
Paramètres
IGNFCollaboratifGetReportConnector nécessite la saisie (ou le pilotage via des attributs des Features entrantes, ou des paramètres utilisateurs du workbench) de paramètres facultatifs et d'un paramètre obligatoire:
Paramètres optionnels mais solidaires :
Login : pseudo de l'utilisateur de l'Espace Collaboratif à utiliser pour l'authentification, qui doit être en minuscule et d'au moins 3 caractères ;
Mot de passe : mot de passe associé à cet identifiant.
Paramètre obligatoire :
Id du signalement : numéro d'identifiant du signalement
Disponibilité et métriques d'usage
Disponibilité
L'authentification, au travers de la Géoplateforme, est monitorée par des sondes UpTrends, notamment la sonde d'"Identity and Access Management" (IAM):
Métriques d'usage
Aucune statistique d'usage de IGNFCollaboratifGetReportConnector n'est actuellement disponible.
Développement
IGNFCollaboratifGetReportConnector est disponible pour être utilisé uniquement en mode lié (Insert Mode = Linked Always, cf. Export as Custom Transformer).
Auteurs
Développeur(s):
PY Nicolas (IGN)
Testeur(s):
PY Nicolas, MUSCARNERA Laurent et HARDY Thomas (IGN)
Documentation:
PY Nicolas (IGN)
Historique de versions de IGNFCollaboratifGetReportConnector
Version |
Date (desc) |
Commentaire |
|---|---|---|
3 |
2026-XX-XX |
Release V3 publique sur le FME Hub Veremes |
3 |
2026-XX-XX |
Release V3 interne |
2 |
202W-XX-XX |
Pas de release V2 |
1 |
202W-XX-XX |
Pas de release V1 |
La documentation de la v3 est disponible via le TODO.
Bug connu
Le Transformer IGNFCollaboratifGetReportConnector ne fait à ce jour l'objet d'aucun bug connu.
Aperçu
Le Transformer IGNFCollaboratifGetReportConnector est composé d'environ 65 Transformers.
Aperçu
Le Transformer IGNFCollaboratifGetReportConnector est composé d'environ xXx_TODO_xXx Transformers.
rTest
Le Transformer IGNFCollaboratifGetReportConnector bénéficie de 91 tests répartis en 19 scénarios.
Ils permettent de vérifier que le comportement du Transformer est correct dans les différents cas d'authentification (véracité des login et mots de passe). Sont également vérifiés que les valeurs de paramètres interdites sont rejetées, ainsi qu'évidemment que le FeatureType des entités sortantes est conforme. De plus, la non altération des données entrantes ressortant par les types d'entités 'Passthrough_data' et 'Rejected' est contrôlée.
