Guide de migration pour les éditeurs de logiciels indépendants
Ce document fournit des recommandations aux éditeurs de logiciels indépendants pour offrir une expérience de migration rapide et fiable aux clients. Il contient les pratiques de migration Microsoft les plus récentes et répond aux questions soulevées par les développeurs.
Utiliser l’authentification basée sur l’application
Les modes d’utilisation diffèrent entre le trafic de l’utilisateur final et celui d’une application effectuant des activités en arrière-plan telles qu’une migration. Il est important de distinguer le trafic de l’utilisateur du trafic de l’application.
Pour fournir une plateforme stable et un service plus fiable, Microsoft demande aux éditeurs de logiciels indépendants de passer d’une authentification basée sur l’utilisateur à une authentification basée sur l’application afin d’offrir une plus grande fiabilité aux utilisateurs finaux et aux partenaires.
La migration est une tâche en arrière-plan qui ne doit pas être exécutée en mode utilisateur. En passant à l’authentification basée sur l’application, vous avez la possibilité de tirer parti des heures creuses afin de disposer de davantage de ressources.
Notes
Microsoft commencera à appliquer les rôles d’utilisation appropriés durant le premier trimestre 2020. Les fournisseurs qui continuent à opérer la migration dans des rôles d’utilisateur peuvent s’attendre à une limitation accrue et à des performances médiocres.
Pour en savoir plus sur l’inscription d’un ID d’application et l’implémentation de l’authentification basée sur l’application, voir :
- Comment inscrire un ID d’application
- Conseils d’authentification pour Microsoft Graph : incluent une vidéo informative, des concepts de base et une description de la manière d’inscrire votre application et d’obtenir des scénarios d’accès
- Don’t get throttled! SharePoint and OneDrive guide to staying below the limits
Conseils pour migrer vers une authentification basée sur l’application
Paramètres d’autorisation
Azure Active Directory (AAD) fournit deux types d’autorisations : les autorisations déléguées et les autorisations d’application. Pour obtenir des conseils ADD officiels, consultez :
Pour les scénarios de migration SharePoint et OneDrive, il est conseillé de suivre la spécification d’autorisation AAD.
Pour l’outil de migration qui s’appuie sur la connexion et la présence de l’utilisateur final, une autorisation déléguée est recommandée.
Pour les outils de migration basés sur le service qui s’exécutent sans utilisateur connecté, tels qu’une application s’exécutant en tant que service d’arrière-plan, une autorisation d’application est recommandée.
Nombre d’ID d’application
Des éditeurs de logiciels indépendants nous ont demandé s’il était préférable d’avoir un seul ID d’application pour tous les produits de l’offre de migration ou un ID d’application pour chaque offre logicielle. Il n’existe aucune recommandation spécifique où les éditeurs de logiciels indépendants sont en mesure d’identifier tous leurs ID d’application. Pour des scénarios très spécifiques, veuillez contacter Microsoft.
Notes
Enregistrez tous vos ID d’application de migration avec Microsoft pour vous assurer que vous bénéficiez d’un débit approprié pour vos tâches de migration.
Utiliser l’API de migration
Pour les tâches de migration, la première recommandation consiste à utiliser l’API de migration publié.
API d’importation (CreateMigrationJob)
Le CreateMigrationJob permet aux éditeurs de logiciels indépendants d’importer des données sur SharePoint et OneDrive de façon plus rapide et plus fiable.
Les dernières fonctionnalités prises en charge sont les suivantes :
API d’exportation (lecture asynchrone des métadonnées)
Une nouvelle API de migration, l’API de lecture asynchrone des métadonnées (Exporter API), est disponible pour les éditeurs de logiciels indépendants. AsynchronousMetadataRead aide les éditeurs de logiciels indépendants à exporter du contenu à partir de SharePoint et de OneDrive avec des appels rapides et raccourcis. Par exemple, la nouvelle API peut exporter toutes les métadonnées de fichiers et de listes à partir du niveau racine d’une bibliothèque de documents en un seul appel. Cela a pour effet de réduire le nombre d’appels requis et la probabilité de limitation, ainsi que d’améliorer les performances.
Pour en savoir plus, consultez API Exportation de migration SharePoint (lecture asynchrone des métadonnées)
Passer à l’API Microsoft Graph
Si une fonctionnalité n’est pas prise en charge par l’API de migration, nous vous recommandons d’utiliser l’API Graph. Si l’API Graph ne prend pas en charge la fonctionnalité de migration nécessaire, utilisez CSOM. Cependant, l’utilisation de CSOM augmente la probabilité de limitation.
Conseils pour CSOM (secours uniquement)
Les rubriques suivantes fournissent des conseils sur des scénarios d’implémentation CSOM spécifiques afin de vous aider à améliorer les performances de migration avec SharePoint et OneDrive.
Conseils pour le classement des requêtes d’énumération
Si le client envisage de lire tous les éléments sans filtrage côté serveur, deux genres de requêtes d’énumération sont possibles.
Pour interroger chaque élément de la liste de manière récursive (autrement dit, l’ordre ne dépend pas des dossiers contenant les éléments), la requête doit trier sur l’ID.
<OrderBy Override="TRUE"><FieldRef name="ID"/></OrderBy>
Pour rechercher tous les éléments d’un dossier spécifique, la requête doit trier sur le nom de fichier, FileLeafRef.
<OrderBy Override="TRUE"><FieldRef name="FileLeafRef"/></OrderBy>
Guide relatif aux autorisations
Au fur et à mesure que vous planifiez votre migration vers OneDrive ou SharePoint, vous devez connaître les trois numéros clés, en particulier lorsque vous avez une hiérarchie de dossiers profondément imbriqués. Il s’agit des éléments suivants : (1) nombre d’étendues d’autorisations uniques SharePoint, (2) le nombre d’affectations de rôle et (3) le nombre total d’éléments dans une liste ou une bibliothèque. Lisez l’intégralité du guide :
Pour les migrations sur 100 To
Pour les clients migrant plus de 100 To de données, suivez les instructions relatives à la création d’un ticket de support pour aider l’équipe de produit à préparer le serveur principal.
Réaffectation et limitation
La cause principale de ralentissement de la migration et de limitation est la charge générée par l’appel de CSOM et des API REST. Cette charge a pour effet de déclencher l’application de règles de limitation qui ont une incidence sur la vitesse, la fiabilité et la prévisibilité de la migration. Une limitation vise à protéger la base de données et à garantir une expérience utilisateur optimale pour nos clients.
Pour des conseils officiels sur la limitation, voir :
Nous nous efforçons sans relâche d’épingler des problèmes et d’améliorer l’API. L’API de lecture asynchrone des métadonnées est le résultat direct des commentaires formulés par les éditeurs de logiciels indépendants. En tant qu’éditeur de logiciels indépendant/partenaire, nous apprécions vos commentaires. Si vous avez d’autres questions, contactez Microsoft.