dFlow~IQ manualChapter 07 · Application guide

Define and run Kafka integration tests

Publish bounded UTF-8 fixtures, observe only post-baseline output and evaluate exact, field, schema and absence assertions.

DOCUMENTED VERSIONdFlow~IQ Community 1.0

First-party product documentation. Instructions are verified against the dFlow~IQ desktop implementation. Labels appear exactly as they do in the application where practical.

07.1

Understand the test boundary

  • Manual and same-cluster only.
  • Timeout from 1 to 120 seconds; default 30.
  • 1 to 1,000 fixtures, at most 4 MiB total.
  • 1 to 100 assertions across at most 20 output topics.
  • At most 10,000 observed records and 32 MiB.
  • Runs and reports are not retained.
07.2

Add input fixtures

Input topic

Where the UTF-8 fixture is published.

Key (optional)

Blank produces a null Kafka key.

Publish as tombstone

Produces a null value.

Value

UTF-8 fixture body.

Headers

One name=value per line; name alone creates a null-valued header.

A keyed tombstone on a compacted topic represents deletion intent. Use it only when the scenario explicitly requires it.

07.3

Choose assertions

Exact record count

Passes only when post-baseline count equals the expected number.

Key equals

At least one new record must match the key.

Header equals

At least one new record must contain the expected header.

JSON field equals

Supports dotted fields and numeric array indexes.

Schema valid

Requires Registry framing and successful decoding; JSON Schema content is also validated.

Expected absence

Passes only after the full timeout without a new matching record.

07.4

Preview, confirm and run

  1. Save test.
  2. Select Preview test and review byte totals, topics, fixtures and assertions.
  3. Type the exact case-sensitive test name in Confirmation.
  4. Select Run test.
  5. dFlow~IQ captures output end offsets, publishes fixtures and evaluates only later records.
  6. Review PASS, FAIL or TIMEOUT and each assertion message.

Any edit or cancellation invalidates the preview. Save required result evidence before leaving the screen because reports are memory-only.

Documentation reference

Current dFlow~IQ Community desktop implementation and bundled UI labels, reviewed 13 August 2026. Product behaviour takes precedence if a later release differs from this page.