Référence ImportConfig

Le fichier ImportConfig.xml utilisé avec Package Deployer contient des informations sur les solutions et les données à importer. Voici un exemple :

<?xml version="1.0" encoding="utf-16"?>
<configdatastorage 
   installsampledata="true"
   waitforsampledatatoinstall="true"
   agentdesktopzipfile=""
   agentdesktopexename=""
   crmmigdataimportfile="data_1033.zip">
   <solutions>
      <configsolutionfile 
         solutionpackagefilename="SampleSolutionOne_1_0_managed.zip"
         overwriteunmanagedcustomizations="false"
         publishworkflowsandactivateplugins="true" />
      <configsolutionfile 
         solutionpackagefilename="SampleSolutionTwo_1_0_managed.zip"
         overwriteunmanagedcustomizations="false"
         publishworkflowsandactivateplugins="true" />
      <configsolutionfile 
         solutionpackagefilename="SampleSolutionThree_1_0_managed.zip" />
   </solutions>
   <filestoimport>
      <configimportfile filename="SampleOption.csv"
         filetype="CSV"
         associatedmap="SampleOption"
         importtoentity="sample_option"
         datadelimiter=""
         fielddelimiter="comma"
         enableduplicatedetection="true"
         isfirstrowheader="true"
         isrecordownerateam="false"
         owneruser=""
         waitforimporttocomplete="false" />
      <configimportfile filename="File.zip"
         filetype="ZIP"
         associatedmap="FileMapName"
         importtoentity="FileEntity"
         datadelimiter=""
         fielddelimiter="comma"
         enableduplicatedetection="true"
         isfirstrowheader="true"
         isrecordownerateam="false"
         owneruser=""
         waitforimporttocomplete="true" />
      <zipimportdetails>
         <zipimportdetail filename="subfile1.csv"
            filetype="csv"
            importtoentity="account" />
         <zipimportdetail filename="subfile2.csv"
            filetype="csv"
            importtoentity="contact" />
      </zipimportdetails>
   </filestoimport>
   <filesmapstoimport>
      <configimportmapfile filename="SampleOption.xml" />
   </filesmapstoimport>
   <cmtdatafiles>
      <cmtdatafile filename="data_1033.zip"
         lcid="1033"
         usermapfilename="UserMap.xml" />
      <cmtdatafile filename="data_1041.zip"
         lcid="1041"
         usermapfilename="" />
   </cmtdatafiles>
</configdatastorage>

Les sections suivantes fournissent des détails sur les éléments et attributs XML valides pour ce document.

configdatastorage élément

configdatastorage est l’élément racine.

Attributs configdatastorage

Tous ces attributs sont facultatifs.

Nom	Description
installsampledata	Installez des exemples de données. Il s’agit des mêmes exemples de données installés à l’aide de ces autres méthodes : - Ajout ou suppression d’exemples de données - Ajouter et supprimer des exemples de données avec code
waitforsampledatatoinstall	Si true et si installsampledata est également défini sur true, attend l’installation des exemples de données pour déployer le package. Ne réglez pas ceci sur true quand installsampledata est false.
agentdesktopzipfile	Nom du fichier zip à dézipper. Si vous spécifiez un nom de fichier .zip ici, un écran est ajouté durant le processus de déploiement du package. Il vous invite à sélectionner l’emplacement où dézipper le contenu du fichier. Cet attribut est couramment utilisé pour créer des packages pour Unified Service Desk for Dynamics 365.
agentdesktopexename	Nom du fichier .exe or .msi dans le fichier zip ou URL à appeler à la fin du processus de déploiement. Cet attribut est couramment utilisé pour créer des packages pour Unified Service Desk for Dynamics 365.
crmmigdataimportfile	Nom du fichier de données de configuration par défaut (.zip) exporté à l’aide de l’outil de configuration de la migration.

éléments configdatastorage

Voici les éléments enfants valides :

Élément	Descriptions
solutions	Contient 0 ou plusieurs configsolutionfile éléments qui décrivent les solutions à importer.
filestoimport	contient - 1 ou plusieurs configimportfile éléments - 0 ou plusieurs zipimportdetails éléments qui décrivent les fichiers individuels et les fichiers zip à importer.
filesmapstoimport	Contient 1 ou plusieurs configimportmapfile éléments. L’ordre des fichiers de mappage dans ce élément indique l’ordre dans lequel ils sont importés. En savoir plus sur la création de cartes de données pour l’importation
cmtdatafiles	Contient 1 ou plusieurs cmtdatafile élément contenant la version localisée du fichier de données de configuration à importer.

