Configuração manual de roteiros de aprendizagem para multilíngue

Os roteiros de aprendizagem do Microsoft 365 oferecem uma configuração manual para organizações que precisam de suporte para um dos seguintes cenários:

  • Sua organização tem um site de comunicação moderna estabelecido do SharePoint Online dedicado ao treinamento e você deseja adicionar roteiros de aprendizagem a esse site. Nesse cenário, a Web Part de roteiros de aprendizagem não foi configurada no site.

  • Você deseja instalar roteiros de aprendizagem para suporte multilíngue em um dos sites de comunicação do SharePoint da sua organização. O site tem ou terá um idioma padrão que não é o inglês e é um dos idiomas com suporte dos roteiros de aprendizagem. Aqui estão os idiomas com suporte dos roteiros de aprendizagem:

  • Inglês

  • Chinês (simplificado)

  • Francês

  • Alemão

  • Italiano (Itália)

  • Japonês (Japão)

  • Português (Brasil)

  • Russo (Russo)

  • Espanhol

A configuração manual dos roteiros de aprendizagem requer experiência no trabalho com Windows PowerShell e com a Shell de Gerenciamento do SharePoint Online. Aqui está uma visão geral das etapas para a configuração manual dos roteiros de aprendizagem:

  • Valide se você atendeu a todos os pré-requisitos.
  • Verifique as configurações de idioma padrão do seu site. Se tudo bem, continue com a instalação manual. Se você precisar de uma configuração de idioma padrão diferente, precisará criar um novo site.
  • Instale o arquivo customlearning.sppkg no catálogo de aplicativos de locatário do SharePoint.
  • Provisionar/identificar um site de comunicação moderno para atuar como seu site inicial dos roteiros de aprendizagem do Microsoft 365.
  • Execute um script do PowerShell que configurará seu locatário com os artefatos dos quais os roteiros de aprendizagem dependem.
  • Navegue até a página do site CustomLearningAdmin.aspx para carregar a Web Part de administrador para inicializar a configuração de conteúdo personalizado.

Pré-requisitos

Para garantir uma configuração manual bem-sucedida da Web Part de roteiros de aprendizagem, os pré-requisitos a seguir devem ser atendidos.

  • Você deve ter configurado e configurado o Catálogo de Aplicativos em todo o locatário. Confira Configurar seu locatário do Office 365 e siga a seção do site "Criar Catálogo de Aplicativos".
  • Se o Catálogo de Aplicativos de todo o locatário já tiver sido provisionado, você precisará de acesso a uma conta que tenha direitos para carregar um pacote nele. Geralmente, essa conta tem uma função de administrador do SharePoint.
  • Se uma conta com essa função não funcionar, vá para o Centro de administração do SharePoint e localize os Administradores de Conjunto de Sites do conjunto de sites do Catálogo de Aplicativos e faça logon como um dos Administradores do Conjunto de Sites ou adicione a conta de administrador do SharePoint que falhou aos Administradores do Conjunto de Sites.
  • Você também precisará de acesso a uma conta que seja uma Administração de Locatários do SharePoint.

Etapa 1: Verificar as configurações de idioma

Como primeira etapa do processo de instalação manual, marque as configurações de idioma do site. Estas são as opções possíveis:

Opção 1 - Você não deseja suporte multilíngue

Se você não quiser suporte multilíngue para seu site, verifique se ele está desativado.

  1. No site de comunicação do SharePoint, selecione Configurações> Informações >do siteExibir todas as configurações> do siteConfigurações de idioma.
  2. Defina a opção Permitir que páginas e notícias sejam traduzidas para vários idiomas como Desativado.
  3. Clique em Salvar.
  4. Continue para a Etapa 2.

Opção 2 - Você deseja suporte multilíngue e concorda com o idioma padrão

