LYNX for Ethos Integration


LYNX Processing Cycle for EthosImage: LYNX Processing Cycle for Ethos

The LYNX Interface facilitates the bi-directional flow of academic-related data between the Ethos tenant and 25Live. Since LYNX integrates directly with the Ethos API, there is no installation required.

Generate an API Key

Use Ethos to make an API key to share with CollegeNET. This key will be specific to your LYNX installation and should not be used with other vendors.

You will need to make a separate key for each of your test and production instances.

Give Access to Specific Resources

Note: Ellucian Does Not Support Changes Made to SESC

Image: SESC view in Colleague.

Ellucian does not currently support changes made to section occurrences in SESC - Section Schedule Detail in the Colleague Ethos Data Model (EDM) or their Business Process APIs. If you would like this feature supported in the Ethos API, please request it from Ellucian.

The API key you generate must have access to GET and PUT methods to specific Ethos resources.

GET access to the following resources:

  • academic-levels
  • academic-periods
  • buildings
  • credit-categories
  • educational-institution-units
  • educational-institutions
  • email-types
  • instructional-delivery-methods
  • instructional-methods
  • instructional-platforms
  • person-name-types
  • persons
  • regions
  • room-characteristics
  • room-types
  • rooms
  • section-crosslists
  • section-registrations
  • section-statuses
  • sections
  • sections-maximum
  • sites
  • student-section-waitlists
  • subjects

PUT access for one resource:

  • instructional-events

Restrict Permissions for Sensitive Endpoints

LYNX needs access to the person's resource to integrate with instructor data, but private and sensitive information is not necessary for 25Live. Use the instructions on the following page to restrict access to information such as Social Security Numbers and Tax Identification Numbers on the API key. To protect private information, you need to restrict the Tax ID from both the "Get persons" request as well as the "GET sections-maximum" request, which returns instructors.

https://ellucian.force.com/clients/s/article/Colleague-How-to-restrict-SSN-access-using-Ethos-API

(Ellucian login required)

Tip: Search the Ellucian Documentation For the Latest Method

Ellucian may change its documentation from time to time, so your best bet is to search the company's help site to find out how to restrict access to sensitive information.

Provide the Following for Testing 

Your assigned Support analyst will need to verify connectivity. (Note: This step is required before proceeding.)

Please send your:

  • Production and Test API keys
  • Academic Period GUID

Configure LYNX

With your API key set up in Ethos, all that remains is for you to configure it in LYNX.

  1. Go to the Configurations > API Integration Settings area.
  2. In the provided fields, enter the API Base URL and API Key from Ellucian.

These fields are automatically saved as soon as you enter data, establishing the connection between Ethos and LYNX.

Configuring API Integration Settings for EthosImage: Configuring API Integration Settings for Ethos

Initialize Course and Reference Data

Once the connection between your SIS database and LYNX has been established by entering the API details into LYNX, you can begin initializing data.

Follow the steps on Initializing Data in LYNX to begin syncing data with your SIS:

  1. Initialize reference data (background information like location names, subject codes, instructors, etc).
  2. Initialize course section data (information for a specific term code).
  3. You may enter up to three-term codes in the "Auto Initialization" field to automatically initialize their course section data.

Use of Data in Ethos

Cross-Listed Sections

If your institution has any cross-list groups with only a single section in Colleague, the API may show an error. Because Ellucian's API does not support filtering cross-list groups by term code, LYNX must retrieve this data for all terms’ sections every time course section data is initialized (either manually or via auto-initialization).

Ethos requires that all cross-list groups contain two or more sections, and LYNX will encounter an error for any cross-list group that does not, even if that cross-list group is part of a term in the past.

Ellucian customers who have experienced this error have done the following:

  • Go into the COURSE.SEC.XLISTS file and find the record number (or ID) that corresponds to the cross-list ID provided in the error
  • Make any needed modifications directly to the record there. If the data causing the error is in a development environment, delete the cross-list group after confirming it isn’t needed. If working in a production environment or in an environment where deleting this data is not preferred, you may need to add an additional section to the crosslist group.
  • The error will only return the crosslist ID of the first group encountered. Once this is resolved, some customers may need to work through these steps again for each subsequent crosslist ID until all erroneous data is corrected.