Control bundle

Form controls starter pack

<ut-chart> <ut-saved-report> <ut-address> <ut-map> <ut-signature> <ut-rating> <ut-slider> <ut-rich-text> <ut-table> <ut-likert> <ut-progress> <ut-info-card> <ut-pdf-viewer>

Every official form control in one package: chart, saved report, address search, map, signature, rating, slider, rich text, table, survey and more.

Uses Google Maps PlatformOpenStreetMap

Officialv1.0.0
Download .utpkg 768 KBInstall in your workspace

About

What it does

Install the whole set of official UserTasks form controls at once. Each control lands in Extensibility → Form controls, enabled, and appears in the form designer's Custom palette, ready to drag onto a form.

The pack carries the controls only. The address search control needs a lookup source on the field (the single Address search package also ships the Google Places integration, API reference and a sample form), the map needs an administrator to approve its tile hosts, and the saved report and chart controls need a report chosen in the designer. Every other control works as soon as it is installed.

After installing

  1. Install the package: every control appears in Extensibility → Form controls and in the form designer's palette under Custom.

Reference

Controls in this bundle

  • Chart <ut-chart>

    Bar, line, area, pie or doughnut chart of static data, another field's rows, lookup results or a saved report. Keyboard-navigable points, a data table view, and optional point selection.

    value json · Lookups, Saved reports

  • Saved report <ut-saved-report>

    Shows a saved report as a sortable, paginated table or a chart, run with the permissions of the person filling in the form. Optionally pick a row as the field's value.

    value json · Saved reports

  • Address <ut-address>

    Address search with suggestions from the field's lookup source (e.g. Google Places, key kept on the server), stored as a structured address with coordinates. Manual entry as a fallback.

    value json · Lookups

  • Map <ut-map>

    An OpenStreetMap map that shows a location from another field (an address or coordinates) and, optionally, lets people drop a pin.

    value json · Network

  • Signature <ut-signature>

    Draw a signature with a finger, pen or mouse, or type a name. Saved as a trimmed PNG in the form's attachments.

    value files · Files

  • Rating <ut-rating>

    Star, heart or circle rating from 1 to 10 with optional labels (Poor … Excellent). Mouse, touch and keyboard.

    value number · self-contained

  • Slider <ut-slider>

    A range slider for numbers (0 to 100, $0 to $5,000, 1 to 10) with a value bubble, mark labels such as Low / Medium / High and an optional box for exact entry.

    value number · self-contained

  • Rich text <ut-rich-text>

    A rich-text editor with bold, italic, underline, headings, lists, quotes and links, a character counter and strict sanitising of everything typed, pasted or dropped.

    value json · self-contained

  • Table <ut-table>

    An editable table (line items, attendees, measurements) with typed columns: text, number, currency, date, choice and tick box. Per-cell validation, totals, and spreadsheet-style keyboard editing.

    value array · self-contained

  • Likert scale <ut-likert>

    Survey matrix: rate several statements on one scale (agree / disagree, satisfaction, frequency or your own labels), with optional N/A. A matrix on wide screens, one card per statement on phones.

    value json · self-contained

  • Progress <ut-progress>

    Progress as a bar, a ring or named steps, from two mapped fields (current and total) or fixed values, with optional warning / good thresholds.

    value number · self-contained

  • Info card <ut-info-card>

    A callout or key / value card: an info, success, warning, error or neutral message that can show up to six other form values ({{field1}} … {{field6}}), formatted for the reader.

    value string · self-contained

  • PDF viewer <ut-pdf-viewer>

    Shows a PDF inside the form (a contract, a quote, a policy) from an Attachments field or an upload: page by page, with zoom, rotation and the page text for screen readers.

    value files · Files

Capabilities and security

