Table de correspondance

Il est fréquent lors d'échanges entre deux systèmes, que les nomenclatures soient différentes. Dans notre cas, il n'est pas rare que les valeurs contenues dans l'annuaire LDAP ne correspondent pas tout à fait aux valeurs attendues par votre application K-Portal ou K-Sup. Les tables de correspondance permettent donc d'effectuer certaines transformations entre les valeurs récupérées de l'annuaire et les valeurs importées dans votre application.
Ainsi, pour chaque attribut importé de l'annuaire LDAP vers votre application, il est possible d'appliquer une table particulière (fichier .dat). Pour cela, voici les étapes à suivre :

1. Créez un fichier dont le nom doit être formaté de la façon suivante : « ldap_nom_du_champ.dat », où nom_du_champ correspond au suffixe de l'attribut dans le fichier de configuration ldap.properties. Par exemple, pour l'attribut ldap.annuaire.type_population, la table de correspondance serait nommée ldap_type_population.dat.
2. Dans le fichier, renseignez la liste des valeurs à convertir, en respectant bien les règles de formatage détaillées dans l'article sur les fichiers .dat.
   ! Attention Les données renvoyées par le LDAP doivent être placées dans la colonne de droite du fichier .dat (clefs), et les valeurs correspondantes dans K-Sup doivent être placées dans la colonne de gauche (valeurs).
3. Placez le fichier dans le dossier spécifié dans le paramètre table.repertoire.specific du fichier env.properties (généralement /storage/conf/tables). Si ce paramètre n'est pas défini, ajoutez-le afin que votre fichier .dat soit bien pris en compte par l'application.

! Attention Lorsqu'une valeur fournie par le LDAP ne correspond à aucune clé dans le fichier .dat, la valeur renvoyée sera vide et le champ ne sera pas rempli pour la personne concernée. Si vous souhaitez que la valeur du LDAP soit restituée telle quelle, ajoutez le paramètre suivant dans votre fichier de configuration :

Propriété	Valeurs possibles	Exemple
ldap.[type].[attribut].conversion.conservationvaleur	1 (option activée)	ldap.annuaire.code_structure.conversion.conservationvaleur=1