CDL to EDP - Common Good API
Migration Change Log
How to migrate from current CDL APIs to the new EDP Common Good APIs
Embedded Files
CDL to EDP - Common Good API
How to use this page
How to use this page
To the right you will see a table of contents of our original Common Good API offerings. You can click on the API name to navigate to the changes you need to be aware of for the given API. If an API isn't present, it is because we have yet to begin migrating that API.
Below is an At-a-Glance table for each of our APIs for quick reference. If the table says "review endpoint changes" as a required developer action, you can review those endpoint level changes within the relevant API section farther down this page. Finer details on what has changed for a given endpoint may require navigation to our API Design documents which have also been linked to in each section.
Affiliation Information
Affiliation Information
Affiliation Information is being split into two separate APIs: one for Employee Affiliations and one for Student Affiliations to better account for the two distinct use cases for which this API tends to be used. Field and object names in JSON response profiles and request profiles have been adjusted for increased field clarity.
All changes mentioned in the At-A-Glance table and Change Log sections can be seen in more detail in the EDP API Design Document(s) linked at the bottom of this section. The API Design Documents contain the name and definitions for each API and endpoint, the lineage of each field element in the response profile, test cases demonstrating the JSON request and response profiles, and the SQL used to generate each endpoint.
At-A-Glance Endpoint Changes
Change Log
API
Split into two APIs: Employee Affiliations and Student Affiliations
API description reworded for clarity
JSON Request Body and Response Bod
/activeEmployeeByHRDeptid
Endpoint renamed to /activeEmployeesByHRDepartmentId
Endpoint description reworded for clarity
Request profile:
Object wrapper renamed from currentEmployeesAffiliation to departmentIds
deptId field renamed to departmentId
Response profile:
persId field renamed to personId
vPAdminUnit field renamed to vpAdminUnit
New field: collegeAdminUnit
/activeEmployees
Endpoint description reworded for clarity
Response profile:
persId field renamed to personId
/activeEmployeesByZdeptid
Endpoint renamed to /activeEmployeesByZDepartmentId
Endpoint description reworded for clarity
Request profile:
Object wrapper renamed from zDeptids to zDepartmentIds
zDeptid field renamed to zDepartmentId
Response profile:
persId field renamed to personId
vPAdminUnit field renamed to vpAdminUnit
/currentStudentByCampus
Moved to future Student Affiliations API. Student Affiliations is a work in progress.
Link to new EDP API Design Document(s)
Student Affiliations API Design - WIP
Employee Information
Employee Information
Employee Information has been merged with HR Information to create the Workforce and Employment API. Field and object names in JSON response profiles and request profiles have been adjusted for increased field clarity.
All changes mentioned in the At-A-Glance table and Change Log sections can be seen in more detail in the EDP API Design Document(s) linked at the bottom of this section. The API Design Documents contain the name and definitions for each API and endpoint, the lineage of each field element in the response profile, test cases demonstrating the JSON request and response profiles, and the SQL used to generate each endpoint.
At-A-Glance Endpoint Changes
Change Log
API
API description reworded for clarity
/employeeJobPositionInformation
Endpoint renamed to /jobs
Endpoint description reworded for clarity
Request profile:
Object wrapper renamed from employee to employees
jobType field renamed to jobTypeCode
Response profile:
Object wrapper renamed from multipleEmployeeJobPositionInfo to employees
Position object renamed to jobs
primaryJobIndicator field renamed to isPrimaryJob
companyCode field renamed to taxEntityCode
compensationFrequencyCode field renamed to payFrequencyCode
effectiveDate field renamed to recordEffectiveDate
expectedEndDate field renamed to expectedAppointmentEndDate
payGroupCode field renamed to appointmentDurationCode
personOrganizationCode field renamed to universityRelationshipCode
standardHoursAmount field renamed to standardHours
absenceEnrollmentGroup field renamed to absenceEligibilityGroup
reportsToPosition field renamed to reportsToPositionNumber
New field: jobTypeCode
/employeeSupervisorInformation
Endpoint renamed to /supervisors
Endpoint description reworded for clarity
Request profile:
Object wrapper renamed from employeeSupervisor to employees
jobType field renamed to jobTypeCode
Response profile:
Object wrapper renamed from employee to employees
job object renamed to jobs
New object nested under jobs called supervisor created for supervisor fields
employeeEmpId field renamed to emplid
employeeInternetId field renamed to internetId
employeePrimaryJobIndicator field renamed to isPrimaryJob
employeeStatusCode field renamed to employeeStatusCode
supervisorDepartmentId field renamed to departmentId
supervisorDepartmentName field renamed to departmentName
supervisorEmailAddressIdentifier field renamed to email
supervisorEmplId field renamed to emplId
supervisorFirstName field renamed to firstName
supervisorFullName field renamed to fullName
supervisorInternetId field renamed to internetId
supervisorJobCode field renamed to jobCode
supervisorLastName field renamed to lastName
supervisorMiddleName field renamed to middleName
supervisorPositionNumber field renamed to positionNumber
supervisorPositionTitle field renamed to positionTitle
New field: jobTypeCode
Link to new EDP API Design Document(s)
HR Information
HR Information
HR Information and Employee Information have been merged to create a "Workforce and Employment" API. Some endpoints (namely hrLocaitonCode and hrCountryCode) have been removed due to a lack of subscribers or because the information provided by the endpoint will be provided by other endpoints in the future. Field and object names in JSON response profiles and request profiles have been adjusted for increased field clarity.
All changes mentioned in the At-A-Glance table and Change Log sections can be seen in more detail in the EDP API Design Document(s) linked at the bottom of this section. The API Design Documents contain the name and definitions for each API and endpoint, the lineage of each field element in the response profile, test cases demonstrating the JSON request and response profiles, and the SQL used to generate each endpoint.
At-A-Glance Endpoint Changes
Change Log
API
HR Information endpoints have been moved to the Workforce and Employment API
/hrCountryCode
Removed
/hrJobCode
Endpoint renamed to jobCodes
Endpoint description reworded for clarity
Request profile:
Object wrapper renamed from jobCode to jobCodes
jobCode field renamed to jobCodes
Response profile:
jobCodeGroupDescription field renamed to jobCodeGroupLongDescription
jobFamilyLevelDescription field renamed to jobFamilyLevelLongDescription
workforceCategoryDescription field renamed to workforceCategoryLongDescription
New field: jobFamilyLongDescription
/hrJobEmployeeClass
Endpoint renamed to employeeClasses
Endpoint description reworded for clarity
Request profile:
Object wrapper renamed from people to jobCodes
Response profile:
employeeClassificationCode field renamed to employeeClassCode
employeeClassificationLongDescription field renamed to employeeClassLongDescription
employeeClassificationShortDescription field renamed to employeeClassShortDescription
/hrJobFamilyCode
Endpoint renamed to jobFamilies
Endpoint description reworded for clarity
Request profile:
Object wrapper renamed from jobFamilyCode to jobFamilyCodes
/hrLocationCode
Removed
/hrPersonInformation
Removed
/hrPositionInformation
Endpoint renamed to positions
Endpoint description reworded for clarity
Request profile:
Object wrapper renamed from people to positionNumbers
Response profile:
departmentIdentifier field renamed to departmentId
jobFamilyDescription field renamed to jobFamilyLongDescription
jobGroupCode field renamed to jobCodeGroupCode
jobGroupCodeDescription field renamed to jobCodeGroupLongDescription
positionShortTitle field renamed to positionTitleAbbreviated
positionTitleDescription field renamed to positionTitle
regOrTemp field renamed to regularOrTemporary
reportsToPosition field renamed to reportsToPositionNumber
standardHoursAmount field renamed to standardHours
New field: departmentName
New field: jobTitle
Link to new EDP API Design Document(s)
Page updated
Report abuse