Importation et synchronisation

--- Avant de démarrer ---

• avoir préparé les données à importer surtout si elles proviennent d'un fichier excel (voir Préparer des données avant l'importation),
• avoir déterminé l'objectif de cette importation et ainsi déduit la méthode de travail et le mode de synchronisation adéquats (voir l'introduction du chapitre Importation et synchronisation).

La configuration d'un import de données se déroule en 5 étapes :

1. Connexion de la source de données externe au site web le plus souvent via ADO (ActiveX Data Objects),

2. Identification et branchement de la source de données à un import d'objets,

3. Association des champs de la structure de données interne au site avec ceux de la source externe (mapping des champs),

4. Diffusion du site,

5. Synchronisation des données.

1. Connexion de la source de données externe au site

Pour l’importation des données, vous devez commencer par spécifier la connexion entre le site et votre source de données externe dans l’écosystème de votre site web. Dans ce but, vous utiliserez donc un élément Source de données ADO. La configuration consiste uniquement à sélectionner la source de données externe.

Cette étape permet à Isotools Studio X8 de connaître la structure de données de la source externe facilitant ensuite le mapping des champs de l'étape 3 de configuration.

Pour réaliser cette opération, procédez comme suit :

1. Dans Configurer, insérer sous > Ecosystème technologique (si ce n'est pas déjà le cas).

2. Insérez sous > Source de données ADO.

3. Nommez la source et configurez sa connexion au fichier ou à la base de données externe en suivant les instructions de l’assistant.
   La source de données ADO est configurée, la source externe est donc connectée au site. Il est maintenant nécessaire de configurer l’import d'objets.

Configuration de la source de données ADO pour connecter des données
d'annuaire du personnel, stockées dans un fichier Excel, au site web

2. Identification et branchement de la source de données à un import d'objets

Cette étape permet de choisir la source de données dans laquelle se trouve les informations à importer par synchronisation.

Dans votre site, il peut en effet y avoir plusieurs sources de données. Nous pourrions avoir par exemple :

• une source de données contenant la liste de vos clients,

• une autre contenant la liste de vos employés,
• etc. 

Il est donc important d’identifier la source de données avant d’associer les informations qu’elle contient avec les champs de la structure de données du service dynamique que vous souhaitez remplir.

De plus, avec l’import d’objets, une même source de données peut pré-remplir plusieurs types de tables. C’est pourquoi, il existe une étape d’insertion intermédiaire d’un élément Import d’objets d’une source de données.

Pour réaliser cette opération, procédez comme suit :

1. Dans Configurer, insérer sous > Import d’objets.

2. Insérez sous > Import d’objets d’une source de données.

3. Suivez les instructions de l’assistant pour connecter la source de données ADO précédemment spécifiée en indiquant le type de synchronisation souhaitée.

4. Dans l’éditeur, cliquez sur Configurer et suivez les instructions de l’assistant pour associer la source de données ADO précédemment configurée à l’import d’objets.
   A ce stade, la source de données depuis laquelle vous allez importer les données est spécifiée. Maintenant, vous allez configurer l’association des champs.

Remarque : Si vous avez choisi un mode de synchronisation unique, un bouton Synchroniser apparaît dans l’éditeur. Il s'agit du bouton permettant de lancer la sychronisation des données lorsqu'elle est de type unique. Vous ne pourrez utiliser ce bouton qu'une fois le site diffusé une première fois. Dans le cas contraire, aucune destination ne sera disponible pour la synchronisation.

Insertion de l'import d'objets et identification de la source de données utilisée pour l'importation

3. Association des champs de la structure de données interne au site avec ceux de la source externe

Dans cette partie, vous allez :

• Spécifier le type d’importation souhaitée parmi les 5 types d'import d'objets proposés,

• Affiner la configuration du processus de mise à jour des informations (synchronisation) entre le site et la source de données externe,

• Indiquer la table de données (du service dynamique) que vous souhaitez alimenter avec ces données,

• Associer les champs de la structure de données correspondant au service sélectionné avec les champs de la source de données externe.

Association des champs simples

Pour réaliser cette opération, procédez comme suit :

1. Dans Configurer, sous Imports d’objets, insérer sous > l'un des imports d'objets proposé.

2. Suivez les instructions de l’assistant variables selon le type d'objets à importer.

3. Dans l'éditeur, sélectionnez l'Origine parmi les champs de la source externe préfixé par le Studio lors de la configuration de l'élément import et au besoin, appliquez une transformation sur l'onglet Transformation (utilisation experte).

4. Si la valeur doit être la même pour tous les enregistrements qui vont être synchronisés, saisissez-la dans le champ Valeur constante.
   Les champs simples sont configurés.

Association des champs complexes

On parle de champs complexes lorsqu'on souhaite importer des données telles que des mots-clés, des images, des documents, des groupes XRM. Ces éléments sont en effet dits complexes car ils ne se limitent pas à une seule information mais en ont plusieurs telles que par exemple l'image qui a un libellé, un nom de fichier, une extension de fichier, une largeur, etc. Dans ce cas, son importation comme celle des autres informations destinées à un champ complexe ne se limite pas à un simple mapping de champ mais nécessite en plus une transformation.

Cas d'une image ou d'un document :

1. Choisissez l’origine correspondant au nom des personnes dans le fichier source de données.

2. Sur l’onglet Transformation, saisissez le chemin dans la ligne « var path = » permettant d’accéder au répertoire des ressources images ou documents que vous souhaitez importer tel que par exemple :

var path = ‘‘C:AdministratifEmployésAnnuairePhotos’’ + sourceValue + « .gif »

Ceci se traduit ainsi : 

• « C:... » indique le chemin vers le répertoire des images (attention, respectez bien la double barre oblique inversée impératif ici),

• « sourceValue » correspond au nom de chaque personne dans le fichier d’origine

• « .gif » identifie le format des images.

Cas des mots-clés :

1. Choisissez l’origine correspondant à l’information dans le fichier source de données que vous souhaitez récupérer sous forme de mots-clés
   OU
   sur l’onglet Mots-clés de l'alimentation d'un champ mots-clés correspondant, cochez les mots-clés qui seront associés à tous les enregistrements par défaut,

2. Si vous optez pour la première option, sur l’onglet Transformation, cochez Appliquer une transformation,

3. Cliquez sur Obtenir la table d’association en haut à gauche dans l’éditeur.
   La liste des mots-clés définie dans le site ainsi que leur identifiant respectif apparaît.

4. Copiez-collez le contenu de la fenêtre dans le champ de saisie Code Javascript de la transformation (avant la dernière ligne pré-saisie dans le champ),

5. Vérifiez que la liste de mots-clés correspond parfaitement aux données que vous avez dans le fichier source de données. S’il existe des différences, modifiez les mots dans le champ Code Javascript de la transformation afin qu’ils correspondent parfaitement à ceux de votre fichier source.

Configuration de l'importation par association des champs des fiches Personnes avec ceux de la source de données.
Ici, association du champ Mots-clés avec la colonne Département du fichier Excel source.

4. Diffusion du site

Afin de synchroniser les données importées, vous devez impérativement diffuser le site. Cette opération permet alors de créer les tables de données dans la base de données du site qui doivent recevoir les données de l'import. Cette synchronisation est automatiquement lancée par l'application suite à la diffusion ou lors de la première navigation dans le site (configuration dans la destination de diffusion).

Pour configurer une destination de diffusion et diffuser le site, reportez-vous au chapitre Diffusion et synchronisation.

5. Synchronisation des données

Pour cette procédure, consultez la page Lancer le processus de synchronisation des données.