Esta página contém as consultas SQL do acumulador de atividades do banco de dados do Blackboard Learn para que você possa obter informações de atividade para utilização móvel do Blackboard. Essas informações presumem que você já pode acessar seu banco de dados e as permissões para as informações de consulta. Essas consultas foram criadas para criar relatórios e, com isso, não há a necessidade de gravar permissões.

Recomendamos usar uma conta com acesso somente de leitura para evitar alterações acidentais. Fazer alterações diretamente no banco de dados de qualquer sistema complexo pode resultar em problemas significativos, incluindo tempo de inatividade. As consultas relacionadas nesta página do documento não fazem quaisquer alterações no sistema.

Amostras de código de consulta SQL são atribuídas nesta página. Essas consultar devem dar a você ideias de como as coisas adicionais funcionam. Existem algumas poucas limitações na forma como os dados são gravados. No momento, não podemos determinar de qual aplicativo ou plataforma qualquer evento particular foi realizado. Isso significa que, ao considerar os dados, o aplicativo Blackboard e o Blackboard Instructor parecem o mesmo.

Nas amostras de consulta SQL, o bblearn é usado como o esquema de banco de dados de amostra. O banco de dados do Blackboard Learn poderá ter dados armazenados em vários esquemas alternativos, tais comobb_bb60 ou bblearn_stats para dados arquivados. A primeira parte da consulta precisa ser alterada para levar em consideração as variações do esquema.

Contagem do número total de logons em dispositivos móveis por um período de tempo especificado

Essa consulta mostra o número de vez que algum usuário fez logon no Blackboard Learn de qualquer aplicativo em qualquer dispositivo. Toda vez que um usuário fazer logon conta como uma vez. Se um usuário for desconectado várias vezes em uma área de recepção ruim, vários logos poderão ser relatados, embora um usuário com logon automático veja como uma sessão de seu dispositivo. Essa amostra se concentra em um mês de dados.

selecione Count(*) from bblearn.activity_accumulator
where TIMESTAMP > '01-MAR-2016'
and TIMESTAMP < '01-APR-2016'
and data like '%Mobile Logon%'

A tabela acumuladora de atividades no banco de dados do Blackboard Learn registra várias tentativas de logon em dispositivos móveis para cada logon de usuário em aplicativos de dispositivos móveis com a Autenticação forçada para Web. Saiba mais sobre esse problema conhecido.

Contar o número de usuários exclusivos de um período específico

Essa consulta mostra o número de usuários exclusivos que fizeram logon durante um período de tempo específico. Já que é usado o ID do banco de dados associado a um logon, independentemente de quantos aplicativos diferentes ou dispositivos usados durante esse período de tempo específico, o usuário só será exibido como um usuário. Por exemplo, se você estiver usando essa consulta repetidamente para criar um relatório mensal, o usuário será exclusivo para cada consulta. Isso quer dizer que toda vez que você executá-lo, cada usuário será contado uma vez. Cada usuário é contado em cada mês diferente em que fizeram logon, mas apenas uma vez por mês. Essa amostra se concentra em um mês de dados.

selecione Count(Distinct(user_pk1)) em bblearn.activity_accumulator
ondeTIMESTAMP > '01-MAR-2016'
e TIMESTAMP < '01-APR-2016'
e data como '%Mobile Logon%'

Contar o número de logons de usuários exclusivos por função no curso

Essa consulta mostra o número de usuários exclusivos que fizeram logon pela função no curso. Ela une as tabelas activity_accumulator e course_users (matrículas). Unir a tabela course_users, que contém as funções de curso e comunidade de cada usuário, pode fornecer uma estimativa aproximada da quantidade de usuários que acessam os aplicativos Blackboard e Blackboard Instructor. As mesmas diretrizes aplicadas a “contar o número de usuários exclusivos de um período específico de tempo” se aplicam a esta consulta. Este exemplo exibe o número de logons de instrutores exclusivos em dispositivos móveis em um mês.

selecione Count(Distinct(user_pk1)) em bblearn.activity_accumulator aa
join bblearn.course_users atualização cumulativa em
aa.user_pk1 = cu.users_pk1
onde cu.role = 'P'
eTimestamp > '01-NOV-2018'
e timestamp < '30-NOV-2018'
e aa.data como '%Mobile Logon%';

