79 lines
4.1 KiB
Markdown
79 lines
4.1 KiB
Markdown
# Reporting User Guide
|
|
|
|
## Open and run a report
|
|
|
|
Open **Reporting** at `/reports` and choose a report from the left catalogue.
|
|
The catalogue separates source-module reports from Reporting semantic reports.
|
|
The header identifies the immutable report revision that will be used. Select a
|
|
summary, detail, or pivot shape, choose dimensions and measures, enter any
|
|
report parameters, and select **Run**.
|
|
|
|
Only rows authorized for the current tenant and principal reach the query
|
|
engine. A successful result shows its authorized row count, visualization,
|
|
and table. When a saved chart does not match an ad-hoc query, Reporting shows
|
|
the accessible table fallback instead of changing or rejecting the query.
|
|
|
|
Summary and pivot rows expose a detail action. Selecting it creates a short-lived,
|
|
account-bound drill context, rechecks the report, semantic model, dataset, row
|
|
policy, and source fingerprint, and then displays only the authorized contributing
|
|
rows. The path above the table records every aggregate dimension used for the
|
|
drill. If the source changed, run the report again rather than treating stale
|
|
aggregate and detail states as equivalent.
|
|
|
|
## Inspect evidence
|
|
|
|
The right panel lists previous runs and definition/source pins. Select an
|
|
earlier run to inspect its retained result. Content and output hashes identify
|
|
the exact definition and output. Warnings explain freshness, inferred schema,
|
|
or provider diagnostics. A failed quality gate records a failed execution and
|
|
does not publish a result.
|
|
|
|
A report configured against an exact published Dataflow run reads that run's
|
|
immutable Datasource materialization. It does not rerun the flow with current
|
|
inputs. The evidence identifies the Dataflow run and materialization, and access
|
|
to both is checked again when the report runs. CSV export therefore provides an
|
|
Excel-readable publication of the exact authorized Dataflow result, with
|
|
spreadsheet formula markers escaped and the run lineage retained on the
|
|
Reporting execution.
|
|
|
|
The **Effective access** explanation states when dimensions, measures, source
|
|
rows, or actions were removed by Policy. A result with no hidden elements says
|
|
so explicitly; catalogue visibility never grants access to protected detail.
|
|
|
|
## Save and export
|
|
|
|
Use **Save current view** to keep the current query under your account. Saved
|
|
views do not alter the report definition. CSV and JSON downloads contain only
|
|
the authorized result of the selected execution. CSV values that begin with a
|
|
spreadsheet formula marker are escaped.
|
|
|
|
Users with scheduling permission can create an hourly, daily, weekly, or
|
|
30-day interval from the current revision, parameters, and query. Scheduled
|
|
runs continue to use those exact pins until the schedule is edited.
|
|
|
|
The Schedules panel can pause or resume each schedule with optimistic revision
|
|
checking. Users with publication permission can publish a successful execution
|
|
to Files or Mail. Files stores CSV, JSON, or accessible HTML through managed
|
|
artifact storage. Mail submits a bounded report notice through its durable
|
|
outbox and requires a usable profile, sender, and recipient. Unavailable targets
|
|
remain explained but cannot be selected as a valid destination. Publication
|
|
history records the target, result, time, output hash, and provider evidence.
|
|
|
|
When Dashboard is enabled, the **Reports** widget lists active reports without
|
|
copying result data into Dashboard. Its item limit is configurable per widget.
|
|
|
|
## Run a module report
|
|
|
|
Module reports retain their source module's access rules. Select the source
|
|
object and any optional parameters, enter the concrete purpose for the run,
|
|
and verify the effective tenant audience before selecting **Run**. Reporting
|
|
will refuse a result that does not carry the declared privacy transforms,
|
|
source revision, and tenant scope.
|
|
|
|
The result groups declared metrics and details without exposing undeclared
|
|
provider data. The Governance panel explains the risk class, permitted export
|
|
formats, retention ceiling, contract version, and required privacy transforms.
|
|
An export records a separate purpose, actor, audience, time, format, and output
|
|
hash. A missing or restricted module report is not replaced with a less
|
|
protected client-side query.
|