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

Input

Il faut obligatoirement une entité en entrée, qui peut être un Creator si vous ne requêtez qu'un unique signalement.

Ports de sortie

Passtrough_data

Les entités 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:

• public = indicateur (YES|NO) renseignant sur le caractère public (login/mdp inutiles pour consulter ce signalement ; YES) ou d'accès réservé (login/mdp fourni en paramètre nécessaire pour consulter ce signalement ; NO) ;

• signalement_id = numéro d'identifiant du signalement ;

• groupe = nom du groupe dans lequel le signalement a été fait ;

• groupe_id = numéro d'identifiant EspaceCollaboratif du groupe dans lequel le signalement a été fait ;

• groupe_description = description du groupe dans lequel le signalement a été fait ;

• auteur = numéro d'identifiant de l'auteur du signalement ;

• code_insee = code insee de la commune ;

• nom_com = nom de la commune (en majuscules non accentuées) ;

• insee_dep = numéro du département ;

• nom_dep = 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) ;

• 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) ;

• 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.

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é

Le site web Espace Collaboratif est monitoré par des sondes UptimeRobot, en particulier la route GET /reports/ utilisée par IGNFCollaboratifGetReportConnector

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):

EXEMPLE HARDY Thomas et MUSCARNERA Laurent (IGN)

Testeur(s):

EXEMPLE PY Nicolas, HARDY Thomas et MUSCARNERA Laurent (IGN)

Documentation:

EXEMPLE HARDY Thomas, MUSCARNERA Laurent, PY Nicolas (IGN)

Historique de versions de IGNFCollaboratifGetReportConnector

Version	Date (desc)	Commentaire
1	2023-06	EXEMPLE Release beta

Bug connu

EXEMPLE Le Transformer IGNFCollaboratifGetReportConnector ne fait à ce jour l'objet d'aucune bug connu.

Aperçu

Le Transformer IGNFCollaboratifGetReportConnector est composé d'environ xXx_TODO_xXx Transformers.

rTest

EXEMPLE Le Transformer IGNFCollaboratifGetReportConnector bénéficie de XX tests dans un scénario unique, répartis en YY scénarios.

EXEMPLE 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 'Passtrough_data' et 'Rejected' est contrôlée.