asgard_import_nomenclature
fonction d'import dans la table de gestion (ou de restauration) des informations relatives aux schémas de la nomenclature nationale
z_asgard_admin.asgard_import_nomenclature( [ domaines text[] DEFAULT NULL::text[] ] )
La fonction asgard_import_nomenclature importe dans la table de gestion[1] les schémas manquants de la nomenclature nationale[2] – ou de certains domaines de la nomenclature qui sont alors listés en argument.
Lors de l'import, le rôle g_admin[5] est pré-désigné comme producteur[3], le rôle g_consult[6] comme lecteur[4].
On notera que la fonction ne crée pas les schémas, elle se contente d'enregistrer dans la table de gestion les informations qui les concernent en vue d’une création future (schémas inactifs[7]).
asgard_import_nomenclature ne fait aucune différence si un schéma de la nomenclature a un homonyme parmi les schémas existants de la base. Elle l’importera dans la table de gestion sous la même forme que les autres : il ne sera pas marqué comme créé et le schéma existant ne sera pas affecté par les modifications faites dans la table de gestion tant qu’il n’aura pas été explicitement référencé[8] par l’administrateur, soit via les fonctions de référencement usuelles (asgard_initialisation_gestion_schema et asgard_initialise_schema), soit simplement en basculant le champ creation sur True.
asgard_import_nomenclature pourra notamment servir au moment de l’initialisation d’ASGARD après installation (cf. Import de la nomenclature pour plus de précisions), mais elle peut être lancée ou relancée à tout moment pour importer des domaines supplémentaires, voire tous les schémas restants de la nomenclature.
Remarque :
Lorsque asgard_import_nomenclature est ré-exécutée sur des sections de la nomenclature qui avaient déjà été importées dans la table de gestion, les champs nomenclature, niv1, niv1_abr, niv2, niv2_abr sont réinitialisés selon la source. Les schémas étant reconnus par leur nom, un schéma renommé entre temps serait recréé avec le nom d'origine.
Syntaxe⚓
SELECT z_asgard_admin.asgard_import_nomenclature( [ %domaines ] ) ;
Ou, en nommant l’argument :
SELECT z_asgard_admin.asgard_import_nomenclature( [ domaines := %domaines ] ) ;
L’argument, optionnel, peut être omis.
Argument⚓
[optionnel] domaines est un tableau de chaînes de caractères (text[]) contenant les noms des domaines à importer, soit le « niveau 1 » de la nomenclature des schémas (repris dans les champs niv1/niv1_abr de la table de gestion). Si aucun argument n’est fourni, toute la nomenclature est importée.
Les domaines peuvent être renseignés indifféremment sous leur forme littérale (telle qu’elle apparaît dans le champ niv1) ou abrégée (comme dans niv1_abr).
Liste des domaines (par ordre alphabétique) :
Forme standardisée | Forme littérale |
|---|---|
agriculture | Agriculture |
air_climat | Air & climat |
amenagement_urbanisme | Aménagement & urbanisme |
culture_societe_service | Culture, société & services |
donnee_generique | Données génériques |
eau | Eau |
foncier_sol | Foncier & sol |
foret | Forêt |
habitat_politique_de_la_ville | Habitat & politique de la ville |
mer_littoral | Mer & littoral |
nature_paysage_biodiversite | Nature, paysage & biodiversité |
nuisance | Nuisances |
reseau_energie_divers | Réseaux & énergie |
risque | Risques |
site_industriel_production | Sites industriels & production |
socio_economie | Socio-économie |
transport_deplacement | Déplacements |
transport_infrastructure | Infrastructures de transport |
Résultat⚓
« __ FIN IMPORT NOMENCLATURE. » si la requête s’est exécutée normalement.
Des messages informent l’opérateur des schémas effectivement ajoutés à la table de gestion ou pour lesquels les champs relatifs à la nomenclature ont été modifiés.
Exemple :
Pour importer les schémas des domaines « transport_deplacement » et « transport_infrastructure » :
SELECT z_asgard_admin. asgard_import_nomenclature(
ARRAY['transport_deplacement', 'Infrastructures de transport']
) ;
NOTICE: Le schéma c_tr_depl_securite_routiere a été ajouté à la table de gestion.
NOTICE: Le schéma c_tr_depl_collectif a été ajouté à la table de gestion.
NOTICE: Le schéma c_tr_depl_exceptionnel a été ajouté à la table de gestion.
NOTICE: Le schéma c_tr_depl_marchandise a été ajouté à la table de gestion.
NOTICE: Le schéma c_tr_depl_mat_dangereuse a été ajouté à la table de gestion.
NOTICE: Le schéma c_tr_depl_trafic a été ajouté à la table de gestion.
NOTICE: Le schéma c_tr_infra_aerien a été ajouté à la table de gestion.
NOTICE: Le schéma c_tr_infra_circulation_douce a été ajouté à la table de gestion.
NOTICE: Le schéma c_tr_infra_ferroviaire a été ajouté à la table de gestion.
NOTICE: Le schéma c_tr_infra_fluvial a été ajouté à la table de gestion.
NOTICE: Le schéma c_tr_infra_maritime a été ajouté à la table de gestion.
NOTICE: Le schéma c_tr_infra_plateforme_multimod a été ajouté à la table de gestion.
NOTICE: Le schéma c_tr_infra_routier a été ajouté à la table de gestion.
Exemple :
Pour importer la totalité de la nomenclature :
SELECT z_asgard_admin.asgard_import_nomenclature() ;
Tous les schémas de la nomenclature sont listés dans l’onglet Messages, sous la même forme que dans l’exemple précédent.
Exemple :
Le champ niv1 a été accidentellement vidé pour le schéma c_eau_aep. L'administrateur peut la rétablir en exécutant la fonction asgard_import_nomenclature sur le domaine Eau.
SELECT z_asgard_admin.asgard_import_nomenclature(ARRAY['eau']) ;
NOTICE: Les champs de la nomenclature ont été mis à jour pour le schéma c_eau_masse_eau.