Description of the mapping file to customize the imports in SharePoint

When launching SharePoint Provisioner (On-Prem and Online versions), it is highly recommended to apply an additional parameter file called 'mapping file' allowing to customize the import in SharePoint more finely.

Please find below the most important tags of the XML file and their functions:

Start of the file:
<?xml version="1.0" encoding="utf-8"?>
<DataImportSettings xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07">
<ListsImportSettings>
<List>

<ListName> : Must be identical to the name of the file present in the SHAREPOINT\LISTS subfolder of the extraction you wish to customize. This line should not be modified. Note that if an import is launched with a mapping file and no corresponding list (or library) is found in the mapping file, in this case, the import of the list (or library) will not take place.

<EmptyList> : Si la valeur est à 'true', cela permet de vider le contenu d'une liste (ou bibliothèque) existante lors de l'import.

<d5p1:KeyValueOfstringFieldImportSettings>
<d5p1:Key>Auteur</d5p1:Key>
<d5p1:Value>

<ApplyToIndividualFiles>false</ApplyToIndividualFiles> : Specific option for importing in DocSet mode to apply the field inheritance to the attachment and not to the DocSet.
<FieldDescription>Champ description</FieldDescription> : Allows you to define a description of the column.
<FieldDisplayName>Auteur</FieldDisplayName> : Display label of the column.
<FieldInternalName>Auteur</FieldInternalName> : Internal name of the column.
<FieldRequired>false</FieldRequired>
<FieldType>Text</FieldType> : Field Type (Text, Note, Choice, DateTime)
<Import>false</Import>
<MapToExistingLookup>false</MapToExistingLookup>
<NotesName>Auteur</NotesName>
<OriginalFieldType>Text</OriginalFieldType>

</d5p1:Value>
</d5p1:KeyValueOfstringFieldImportSettings>

<FillTitleWithField> : Allows you to define the clickable column (must be a TEXT field). By default, if it is empty, the NoteID of the Notes documents will become the clickable column in the default view.

It is possible to use 2 keywords to apply either the values of the DocumentKey (created during the extraction with Notes Extractor), or Subject tags, as below:

<FillTitleWithField>&lt;DocumentKey&gt;</FillTitleWithField>
<FillTitleWithField>&lt;Subject&gt;</FillTitleWithField>

<ListTitle> : Allows you to define the title of the list or library to be imported.

<ListUrl> : Allows you to define the URL of the list or library to be imported.

<TargetFolder i:nil="true" /> (or <TargetFolder>Folder name</TargetFolder> ) : Allows you to define the name of a folder into which all items will be imported. If you want to create a folder tree, it is imperative to separate the folders with a backslash ("\"), example:

<TargetFolder>Parent_Folder\Sub-folder</TargetFolder>

Note that if the Notes documents were sorted into folders, in this case this sorting is preserved. The XML files contain the PreferredFolder tag with a value, like:

<PREFERREDFOLDER><![CDATA[Parent_Folder\Sub-folder]]></PREFERREDFOLDER>

End of the file:
</ImportSettings>
</List>
</ListsImportSettings>
</DataImportSettings>