Package io.jenkins.plugins.analysis.core.steps

Class RecordIssuesStep

java.lang.Object
hudson.model.AbstractDescribableImpl<org.jenkinsci.plugins.workflow.steps.Step>
org.jenkinsci.plugins.workflow.steps.Step
io.jenkins.plugins.analysis.core.steps.RecordIssuesStep
All Implemented Interfaces:
ExtensionPoint, Describable<org.jenkinsci.plugins.workflow.steps.Step>, Serializable
public class RecordIssuesStep extends org.jenkinsci.plugins.workflow.steps.Step implements Serializable
Pipeline step that scans report files or the console log for issues. Stores the created issues in an AnalysisResult. The result is attached to the Run by registering a ResultAction.

Additional features:

  • It provides a QualityGateEvaluator that is checked after each run. If the quality gate is not passed, then the build will be set to Result.UNSTABLE or Result.FAILURE, depending on the configuration properties.
  • It provides thresholds for the build health that could be adjusted in the configuration screen. These values are used by the HealthReportBuilder to compute the health and the health trend graph.
See Also:

  • Constructor Details

    • RecordIssuesStep

      @DataBoundConstructor public RecordIssuesStep()
      Creates a new instance of RecordIssuesStep.

  • Method Details

    • setScm

      @DataBoundSetter public void setScm(String scm)
      Sets the SCM that should be used to find the reference build for. The reference recorder will select the SCM based on a substring comparison, there is no need to specify the full name.
      Parameters:
      scm - the ID of the SCM to use (a substring of the full ID)

    • getScm

      public String getScm()

    • setQualityGates

      @DataBoundSetter public void setQualityGates(List<WarningsQualityGate> qualityGates)
      Defines the optional list of quality gates.
      Parameters:
      qualityGates - the quality gates

    • getQualityGates

      public List<WarningsQualityGate> getQualityGates()

    • setId

      @DataBoundSetter public void setId(String id)
      Defines the ID of the results. The ID is used as URL of the results and as name in UI elements. If no ID is given, then the ID of the associated result object is used.

      Note: this property is not used if isAggregatingResults is false. It is also not visible in the UI in order to simplify the user interface.

      Parameters:
      id - the ID of the results

    • getId

      public String getId()

    • setName

      @DataBoundSetter public void setName(String name)
      Defines the name of the results. The name is used for all labels in the UI. If no name is given, then the name of the associated StaticAnalysisLabelProvider is used.

      Note: this property is not used if isAggregatingResults is false. It is also not visible in the UI in order to simplify the user interface.

      Parameters:
      name - the name of the results

    • getName

      public String getName()

    • setIcon

      @DataBoundSetter public void setIcon(String icon)
      Defines the custom icon of the results. If no icon is given, then the default icon of the associated StaticAnalysisLabelProvider is used.
      Parameters:
      icon - the icon of the results

    • getIcon

      public String getIcon()

    • getToolProxies

      @CheckForNull @Deprecated public List<ToolProxy> getToolProxies()
      Deprecated.
      this method is only intended to be called by the UI
      Gets the static analysis tools that will scan files and create issues.
      Returns:
      the static analysis tools (wrapped as ToolProxy)
      See Also:

    • setToolProxies

      @DataBoundSetter @Deprecated public void setToolProxies(List<ToolProxy> toolProxies)
      Deprecated.
      this method is only intended to be called by the UI
      Sets the static analysis tools that will scan files and create issues.
      Parameters:
      toolProxies - the static analysis tools (wrapped as ToolProxy)
      See Also:

    • setTools

      @DataBoundSetter public void setTools(List<Tool> tools)
      Sets the static analysis tools that will scan files and create issues.
      Parameters:
      tools - the static analysis tools
      See Also:

    • setTools

      public void setTools(Tool tool, Tool... additionalTools)
      Sets the static analysis tools that will scan files and create issues.
      Parameters:
      tool - the static analysis tool
      additionalTools - additional static analysis tools (might be empty)
      See Also:

    • getTools

      public List<Tool> getTools()
      Returns the static analysis tools that will scan files and create issues.
      Returns:
      the static analysis tools

    • setTool

      @DataBoundSetter public void setTool(Tool tool)
      Sets the static analysis tool that will scan files and create issues.
      Parameters:
      tool - the static analysis tool

    • getTool

      @CheckForNull public Tool getTool()
      Always returns null. Note: this method is required for Jenkins data binding.
      Returns:
      null

    • getSourceCodeEncoding

      @CheckForNull public String getSourceCodeEncoding()

    • setSourceCodeEncoding

      @DataBoundSetter public void setSourceCodeEncoding(String sourceCodeEncoding)
      Sets the encoding to use to read source files.
      Parameters:
      sourceCodeEncoding - the encoding, e.g. "ISO-8859-1"

    • setSourceDirectories

      @DataBoundSetter public void setSourceDirectories(List<io.jenkins.plugins.prism.SourceCodeDirectory> sourceDirectories)
      Sets the paths to the directories that contain the source code. If not relative and thus not part of the workspace, then these directories need to be added in Jenkins global configuration to prevent accessing of forbidden resources.
      Parameters:
      sourceDirectories - directories containing the source code

    • getSourceDirectories

      public List<io.jenkins.plugins.prism.SourceCodeDirectory> getSourceDirectories()

    • setSourceCodeRetention

      @DataBoundSetter public void setSourceCodeRetention(io.jenkins.plugins.prism.SourceCodeRetention sourceCodeRetention)
      Defines the retention strategy for source code files.
      Parameters:
      sourceCodeRetention - the retention strategy for source code files

    • getSourceCodeRetention

      public io.jenkins.plugins.prism.SourceCodeRetention getSourceCodeRetention()

    • getAggregatingResults

      public boolean getAggregatingResults()
      Returns whether the results for each configured static analysis result should be aggregated into a single result or if every tool should get an individual result.
      Returns:
      true if the results of each static analysis tool should be aggregated into a single result, false if every tool should get an individual result.

    • setAggregatingResults

      @DataBoundSetter public void setAggregatingResults(boolean aggregatingResults)

    • isQuiet

      public boolean isQuiet()
      Returns whether report logging output should be enabled.
      Returns:
      true if report logging is disabled false if report logging is enabled

    • setQuiet

      @DataBoundSetter public void setQuiet(boolean quiet)

    • isSkipBlames

      public boolean isSkipBlames()
      Returns whether SCM blaming should be disabled.
      Returns:
      true if SCM blaming should be disabled

    • setSkipBlames

      @DataBoundSetter public void setSkipBlames(boolean skipBlames)

    • isSkipPostProcessing

      public boolean isSkipPostProcessing()
      Returns whether post-processing of the issues should be disabled.
      Returns:
      true if post-processing of the issues should be disabled.

    • setSkipPostProcessing

      @DataBoundSetter public void setSkipPostProcessing(boolean skipPostProcessing)

    • isSkipDeltaCalculation

      public boolean isSkipDeltaCalculation()
      Returns whether the SCM delta calculation for the new issue detection should be disabled.
      Returns:
      true if the SCM delta calculation for the new issue detection should be disabled.

    • setSkipDeltaCalculation

      @DataBoundSetter public void setSkipDeltaCalculation(boolean skipDeltaCalculation)

    • isSkipPublishingChecks

      public boolean isSkipPublishingChecks()
      Returns whether publishing checks should be skipped.
      Returns:
      true if publishing checks should be skipped, false otherwise

    • setSkipPublishingChecks

      @DataBoundSetter public void setSkipPublishingChecks(boolean skipPublishingChecks)

    • setChecksAnnotationScope

      @DataBoundSetter public void setChecksAnnotationScope(io.jenkins.plugins.analysis.core.steps.WarningChecksPublisher.ChecksAnnotationScope checksAnnotationScope)
      Sets the scope of the annotations that should be published to SCM checks.
      Parameters:
      checksAnnotationScope - the scope to use

    • getChecksAnnotationScope

      public io.jenkins.plugins.analysis.core.steps.WarningChecksPublisher.ChecksAnnotationScope getChecksAnnotationScope()

    • isPublishAllIssues

      @Deprecated public boolean isPublishAllIssues()
      Deprecated.
      use getChecksAnnotationScope() instead
      Returns whether all issues should be published using the Checks API. If set to false only new issues will be published.
      Returns:
      true if all issues should be published, false if only new issues should be published

    • setPublishAllIssues

      @Deprecated @DataBoundSetter public void setPublishAllIssues(boolean publishAllIssues)
      Deprecated.
      use setChecksAnnotationScope(ChecksAnnotationScope) instead
      Returns whether all issues should be published to SCM checks.
      Parameters:
      publishAllIssues - if true then all issues should be published, otherwise only new issues

    • getEnabledForFailure

      public boolean getEnabledForFailure()
      Returns whether recording should be enabled for failed builds as well.
      Returns:
      true if recording should be enabled for failed builds as well, false if recording is enabled for successful or unstable builds only

    • setEnabledForFailure

      @DataBoundSetter public void setEnabledForFailure(boolean enabledForFailure)

    • setIgnoreQualityGate

      @DataBoundSetter public void setIgnoreQualityGate(boolean ignoreQualityGate)
      If true, then the result of the quality gate is ignored when selecting a reference build. This option is disabled by default, so a failing quality gate will be passed from build to build until the original reason for the failure has been resolved.
      Parameters:
      ignoreQualityGate - if true then the result of the quality gate is ignored, otherwise only build with a successful quality gate are selected

    • getIgnoreQualityGate

      public boolean getIgnoreQualityGate()

    • setFailOnError

      @DataBoundSetter public void setFailOnError(boolean failOnError)
      Determines whether to fail the step on errors during the step of recording issues.
      Parameters:
      failOnError - if true then the build will be failed on errors, false then errors are only reported in the UI

    • getFailOnError

      public boolean getFailOnError()

    • getHealthy

      public int getHealthy()

    • setHealthy

      @DataBoundSetter public void setHealthy(int healthy)
      Sets the healthy threshold, i.e., the number of issues when health is reported as 100%.
      Parameters:
      healthy - the number of issues when health is reported as 100%

    • getUnhealthy

      public int getUnhealthy()

    • setUnhealthy

      @DataBoundSetter public void setUnhealthy(int unhealthy)
      Sets the healthy threshold, i.e., the number of issues when health is reported as 0%.
      Parameters:
      unhealthy - the number of issues when health is reported as 0%

    • getMinimumSeverity

      @CheckForNull public String getMinimumSeverity()

    • setMinimumSeverity

      @DataBoundSetter public void setMinimumSeverity(String minimumSeverity)
      Sets the minimum severity to consider when computing the health report. Issues with a severity less than this value will be ignored.
      Parameters:
      minimumSeverity - the severity to consider

    • setTrendChartType

      @DataBoundSetter public void setTrendChartType(TrendChartType trendChartType)
      Sets the type of the trend chart that should be shown on the job page.
      Parameters:
      trendChartType - the type of the trend chart to use

    • getTrendChartType

      public TrendChartType getTrendChartType()

    • getFilters

      public List<RegexpFilter> getFilters()

    • setFilters

      @DataBoundSetter public void setFilters(List<RegexpFilter> filters)

    • start

      public org.jenkinsci.plugins.workflow.steps.StepExecution start(org.jenkinsci.plugins.workflow.steps.StepContext context)
      Specified by:
      start in class org.jenkinsci.plugins.workflow.steps.Step