Um site de comunicação do SharePoint tem um idioma padrão. O idioma padrão determina o idioma em que você visualiza os roteiros de aprendizagem, incluindo a página Administração de roteiros de aprendizagem. A configuração de idioma padrão é definida quando o site é criado pela primeira vez e não pode ser alterada posteriormente. Antes de continuar com a configuração manual, verifique se você está de acordo com o idioma padrão do site de destino.

  1. No site de comunicação do SharePoint, selecione Configurações> Informações >do siteExibir todas as configurações> do siteConfigurações de idioma.
  2. Ative a opção Permitir que páginas e notícias sejam traduzidas para vários idiomas.
    • Se você concordar com o idioma que aparece na parte superior da lista em Idioma, poderá adicionar outros idiomas e clicar em Salvar. Continue para a Etapa 2.
    • Se você quiser um idioma padrão diferente do que foi selecionado para o site, será necessário criar um novo site de Comunicação do SharePoint com o idioma desejado. Vá para a Opção 3.

Opção #3 - Você deseja suporte multilíngue, mas deseja um idioma padrão diferente para o site

Com essa opção, você cria um novo site de comunicação do SharePoint Online com o idioma padrão desejado e, em seguida, define as configurações de Idioma para o site.

  1. Para criar um novo site de comunicação do SharePoint, consulte Criar um site de comunicação no SharePoint Online. Ao criar o site, certifique-se de definir o idioma como o idioma padrão desejado para os roteiros de aprendizagem.
  2. No site que você criou, selecione Configurações> Informações >do siteExibir todas as configurações> do siteConfigurações de idioma.
  3. Ative a opção Permitir que páginas e notícias sejam traduzidas para vários idiomas.
  4. Adicione mais idiomas, se necessário, e clique em Salvar.
  5. Continue para a Etapa 2.

! [Nota] Se você precisar migrar conteúdo personalizado de um site para um site recém-criado, consulte a seção "Migrar conteúdo personalizado" mais adiante neste documento.

Etapa 2 - Obter o pacote da web part e o script de instalação do GitHub

Como parte do processo de configuração, você precisará do pacote de Web part de roteiros de aprendizagem do Microsoft 365 e do Script de Configuração do PowerShell.

Etapa 2 – Carregar a Web Part para o Catálogo de Aplicativos de Locatário

Para configurar os roteiros de aprendizagem do Microsoft 365, carregue o arquivo customlearning.sppkg no Catálogo de Aplicativos de todo o locatário e implante-o. Consulte Usar o Catálogo de Aplicativos para disponibilizar aplicativos de negócios personalizados para seu ambiente do SharePoint Online para obter instruções detalhadas sobre como adicionar um aplicativo ao Catálogo de Aplicativos.

Etapa 3 - Provisionar/identificar um site de comunicação moderno

Identifique um site de comunicação existente do SharePoint ou provisione um novo em seu locatário do SharePoint Online. Para obter mais informações sobre como provisionar um site de comunicação, consulte Criar um site de comunicação no SharePoint Online e siga as etapas para criar um site de comunicação.

Etapa 4 - Adicionar o aplicativo de roteiros de aprendizagem do Microsoft 365 ao site

  1. No site do SharePoint, clique no menu Sistema e clique em Adicionar um aplicativo.
  2. Em Seus Aplicativos, clique em Da Sua Organização e, em seguida, clique em roteiros de aprendizagem para o Office 365.

Etapa 5 - Definir permissões para o site

Verifique se as seguintes permissões estão definidas para o site:

  • Administrador do Conjunto de Sites ou parte do grupo Proprietários - Permissões necessárias para inicializar o item da lista CustomConfig que configura os roteiros de aprendizagem para seu primeiro uso.
  • Grupo de membros - permissões necessárias para Administrar roteiros de aprendizagem, incluindo ocultar e mostrar conteúdo e administrar playlists personalizadas
  • Grupo de visitantes - permissões necessárias para exibir o conteúdo do site.

Etapa 6- Execute o script de configuração do PowerShell

