Workday

Ad Astra integrates with Workday's APIs for ingesting and publishing the necessary data for Essential Scheduling, Student Centered Scheduling, and Integrated Planning. Below are the instructions for configuring Workday.

Workday Integration User

Create an integration user and change default settings in order to not require a password reset after 90 days. Assign the integration user access to the APIs via the "View Security for Securable Item" task in Workday.  

APIs Required for Base Data: Essential Scheduling

Additional APIs Required for Base Data: Essential Scheduling - Publish

Endpoints for Extended Data: Student Centered Scheduling and Integrated Planning

Student Registrations Report

Create a Student Registrations custom report (required) to allow access to historical student registrations. 

1. Navigate to the "Data Sources" report
2. Filter to "Student Course Registrations" data source
3. From the related actions menu select Custom Report -> Create
4. Name the report "Student Registrations"
5. Select "Advanced" for the report type
6. Check the "Enable As Web Service" box
7. Check the "Optimized for Performance" box
8. Add the following columns to the report

   Workday ID	Course	Course Sections
   Unit Type	Start Date	In-Progress Registration Units
   Units	Replaced Registration	Academic Level
   Student ID *	Repeated Registration	Academic Period
   Student	Overall Registration Status	Academic Unit
   Attempted Units	Earned Units	Transcript Grade
   Earned Grade Points

   * Student ID is a calculated field. Use the following configuration:
        1. Add calculated 
        2. Name: Student ID
        3. Calculation
             1. Lookup Field: Student Record
             2. Related Business Object: Academic Record
             3. Return Value: Student ID
   
   
9. Select the Filter tab
   1. In Filter on Instances
      1. Add Starting Academic Period Field
      2. Set Operator to "in the selection list"
      3. Set Comparison Type to "Prompt the user for the value"
      4. Set Comparison Value to "Default Prompt"
10. Select the Prompts tab
    1. Add Starting Academic Period Field
    2. Set Prompt Qualifier to Default Prompt
    3. Set Label For Prompt XML Alias to "academicPeriod"
    4. Set Default Type to "No default value"
    5. Uncheck Required, Do Not Prompt at Runtime, and Do Not Include in Subtitle boxes
11. Select the Share tab
    1. Select "Share with specific authorized groups and users"
    2. Add the "Student Integration System" group to "Authorized Groups"
12. Select OK
13. Select Test to test the report

Academic Period Types Report

Create an Academic Period Types custom report (required) to allow access to partial terms and term types.

1. Navigate to the "Data Sources" report and select "Academic Periods"
2. From the related actions menu select Custom Report -> Create
3. Name the report "Academic Period Types
4. Select "Advanced" for the report type
5. Check the "Enable As Web Service" box
6. Add the following columns to the report all from the Academic Periods business object
   • Academic Period
   • Academic Year (the non-prompt option)
   • Period Type
   • Standard Academic Period (boolean)
7. Select the Share tab
   • Select "Share with specific authorized groups and users"
   • Add the "Student Integration System" group to "Authorized Groups"
8. Select OK
9. Select Test to test the report
   
   

Provide Information 

Provide Ad Astra the following:
Integration Username and Password
SIS Institution ID *
Base SOAP URL
Workday WSDL file location for Student Registration report
Workday WSDL file location for Academic Period Type report

* Note: The SIS Institution ID can be derived from the Workday Instance URL (E.g. "CUSTOMER_SIS_ID" from https://impl.workday.com/CUSTOMER_SIS_ID/d/home.htmld)

Initial Import

After successful configuration, the terms will be populated per the pending scheduled import.

Article Version History