Configuration manuelle des voies d’apprentissageLearning pathways manual setup

Les chemins d’apprentissage Microsoft 365 offrent une configuration manuelle pour les organisations qui ont besoin d’une prise en charge pour l’un des scénarios suivants :Microsoft 365 learning pathways offers a manual setup for organizations that need support for one of the following scenarios:

  • Votre organisation dispose d’un site de communication moderne SharePoint Online dédié à la formation et vous souhaitez ajouter des voies de formation à ce site.Your organization has an established SharePoint Online modern communication site dedicated to training and you want to add learning pathways to that site. Dans ce scénario, le composant WebPart voies d’apprentissage n’a pas été configuré sur le site.In this scenario, the learning pathways web part hasn't been set up on the site.

  • Vous souhaitez installer les voies de formation pour la prise en charge multilingue dans l’un des sites de communication SharePoint de votre organisation.You want to install learning pathways for multilingual support in one of your organization's SharePoint Communication sites. Le site possède une langue par défaut qui n’est pas l’anglais et est l’une des langues prises en charge par les voies d’apprentissage.The site has, or will have, a default language that isn't English and is one of the languages supported by learning pathways. Voici les langues prises en charge par les voies de formation :Here are the languages supported by learning pathways:

  • AnglaisEnglish

  • Chinois (simplifié)Chinese (Simplified)

  • FrançaisFrench

  • AllemandGerman

  • Italien (Italie)Italian (Italy)

  • Japonais (Japon)Japanese (Japan)

  • Portugais (Brésil)Portuguese (Brazilian)

  • Russe (russe)Russian (Russian)

  • EspagnolSpanish

La configuration manuelle des voies de formation nécessite l’utilisation de Windows PowerShell et de SharePoint Online Management Shell.Manual setup of learning pathways requires experience working with Windows PowerShell and the SharePoint Online Management Shell. Voici une présentation des étapes de la configuration manuelle des voies de formation :Here's an overview of the steps for the manual setup of learning pathways:

  • Vérifiez que vous remplissez toutes les conditions préalables.Validate that you have met all the prerequisites.
  • Vérifiez les paramètres de langue par défaut pour votre site.Check the default language settings for your site. Si ce n’est pas le cas, poursuivez l’installation manuelle.If OK, continue with manual install. Si vous avez besoin d’un autre paramètre de langue par défaut, vous devez créer un nouveau site.If you need a different default language setting, you'll need to create a new site.
  • Installez le fichier customlearning. sppkg dans votre catalogue d’applications client SharePoint.Install the customlearning.sppkg file in your SharePoint Tenant App Catalog.
  • Approvisionner/identifier un site de communication moderne qui se comporte comme votre site d’accueil des chemins d’apprentissage Microsoft 365.Provision/identify a modern communication site to act as your Microsoft 365 learning pathways home site.
  • Exécutez un script PowerShell qui configurera votre client avec les artefacts dont dépend le chemin d’apprentissage.Execute a PowerShell script that will configure your tenant with the artifacts that learning pathways depends on.
  • Accédez à la page de site CustomLearningAdmin. aspx pour charger le composant WebPart d’administration afin d’initialiser la configuration de contenu personnalisé.Navigate to the CustomLearningAdmin.aspx site page to load the admin web part to initialize the custom-content configuration.

Conditions préalablesPrerequisites

