Sources

Bibliothèque SharePoint

SharePoint Online, les bibliothèques de documents sous-jacentes à Microsoft Teams et SharePoint en local. Indiquée par l'URL de la bibliothèque.

OneDrive

Le OneDrive for Business d'un utilisateur, indiqué par l'UPN de l'utilisateur (son adresse de connexion) et, facultativement, par un dossier à l'intérieur.

Partage de fichiers

Un dossier sur un serveur de fichiers ou sur un lecteur local du serveur SMART Migration, indiqué par un chemin UNC ou un lecteur.

Liste de fichiers CSV

Un fichier CSV dans Nextcloud Files qui liste les fichiers à migrer, provenant d'un nombre quelconque des sources ci-dessus. Indiqué par le lien du fichier.

Requête dynamique sur les données BI

Les fichiers qu'une requête DAX Power BI ou une clause SQL WHERE sélectionne dans les données BI, parmi toutes les sources recensées par l'Analyse. En cours de développement.

Une source entière, ou un seul de ses dossiers

Chaque type de source peut être lu en entier ou à partir d'un dossier : une tâche prend une bibliothèque de documents entière, un OneDrive entier ou un partage entier, ou seulement un dossier à l'intérieur, avec les sous-dossiers de ce dossier tant que Inclure les sous-dossiers est activé.

