After configuring the Course Evaluations & Surveys (CES) to Faculty Success (FS) integration through the work request utility, you may encounter a few additional troubleshooting steps as you work through syncing your first projects. We have outlined all common sync issues and other considerations below for reference as you familiarize with the integration and its requirements.
When selecting project results to sync to Faculty Success, you may find the project does not appear in the drop-down list of options. There are a few reasons for this, which all need to be reviewed in Course Evaluations & Surveys. This is typically caused by one of the following:
- Project status is not ended
- Results not available to instructors
- Individual courses added after Project End Date
If after review of the listed project, none of the above seem incorrect, use the Submit a Request feature to contact support for further investigation.
Project status is not ended
Only courses which have the Status of "Ended" are available for syncing from CES to FS. Projects which are Not-Deployed or In-Progress will not appear in the list of CES reports to sync. Once the project end date has passed, the course will become available to the Course Evaluation Project drop-down menu in Faculty Success. If you update the status of a project in CES to Ended, please allow 15 minutes for the project to appear in Faculty Success.
Individual courses added after Project End Date
By viewing the Courses tab in CES for a project, sort by End Date to ensure no individual courses have an End Date after the Project End Date. If any courses have an End Date after the Project End Date, the Project will not be available to Faculty Success until all Course End Dates have passed. For more information on how to search courses in CES, see this article.
Results not available to Instructors
If the project still does not appear after the above dates have been reviewed, it may be due to a project setting in Course Evaluations & Surveys. In CES, open the project you are attempting to sync and review the Report Setup tab. Under "Reporting Access", the option "Allow Instructors to view reports for their courses" must be checked. This article describes the access dates that can be configured to allow results to be made available to instructors.
In some cases, you may receive the message "Attachment Failed" after attempting a course evaluation file sync to Faculty Success. This is uncommon, and may need to be reviewed by our support team for next steps. However, please confirm the following:
- Only one sync is occurring at a time
- Data is not being imported via CSV or Web Services (API) to Faculty Success Scheduled Teaching at the time of the sync
If the error persists after confirming the items below, contact our support team to open an investigation through the Submit a Request feature.
Processing one sync at a time
It is not uncommon for CES projects for a term to be broken up into many smaller projects. When syncing these results to Faculty Success, we highly recommend waiting for the previous sync to finish before queuing another project sync.
Mitigate import processes during the sync
Adding, updating, or deleting courses in Faculty Success during a sync can result in the "Attachment Failed" message. Please avoid processing other imports to Scheduled Teaching data while the sync is in progress.
A successful project sync will result in the "Attached" status appearing in the History table for your Course Evaluation Management tool. A successful project sync does not indicate that all course evaluations in the CES project found matching courses in Faculty Success. Review the detailed results of the sync by selecting "Download Results" from the Action menu for the synced project. The downloaded csv file will contain a breakdown of evaluation results from courses in CES that the system attempted to find matches for in Faculty Success. By reviewing the "status" column for all failures, and referencing the "message" column for the reason for the failure, there are two common issues you will find in the results file.
- No user found
- No matching records for "username"
For both errors, data can be corrected in either CES or FS as needed.
No user found
|Failure||No user found|
User matching from CES to FS relies on the email address stored separately in each system. If a matching user email is not found in FS, the course evaluation file is unable to be imported to a user account. This may be quickly updated in Users & Security for Faculty Success, or by reviewing the Instructors in the project for Course Evaluations & Surveys.
No matching records for "username"
|Failure||No matching records for username|
When this message appears, a matching Faculty Success account was located for the Instructor listed in FS, but when the system attempted to match the course code, no matching record was found. There are two ways to ensure that a record's course code was properly configured in order for the sync to match the report to it.
- CE&S Course Code
This configuration is most common for institutions that implemented CES and FS at the same time, relying on system automation rather than manually uploading CES course code values to FS, as discussed further below in CES Course Code. If all CES projects are set up using this exact format for their course codes, you can review the course codes from CES in FS by concatenating COURSEPRE-COURSENUM-SECTION field codes. It is easiest to review this in FS by using the Create a New Report feature to create an Export Raw Data report.
To find the course codes in CES, you can follow the steps outlined below:
- Navigate to the Courses tab of the desired project.
You can then view the courses from this tab to view the course codes from the "Code" column.
You can export the course codes from CES by clicking the "Export All Courses" hyperlink. To export selected courses, first select all courses on the same page (you can adjust records per page at the bottom of the page to accommodate large groups of courses prior to export) and then click the "Export Selected Courses" hyperlink to export the selected courses.
Information about the courses in your project will then be exported to an Excel file, where the course codes can be found in the "Code" column of the Excel file.
CES Course Code
It is more common that the course codes in CES follow a unique format, especially when they are imported from other source systems. In this case, it is crucial these course codes are added to Scheduled Teaching in Faculty Success within the EK_COURSE_CODE field in order for the sync to find matching records to attach the report to. This can be processed as part of a CSV Data Import to update existing records, or your data feed to FS can be modified to include the EK_COURSE_CODE as part of record creation.
Note: The EK_COURSE_CODE must be imported for all courses in a term for which you want to sync project results. This should occur before running a sync.
Re-Syncing a Project
After troubleshooting your first sync attempt, you may re-sync a project. With each sync, the system will replace all previously uploaded files with the latest version from CES and attempt to find new matches where previously a matching user or course was not found. There is no limit to the number of times you can attempt to re-sync a CES project.