Skip to main content

​
Basic Configuration

To enable multiple linked items in a column, use the multiItemLink column type instead of itemLink: 
{
  "headerGroup": "Potential risks",
  "headerGroupCss": "headPotentialRisks",
  "headerCss": "headPotentialRisks",
  "header": "Item/Func",
  "type": "multiItemLink",
  "width": 150,
  "filterable": true,
  "level": 1,
  "id": "item",
  "canCreate": true,
  "typeProperties": {
    "linkRole": "assesses",
    "linkTypes": "systemrequirement,softwarerequirement,systemelement"
  }
}
This configuration allows users to link multiple system requirements, software requirements, or system elements to a single risk item.
  • itemLink: Shows a single linked item per cell. If multiple items exist, only the first one displays.
  • multiItemLink: Shows all linked items as a formatted list within one cell. Each item appears on a separate line with its ID and title.

​
Visual Hierarchy

When working with multiple linked items, the data flows from upstream items through risk items to downstream tasks: diagram

​
Editing Multiple Items

In edit mode, the multiItemLink column displays an autocomplete field where you can:
  1. Add items: Type to search for existing work items, then select from suggestions
  2. Create new items: If canCreate: true, select “Add new [type]” to create linked items on-the-fly
  3. Remove items: Delete individual links using the removal controls
The column shows all linked items with their IDs and titles, separated by line breaks for readability.

​
Filtering Available Items

You can restrict which items appear in the autocomplete using standard query and scope parameters: 
{
  "header": "Hazardous Situations",
  "type": "multiItemLink",
  "id": "situations",
  "typeProperties": {
    "linkRole": "assessedHazardousSituation",
    "linkTypes": "hazardousSituation",
    "document": "Risks/hazardSituations",
    "project": "med_library",
    "query": "status:released"
  }
}
This configuration loads only released hazardous situations from a specific document and project.

​
Dynamic Filtering with Query Factory

For advanced scenarios, use queryFactory to filter available items based on other column values: 
{
  "queryFactories": {
    "situationsQuery": "function(info){return 'linkedWorkItems:'+info.item['assessedSequence']}"
  },
  "columns": [
    {
      "header": "Hazardous Situation",
      "type": "multiItemLink",
      "id": "assessedHazardousSituation",
      "typeProperties": {
        "linkRole": "assessedHazardousSituation",
        "linkTypes": "hazardousSituation",
        "queryFactory": "situationsQuery",
        "createInCurrentDocument": true,
        "document": "Risks/hazardSituations"
      }
    }
  ]
}
This shows only situations linked to the current row’s sequence value, enabling context-aware autocomplete.
You cannot use sub-columns with multiItemLink columns. For example, if you have a multiItemLink column showing harms, you cannot add a separate column showing harm.severity using dot-notation bindings.Workaround: Use serverRender to display linked item properties within the same cell, or create separate read-only columns with custom Velocity rendering.

​
Controlling Item Creation

​
Disable Creation

Prevent users from creating new linked items by setting canCreate: false: 
{
  "header": "Harm",
  "type": "multiItemLink",
  "id": "assessedHarm",
  "canCreate": false,
  "typeProperties": {
    "linkRole": "assessedHarm",
    "linkTypes": "harm",
    "query": "status:released"
  }
}
Users can only select from existing items matching the query.

​
Specify Creation Location

Control where new items are created:
  • Same document as query source (default behavior)
  • Current RISKSHEET document: "createInCurrentDocument": true
  • Specific document: "createInDocument": "Risks/hazardSituations" (version 24.8.1+)

​
Multi-Project Configuration

For cross-project linking, specify multiple projects using space-separated project IDs: 
{
  "typeProperties": {
    "linkRole": "assesses",
    "linkTypes": "systemrequirement",
    "project": "projectA projectB projectC"
  }
}
When using configuration properties for project values, provide hardcoded project IDs as fallbacks since empty configuration property values cause errors.

​
Verification

After configuring a multiItemLink column:
  1. Open your RISKSHEET in edit mode
  2. Click a cell in the multi-item link column
  3. Type to search for work items — autocomplete suggestions should appear
  4. Select multiple items
  5. Save the RISKSHEET
You should now see all linked items displayed as a formatted list in the cell, with each item on its own line showing the ID and title.

​
See also