`Source Type`	La source entière	Un seul de ses dossiers
`SharePoint Library`	L'URL de la bibliothèque dans `Source URL` : `https://mytenant.sharepoint.com/sites/S1/LibA`	Le dossier après la bibliothèque : `https://mytenant.sharepoint.com/sites/S1/LibA/MyFolder`
`OneDrive`	L'UPN de l'utilisateur dans `Source UPN`, `Source Folder` laissé vide	L'UPN, et le dossier dans `Source Folder` : `Documents/Archive`
`FileShare`	Un partage sous forme de chemin UNC dans `Source UNC`, `\\MyServer\MyShare`, ou un lecteur du serveur SMART Migration, `D:\`	Un dossier sur l'un ou l'autre : `\\MyServer\MyShare\MyFolder` ou `D:\MyFolder`

Diviser une source volumineuse en une tâche par dossier permet de garder chaque exécution courte et son historique facile à lire ; une seule tâche pour toute la source maintient la source à un seul endroit dans les arborescences et dans le rapport Power BI.

Diviser une très grande bibliothèque en tâches par dossier

Une bibliothèque de documents contenant plusieurs milliers de fichiers peut tout à fait être traitée en une seule tâche. Ce n'est pas le cas d'une bibliothèque contenant des centaines de milliers, voire des millions de documents : migrée en une seule tâche, elle est lente et risque de ne jamais aboutir.

Ne migrez pas une très grande bibliothèque en une seule tâche

Lire une bibliothèque de millions de fichiers en une seule exécution consomme énormément de ressources de SharePoint et de SharePoint Online, ainsi que de mémoire du serveur SMART Migration. Microsoft 365 limite d'autant plus fortement une exécution longue et lourde qu'elle dure longtemps ; le serveur conserve toute l'arborescence des dossiers de la bibliothèque pendant la préparation de la tâche ; et une exécution interrompue vers la fin, par une limitation, une coupure ou un redémarrage, a passé des jours sur un travail qu'il faut vérifier à nouveau.

Partitionnez plutôt la bibliothèque : une tâche par dossier, ou par groupe de dossiers, chacune portant sur une partie de la bibliothèque.

Analysez d'abord la bibliothèque
Exécutez une tâche Analyse sur toute la bibliothèque. Elle ne déplace rien, et le rapport Power BI montre ensuite comment les fichiers, les versions et le volume se répartissent entre ses dossiers.
Choisissez les dossiers
Attribuez une tâche propre à chaque grand dossier de premier niveau (le dossier après la bibliothèque dans Source URL, par exemple .../sites/S1/LibA/Projects) et regroupez les petits dossiers dans quelques tâches supplémentaires. Un dossier encore trop volumineux est à nouveau divisé, un niveau plus bas.
N'oubliez pas les fichiers à la racine
Les fichiers situés à la racine de la bibliothèque, hors de tout dossier, nécessitent eux aussi une tâche : l'URL de la bibliothèque elle-même, avec Inclure les sous-dossiers désactivé.
Gardez les tâches ensemble
Placez les tâches de la bibliothèque dans un même groupe, attribuez-leur une étiquette, par exemple le nom de la bibliothèque, et faites en sorte que leurs destinations reconstituent l'organisation de la bibliothèque dans Nextcloud. Répartissez les plus volumineuses sur les soirées et les week-ends.

Cela demande un peu de planification, et cela en vaut la peine

Diviser une bibliothèque coûte une heure ou deux de planification. En retour, chaque tâche est assez courte pour se terminer en une nuit, une tâche interrompue ne coûte que sa propre partie, la progression de chaque partie est claire dans le Tableau de bord, et les propriétaires peuvent vérifier et valider la bibliothèque dossier par dossier.

Voir aussi Choisir les fichiers qu'une tâche prend et Groupes et étiquettes

Bibliothèques de documents SharePoint et Teams

Pour le Source Type SharePoint Library, Source URL est l'URL de la bibliothèque de documents, par exemple https://mytenant.sharepoint.com/sites/T1/LibB

Un sous-dossier : écrivez son chemin après la bibliothèque, par exemple https://mytenant.sharepoint.com/sites/S1/LibA/MyFolder ou .../LibA/MyFolder/2024 ; la tâche ne lit alors que ce dossier. Vous pouvez aussi ouvrir le dossier dans le navigateur et coller le contenu de la barre d'adresse : l'application le transforme en cette même URL.
Copiez l'adresse depuis le navigateur : voir ci-dessous.
L'URL est vérifiée au fil de la saisie. Il doit s'agir d'une adresse web commençant par https:// ou http:// et comportant un nom de serveur valide. SharePoint n'autorise pas * : < > " | ni ? dans un nom de site, de bibliothèque ou de dossier ; une URL dont le chemin contient l'un de ces caractères, saisi tel quel ou écrit sous la forme %2A ou équivalent, n'est donc pas validée. Un lien de partage, tel que https://mytenant.sharepoint.com/:f:/s/S1/…, ne l'est pas non plus : il désigne un partage, pas un emplacement ; copiez plutôt la barre d'adresse.
Un site n'est pas une bibliothèque. Une adresse qui s'arrête au site, comme https://mytenant.sharepoint.com/sites/S1, n'est pas validée : ajoutez la bibliothèque.
Teams : les fichiers d'une équipe et de ses canaux sont conservés dans une bibliothèque de documents du site SharePoint de l'équipe. Utilisez l'URL de cette bibliothèque.
SharePoint en local : utilisez l'URL de la bibliothèque sur votre batterie de serveurs. SMART Migration s'y connecte avec des identifiants NTLM plutôt qu'avec l'inscription d'application Microsoft 365.

Copier l'adresse directement depuis le navigateur

La façon la plus simple de renseigner Source URL consiste à ouvrir la bibliothèque dans le navigateur (ou n'importe quel dossier qu'elle contient, aussi profond soit-il), à copier ce qu'affiche la barre d'adresse et à le coller.

Ce qu'affiche le navigateur est rarement l'adresse propre de la bibliothèque : c'est une page de la bibliothèque, .../Forms/AllItems.aspx, avec le dossier masqué dans un paramètre id= encodé, suivi d'un identifiant d'affichage. L'application supprime tout cela et conserve l'adresse directe et lisible de la bibliothèque ou du dossier, dès que vous quittez le champ, puis à nouveau lors de l'enregistrement de la tâche :

Collé depuis la barre d'adresse	Devient
`https://mytenant.sharepoint.com/sites/S1/LibA/Forms/AllItems.aspx?id=%2Fsites%2FS1%2FLibA%2FMyFolder&viewid=…`	`https://mytenant.sharepoint.com/sites/S1/LibA/MyFolder`
`https://mytenant.sharepoint.com/sites/S1/Shared%20Documents/Forms/AllItems.aspx`	`https://mytenant.sharepoint.com/sites/S1/Shared Documents`

