IGNFCollaboratifContextConnector

Ce Transformer permet de récupérer les informations d'un utilisateur qui possède un compte sur l'Espace Collaboratif et de lister, par exemple, les groupes auxquels il appartient ou encore les thèmes disponibles.

IGNFCollaboratifContextConnector génère plusieurs entités sortantes, descriptives :

• du compte utilisé (Descriptif),

• des groupes auxquels l'utilisateur est inscrit (Communautés),

• des thèmes sur lesquels l'utilisateur peut contribuer (Thèmes_complets),

• des thèmes du groupe actuellement actif pour l'utilisateur (Thèmes_actifs).

Note

Tous les paramètres de IGNFCollaboratifContextConnector sont pilotables par des paramètres publiés du traitement.

Configuration

Port d'entrée

Input

IGNFCollaboratifContextConnector est auto-instancié, il ne nécessite pas d'Input.

Ports de sortie

IGNFCollaboratifContextConnector génère plusieurs entités sortantes, descriptives :

• du compte utilisé (Descriptif),

• des groupes auxquels l'utilisateur est inscrit (Communautés),

• des thèmes sur lesquels l'utilisateur peut contribuer (Thèmes_complets),

• des thèmes du groupe actuellement actif pour l'utilisateur (Thèmes_actifs).

Descriptif

Permet d'afficher les mêmes attributs que précédemment avec en plus le mail de l'utilisateur ainsi que ses nom et prénom :

• login = pseudo de l'utilisateur de l'Espace Collaboratif ;

• utilisateur_id = identifiant (numéro) de l'utilisateur ;

• prenom = prénom de l'utilisateur ;

• nom = nom de l'utilisateur ;

• email = mail de l'utilisateur.

Communautés

Permet d'avoir la liste des groupes auxquels l'utilisateur est inscrit :

• groupe = nom du groupe ;

• groupe_id = numéro du groupe ;

• role = rôle de l'utilisateur dans ce groupe (administrateur ou utilisateur) ;

• emprise{} = liste des emprises liées au groupe:

  • emprise{}.code_insee = code de l'emprise, généralement insee

  • emprise{}.code_type = type de l'emprise, généralement une collectivité

    • Zone de collecte IGN, ZC suivi de 3 chiffres

    • EPCI (code SIREN), code SIREN (9 caractères)

    • Département (code INSEE)

    • Collectivité d'outre-mer (code INSEE)

    • Région (code INSEE)

    • Commune (code INSEE)

    • Territoire, FXX, MTQ, MYT...

    • Autre

Si l'utilisateur n'appartient à aucun groupe, ce FeatureType de sortie n'existe pas.

Thèmes_complets

Permet d'avoir la liste des thèmes disponibles à l'utilisateur :

• groupe = nom du groupe ;

• groupe_id = numéro du groupe ;

• role = rôle de l'utilisateur dans ce groupe (administrateur ou utilisateur) ;

• themes = nom du thème.

Si l'utilisateur n'appartient à aucun groupe, ce FeatureType de sortie n'existe pas.

Thèmes_actifs

Le nom de ce type d'entités de sortie est mal choisi, mais respecte l'API Collaborative. Si l'utilisateur n'appartient à aucun groupe, il a cependant accès aux thèmes par défaut :

• groupe = nom du groupe ;

• groupe_id = numéro du groupe ;

• theme_actif = nom du thème ;

• description = description du thème ;

• attributs = attributs présent dans le thème (s'il y en a).

Dans le cas d'un utilisateur appartenant à au moins un groupe, ce type d'entités de sortie n'existe pas.

Rejected

Les erreurs ressortent par ce port :

• fme_rejection_code = code de l'erreur ;

• fme_rejection_message = descriptif de l'erreur ;

• login = login saisi lors de la connexion.

Paramètres

IGNFCollaboratifContextConnector nécessite la saisie (ou le pilotage via des paramètres utilisateurs) de deux paramètres :

• Login : pseudo de l'utilisateur de l'Espace Collaboratif à utiliser pour l'authentification ;

• Mot de passe : mot de passe associé à cet identifiant.

Développement

IGNFCollaboratifContextConnector est disponible pour être utilisé uniquement en mode lié (Insert Mode > Linked Always). Voir la documentation FME sur l'export de Transformers personnalisés en français ou en anglais (Export as Custom Transformer).

Auteurs

Développeur(s) :

HARDY Thomas et MUSCARNERA Laurent (IGN)

Testeur(s) :

PY Nicolas, HARDY Thomas et MUSCARNERA Laurent (IGN)

Documentation :

HARDY Thomas, MUSCARNERA Laurent, PY Nicolas (IGN)

Historique de versions de IGNFCollaboratifContextConnector

Version	Date (desc)	Commentaire
1	2024-01-18	Release V1
1	2023-12-31	Release V1 interne
1	2023-06	Release beta

Bugs connus

Le Transformer IGNFCollaboratifContextConnectorbénéficie ne fait à ce jour l'objet d'aucun bug connu.

rTest

Le Transformer IGNFCollaboratifContextConnector bénéficie de 62 tests, répartis en 13 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), ainsi que selon l'appartenance du compte à 0,1,n communautés. Ils permettent en outre de s'assurer que le type d'entités des entités sortantes est conforme.