Esta página contiene consultas SQL del acumulador de actividades para la base de datos de Blackboard Learn, de modo que usted pueda obtener información sobre la actividad para el uso móvil de Blackboard. Esta información supone que usted ya tiene la capacidad de acceder a su base de datos y a permisos para información de consulta. Estas consultas están diseñadas para generar informes, por lo que no son necesarios los permisos de escritura.
Recomendamos usar una cuenta con acceso de solo lectura para evitar cambios accidentales. Realizar cambios directamente en la base de datos de cualquier sistema complejo puede generar problemas significativos, como el tiempo de inactividad. Las consultas mencionadas en esta página en este documento no realizan ningún cambio en el sistema.
Los ejemplos de código de consulta SQL se designan en esta página. Las consultas deben darle ideas de cómo funcionan los elementos adicionales. Existen algunas limitaciones en cuanto a la forma en que se registran los datos. Actualmente, no podemos determinar desde qué aplicación o plataforma se realizó un evento en particular. Es decir, cuando observe los datos, no notará la diferencia entre la aplicación de Blackboard y Blackboard Instructor.
En los ejemplos de consultas SQL, se utiliza BBLEARN como el esquema de muestra de la base de datos. La base de datos de Blackboard Learn puede tener los datos almacenados en una cantidad de esquemas alternativos como bb_bb60 o bblearn_stats para datos archivados. Es posible que la primera parte de la consulta deba modificarse para tener en cuenta las variaciones de esquema.
Contar la cantidad total de inicios de sesión móviles durante un período de tiempo específico
Esta consulta muestra la cantidad de veces que un usuario inició sesión en Blackboard Learn desde cualquier aplicación o dispositivo. Cada vez que un usuario inicia sesión cuenta como una vez. Si un usuario se desconecta de manera repetida en un área con mala recepción, se pueden informar muchos inicios de sesión, aunque un usuario con inicio de sesión automático lo verá como una sesión desde su dispositivo. En este ejemplo se muestra un mes de datos.
select Count(*) from bblearn.activity_accumulator
where TIMESTAMP > '01-MAR-2016'
and TIMESTAMP < '01-APR-2016'
and data like '%Mobile Login%'
En la tabla del acumulador de actividades de la base de datos de Blackboard Learn, se registra el Intento de inicio de sesión desde un dispositivo móvil varias veces para cada inicio de sesión de usuario desde una aplicación móvil con la autenticación Forzar a la Web. Más información sobre este problema conocido.
Contar la cantidad de usuarios únicos durante un período específico
Esta consulta muestra la cantidad de usuarios únicos que iniciaron sesión durante un período de tiempo específico. Dado que usa la ID de la base de datos asociada con un inicio de sesión, independientemente de cuántas aplicaciones o dispositivos diferentes usó durante este período, el usuario solo se verá como un usuario. Por ejemplo, si usté está usando esta consulta de manera repetida para crear un informe mes a mes, el usuario será único para cada consulta. Esto significa que cada vez que usted la ejecute, cada usuario se contará una vez. Cada usuario se cuenta por cada mes diferente en el que inició sesión, pero solo una vez por mes. En este ejemplo se muestra un mes de datos.
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 la cantidad de inicios de sesión de usuarios únicos según el rol en el curso
Esta consulta muestra la cantidad de usuarios únicos que iniciaron sesión según su rol en el curso. Combina la tabla activity_accumulator con la tabla course_users (inscripciones). La combinación con la tabla course_users, que contiene el rol de cada usuario en un curso o una organización, puede brindar una estimación aproximada de la cantidad de usuarios que acceden a las aplicaciones Blackboard y Blackboard Instructor. Las mismas pautas que se aplican a "contar la cantidad de usuarios únicos durante un periodo específico" se aplican a esta consulta. Este ejemplo devuelve la cantidad de inicios de sesión mediante dispositivos móviles de profesores únicos durante un mes.
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%';
Tenga en cuenta que para cu.role debe usarse el "ID de rol" del curso o de la organización. Además, es posible que algunos usuarios inicien sesión en la aplicación incorrecta. Por ejemplo, un profesor puede iniciar sesión en la aplicación Blackboard por error. Tenga en cuenta esto a la hora de analizar los resultados.
Mostrar todos los inicios de sesión individuales durante un periodo específico
Esta consulta es efectivamente igual a la consulta "Contar la cantidad total de inicios de sesión móviles durante un período de tiempo específico", con la diferencia que esta muestra todos los datos sin procesar en vez de solo un recuento de la cantidad de filas. Puede ser útil si está buscando patrones, o planeando exportar los datos para que se manipulen para informes más exhaustivos. El carácter "*" en la primera línea significa que se mostrarán todas las columnas de la tabla.
select * from bblearn.activity_accumulator
where TIMESTAMP > '01-MAR-2016'
and TIMESTAMP < '01-APR-2016'
and data like '%Mobile Login%'
Mostrar todas las veces individuales que los usuarios vieron los subprocesos de los foros en un período específico
Con esta consulta, en vez de mirar los datos de inicio de sesión como la página de Mobile Analytics, se observa lo que los estudiantes están haciendo en la aplicación. Siempre que alguien usa la aplicación de Blackboard para ver un subproceso en un foro, el Building Block registra un elemento 'mobile.view.thread' en la tabla activity_accumulator. Esta consulta muestra los momentos en que un alumno miró algún subproceso en algún foro. Si estos datos se combinan con los datos de otras tablas o se manipulan en un programa, como Microsoft Excel, es posible determinar la información sobre los patrones de uso, cursos y alumnos específicos.
select * from bblearn.activity_accumulator
where TIMESTAMP > '01-MAR-2016'
and TIMESTAMP < '01-APR-2016'
and data = 'mobile.view.thread'
Mostrar el uso de todos los dispositivos móviles
La siguiente consulta extrae todos los elementos de Mobile de un mes específico. Sin embargo, la consulta puede incluir resultados para páginas que simplemente contienen la palabra "Mobile". Aunque esta información es útil, puede ser mejor convertir los datos en otro formato para encontrar patrones de uso. Por ejemplo, vea cuáles son los elementos, que han registrado uso, a los que se accede con más frecuencia desde los dispositivos móviles.
select * from bblearn.activity_accumulator
where TIMESTAMP > '01-MAR-2016'
and TIMESTAMP < '01-APR-2016'
and data like '%Mobile%'
Consultas avanzadas
Las siguientes consultas incluyen algunos de los aspectos básicos antes mencionados y muestran las maneras de obtener datos más granulares o colocan los datos juntos para que sean más legibles.
Consulta a los usuarios de Blackboard
Esta consulta incluye todos los datos en la tabla de usuarios. Además, incluye el nombre de usuario de cada usuario y el valor de PK asociado. Son todos los usuarios en Blackboard Learn, independientemente de si usan o no alguno de los productos móviles de Blackboard.
select *
from bblearn.users
Limitar la consulta a columnas específicas
Las consultas en esta página usan un designador '*'en la parte de la consulta en la que puede especificar columnas. Esto hace que SQL devuelva todas las columnas en la tabla, independientemente de si le proporcionan un valor real. La siguiente consulta devuelve todas las líneas de la tabla activity_accumulator, pero solo devuelve 5 columnas. Estas no solo nos permiten identificar el usuario, el curso y el elemento de contenido, sino que también nos proporcionan información del campo de datos y la marca de tiempo desde donde se lleva a cabo la actividad. No se muestra ninguna de las otras columnas.
select user_pk1, course_pk1, content_pk1, data, timestamp
from bblearn.activity_accumulator
Unir varias tablas
Combinar resultados de dos tablas puede ayudarlo a filtrar, limitando así sus datos a los usuarios pertinentes. También puede ingresar el nombre del usuario para asociar directamente usuarios con actividades, de modo que no tenga que buscarlo de forma manual. SQL usa uniones para combinar los resultados de varias tablas. Una unión es una instrucción "where" (donde) que permite a SQL saber que el valor de una tabla es igual al mismo valor en otra tabla.
La siguiente consulta es un ejemplo de una Unión de SQL que usa nuestras tablas. Las uniones pueden ser difíciles y, a veces, pueden requerir mucho de prueba y error. Si planea realizar consultas más complicadas, se recomienda que conozca acerca de las Uniones. Las consultas más complicadas pueden requerir más trabajo del servidor de la base de datos para procesar y pueden tener más errores.
Aquí encontrará un ejemplo línea por línea, y también una buena referencia para crear otras consultas. Esta consulta combina varias partes, presentadas anteriormente, en una consulta que proporciona solo columnas específicas de varias tablas con muchas limitaciones establecidas.
- Especifique las columnas de dos tablas diferentes. Los nombres de las tablas se definen después de las columnas.
- Elija dos tablas y proporcióneles sobrenombres de una sola letra.
- Where es el lugar donde se colocan las condiciones. En SQL, la explicación de cómo las tablas se relacionan se considera una condición. Es necesario que especifique qué columnas son equivalentes, de manera que SQL sepa cómo relacionar los datos.
- Condición adicional: fecha de inicio de la marca de tiempo
- Condición adicional: fecha de finalización de la marca de tiempo
- Condición adicional: delimitador de la columna de datos
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%'
Al igual que una consulta, es posible agregar una condición a la tabla de usuarios, como u.user_id = 'StudentLogin'. Esto permite que una consulta se ejecute en la tabla activity_accumulator sin tener que averiguar el valor de PK1 de los usuarios, siempre que se haya obtenido el nombre de usuario real del estudiante.
Se pueden unir otras tablas. Cuantas más condiciones y uniones se agreguen, más tiempo llevará la consulta, pero se pueden obtener mejores datos. En vez de tener muchas ID de la base de datos, según lo producido de forma predeterminado por la tabla activity_accumulator, el nombre del contenido y los nombres de los cursos pueden rellenarse en la consulta.
Hacer referencia a datos
Eventos móviles
El Building Block de Mobile Web Services registra los siguientes eventos en la tabla activity_accumulator. Esta lista puede modificarse a lo largo del tiempo. Puesto que el Building Block, y no las propias aplicaciones, registran los eventos, el formato de los datos es el mismo independientemente de qué aplicación se usó para realizar la función. En la consulta anterior de las vistas de subprocesos, el parámetro 'mobile.view.thread' puede reemplazarse por cualquiera de las entradas de la siguiente tabla si la entrada contiene texto adicional además del listado móvil. Existen algunas instancias en las que hay diferentes entradas para la misma acción. Esto se debe a que el formato del registro cambió en algún momento; por ello, tal vez tenga que buscar ambos tipos de entradas para obtener los resultados a lo largo del tiempo.
| Evento | Entrada en el campo 'Datos' de la tabla activity_accumulator |
|---|---|
| ver lista de blogs | mobile.list.blogs |
| ver lista de publicaciones | mobile.list.blog.entries |
| ver comentarios de la publicación | mobile.list.blog.comments |
| agregar comentario de diario | mobile.list.journal.add.entry.comment |
| agregar comentario de blog | mobile.list.blog.add.entry.comment |
| agregar entrada de diario | mobile.list.journal.add.entry |
| agregar entrada de blog | mobile.list.blog.add.entry |
| ver lista de diarios | mobile.list.journals |
| ver lista de publicaciones | mobile.list.journal.entries |
| ver comentarios de la publicación | mobile.list.journal.comments |
| ver foros | mobile.list.forums |
| ver subprocesos | mobile.list.threads |
| ver subproceso | mobile.view.thread |
| ver publicaciones del subproceso | mobile.view.thread.post |
| ver anuncios | mobile.view.announcements |
| ver listas | mobile.view.roster |
| ver calificaciones | mobile.view.grades |
| agregar entrada de diario | mobile.add.journal.entry |
| agregar publicación de la base de datos | mobile.add.thread.post |
| agregar comentario de publicación de la base de datos | mobile.add.thread.post.comment |
| ver elemento del contenido | Vista de contenido móvil |
