Skip to main content

Searching for Components

Searching for components finds information about specific artifacts in the repository. Use this for research into available components, to integrate with your build tool migrations, to download packages, and for quality assurance.

Searching Overview

Component search is available in the search bar at the top and the Search button on the side navigation.

  • The nx-search-read privilege is required to view the search bar and menu button in the user interface.

    The repository-view privilege is required to search a specific repository.

  • Format-specific search forms are nested under the Search button.

Example search for keyword sonatype with format npm added and the icons for removing or resetting search criteria highlighted

More Criteria Drop-down

Use the more criteria dropdown to add additional search criteria to your query. This criteria includes specific metadata fields for the repository as well as format-specific criteria.

  • Selecting specific criteria adds a new search field for you to enter into.

  • Criteria may be removed by selecting the minus icon within the criteria input box.

  • Criteria are not used when nothing is specified in the specific criteria.

Keyword search query string

Tokenization is the process of splitting text into smaller parts, or 'tokens', during indexing and querying. Component metadata and coordinates are tokenized in the Nexus Repository database so the search provides better matching.

When using keyword searches with a hyphenated component name such as aether-util the query is tokenized to aether and util; proving results for both keywords. The tokens of your query string must match a field in one of the indexes exactly.

Using double quotes to narrow results

To match exactly aether-util, use double quotes in the search term to require the full string for a match.

"aether-util"

Wildcards in searches

Use the asterisk (*) character as a wildcard to broaden search results. Wildcards may be used anywhere in the query string however placing them anywhere except for the last character position may have a performance impact on its execution.

Use aeth* to find aether or aether-util

Search Results

After entering search criteria in one or multiple input fields, the first 300 results become visible in the component list. The components are listed with their Name, Group, Version, Format, and Repository information.

Selecting a component in the list changes to a display of the component information.

Notable Search Functionality Differences Between Environments

Search functionality differences exist between the different databases and deployment patterns.

  • Searching by Conan Package ID and Conan Package or Recipe Revisions are not available for those using OrientDB.

  • Use a leading slash (i.e., "/") when searching for raw components in H2 or Non-HA PostgreSQL Environment

Search Feature Differences in an HA Environment

The search feature implemented for high availability (HA) differs a great deal from the search currently used in a non-HA environment.

HA search has the following requirements:

  • At least one search criterion is required when searching through the UI

  • At least one additional search criterion is required beyond format when searching through the UI

  • Each search criteria must be at least three characters long

  • Leading wildcard search is not supported; however, you may use a trailing wildcard (i.e., prefix search)

  • Searches cannot begin with special characters followed by a wildcard

  • All keyword searches automatically append a wildcard (*) at the end of each criterion

Example Invalid Search Patterns

The following search patterns are some that may work in non-HA environments but will not work in an HA environment

Invalid Pattern

Reasoning

"*"

Less than three characters long; leading wildcard not supported

"he*"

Less than three characters long

"he*@_"

User criteria ("@_") contains only an underscore

"he*@/"

User criteria ("@/") contains only a forward slash

"he*@*"

User criteria ("@*") contains only a wildcard

"/*/hel"

Search begins with a special character followed by a wildcard

"$%*hel"

Search begins with two special characters followed by a wildcard

Refetch Limits and Search Configuration Capability

As of 3.72.0, Nexus Repository will only make 10 trips to the database to return a result set in a PostgreSQL HA deployment. You can adjust this limit by creating a Search Configuration Capability specifying a different refetch limit. Setting the refetch limit to "-1" will allow unlimited database queries; however, this can result in slower performance in very large deployments. In some scenarios, the refetch limit may result in missing or empty search results.

You must have clustering enabled to see the Search Configuration capability option.

Search Criteria and Component Attributes

Criteria to use with most repository formats. These return results across all repositories:

  • Keyword

    Use a keyword search to search for a string found in any component metadata value.

  • Format

    The format of the repository in which to look for a component.

  • Repository Name

    The name of a repository in which to look for a component.

  • Group

    The namespace of the component; often the organization that produces it. Some formats use a different name for this criterion such as org for Ivy or groupId for Maven while other formats do not use groups such as the Nuget repository format.

  • Name

    The name of a component constitutes its main identifier. Different repository formats use a different name for the concept such as artifactId for Apache Maven and the maven2 repository format.

  • Version

    A component's version identifies the specific point in time at which that component was released. Various tools such as Maven or NuGet use the term version. Other build systems call this something else (e.g., Apache Ivy uses rev (short for revision)). In most repository formats, version numbers do not need to follow a specific standard and are simply a string. This affects the sort order and can produce unexpected results.

  • Checksum

    A checksum value of a component file generated by an MD5, SHA-1, SHA-256, or the SHA-512 algorithm.

