Troubleshooting Common Errors

The following table lists common errors and their solutions.

Integration Manager uses the XML API and the log file includes error codes returned by the API. See Error Codes.

Use the following table and the API error code reference in addition to the Integration Manager log file to try and troubleshoot your integration before you contact OpenAir Customer Support.

Error type	Error	Solution
Popup	`Access to bckupdthash was denied`	You may not have full permissions. If you are using Windows 8 or higher, access to files and folders is restricted unless your Windows user account has administrator privileges. Users running Integration Manager must have read-write access to the Integration Manager installation folder (`C:\Program Files(x86)\OpenAir\IntegrationManager`) and be able to create, modify, and delete files in this folder. See Getting Started with Integration Manager.
Log	`ERR: Status: Access is not enabled. Contact your OpenAir account administrator to enable this functionality. ERR: Error while exporting`	The OpenAir user specified in the account settings may not have access to Integration Manager. You must grant access to Integration Manager at the individual user level. See Getting Started with Integration Manager.
Log	Error code 425: Functionality not available	You are attempting to import information that requires a feature that is not enabled for your account. For example, your account configuration may not allow you to import proxy information. In this case, importing proxy information would result in this error.
Log	Error code 601: Invalid ID. There isn't a record matching the id or code you asked for	You are attempting to import records from a CSV file into OpenAir and the OpenAir internal ID is used as primary import key. Integration Manager logs an error for each record if the value under the column mapped with the OpenAir internal ID is `[blank]` or does not match OpenAir internal ID values for that record type. See also Record Creation or Update Rules on Import.
Log	Error Code 821: The timesheet cannot be modified because it is no longer open or has been exported	By default, it is not possible to modify timesheets and time entries from timesheets that are submitted for approval, approved, or archived (`status` value is `S`, `A`, or `X`) in OpenAir. Your OpenAir account configuration can be changed to allow account administrators to modify timesheets in these cases. You should proceed with caution as such changing approved or archived time entries may have a downstream impact. See also Timesheet and Timesheet entry.

Error type

Error

Solution

Popup

Access to bckupdthash was denied

You may not have full permissions. If you are using Windows 8 or higher, access to files and folders is restricted unless your Windows user account has administrator privileges. Users running Integration Manager must have read-write access to the Integration Manager installation folder (C:\Program Files(x86)\OpenAir\IntegrationManager) and be able to create, modify, and delete files in this folder. See Getting Started with Integration Manager.

Log

ERR: Status: Access is not enabled. Contact your OpenAir account administrator to enable this functionality. ERR: Error while exporting

The OpenAir user specified in the account settings may not have access to Integration Manager. You must grant access to Integration Manager at the individual user level.

See Getting Started with Integration Manager.

Log

Error code 425: Functionality not available

You are attempting to import information that requires a feature that is not enabled for your account. For example, your account configuration may not allow you to import proxy information. In this case, importing proxy information would result in this error.

Log

Error code 601: Invalid ID. There isn't a record matching the id or code you asked for

You are attempting to import records from a CSV file into OpenAir and the OpenAir internal ID is used as primary import key. Integration Manager logs an error for each record if the value under the column mapped with the OpenAir internal ID is [blank] or does not match OpenAir internal ID values for that record type. See also Record Creation or Update Rules on Import.

Log

Error Code 821: The timesheet cannot be modified because it is no longer open or has been exported

By default, it is not possible to modify timesheets and time entries from timesheets that are submitted for approval, approved, or archived (status value is S, A, or X) in OpenAir. Your OpenAir account configuration can be changed to allow account administrators to modify timesheets in these cases. You should proceed with caution as such changing approved or archived time entries may have a downstream impact. See also Timesheet and Timesheet entry.