Lookups
Suggestions come from the field's lookup source — a data table, or an API reference the UserTasks server calls with credentials stored on the server. The control only sees the suggestions.
Saved reports
Rows of the saved report the designer chose (the field's report_id, read by the server from the stored form), run as the person filling in the form: only reports they can open, with their permissions.
Network
Fetches only from the hosts in its manifest, and only after an administrator approves them in Extensibility → Form controls. Until then the frame's CSP blocks every request. Map tiles come through the UserTasks server (public tile servers refuse the sandboxed frame's referrer-less requests), only once the tile host is approved. Hosts: tile.openstreetmap.org.
Files
Uploads go through the Attachments pipeline (the same checks and storage). Reads are limited to files the form already gives the control: its own value, or an Attachments field the designer maps.

Install

Install it in your workspace

Works on UserTasks cloud and any self-hosted instance. The control lands in Extensibility → Form controls, enabled, and appears in the form designer's Custom palette.

In the app

  1. Open Extensibility → Form controls → Browse gallery (it opens Packages → Browse gallery on the Form controls tab) and choose Install on Form controls starter pack. Or download form-controls-starter-pack-1.0.0.utpkg and drag it onto Automations → Packages.
  2. The wizard verifies the checksum, every file hash and the signature, and shows what it adds.
  3. In Extensibility → Form controls, an administrator approves tile.openstreetmap.org.
  4. Drag the control onto a form in the designer and set its properties.

With the CLI

shell
curl -fLO https://usertasks.com/gallery/form-controls-starter-pack-1.0.0.utpkg
usertasks packages inspect form-controls-starter-pack-1.0.0.utpkg
usertasks packages install form-controls-starter-pack-1.0.0.utpkg

Verify the download

File SHA-256
a4e12a06db91e667d3c90cfe3c48ce2717e9f5ced547947543b6b7692c9cb988
Package checksum (what is signed)
sha256:1d40189f57abc41e98183fe14adff5ccf97a4e17ee7023b7520d1a6f8e4f361b
<ut-chart> module SHA-256
8e2fa70f0ed224efdc4ecd46baf1dc0b9ce2b5ec3daf8f2b19bd3225775632db
<ut-saved-report> module SHA-256
b707875dba4f4f91e44c8c8bd619f509af1ad849b84cbf8548254888b16b2db1
<ut-address> module SHA-256
69a1d55d7e94f444db063ca40a7b4eb78ce21e5e1e0fdd6f53c64298f8ab7780
<ut-map> module SHA-256
eeb6bd6b75a81efdcd841a99eee5f06d20d04cc0aef97ee82d1ad025be3556e5
<ut-signature> module SHA-256
282ed77a356e22906a37841fcf668d37e5cc4434abcddde09245cbd6a1a4b010
<ut-rating> module SHA-256
cca111b0cc39e14362996667c085206d92c4409365f2dc1c5d5b3f5387678a64
<ut-slider> module SHA-256
3cbeabfb61838f3eef8e86555e51524fa953a3d1fa6174c6e3133302f7466063
<ut-rich-text> module SHA-256
18118557b71bb3bffa79b85bedcef2d0d1e95cf9be0810b8cae30d93e43f2cdf
<ut-table> module SHA-256
a97a72b35c8929d0692726855f27036eaae5e2b038b4c3fc4ff643967a948206
<ut-likert> module SHA-256
292f1b82ff9452052b5e9d710999d6f31b0f01474fd7418318dc7788bd869be6
<ut-progress> module SHA-256
ba08a02f66a291f23178d2356f1f80ebb75692929f48520c830fecff5b5b5281
<ut-info-card> module SHA-256
d3a73d3d2a4ef2005d91d02f87ccafe97b28578c701bc3f2d93de5ea70fea3e3
<ut-pdf-viewer> module SHA-256
25fc50254b2275adca2f4a3c386c300d808b9e9386dcb9185254f96da1dcf5b6
Signer
UserTasks Gallery · 49:f3:04:90:47:02:4d:07:28:61:3d:dc:bb:aa:db:11

More form controls

All controls