Autres versions

Vous êtes ici : Développer dans K-SupConnecteurs SIImport / Export XML

Import / Export XML

Introduction

Le module d'import XML vous permet d'alimenter n'importe quel type de contenu de votre application de façon automatique, ce qui permet de récupérer des contenus provenant de sources externes, de façon ponctuelle ou récurrente.

Le format XML a été privilégié parce qu'il est très répandu, il permet la création de fichiers de données à partir de la plupart des technologies actuelles (Java, PHP...), et de décrire tous les types de contenus existants dans K-Portal / K-Sup.

Les options de configuration qui ont été associées au module permettent par ailleurs de piloter finement la façon dont seront importées les données : quelle zone importer et/ou ne pas importer, quelle valeur attribuer par défaut en cas de valeur non renseignée... 

Les connecteurs LDAP et CDM-fr, fournis avec K-Sup, utilisent tous deux ce module pour importer les contenus dans votre site.

Import de groupes

Import XML de groupes

Import de fiches

Format XML

Le format attendu pour le fichier XML est le suivant :
<?xml version="1.0" encoding="utf-8"?>
<LISTE_ITEMS>
	<ITEM>
		<ENTETE>
			<ACTION>IMPORTER</ACTION>
			<OBJET>NOM_OBJET</OBJET>
			<CODE>CODEFICHE</CODE>
			<LANGUE>LANGUEFICHE</LANGUE>
		</ENTETE>
		<DONNEES>
			<INTITULE_CHAMP>Contenu du champ</INTITULE_CHAMP>
		</DONNEES>
	</ITEM>
</LISTE_ITEMS>
  • ENTETE
    • ACTION : vaut toujours "IMPORTER"
    • OBJET : nom de l'objet importé, parmi les valeurs suivantes : 
      • ARTICLE
      • ACTUALITE
      • DOCUMENT
      • ANNUAIRE (ANNUAIREKSUP pour K-Sup)
      • DEFAULTSTRUCTURE (DEFAULTSTRUCTUREKSUP pour K-Sup)
      • LABORATOIRE (K-Sup)
      • FORMATION (K-Sup)
      • PARCOURS (K-Sup)
      • UEUP (K-Sup)
      • COURS (K-Sup)
      • OFFRESSTAGESEMPLOIS (K-Sup)
      • ANNUAIREETUDIANTS (K-Sup)
      • ANNUAIREANCIENSETUDIANTS (K-Sup)
      • ASSOCIATIONETUDIANT (K-Sup)
    • CODE : Code de la fiche
    • LANGUE : Langue de la fiche, les valeurs possibles sont renseignées dans votre fichier de configuration (jtf.properties ou [projet].properties, paramètres langue_x). Par défaut : 0 pour français, 1 pour anglais, 2 pour allemand, 3 pour espagnol.
  • DONNEES : les nœuds placés sous ce nœud correspondent aux différents champs de chaque fiche. Le nom du nœud doit correspondre au nom du champ en base de données. Par exemple, CHAPEAU pour le champ "Résumé" de la fiche Article.
Certains champs attendent un format spécifique de données :
  • Dates : JJMMAAAA
  • Libellés multivalués : les codes des libellés doivent être séparés par un point-virgule

Paramétrage du module

Consulter notre article dédié sur le paramétrage de l'import XML.