Les caractères encodés sont reconvertis en ce qu'ils représentent (%20 en espace, %C3%A6 en æ), de sorte que l'adresse se lit telle que SharePoint affiche les noms. Le même nettoyage s'applique à Destination URL et au champ Import SharePoint URL d'une tâche d'import. Il est effectué par l'application seule ; aucune requête n'est envoyée à SharePoint.

Pour créer une tâche par bibliothèque d'un site ou d'un tenant entier, parcourez-le avec une tâche d'import. Voir Importer des tâches en parcourant SharePoint ou OneDrive

OneDrive

Pour le Source Type OneDrive, Source UPN est le nom d'utilisateur principal (UPN) de l'utilisateur dont le OneDrive est lu, par exemple user1@contoso.com. Une adresse sur le domaine onmicrosoft.com du tenant, telle que user1@tenant.onmicrosoft.com, est également valide.

Dossier source est un chemin facultatif à l'intérieur du OneDrive, par exemple Documents/Archive. Laissez-le vide pour lire l'intégralité du lecteur.
Résolu en affiche l'adresse OneDrive que la tâche lira, déduite de l'UPN et du mappage de domaine défini dans l'onglet Paramètres.

Une tâche OneDrive nécessite le mappage de domaine

Microsoft 365 construit l'adresse OneDrive d'un utilisateur à partir du domaine SharePoint propre au tenant, et non à partir du domaine de son UPN. Tant que Map From et Map To ne sont pas définis dans l'onglet Paramètres, une tâche OneDrive ne peut pas déterminer quel OneDrive lire, et un UPN dont le domaine ne correspond pas à Map From n'est pas validé, sauf s'il s'agit d'une adresse onmicrosoft.com, qui désigne elle-même son tenant.

Tous les OneDrive d'un tenant peuvent être transformés en tâches en un seul parcours. Voir OneDrive vers Nextcloud

Partages de fichiers

Pour le Source Type FileShare, Source UNC est le chemin UNC ou le lecteur des fichiers, par exemple \\MyServer\MyShare\MyFolder ou D:\MyFolder

L'autorisation de lecture sur ce chemin doit être accordée au compte Windows sous lequel s'exécute le serveur SMART Migration : c'est le serveur qui lit les fichiers, et non Nextcloud. Un partage de fichiers n'a ni historique des versions ni métadonnées SharePoint ; ces paramètres ne sont donc pas proposés pour lui. Voir Partages de fichiers vers Nextcloud

Une liste de fichiers provenant de plusieurs sources

Pour le Source Type File List CSV, File List Link est le lien vers un fichier CSV dans Nextcloud Files qui liste les fichiers à migrer, un par ligne, par exemple exporté depuis le tableau File details du rapport Power BI Files. Les colonnes y sont séparées par des virgules ou des points-virgules, avec une colonne Name et une colonne Path facultative, dans n'importe quel ordre parmi d'éventuelles autres colonnes ; sans Path, chaque Name est l'URL complète, le chemin UNC ou le chemin de lecteur du fichier. La tâche prend exactement ces fichiers, quelle que soit la bibliothèque SharePoint, le OneDrive ou le partage de fichiers où se trouve chacun d'eux. Ce type est proposé pour les tâches Migration de test et Migration, pas pour Analyse, et Inclure les sous-dossiers n'est pas proposé pour lui : la liste désigne chaque fichier individuellement. Voir Migrer une liste de fichiers depuis un fichier CSV