Pour garantir la réussite de la configuration manuelle du composant WebPart voies d’apprentissage, les conditions préalables suivantes doivent être remplies.To ensure a successful manual setup of the learning pathways web part, the following prerequisites must be met.

  • Vous devez avoir configuré et configuré le catalogue d’applications à l’échelle du client.You must have set up and configured the tenant-wide App Catalog. Consultez la rubrique configurer votre client Office 365 et suivez la section « créer un catalogue d’applications ».See Set up your Office 365 tenant and follow the "Create App Catalog" site section.
  • Si votre catalogue d’applications à l’échelle du client a déjà été mis en service, vous devez accéder à un compte disposant des droits pour télécharger un package vers celui-ci.If your tenant-wide App Catalog has already been provisioned, you'll need access to an account that has rights to upload a package to it. En règle générale, ce compte dispose d’un rôle d’administrateur SharePoint.Generally this account has a SharePoint administrator role.
  • Si un compte associé à ce rôle ne fonctionne pas, accédez au centre d’administration SharePoint et recherchez les administrateurs de collections de sites pour la collection de sites de catalogue d’applications, ou ouvrez une session en tant qu’administrateur de collection de sites ou ajoutez le compte d’administrateur SharePoint qui a échoué aux administrateurs de collection de sites.If an account with that role doesn't work, go to the SharePoint admin center and find the Site Collection Administrators for the App Catalog site collection and either login as one of the Site Collection Administrators, or add the SharePoint administrator account that failed to the Site Collection Administrators.
  • Vous aurez également besoin d’accéder à un compte qui est un administrateur de client SharePoint.You'll also need access to an account that is a SharePoint Tenant Admin.

Étape 1 : vérifier vos paramètres de langueStep 1 - Check your language settings

Lors de la première étape du processus d’installation manuelle, vérifiez les paramètres de langue de votre site.As the first step of the manual install process, check your site language settings. Les options possibles sont les suivantes :Here are the possible options:

Option 1 : vous ne voulez pas de prise en charge multilingueOption 1 - You don't want multilingual support

Si vous ne voulez pas de prise en charge multilingue pour votre site, vérifiez qu’elle est désactivée.If you don't want multilingual support for your site, ensure it's turned off.

  1. À partir du site de communication SharePoint, sélectionnez paramètresdu > site informations > Afficher tous lesparamètres de langue des paramètres du site > Language settings.From the SharePoint communication site, select Settings > Site information > View all site settings > Language settings.
  2. Définissez le commutateur activer la traduction des pages et des informations en plusieurs langues sur désactivé.Set the Enable pages and news to be translated into multiple languages switch to Off.
  3. Cliquez sur Enregistrer.Click Save.
  4. Passez à l’étape 2.Continue to Step 2.

Option 2 : vous souhaitez une prise en charge multilingue et vous êtes OK avec la langue par défautOption 2 - You want multilingual support and you're OK with the default language

Un site de communication SharePoint possède une langue par défaut.A SharePoint communication site has a default language. La langue par défaut détermine la langue dans laquelle vous visualisez les voies de formation, y compris la page d’administration des voies d’apprentissage.The default language determines the language in which you view learning pathways, including the learning pathways Administration page. Le paramètre de langue par défaut est défini lors de la création initiale du site et ne peut pas être modifié par la suite.The default language setting is set when the site is first created and cannot be changed afterward. Avant de poursuivre la configuration manuelle, vérifiez que vous êtes OK avec la langue par défaut du site cible.Before Continueing with the manual setup, ensure you're OK with default language of the target site.

  1. À partir du site de communication SharePoint, sélectionnez paramètresdu > site informations > Afficher tous lesparamètres de langue des paramètres du site > Language settings.From the SharePoint communication site, select Settings > Site information > View all site settings > Language settings.
  2. Définissez le commutateur activer la traduction des pages et des informations en plusieurs langues sur activé.Set the Enable pages and news to be translated into multiple languages switch to On.
    • Si vous êtes OK avec la langue qui apparaît en haut de la liste sous langue, vous pouvez ajouter des langues supplémentaires, puis cliquez sur Enregistrer.If you're OK with the language that appears at the top of the list under Language, you can add additional languages, and then click Save. Passez à l’étape 2.Continue to Step 2.
    • Si vous souhaitez utiliser une langue par défaut différente de celle sélectionnée pour le site, vous devez créer un nouveau site de communication SharePoint avec la langue de votre choix.If you want a different default language than what's been selected for the site, you'll need to create a new SharePoint Communication site with the language you want. Passez à l’option 3.Continue to Option 3.

Option #3-vous souhaitez une prise en charge multilingue mais souhaitez une autre langue par défaut pour le siteOption #3 - You want multilingual support but want a different default language for the site

