Package io.jenkins.plugins.batchcontrol.action

Class DashboardSection

java.lang.Object
io.jenkins.plugins.batchcontrol.action.DashboardSection
All Implemented Interfaces:
ModelObject, org.kohsuke.stapler.StaplerProxy
@Restricted(org.kohsuke.accmod.restrictions.NoExternalUse.class) public class DashboardSection extends Object implements ModelObject, org.kohsuke.stapler.StaplerProxy
The run record dashboard at /batch-control/dashboard/ (SPEC item 10): the most recent builds of every job with cause, user, parameters, result, duration, who aborted it, and — for APPROVED_REQUEST builds — a link to the originating run request.

D-67 (hosting review round 3): at most the 50 most recent runs, newest first, with a link to History for the rest; no look-back window and no paging. The read is bounded by 500 records whatever the store holds, newest bucket first. Requires ViewHistory for the whole subtree (getTarget()); records are read-only, so PUT/DELETE/PATCH are 405 (HttpVerbs).

  • Field Details

    • LIMIT

      public static final int LIMIT
      Most runs the dashboard lists (D-67).
      See Also:

    • SCAN

      public static final int SCAN
      Records read at most, newest appended first. A bucket is ordered by completion, the list by start time, so a little more than LIMIT is read to pick the most recently started.
      See Also:

  • Constructor Details

    • DashboardSection

      public DashboardSection()

  • Method Details

    • getTarget

      public Object getTarget()
      Specified by:
      getTarget in interface org.kohsuke.stapler.StaplerProxy

    • getDisplayName

      public String getDisplayName()
      Specified by:
      getDisplayName in interface ModelObject

    • getViewPermissions

      public Permission[] getViewPermissions()
      Permissions for this screen's l:layout (the same set its section gate checks).

    • getLinks

      public SectionAccess getLinks()
      Link predicates: a link to another screen is rendered only if the user may open it.

    • getItems

      public List<RunRecord> getItems()
      The most recent runs, newest first, at most LIMIT.

    • getLimit

      public int getLimit()
      Most runs listed, for the page text.

    • getOversized

      public int getOversized()
      Over-long lines (over 1 MiB) skipped while reading (security-11 N-02); the CSV export skips the same lines, so the screen says so rather than look complete.

    • format

      public String format(Instant instant)
      Human-readable timestamp.

    • duration

      public String duration(long durationMs)
      Human-readable duration.

    • runUrl

      @CheckForNull public String runUrl(RunRecord record)
      Root-relative build URL (job/a/job/b/12/), or null for plain text (D-44).

    • parameters

      public String parameters(Map<String,String> parameters)
      One-line parameter rendering; values come from the record already masked.