Customers who take advantage of Pearson Virtual Schools PowerSchool integration may have a need to troubleshoot error messages on occasion. The errors are often easy to resolve, and this document is intended to support a district in resolving errors efficiently.
There are a few types of integrations that Pearson offers.
- Roster integration – this integration brings student data into the Pearson Virtual Schools LMS platform automatically, so they do not need to register and log in
- Grade integration – this integration provides an option for synching the student roster as well as any grades that are in the Pearson Virtual
School’s platform with the district Student Information System.
ErrorTroubleshootingGuide
Error Message |
Scenario |
How to Correct |
Duplicate Section |
Two courses mapped to single SIS section.
Each course must be mapped to a unique SIS section. |
Review the course mapping and ensure that each course is mapped to a unique SIS section. Within the Pearson Connexus, go to the Admin App > Courses menu and find the section ID that is used in two courses. Check the SIS to see if these were mapped in error. |
|
|
If both courses are needed but only one section was created in the SIS, create a new section and enter it into one of the duplicated courses. It is recommended to check this section and gradeboook to ensure that one of the Pearson Connexus courses did not get created already. If it did, create a new section for the one that did not sync. |
Duplicate staff with username: {username} in Power school Id - {SIS _ID} & ConnexusEMS Id - {CxEMS_DomainID} |
Adding a teacher in Pearson Connexus.
During the sync, an SIS staff account with the same username as one that already existed within Pearson Connexus was found. |
Usernames do not have to be unique in the SIS, but they must be unique within a school in Pearson Connexus.
To correct edit the staff username in SIS to be unique. |
Duplicate student with username: {CxEMS username} in CxEMS domain - {CxEMS_DomainID} |
Adding a student in Pearson Connexus.
During the sync, a SIS student account with the same username as one that already existed within Pearson Connexus was found. |
Usernames do not have to be unique in SIS, but they must be unique within a school in Pearson Connexus.
To correct, edit the student username in SIS to be unique. |
Failed during enrollment update/create: User:{enrollment.userId}; Entity:{enrollment.entityId}; SIS enrollment ID:{enrollment.SIS EnrollmentId} |
Creating or updating enrollment in Pearson Connexus.
The enrollment could not be created or updated in Pearson Connexus because the user ID, course ID, enrollment ID, or the |
To correct, ensure that the user ID, course ID, enrollment ID, and course-SIS section mapping is present. |
|
Pearson Connexus course-SIS section mapping is missing. |
|
Failed to create an enrollment in CxEMS for SIS section id - {sectionId} because student external id {SIS_DCID} is not found in CxEMS |
Creating or updating enrollment in Pearson Connexus.
Failed to create an enrollment in Pearson Connexus because the SIS DCID was not found within the student profile in Pearson Connexus. |
To correct:
Ensure that the required fields in their user profile in Pearson Connexus exactly match the SIS. Correct any unmatched fields in the first name, last name and username within Pearson Connexus. Sync overnight should update with SIS DCID. If it does not, export the student DDE and add their DCID manually. |
Failed to create an enrollment in CxEMS for student ID {CxEMS_UserID} because section id {SIS sectionId} mapping to course not found in GP |
Creating or updating enrollment in Pearson Connexus.
Failed to create an enrollment in Pearson Connexus because the Pearson Connexus course is not mapped to the SIS section. |
To correct, map the Pearson Connexus course to the SIS section to resolve. |
Failed to create an enrollment in CxEMS SIS section id = {sectionId} because staff external id {SIS_DCID} is not found in CxEMS |
Creating or updating enrollment in Pearson Connexus.
Failed to create an enrollment in Pearson Connexus because the SIS DCID was not found within the staff profile in Pearson Connexus. |
To correct:
Ensure that the required fields in their user profile in Pearson Connexus exactly match to SIS. Correct any unmatched fields in the first name, last name and username within Pearson Connexus.
NOTE: Staff do not need to have a Pearson Connexus external ID, the external ID is only needed for students to sync scores. |
Failed to create an enrollment in CxEMS for staff ID {CxEMS_UserID} because section id {SIS |
Creating or updating enrollment in Pearson Connexus. |
To correct, map the Pearson Connexus course to the SIS section to resolve. |
sectionId} mapping to course not found in CxEMS |
Failed to create an enrollment in Pearson Connexus because the Pearson Connexus course is not mapped to the SIS section. |
|
Failed to create staff with username: {user.username} in CxEMS domain {CxEMS_DomainId} |
Creating staff user in CxEMS.
Duplicate username for staff found in the mapped SIS school. The sync will create the first user found and then throw this error if it finds another user with the same username. |
To correct: Find the multiple user profiles in the SIS and make each username unique to resolve. Additionally, check that the first name or last name is not null in the SIS. |
Failed to create student with username: {it.username} in CxEMS domain {CxEMS_SchoolId} |
Creating student user in CxEMS.
Caused by duplicate usernames within SIS school or Pearson Connexus profile not matching up to SIS. The sync will create the first user found and then throw this error if it finds another user with the same username. |
Check these variables in order: Use the SIS API to search for all instances of the username within the mapped SIS school. Find the multiple user profiles in the SIS and make each username unique to resolve. Within Pearson Connexus, enter the Users menu, find the user and check that the first name (equal to SIS's first name + middle name), last name and username match the profile within the SIS. |
Failed to update an assignment: {CxEMS assignment.itemID} since assignment does not exist in the SIS section {sectionID} |
Adding assignment to SIS.
The assignments that were previously created by the integration code within SIS have been deleted. You can confirm this |
To correct: A new section must be created. Once complete and mapped, notify your District Success Partner so all past scores from the last 30 days can be resynced. Data older than 30 days cannot be synced and will have to be added manually. |
|
by entering PowerTeacher and looking at the Assignments. |
|
Failed to update staff with username: {user.username} in CxEMS domain {CxEMS_DomainId} |
Updating staff user in CxEMS.
This can be caused by: Duplicate usernames within the SIS Users with no domain role in Pearson Online Classroom Often caused by handling users manually Staff assigned same external ID in error |
Check these variables in this order.
SIS usernames may have been repurposed. To resolve, edit the staff username to have a unique username in SIS, so that all users synced in Pearson Connexus have unique usernames. Check for domain rights for the staff within Pearson Connexus. Open User menu > open user account via User ID link > select Domain Permissions tab and ensure user was granted rights to the domain. Within Pearson Connexus user menu, search by the username to find the external ID applied. Search again by this external ID to see if it is set to multiple users in Pearson Connexus domain. |
Failed to update student with username: {it.username} in CxEMS domain {CxEMS_SchoolId} |
Updating student user in CxEMS.
SIS usernames may have been repurposed. |
To correct, log in to Pearson Connexus and delete all user accounts that are mapped to the same external ID. |
Failed while adding assignment [{CxEMS assignment.name}] ({CxEMS assignment.itemID}) for SIS section id [{sectionId}] |
Adding assignment to SIS.
The SIS API creating the assignment didn't have all the mandatory fields populated, the Pearson Connexus course had no content items, or the SIS section did not have all four categories created. |
To correct: ensure all mandatory fields are populated check that the course has content items Check that the SIS section has all 4 categories created |
Failed while creating assignments in SIS for CxEMS course [{course.id} - {course.title} ]. |
Getting item IDs in Pearson Connexus or updating Pearson Connexus items with SIS assignment ID. |
To correct: Create a new Pearson Connexus course that is NOT a derivative child of the original mapped Pearson Connexus course. Create a new SIS section. Map the new SIS section to the new Pearson Connexus course. |
Failed while creating/updating assignments because SIS section {SIS_ID} is deleted in SIS but mapping to CxEMS course {CxEMS_CourseID} still exists. |
Creating/updating assignments in SIS.
The SIS section was deleted. |
Ensure the mapping between the SIS section and the Pearson Connexus course is removed, since the SIS section was deleted. |
Failed while getting CxEMS item grades for Enrollment: {enrollment.id} Student: {enrollment.userid} |
Getting Pearson Connexus scores |
Enrollment ID or item ID does not exist, check enrollment ID or item ID. |
Failed while getting CxEMS item grades for Enrollment: {enrollment.id} Student: {enrollment.userid} |
Getting CxEMS scores per item |
Enrollment ID or item ID does not exist, check enrollment ID or item ID. |
Failed while getting grade for Enrollment:{enrollmentId}; Item:{itemId} |
Getting grade from Pearson Connexus for an enrollment
Occurs if an enrollment or an item in the enrollment is deleted. |
To correct: Run ListRestorableEnrollments or ListRestorableItems in Pearson Connexus. If deleted, it should be restored through DLAP by running RestoreEnrollment or RestoreItems. |
Failed while getting lesson items for CxEMS Course: {courseId} |
Getting items from CxEMS course |
Pearson Connexus course was deleted. |
Failed while getting list of enrollments for CxEMS Domain: {CxEMS_DomainId} |
Getting enrollments from CxEMS |
Pearson Connexus school was deleted. |
Failed while updating assignment [{assignment.name}]({assignment.abbreviation}) for SIS assignment id [{assignmentId}] |
Updating assignment in SIS
One of the four SIS categories is deleted. |
Validate that the mandatory fields are present in the API - null, weight is greater than 100%. |
Failed while updating assignment for CxEMS Item Id: {itemId} SIS Assignment Id: {item.data.ps_assignmentid.value} SIS Student Id: {studentId} |
Updating SIS score.
The SIS assignment or section was deleted, or the Pearson Connexus course is mapped to the wrong section. |
To correct: Delete the Pearson Connexus course and delete the SIS section. Create new Pearson Connexus course and recreate the SIS section. Remap them. |
Failed while updating assignment score for CxEMS Item Id: {CxEMS_ID} SIS Assignment Id: {SIS_ID} SIS Student Id: {SIS_ID} |
Updating SIS score.
Pearson Connexus teacher has assigned a score that is greater than 100% and that is something that SIS rejects. |
If you do not see any scores over 100% and this error is for the same SIS student ID, see if the student has been deleted from the mapped SIS section. |
Failed while updating score for enrollment {CxEMS_EnrollmentID} for student {CxEMS_UserID} because section {SIS_SectionID} is deleted but mapping to CxEMS course {CxEMS_CourseID} still exists. |
Updating SIS score. |
The mapping between the SIS section and the Pearson Connexus course needs to be removed, since the SIS section was deleted. |
Failed while updating scores for CxEMS Domain: {CxEMS_DomainId}; SIS School: {psSchoolId} |
Delta Score update job.
The last signal from the resource ID was not obtained. |
To correct: Wait that night for the next sync. Contact your District Success Partner to kick off the integration process if the sync doesn’t happen after waiting.
Note: This also fails if the student does not have an AssignmentStudentAssociation in the given AssignmentSection.Id [possible if student is enrolled in wrong section] |