Advanced System Reporting Overview
Overview of Advanced System Reporting Function Data Installation and SetupAdvanced System Reporting: Sample TemplatesAdvanced System Reporting Database AttributesAuto-Reporting OptionsSend System Statistics to BlackboardHow to allow Clients access to Stats DatabaseHow to verify access to Stats DatabaseHow to pull stats without Crystal Reports
Advanced System Reporting
Robust reporting to understand how their system is being used
Data from predefined fields in the bb_bb60_stats database is used to create and tailor reports to meet specific institutional needs
These reports assist in understanding and analyzing use of the system and can report information such as:– when different types of users access the system– how they use the system– if the system improves Student performance.
Function Where does the data come from?
Data is transferred nightly into a separate reporting database.Nightly job executed from the bb-task.xml file
From the bb_bb60 schema to the bb_bb60_stats
Function (cont.)Data from the bb_bb60 schema is transferred into the bb_bb60_stats to handle the Advanced System Reporting tool.
The following are the tables from the bb_bb60 Schema that is then transferred nightly to the bb_bb60_stats schema:
Function (cont.)
By default the scheduling of the data transfer occurs at 1am which is typically where low load is seen on the app1 server.
System Administrators have access to the stats database to use the Crystal Reports template that Blackboard provides to develop reports to suit their Institutional needs.
Data Data transferred to statistics database is a sub-set of data from production database.
The bb_bb60 is the main database also referred to as the “Production Database”The bb_bb60_stats is the statistical database where the a sub-set of the tables below get transferred into nightly:
SID
bb_bb60 bb_bb60_stats
Data (cont.)How to verify Purge of data:
View the “update-tool-log.txt” located in the /usr/local/blackboard/logs/update-tools directory
Installation and Setup Advanced System Reporting is set up automatically when the Blackboard Academic Suite is installed.The Enable Event Tracking option must be set to Yes on the Auto-Reporting Options page before Statistics will be recorded. (default it is on.)
Purging data in the databases
Every day automatic process runs that synchronizes the sub-set of data in the stats database with the data in the main database.
Once the synchronization is complete the statistical data is deleted from the main database that is more than 180 days old.
Purging data in the databases (cont.)
The synchronization process only occurs for Enterprise licenses. For Basic clients any data older than 180 (default setting) simply gets deleted.
The synchronization process can be run at any time using the PurgeAccumulator tool.- Location> /usr/local/blackboard/tools/admin- Cmd> ./PurgeAccumulator.sh <command>
<Virtual_Installation> <days_or_date>
Advanced System Reporting: Sample Templates
Bb Academic Suite includes a set of ASR templates for use with Crystal Reports
Template use requires license for Crystal reports from Crystal Decisions Inc.
Advanced System Reporting Database Attributes
The following excerpts diagrams details the shared rows in the reporting database tables.The relationship between the tables is used to define and return customized data reports.
Advanced System Reporting Database Attributes (cont.)
ACTIVITY_ACCUMULATOR
PK1EVENT_TYPEUSER_PK1COURSE_PK1GROUP_PK1FORUM_PK1INTERNAL_HANDLECONTENT_PK1DATATIMESTAMPSTATUSMESSAGESSESSION_ID
APPLICATION
PK1APPLICATIONLARGE_ICONPLUGINS_PK1ENABLED_MASKSSL_INDRELABEL_INDLABELSMALL_ICONTYPEDESCRIPTIONALLOW_GUEST_MASKALLOW_OBSERVER_MASKNAMECAN_RELABEL_INDCAN_ALLOW_GUEST_INDCAN_ALLOW_OBSERVER_INDCAN_CONFIGURE_INDCONFIGURE_URL
COURSE_ROLES
PK1COURSE_ROLENAMEDEFAULT_NAMEORG_NAMEORG_DEFAULT_NAME
COURSE_USERS
PK1CRSMAIN_PK1DATA_SRC_PK1ROLELINK_NAME_1LINK_URL_1LINK_DESC_1LINK_NAME_2LINK_URL_2LINK_DESC_2LINK_NAME_3LINK_URL_3LINK_DESC_3USERS_PK1PHOTO_LINKINTRONOTEPINFOCARTRIDGE_INDAVAILABLE_INDSOS_ID_PK2ROW_STATUSENROLLMENT_DATECRSMAIN_SOS_ID_PK2USERS_SOS_ID_PK2DTMODIFIED
INSTITUTION_ROLES
PK1ROLE_NAME
COURSES
PK1BUTTONSTYLES_PK1CARTRIDGE_PK1CLASSIFICATIONS_PK1DATA_SRC_PK1SOS_ID_PK2DTCREATEDDTMODIFIEDCOURSE_NAMECOURSE_IDCOURSE_DESCROW_STATUSBATCH_UIDENROLL_OPTIONDURATIONPACESERVICE_LEVELABS_LIMITSOFT_LIMITUPLOAD_LIMITSTART_DATEEND_DATEENROLL_START_DATEENROLL_END_DATEDAYS_OF_USEFEEENROLL_ACCESS_CODEBANNER_URLINSTITUTION_NAMEREG_LEVEL_INDNAVIGATION_STYLETEXTCOLORBACKGROUND_COLORCOLLAPSIBLE_INDCATALOG_INDLOCKOUT_INDDESC_PAGE_INDAVAILABLE_INDALLOW_OBSERVER_INDLOWER_COURSE_ID
DATA_SOURCE
PK1DTMODIFIEDROW_STATUSBATCH_UIDDESCRIPTION
NAVIGATION_ITEM
PK1APPLICATIONINTERNAL_HANDLEENTITLEMENT_UIDFAMILYHREFENABLED_MASKCOMPONENT_TYPENAVIGATION_TYPESRCLABELDESCRIPTIONSUB_GROUPPOSITIONLAUNCH_INDREDIRECT_URLUSER_LABELVISIBLE_IND
SYSTEM_ROLES
PK1SYSTEM_ROLENAMEDEFAULT_NAME
SYSTEM_TRACKING
PK1TIMESTAMPCOURSESACTIVECOURSESCARTRIDGESORGANIZATIONSACTIVEORGANIZATIONSUSERSACTIVEUSERSUSERS_ZUSERS_AUSERS_CUSERS_HUSERS_NUSERS_OUSERS_RUSERS_UACTIVE_COURSE_USERSCOURSE_USERS_BCOURSE_USERS_GCOURSE_USERS_PCOURSE_USERS_SCOURSE_USERS_TCOURSE_USERS_UINST_USERS_1INST_USERS_2INST_USERS_3INST_USERS_4INST_USERS_5INST_USERS_6INST_USERS_7INST_USERS_8INST_USERS_9INST_USERS_10INST_USERS_11INST_USERS_12INST_USERS_13INST_USERS_14INST_USERS_15INST_USERS_16INST_USERS_17INST_USERS_18INST_USERS_19INST_USERS_20PAGE_VIEWSSESSIONSCOURSE_PAGE_VIEWSSYSTEMEXTENSIONSLOGIN_ATTEMPTS_SUCCESSLOGIN_ATTEMPTS_FAILURE
USERS
PK1CITYDATA_SRC_PK1SYSTEM_ROLESOS_ID_PK2DTCREATEDDTMODIFIEDROW_STATUSBATCH_UIDUSER_IDPASSWDFIRSTNAMEMIDDLENAMELASTNAMEGENDEREDUC_LEVELBIRTHDATETITLESTUDENT_IDEMAILJOB_TITLEDEPARTMENTCOMPANYSTREET_1INSTITUTION_ROLES_PK1STREET_2STATEZIP_CODECOUNTRYB_PHONE_1B_PHONE_2H_PHONE_1H_PHONE_2M_PHONEB_FAXH_FAXWEBPAGESETTINGSCOMMERCE_ROLECDROMDRIVE_PCCDROMDRIVE_MACPUBLIC_INDADDRESS_INDPHONE_INDWORK_INDEMAIL_INDAVAILABLE_INDLAST_LOGIN_DATEIM_TYPEIM_ACCOUNT
ADVANCED SYSTEM REPORTINGBlackboard Learning SystemTM (Release 6)
NOTE: Fields in gray are database control fields© 2003 Blackboard Inc. Proprietary and Confidential
ORGANIZATIONS
PK1BUTTONSTYLES_PK1CARTRIDGE_PK1CLASSIFICATIONS_PK1DATA_SRC_PK1SOS_ID_PK2DTCREATEDDTMODIFIEDCOURSE_NAMECOURSE_IDCOURSE_DESCROW_STATUSBATCH_UIDENROLL_OPTIONDURATIONPACESERVICE_LEVELABS_LIMITSOFT_LIMITUPLOAD_LIMITSTART_DATEEND_DATEENROLL_START_DATEENROLL_END_DATEDAYS_OF_USEFEEENROLL_ACCESS_CODEBANNER_URLINSTITUTION_NAMEREG_LEVEL_INDNAVIGATION_STYLETEXTCOLORBACKGROUND_COLORCOLLAPSIBLE_INDCATALOG_INDLOCKOUT_INDDESC_PAGE_INDAVAILABLE_INDALLOW_OBSERVER_INDLOWER_COURSE_ID
This
is a
vie
w o
f Cou
rse_
Mai
n
This
is a
vie
w o
f Cou
rse_
Mai
n
Advanced System Reporting Database Attributes (cont.)
Attribute Definitions– The tables below detail the attributes in each database table.
Each of the tables below includes the following columns: Attribute: The name of the attribute as it appears in the database. Data Type: The format of the information stored in the attribute
(date, varchar, etc.) Null? Indicated whether or not null values are allowed. Y indicates
that null values are allowed for the attribute, N indicates that null values are not allowed for the attribute.
Description: Explains the information stored in the attribute and its importance.
Advanced System Reporting Database Attributes (cont.)
Attribute: The name of the attribute as it appears in the database.
Advanced System Reporting Database Attributes (cont.)
Data Type: The format of the information stored in the attribute (date, varchar, etc.)
Advanced System Reporting Database Attributes (cont.)
Null? Indicated whether or not null values are allowed. Y indicates that null values are allowed for the attribute, N indicates that null values are not allowed for the attribute.
Advanced System Reporting Database Attributes (cont.)
Description: Explains the information stored in the attribute and its importance.
Advanced System Reporting Database Attributes (cont.)
Event Types (Only for AA Table):– The following table lists the possible event types stored in the
ACTIVITY_ACCUMULATOR table.– The Page View column shows whether or not the activity counts as a
page view when generating statistics.
Advanced System Reporting Database Attributes (cont.)
Tables:– ACTIVITY_ACCUMULATOR– COURSE_ROLES– COURSE_USERS– SYSTEM_ROLES– INSTITUTION_ROLES– USER_ROLES– APPLICATION– NAVIGATION_ITEM– USERS– COURSE_MAIN– DATA_SOURCE– SYSTEM_TRACKING
Auto-Reporting Options
Auto-reporting sends system updates to a secure Blackboard server automatically.Blackboard Support uses this information to assist the Administrator in maintaining Blackboard Academic Suite
Auto-Reporting Options (cont.)
Benefits of auto-reporting
Assist in capacity planning with Blackboard Academic Suite for future growth
Notification from Blackboard Learning System when a patch or upgrade is available
Assist system maintenance with the help of Blackboard Support staff
Send System Statistics to Blackboard
Email system statistics to Blackboard from the Send System Statistics to Blackboard page.Blackboard Support staff use system statistics to help troubleshoot problems.
How to allow Clients access to Stats Database
Client to provide you with a STATIC IP where the ASR tool will be kicked off from. Create a CR with OPS to send to Infra to open up firewall via port 1521Create a CR with OPS to create a “asr_user” for the database.Capture the following to provide to the client:
Hostname: 192.xxx.xxx.xxx (hosted database IP address)Port Number: 1521SID: Univ6Username (typically): asr_userPassword: Univ6asrpass
How to verify access to Stats Database
1. From the Windows desktop click Start, Run.2. In the resulting Run dialogue box, type "cmd" and click the OK
button.3. In the resulting command window, type telnet (hosted database
IP) 172.25.1.112 1521 and press Enter on your keyboard.
How to verify access to Stats Database (cont.)
4. You will see Connecting To 172.25.1.112 5. After a few minutes if there is a connection problem the
message above will be amended with Could not open connection to the host. This means the connection is blocked by a firewall. Arrangements must be made for the workstation to have firewall access to the database. This may involve setting up a static IP for the workstation by your IT staff and communicating this information to the institution where your database is housed.
Top Related