private static IEnumerable <HtmlDataQualityCategory> GroupByCategories(
            [NotNull] IEnumerable <QualitySpecificationElement> elements,
            [NotNull] IDictionary <TestDescriptor, HtmlTestDescriptor> testDescriptors,
            [NotNull] HtmlDataQualityCategoryComparer categoryComparer,
            [NotNull] HtmlQualitySpecificationElementComparer elementComparer,
            [CanBeNull] IHtmlDataQualityCategoryOptionsProvider optionsProvider,
            [NotNull] out List <HtmlQualitySpecificationElement>
            htmlQualitySpecificationElements)
        {
            List <QualitySpecificationElement> elementsList = elements.ToList();

            IDictionary <string, HtmlDataQualityCategory> reportCategories =
                MapReportCategories(elementsList,
                                    categoryComparer,
                                    elementComparer,
                                    optionsProvider);

            htmlQualitySpecificationElements = new List <HtmlQualitySpecificationElement>();

            foreach (QualitySpecificationElement element in elementsList)
            {
                HtmlDataQualityCategory reportCategory =
                    reportCategories[GetCategoryKey(element.QualityCondition.Category)];

                HtmlTestDescriptor htmlTestDescriptor =
                    testDescriptors[element.QualityCondition.TestDescriptor];

                var htmlQualityCondition = new HtmlQualityCondition(
                    element.QualityCondition, htmlTestDescriptor, reportCategory);

                var htmlElement = new HtmlQualitySpecificationElement(htmlQualityCondition,
                                                                      element);

                reportCategory.AddQualitySpecificationElement(htmlElement);
                htmlQualitySpecificationElements.Add(htmlElement);

                htmlTestDescriptor.AddReferencingElement(htmlElement);
            }

            htmlQualitySpecificationElements.Sort(elementComparer);

            // exclude undefined root category if it does not contain any quality conditions

            return(reportCategories.Values
                   .Where(cat => !cat.IsRoot ||
                          !cat.IsUndefinedCategory ||
                          cat.QualitySpecificationElements.Count > 0)
                   .Distinct()
                   .OrderBy(c => c, categoryComparer)
                   .ToList());
        }
        GetHtmlTestDescriptors([NotNull] QualitySpecification qualitySpecification)
        {
            Assert.ArgumentNotNull(qualitySpecification, nameof(qualitySpecification));

            var result = new Dictionary <TestDescriptor, HtmlTestDescriptor>();

            foreach (QualitySpecificationElement element in qualitySpecification.Elements)
            {
                TestDescriptor     testDescriptor = element.QualityCondition.TestDescriptor;
                HtmlTestDescriptor htmlTestDescriptor;
                if (!result.TryGetValue(testDescriptor, out htmlTestDescriptor))
                {
                    htmlTestDescriptor = new HtmlTestDescriptor(testDescriptor);
                    result.Add(testDescriptor, htmlTestDescriptor);
                }
            }

            return(result);
        }
        internal HtmlQualityCondition([NotNull] QualityCondition qualityCondition,
                                      [NotNull] HtmlTestDescriptor testDescriptor,
                                      [NotNull] HtmlDataQualityCategory category)
        {
            Assert.ArgumentNotNull(qualityCondition, nameof(qualityCondition));

            _qualityCondition = qualityCondition;
            TestDescriptor    = testDescriptor;
            Category          = category;

            Description = StringUtils.IsNotEmpty(qualityCondition.Description)
                                              ? qualityCondition.Description
                                              : null;
            Uuid        = qualityCondition.Uuid;
            VersionUuid = qualityCondition.VersionUuid;

            string url = qualityCondition.Url;

            if (url != null && StringUtils.IsNotEmpty(url))
            {
                UrlText = url;
                UrlLink = SpecificationReportUtils.GetCompleteUrl(url);
            }

            foreach (TestParameterValue value in qualityCondition.ParameterValues)
            {
                HtmlTestParameter parameter = testDescriptor.GetParameter(value.TestParameterName);

                if (parameter == null)
                {
                    // test parameter was deleted/renamed -> ignore value
                    continue;
                }

                _parameterValues.Add(new HtmlTestParameterValue(value, parameter));
            }
        }