DataImporter - Importation des contacts d'un fournisseur

AFFICHER TOUT LE CONTENU

Table des matières

Aperçu

L'importation des contacts permet d'ajouter l'information reliée au contact d'un fournisseur.

Références

Liens vers les articles reliés à l'importation des contacts d'un fournissuer et à la configuration du fichier XML

Ce qu'il faut savoir :  

Les fichiers modèles de référence (.xlsx et .xml) pour l'importation sont inclus dans le fichier compressé Fournisseurs_Contacts.zip.  
 

Champs disponibles pour l''importation des contacts de fournisseurs

Champs requis

  • Nom - Texte(100)
    • Nom de famille du contact

Champs optionnels

  • Prénom - Texte(100)​
    • Prénom du contact
  • EstActif
    • ​Indique si le contact est actif ou non. 

    • Les valeurs acceptées sont : 1 ou 0, True ou False, Oui ou Non.

  • Titre - Texte(100)
    • Titre du contact
  • Adresse - Texte(500)
    • Adresse postale du contact
    • C'est possible d'inscrire l'adresse complète sur plusieurs lignes dans ce champ ou d'utiliser les champs individuels pour le faire. 
  • Ville
  • Province
  • CodePostal
  • Pays
  • TéléphoneBureau - Texte(50)
    • Téléphone du contact
  • PosteTéléphonique - Texte(50)
    • Poste téléphonique du contact
  • TéléphoneCellulaire - Texte(50)
    • Téléphone du contact
  • Téléavertisseur - Texte(50)
    • Numéro de téléavertisseur du contact
  • Télécopieur - Texte(50)
    • Télécopieur du contact
  • Compagnie - Texte(250)
    • Représente le nom du fournisseur ou du manufacturier avec lequel le contact doit être associé.
    • Le système va créer le fournisseur lors de l'importation s'il n'existe pas.
    • Cette information est reliée au module Fournisseur. Pour plus de détail, se référer à l'importation des fournisseurs.
  • Courriel - Texte (320)
    • L'adresse courriel doit avoir un format valide, c’est-à-dire, contenir un @ et un point (.) pour .com, .ca, .gouv.qc.ca, etc.
  • Note - Texte (5000)
    • Ce champ permet d'importer toute information supplémentaire qui ne peut être reliée à un champ existant de la fiche d'un contact.
ATTENTION :  L'information dans ce champ est écrasée à chaque import. Il faut donc s'assurer que toute l'information est là
  • Langue
    • ​Les valeurs acceptées sont : Anglais, Français ou Portugais.
    • Par défaut, si ce champ n'est pas importé, il sera configuré avec la langue par défaut de la base de données.

Contenu du fichier de configuration (Contacts.xml)

La déclaration de la source se fait en indiquant la valeur Contact dans la balise <Content>

ATTENTION : Le modèle de fichier XML utilisé en exemple est pour une importation à partir d'Excel 2007 ou 2010. 

<?xml version="1.0" encoding="utf-8" ?> 
<Sources>
    <Source Name="ImportationContact">
<ConnectionString>Provider=Microsoft.ACE.OLEDB.12.0;Data Source=c:\Import\Fournisseurs_Contacts.xlsx;Extended Properties="Excel 12.0 Xml;HDR=YES";</ConnectionString>
<ViewName>[Contacts$]</ViewName> 
<Content>Contact</Content>

<!-- Balises supplémentaires -->
     <EmptyValueHandling>NoChange</EmptyValueHandling>
    </Source>
</Sources>

Référez-vous à l'article Fichier de configuration XML qui explique comment programmer les références à vos sources de données.

Balises supplémentaires pour l'importation des contacts d'un fournisseur

Le fichier XML pour l'importation des contacts d'un peut contenir une balise supplémentaire. Cette balise n'est pas obligatoire et lorsqu'elle n'est pas spécifiée, la valeur par défaut est alors utilisée.

Ce qu'il faut savoir : 

Les balises supplémentaires sont sensibles aux majuscules.

Si la valeur n'est pas écrite exactement comme il est documenté, Octopus ignorera la balise et utilisera la valeur par défaut.

Gestion des champs vides

DataImporter permet de nettoyer les données contenues dans Octopus lorsque des champs vides sont rencontrés. Si cette balise n'est pas présente, la valeur par défaut NoChange sera utilisée.

Si vous voulez utiliser ce paramètre dans le cadre d'un import, il est important que votre source de données doit contenir uniquement les colonnes sur lesquelles agir. DataImporter tentera de nettoyer systématiquement toutes les colonnes présentes. Vous pourrez ainsi nettoyer tous les champs à l'exception de :

  • Les champs requis dans l'application.
  • Les champs rendus obligatoires par la configuration de votre base de données Octopus.
  • Les champs qui imposent un nombre limité de valeurs acceptées, par exemple les champs de type booléen (oui/non).

Valeur permises pour la balise EmptyValueHandling :

  • Clear : la valeur présente dans Octopus sera nettoyée et le champ sera vide.
  • NoChange (Valeur par défaut) : Les champs vides dans la source de donnée sont ignorés et la valeur existante dans Octopus est conservée.

Pour utiliser cette balise, ajouter la ligne suivante dans le fichier XML : 

<EmptyValueHandling>VALEUR</EmptyValueHandling>
X
Aidez-nous à améliorer l’article








Aidez-nous à améliorer l’article