Compartilhar via

LinkedIn Learning – conector do Power BI

O conector do Power BI do LinkedIn Learning é um conector de dados especializado, projetado e desenvolvido para estabelecer uma conexão direta entre o Power BI e as APIs do LinkedIn Learning. Por meio dessa integração, os usuários podem acessar insights essenciais e métricas de engajamento, incluindo conclusão de cursos, horas de conteúdo visualizado e dias de aprendizado ativo.

Esses insights podem ser agregados, com base em várias entidades, como indivíduos, grupos, contas ou objetos de conteúdo, como cursos e vídeos. As organizações que analisam essas métricas podem medir efetivamente o efeito e o sucesso de suas iniciativas de aprendizagem e desenvolvimento.

Observação

O artigo do conector a seguir é fornecido pelo LinkedIn Learning, proprietário desse conector e membro do Programa de Certificação de Conector do Microsoft Power Query. Se tiver dúvidas sobre o conteúdo deste artigo ou desejar fazer alterações, visite o site do LinkedIn Learning e use os canais de suporte.

Resumo

Item Descrição
Estado da liberação Disponibilidade geral
Produtos Power BI Desktop
Power Apps
Tipos de autenticação compatíveis OAuth 2 passos

Funcionalidades com suporte

  • O conector do Power BI facilita a extração de dados de envolvimento do aluno e informações do curso de maneira direta e prática.

Observação

Alguns recursos mostrados podem não estar presentes por padrão e podem exigir suporte adicional do LinkedIn para serem habilitados. Entre em contato com a equipe de contas do LinkedIn Learning.

Vantagens

  • Não há necessidade de baixar ou receber arquivos CSV.
  • Capacidade de consultar períodos de dados superiores a um ano.
  • Não há necessidade de soluções de codificação para se conectar à API do LinkedIn Learning a fim de obter dados de alunos e de ativos.

Limitações

  • O status da licença do aluno não está acessível na API de relatórios. Portanto, esses dados não estão disponíveis no conector do Power BI.

Pré-requisitos

O cenário descrito neste tutorial pressupõe que você já tem os seguintes pré-requisitos:

  • Um computador Microsoft Windows
  • Microsoft Power BI Desktop: Baixar aqui
  • Acesso de administrador do LinkedIn Learning

Recomendamos que você use a última versão do Power BI para garantir que tenha acesso à última versão do LinkedIn Learning Connector.

Etapas para configurar o conector do Power BI do LinkedIn Learning

As seguintes etapas descrevem o processo de configuração do conector do Power BI do LinkedIn Learning:

Observação

Antes de iniciar essa configuração, verifique se você já gerou as chaves de API para obter a ID do Cliente e o Segredo do Cliente necessários para o conector do Power BI.

Selecione aqui: para obter etapas sobre como provisionar chaves de API

Ao gerar as chaves de API, certifique-se de ter marcado as caixas de seleção "conteúdo e relatório".

Autenticação

Para obter a ID do Cliente e o Segredo do Cliente do LinkedIn Learning, siga estas etapas:

  1. Faça login no LinkedIn Learning. Se você ainda não estiver na tela Administrador, selecione Ir para administrador e Eu > Integrar.

    Captura de tela com a localização da ID do Cliente e do Segredo do Cliente nas configurações de integração do LinkedIn Learning.

  2. Em Acessar conteúdo e relatórios via API, a ID do cliente e o segredo gerados para o conector do Power BI poderão ser localizados aqui.

  3. Em seguida, abra o Power BI, selecione Arquivo e Obter Dados.

  4. Na caixa de pesquisa, procure por "LinkedIn Learning".

    Captura de tela da caixa de pesquisa Obter dados com resultados da busca retornados quando pesquisa-se pelo LinkedIn Learning.

  5. Selecione o Conector LinkedIn Learning

    Captura de tela mostrando onde a ID do Cliente e o Segredo do Cliente devem ser inseridos no Power BI.

  6. Quando solicitado, insira na seção Credenciais de conexão a ID do Cliente e o Segredo do Cliente gerados no LinkedIn Learning. Os parâmetros datetime Data_início e Data_final são opcionais e não são necessários para o sucesso da conexão.

    1. Selecione Básico para o tipo de Autenticação.
    2. Insira a ID do Cliente na seção Nome de usuário.
    3. Insira o Segredo do Cliente na seção Senha.

Dica

É possível usar o parâmetro data_início para baixar os dados de mais de um ano e usar o parâmetro data_final em conjunto com o parâmetro data_início para definir uma janela de dados. Se deixado vazio, o parâmetro data_início será definido automaticamente para a data atual menos 1 ano e o parâmetro data_final será definido para a data atual e será atualizado continuamente durante as atualizações de dados.

Observação

A ID do Cliente e o Segredo do Cliente são armazenados no Power BI e só precisam ser inseridos uma vez. No entanto, você pode atualizá-los em Transformar Dados e, em seguida, Configurações da Fonte de Dados.

