Skip to content
Skills Library
Programming · Building & coding

builder-data-scopes

/builder-data-scopes

Choose, implement, or debug Application Builder DATA_SCOPES for element formulas and data providers, including visibility, collection property pickers, form inputs, and nested row actions. Do not use for database view scopes or unrelated formulas.

Repository
baserow ↗
Licence
MIT
Last repository change
27.10.2026

Assessment and security

100/ 100Class: good
Format25 / 25
Frontmatter with name and description, valid name, description up to 1,024 characters, name matching the folder.
Discoverability25 / 25
Description explains when to use the skill, has a reasonable length and uses third person.
Content35 / 35
At least 150 words and at most 500 lines, headings, step lists, examples or code.
Hygiene15 / 15
No placeholders such as TODO, no Windows paths, with a licence.
Riskno signals detected in the scan
Files in this package
1
Scripts
0
HTML comments
0
URLs in SKILL.md
0
Deprecation

No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.

Licence

MIT, open: use and modify while retaining author attribution.

What it does and when to use it

Choose, implement, or debug Application Builder DATA_SCOPES for element formulas and data providers, including visibility, collection property pickers, form inputs, and nested row actions. Do not use for database view scopes or unrelated formulas.

Original author description

Choose, implement, or debug Application Builder DATA_SCOPES for element formulas and data providers, including visibility, collection property pickers, form inputs, and nested row actions. Do not use for database view scopes or unrelated formulas.

How it works

  1. Choose the scope at the caller
  2. Follow the collection chain
  3. Test the boundary
Original SKILL.md headings · 32 lines, 424 words
SKILL.md preview
---
name: builder-data-scopes
description: Choose, implement, or debug Application Builder DATA_SCOPES for element formulas and data providers, including visibility, collection property pickers, form inputs, and nested row actions. Do not use for database view scopes or unrelated formulas.
---

# Builder data scopes

Use this skill when a Builder formula or data provider sees too much data, too little data, or the wrong collection row. Read the current definitions in `web-frontend/modules/builder/constants.js` and the relevant caller before changing a scope.

## Choose the scope at the caller

`applicationContext.dataScope` describes what is available relative to the formula's target element. Choose it for the **formula location**, not just the element type. Keep the named compound scopes in `constants.js`.

- `EXCLUDE_TARGET_SUBTREE`: exclude the target and its descendants. Use for visibility conditions, which must not depend on data inside the element they decide to show. Ancestor data remains available.
- `INCLUDE_TARGET_DATA_SOURCE`: include the target when finding a collection data source, but do not follow the target's `schema_property`. Use while choosing that property in a collection form.
- `INCLUDE_TARGET_ELEMENT`: include the target, its descendants, and its schema property. Use for formulas that need the current row, such as table fields and record-selector option suffixes. Form submission also needs access to inputs inside the form.

These scopes set independent flags: target element, target descendants, and target schema properties. Do not assume one flag implies another. Page-level contexts currently start with `EXCLUDE_TARGET_SUBTREE`; callers that need target data opt in explicitly.

Examples:

- A form's visibility formula uses `EXCLUDE_TARGET_SUBTREE`: it may read data outside the form, but not inputs inside it. Form submission must include those inputs.
- A table field formula uses `INCLUDE_TARGET_ELEMENT` to read its current row; the table's show-more label uses `EXCLUDE_TARGET_SUBTREE` because it has no current row.
- A record selector's option suffix uses `INCLUDE_TARGET_ELEMENT` to read the current option. Its label and visibility formulas must not see that option.
- A collection's property picker uses `INCLUDE_TARGET_DATA_SOURCE` to find its data source without following the property currently being selected.

## Follow the collection chain

A nested collection may have no `data_source_id`: its rows can come from a `schema_property` on an ancestor's row. Find the nearest ancestor with a data source, then follow each nested property and row index. Frontend action dispatch sends the full `index_path`; the backend derives `current_record.__idx__` from its last entry. Do not reduce that path to one index when resolving nested actions.

Relevant code: `web-frontend/modules/builder/dataProviderTypes.js`, `elementTypes.js`, `mixins/collectionElementForm.js`, and `backend/src/baserow/contrib/builder/data_providers/data_provider_types.py`.

## Test the boundary

Assert actual formula values and picker choices, including both allowed and excluded data. Cover a table inside a repeat, a repeat child, record-selector options versus visibility, form submission versus form visibility, and a button action in a property-backed table. Use different parent and child values so the wrong scope cannot pass unnoticed.

Versions

The database has no other skills named builder-data-scopes.

Database snapshot: 13.11.2026 · package version a2b4cc131fdf (SHA-256 digest of the entire package)

Downloads in the last 30 days: 0 · ranking

Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.

Similar skills

  • 100test-data-builder
    Test Data Builder - Auto-activating skill for Test Automation. Triggers on: test data builder, test data builder Part of the Test Automation skill category. Use when writing or running tests. Trigger with phrases like "test data builder", "test builder", "test".
  • 100create-update-service
    Create or update Baserow integration and service types, including services exposed as Application Builder data sources, Builder workflow actions, Automation node actions, Automation node triggers, or dashboard data sources. Use when adding a ServiceType/IntegrationType subclass,…
  • 90datasets
    Use when a collection needs queried or joined test inputs, a reusable named view, spreadsheet worksheet data, live database rows, or script access through pm.datasets(). Chooses between a simple iteration file and a dataset while preserving query semantics, portability, and…
  • 90Add Or Update Builder Element Type
    Add or update a Baserow Application Builder element type across backend models, backend ElementType registration, frontend element registry/components/forms/icons/translations, migrations, and targeted tests. Use when creating or changing an element shown in the builder…
  • 100appbuilder-action-scaffolder
    Create, implement, deploy, and debug Adobe Runtime actions with consistent layout, validation, and error handling. Use this skill whenever the user needs to add actions to an App Builder project, understand action structure (params, response format, web/raw actions), configure…
  • 100frappe-web-form-builder
    Generate Frappe Web Forms for public-facing forms. Use when creating customer portals, registration forms, surveys, or public data collection forms.

Feedback and reports

Your message goes to Bartosz Sokoliński. An email address is needed only for a reply. See the privacy policy.