Troubleshooting Integrations

This topic addresses issues that may occur in integrations between Anthology Student and Human Resources (HR) and Payroll systems.

Import of HR Data Failed

Symptoms

After the HR data from the Human Resources (HR) Systems is imported to Anthology Student, in case of any failure, it displays a message in the Request-Response column on the Inbound HR and Payroll Integration Log page explaining the reason for the failure.

In Anthology Student, select Processes > Faculty Workload > Inbound HR and Payroll Integration Log.
Select the link in the Request-Response column to view the details of the request and response JSON.

Possible Causes

This issue may occur due to the following reasons:

Integration between Anthology Student and Human Resources (HR) has not been configured correctly.
One or more of the required fields are missing data. Anthology Student validates a list of fields. If any of the required values are missing the data, the import of HR data fails.

Action to Resolve

To resolve this issue:

Refer to Configure the Systems for Integrationto verify if you have configured and enabled the integration correctly.
Review the list of following validations to understand the reason for the failure and provide the missing or incorrect information in the appropriate location to import the data automatically to Anthology Student.

Entities in Anthology Student	Scenarios	Message in Anthology Student	What it Means
Job Function	Delete	IntegrationReferenceIdentifier is required.	The IntegrationReferenceIdentifier field does not have a value. This is a mandatory field.
		The field IntegrationReferenceIdentifier must be a string or array type with a maximum length of 50.	The IntegrationReferenceIdentifier field exceeded the maximum length of 50.
		Job Function does not exist.	The IntegrationReferenceIdentifier does not exist in Job Function.
		The Job Function cannot be deleted because it is associated with a Job.	The IntegrationReferenceIdentifier is used in other entity.
	Create or update	Code is required.	The Code field does not have a value. This is a mandatory field.
		The field Code must be a string or array type with a maximum length of 50.	The Code field exceeded the maximum length of 50.
		Name is required.	The Name field does not have a value. This is a mandatory field.
		The field Name must be a string or array type with a maximum length of 256.	The Name field exceeded the maximum length of 256.
		IntegrationReferenceIdentifier is required.	The IntegrationReferenceIdentifier field does not have a value. This is a mandatory field.
		The field IntegrationReferenceIdentifier must be a string or array type with a maximum length of 50.	The IntegrationReferenceIdentifier field exceeded the maximum length of 50.
		Code already exists.	In the create scenario, Code already exists. The value must be unique.
		Job Function does not exist.	In the update scenario, if IntegrationReferenceIdentifier does not exist in Job Function.
Job Type	Delete	IntegrationReferenceIdentifier is required.	The IntegrationReferenceIdentifier field does not have a value. This is a mandatory field.
		The field IntegrationReferenceIdentifier must be a string or array type with a maximum length of 50.	The IntegrationReferenceIdentifier field exceeded the maximum length of 50.
		Job Type does not exist.	The IntegrationReferenceIdentifier does not exist in Job Type.
		The Job Type cannot be deleted because it is associated with a Job.	The IntegrationReferenceIdentifier is used in other entity.
	Create or update	Code is required.	The Code field does not have a value. This is a mandatory field.
		The field Code must be a string or array type with a maximum length of 50.	The Code field exceeded the maximum length of 50.
		Name is required.	The Name field does not have a value. This is a mandatory field.
		The field Name must be a string or array type with a maximum length of 256.	The Name field exceeded the maximum length of 256.
		Code already exists.	In the create scenario, Code already exists. The value must be unique.
		IntegrationReferenceIdentifier is required.	The IntegrationReferenceIdentifier field does not have a value. This is a mandatory field.
		The field IntegrationReferenceIdentifier must be a string or array type with a maximum length of 50.	The IntegrationReferenceIdentifier field exceeded the maximum length of 50.
		Job Type does not exist.	In the update scenario, if IntegrationReferenceIdentifier does not exist in Job Type.