Avec cette option, vous créez un site de communication SharePoint Online avec la langue par défaut souhaitée, puis définissez les paramètres de langue pour le site.With this option, you create a new SharePoint Online communication site with the default language you want, and then set the Language settings for the site.

  1. Pour créer un nouveau site de communication SharePoint, voir créer un site de communication dans SharePoint Online.To create a new SharePoint communication site, see Create a communication site in SharePoint Online. Lors de la création du site, veillez à définir la langue sur la langue par défaut souhaitée pour les voies d’apprentissage.When creating the site, be sure to set the language to the default language you want for learning pathways.
  2. À partir du site que vous avez créé, sélectionnez paramètresdes > informations de site > Afficher tous lesparamètres de langue des paramètres du site > Language settings.From the site you created, select Settings > Site information > View all site settings > Language settings.
  3. Définissez le commutateur activer la traduction des pages et des informations en plusieurs langues sur activé.Set the Enable pages and news to be translated into multiple languages switch to On.
  4. Ajoutez des langues supplémentaires, si nécessaire, puis cliquez sur Enregistrer.Add additional languages, if necessary, and then click Save.
  5. Passez à l’étape 2.Continue to Step 2.

! Note Si vous devez migrer le contenu personnalisé d’un site vers un site nouvellement créé, reportez-vous à la section « migrer du contenu personnalisé » plus loin dans ce document.![Note] If you need to migrate custom content from a site to a newly created site, see the "Migrate Custom Content" section later in this document.

Étape 2 : obtenir le package de composants WebPart et le script de configuration à partir de GitHubStep 2 - Get the web part package and setup script from GitHub

Dans le cadre du processus de configuration, vous avez besoin du package de composants WebPart des chemins d’apprentissage Microsoft 365 et du script de configuration de PowerShell.As part of the setup process, you'll need the Microsoft 365 learning pathways Web part package and the PowerShell Setup Script.

  • Accédez au référentiel GitHub des voies d’apprentissage.Go the learning pathways GitHub Repository.
  • Cliquez sur Télécharger pour enregistrer le package de composants WebPart et le script sur un lecteur local.Click Download to save the web part package and script to a local drive. Vous utiliserez le script et le package de composants WebPart dans les étapes ultérieures de ce processus.You'll be using the script and the web part package in later steps of this process.

Étape 2 : Télécharger le composant WebPart dans le catalogue d’applications clientStep 2 - Upload the web part to the Tenant App Catalog

Pour configurer les voies d’apprentissage de Microsoft 365, téléchargez le fichier customlearning. sppkg dans le catalogue d’applications à l’échelle du client et déployez-le.To set up Microsoft 365 learning pathways, you upload the customlearning.sppkg file to the tenant-wide App Catalog and deploy it. Pour obtenir des instructions détaillées sur la façon d’ajouter une application au catalogue d’applications, voir utiliser le catalogue d’applications pour mettre à disposition des applications d’entreprise personnalisées pour votre environnement SharePoint Online .See Use the App Catalog to make custom business apps available for your SharePoint Online environment for detailed instructions on how to add an app to the App Catalog.

Étape 3 : configurer/identifier un site de communication moderneStep 3 - Provision/identify a modern communication site

Identifiez un site de communication SharePoint existant ou approvisionnez-en un nouveau dans votre client SharePoint Online.Either identify an existing SharePoint communication site or provision a new one in your SharePoint Online tenant. Pour plus d’informations sur la mise en service d’un site de communication, voir créer un site de communication dans SharePoint Online et suivre les étapes de création d’un site de communication.For more information about how to provision a communication site see Create a communication site in SharePoint Online and follow the steps to create a communication site.

Étape 4 : ajouter l’application des chemins d’apprentissage Microsoft 365 au siteStep 4 - Add the Microsoft 365 learning pathways app to the site

  1. À partir du site SharePoint, cliquez sur le menu système, puis cliquez sur Ajouter une application.From the SharePoint site, click the System menu, then click Add an App.
  2. Sous vos applications, cliquez sur à partir de votre organisation, puis cliquez sur parcours de formation pour Office 365.Under Your Apps, click From Your Organization, and then click learning pathways for Office 365.

