NAPC Demo  

Essayez gratuitement NAPContent sur notre site demo !

Devenez membre

 et bénéficiez de toutes nos solutions!

Devenez membre

Découvrez les sites

qui utilisent NAPContent !

Voir
plus

Import/ Export

Introduction

NAPContent inclut de base un système d'import et d'export de données flexible et paramétrable.

Il ne vous impose pas un type et un format de fichier prédéterminé pour réaliser vos opérations, c'est NAPContent qui va pouvoir s'adapter à votre fichier pour l'importer ou à vos exigences pour exporter vos items.

De plus il est possible d'étendre les fonctions de NAPContent via des plugins et ainsi importer et exporter depuis/vers n'importe quelle source de données. 

Sur le même principe que la gestion des items, il vous faudra créer des types d'import/export afin d'utiliser la fonction.

Créer un gabarit d'import/export

Accès aux types d'import/export

Allez dans l'administration de NAPContent, puis sélectionner dans le menu la rubrique "Import/Export". Vous accédez alors à la liste des types existants. 

impexp edit 01

Ajouter/Modifier un type d'import/export

Cliquez sur le libellé du champ pour le modifier, ou bien cliquez sur le bouton Nouveau pour créer un nouveau type d'import export. 

impexp edit 02 Un type d'import est composé des informations suivantes : 

Type : Sélection du type auquel est rattaché l'import/export. Il n'existe pas la possibilité d'exporter plusieurs types à la fois.

Nom : Nom permettant d'identifier le type d'import/export.

Plugin : Méthode à utiliser pour l'import/export. La liste dépend des plugins installés et activés sur le site. 

Statut : Etat de publication du type d'import/export.

 

impexp edit 03

 La localisation du fichier permet de définir à quel endroit il faut récupérer ou écrire le fichier.

Localisation : Le fichier peut être récupéré ou écrit soit en local (serveur web), soit sur un serveur FTP ou bien une URL web (uniquement en lecture = import)

Nom du fichier : Définit le nom du fichier à importer, il n'est pas forcément nécessaire de renseigner l'extension du fichier qui peut être définit automatiquement.

Filtre : A la place du nom de fichier, vous pouvez définir ici une expression régulière permettant de matcher le(s) fichier(s) à récupérer.  (uniquement pour le local et le ftp)

Adresse : Saisir le chemin d'accès au fichier. Pour le local, vous pouvez utiliser le chemin relatif ou bien le chemin complet. Pour le FTP et le WEB, saisir les différents segments de l'URL ou du répertoire (ex: /site/test/)

Serveur : Pour le FTP et le WEB uniquement, préciser l'url du serveur. (ex : www.napcontent.com)

Nom d'utilisateur : Pour le FTP et le WEB uniquement, préciser le nom d'utilisateur.

Mot de passe : Pour le FTP et le WEB uniquement, préciser le mot de passe.

Port :Pour le FTP et le WEB uniquement, préciser port.

Supprimer ? : Précise pour le local et le FTP uniquement si le fichier doit être supprimé après avoir été récupéré.

Préfixe nom de fichier : Pour l'export uniquement, permet de préciser un préfixe au nom du fichier. Il est possible de saisir la valeur %date qui inclut automatiquement une date de fichier condensé (YmdHis).

Suffixe nom fichier : Pour l'export uniquement, permet de préciser un suffixe au nom du fichier. Il est possible de saisir la valeur %date qui inclut automatiquement une date de fichier condensé (YmdHis).

 

 impexp edit 04Archiver ? : Indique si le fichier importé/exporté est archivé à la fin du traitement.

Envoyer un email à :  Saisir une adresse email à laquelle sera envoyée le rapport d'import/export à la fin de chaque traitement.

 

impexp edit 05 Autoriser Ajout : Indique si l'import peut créer des nouveau items ou non.

Autoriser MAJ : Indique si l'import peut modifier items existants ou non.

Autoriser suppression :Indique si l'import peut supprimer items existants ou non.

Item ID : clé primaire : Indique si c''est l'ID de l'item qui fera office de clé primaire pour identifier les items à importer.

Clé primaire : Sélectionne un champ qui sera utilisé pour la clé primaire. Dans le cas où c'est l'ID de l'item qui sera la clé primaire, il vous faudra créer un champ technique (par exemple hidden) afin de faire le lien et le sélectionner dans la liste ci dessous. La clé primaire permet d'identifier un item afin de le modifier ou le supprimer. Afin de faire appaitre le champ dans la liste, il doit tout d'abord être associé à l'import.

Champ action : Le champ d'action peut être utilisé dans certains cas pour l'import/export. C'est un champ qui va indiquer via une valeur l'action à réaliser.

Action d'ajout, MAJ, suppression : Saisir la valeur qui correspond à chacune des actions.

Action de SUPPR : Action à réaliser lorsqu'un import supprimer un élément, doit-il juste être dépublié ou bien supprimé définitivement. 

Paramétrer l'import/export

Accès au paramétrage d'un import/export

Allez dans l'administration de NAPContent, puis sélectionner dans le menu la rubrique "Import/Export". Vous accédez alors à la liste des types existants.  Cliquez ensuite dans la colonne configuration sur l'icône correspondant à la ligne du type que vous souhaitez paramétrer.

impexp edit 06

Configuration liée au plugin d'import/export

