Dataset
What It Is
A dataset is the shared description of a kind of record that people can investigate. Contacts, organizations and accounting lines are examples. Staff encounter it as a choice of subject for a question, together with the fields and relationships that subject offers. Its identity follows the application and declared record kind, rather than the label a customer happens to display.
The owning application supplies the declaration. Platform brings those declarations together and resolves them with the workspace’s metadata and the reader’s access. This keeps the query vocabulary separate from any particular screen. A customer-defined label or additional field can become part of the description without changing the identity of the subject being queried.
A dataset therefore gives Product a useful boundary: which records can be investigated, what can be asked about them, and which authority permits that investigation. It does not transfer ownership of the records to Platform.
What It Is Not
A dataset differs from the stored records it describes. It also differs from a physical table: a record description can combine several sources or select a detail such as a preferred address. A saved question selects and filters that vocabulary. A report presents the result of saved questions. These distinctions matter because changing a presentation does not change the available data model or its owner.
How It Is Used
Staff browse datasets before building a question. The catalog includes unauthorized entries, making missing access visible without making those records queryable. An available dataset supplies the choices used by the designer and related list tools. Applications register their declarations during deployment and receive errors when a declaration cannot be accepted.
Rhythm staff use a separate system catalog for platform operations. They also maintain custom definitions for selected customers. Customers can activate custom objects whose datasets then become available within their workspace. All three forms provide a query subject, but their ownership and availability differ.
Its Facets
Fields. Values include ordinary record fields, custom information, calculations and selected collection details. Their types and supported operations determine how a question can use them.
Relationships. References and declared joins connect records without requiring the person to understand their storage. The reader’s access affects which related vocabulary is available.
Query permission. Dataset authority comes from its owner. Record-read and application access can add requirements beyond the query permission.
Scopes and discovery rule. A scope supplies an initial population, such as recently viewed records. Discovery defaults guide initial selection rather than silently changing submitted questions.
Defaults. Suggested columns, criteria and ordering make the first arrangement useful while remaining distinct from the actual request.
System dataset. HQ subjects describe platform records across customers and remain separate from customer record subjects.
Custom query table. A published tailored definition appears as a dataset where its assignments allow it. Its lifecycle and publication health affect continued use.
Custom object dataset. Workspace-defined records use their own scoped access and metadata.
Description. The resolved description supplies current labels and choices to clients, including changes that invalidate a cached description.
How It Relates
Queries name datasets; reports and scheduled files depend on those queries. Search uses dataset projections to build a separate index. Export coverage records declared extraction subjects separately. CRM, Accounting and other applications remain responsible for the records being described.
What It Could Become
The product should decide how future field and record restrictions fit this vocabulary. Tailored datasets also need clear authority for later administration features. Any expansion should preserve the distinction between describing records, permitting access and presenting a result.