Contents Menu Expand Light mode Dark mode Auto light/dark, in light mode Auto light/dark, in dark mode Skip to content
X as Code (XaC) documentation
Light Logo Dark Logo

Knowledge

  • Tutorials
    • Setting Up a Sphinx-Needs Project
    • Setting Up PlantUML for Sphinx-Needs
    • Creating Powerful Dashboards
    • Setting Up ubCode and ubConnect Licenses
  • How To Guides
    • Writing Requirements
    • Tracing Source Code
    • Mermaid Integration
    • Draw.io Integration
    • Architecture Diagrams
    • Architecture Documentation with arc42
    • Jira and other Links
    • How to integrate External Needs
    • GitHub Actions Integration
    • Test Management and Traceability
      • Test Requirements
  • Explanation
    • Why X-as-Code Beats Multi-Tool Chaos
    • The Review Process: From ALM to Git
    • Access Management Strategies
  • Reference
  • FAQ & BEST PRACTICES

Community

  • Contribute
Back to top
View this page
Edit this page

How to integrate External Needs¶

Sometimes you want to integrate needs from an external source into your documentation. A known and valid use-case might be for example the integration of “plattform” requirements.

The following example shows how to integrate needs from an external json file.

# file: ubproject.toml
# docs/external/needs_external.json integration
[[needs.external_needs]]
json_path = "./external/needs_external.json"
# use this to download from a remote
# json_url = "https://sphinx-needs.readthedocs.io/en/latest/needs.json"
base_url = "https://example.com"
target_url = "{{need['id']}}"

External needs¶

Here are some needs that are external to the documentation, but can still be linked by other needs in this documentation:

  • REQ_1_1_ext

  • REQ_1_2_ext

  • SPEC_1_1_ext

  • SPEC_1_2_ext

These external needs can be linked like normal needs:

Requirement: Requirement 1.1 REQ_1_1
status: open
links outgoing: REQ_1_1_ext

This is a requirement that links to an external requirement.

Next
GitHub Actions Integration
Previous
Jira and other Links
Copyright © 2026, team useblocks
Made with Sphinx and @pradyunsg's Furo
On this page
  • How to integrate External Needs
    • External needs