Installation et configuration manuelles de l’apprentissage personnalisé pour Office 365Manually installing and configuring Custom Learning for Office 365

Le composant WebPart formation personnalisée Microsoft est créé à l’aide de la version 1.7.1 de SharePoint Framework .The Microsoft Custom Learning Web Part is build using the SharePoint Framework version 1.7.1.

Pour installer et configurer manuellement le composant WebPart et la collection de sites, vous devez effectuer les étapes suivantes :To manually install and configure the web part and site collection you will need to complete the following steps:

  1. Vérifiez que vous remplissez toutes les conditions préalables.Validate that you have met all the prerequisites.
  2. Installez le fichier customlearning. sppkg dans votre catalogue d’applications client 365 Office.Install the customlearning.sppkg file in your Office 365 Tenant App Catalog.
  3. Approvisionner/identifier un site de communication moderne qui sert de formation personnalisée pour votre site d’accueil Office 365.Provision/Identify a modern communication site to act as your Custom Learning for Office 365 home site.
  4. Exécutez un script PowerShell qui configurera votre client avec les artefacts appropriés dont dépend l’apprentissage personnalisé.Execute a PowerShell script that will configure your tenant with the appropriate artifacts that Custom Learning depends on.
  5. 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

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 site de catalogue d’applications.Please 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 aurez besoin d’accéder à un compte disposant de droits de chargement d’un package vers celui-ci pour terminer le processus d’installation.If your tenant-wide App Catalog has already been provisioned you will need access to an account that has rights to upload a package to it to complete this setup process. Il s’agit généralement d’un compte doté du rôle d’administrateur SharePoint.Generally this is an account with the 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 et connectez-vous 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 does not work, go to the SharePoint admin center and find the Site Collection Administrators for the app catalog site collection and either log in 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’un accès à un compte qui est un administrateur de client SharePoint.You will also need access to an account that is a SharePoint Tenant Admin.

Télécharger le composant WebPart dans le catalogue d’applications clientUpload the web part to the Tenant App Catalog

Pour configurer la formation personnalisée pour Office 365, téléchargez le fichier customlearning. sppkg dans le catalogue d’applications à l’échelle du client et déployez-le.To set up Custom Learning for Office 365, you upload the customlearning.sppkg file to the tenant-wide App Catalog and deploy it. Pour obtenir des instructions détaillées sur l’ajout d’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 .Please 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.

Mettre en service/identifier un site de communication moderneProvision/Identify 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.

Définir des autorisations pour le siteSet permissions for the site

Vous pouvez ajouter tout le monde qui doit être en mesure d’afficher le contenu au groupe visiteurs et à toutes les personnes qui doivent être en mesure d’administrer les playlists personnalisées au groupe membres.You will want to add everyone who should be able to view content to the Visitors group and everyone who should be able to administer custom playlists to the Members group. Pour configurer le site pour la formation personnalisée la première fois, l’utilisateur doit être administrateur de collection de sites ou appartenir au groupe propriétaires.To configure the site for Custom Learning the first time the user must be either a site collection administrator or part of the Owners group.

Ajoutez une application personnalisée d’application Office 365 à la collection de sites.Add Custom Learning for Office 365 App to the site collection.

Exécuter un script de configuration PowerShellExecute 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. De plus, 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.

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.If you are performing a manual install and you would like to turn telemetry tracking off, please change the CustomlearningConfiguration.ps1 script to set the $optInTelemetry variable to $false.

Si vous n’effectuez pas une installation manuelle et souhaitez désactiver le suivi de la télémétrie, un script distinct TelemetryOptOut.ps1 a été inclus, lorsque l’exécution désactivera le suivi de télémétrie.If you are not performing a manual install and would like to turn telemetry tracking off, a seperate script TelemetryOptOut.ps1 has been included that when run will disable telemetry tracking.

Initialiser la configuration personnalisée du composant WebPartInitialize web part custom configuration

Une fois le script PowerShell exécuté, accédez à <YOUR-SITE-COLLECTION-URL>/SitePages/CustomLearningAdmin.aspx .After the PowerShell script is successfully run, navigate to <YOUR-SITE-COLLECTION-URL>/SitePages/CustomLearningAdmin.aspx. Cela initialise l’élément de liste CustomConfig qui configure la formation personnalisée pour sa première utilisation.This initializes the CustomConfig list item that sets up custom learning for its first use.

La configuration est maintenant terminée et vous pouvez passer à l’aide de la formation personnalisée pour Office 365.The configuration is now complete and you can move forward with using Custom Learning for Office 365. Pour plus d’informations, reportez-vous à la documentation de l’utilisateur.Please see the user documentation for more information.