Skip to main content

Symptoms

After updating the Risksheet plugin, you may encounter:
  • The Risksheet menu item is missing from the Polarion navigation bar
  • The Setup and License pages in Polarion administration appear empty
  • Risksheet features are completely unavailable despite the plugin files being present

Step 1: Verify Plugin Folder Structure

A common update mistake is copying the new plugin version over the old one instead of deleting the old version first. Only one version folder per product is allowed in the Extensions directory.
  1. Navigate to [POLARION_INSTALL]/polarion/extensions/
  2. Look for Risksheet-related folders
  3. Verify that only one Risksheet folder exists
diagram
You must completely delete the previous plugin version folder from the Extensions directory before copying the new version. Having two versions simultaneously causes the menu to disappear and other unpredictable behavior.

Step 2: Delete the Workspace Cache

After installing or updating the Risksheet plugin, you must clear the Polarion workspace cache:
  1. Stop the Polarion server
  2. Delete the directory: [POLARION_INSTALL]/data/workspace/.config
  3. Optionally, also delete: [POLARION_INSTALL]/data/workspace/.metadata
Failure to delete the [POLARION_INSTALL]/data/workspace/.config directory after installation or update causes empty Setup and License pages in administration. This step is required for both fresh installations and updates.

Step 3: Restart Polarion

  1. Start the Polarion server service
  2. Wait for the server to fully initialize (check server logs for startup completion)
  3. Clear your browser cache or open a new incognito/private window
  4. Navigate to the Polarion project where Risksheet is configured

Step 4: Verify Context Menu Availability

After the Risksheet plugin loads successfully, confirm that the context menu and navigation items are available:
  1. Open a Risksheet-enabled document
  2. Right-click on any cell in the grid
  3. Verify that menu options appear, including:
    • Open Row Item
    • Open Linked Item (when applicable)
    • New Level Items (for creating risk items)
    • Freeze Pane / Unfreeze Pane
Menu ItemWhen Available
Open Row ItemAlways available on data rows
Open Linked ItemWhen cell contains a valid item link
New Level ItemsWhen levels[].showInMenu is true in configuration
Freeze PaneAlways available
Unfreeze PaneWhen columns are currently frozen
If menu items are still not appearing, enable debug mode by setting debug: true in your risksheet.json configuration. This adds a Debug option to the context menu that logs diagnostic information to the browser console.

Verification

You should now see the Risksheet menu in the Polarion navigation bar and the Setup and License pages should display their full content in the administration panel. The context menu should appear when right-clicking cells in the Risksheet grid.

See Also


Support TicketsSource Code
  • RiskSheetContextMenu.ts