Há um script CustomLearningConfiguration.ps1 do PowerShell que você precisará executar para criar três propriedades de locatário que a solução usa. Além disso, o script cria duas páginas de aplicativo de parte única na biblioteca de páginas do site para hospedar as Web Parts de administrador e usuário em um local conhecido.

  1. Se você ainda não baixou o Shell de Gerenciamento do SharePoint Online, baixe-o agora. Consulte Download do Shell de Gerenciamento do SharePoint Online.
  2. Talvez seja necessário definir uma política de execução do PowerShell para executar o script. Para obter mais informações, consulte Sobre políticas de execução.
  3. Execute o CustomLearningConfiguration.ps1 script. Além das credenciais de Administração de Locatário, o script solicitará que você insira o nome do locatário e o nome do site. Considerando o exemplo a seguir para a URL do site, https://contoso.sharepoint.com/sites/O365CL, contoso é o nome do locatário e O365CL é o nome do site.

Desativando a Coleta de Telemetria

Parte dessa solução inclui a aceitação de rastreamento de telemetria anônima, que, por padrão, é definida como ativada. Se você estiver fazendo uma instalação manual e quiser desativar o rastreamento de telemetria, altere o CustomlearningConfiguration.ps1 script para definir a variável $optInTelemetry como $false e execute o script.

Validar o sucesso do provisionamento e inicializar a lista CustomConfig

Depois que o script do PowerShell for executado com êxito, você navegará até o site, inicializará o item de lista CustomConfig que configura os roteiros de aprendizagem para seu primeiro uso e validará se o site está funcionando.

  • Saiba mais em <YOUR-SITE-COLLECTION-URL>/SitePages/CustomLearningAdmin.aspx. Abrir o CustomLearningAdmin.aspx inicializa o item de lista CustomConfig que configura os caminhos de aprendizado para o primeiro uso. Você verá uma página parecida com esta:

Administração aplicativo page.png

Adicionar Proprietários ao Site

Como o Administrador de Administração de Locatários, é improvável que você seja a pessoa que personalizará o site, portanto, você precisará atribuir alguns proprietários ao site. Os proprietários têm privilégios administrativos no site para que possam modificar as páginas do site e renomear o site. Eles também têm a capacidade de ocultar e mostrar o conteúdo fornecido por meio da Web Part de roteiros de aprendizagem. Além disso, eles terão a capacidade de criar listas de reprodução personalizadas e atribuí-las a subcategorias personalizadas.

  1. No menu Configurações do SharePoint, clique em Permissões do Site.
  2. Clique em Configurações Avançadas de Permissão.
  3. Clique em roteiros de aprendizagem para proprietários do Office 365.
  4. Clique em Novo>,Adicionar usuários a este grupo e adicione as pessoas que você deseja que sejam proprietárias.
  5. Adicione um link para Explorar o Site na mensagem Compartilhar e clique em Compartilhar.

Migrar Conteúdo Personalizado

Depois de restabelecer o site de roteiros de aprendizagem seguindo as etapas acima, você precisará mover o conteúdo da lista CustomPlaylists e da lista CustomAssets . Opcionalmente, você também pode mover as páginas personalizadas reais que compõem seus ativos personalizados se eles residirem no site de roteiros de aprendizagem existente e se sua intenção for excluí-los. A tarefa pode ser difícil porque, para todos os itens na lista CustomPlaylists , a ID do item de lista na lista CustomAssets fica oculta no campo JSONData de cada item da lista de lista de reprodução. Portanto, simplesmente mover o conteúdo da lista CustomPlaylists de um site para outro não será suficiente. Além disso, a lista CustomAssets contém a URL absoluta para a página do ativo personalizado no campo JSONData do item de lista. Se os ativos não forem movidos e o site não for renomeado (alterando assim a URL absoluta para a página do ativo), os CustomAssets poderão permanecer. Mas você precisará corrigir manualmente as entradas. Dada a complexidade desse tipo de migração, sugerimos que você considere contratar um de nossos parceiros de roteiros de aprendizagem para ajudá-lo a fazer essa transição.

Próximas etapas

  • Last updated on