Atividade de utilização móvel

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.

É recomendado 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.

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

A tabela acumuladora de atividades no banco de dados do Blackboard Learn registra “Tentativa de logon por dispositivos móveis” três vezes para cada logon de usuário de aplicativo móvel no iOS quando o Mobile B2 é configurado com a autenticação Forçar para a Web. Isso afeta os logons dos aplicativos Blackboard e Blackboard Instructor. As estatísticas de atividade de utilização móvel para logons serão infladas para usuários de aplicativos do iOS.

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

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.

select Count(Distinct(user_pk1)) from bblearn.activity_accumulator
where TIMESTAMP > '01-MAR-2016'
and TIMESTAMP < '01-APR-2016'
and data like '%Mobile Login%'

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

Essa consulta mostra o número de usuários exclusivos que fizeram login 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 logins de instrutores exclusivos em dispositivos móveis em um mês.

select Count(Distinct(user_pk1)) from bblearn.activity_accumulator aa
join bblearn.course_users cu on
aa.user_pk1 = cu.users_pk1
where cu.role = 'P'
and timestamp > '01-NOV-2018'
and timestamp < '30-NOV-2018'
and aa.data like '%Mobile Login%';

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 login no aplicativo incorreto. Por exemplo, um instrutor pode fazer login 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.

select * from bblearn.activity_accumulator
where TIMESTAMP > '01-MAR-2016'
and TIMESTAMP < '01-APR-2016'
and data like '%Mobile Login%'

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 login 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.

select * from bblearn.activity_accumulator
where TIMESTAMP > '01-MAR-2016'
and TIMESTAMP < '01-APR-2016'
and 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.

select * from bblearn.activity_accumulator
where TIMESTAMP > '01-MAR-2016'
and TIMESTAMP < '01-APR-2016'
and data like '%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.

select *
from 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.

select user_pk1, course_pk1, content_pk1, data, timestamp
from 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 is the place to put conditions. 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

select u.user_id, a.data, a.timestamp
from bblearn.activity_accumulator a, bblearn.users u
where u.pk1=a.user_pk1
and a.TIMESTAMP > '01-MAR-2016'
and a.TIMESTAMP < '01-APR-2016'
and a.data like '%Mobile Login%'

Semelhante à consulta, uma condição poderá 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 componente básico 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 componente básico, 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
EventoEntrada no campo 'Data' da tabela activity_accumulator
visualizar lista de blogsmobile.list.blogs
visualizar lista de publicaçõesmobile.list.blog.entries
visualizar comentários de publicaçõesmobile.list.blog.comments
adicionar comentário do diáriomobile.list.journal.add.entry.comment
adicionar comentário do blogmobile.list.blog.add.entry.comment
adicionar entrada do diáriomobile.list.journal.add.entry
adicionar entrada do blogmobile.list.blog.add.entry
visualizar lista de diáriosmobile.list.journals
visualizar lista de publicaçõesmobile.list.journal.entries
visualizar comentários de publicaçõesmobile.list.journal.comments
visualizar fórunsmobile.list.forums
visualizar linhas de discussãomobile.list.threads
visualizar linha de discussãomobile.view.thread
visualizar publicações da linha de discussãomobile.view.thread.post
visualizar anúnciosmobile.view.announcements
visualizar listamobile.view.roster
visualizar notasmobile.view.grades
adicionar entrada do diáriomobile.add.journal.entry
adicionar publicação dbmobile.add.thread.post
adicionar comentário de publicação dbmobile.add.thread.post.comment
visualizar item de conteúdoVisualizar conteúdo móvel