Note que, para cu.role, o curso ou comunidade “CÓDIGO DA FUNÇÃO” deve ser usado. Além disso, alguns usuários podem fazer logon no aplicativo incorreto. Por exemplo, um instrutor pode fazer logon no aplicativo Blackboard por engano. Leve isso em consideração ao analisar os resultados.

Mostrar todos os logos individuais para um período de tempo específico

Essa consulta é efetivamente a mesma da consulta "contagem do número de total de logos em dispositivos móveis em um período de tempo específico", com a diferença de que mostra todos os dados brutos em vez de apenas uma contagem do número de linhas. Isso poderá ser útil se você estiver procurando por padrões ou planejando exportar os dados que serão manipulados em relatórios mais profundos. O caractere '*' na primeira linha significa que ele mostrará todas as colunas da tabela.

selecione * em bblearn.activity_accumulator
onde TIMESTAMP > '01-MAR-2016'
e TIMESTAMP < '01-APR-2016'
e data como '%Mobile Logon%'

Mostrar todas as vezes individuais que usuários visualizaram linhas de discussão do fórum em um período específico

Essa consulta, em vez de procurar por dados de logon como a página Mobile Analytics, procura pelo o que os alunos estão fazendo no aplicativo. Toda vez que alguém usar o aplicativo Blackboard para visualizar uma linha de discussão em um fórum, o Building Block gravará um item 'mobile.view.thread' na tabela activity_accumulator. Essa consulta mostra quando um aluno visualizou alguma linha de discussão em qualquer fórum. Se esses dados estiverem combinados com dados de outras tabelas ou forem manipulados em um programa como o Microsoft Excel, as informações sobre alunos, cursos e padrões de utilização específicos poderão ser determinados.

selecione * em bblearn.activity_accumulator
onde TIMESTAMP > '01-MAR-2016'
e TIMESTAMP < '01-APR-2016'
e data = 'mobile.view.thread'

Mostrar toda a utilização de dispositivos móveis

A seguinte consulta puxa todos os itens de Dispositivos móveis de um mês específico. No entanto, a consulta poderá incluir resultados de páginas que simplesmente contêm a palavras "dispositivo móvel". Embora essas informações sejam úteis, pode ser melhor converter os dados em outro formato para encontrar padrões de utilização. Por exemplo, veja quais itens com registro de utilização são mais comumente acessados em dispositivos móveis.

selecione * em bblearn.activity_accumulator
onde TIMESTAMP > '01-MAR-2016'
e TIMESTAMP < '01-APR-2016'
e data como '%Mobile%'

Consultas avançadas

As seguintes consultas incluem algumas das informações básicas acima e mostram como conseguir mais granularidade ou reunir dados para que fiquem mas legíveis.

Consulta a usuários do Blackboard

Essa consulta inclui todos os dados na tabela de usuários. Isso inclui o nome de usuário de cada usuário e o valor PK associado. Isto é, todos os usuários dentro do Blackboard Learn, independentemente se usam ou não algum produto para dispositivo móvel do Blackboard.

selecione *
em bblearn.users

Limite sua consulta em colunas específicas

Todas as consultas nesta página usaram um designador '*' na parta da consulta que permite que você especifique colunas. Isso faz com que o SQL retorne todas as colunas da tabela, independentemente se forneceram valores reais para você. A seguinte consulta retorna todas as linhas da tabela activity_accumulator, mas só retorna 5 colunas. Elas não apenas nos permitem identificar o usuário, o curso e o item do conteúdo, mas também nos dá informações do campo de dados e o carimbo de data e hora de quando a atividade ocorreu. Nenhuma outra coluna é exibida.

selecione user_pk1, course_pk1, content_pk1, data, timestamp
em bblearn.activity_accumulator

Juntar várias tabelas

Se você combinar resultados de duas tabelas, isso poderá lhe ajuda a filtrar, limitando seus dados ao usuários relevantes. Você também pode puxar pelo nome de usuário para associar diretamente usuários com atividades para que você não tenha que procurar manualmente. O SQL usa junções para combinar os resultados de várias tabelas. Uma junção é uma declaração que permite que o SQL saiba que o valor de uma tabela é igual ao mesmo valor em outra tabela.

