Atlassian uses cookies to improve your browsing experience, perform analytics and research, and conduct advertising. Accept all cookies to indicate that you agree to our use of cookies on your device. Atlassian cookies and tracking notice, (opens new window)
Confluence
Teams
, (opens new window)

Requirement Yogi (Cloud)
Results will update as you type.
  • Getting Started - Tutorials
  • Best Practices
  • Administrator's guide
    • Installation Checklist
    • RY Champions
    • Cleanup Tasks
    • Rename requirements
    • Key suggestions
    • Migrating from DC to Cloud
    • Data residency
    • Limitations
    • IPs and domains used by Requirement Yogi
  • Features
  • Requirement Yogi for Jira
  • Testing your requirements - Best practices
  • Integrations
  • REST APIs (Cloud)
  • Release notes
    Calendars
You‘re viewing this with anonymous access, so some content might be blocked.
/
Cleanup Tasks
Updated May 14, 2024

    Cleanup Tasks

    This new feature will allow you to find requirements with errors, and clean them up. Here are the types of errors you may find:

    • Multiple definitions: This error happens when you use the same requirement key (definition macro) on multiple places. Requirement keys need to be unique per space, or on different variants, otherwise we will not be able to index the requirement.

    • Dead Confluence Links: When you use a requirement link to point to a requirement, that gets deleted, moved or changed variant.

    • Dead Jira Links: When you link a requirement to a Jira issue but the requirement ends up deleted, moved or changed variant.

    How to use

    In the sidebar, click on Requirements > Administration > Cleanup tasks.

    Cleanup Tasks.png

    Duplicated keys / Multiple definitions

    This list will allow you to see each duplicated key.

    As we cannot edit Confluence pages ourselves, you’ll need to click on page links and remove the duplicated keys manually.

    Duplicated keys.png

    In the search tab, you can also see the requirements with multiple definitions error.

    📌 If you want to remove the error on a requirement because you are in the process of creating a variant, and still want the original requirement to be indexed:

    • You can click on the bin icon to remove a duplicated key. This will not edit the Confluence page and remove the key, but it will deindex this definition from the page. If you edit the page again, we’ll trigger an indexation and the error will come back.

    Search - Multiple Definitions.png

    Dead Confluence Links

    This list will show you deleted requirements on the left side, and on the right side, pages where they have a requirement link macro on.

    You’ll have to click on the Confluence pages, and edit the page yourself to clean those dead requirement links.

    Dead Confluence Links.png

    Dead Jira Links

    Note that this is only useful if you have installed the Requirement Yogi for Jira Integration.

    This list will show deleted requirements in Confluence, that still point to Jira issues.

    Here you can click on ‘Remove duplicated links’ and it will clean the dead requirement links for those Jira issues.

    Jira Dead links.png

     

    {"serverDuration": 12, "requestCorrelationId": "afc11d14c4a84467bbb372c450b983b3"}