Below are some common error messages and what they mean:
Position 'xxxx': The employee with employee ID xxxx you tried to assign to this position was not found.
This happens when you try to assign an employee to a position, but the employee does not exist in our system. This usually happens if you try and post a position file without first updating your employees. We suggest that if you are using hierarchy that you post an employee file followed by a position file.
Element 'root': This element is not expected. Expected is ( position )
The file should contain one <root></root> block at the top, followed by one or more <position></position> blocks.
TIP: This is usually because you have more than one "root" position (i.e. the position at the top of your hierarchy e.g. MD, CEO, etc). You should check which is the correct one and for the others, check that they have a manager (i.e. a parent position that they report to).
Element 'position_id': Duplicate key-sequence ['12345'] in unique identity-constraint 'position_id_unique'
This is telling you that there is a duplicate ‘position_id’ of ‘12345’ in the file.
Element 'employee_id': [facet 'pattern'] The value 'C1734345' is not accepted by the pattern '[a-z0-9]*'**
This is telling you that the ‘employee_id’ element doesn’t fit the pattern defined in the schema. In this case the pattern only allows lowercase a-z and 0-9. There is a capital ‘C’ which is not permitted, please ensure ‘employee_id’ elements are in lowercase.
Element 'employee_id': [facet 'minLength'] The value has a length of '0'; this underruns the allowed minimum length of '1'
This is telling you that the ‘employee_id’ element should contain at least 1 character. In this case it is usually because the position is vacant and you have included the element. Remove the element for vacant positions.
Element 'parent_position_id': This element is not expected. Expected is ( employee_id )
This is telling you that the element ‘parent_position_id’ is not expected. In this case its because you have included it in the <root> position element, this is the top of the hierarchy and as such can’t have a parent position.
xmlParseEntityRef: no name
This is because the value contains a ‘&’ character. For example, if you have a position title of “Head of Sales & Marketing” then you must replace the ‘&’ with ‘&’ (e.g. “Head of Sales & Marketing”). Alternatively, you can just replace it with the text equivalent (e.g. “Head of Sales and Marketing”)