Page Comparison

• Review Analysis of Person API Analysis - For those that agreed to provide comparative analysis with various models, please be prepared to discuss your findings

• BYU and someone with eduPerson went over their “person” API’s and they were compared back to the LIS model in process.

Here are some random scribbled notes as I tried to understand:

Coversation led by BYU

Group Affiliation
BYU Puts Memberships/Affiliation directly in the Person Object
LIS Model has a separate Membership entity
--There should be a discussion on what direction to go.
LIS also has a "relationships" entity for family relationships such as dependents between people, parents etc...

BYU API -
Goal not to have 500 top level objects, but to have 50 or so

BYU API - Concept of the person API is “Here is everything we know about a person”

Person Object is a GIANT VIEW of the person, everything related to a person
It is an aggregate of multiple data sources, we aggregate it into a single API Entity

Personal Question/ Thought: BYU Person Objects pulls from multiple data sources, not just a single source. The Person API is an aggregate of that data. Processing real time data from SQL is not probably very ideal for something like this so I’m wondering if they use an intermediary system to capture source data changes in real time and publish changes to a data stream which becomes the source of the API.

Authorizations are done at the "Field Set" level, which makes the larger data set easier to digest as applications only get access to what they have access to

Question about Relationships
LSI -- Concept of an "agent" -- Allows them to be a "parent", "Advisor","
BYU -- Concept of "Delegates"

Question regarding Demographics:
LSI -- Much more simple demographics compared to BYU
BYU: Concept of Field Sets that can be optional

Comment: There are cases where data when used together becomes more sensitive than any of the individual pieces of data alone. The example they gave was Combining Class Schedule with Course Enrollment.

Security: Concept of securing "Field Sets" instead of at the field level

Fields may appear in multiple field sets/duplicated

Vocabulary

LIS Model uses basic vocabulary to describe things whereas BYU uses specific vocabulary.

• For example: BYU calls a Building a Building with fields such as Building Name
  LSI calls the similar objects "Address Part" which is somewhat ambiguous, but may be more extensible.

Concept of Publishers/Subscribers to areas. Subs can/do get notified when a subject area has changed since they last received data. What changed is less clear, can result in "change messages" that are really not applicable to all subs.

Comment: Universities will always need "one more field" Having a standardized extension mechanism for adding extensions needs to be available and built into the process. "is this extension local (for one school) or something that should be pushed to the main.

Free For All approach to adding things Creates 5 different ways to define the something = Bad.

review of eduPerson model.
(I’m not sure what eduPerson is) It was brief and less comprehensive.

BYU has a credentials table, so that as credentials change the can handle it. Things that aren't global like NetID, ByuID become more global type of credentials, this is handled.

• Vetting of the process: Is this format/process working for the group? Different approaches

Not Covered

• Discussion of Proof of Concept

  • Goals and intentions

  • Call for participants

They asked for volunteer schools that may want to be in a Proof Of Concept for this project along with Oregon State. I was NOT sure if we were interested in this. Steven Maglio / Diana Antova

• Review of timelines for work going forward

• Models

Common EDU API Matrix: https://docs.google.com/spreadsheets/d/1ky2yASn8YU2yXhL0MPfwpKOQBu805lxbR0tARWOhBis/edit?usp=sharing

Andrew Marmor

Andrew Marmor

• Microsoft has developed a higher-ed data model,

• Microsoft dynamics (business applications platform)

• Available on github: https://github.com/Microsoft/Dynamics-365-Industry-Accelerators/tree/master/edu

• https://appsource.microsoft.com/en-us/product/dynamics-365/mshied.highereducationcommondatamodel?mktcmpid=blog_CISlnEvalToolLaunchIMML&src=DataAmpMainBlog%2Cwebsite&tab=Overview

• Privacy

• Microsoft model has single FERPA field, discussion on how to handle individual privacy selections

• Higher Ed Accelerator requires Dynamic 365 license, seems to be a platform to build additional apps (PowerApp) and analytics (PowerBI) directly on top of . https://community.dynamics.com/365/b/dynamics365isvsuccess/archive/2018/10/30/a-first-look-at-the-dynamics-365-higher-education-accelerator

• Person object is called Contact in MS model

• Question: How to tie enrollment to contact

  • Academic Period Detail ties together

• Question: Are instructors and students both contacts

  • Yes - Contact has a Type = STUDENT, Instructor etc…

  • Account - Entity, again can have a Type of SCHOOL

• Review of timelines for work going forward

Next steps: Now that we have all of the data and examples of multiple different models for Person, what do we do now?

Consensus

• Create a plain list of everything we would want in a Person API with proposed fields that would be included as a step prior to adding anything to GitHub/Swagger.

• Review

• Standardize Fields, Naming Convention, etc..

• Potentially begin to publish a DRAFT person model to GitHub

• Create Swagger sandbox of Draft model to iterate individual needs against

• Once vetted, do we generate an OpenAPI definition?

Question: Jarred U.Wi - Should we fork/copy BYU’s swagger spec as a start before starting from scratch.