Práticas recomendadas para usar o serviço de Relatório Organizacional do Microsoft Learn
Este artigo descreve as práticas recomendadas para usar o serviço de Relatório Organizacional do Learn.
Compreender o Contrato de Acesso e Partilha de Dados do Microsoft Learn
Ao usar este serviço de compartilhamento de dados, você está reconhecendo e aceitando o Contrato de Acesso e Compartilhamento de Dados do Microsoft Learn para permitir que a Microsoft compartilhe dados do Learn com sua organização para usuários do Learn que entram com a ID de locatário da sua organização. Leia e compreenda este contrato antes de usar o Microsoft Learn Organizational Reporting Service e incluir a saída em qualquer ambiente de produção.
Planeje qual solução de relatório você usará para visualizar os dados oferecidos neste serviço
O serviço Microsoft Learn Organizational Reporting fornece dados brutos de conclusão às organizações e não tem painéis por padrão. Você pode pegar os dados e exportá-los para CSV para visualizar rapidamente os dados, mas eles precisam ser unidos para serem impactantes.
Fornecemos um modelo do Learn Organizational Reporting Power BI para armazenamento de banco de dados SQL que tem muitas visualizações de dados padrão nele, mas você também pode usar qualquer solução de relatório de sua escolha. Planeje com antecedência o que você gostaria de usar, para que você possa conectá-lo ao armazenamento de dados como parte do processo de configuração.
Compreender o modelo de conteúdo do Learn
Para usar a resposta do serviço Microsoft Learn Organizational Reporting de forma eficaz, é importante entender os tipos de conteúdo disponíveis no Microsoft Learn e suas relações entre si. Consulte o artigo Tipos de conteúdo do Learn para obter mais informações.
Nomeadamente:
- UID significa "Unique ID" e é exclusivo para cada objeto de conteúdo. Se um UID for alterado, mesmo que o título ou outros metadados permaneçam os mesmos, o conteúdo será considerado um novo objeto.
- Os módulos são o objeto central dentro do catálogo de treinamento do Learn. Todos eles são capazes de ficar sozinhos, no sentido de que ensinam um cenário ou conceito de ponta a ponta dentro deles e não exigem módulos de pré-requisitos. Alguns não fazem parte de um percurso de aprendizagem. Outros estão agrupados num ou em mais percursos de aprendizagem que levam um utilizador a acompanhar a criação de conceitos mais avançados. Um módulo não precisa de fazer parte de um percurso de aprendizagem ou pode fazer parte de um ou mais.
- As unidades não são escritas como conteúdo independente. Devem ser seguidas por uma ordem específica no módulo. Por este motivo, incluímos a ligação para a página de detalhes do módulo e a primeira unidade para que os utilizadores possam começar lá e prosseguir ao longo do conteúdo.
Entender como a localização funciona no Learn e como o conteúdo localizado é refletido na saída de relatórios da organização
O Microsoft Learn oferece suporte a mais de 65 localidades no site e grande parte do conteúdo foi traduzido para essas localidades. Nosso objetivo é disponibilizar o conteúdo em todos os idiomas em que o(s) produto(s) ensinado(s) no conteúdo está disponível, mas nem todas as experiências de localidade traduziram o conteúdo disponível.
Quando um registro de localidade não tem a tradução associada disponível, o conteúdo do site e a resposta da API "retornam" ao inglês como padrão. No caso da saída da API, você verá metadados em inglês em outras respostas de localidade quando o fallback acontecer. No entanto, o URL para o conteúdo ainda apontará para a localidade, mesmo que o conteúdo principal possa cair para trás e o motivo seja permitir que o usuário ainda navegue no site nessa localidade (que mostrará o cabeçalho/rodapé traduzido e qualquer outro link que tenha tradução disponível).
Quando as atualizações são publicadas para o conteúdo em inglês, nossos pipelines de localização trabalham para que as versões localizadas sejam atualizadas o mais rápido possível – geralmente dentro de alguns dias após a alteração original. Você pode ver uma lista completa de localidades suportadas através do rodapé do site (selecione o link para o idioma em que você está visualizando o site).
Nossos registros de conclusão de conteúdo de treinamento são agnósticos à localidade, ou seja, não diferenciamos versões localizadas de conteúdo como objetos separados em nossos registros de conclusão de treinamento do usuário. Não importa em qual idioma um usuário conclua um treinamento, ele receberá crédito pelo objeto geral e não armazenamos uma referência ao idioma em que ele foi concluído. Isso significa que, se você implementar os dados do serviço Learn Organizational Reporting em sua experiência de aprendizagem, precisará levar isso em conta e, se carregar os objetos de conteúdo como objetos separados, implementar uma equivalência entre eles para que, independentemente do idioma em que o usuário conclua o treinamento, ele receba crédito por ele nos outros idiomas e não precise retomá-lo.
Entender como o controle de versão de conteúdo funciona no Learn e como ele se reflete na saída de relatórios da organização
Notavelmente, o conteúdo está sendo atualizado o tempo todo. Publicamos atualizações normalmente duas vezes por dia. Podem ser menores, como pequenas alterações de texto, ou maiores, como grandes revisões, adições ou exclusões. Em geral, o portfólio de conteúdo é gerenciado como um projeto de código aberto massivo e altamente governado com milhares de contribuidores e, como tal, mudanças estão acontecendo o tempo todo. Se você usar os dados do serviço Learn Organizational Reporting em seu sistema de produção, deverá estar ciente disso e ter seu sistema capaz de lidar com isso.
Quando novos objetos de conteúdo são adicionados, eles aparecem como um novo objeto (identificado pelo UID) na resposta. Quando o conteúdo é modificado, você pode saber com base em seu valor last_modified. Quando o conteúdo for excluído, ele será removido da resposta. Embora às vezes haja um pequeno atraso na atualização do conteúdo na resposta da API, quando um usuário segue a URL do conteúdo, ele sempre verá as informações mais atuais. No caso de exclusões, o URL antigo será redirecionado para o novo conteúdo ou experiência.
Não há referências a versões de conteúdo no momento além da last_modified data.
Compreender as limitações do serviço de Relatório Organizacional
Consulte Limitações no artigo de visão geral do recurso do serviço Learn Organizational Reporting Service.
Atualize os dados regularmente
Se você estiver usando as informações do catálogo dos dados do serviço Learn Organizational Reporting para dar suporte aos seus processos de negócios ou exibindo para os clientes como parte da experiência do seu site, certifique-se de atualizar o conteúdo pelo menos uma vez por dia.
Notavelmente, o conteúdo está sendo atualizado o tempo todo. Publicamos atualizações normalmente duas vezes por dia. Podem ser menores, como pequenas alterações de texto, ou maiores, como grandes revisões, adições ou exclusões. Em geral, o portfólio de conteúdo é gerenciado como um projeto de código aberto massivo e altamente governado com milhares de contribuidores e, como tal, mudanças estão acontecendo o tempo todo. Se você usar os dados do serviço de Relatório Organizacional em seu sistema de produção, deverá estar ciente disso e ter seu sistema capaz de lidar com isso.
Certifique-se de que as informações associadas ao Microsoft Entra sejam atualizadas regularmente
Para saber a quem cada registro de conclusão está se referindo, você precisará unir os dados do conjunto de dados do Relatório Organizacional às suas informações do Microsoft Entra, para que os nomes apareçam ao lado dos registros de conclusão. Se você não atualizar seus dados associados do Microsoft Entra, poderá ter registros de conclusão com dados pessoais obsoletos ou que estejam faltando dados de PII associados a eles.
Consulte a documentação do desenvolvedor
A documentação do desenvolvedor do serviço Learn Organizational Reporting tem uma lista completa dos dados fornecidos como parte da resposta e recomendações sobre como cada campo é recomendado para ser usado para dar suporte a ótimas experiências de aprendizagem.
Próximos passos
Para obter mais informações para apoiá-lo com o Learn Organizational Reporting Service, revise os seguintes artigos: