학습 경로 수동 설정Learning pathways manual setup

Microsoft 365 학습 경로는 다음 시나리오 중 하나를 지원 해야 하는 조직에 대 한 수동 설치를 제공 합니다.Microsoft 365 learning pathways offers a manual setup for organizations that need support for one of the following scenarios:

  • 조직에 교육 전용의 설정 된 SharePoint Online 최신 통신 사이트가 있으며, 해당 사이트에 대해 학습 경로를 추가 하려는 경우Your organization has an established SharePoint Online modern communication site dedicated to training and you want to add learning pathways to that site. 이 시나리오에서는 학습 경로 웹 파트가 사이트에 설정 되지 않았습니다.In this scenario, the learning pathways web part hasn't been set up on the site.

  • 조직의 SharePoint 통신 사이트 중 하나에서 다국어 지원에 대 한 학습 경로를 설치 하려고 합니다.You want to install learning pathways for multilingual support in one of your organization's SharePoint Communication sites. 이 사이트는 영어가 아닌 기본 언어로 제공 되거나 학습 경로에서 지원 되는 언어 중 하나입니다.The site has, or will have, a default language that isn't English and is one of the languages supported by learning pathways. 다음은 학습 경로에서 지 원하는 언어입니다.Here are the languages supported by learning pathways:

  • 영어English

  • 중국어(간체)Chinese (Simplified)

  • 프랑스어French

  • 독일어German

  • 이탈리아어(이탈리아)Italian (Italy)

  • 일본어 (일본)Japanese (Japan)

  • 포르투갈어 (브라질)Portuguese (Brazilian)

  • 러시아어 (러시아어)Russian (Russian)

  • 스페인어Spanish

학습 경로를 수동으로 설정 하려면 Windows PowerShell 및 SharePoint Online 관리 셸을 사용 하는 경험이 필요 합니다.Manual setup of learning pathways requires experience working with Windows PowerShell and the SharePoint Online Management Shell. 다음은 학습 경로의 수동 설정 단계에 대 한 개요입니다.Here's an overview of the steps for the manual setup of learning pathways:

  • 모든 필수 구성 요소를 충족 했는지 확인 합니다.Validate that you have met all the prerequisites.
  • 사이트에 대 한 기본 언어 설정을 확인 합니다.Check the default language settings for your site. 확인 되 면 수동 설치를 계속 합니다.If OK, continue with manual install. 다른 기본 언어 설정이 필요한 경우에는 새 사이트를 만들어야 합니다.If you need a different default language setting, you'll need to create a new site.
  • SharePoint 테 넌 트 앱 카탈로그에 customlearning 파일을 설치 합니다.Install the customlearning.sppkg file in your SharePoint Tenant App Catalog.
  • Microsoft 365 학습 경로 홈 사이트로 작동할 최신 커뮤니케이션 사이트를 프로 비전/식별 합니다.Provision/identify a modern communication site to act as your Microsoft 365 learning pathways home site.
  • 경로 학습 경로가 종속 된 아티팩트를 사용 하 여 테 넌 트를 구성 하는 PowerShell 스크립트를 실행 합니다.Execute a PowerShell script that will configure your tenant with the artifacts that learning pathways depends on.
  • CustomLearningAdmin 사이트 페이지로 이동 하 여 사용자 지정 콘텐츠 구성을 초기화 하기 위해 관리 웹 파트를 로드 합니다.Navigate to the CustomLearningAdmin.aspx site page to load the admin web part to initialize the custom-content configuration.

필수 구성 요소Prerequisites

