Catalog-Backed Selectors

Use catalog-backed selectors when a mold input should be selected from existing Shoehorn data.

inputs:
  type: object
  required:
    - team
  properties:
    team:
      type: string
      title: Owning team
      ui:options:
        source: catalog:teams
        placeholder: Select a team

Available sources

Source	What users can select	Stored value
`catalog:teams`	Teams	Team slug, falling back to team name
`catalog:users`	Users	User email
`catalog:groups`	Groups	Group name
`catalog:entities`	Catalog entities	Entity service name, falling back to entity ID
`catalog:repositories`	Repositories	Repository full name, falling back to repository name

Use catalog:entities when a mold needs to select a catalog entity. Add filters when the selector should only show a subset, such as services owned by a team.

Filtering entities

catalog:entities supports filters in ui:options.filters.

dependsOnService:
  type: string
  title: Depends on service
  ui:options:
    source: catalog:entities
    placeholder: Select a service
    filters:
      type: service
      lifecycle: production
      owner: platform-team
      source: github
      tags:
        - golang
      search: api
      limit: 50

Supported filters:

Filter	Description
`type`	Entity type, such as `service`
`manifestType`	Manifest type
`lifecycle`	Lifecycle value
`owner`	Owner or team
`source`	Source system
`team`	Team
`tags`	Required tags
`search`	Search text
`limit` or `pageSize`	Number of options to load

Examples

User selector:

requestedBy:
  type: string
  title: Requested by
  ui:options:
    source: catalog:users
    placeholder: Select a user

Repository selector:

repository:
  type: string
  title: Existing repository
  ui:options:
    source: catalog:repositories
    placeholder: Select a repository