Automation Platform Tasks

Viewing jobs Quick View

2 minute read

A quick view category provides a convenient way to select a group of jobs that interest you, such as "all production builds for product xyz version 3.6" or "all jobs I invoke manually." CloudBees CD displays the most recent jobs for each category on your Home page so you can review them easily.

To create a new jobs quick view category

Enter information into the fields as follows:

Name —Type a name for your new job category.

Number of Jobs —Type the maximum number of jobs you want to see in your quick view summary. The summary displays the most recent applicable jobs.

Include Last Success —Select this check box if you want to see the last successful job in this category, even if it was not one of the most recent jobs.

Two Filter categories:

  • Intrinsic filters —These filters provide a convenient way to access certain well-defined fields for jobs.

  • Custom filters —These filters allow you to access a much broader range of values, including custom properties. Any values accessible through an intrinsic filter can be checked using a custom filter also (though not as conveniently).

Each filter specifies three values: the name of a particular property to check, a value it should be compared with, and relational operators such as "equals" or "less than." For example, if you select "Outcome" in an intrinsic filter with operator "not equals" and value "Success," the filter selects jobs that did not complete successfully because they had errors or warnings.

For an intrinsic filter, select a property by choosing one of several predefined properties from a list. For a custom filter, enter a property name. This name can be either the name of an intrinsic property for the job (such as "status" or "procedureName"), or the name of a property defined in the global property sheet for that job, or the name of a parameter for that job.

For the relational operator, select one of the values in the list. The behavior of the relational operators is determined by the underlying database. In most cases, comparisons are done using string comparison; operators such as "less than" may not be useful on numbers because "12" is considered less than "9". For some built-in properties, the database treats values according to a specific type such as number or date, so comparisons are implemented in the way appropriate for that type.

The relational operator "like" invokes an SQL wildcard comparison where "%" is the wildcard character. For example %test% matches "first test" and "tests failed" but not "Test 44".

Job Quick View filters allow property path references. However, property path references are not allowed in search parameters on the Search page.

Click OK after making your selections to save your new job category and see it on the Home page.

To edit an existing jobs quick view category

Keep or change any of the previously entered information. See the Filter information above to add or change existing custom or intrinsic filters.

Click OK after making your selections to save your modified job category and see it on the Home page.