학습용 경로 웹 파트를 수동으로 설치 하려면 다음 필수 구성 요소를 충족 해야 합니다.To ensure a successful manual setup of the learning pathways web part, the following prerequisites must be met.

  • 테 넌 트 전체 앱 카탈로그를 설정 하 고 구성 해야 합니다.You must have set up and configured the tenant-wide App Catalog. Office 365 테 넌 트 설정을 참조 하 고 "앱 카탈로그 만들기" 사이트 섹션을 따르세요.See Set up your Office 365 tenant and follow the "Create App Catalog" site section.
  • 테 넌 트 전체 앱 카탈로그가 이미 프로 비전 된 경우 패키지를 업로드 하는 데 사용할 수 있는 권한이 있는 계정에 대 한 액세스가 필요 합니다.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. 일반적으로이 계정에는 SharePoint 관리자 역할이 있습니다.Generally this account has a SharePoint administrator role.
  • 해당 역할이 있는 계정이 작동 하지 않으면 SharePoint 관리 센터로 이동 하 여 앱 카탈로그 사이트 모음에 대 한 사이트 모음 관리자를 찾고, 사이트 모음 관리자 중 한 명으로 로그인 하거나, 사이트 모음 관리자에 게 실패 한 SharePoint 관리자 계정을 추가 합니다.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.
  • 또한 SharePoint 테 넌 트 관리자 인 계정에도 액세스 해야 합니다.You'll also need access to an account that is a SharePoint Tenant Admin.

1 단계-언어 설정 확인Step 1 - Check your language settings

수동 설치 프로세스의 첫 단계에서 사이트 언어 설정을 확인 합니다.As the first step of the manual install process, check your site language settings. 사용할 수 있는 옵션은 다음과 같습니다.Here are the possible options:

옵션 1-다국어 지원 안 함Option 1 - You don't want multilingual support

사이트에 대 한 다국어 지원을 사용 하지 않으려면 설정이 해제 되어 있는지 확인 합니다.If you don't want multilingual support for your site, ensure it's turned off.

  1. SharePoint communication 사이트에서 > 사이트 정보 > 보기 모든 사이트 설정 > 언어 설정을선택 합니다.From the SharePoint communication site, select Settings > Site information > View all site settings > Language settings.
  2. 페이지 및 뉴스를 여러 언어로 번역 하도록 사용 을 설정 합니다.Set the Enable pages and news to be translated into multiple languages switch to Off.
  3. 저장을 클릭합니다.Click Save.
  4. 2 단계를 계속 진행 합니다.Continue to Step 2.

옵션 2-다국어 지원을 사용 하며 기본 언어로 확인Option 2 - You want multilingual support and you're OK with the default language

SharePoint communication site에는 기본 언어가 있습니다.A SharePoint communication site has a default language. 기본 언어는 학습 경로 관리 페이지를 포함 하 여 학습 경로를 보는 데 사용할 언어를 결정 합니다.The default language determines the language in which you view learning pathways, including the learning pathways Administration page. 기본 언어 설정은 사이트를 처음 만들 때 설정 되며 나중에 변경할 수 없습니다.The default language setting is set when the site is first created and cannot be changed afterward. 수동 설치를 Continueing 전에 먼저 대상 사이트의 기본 언어를 사용 하는 것이 올바른지 확인 합니다.Before Continueing with the manual setup, ensure you're OK with default language of the target site.

  1. SharePoint communication 사이트에서 > 사이트 정보 > 보기 모든 사이트 설정 > 언어 설정을선택 합니다.From the SharePoint communication site, select Settings > Site information > View all site settings > Language settings.
  2. 페이지 및 뉴스를 여러 언어로 번역할 수 있도록 설정 합니다를 켜기로 전환 합니다.Set the Enable pages and news to be translated into multiple languages switch to On.
    • 언어의 목록 맨 위에 표시 되는 언어를 확인 하는 경우에는 다른 언어를 추가한 다음 저장을 클릭할 수 있습니다.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. 2 단계를 계속 진행 합니다.Continue to Step 2.
    • 사이트에 대해 선택한 것과 다른 기본 언어를 사용 하려면 원하는 언어로 새 SharePoint Communication 사이트를 만들어야 합니다.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. 옵션 3으로 이동 합니다.Continue to Option 3.

