Skip to main content

Atividade de uso do aplicativo Blackboard

Atividade de utilização móvel

Esta página contém consultas SQL do acumulador de atividades para o banco de dados Blackboard para que você possa obter informações de atividades para uso do Blackboard para dispositivos móveis. 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.

Importante

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 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 acessos em dispositivos móveis por um período de tempo especificado

Essa consulta mostra o número de vezes que qualquer usuário acessou o sistema no Blackboard a partir de qualquer aplicativo em qualquer dispositivo. Toda vez que um usuário acessar 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 acesso 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%'

Nota

A tabela do acumulador de atividades no banco de dados da Blackboard registra a Tentativa de acesso móvel várias vezes para cada acesso de usuário do aplicativo móvel com autenticação Force para Web.

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 acesso durante um período de tempo específico. Já que é usado o código do banco de dados associado a um acesso, 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 acesso, 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 acessos de usuários exclusivos por função no curso

Essa consulta mostra o número de usuários exclusivos que fizeram acesso 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 organização 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 acessos 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 organização “Código da função” deve ser usado. Além disso, alguns usuários podem acessar no aplicativo incorreto. Por exemplo, um instrutor pode acessar 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 acesso 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. São todos os usuários da Blackboard, independentemente de usarem ou não qualquer um dos produtos móveis da 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 pode ajudar 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. Onde é o lugar para 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 de início do carimbo de data/hora

  5. Condição adicional: data de término do carimbo de data/hora

  6. Condição adicional: limitador de 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 pode ser adicionada à tabela de usuários, 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.

tabela 68. 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 de participantes

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



Como faço para saber quantos alunos e/ou professores estão usando os aplicativos Bb Mobile?

Para servidores que usam a versão *.2.9 e superior do Building block do Blackboard Mobile Web Services, quando um usuário faz acesso no aplicativo Blackboard Mobile, a função Usuário do BbMobile é adicionada como uma função institucional secundária.

Alunos

Aqui está uma consulta sobre como encontrar todos os usuários alunos que têm o Usuário BbMobile associado a eles como uma função secundária institucional (presumindo que a função 'aluno' seja Institution_roles_pk1 = 1):

SELECT count(distinct u.pk1) as count_BbMobileUser

FROM users u, user_roles r, institution_roles ir

WHERE u.institution_roles_pk1 = '1'

AND u.pk1 = r.users_pk1

AND r.institution_roles_pk1 = ir.pk1

AND ir.role_name = 'BbMobile User';

Universidade

Aqui está uma consulta sobre como encontrar todos os usuários professores que têm o Usuário BbMobile associado a eles como uma função secundária institucional (presumindo que a função 'docente' seja Institution_roles_pk1 = 2):

SELECT count(distinct u.pk1) as count_BbMobileUser

FROM users u, user_roles r, institution_roles ir

WHERE u.institution_roles_pk1 = '2'

AND u.pk1 = r.users_pk1

AND r.institution_roles_pk1 = ir.pk1

AND ir.role_name = 'BbMobile User';

Contando o total de acessos em dispositivos móveis por 1 mês

SELECT Count(*) from bblearn.activity_accumulator

WHERE TIMESTAMP > '01-MAR-2016'

AND TIMESTAMP < '01-APR-2016'

AND data like '%Mobile Login%';

Contando usuários exclusivos por 1 mês

SELECT Count(Distinct(user_pk1))

FROM bblearn.activity_accumulator

WHERE TIMESTAMP > '01-MAR-2016'

AND TIMESTAMP < '01-APR-2016'

AND data like '%Mobile Login%';