A seguinte consulta é um exemplo de uma Junção de SQL que usa nossas tabelas. Junções podem ser difíceis e às vezes requerem muita tentativa e erro. Se você planejar fazer mais consultas complicadas, recomenda-se saber mais sobre as Junções. Consultas mais complicados podem exigir mais trabalho do servidor do banco de dados para processar e tem um potencial maior de dar errado.

Aqui está um exemplo linha por linha, bem como uma boa referência para criar outras consultas. Essa consulta combinas várias partes, apresentadas anteriormente, em uma consulta que dá apenas colunas específicas de várias tabelas com um conjunto de limitações variadas.

  1. Especifique as colunas de duas tabelas diferentes. Os nomes da tabela são definidos após as colunas.
  2. Escolha duas tabelas e dê a elas apelidos de uma única letra.
  3. Where é o local de colocar condições. No SQL, a explicação de como as tabelas estão relacionadas é considerada uma condição. Por isso, você precisa especificar quais colunas são equivalentes para que o SQL saiba como relacionar os dados.
  4. Condição adicional: data inicial do carimbo de data e hora
  5. Condição adicional: data final do carimbo de data e hora
  6. Condição adicional: limitador da coluna de dados

selecione u.user_id, a.data, a.timestamp
em bblearn.activity_accumulator a, bblearn.users u
onde u.pk1=a.user_pk1
e a.TIMESTAMP > '01-MAR-2016'
e a.TIMESTAMP < '01-APR-2016'
e a.data como '%Mobile Logon%'

Semelhante à consulta, uma condição pode ser adicionada à tabela do usuário, como u.user_id = 'StudentLogin'. Isso permite que uma consulta seja executada com a tabela activity_accumulator sem ter de descobrir o valor PK1 dos usuários, contanto que o nome de usuário real do aluno seja obtido.

Outras tabelas podem ser reunidas. Quanto mais condições e junções forem adicionadas, mais tempo levará a consulta, mas melhores dados poderão ser obtidos como resultado. Em vez de ter vários IDs de bancos de dados, como colocado por activity_accumulator por padrão, o nome do conteúdo e os nomes do curso poderão ser preenchidos na consulta.

Dados de referência

Eventos de dispositivo móvel

Os seguintes eventos são registrado pelo building block dos Serviços móveis de Web na tabela activity_accumulator. Essa lista pode mudar ao longo do tempo. Como eventos são registrados pelo building block, e não pelos aplicativos o formato dos dados é o mesmo, independentemente de qual aplicativo foi usado para realizar a função. Na consulta anterior de visualizações de linha de discussão, o parâmetro 'mobile.view.thread' poderá ser substituído por qualquer uma das entradas da tabela abaixo se a entrada contiver texto extra além da própria lista móvel. Existem alguns exemplos nos quais existem entradas diferentes para a mesma ação. Isso é porque o formato de gravação mudou em algum momento para que você possa pesquisa por ambos tipos de entrada e obter resultados ao longo do tempo.

Tipos de conteúdo compatíveis com o aplicativo Blackboard
Evento Entrada no campo 'Data' da tabela activity_accumulator
visualizar lista de blogs mobile.list.blogs
visualizar lista de publicações mobile.list.blog.entries
visualizar comentários de publicações mobile.list.blog.comments
adicionar comentário do diário mobile.list.journal.add.entry.comment
adicionar comentário do blog mobile.list.blog.add.entry.comment
adicionar entrada do diário mobile.list.journal.add.entry
adicionar entrada do blog mobile.list.blog.add.entry
visualizar lista de diários mobile.list.journals
visualizar lista de publicações mobile.list.journal.entries
visualizar comentários de publicações mobile.list.journal.comments
visualizar fóruns mobile.list.forums
visualizar linhas de discussão mobile.list.threads
visualizar linha de discussão mobile.view.thread
visualizar publicações da linha de discussão mobile.view.thread.post
visualizar avisos mobile.view.announcements
visualizar lista mobile.view.roster
visualizar notas mobile.view.grades
adicionar entrada do diário mobile.add.journal.entry
adicionar publicação db mobile.add.thread.post
adicionar comentário de publicação db mobile.add.thread.post.comment
visualizar item de conteúdo Visualizar conteúdo móvel