옵션 #3-다국어 지원을 사용 하지만 사이트에 대해 다른 기본 언어를 사용 하려고 합니다.Option #3 - You want multilingual support but want a different default language for the site

이 옵션을 사용 하면 기본 언어를 사용 하 여 SharePoint Online 통신 사이트를 새로 만든 다음 사이트에 대 한 언어 설정을 지정할 수 있습니다.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. 새 SharePoint communication site를 만들려면 Sharepoint Online에서 커뮤니케이션 사이트 만들기를 참조 하세요.To create a new SharePoint communication site, see Create a communication site in SharePoint Online. 사이트를 만들 때이 언어를 학습용 경로에 사용할 기본 언어로 설정 해야 합니다.When creating the site, be sure to set the language to the default language you want for learning pathways.
  2. 만든 사이트에서 설정 > 사이트 정보 > 보기 모든 사이트 설정 > 언어 설정을선택 합니다.From the site you created, select Settings > Site information > View all site settings > Language settings.
  3. 페이지 및 뉴스를 여러 언어로 번역할 수 있도록 설정 합니다를 켜기로 전환 합니다.Set the Enable pages and news to be translated into multiple languages switch to On.
  4. 필요한 경우 다른 언어를 추가 하 고 저장을 클릭 합니다.Add additional languages, if necessary, and then click Save.
  5. 2 단계를 계속 진행 합니다.Continue to Step 2.

