Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
This CCC Data Warehouse user guide provides support and implementation steps for the Canvas data direct access service exclusively for California Community Colleges
Panel
panelIconIdbgColoratlassian-info
panelIcon:info:
bgColor#FFFFFF
#FFFAE6

NOTE: This document pertains to Canvas 1.0 - currently being replaced with Canvas Data 2 from Instructure.
For information on integrating your college’s Canvas Data 2 API with the CCC Data Warehouse Direct Connect Service, see CCC Data Warehouse - Direct Access User Guide.

...

Introduction

This guide provides colleges with an overview of the implementation process and preparatory steps required for colleges to successfully access their Canvas data in the CCC Data Warehouse.

...

The CCC Data Warehouse can optionally support the inclusion of Canvas data. When a college (or district) elects to have their Canvas data added to the CCC Data Warehouse, these data can then be accessed through a direct connection (secured through the use of a site-to-site VPN). As Canvas data is managed at a district level, each college in a multi-college district may need to opt-in for their data to be supported in the DW. Colleges may request to implement this service by contacting their College Experience Manager (CEM) through CCCTC Enabling Services.

Panel
panelIconId3aa4620c-5738-4e98-b676-3548a28abfa6
panelIcon:canvas:
panelIconText:canvas:
bgColor#F4F5F7

Canvas Data 2

Canvas Data 2 offering is a set of services and technologies that provides institutions with access to download their raw data across various Instructure educational products. Canvas Data 2 allows institution IT/data teams to retrieve their school's LMS data in bulk and keep it up-to-date (4 hours of data freshness) to conduct their own research and build custom reports, dashboards, and tools to meet the unique needs of the institution. Canvas Data 2 allows access to high-fidelity source data and provides more granular datatheir College Experience Manager (CEM) through CCCTC Enabling Services.

Note

Reminder: If your college has not yet implemented the DW Direct ConnectCCC Data Warehouse - Direct Access User Guide service, Enabling Services will get that process started as part of the Canvas direct access service.

...

College Participation

California Community Colleges that have adopted Canvas may requestto implement the inclusion of their Canvas data in the CCC Data Warehousethrough Enabling Services at the CCC Technology Center.

...

In order to access your Canvas data in the CCC Data Warehouse, the Canvas Data 2 API will be used to add your college’s Canvas data to the DW pipeline. This process requires your unique Canvas Data API credentials (API key and secret) in the format that works with the structure of your Canvas account.

...

  1. Open Your Account: Click the Admin link in your Canvas application, then click on the name of your account or sub-account.

  2. Open Canvas Data Portal: In Account Navigation, click the Canvas Data Portal link.

  3. Create API Credentials: Click the Create Credentials button. A success notification with your API credentials will display.

...

4. Copy API Credentials: Once API credentials are created, copy the API Key and API Secret and prepare to pass to the Implementation Engineer at the CCC Technology Center.

Note

Note: If you return to the Credentials Portal, you will be able to see the API Key but not the API Secret.

Tip

Read more creating your Canvas API credentials: How do I obtain an API access token in the Canvas Data Portal?

...

  1. To facilitate the process of adding your Canvas data into the Data Warehouse, provide your API Key and Secret values to your ES Implementation Engineer in the format shown below. These values should be passed using a secure method such as Privnote.

    1. Canvas Data API Key: [canvas-datawarehouse-<misCode>-apikey]
      (Replace <misCode> with your college MIS code, and replace “apikey” with your Canvas API key value generated for your specific Instructure account.)

    2. Canvas Data API Secret: [canvas-datawarehouse-<misCode>-apisecret]
      (Replace <misCode> with your college MIS code, and replace “apisecret” with your Canvas API secret value generated for your specific Instructure account.)

  2. Upon receipt of your API values, your ES Implementation Engineer will facilitate the process of adding your Canvas data into the CCC Data Warehouse with the CCCTC DevOps team.

Note

With your API values in place, the DW data pipeline is configured to securely pass your Canvas data to the CCC Data Warehouse. After that, your Canvas data will be updated nightlyon a recurring/regular schedule.

Creating New API Credentials: You can create new credentials by clicking the Create Credentials button again.

Warning

Important: Generating new API credentials will invalidate the old credentials for all users who have access to them. This includes third-party partner accounts, such as the CCC Data Warehouse.

...

  1. After your Canvas data has been added to the CCC Data Warehouse, the ES Implementation Engineer will guide you to connect to the CCC Data Warehouse through your established DW Direct Connect (ODBC/JDBC) and access your Canvas Data either through your local BI application (typically Tableau or Power BI) or an SQL query.

  2. Once connected, test connection to your Canvas data using your local BI data application, and attempt to run at least one query against the Canvas Data set.

...