Position Title	Delete	IntegrationReferenceIdentifier is required.	The IntegrationReferenceIdentifier field does not have a value. This is a mandatory field.
		The field IntegrationReferenceIdentifier must be a string or array type with a maximum length of 50.	The IntegrationReferenceIdentifier field exceeded the maximum length of 50.
		Position Title does not exist.	The IntegrationReferenceIdentifier does not exist in Position Title.
		The Position Title cannot be deleted because it is associated with a Position.	The IntegrationReferenceIdentifier is used in other entity.
	Create or update	Code is required.	The Code field does not have a value. This is a mandatory field.
		The field Code must be a string or array type with a maximum length of 50.	The Code field exceeded the maximum length of 50.
		Name is required.	The Name field does not have a value. This is a mandatory field.
		The field Name must be a string or array type with a maximum length of 256.	The Name field exceeded the maximum length of 256.
		Code already exists.	In the create scenario, Code already exists. The value must be unique.
		IntegrationReferenceIdentifier is required.	The IntegrationReferenceIdentifier field does not have a value. This is a mandatory field.
		The field IntegrationReferenceIdentifier must be a string or array type with a maximum length of 50.	The IntegrationReferenceIdentifier field exceeded the maximum length of 50.
		Position Title does not exist.	In the update scenario, if IntegrationReferenceIdentifier does not exist in Position Title.
Position Type	Delete	IntegrationReferenceIdentifier is required.	The IntegrationReferenceIdentifier field does not have a value. This is a mandatory field.
		The field IntegrationReferenceIdentifier must be a string or array type with a maximum length of 50.	The IntegrationReferenceIdentifier field exceeded the maximum length of 50.
		Position type does not exist.	The IntegrationReferenceIdentifier does not exist in Position Type.
		The Position Type cannot be deleted because it is associated with a Position.	The IntegrationReferenceIdentifier is used in other entity.
	Create or update	Code is required.	The Code field does not have a value. This is a mandatory field.
		The field Code must be a string or array type with a maximum length of 50.	The Code field exceeded the maximum length of 50.
		Name is required.	The Name field does not have a value. This is a mandatory field.
		The field Name must be a string or array type with a maximum length of 256.	The Name field exceeded the maximum length of 256.
		Code already exists.	In the create scenario, Code already exists. The value must be unique.
		IntegrationReferenceIdentifier is required.	The IntegrationReferenceIdentifier field does not have a value. This is a mandatory field.
		The field IntegrationReferenceIdentifier must be a string or array type with a maximum length of 50.	The IntegrationReferenceIdentifier field exceeded the maximum length of 50.
		Position Title does not exist.	In the update scenario, if IntegrationReferenceIdentifier does not exist in Position Type.
		Classification Code is invalid.	The classification code passed is invalid. Pass a valid code.
Job	Delete	IntegrationReferenceIdentifier is required.	The IntegrationReferenceIdentifier field does not have a value. This is a mandatory field.
		The field IntegrationReferenceIdentifier must be a string or array type with a maximum length of 50.	The IntegrationReferenceIdentifier field exceeded the maximum length of 50.
		Job does not exist.	The IntegrationReferenceIdentifier does not exist in Job.
		The Job cannot be deleted because it is associated with a Position.	The IntegrationReferenceIdentifier is used in other entity.
		The Job cannot be deleted because it is associated with Policies.	The IntegrationReferenceIdentifier is used in other entity.
	Create or update	Code is required.	The Code field does not have a value. This is a mandatory field.
		The field Code must be a string or array type with a maximum length of 50.	The Code field exceeded the maximum length of 50.
		Name is required.	The Name field does not have a value. This is a mandatory field.
		The field Name must be a string or array type with a maximum length of 256.	The Name field exceeded the maximum length of 256.
		Code already exists.	In the create scenario, Code already exists. The value must be unique.
		Job does not exist.	In the update scenario, Code already exists. The value must be unique.
		IntegrationReferenceIdentifier is required.	The IntegrationReferenceIdentifier field does not have a value. This is a mandatory field.
		The field IntegrationReferenceIdentifier must be a string or array type with a maximum length of 50.	The IntegrationReferenceIdentifier field exceeded the maximum length of 50.
		Job does not exist.	In the update scenario, the IntegrationReferenceIdentifier does not exist or is not integrated.
		Job Type with IntegrationReferenceIdentifier does not exist.	The Job Type IntegrationReferenceIdentifier passed is invalid. Pass a valid value.
		Job Function with IntegrationReferenceIdentifier does not exist.	The Job Function IntegrationReferenceIdentifier passed is invalid. Pass a valid value.
		Effective From Date is invalid.	The effective from date passed is invalid. Pass a valid value. The year of the date must be greater than 1753.
		Effective To Date is invalid.	The effective to date passed is invalid. Pass a valid value.
		Effective From must be less than or equal to Effective To.	The effective from date field must be less than or equal to effective to date.