Depois de conectadas com êxito, as tabelas de dados disponíveis para carregamento no Power BI agora ficam visíveis.

Captura de tela das tabelas de dados do LinkedIn Learning que estão disponíveis para carregamento no Power BI.

Visão geral das tabelas de dados

Para carregar dados em tabelas, siga estas etapas:

  1. Selecione Obter Dados

  2. Selecione o conector de dados do LinkedIn Learning

  3. Em seguida, selecione as tabelas que gostaria de carregar ou criar

    Captura de tela destacando as etapas necessárias para carregar dados do LinkedIn Learning em tabelas.

Observação

Por padrão, o equivalente a um ano de dados será carregado em cada tabela de dados. Esteja ciente de que isso pode levar algum tempo para carregar. Além disso, as tabelas de dados usadas no conector do Power BI do LinkedIn Learning correspondem aos nossos Pontos de Extremidade de API documentados.

Documentação do Ponto de Extremidade de API:

Todas as tabelas de dados, exceto os Ativos de Aprendizagem, representam relatórios de atividades do aluno. A tabela dos Ativos de Aprendizagem fornece nosso catálogo completo de cursos, incluindo todos os idiomas.

Apesar das várias consultas possíveis disponíveis no Ponto de Extremidade de API dos ativos de aprendizado, todos os ativos são carregados com informações completas. Mais detalhes sobre o ponto de extremidade podem ser encontrados na documentação da API. Localizado Aqui

Opções de renovação dos dados

No Power BI, há duas opções principais para renovar dados a fim de garantir que as informações atualizadas mais recentes estejam disponíveis:

  • Renovação sob demanda: permite que os usuários acionem manualmente uma renovação do conjunto de dados sempre que precisarem atualizar os dados. A renovação sob demanda pode ser feita diretamente da interface do Serviço do Power BI ou por meio do aplicativo Power BI Desktop. A renovação sob demanda é útil quando o acesso imediato aos dados mais recentes é necessário ou quando a fonte de dados não oferece suporte a renovações agendadas.

    Captura de tela mostrando onde o botão Atualizar sob demanda está localizado no Power BI.

  • Renovação agendada: essa opção permite configurar uma agenda de renovação para o conjunto de dados no Serviço do Power BI. Você pode definir com que frequência deseja que os dados sejam renovados, como diariamente, semanalmente ou até mesmo várias vezes por dia.

    Uma renovação agendada pode ser configurada para execução em horários ou intervalos específicos, garantindo que os dados estejam sempre atualizados.

    Essa opção é adequada para conjuntos de dados atualizados regularmente, quando a fonte de dados oferece suporte à renovação agendada.

    Captura de tela mostrando onde o botão Agendar atualização está localizado no Power BI.

Recurso de renovação de dados no conjunto de dados publicado

Para atualizar as tabelas de dados, você pode agendar uma renovação ou executar uma renovação sob demanda.

  1. Selecione o nome do conjunto de dados que deseja renovar.

    Captura de tela dos conjuntos de dados disponíveis para renovação.

  2. Selecione a opção de renovação:

    1. Atualizar agora
    2. Agendar atualização

    Captura de tela dos botões de atualização que mostram as opções disponíveis para renovar, que são Atualizar agora ou Agendar atualização.

Atualização incremental (opcional)

Observação

Antes de começar, verifique se você tem um plano que ofereça suporte a atualizações incrementais A atualização incremental tem suporte para modelos do Power BI Premium, Premium por usuário, Power BI Pro e Power BI Embedded.Clique Aqui

A atualização incremental melhora o desempenho da atualização e oferece vários benefícios. Esse método de renovação funciona definindo uma janela de dados para arquivamento de dados, atualização incremental e dados em tempo real (quando há suporte).

Captura de tela de como uma atualização incremental é executada.

Informações adicionais sobre atualização incremental. Localizado Aqui

  • As atualizações incrementais são configuradas tabela por tabela e exigem a edição da consulta de cada tabela no Power BI Desktop.

Observação

Esse processo é opcional, não sendo necessário para uma integração bem-sucedida com o LinkedIn Learning usando o conector do Power BI.

Configurar a atualização incremental

Para configurar a atualização incremental, siga estas etapas:

  1. Clique com o botão direito do mouse em "Nome da tabela específica"

  2. Selecione "Editar Consulta"

    Captura de tela mostrando a opção de edição de consulta no Power BI.

Observação

