> ## Documentation Index
> Fetch the complete documentation index at: https://learn.nextedy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Save Operation Failures

> Diagnose and resolve errors that occur when saving changes in Nextedy RISKSHEET, including transaction failures, permission conflicts, session timeouts, and the `refreshOnSave` configuration interaction.

export const LastReviewed = ({date}) => {
  if (!date) return null;
  const formatted = new Date(`${date}T00:00:00Z`).toLocaleDateString("en-US", {
    year: "numeric",
    month: "long",
    day: "numeric",
    timeZone: "UTC"
  });
  return <p className="mt-10 text-sm text-gray-400 dark:text-zinc-500 not-prose">
      Last reviewed on {formatted}
    </p>;
};

## Common Save Error Messages

| Error Message                                                | Cause                                                        | Quick Fix                                             |
| ------------------------------------------------------------ | ------------------------------------------------------------ | ----------------------------------------------------- |
| "There are unsaved changes. Please save the document first." | A blocking operation was attempted before saving             | Save the document first, then retry the operation     |
| "Overwrite not supported with Refresh On Save = false"       | Configuration conflict between overwrite and `refreshOnSave` | Set `refreshOnSave` to `true` or disable overwrite    |
| "Overwrite is not compatible with Refresh on Save false"     | Server-side version of the same conflict                     | Same fix: enable `refreshOnSave` or disable overwrite |
| Unknown communication error                                  | Session timeout with concurrent licenses                     | Re-authenticate in a new tab, then retry save         |

## Resolve Transaction Failures

All Risksheet save operations are wrapped in database transactions. If any single item update fails, the entire save operation rolls back to prevent partial data updates.

1. Note the specific error message displayed in the toast notification
2. Check if the error relates to a specific work item (look for item IDs in the message)
3. Verify that you have write permissions on all modified work items
4. Retry the save. If it continues to fail, undo recent changes to isolate the problematic edit

<Frame>
  <img src="https://mintcdn.com/none-17b4493f/t34k0QhMnn4JCqkc/risksheet/diagrams/troubleshooting/save-failures/diagram-1.svg?fit=max&auto=format&n=t34k0QhMnn4JCqkc&q=85&s=6cd9053b7feb8c9ca1144b16a5239176" alt="diagram" style={{ maxWidth: "660px", width: "100%" }} width="660" height="210" data-path="risksheet/diagrams/troubleshooting/save-failures/diagram-1.svg" />
</Frame>

<Warning title="Custom Polarion Scripts Can Interfere">
  Custom Polarion workflow scripts that validate work item fields (such as duplicate title checks) can interfere with Risksheet save operations. If saves fail inconsistently across rows, check for custom validation scripts on the affected work item types.
</Warning>

## Fix "Overwrite Not Supported" Error

This error occurs when the sheet configuration has a conflict between overwrite mode and the `refreshOnSave` setting.

1. Open the Risksheet configuration via the configuration editor
2. Locate the `global` section and check the `refreshOnSave` property
3. Resolve the conflict by either:
   * Setting `refreshOnSave` to `true` (recommended), or
   * Disabling overwrite behavior

```yaml theme={null}
global:
  refreshOnSave: true
```

## Handle "Discard Changes" Popup After Save

When `refreshOnSave` is set to `false`, you may see a browser popup asking "Changes you made may not be saved" when navigating away after saving. This occurs because the UI is not refreshed after save, so the browser still detects a "dirty" state even though changes were saved successfully.

**Resolution:**

* **Upgrade to version 25.8.1 or later** where this issue is fixed
* Alternatively, set `refreshOnSave` to `true` to avoid the misleading popup

<Tip title="Your Changes Are Saved">
  If you see the "Discard changes" popup after pressing Save and you are on a version prior to 25.8.1, your changes were actually saved. The popup is cosmetic. Dismiss it safely.
</Tip>

## Handle Session Timeout During Save

With concurrent Polarion licenses, your session may expire during long editing sessions. Prior to version 24.8.6, this produced an "unknown communication error" with no clear indication of the cause. Since version 24.8.6, Risksheet shows a proper timeout message with a login link.

**Quick workaround:**

1. Open a new browser tab and navigate to your Polarion instance
2. Log in to re-authenticate your session
3. Return to the Risksheet tab and retry the save

<Tip title="Built-in Session Keep-Alive">
  Risksheet includes a keep-alive mechanism that sends periodic heartbeat requests to prevent session timeout. If you still experience timeouts, check your Polarion server's session timeout configuration.
</Tip>

## Resolve Formula-Generated Field Conflicts

Formula-generated fields (such as auto-generated titles) can cause save failures when Polarion permissions restrict editing those fields in certain workflow states.

**Scenario:** A formula generates a title from related fields (e.g., hazardous situation + harm). If the stored title differs from the formula output (for example, after a data migration that truncated titles), Risksheet attempts to save the recalculated value. If permissions block editing the title field in the current workflow state, the save fails.

**Resolution:**

1. Correct the stored values to match what the formula generates
2. Or adjust workflow permissions to allow the formula-populated fields to be updated

<Warning title="Items Without Titles">
  Items with empty or missing titles can cause linking errors. Use formula-based title auto-generation from related fields as a best practice for FMEA workflows.
</Warning>

## Verify Save Success

After resolving a save failure and retrying:

1. Save the document and confirm no error messages appear
2. Refresh the page to verify all changes persisted
3. Check modified work items in the Polarion work item view

You should now see all changes saved successfully with no error notifications, and the grid reflecting the committed state.

## See Also

* [Session Timeout Errors](/risksheet/troubleshooting/session-timeout) — session expiry and re-authentication
* [Access Denied Errors](/risksheet/troubleshooting/access-denied) — permission troubleshooting
* [Cell Editing Issues](/risksheet/troubleshooting/cell-editing-issues) — cells that do not accept changes
* [Permission-Based Field Restrictions](/risksheet/troubleshooting/permission-errors) — field-level permission behavior

<LastReviewed date="2026-06-24" />