Unizin Product Documentation
ProductsSupport and TrainingPolicies
  • Unizin Product Documentation
  • Products
    • Content
      • Unizin Engage
        • eReader User Guide
          • Notes, Highlights, and Citations
          • Appearance Settings
          • Download for Offline
          • eReader Layout
          • Keyboard Shortcuts
          • Navigating Your eBook
          • Print
          • Text to Speech
          • Copy and Paste
          • Creating Flashcards
          • Collaboration and Note Sharing
          • Pearson Titles
        • Institution Support
          • Disabled Student Services / Alt-Format
            • Best Practices for Republishing Course Content
            • Disabled Student Services
            • Requesting eTextbook Files for Accessibility Purposes
            • WCAG 2.0 AA evaluation for Engage
            • WCAG 2.0 AA evaluation for EPUB for Engage
          • Institution's Support Responsibilities
        • Caliper 1.1 sensor
        • Release Notes
          • 2.28.22
          • 2019-09-17
          • 2019-05-29
          • 2.26.8
          • 2.26.0
          • 2.25.0
          • 2.22.0
          • 2.21.6
          • 2.21.5
          • 2.20.8
          • 2.20.5
          • 2.20.3
          • 2.19.1
          • 2.18.0
          • 2.17.0
          • 2.14.0
          • 2.12.0
          • 2.11.0
          • 2.9.0
          • 2.8.3
          • 2016-03-17
          • 2016-02-11
          • 2016-01-28
        • Using Analytics (New)
      • Unizin Order Tool
        • Overview of the User Interface
        • Key Concepts
          • Profiles
          • Ordering periods
          • Coordinator permissions
          • Program administrator permissions
        • Courses & Ordering
          • Course filtering
          • Place an order
          • Add sections to a placed order
          • Edit a placed order
          • Cancel an order
          • Reordering
        • Order History
          • Instructor Order History
          • Coordinator and Program Administrator Order History
          • Order Activity
        • Student Choice
          • Student Choice (Program Administrators)
          • Student Choice (Students)
        • Entitlements
          • Entitlements (Program Administrators)
          • Entitlements (Students)
        • Catalog Tool
        • Schedule of Classes
        • Content Request Tool
        • Order Tool Dashboard
        • Vendor Sandbox Tenant
        • Institution Support
        • Implementation
          • SIS Data Integration
            • 1.0 - SIS Integration
            • 2.0 - SIS Integration
          • SSO integration
          • UI customizations
          • Order Feed
            • 1.0 - Order Feed
            • 2.0 - Order Feed
            • 3.0 - Order Feed
          • Publisher report
          • Final declined offers feed
          • Institutional (SIS) Catalog Import
          • Student Price
          • Historical Entitlements Import
        • Release Notes
          • Order Tool Bug Fixes and Enhancements
          • Order Tool Bug Fixes
          • Order Tool Accessibility Improvements
          • Order Feed Improvements
          • Content Request Form Update and Minor Bug Fix
          • Flat Markup Fee Update
          • Ordering Email Receipt Update & Minor Bug Fix
          • Bug Fix for Public Catalog Feature
          • Catalog Search Enhancements
          • Reordering Reminder Email Notifications
          • UX Improvements & Minor Bug Fixes
          • Historical Entitlements Import
          • Student Prices
          • Reordering Feature
          • Email Enhancements
          • Ordering Enhancements
          • Bug Fix for the Institutional Catalog Import
          • Bug Fix for the Final Declined Offers Feed (FDOF)
          • Order Activity Feature and Other Enhancements
          • Bug Fixes for Order History and Report an Issue Features
          • Public catalog feature
          • Minor Bug Fixes for Ordering and Student Choice
          • Entitlements Production Release, Bug fixes, and Minor updates
          • Minor Updates and Bug Fixes for Ordering Workflows
          • Catalog Search Optimization
          • Student Choice
          • Archive Terms Feature and Integration Improvements
          • Introduces the Program Administrator role, Catalog Tool, and Schedule
          • User interface updates and improvements
          • Order feed improvements
          • Order history, UI enhancements
          • Email notification upgrades, UI improvements
          • Order feed changes
          • New features for Course coordinators and upgrades to the UI
          • Changes to the Term, Course, and Section models; introduces a Session
          • Bug fixes, import improvements, and validation improvements
          • Tracking Order History
          • Publisher Reporting
          • Fixes the order feed, automates SIS data importing, and automates the generation of order feed repor
    • Data & Analytics
      • Unizin Data Platform
        • Key concepts
          • Platform overview
          • Data categories
          • Data models
          • Loading schemas
          • Keymap
        • Unizin Common Data Model
          • Academic structures (ERD)
          • Learners (ERD)
          • Course structures (ERD)
          • Course resources (ERD)
          • Learner activities (ERD)
          • Quizzes (ERD)
          • Social (ERD)
          • Course outcomes (ERD)
        • System overview
          • Context data pipeline
            • Context data ingress
            • Batch-ingest application
            • Batch-ingest db server
            • Context store
          • Event data pipeline
            • UDP Caliper endpoint
            • Approval process for implementing Caliper compliant tools
            • UDP Event enricher
            • Event store
        • Data stores
          • Data lake
            • UDP Context store
            • UDP Event store
              • Accessing the Event store
              • Expanded table
                • Expanded table: Canvas edApp mapping
            • Synthetic Data [beta]
              • Viewing Synthetic Data datasets within the BigQuery UI
              • Query Synthetic Data via client libraries
          • Data marts
            • UDP Distributions
            • Interaction sessions
            • Learning Environment Organization
            • File Interaction
            • Last Activity
            • Long Inactivity
            • Course Status
            • Daily Course Grade Record
            • LTI Tool Use
            • LMS Tool Use
            • Tool Usage Metrics
            • Links
            • Taskforce
              • Level 1 Aggregated
              • Level 2 Aggregated
              • Level 2 Course Weekly Distribution Summary
              • Student Term Profile
              • Course Profile
            • Student Activity Score
              • Student Course Metrics
              • Student Course Section Metrics
              • Final
              • Course Final
              • Course Section Final
        • Data integrations
          • Context data integration
            • Loading schema
            • Keymap support
            • Manifest file
            • File requirements
            • Integration mechanics
          • Event data integration
          • SIS data integration
          • LMS data integration
            • Instructure Canvas
        • Release Notes
          • UDP Marts Release Notes
            • 1.0.83
            • 1.0.80
            • 1.0.79
            • 1.0.78
            • 1.0.77
            • 1.0.72
            • 1.0.67
            • 1.0.58
            • 1.0.51
            • 1.0.44
            • 1.0.42
            • 1.0.32
            • 1.0.31
            • 1.0.0
            • Level 2 Taskforce data marts now available
          • 2.0.167
          • 2.0.152
          • 2.0.138
          • 2.0.137
          • 2.0.113
          • 2.0.112
          • 2.0.111
          • 2.0.110
          • 2.0.99
          • 2.0.98
          • 2.0.83
          • 2.0.80
          • 2.0.71
          • 2.0.66
          • 2.0.59
          • 2.0.58
          • 2.0.53
          • 2.0.47
          • 2.0.25
        • Miscellaneous
          • Canvas Data additions, ~Fall 2021
          • Canvas Live Events: from SQS to HTTPS
          • Canvas New Analytics vs. UDP
          • Course Section Enrollment Role Status Mappings
          • Migrating from UDW to UDP
      • Unizin Data Warehouse
        • Implementation Guide
        • Scope of Services
        • Access Provisioning
        • Access Revocation
        • Connecting to the UDW
      • Raw Canvas Data 2
        • Flat Files
        • BigQuery Datasets
    • Hosted Services
      • My Learning Analytics
        • Install MyLA via LTI 1.3
        • Custom configure MyLA
  • Support and Training
    • Professional Development
      • Stepping Stones: A Faculty Development Curriculum for Learning Analytics Use
      • Structured Conversations initiative
    • UDP Self-paced Training
    • Resources Site Broken Links
    • Status Pages
  • Policies
    • General policies
      • Sponsor Teams
      • Browser Support Policy
      • Opt-Out & Invoicing Policy (Order Tool)
    • Support Policy
      • Unizin Engage - SP
      • Unizin Order Tool - SP
      • Unizin Data Platform - SP
      • Unizin Data Warehouse - SP
      • Unizin Data Analysis - SP
      • Pressbooks Hosting - SP
    • Privacy Policy
      • Unizin Engage - PP
      • Unizin Order Tool - PP
      • Unizin Data Platform - PP
      • RStudio service - PP
    • End User License Agreements
      • Unizin Engage - EULA
      • Unizin Order Tool - EULA
    • Terms of Use
      • Unizin Data Platform - ToU
    • Incident Reports
Powered by GitBook
LogoLogo

Unizin Homepage

  • unizin.org

Data & Analytics

  • Unizin Data Platform
  • Unizin Data Warehouse

Content

  • Unizin Engage
  • Unizin Order Tool

Hosted Services

  • My Learning Analytics

Copyright © 2023, Unizin, Ltd.

On this page
  • Contents
  • Manifest File Version 2
  • File Name Requirements
  • Version 2
  • Version 1
  • Manifest File Version 1 (No longer implemented)
  1. Products
  2. Data & Analytics
  3. Unizin Data Platform
  4. Data integrations
  5. Context data integration

Manifest file

A manifest file is an important part of every context dataset pushed to the UDP. It describes the contents of a full context dataset in such a way that the UDP can validate the completeness and integrity of the dataset before importing it into a UDP instance.

Contents

A manifest file is a YAML file whose keys enable the UDP to ensure that a complete dataset is available and valid prior to ingestion.

Here is an example of the recommended version 2 (v2) manifest file used for SIS loading schema:

Manifest File Version 2

# The version of the manifest file used
# in this dataset.
manifest_version: "v2"

# The name of the system whose data is ingested,
# where values may include 'peoplesoft', 'banner',
# 'canvas-data', etc. depending on the application.
source: "my_sis"

