From: michaelbirnstiehl Date: Thu, 18 Nov 2021 15:11:58 +0000 (-0600) Subject: SONAR-15498 update unicity note X-Git-Tag: 9.2.0.49834~6 X-Git-Url: https://source.dussan.org/?a=commitdiff_plain;h=6d3211296f8f7569de04626f5ffec647385cce4e;p=sonarqube.git SONAR-15498 update unicity note --- diff --git a/server/sonar-docs/src/pages/project-administration/managing-portfolios.md b/server/sonar-docs/src/pages/project-administration/managing-portfolios.md index 2b33a92689d..1a6c3d4810d 100644 --- a/server/sonar-docs/src/pages/project-administration/managing-portfolios.md +++ b/server/sonar-docs/src/pages/project-administration/managing-portfolios.md @@ -21,6 +21,10 @@ Users need to have either **Administer** permissions for any Portfolios that the ## Populating Portfolios After you've created a portfolio, you can populate it with projects, applications, and other portfolios. +[[info]] +|**Uniqueness in portfolios**

+|Project branches, applications, and portfolios can only appear once in any given hierarchy in order to avoid magnifying their impacts on aggregated ratings. The portfolio configuration interface has some logic to prevent obvious duplications (such as manually adding the same project). However, in case of more subtle duplications (for example, due to regular expression or other bulk definition), the calculation of that portfolio will fail with a helpful error message. + ### Adding another Portfolio to a Portfolio To add another Portfolio to your Portfolio, from **[Administration > Configuration > Portfolios](/#sonarqube-admin#/admin/extension/governance/views_console)** click the **Add Portfolio** button at the top of the third column, and choose: @@ -65,10 +69,6 @@ To add an Application to a Portfolio, make sure your Application is [already cre 4. Select **Local Reference**. 5. Choose your Application from the drop-down menu and click **Add**. -[[info]] -|**Project unicity under a portfolio**

-|Projects, applications, and portfolios can only appear once in any given hierarchy in order to avoid magnifying their impacts on aggregated ratings. The portfolio configuration interface has some logic to prevent obvious duplications (e.g. manually adding the same project), however in case of more subtle duplications (for example, due to regular expression or other bulk definition), then the calculation of that portfolio will fail with a helpful error message. - ## Calculation By default, Portfolios are queued to be recalculated after each analysis of an included project. For each relevant Portfolio, a “Background Task” is created, and you can follow the progress on each in the **[Administration > Projects > Background Tasks](/#sonarqube-admin#/admin/background_tasks)** by looking at the logs available for each item.