São necessários dois parâmetros do tipo datetime: RangeStart e RangeEnd.>Os nomes dos parâmetros não podem ser alterados.

  • RangeStart: defina esse parâmetro para a data a partir da qual os dados precisam ser consultados na API.
  • RangeEnd: defina esse parâmetro para a data de hoje.

  1. Selecione "Gerenciar Parâmetros"

    Captura de tela mostrando a opção de gerenciar parâmetros no Power BI.

  2. Configure os parâmetros de RangeStart e RangeEnd.

    1. Selecione "Novo"
    2. Na seção Nome, insira o nome do parâmetro de datetime, por exemplo, RangeEnd.
    3. Verifique se a caixa de seleção "Obrigatório" está marcada.
    4. Insira os valores da seguinte maneira:

      1. Tipo: Data/Hora

      2. Valores sugeridos: Qualquer valor

      3. Valor atual: Data atual

      4. Repita o mesmo para criar o parâmetro RangeStart, mas certifique-se de que o Valor Atual esteja definido para a data a partir da qual os dados precisam ser consultados.

        Captura de tela destacando as etapas necessárias para criar os parâmetros RangeStart e RangeEnd.

  3. Depois de criar os parâmetros, mova-os para a parte superior da seção de consulta.

  4. Em seguida, selecione o nome da tabela e, nas etapas aplicadas, escolha "Origem".

    Captura de tela das tabelas de dados e da origem a ser selecionada na seção de etapas aplicadas.

  5. Na função de origem, defina os parâmetros conforme mostrado: "= LinkedInLearning.Contents(RangeStart, RangeEnd)"

    Captura de tela mostrando onde os parâmetros são definidos na função de origem.

  6. Repita o processo em todas as tabelas de dados, garantindo que os mesmos parâmetros (RangeStart e RangeEnd) sejam definidos em todas as origens na seção de etapas aplicadas de cada tabela.

  7. Em seguida, configure a filtragem de intervalo de datas.

  8. Em cada tabela ou consulta, selecione Navegação na seção Etapas Aplicadas.

    Captura de tela do intervalo de filtragem disponível para a coluna data, semana.

  9. Crie um filtro de datetime.

    1. Selecione a seta suspensa da "Coluna semana".
    2. Selecione Filtros de "Data/Hora".
    3. Selecione "Filtro Personalizado".
    4. Insira os valores da seguinte maneira:

      1. Selecione Básico.

      2. Escolha "é posterior ou igual a".

      3. Verifique se o parâmetro está definido e selecione "RangeStart".

      4. Selecione E.

      5. Escolha "é anterior".

      6. Verifique se o parâmetro está definido e selecione "RangeEnd".

        Captura de tela da filtragem disponível para a coluna data, semana.

  10. Salve e feche o Editor do Power Query. Esse processo pode levar algum tempo, dependendo do número de tabelas e do intervalo de datas.

  11. A próxima etapa é habilitar a atualização incremental de cada tabela.

    1. Clique com o botão direito do mouse em "Nome da tabela específica".

    2. Selecione "Atualização Incremental".

    3. Selecione "Atualizar esta tabela de maneira incremental".

    4. Configure com base na preferência.

    5. Selecione "Aplicar".

      Captura de tela da opção de atualização incremental.

Dica

Arquivar dados: define o intervalo quando você não deseja mais ver dados. Dados de atualização incremental: define quando os dados não são mais consultados na API. Certifique-se de que a atualização incremental esteja definida para no mínimo 1 mês e no máximo 6 meses.

Colunas de dados/JSON

As seguintes colunas são usadas pelo conector de dados e não devem ser excluídas, pois isso pode causar erros durante a renovação de dados:

  • Semana da época
  • semana
  • parâmetros
  • total_pages_week
  • page_index
  • param_w_start
  • page_data.paging

Além disso, a coluna page_data.paging contém as informações de paginação retornadas pela API.

Se você encontrar o símbolo "expandir" durante a edição de uma consulta, isso indica que ela pode ser expandida para mostrar mais linhas.

Captura de tela da opção de expansão localizada nas colunas de dados.

Expandir a coluna adiciona uma etapa nas configurações de consulta.

  • A expansão de colunas pode ser feita quando necessário, o que duplica linhas.
  • A expansão de colunas é importante para exibir habilidades em ativos de aprendizagem e propriedades personalizadas em relatórios de detalhes do aluno.

Parabéns! Seus administradores de aprendizagem agora podem obter insights importantes e métricas de engajamento por meio do aplicativo Microsoft Power BI.

Problemas comuns e dicas para solução de problemas

Se a atualização de dados falhar ao tentar renová-los:

  1. Selecione o sinal de aviso para ver os detalhes da mensagem de erro e diagnosticar o problema.

Captura de tela do sinal de aviso que pode ser utilizado para analisar mensagens de erro.

  1. Analise os detalhes da mensagem de erro. Analisar essa mensagem ajuda a identificar e resolver quaisquer problemas que impeçam a renovação de dados.

Captura de tela da mensagem de erro.

Perguntas frequentes

Para obter mais informações, consulte LinkedIn Learning Reporting API FAQ.

Recursos adicionais

Aviso de isenção de responsabilidade

O LinkedIn Learning está constantemente investindo na infraestrutura de relatórios. No futuro, pode haver alterações na API de relatórios que exijam ajustes na forma como os dados são consultados. Essas atualizações podem exigir que você faça algumas renovações na sua plataforma. Pretendemos fornecer diretrizes detalhadas antes de quaisquer alterações potenciais para garantir que você tenha tempo suficiente para fazer as mudanças necessárias no aplicativo.