Une requête sur les données BI

Le Source Type Dynamic BI data query sélectionne les fichiers selon ce qu'ils sont plutôt que selon leur emplacement (plus de 100 versions, une colonne de métadonnées ayant une valeur donnée), parmi toutes les bibliothèques, tous les OneDrive et tous les partages de fichiers recensés par l'Analyse. Il est en cours de développement : ses champs sont affichés dans la boîte de dialogue de la tâche, mais une tâche qui l'utilise ne peut pas encore s'exécuter.

Deux façons de l'écrire : une requête DAX enregistrée dans Power BI avec l'Analyseur de performances, transformée en clause SQL WHERE par Convertir en SQL, ou la clause WHERE écrite à la main.
Appliquée par SMART Migration à chaque exécution : SMART Migration ajoute la clause à sa propre sélection de fichiers dans les données BI ; la sélection est ainsi toujours à jour et ne peut que sélectionner des fichiers.
Maintenue à jour par l'analyse incrémentielle : avec Incrémentiel (uniquement les fichiers modifiés depuis la dernière exécution réussie) sur les tâches d'Analyse des bibliothèques protégées, les données BI suivent les documents chaque nuit, et une tâche de requête conserve une copie exactement des fichiers critiques, pour DORA.
Pas une sauvegarde : une copie récurrente couvre des bibliothèques sélectionnées, moins de 20 en règle générale, jamais plus d'environ 50.

Voir Sélectionner des fichiers avec une requête Power BI ou SQL

Ce que chaque type de source prend en charge

	SharePoint Online et Teams	SharePoint en local	OneDrive	Partage de fichiers
Historique des versions	Oui	Oui	Oui	Non
Métadonnées SharePoint vers MetaVox	Oui	Oui	Oui	Non
Remplacer le fichier source par un lien .url	Oui	Non	Oui	Non
Se connecte avec	Inscription d'application et certificat	Identifiants NTLM	Inscription d'application et certificat	Le compte Windows du serveur

Restreindre la source avec des filtres

Une source n'a pas à être prise en entier. Sous les champs propres à la source, l'étape Source propose des filtres qui sélectionnent les fichiers que la tâche prend. Activez Paramètres avancés, en haut de l'étape, pour les afficher :

Champ	Prend	Exemple
`From Date` et `To Date`	Les fichiers à partir d'une date et heure et jusqu'à une date et heure	Uniquement les deux dernières années : `From Date` deux ans en arrière
`Size From` et `Size To`	Les fichiers d'une taille minimale et maximale, en Ko	Exclure les fichiers de plus de 2 Go : `Size To` `2097152`
`Source File Type`	Les fichiers ayant ces extensions, sans le point, séparées par `;` ou une par ligne	`pdf;docx;xlsx`

Un fichier est pris lorsqu'il satisfait tous les filtres définis. Une fois définis, les filtres restent en vigueur lorsque Paramètres avancés est de nouveau désactivé ; tant qu'il est désactivé, la ligne sous l'interrupteur indique ce qu'il masque. Voir Choisir les fichiers qu'une tâche prend

Autres paramètres de l'étape Source

Inclure les sous-dossiers : lire aussi les dossiers situés sous la source, ou seulement les fichiers à sa racine. Activé par défaut.
Inclure l'historique des versions et Portée de l'historique des versions : voir Historique des versions
Date de début, Date de fin, Taille à partir de, Taille jusqu'à et Type de fichier source (Paramètres avancés) : voir Choisir les fichiers qu'une tâche prend
Migrer les fichiers présentant des avertissements de métadonnées (Paramètres avancés) : voir Métadonnées, MetaVox et vues SharePoint
Remplacer l'élément de la bibliothèque de documents source SharePoint Online par un lien .url vers Nextcloud (Paramètres avancés) : voir Bascule : migration traditionnelle et migration améliorée

Voir aussi