Position	Delete	IntegrationReferenceIdentifier is required.	The IntegrationReferenceIdentifier field does not have a value. This is a mandatory field.
		The field IntegrationReferenceIdentifier must be a string or array type with a maximum length of 50.	The IntegrationReferenceIdentifier field exceeded the maximum length of 50.
		Position does not exist.	The IntegrationReferenceIdentifier does not exist in Position.
		The Position cannot be deleted because it is associated with another Position.	The IntegrationReferenceIdentifier is used in other entity.
		The Position cannot be deleted because it is associated with Staff Position Assignment.	The IntegrationReferenceIdentifier is used in other entity.
	Create or update	Code is required.	The Code field does not have a value. This is a mandatory field.
		The field Code must be a string or array type with a maximum length of 50.	The Code field exceeded the maximum length of 50.
		Name is required.	The Name field does not have a value. This is a mandatory field.
		The field Name must be a string or array type with a maximum length of 256.	The Name field exceeded the maximum length of 256.
		IntegrationReferenceIdentifier is required.	The IntegrationReferenceIdentifier field does not have a value. This is a mandatory field.
		The field IntegrationReferenceIdentifier must be a string or array type with a maximum length of 50.	The IntegrationReferenceIdentifier field exceeded the maximum length of 50.
		Position does not exist.	In the update scenario, the IntegrationReferenceIdentifier does not exist or is not integrated.
		FTE is required.	The FTE field does not have a value. This is a mandatory field.
		FTE accepts (0 or greater).	The FTE value passed is a negative value. It must be greater than 0.
		FTE must be greater than 0.	The FTE value passed is a zero value. It must be greater than 0.
		FTE exceeds 9999999999999.99.	The FTE value passed exceeded the maximum length of 9999999999999.99.
		Valid From Date is invalid.	The valid from date passed is invalid. Pass a valid value. The year of the date must be greater than 1753.
		Valid To Date is invalid.	The valid to date passed is invalid. Pass a valid value.
		Valid From Date must be less than or equal to Valid To Date.	The valid from date field must be less than or equal to valid to date.
		Job IntegrationReferenceIdentifier is required.	The Job IntegrationReferenceIdentifier field does not have a value. This is a mandatory field.
		Job with IntegrationReferenceIdentifier does not exist.	The Job is not integrated or Job record is not found in the system.
		Position valid from and to date should be within the Job duration.	The Position duration is not within the range of the selected Job duration.
		Position Title with IntegrationReferenceIdentifier does not exist.	The Position Title value passed is invalid. Pass a valid value.
		The field Position Type IntegrationReferenceIdentifier must be a string or array type with a maximum length of 50.	The Position Type IntegrationReferenceIdentifier field exceeded the maximum length of 50.
		Position Type with IntegrationReferenceIdentifier does not exist.	The Position Type value passed is invalid. Pass a valid value.
		Parent Position with IntegrationReferenceIdentifier does not exist.	The Parent Position value passed is invalid. Pass a valid value.
		Position cannot be associated with the same Parent Position.	In the update scenario, the same Position IntegrationReferenceIdentifier value is passed as the position.
		Pay Cycle IntegrationReferenceIdentifier is required.	The IntegrationReferenceIdentifier field does not have a value. This is a mandatory field.
		Pay Cycle with IntegrationReferenceIdentifier does not exist.	The Pay Cycle is not integrated or the record is not found in the system.
		Position does not exist.	In the update scenario, the Position value passed is invalid. Pass a valid value.