Conan Repositories

  • Base Version

    Project or library version (e.g., "1.0.0")

  • Channel

    Channel represents an alternative variant of packages for the same library and usually describes the maturity of the package (e.g., "stable" or "testing"). Also can show package revisions.

    Common Version criteria for Conan format is a combination of Base Version and Channel, for instance, "1.0.0-stable"

  • Package ID (PostgreSQL or H2 databases only)

    A Conan Package ID is a unique identifier that encodes information about the settings, options, and requirements of each package.

  • Package and Recipe Revisions (PostgreSQL or H2 databases only)

    In simplest terms, revisions are versions of versions. The Conan revisions feature allows you to make changes to your artifacts while maintaining a single Conan reference. Every Conan recipe export is associated with a unique ID (i.e., a revision); every recipe change results in a new recipe revision (RREV). Conan calculates a new package revision (PREV) using the package contents' hash whenever you create a new package. Package revisions belong to recipe revisions; the same package ID may have multiple package revisions belonging to a single recipe revision.

    See Conan's documentation on package revisions

Docker Repositories

  • Image Name

    The name for the Docker image. It is equivalent to the Name of the component in the repository manager that represents the Docker image.

  • Image Tag

    The tag for the Docker image. It is equivalent to the Version of the component in the repository manager that represents the Docker image.

  • Layer Id

    The unique identifier for a Docker image layer.

Maven Repositories

  • Group Id

    The Maven groupId for a component. Other build systems supporting the Maven repository format call this differently e.g. org for Apache Ivy and group for Gradle and Groovy Grape. Group Id is equivalent to Group.

  • Artifact Id

    The Maven artifactId for a component. Other build systems call this differently e.g. name for Apache Ivy and Gradle, and the module for Groovy Grape. Artifact ID is equivalent to Name.

  • Classifier

    The Maven classifier for a component. Common values are javadoc, sources, or tests.

  • Base Version

    The base version of the component/asset. Typically this is the same value as the version for release components. SNAPSHOT development components use a time-stamped version but the base version uses the SNAPSHOT version e.g. version of 1.0.0-20151001.193253-1 and base version of 1.0.0-SNAPSHOT.

  • Extension

    The extension is used for a specific asset of a component.

NuGet Repositories

  • ID

    The NuGet component identifier is known as Package ID to NuGet users.

  • Tags

    Additional information about a component formatted as space-delimited keywords, chosen by the package author.

p2 Repositories

  • Plugin Name

    The name of a p2 plugin stored

PyPI Repositories

  • Classifiers

    Denote the maturity, intended audience, license, and supported versions the creator wished associated with their component.

  • Description

    The creator provided a long description of the component.

  • PyPI Keywords

    Associated component keywords. Generally used as identifiers to search.

  • Summary

    The creator described the component.

RubyGems Repositories

  • Platform

    The Platform the gem runs on is defined via the gemspec.

  • Summary

    A summary of the gem's description is defined via the gemspec.

  • Description

    A long description of the gem is defined via the gemspec. This field is optional when creating a gem so may be blank.

Yum Repositories

  • Package Name

    The name of the package, this field is the equivalent of Name for Yum.

  • Architecture

    The architecture the package is designed to be run on.

Preconfigured Searches

Preconfigured searches are available when a repository for the format exists in the repository and the user has repository-view access to the repository. The format-specific search is available via the format-named menu item in the Search section of the Browse menu.

Each preconfigured search supports adding further criteria.

  • Keyword Search

    The main toolbar includes a Search components text input field. Type your search term and press enter/return and the repository manager performs a search by Keyword.

    The same search can be accessed by selecting the Search item in the Browse main menu. The search term can be provided in the Keyword input field in the Search feature view.

  • Custom Search

    A configurable search using the criteria you select is available via the Custom menu item in the Search section of the Browse main menu. Initially, it has no criteria and it allows you to create a search with criteria you add with the More Criteria dropdown.

Search Name

Format

Default Inputs

Apt Search

apt

Package Name, Version

Bower Search

bower

Name, Version

CocoaPods Search

cocoapods

Package Name, Version

Conan Search

conan

Package Name, Base Version, Channel

Conda Search

conda

Package Name, Version

Docker Search

docker

Image Name, Image Tag, Layer ID

Git LFS Search

gitlfs

Name (generated OID found in the pointer file)

Go Search

go

Name, Version

Helm Search

helm

Name, Version

Maven Search

maven2

Group Id, Artifact Id, Version, Base Version, Classifier, Extension

NuGet Search

nuget

ID, Tags

npm Search

npm

Scope, Name, Version

p2 Search

p2

Package Name, Plugin Name

PyPI Search

pypi

Classifiers, Description, PyPI Keywords, Summary

R Search

r

Package Name and Version

Raw Search

raw

Name

RubyGems Search

RubyGems

Name, Version, Platform, Summary, Description

Yum Search

yum

Package Name, Version, Architecture