! 참고 사이트에서 새로 만든 사이트로 사용자 지정 콘텐츠를 마이그레이션해야 하는 경우이 문서의 뒷부분에 나오는 "사용자 지정 콘텐츠 마이그레이션" 섹션을 참조 하십시오.![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.

2 단계-GitHub에서 웹 파트 패키지 및 설치 스크립트 가져오기Step 2 - Get the web part package and setup script from GitHub

설치 프로세스의 일부로 Microsoft 365 learning 경로 웹 파트 패키지 및 PowerShell 설치 스크립트가 필요 합니다.As part of the setup process, you'll need the Microsoft 365 learning pathways Web part package and the PowerShell Setup Script.

  • 학습 경로 GitHub 리포지토리로이동 합니다.Go the learning pathways GitHub Repository.
  • 다운로드 를 클릭 하 여 웹 파트 패키지와 스크립트를 로컬 드라이브에 저장 합니다.Click Download to save the web part package and script to a local drive. 이 프로세스의 이후 단계에서 스크립트 및 웹 파트 패키지를 사용 하 게 됩니다.You'll be using the script and the web part package in later steps of this process.

2 단계-테 넌 트 앱 카탈로그에 웹 파트 업로드Step 2 - Upload the web part to the Tenant App Catalog

Microsoft 365 학습 경로를 설정 하려면 helloworld-webpart.sppkg 파일을 테 넌 트 전체 앱 카탈로그에 업로드 하 고 배포 합니다.To set up Microsoft 365 learning pathways, you upload the customlearning.sppkg file to the tenant-wide App Catalog and deploy it. 앱 카탈로그에 앱을 추가 하는 방법에 대 한 자세한 내용은 앱 카탈로그를 사용 하 여 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.

3 단계-최신 커뮤니케이션 사이트 프로 비전/식별Step 3 - Provision/identify a modern communication site

기존 SharePoint communication site를 식별 하거나 SharePoint Online 테 넌 트에서 새 사이트를 프로 비전 합니다.Either identify an existing SharePoint communication site or provision a new one in your SharePoint Online tenant. 통신 사이트를 구축 하는 방법에 대 한 자세한 내용은 SharePoint Online에서 커뮤니케이션 사이트 만들기 및 단계에 따라 통신 사이트 만들기를 참조 하세요.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.

4 단계-Microsoft 365 학습 경로 앱을 사이트에 추가Step 4 - Add the Microsoft 365 learning pathways app to the site

  1. SharePoint 사이트에서 시스템 메뉴를 클릭 한 다음 앱 추가를 클릭 합니다.From the SharePoint site, click the System menu, then click Add an App.
  2. 아래에서 조직에서를 클릭 한 다음 Office 365에 대 한 학습 경로를 클릭 합니다.Under Your Apps, click From Your Organization, and then click learning pathways for Office 365.

5 단계-사이트에 대 한 사용 권한 설정Step 5 - Set permissions for the site

사이트에 대해 다음 권한이 설정 되어 있는지 확인 합니다.Ensure the following permissions are set for the site:

  • 사이트 모음 관리자 또는 소유자 그룹의 일부 -처음 사용을 위해 학습 경로를 설정 하는 customconfig 목록 항목을 초기화 하는 데 필요한 권한입니다.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.
  • Members group -콘텐츠 숨기기 및 표시, 사용자 지정 재생 목록 관리 등 학습 경로를 관리 하는 데 필요한 사용 권한Members group - permissions required to Administer learning pathways, including hiding and showing content, and administering custom playlists
  • 방문자 그룹 -사이트 콘텐츠를 보는 데 필요한 사용 권한Visitors group - permissions required to view site content.

6 단계-PowerShell 구성 스크립트 실행Step 6- Execute PowerShell Configuration Script

CustomLearningConfiguration.ps1솔루션에서 사용 하는 세 개의 테 넌 트 속성 을 만들기 위해 실행 해야 하는 PowerShell 스크립트가 포함 됩니다.A PowerShell script CustomLearningConfiguration.ps1 is included that you will need to execute to create three tenant properties that the solution uses. 또한이 스크립트는 사이트 페이지 라이브러리에 두 개의 단일 파트 앱 페이지 를 만들어 관리자 및 사용자 웹 파트를 알려진 위치에 호스트 합니다.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. SharePoint Online 관리 셸을 아직 다운로드 하지 않은 경우 지금 다운로드 하세요.If you haven't already downloaded the SharePoint Online Management Shell, download it now. SharePoint Online 관리 셸 다운로드를 참조 하세요.See SharePoint Online Management Shell Download.
  2. 스크립트를 실행 하려면 PowerShell 실행 정책을 설정 해야 할 수 있습니다.You may need to set a PowerShell execution policy to run the script. 자세한 내용은 실행 정책 정보를 참조 하세요.For more information, see About Execution Policies.
  3. 스크립트를 실행 CustomLearningConfiguration.ps1 합니다.Execute the CustomLearningConfiguration.ps1 script. 테 넌 트 관리자 자격 증명 외에도 스크립트는 테 넌 트 이름과 사이트 이름을 입력 하 라는 메시지를 표시 합니다.In addition to your Tenant Admin credentials, the script will prompt you for your tenant name and site name. 사이트 URL에 대해 다음 예제를 고려할 때 https://contoso.sharepoint.com/sites/O365CL , contoso 은 테 넌 트 이름이 며 O365CL 사이트 이름입니다.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.

원격 분석 컬렉션 사용 안 함Disabling Telemetry Collection

이 솔루션의 일부에는 기본적으로 설정 되어 있는 익명 원격 분석 추적 옵트인이 포함 되어 있습니다.Part of this solution includes anonymized telemetry tracking opt in, which by default is set to on. 수동 설치를 수행 하는 경우 원격 분석 추적을 해제 하려면 스크립트를 변경 하 여 CustomlearningConfiguration.ps1 $optInTelemetry 변수를 $false로 설정 하 고 스크립트를 실행 합니다.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.

프로 비전 성공 유효성 검사 및 CustomConfig 목록 초기화Validate Provisioning Success and Initialize the CustomConfig List

PowerShell 스크립트를 성공적으로 실행 한 후 사이트로 이동 하 고 처음 사용 하기 위해 학습 경로를 설정 하는 Customconfig 목록 항목을 초기화 한 다음 사이트가 작동 하는지 확인 합니다.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.

  • <YOUR-SITE-COLLECTION-URL>/SitePages/CustomLearningAdmin.aspx으로 이동합니다.Go to <YOUR-SITE-COLLECTION-URL>/SitePages/CustomLearningAdmin.aspx. CustomLearningAdmin.aspx를 열면 처음 사용할 학습 경로를 설정하는 CustomConfig 목록 항목이 초기화됩니다.Opening CustomLearningAdmin.aspx initializes the CustomConfig list item that sets up learning pathways for first use. 다음과 같은 페이지가 표시 됩니다.You should see a page that looks like this:

cg-adminapppage.png

사이트에 소유자 추가Add Owners to 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. 소유자는 사이트 페이지를 수정 하 고 사이트를 다시 브랜딩 할 수 있도록 사이트에 대 한 관리 권한을 가집니다.Owners have administrative privileges on the site so they can modify site pages and rebrand the site. 또한 학습 경로 웹 파트를 통해 제공 되는 콘텐츠를 숨기 거 나 표시 하는 기능도 제공 됩니다.They also have the ability to hide and show content delivered through the learning pathways Web part. 또한 사용자 지정 재생 목록을 작성 하 고 사용자 지정 하위 범주에 할당할 수 있습니다.In addition, they'll have the ability to build custom playlist and assign them to custom subcategories.

  1. SharePoint 설정 메뉴에서 사이트 사용 권한을클릭 합니다.From the SharePoint Settings menu, click Site Permissions.
  2. 고급 사용 권한 설정을클릭 합니다.Click Advanced Permission Settings.
  3. Office 365 소유자의 학습 경로를클릭 합니다.Click learning pathways for Office 365 Owners.
  4. 새로 만들기 > 사용자를이 그룹에 추가를 클릭 한 다음 소유자가 하려는 사용자를 추가 합니다.Click New > Add Users to this group, and then add the people you want to be Owners.
  5. 링크를 추가 하 여 공유 메시지에서 사이트를 탐색 하 고 공유를 클릭 합니다.Add a link to Explore the Site in the Share message, and then click Share.

사용자 지정 콘텐츠 마이그레이션Migrate Custom Content

위의 단계를 수행 하 여 학습 경로 사이트를 다시 설정한 후에는 Customplaylists 목록 목록과 customplaylists 목록의 내용을 이동 해야 합니다.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. 선택적으로 사용자 지정 자산을 구성 하는 실제 사용자 지정 페이지를 기존 학습 경로 사이트에 두고 이동할 수도 있고,이를 삭제 하는 것도 의도입니다.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. Customplaylists 목록에 있는 모든 항목의 경우에는 customplaylists 목록에 있는 목록 항목의 ID가 각 재생 목록 항목의 JSONData 필드에 가려질 수 있기 때문에 작업을 어려울 수도 있습니다.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. 따라서 Customplaylists 목록 목록의 내용을 한 사이트에서 다른 사이트로 이동 하는 것 만으로는 충분 하지 않습니다.So, simply moving the contents of the CustomPlaylists list from one site to the other will not be sufficient. 또한 Customassets 목록에는 목록 항목의 JSONData 필드에 있는 사용자 지정 자산의 페이지에 대 한 절대 URL이 포함 됩니다.Further, the CustomAssets list contains the absolute URL to the custom asset's page in the JSONData field of the list item. 자산을 이동 하지 않고 사이트의 이름을 바꾸지 않으면 (즉, 자산의 페이지에 대 한 절대 URL을 변경 하는 경우) Customassets 남아 있을 수 있습니다.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. 그러나 항목을 수동으로 수정 해야 합니다.But you will need to manually correct the entries. 이러한 유형의 마이그레이션에 대 한 복잡성이 주어 지 면이 전환을 지원 하기 위해 학습 경로 파트너 중 하나를 등록 하는 것이 좋습니다.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.

다음 단계Next Steps