Staff Position Assignment	Delete	IntegrationReferenceIdentifier is required.	The IntegrationReferenceIdentifier does not have a value. This is a mandatory field.
		The field IntegrationReferenceIdentifier must be a string or array type with a maximum length of 50.	The IntegrationReferenceIdentifier exceeded the maximum length of 50.
		Staff Position Assignment does not exist. .	The Staff Position Assignment IntegrationReferenceIdentifier does not exist in FWM.
		You cannot delete the selected Staff Position Assignment because it is set as primary. Select another Position as primary and try again.	The selected Staff Position Assignment cannot be deleted because it is primary. Select another Position as primary and try again.
		The Staff Position Assignment cannot be deleted because it is associated with Staff Policy Association.	The selected Staff Position Assignment cannot be deleted because it is associated with Staff Policy Association. Or The Staff is configured as part of all Positions in Staff Policy Association.
		The Staff Position Assignment cannot be deleted because it is associated with Staff Payroll.	The Staff Position Assignment cannot be deleted because it is associated with Staff Payroll.
	Create or update	Personnel Number is required.	The Personnel Number does not have a value. This is a mandatory field.
		Primary Contact Email is required.	The Primary Contact Email does not have a value. This is a mandatory field.
		IntegrationReferenceIdentifier is required.	The IntegrationReferenceIdentifier does not have a value. This is a mandatory field.
		The field IntegrationReferenceIdentifier must be a string or array type with a maximum length of 50.	The IntegrationReferenceIdentifier exceeded the maximum length of 50.
		Valid From Date is invalid.	The valid from date format is invalid.
		Valid To Date is invalid.	The valid to date format is invalid.
		Valid From must be less than or equal to Valid To.	The valid from date must be less than or equal to Valid to date.
		Staff Position Assignment valid from and to date should be within the Position duration.	The Staff Position Assignment valid from and to date must be within the range of Position duration.
		Staff Position Assignment does not exist.	In the update scenario, the IntegrationReferenceIdentifier does not exist.
		Staff with Employee Number does not exist.	The Staff with Personnel Number does not exist.
		You cannot change the Staff Position Assignment from primary because at least one primary is required. Specify another Position as primary instead.	When you are trying to update the only primary record to non primary.
		Position IntegrationReferenceIdentifier is required.	The Position IntegrationReferenceIdentifier does not have a value. This is a mandatory field.
		The field Position IntegrationReferenceIdentifier must be a string or array type with a maximum length of 50.	The Position IntegrationReferenceIdentifier exceeded the maximum length of 50.
		Position with IntegrationReferenceIdentifier does not exist.	The Position with IntegrationReferenceIdentifier does not exist in FWM.
		Staff Position Assignment already exists.	The Staff Position Assignment already exists for the Staff.
		Position Assignment cannot be saved because a Staff member is assigned to the Position for dates you specified. Active Assignment cannot have overlapping dates.	The Staff Position Assignment already exists for the dates specified with a different Staff.
		Pay Cycle with IntegrationReferenceIdentifier does not exist.	The Pay Cycle with IntegrationReferenceIdentifier not exists in FWM.
		At least one Staff Position Assignment must be active because the Staff Policy Association exists for the Staff.	The existing Staff Position Assignment for staff must have at least one active staff position assignment.
		Code already exists.	The Code for Staff exists already.
		Campus Group is required.	The Campus Group does not have a value. This is a mandatory field.
		Staff Group Membership is required.	The Staff Group Membership does not have a value. This is a mandatory field.
		Staff Group Membership is invalid.	The Staff Group Membership value is invalid.
		You cannot Add/ Edit the System Administrator.	The System Administrator cannot be added or edited.
		The staff member cannot be deactivated until these scheduled tasks are assigned to another staff member.	The staff member with scheduled task cannot be deactivated. Assign a staff member for the task.
		You cannot deactivate a staff member who manages staff groups.	The staff member who manages the staff group cannot be deactivated.
		Change the Organizational Hierarchy or Delegation configuration in SFAA to deactivate.	To deactivate SFAA, change the Organizational Hierarchy or Delegation configuration
		The staff member cannot be deactivated because they are the default Financial Aid Advisor for below campuses.	The default Financial Aid Advisor staff member for campuses cannot be deactivated.
		Assign new default advisors to deactivate the staff member.	To deactivate the staff member, assign new default advisors.
		{0} has already been selected as Automated User.	{0} is the automated user.
		There can only be one Automated User.	Only one automated user is authorized.
		Password must contain at least {1} character(s).	The password must have minimum characters.
		Password must contain at least {1} character(s).	The password must have minimum numeric.
		Password and Code cannot be same.	The password and code must be unique.

For additional information, contact Anthology Professional Services.

Import of Payroll Data Failed