configsolutionfile élément

Décrit les solutions à importer dans configdatastorage.solutions élément.

Attributs configsolutionfile

Nom	Description
solutionpackagefilename	Obligatoire Spécifiez le nom de fichier .zip de la solution.
overwriteunmanagedcustomizations	Facultatif Si vous voulez remplacer toutes les personnalisations non gérées lors de l'importation d'une solution qui existe déjà dans l'environnement cible. Si vous ne spécifiez pas ce comportement, les personnalisations non gérées dans la solution existante sont conservées sur l'environnement cible.
publishworkflowsandactivateplugins	Facultatif si vous publiez vos workflow et activez les plug-ins dans l’environnement cible une fois la solution est importée. Si vous ne spécifiez pas le comportement, le Workflow est publié et les plug-ins activés.

configimportfile élément

Décrit les fichiers à importer dans configdatastorage.filestoimport élément.

Attributs configimportfile

Nom	Description
filename	Nom du fichier contenant les données d’importation.
filetype	Cette valeur peut être vide csv, xml ou zip. Si le fichier est un fichier .zip, un zipimportdetails élément doit être présent avec un zipimportdetail élément pour chaque fichier dans le fichier .zip.
associatedmap	Nom du mappage de données de l’importation Dataverse à utiliser avec ce fichier. Si cet élément est laissé vide, Dataverse tente d’utiliser le mappage de données d’importation déterminé par le système pour ce fichier.
importtoentity	Il peut s’agir du nom du fichier .exe dans le fichier zip, d’une URL ou d’un fichier .msi pour fournir un lien à appeler à la fin du processus.
datadelimiter	Nom du séparateur de données utilisé dans le fichier d’importation. Les valeurs valides sont un guillemet simple ou des guillemets doubles.
fielddelimiter	Nom du séparateur de champs utilisé dans le fichier d’importation. Les valeurs valides sont virgule, deux points ou guillemet simple.
enableduplicatedetection	Si les règles de détections des doublons doivent être activées lors de l’importation des données. Les valeurs valides sont true ou false.
isfirstrowheader	Si la première ligne du fichier d’importation contient les noms des champs. Les valeurs valides sont true ou false.
isrecordownerateam	Si le propriétaire de l’enregistrement lors de l’importation doit être une équipe. Les valeurs valides sont true ou false.
owneruser	L’identifiant utilisateur qui doit être propriétaire des enregistrements. La valeur par défaut est l’utilisateur actuellement connecté.
waitforimporttocomplete	Si true, le système attend la fin de l’importation avant de poursuivre. Si false, il met les tâches en files d’attente et continue.

zipimportdetails élément

Décrit les fichiers zip à importer dans l’élément configdatastorage.filestoimport lorsque configimportfile.filetype est zip.

Contient 1 ou plusieurs zipimportdetail éléments qui fournir des informations sur un fichier individuel contenu dans un fichier .zip spécifié dans le configimportfile élément.

zipimportdetail élément

Fournir des informations sur un fichier individuel contenu dans un fichier .zip spécifié dans le configimportfile élément.

Attributs zipimportdetail

Nom	Description
filename	Nom du fichier contenant les données d’importation.
filetype	Cette valeur peut être vide csv ou xml.
importtoentity	Il peut s’agir du nom du fichier .exe dans le fichier zip, d’une URL ou d’un fichier .msi pour fournir un lien à appeler à la fin du processus.

configimportmapfile élément

Contient des informations sur un fichier de carte individuel à importer dans Dataverse.

Attributs configimportmapfile

Nom	Description
filename	Nom du fichier contenant les données de mappage.

cmtdatafile élément

Spécifier les fichiers de données de configuration localisés avec l’ID de paramètres régionaux (obligatoire) et le fichier de mappage de données utilisateur (facultatif).

Exemple de cmtdatafile

<cmtdatafiles>
   <cmtdatafile filename="data_1033.zip"
      lcid="1033"
      usermapfilename="UserMap.xml" />
   <cmtdatafile filename="data_1041.zip"
      lcid="1041"
      usermapfilename="" />
</cmtdatafiles>

Attributs cmtdatafile

Nom	Description
filename	Nom du fichier contenant les données de mappage.
lcid	Représentation sous forme de chaîne de l’identifiant du code de langue LCID.
usermapfilename	Pour Dynamics 365 (on-premises) uniquement. Contient le fichier de mappage utilisateur (.xml) généré à l’aide de Configuration Migration Tool dans votre projet. Ce fichier est requis pour importer les informations utilisateur vers une Dynamics 365 (on-premises) instance sur un domaine différent.