> ## 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.

# Manage Cross-Project Resources

> Share enumeration values, rating scales, templates, and linked work items across multiple Polarion projects to maintain consistency in multi-project risk management environments.

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>;
};

## Use Global Templates for Shared Configuration

Global templates provide the primary mechanism for sharing Nextedy RISKSHEET configuration across projects. When a document inherits from a template, it receives the template's sheet configuration including all shared definitions.

1. Create a Risksheet template document containing the shared configuration
2. Configure the template path in Risksheet Project Properties so all projects reference the same template
3. Documents created from the template automatically inherit the shared configuration:

| Shared Resource | Configuration Key | What It Provides                                           |
| --------------- | ----------------- | ---------------------------------------------------------- |
| Enumerations    | `enums`           | Dropdown options with IDs, names, descriptions, and icons  |
| Rating scales   | `ratings`         | Severity, occurrence, detection scales for risk assessment |
| Formulas        | `formulas`        | Named formula functions (e.g., RPN calculation)            |
| Styles          | `styles`          | CSS class definitions for conditional formatting           |
| Cell decorators | `cellDecorators`  | Conditional formatting functions mapped to columns         |
| Views           | `views`           | Saved column visibility presets                            |

Documents can override specific parts of the inherited configuration by attaching their own sheet configuration.

<Tip title="Template Changes Propagate on Reload">
  When you update a global template's sheet configuration, documents inheriting from it pick up the changes on the next page load. No manual update is needed per document.
</Tip>

## Share Enumerations Across Projects

Enum columns automatically filter values based on column type and project context. When a column loads items from multiple projects via the `project` parameter in `typeProperties`, enum values from all configured projects are merged:

```yaml theme={null}
{
  "columns": [
    {
      "header": "Risk Type",
      "bindings": "riskType",
      "type": "enum:riskCategory",
      "typeProperties": {
        "project": "SafetyProject,CyberProject"
      }
    }
  ]
}
```

<Frame>
  <img src="https://mintcdn.com/none-17b4493f/-Icoak49xQVOW38R/risksheet/diagrams/guides/advanced/cross-project-resources/diagram-1.svg?fit=max&auto=format&n=-Icoak49xQVOW38R&q=85&s=9972773b89ffa70202a44676df7977a6" alt="diagram" style={{ maxWidth: "620px", width: "100%" }} width="620" height="160" data-path="risksheet/diagrams/guides/advanced/cross-project-resources/diagram-1.svg" />
</Frame>

Task-type enums filter across configured task types in multiple projects. Risk-type enums filter by configured risk types. Project enum columns show only projects allowed in the configuration.

## Configure Cross-Project Reviews

Work item-based reviews can store review items in a dedicated project while linking them back to risk items in the originating project:

```yaml theme={null}
reviews:
  reviewManager: WorkItemBased
  typeProperties:
    linkTypes: reviewItem
    linkRole: reviews
    project: ReviewsProject
    document: Reviews/FMEAReviews
```

When `document` is specified, review work items are created as document work items and positioned after the last existing review item in the target document.

<Warning title="Required Configuration">
  Work item-based reviews require `typeProperties.linkTypes` and `typeProperties.linkRole` to be set. Missing either property results in a runtime error when creating reviews.
</Warning>

## Cross-Project Workflow Status Transitions

When editing cross-project linked items, the workflow status dropdown correctly loads available transitions for the item's home project. The status field presents only valid workflow actions based on the work item's current state in its originating project.

<Note title="New Items">
  Workflow status transitions are not available for newly created work items until they are saved. The status dropdown remains disabled for unsaved items.
</Note>

## Manage User Roles Across Projects

When downstream tasks reside in a different project, the assignee column's `userRole: 'project_assignable'` fetches users from the Risksheet project context, not the task's home project.

**Workaround:** Use a global role where needed users are added across all relevant projects:

```json theme={null}
{
  "columns": [
    {
      "header": "Assignee",
      "bindings": "assignee",
      "type": "ref:user",
      "typeProperties": {
        "userRole": "global_risk_team"
      }
    }
  ]
}
```

## Cross-Project Autocomplete and Suggestions

Autocomplete suggestions for link columns are automatically scoped to the configured projects. When `typeProperties.project` lists multiple projects, the suggestion API returns matching items from all listed projects:

* Users type a fragment and see results from all configured project scopes
* Invalid suggestions from projects that do not match the column's type filters are automatically excluded
* Configure `suggester.limit` in Risksheet Project Properties to control the maximum number of suggestions (default: 20)

## Verify Your Configuration

After setting up cross-project resources:

1. Open a Risksheet document that inherits from the global template
2. Confirm enumerations, ratings, and formulas load correctly from the shared configuration
3. Verify that link columns show suggestions from all configured projects
4. Create a new linked item and confirm it appears in the correct target project
5. Test workflow status transitions on cross-project items

You should now see shared resources loading consistently across all projects using the same template and cross-project configuration.

## See Also

* [Configure Cross-Project Linking](/risksheet/guides/advanced/cross-project-linking) — displaying and linking items from other projects
* [Set Up Global Templates](/risksheet/guides/configuration/global-templates) — template inheritance setup
* [Configure Multi-Project Setup](/risksheet/guides/configuration/multi-project-setup) — project-level settings
* [Manage Cross-Project Reviews](/risksheet/guides/reviews/cross-project-reviews) — cross-project review workflows

<LastReviewed date="2026-07-08" />
