Query Smart Component

Query Smart Components are a type of Smart Component that retrieves submission data. Instead of writing query logic directly, Creators describe what data they need in plain language. The UnqorkAI Build Agent generates the underlying query and creates or reuses a Smart Component to satisfy the requirements.

Query Smart Components are available to all AI-enabled environments.

How to Use Query Smart Components

To create a Query Smart Component, do the following:

1. Open a module in the Module Builder.

2. Describe the data requirements to the UnqorkAI Build Agent. For example:

   "Create a query that accepts a status input parameter and retrieves submissions from schema 622131946701db01afdd79e8 where the status field matches it, sorted by creation date descending and limited to 10 results. Display the results in a table. The query should fire automatically whenever the status value changes."

3. The Build Agent creates or reuses a Smart Component to retrieve the data.

Data Access

Query Smart Components retrieve submission records. At launch, Query Smart Components support read operations only. Create, update, and delete operations are not supported.

Data Privileging

Query Smart Components do not use Unqork User Groups or schema module RBAC settings. To control data access, apply restrictions at the application layer through server-side execution.

Express RBAC controls are available at the query level. Administrators can assign invocation privileges to Express Roles, restricting which roles can invoke a specific Query Smart Component.

For more information on data access controls for Query Smart Components, contact your Unqork representative.

Limitations

• Read-only at launch: Create, update, and delete operations are not supported.

• Maximum records: Queries return a maximum of 10,000 records.

• File references: Query Smart Components do not refresh authentication signatures on file links. To retrieve a working file link from a submission, use the /getSubmissions API.

• Data Models: Unqork Data Models are not supported at launch.

• AI-enabled environments: Query Smart Components require an AI-enabled environment.

The /getSubmissions API continues to work as it does today.