Étape 5 : définir des autorisations pour le siteStep 5 - Set permissions for the site

Assurez-vous que les autorisations suivantes sont définies pour le site :Ensure the following permissions are set for the site:

  • Administrateur de la collection de sites ou partie du groupe propriétaires : autorisations requises pour initialiser l’élément de liste CustomConfig qui configure les voies de formation pour sa première utilisation.Site Collection Administrator or part of the Owners group - Permissions required to initialize the CustomConfig list item that sets up learning pathways for its first use.
  • Groupe de membres -autorisations requises pour administrer les voies de formation, y compris le masquage et l’affichage du contenu, ainsi que l’administration des playlists personnaliséesMembers group - permissions required to Administer learning pathways, including hiding and showing content, and administering custom playlists
  • Groupe visiteurs -autorisations requises pour afficher le contenu du site.Visitors group - permissions required to view site content.

Étape 6-exécuter le script de configuration PowerShellStep 6- Execute PowerShell Configuration Script

Un script PowerShell CustomLearningConfiguration.ps1 est inclus que vous devrez exécuter pour créer trois propriétés de client utilisées par la solution.A PowerShell script CustomLearningConfiguration.ps1 is included that you will need to execute to create three tenant properties that the solution uses. En outre, le script crée deux pages d’application à composant unique dans la bibliothèque pages de site pour héberger les composants WebPart administrateur et utilisateur à un emplacement connu.In addition, the script creates two single part app pages in the site pages library to host the admin and user web parts at a known location.

  1. Si vous n’avez pas encore téléchargé SharePoint Online Management Shell, téléchargez-le maintenant.If you haven't already downloaded the SharePoint Online Management Shell, download it now. Voir téléchargement de SharePoint Online Management Shell.See SharePoint Online Management Shell Download.
  2. Vous devrez peut-être définir une stratégie d’exécution PowerShell pour exécuter le script.You may need to set a PowerShell execution policy to run the script. Pour plus d’informations, consultez la rubrique à propos des stratégies d’exécution.For more information, see About Execution Policies.
  3. Exécutez le CustomLearningConfiguration.ps1 script.Execute the CustomLearningConfiguration.ps1 script. En plus de vos informations d’identification d’administrateur client, le script vous invite à indiquer le nom de votre client et le nom de votre site.In addition to your Tenant Admin credentials, the script will prompt you for your tenant name and site name. Dans l’exemple suivant, pour l’URL de votre site, https://contoso.sharepoint.com/sites/O365CL , contoso est le nom du client et O365CL est le nom du site.Considering the following example for your site URL, https://contoso.sharepoint.com/sites/O365CL, contoso is the tenant name and O365CL is the site name.

Désactivation de la collection de télémétrieDisabling Telemetry Collection

Une partie de cette solution inclut le suivi des télémétries anonyme, qui est défini par défaut sur activé.Part of this solution includes anonymized telemetry tracking opt in, which by default is set to on. Si vous effectuez une installation manuelle et que vous souhaitez désactiver le suivi de la télémétrie, modifiez le CustomlearningConfiguration.ps1 script de manière à définir la variable $optInTelemetry sur $false et exécutez le script.If you are doing a manual install and you would like to turn telemetry tracking off, change the CustomlearningConfiguration.ps1 script to set the $optInTelemetry variable to $false and run the script.

Valider la réussite de la mise en service et initialiser la liste CustomConfigValidate Provisioning Success and Initialize the CustomConfig List

Une fois le script PowerShell exécuté, accédez au site, initialisez l’élément de liste CustomConfig qui configure les voies de formation pour sa première utilisation et validez le bon fonctionnement du site.After the PowerShell script is successfully run, you navigate to the site, initialize the CustomConfig list item that sets up learning pathways for its first use, and validate the site is working.

  • Accédez à <YOUR-SITE-COLLECTION-URL>/SitePages/CustomLearningAdmin.aspx.Go to <YOUR-SITE-COLLECTION-URL>/SitePages/CustomLearningAdmin.aspx. L’ouverture de CustomLearningAdmin.aspx initialise l'élément de liste CustomConfig qui configure le parcours d’apprentissage pour la première utilisation.Opening CustomLearningAdmin.aspx initializes the CustomConfig list item that sets up learning pathways for first use. Vous devriez voir une page semblable à celle-ci :You should see a page that looks like this:

