Build-test automation
IntroductionScenario 1 - Creating a simple procedureScenario 2 - Creating a procedure that uses an SCMScenario 3 - Notification, scheduling, and reportingScenario 4 - Multi-agent build and test
IntroductionCustomizing the automation platform UIConfiguring CloudBees CD/ROUsing CloudBees CD/RO in your environmentCloudBees CD/RO Installed tools
IntroductionArtifact managementAuthenticating users for ldap and active directoryAuto-discoveryDefect trackingJob step execution environmentPostprocessorsReportsWorkflow overviewWorkspaces overview
IntroductionIntrinsic propertiesReserved wordsProperty shortcutsProperty error codes
IntroductionAdding a link to a jobCalling a subprocedureChecking the outcome of preceding stepsConditional executionCustom parameter layoutsEmail notificationsExecuting tasks on all resources in a poolFactory proceduresPostp extensionPublishing and retrieving an artifactReserving a resource for the job step durationRunning steps in parallelStep timeouts and steps that always runStoring and retrieving properties in a jobWorking with properties stored in a procedure
Using special characters in object names
Introduction
IntroductionDefining entriesCreate new or edit existing privileges
IntroductionArtifact detailsCreate new or edit existing artifactsArtifact versionsArtifact version detailsEdit an existing artifact versionRepositoriesCreate new or edit existing repositories
Database configuration
IntroductionCreate new or edit existing configurationsDefect tracking reports
IntroductionCreate new or edit existing email configurationsEmail notifiers
Event log
IntroductionJob configurationShortcutsJobs quick view
IntroductionCloudBees CD/RO job detailsJob step details
IntroductionProcedure runsCreate new or edit existing procedureCreate new or edit existing stepsPublish artifact version stepsRetrieve artifact version stepsSend email stepsCreate new or edit existing parameters
IntroductionProject detailsCreate new or edit existing schedulesCreate new or edit existing credentials
IntroductionNested Property Sheet
Reports
IntroductionResource poolsCreate new or edit existing poolsResource pool details
IntroductionSearch resultsEdit existing property settings
Source control
IntroductionUsersCreate new or edit existing local usersUser detailsEdit user settingsGroupsCreate new or edit existing groupsGroup detailsCreate new or edit existing directory providersSingle sign-onTest directory provider
IntroductionCreate new or edit exiting workflow definitionsWorkflow definition detailsRun workflowWorkflow detailsWorkflow logTransition workflow
Introduction Create or modify WorkspacesWorkspace file

Searching and Filtering

3 minute readAutomation

The page allows you to search for any supported object type.

Enter information into the fields as follows:

Field Name Description

Object Type

Use the drop-down menu to select the object you wish to search.

Criteria

Click Add Criteria one or more times to further define the criteria for your search.

  • Use the drop-down arrow to select a criteria argument. These arguments are properties. For a description of any of these properties, see the Properties Help topic.

  • Use the drop-down arrow to select an operator for the search.

  • Enter a value to search that is based on the selected operator and argument. For example, if you selected Project Name to begin your search and "contains" as the operator, you might want to enter the actual project name in this field or the first few letters if you have multiple projects named in a similar pattern.

Custom Criteria

Click Add Custom Criteria one or more times to enter custom criteria to further define your object search. Type the property name to search, and then select your search operator and the search value.

Click OK after filling in the fields and to go to the Search Results page.

NOTE:

  • Only the first 450 characters of a property string are searchable. For example, if your property value happens to contain 1500 characters and the information you are trying to find is 800 characters into the property string, the search mechanism will not find it.

  • When defining a search on this page, property path references are not allowed in search parameters. However, property path references are allowed in the Home page Quick View filters.

  • The maximum number of search results that will be returned on the Search Results page is controlled by the server property ec_ui/maxIds/default. The out-of-the box default for this property is 1000. This default can be overridden for a specific object type. For example, the maximum number of jobs to display is controlled using the server property ec_ui/maxIds/job that is set to 500 out-of-the box.

  • The default page size of 100 will be used to display the search results on the Search Results page, unless a user-specified page size is set (this user-specified setting will be used). You can save a user-specified page setting by changing the value in the Records Per Page drop-down field at the bottom of the Search Results page.

  • The Records Per Page drop-down options are controlled through a server property ec_ui/pageSizeOptions with 10, 20, 50,100, 250, or 500 as the out-of-the-box value.

  • Any changes to the properties within the server property sheet ec_ui/maxIds or the server property ec_ui/pageSizeOptions take effect after you log in again.

Context Searching and Filtering

Context searching allows you to search for objects on the current page without having to navigate to a separate Search page. It is available on these pages:

  • Projects

  • Jobs

  • Artifacts

  • Artifact versions

  • Workflow

In-context search has these capabilities:

  • Quick search: Type the search criteria in the text box and click OK to run a quick search.

  • Search filters: Enter criteria to filter the results by specific attributes or properties on the selected object, and click OK to run the search.

  • Saved searches: Save a search as a named saved search for later use.

    Save search
    Figure 1. Save search

    1

    Quick search. The OK button also applies to the search filters.

    2

    Search filters

    3

    Saved searches

Example

Running Quick Searches

On the Jobs page, if you do a quick search for mysql, you get these results:

Quick search
Figure 2. Quick search

Saving Filters

To save the filter for jobs containing mysql in the job name:

  1. Click Save. The Save Filter dialog box opens.

  2. Enter the filter name in the Filter Name field and click OK.

    The Saved Filter field now shows that there is a saved filter called mysql.

When you have more than one saved filter, click on the down arrow to see the list of filters you have saved. The saved filters are user-specific, so you will only see your saved filters and not other users’ filters.

Setting Search Filters

To add filters for search:

  1. Click Show to show the filters.

    The Add Criteria and Add Custom Criteria options appear along with the filter fields.

  2. Click Add Criteria to add criteria.

  3. In the first field, select the search filter argument.

  4. In the second field, select the operator for the filter.

  5. In the third field, select the criteria to narrow down your search. The available options depend on the argument you selected.

  6. To add another filter, enter a value in the Quick Search text box, click Add Criteria, or click Custom Criteria.

  7. Repeat the previous step to add as many filters as you want.

  8. To run the search, click OK.

Search results