# The UCDM version number this dataset's format
# corresponds to.
data_schema: "2.0"

# The ISO 8601 UTC datetime stamp describing how current this dump is.
# In most cases, simply providing when the dataset was produced works well.
datetime: "2021-12-10T19:11:23Z"

# A unique identifier for the dataset, such as a UUID
dump_id: "b4f8eec7-7adc-47a1-83a4-238f1032da00"

# An object of the files included in the dataset.
# For each file, an MD5 checksum is provided.
files:
  academic_term: 9c9e18230ff048f2837889f41e1faba2
  course_offering: 64388cb12350d966fbdc37b9e6c02014
  course_section: 4388cb129e18230ff048f2831e1fa14

files:
  - academic_term: 9c9e18230ff048f2837889f41e1faba2
  - course_offering: 64388cb12350d966fbdc37b9e6c02014
  - course_section: 4388cb129e18230ff048f2831e1fa14   
...

Note: Both formats for the files section as listed above are supported for manifest v2 in batch ingest. This only applies to manifest v2.

The complete set of keys that must be provided in a manifest file are:

Key
Definition

manifest_version

The version of the manifest file format used in this manifest file. New implementations should use "v2".

source

The name of the system from which data is generated to conform with a UDP loading schema. For example, "sis" is the source value for the SIS Loading schema.

data_schema

The version of the UDP loading schema to which this dataset conforms. New implementations should use "2.0".

datetime

The ISO 8601 UTC datetime describing when the dataset was produced.

dump_id

A unique identifier for this particular dataset dump.

files

An object with keys for each provided loading schema entities (such as person), with values of the MD5 hash (a checksum) of each corresponding CSV file (such as person.csv).

Prior to import, the UDP will compute the MD5 hash for each entity's file indicated in the manifest file. If they match, then the files have been transported accurately and import can begin.

File Name Requirements

Accompanying CSV data files should be named for their associated loading schema entity, with a ".csv" suffix.

The filenames of manifest files may reference the following naming conventions:

Version 2

In a second example, suppose that you are producing a dataset that conforms to the SIS Loading schema. The loading schema name to be used is sis. It is not necessary to provide a date if the date suffix from your .csv file names is removed because the manifest defines the datetime. Therefore, a valid filename for the UDP loading schema in this case is:\

<source>_daily.done

sis_daily.done

Version 1

In these formulas, the source value will be identical to the source value in the manifest file. For example, suppose that you are producing a dataset that conforms to the SIS Loading schema. The loading schema name to be used is sis. The date will be in ISO 8601 format and refer to the date only; e.g., 2022-01-01. Using the preceding example, a valid filename for the UDP loading schema is:

<source>_daily_<date>.done

sis_daily_2022-01-11.done

Manifest File Version 1 (No longer implemented)

Here is an example of version 1 (v1) of a manifest file used for SIS loading schema. This version is no longer recommended or implemented, and will eventually be removed.

Note in version 1 the files attribute is an array, where each institution must specify the full name of the associated CSV file along with MD5 checksum. In addition, each CSV file referenced is expected to include the current date in its name. These rules were simplified for version 2.

# The version of the manifest file used
# in this dataset.
manifest_version: "v1"

# The name of the system whose data is ingested,
# where values may include 'peoplesoft', 'banner',
# 'canvas-data', etc. depending on the application.
source: "my_sis"

# The UCDM version number this dataset's format
# corresponds to.
data_schema: "2.0"

## The ISO 8601 UTC datetime stamp describing how current this dump is.
## In most cases, simply providing when the dataset was produced works well.
datetime: "2021-12-10T19:11:23Z"

## A unique identifier for the dataset, such as a UUID
dump_id: "b4f8eec7-7adc-47a1-83a4-238f1032da00"

## An array of the files included in the dataset.
## For each file, an MD5 checksum is provided.
files:
- name: "academic_term_2019-02-04.csv"
  checksum: "9c9e18230ff048f2837889f41e1faba2"
- name: "course_offering_2019-02-04.csv"
  checksum: "64388cb12350d966fbdc37b9e6c02014"
- name: "course_section_2019-02-04.csv"
...
PreviousKeymap supportNextFile requirements

Last updated 1 year ago

You may name the manifest file however you like, so long as it's a (basically meaning "a typical file name"), and ends in ".done".

valid Google Cloud Storage object name