How do I search documents by several metadata fields at once?
Use FormKiQ's supported attribute-search operations to express the combination of fields you need, with types and indexes appropriate to the query. Composite keys support configured multi-field access patterns; they do not make every arbitrary filter equivalent. Full-text combinations depend on the selected search backend. Follow pagination tokens to retrieve the complete result set.
Design around a real query
Write the business question first: find invoices for a selected vendor and accounting period, for example. Define stable attribute keys and consistent value formats. Preserve numeric values as numbers rather than strings when numeric comparisons are required.
Use the multi-attribute tutorial to configure the attribute filters and optional composite-key structure for the actual access pattern. Check the API schema for supported operators, ordering, and combinations. A JSON object's nested-field query is a different request shape from a regular attribute search.
Prove completeness
Create documents that match all fields, only some fields, and boundary values. Confirm the response contains only the intended matches. Treat returned continuation tokens as opaque and follow next using the same filters and site until no continuation remains.
When combining content text with metadata, use an operation supported by the installed backend. Measure latency and pagination under representative volume before promising interactive reports from an unbounded search.
Edition and configuration
Structured metadata search is available in Core. Multi-attribute filtering and composite-key selection are version-specific; OpenSearch is a separate Advanced/Enterprise extension. Check the installed release rather than inferring support from the SDK alone.