The employee did sync. This Error means one field on that employee, Work State, was too long to send to Spectrum, so the connector left that one field out and sent the rest of the employee record normally. Spectrum accepts a maximum of 10 characters for Work State. Before measuring the length, Arcoro pulls out just the code portion of the value, the part before a dash and description if the field is entered that way, so the 10 character limit applies to that shorter code, not to the full text you may see in Arcoro.
Error Messages
| Message text | Direction | Occurs when | Outcome | Fix |
|---|---|---|---|---|
| The Work State '[work state value]' exceeds the maximum length of 10 characters supported by Spectrum. The provider will still attempt to process any additional changes but this field will not be sent. | Write (Arcoro to Spectrum) | Employee entity. Arcoro extracts the code portion of the employee's Work State value (the part before a dash and description, if present), and that extracted code is longer than 10 characters. The value quoted in the message is that extracted code, not the full raw field text. This check runs every time the Employee entity is written and is not tied to any particular sync scope. | Field skipped only. The Work State field is left off this employee. Every other field, including the rest of the sync, still goes through. | Shorten the employee's Work State value, or the code portion of it, to 10 characters or fewer in Arcoro, then rerun the sync. |
Why This Error Did Not Stop the Sync
An Error in the sync log does not always mean the record was blocked. Spectrum length checks come in two forms that share the same 10-character limit but behave differently. One form only removes the single field that was too long and lets the rest of the employee write go through. The other form removes the entire employee record for that sync. Work State uses the first, non-blocking form. The similarly worded Union Class length message uses the second, blocking form. Seeing both in the same log does not mean both behave the same way.
| Message | Character limit | Blocks the employee record |
|---|---|---|
| Work State length message (this article) | 10 characters | No. Only the Work State field is left off; the employee still syncs. |
| Union Class length message | 10 characters | Yes. The whole employee record is skipped for that sync. |
Confirming the Error
- Open the Sync History screen and find the sync execution in question.
- Open the step for the Viewpoint Spectrum connector inside that execution.
- Find the row for the Employees entity.
- Look at the Errors column. A non-zero count means at least one Error, possibly this one, fired for that entity during this run.
- Open the Errors detail and match the fixed part of the sentence: "exceeds the maximum length of 10 characters supported by Spectrum." The Union Class message uses very similar wording, so confirm the sentence starts with "The Work State" and not "The Union Class" before treating it as this message.
- Check the Added or Updated column for the same Employees row. For this message, the employee will still show under Added or Updated even though the Errors count is non-zero. That combination is expected here because only the Work State field was left off; it is not a sign of a bigger problem.
Resolving the Error
- In Arcoro, open the employee record and find the Work State field.
- Shorten the value, or the code portion of it if it is entered as a code and description, to 10 characters or fewer.
- Rerun the sync.
- Confirm the Error for this employee is gone from the Employees entity row, and that Work State now has a value on the Spectrum side.
When to Escalate
If any of the following occur, you may need to reach out to Arcoro support for additional assistance.
- The Work State value is already 10 characters or fewer, but the Error still appears. This may mean the value on the record has not refreshed before the sync runs, and needs investigation beyond a simple data edit.
- Any Failures count on the Employees entity row for this connector. Failures are a separate, more serious category from the Errors covered here and are outside the scope of this article.