Clarity is Truegility’s data platform for turning isolated, distributed business data into governed, reusable building blocks and trustworthy reporting. At the core are two ideas: Databooks, where you define and manage slow-changing “master data light” such as dimensions, hierarchies, and mappings, and Reportbooks, where you assemble that curated data into consistent, reusable report experiences in Power BI.
Use the Databooks section of this site to learn how to design and govern the tables that drive your semantic models, then move to the Reportbooks section to connect those tables into robust, shareable reports.
If you are new to Clarity, skim both sections first to anchor the concepts, then follow the workflow page that matches your role, whether you are shaping master data, wiring up models, or publishing finished reports to your business users.
Use Databooks to store and maintain the slow-changing tables that drive your reporting, such as dimensions, reference lists, and business hierarchies. Databooks handle typed columns, validation, hierarchies, generated IDs, and the push process that keeps downstream semantic models in sync.
Think of Databooks as “master data light”: they give you central control over definitions without the overhead of a full enterprise MDM system. Databooks are optimized for relatively stable, curated data and should not be used for high-volume transactional or log data such as events, telemetry, or detailed fact tables.
Use Databooks when you need a governed, shared definition of what things are, not a raw history of what happened.
Create a databook, import source tables, configure columns, validate data, and save the finished structure.
Build custom hierarchies, reorder members, rename values, and filter rows directly from the hierarchy tree.
Use generated IDs, hierarchy-driven defaults, and custom forms to speed up manual data maintenance.
Use hierarchy order columns from Clarity so business labels sort the way you expect in Power BI visuals.
Edit master data, push changes to linked semantic models, and confirm the update in your reportbook.
Use Reportbooks to curate pages from one or more Power BI reports into a single, coherent navigation experience. Reportbooks help you organize pages, apply filters across reports, replace source reports, and share a consistent view with other users.
Reportbooks are especially useful when you want an executive or cross-functional audience to consume multiple reports as one governed analytics experience instead of a collection of separate links. Use them when users need a single entry point into related Power BI content rather than a set of individual reports with disconnected navigation and filters. If your scenario is a single self-contained report with no need for cross-report navigation or shared filters, a standalone Power BI report may be sufficient.
Create a reportbook, add report pages, rename sections, clone pages, and save shared filter defaults.
Swap an outdated Power BI report for a new one without losing reportbook structure or bookmark references.
Apply one filter above the report level so every page in a multi-report reportbook stays aligned.
| Role | What they usually do |
|---|---|
| Data owners | Create and maintain Databooks, manage validation rules, review validation errors, update master data, and push changes downstream. |
| Report builders | Create Reportbooks, add pages from workspaces, set global filters, and keep report navigation clear and aligned with business scenarios. |
| Report viewers | Open Reportbooks, apply or reuse filters, move between pages, and export or share the final view. |
| Admins | Manage folders, permissions, row-level security, and deployment, environment management, or support workflows around the platform. |
This page gives a high-level overview of Clarity concepts. For step-by-step guides and examples, use the Databooks and Reportbooks sections in the left-hand navigation.