cg-adminapppage.png

Ajouter des propriétaires au siteAdd Owners to Site

En tant qu’administrateur client, il est peu probable que vous soyez la personne qui personnalise le site ; vous devrez donc affecter quelques propriétaires au site.As the Tenant Admin, it's unlikely you'll be the person customizing the site, so you'll need to assign a few owners to the site. Les propriétaires disposent de privilèges d’administrateur sur le site afin qu’ils puissent modifier les pages du site et repersonnaliser le site.Owners have administrative privileges on the site so they can modify site pages and rebrand the site. Ils ont également la possibilité de masquer et d’afficher le contenu fourni via le composant WebPart voies d’apprentissage.They also have the ability to hide and show content delivered through the learning pathways Web part. En outre, ils auront la possibilité de créer une playlist personnalisée et de les affecter à des sous-catégories personnalisées.In addition, they'll have the ability to build custom playlist and assign them to custom subcategories.

  1. Dans le menu paramètres SharePoint, cliquez sur autorisations de site.From the SharePoint Settings menu, click Site Permissions.
  2. Cliquez sur paramètres d’autorisation avancés.Click Advanced Permission Settings.
  3. Cliquez sur voies d’apprentissage pour les propriétaires Office 365.Click learning pathways for Office 365 Owners.
  4. Cliquez sur nouveau > Ajouter des utilisateurs à ce groupe, puis ajoutez les personnes que vous souhaitez être propriétaires.Click New > Add Users to this group, and then add the people you want to be Owners.
  5. Ajoutez un lien pour Explorer le site dans le message de partage, puis cliquez sur partager.Add a link to Explore the Site in the Share message, and then click Share.

Migrer du contenu personnaliséMigrate Custom Content

Une fois que vous avez rétablissez votre site de voies d’apprentissage en suivant les étapes ci-dessus, vous devrez déplacer le contenu de votre liste CustomPlaylists et de votre liste CustomAssets .After you reestablish your learning pathways site by following the steps above, you will need to move the contents of your CustomPlaylists list and your CustomAssets list. Vous pouvez également déplacer les pages personnalisées réelles qui composent vos biens personnalisés si elles résident sur le site des voies d’apprentissage existantes, et que votre intention est de la supprimer.You can also, optionally, move the actual custom pages that make up your custom assets if they live in the existing learning pathways site, and your intent is to delete it. La tâche peut être difficile, car pour tous les éléments de la liste CustomPlaylists , l’ID de l’élément de liste dans la liste CustomAssets est enfoui dans le champ JSONData de chaque élément de liste de playlist.The task can be difficult because for all the items in the CustomPlaylists list, the ID of the list item in the CustomAssets list is buried in the JSONData field of each playlist list item. Par conséquent, le simple fait de simplement délimiter le contenu de la liste CustomPlaylists d’un site à l’autre sera insuffisant.So, simply moving the contents of the CustomPlaylists list from one site to the other will not be sufficient. De plus, la liste CustomAssets contient l’URL absolue de la page de l’élément personnalisé dans le champ JSONData de l’élément de liste.Further, the CustomAssets list contains the absolute URL to the custom asset's page in the JSONData field of the list item. Si les ressources ne sont pas déplacées et que le site n’est pas renommé (ce qui modifie l’URL absolue vers la page de l’élément), CustomAssets peut être conservé.If the assets aren't moved and the site isn't renamed (thus changing the absolute URL to the asset's page), then CustomAssets can remain. Toutefois, vous devrez corriger manuellement les entrées.But you will need to manually correct the entries. Étant donné la complexité de ce type de migration, nous vous conseillons d’avoir inscrit l’un de nos partenaires de parcours de formation pour vous aider à effectuer cette transition.Given the complexity of this type of migration we suggest you consider enlisting one of our learning pathways partners to assist you in making this transition.

Étapes suivantesNext Steps