Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 14 additions & 0 deletions docs/admin-guide/input-sources.md
Original file line number Diff line number Diff line change
Expand Up @@ -232,6 +232,20 @@ inputs:
- query: 'region={{ .inputs.region }}'
```

**Example YAML snippet** (HTTP Server with searchable input):

When `searchable` is set to `true` (HTTP Server sources), the dropdown will wait for the user to type a search term instead of loading all values upfront. Use `{{ value }}` in overrides to pass the search text to the HTTP source, as opposed to the `{{ .inputs.<name> }}` syntax used for referencing other inputs.

```yaml
inputs:
instance:
type: input-source
source-name: http-server-instance-list
searchable: true
overrides:
- query: 'search={{ value }}'
```

More usage examples can be found [here](/blueprint-designer-guide/blueprints/blueprints-yaml-structure#inputs).

---
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -115,6 +115,7 @@ For advanced input visibility control and organization, see the [customization](
- ```default``` - (Optional) Value to be used in the Torque UI and will be used in case no other value provided for the input. If a default value is not defined, the environment end-user will need to provide one when launching the environment.
- ```allowed-values``` converts the input into a dropdown list, allowing the environment end-user to select the appropriate value. If a ```default``` is specified, it must be included in the allowed values list.
- ```quick``` is an optional boolean value. Setting it to "true" or omitting it will cause the input to be presented to the end user in the "quick links" section of the environment. Setting it to "false" means it will not appear in that section.
- ```searchable``` (Optional, ```input-source``` type with HTTP Server sources): When set to ```true```, the dropdown will wait for the user to type a search term instead of loading all values upfront. The search text can be passed to the source using ```{{ value }}``` in overrides.
- ```pattern``` is an optional regular expression pattern that the input value must match. If provided, Torque will validate the user input against this pattern during environment launch and prevent launching if the input does not conform to the specified pattern.
- ```validation-description``` is an optional user-friendly message or description that will be shown to the user if the provided input value does not match the specified `pattern`. This helps provide better guidance to the user on the expected input format or constraints.

Expand Down
Loading