Chaque plugin d'import/export possède ses propres paramètres, en fonction du plugin sélectionné dans le type d'import/export vous aurez la possibilité ici de renseigner les paramètres spécifiques.

Ajout et paramétrage d'un champ

Il est possible de rajouter autant de champ que vous souhaitez, un champ peut représenter une colonne d'un fichier CSV ou bien encore une clé dans un fichier XML, c'est tout simplement une information supplémentaire à intégrer. 

Pour ajouter un champ, cliquez sur le bouton "+" qui apparait à droite de la zone "fields". Une fenêtre avec la liste des champs apparait, filtrer et sélectionner un ou plusieurs champs en cliquant sur leur titre. Il est possible d'ajouter plusieurs fois le même champ. Une fois que vous avez terminé votre sélection vous pouvez fermer cette fenêtre de sélection.

Les champs sélectionnés apparaissent dans leur ordre de sélection, vous pouvez modifier l'ordre en cliquant sur le titre et en effectuant un glisser/déposer. Cela permet de gérer l'ordre de traitement de l'import ou de génération du fichier d'export.

Vous pouvez retirer un champ en cliquant sur l'icône de la corbeille associée. 

A côtés de chaque champ ajouté, un bouton d'édition vous permet de régler les détails et les paramètres d'import/export lié.

impexp edit 07

Le paramétrage est décomposé en quatre parties :

1) La configuration globale et obligatoire :

Nom : Définit un nom afin d'identifier le champ (aucun impact sur l'import/export)

Identifiant : Valeur unique dans l'import/export qui permet de définir le champ. Cette valeur est exploitée différemment selon les plugins d'import/export (voir la documentation du plugin)

Obligatoire : Indique si le champ est obligatoire ou non pour l'import. Si le champ est manquant l'enregistrement ne sera pas importé. (sauf pour la suppression ou ce paramètre est ignoré) 

2) Les paramètres spécifiques liés au type de plugin d'import/export :

Ces paramètres dépendent directement du type d'import/export.  Se référer à la documentation du plugin d'import/export pour plus d'informations. 
Selon le plugin il se peut qu'il n'y ait aucun paramètre.

3) Les paramètres spécifiques liés au plugin de champ :

Ces paramètres dépendent directement du type de champ. Se référer à la documentation du plugin de champ pour plus d'informations.
Selon le plugin il se peut qu'il n'y ait aucun paramètre.

4) Les paramètres globaux pour l'import:

Valeur par défaut : Si la valeur n'est pas renseignée ou bien qu'elle corresponde à la valeur nulle définit dans le paramètre suivant, alors la valeur par défaut sera utilisé.

Valeur nulle : Vide par défaut, il est possible de saisir une valeur qui indique que le champ est considéré comme vide si la valeur du champ est égale à ce paramètre.

Valeur multiple : Autorise ou non le fait que le champ puisse avoir plusieurs valeurs à importer.

Valeur correspondante : Permet de remplacer une valeur par une autre selon une table de correspondance. Cette table peut être défini selon une requête SQL (avec une sélection de 2 champs) ou bien via une liste manuelle sous le format suivant: valeur1::valeur2 (une correspondance par ligne). La première valeur correspond à la valeur du fichier importé et la seconde à la correspondance souhaitée pour l'import dans l'item.

Séparateur de données : Permet de définir un caractère ou un ensemble de caractère qui permet de séparer une valeur en plusieurs valeurs. Ne fonctionne que si valeur multiple est activé.

Nettoyer : Permet de supprimer une ou plusieurs caractères de valeur, lister un caractère par ligne. Chaque élément peut également être remplacé par un autre. Dans ce cas utiliser le format suivant chartodel::chartoreplace.

Supprimer les espaces : Permet de supprimer les espaces inutiles en début et fin de la valeur à importer.

Supprimer les valeurs nulles : Si la valeur à importer est nulle ou non renseignée alors elle est automatiquement supprimée.

Les paramètres des différents champs

Chaque plugin de champ peut posséder ses propres paramètres d'import/export.

Access

Format : Permet d'importer/exporter l'ID du niveau d'accès ou le nom

Author

Format : Permet d'importer/exporter l'ID de l'auteur ,le nom, l'identifiant ou l'email.

Categories

Format : Permet d'importer/exporter l'ID ou le titre de la catégorie.

Uniquement la catégorie principale : Indique si toutes les catégories ou seulement la catégorie principale sont exportés.

Created

Format : Définit le format de la date à exporter

Language

Format : Définit si c'est le nom ou le tag de la langue qui doit être importer/exporter. 

Metadata

Format : Définit si c'est juste la description qui doit être importer/exporter ou bien toutes les metadatas.

Params

Format : Vide indique qu'il traite tous les paramètres, saisir une valeur ne traitera que le paramètre correspondant à cette valeur.

Type

Format : Définit si c'est le nom ou l'ID du type qui doit être importer/exporter.

Updated

Format : Définit le format de la date à exporter.

Checkbox, Select, Radio

Format : Définit si c'est le libellé ou l'ID de l'élément qui doit être importer/exporter.

Datepicker

Format : Définit le format de la date à exporter.

Importer des items

Exporter des items

Consulter les logs d'import/export

×
Ce site utilise des cookies pour vous offrir le meilleur service. En continuant, vous acceptez de recevoir les cookies sur ce site.