Appearance
v10.02 Release Notes
About 5180 wordsAbout 17 min
2026-11-16
10.02 is the first release after 10.01 (November 3, 2026). This note covers every change since 10.01.
10.02 brings the numbers to people. Subscriptions send a dashboard on a schedule and metric alerts send a message when a measure crosses a line, by email, as a direct message in WeCom, DingTalk, Feishu, Slack or Microsoft Teams, or into a group channel; people can also ask data questions in those IM apps. The audit log is rebuilt: records go to the database, retention is enforced, and three usage dashboards show who uses what. Backup and restore checks a backup before restoring it and puts everything back when a restore fails. Reports without a mobile layout get one automatically, claude.ai and ChatGPT connect after one click in Datafor instead of a pasted token, and tenants get their own time zone, an AI user limit and an administrator password that is set when they are created.
Read Upgrade notes before you upgrade: the earlier alert API and the WeCom plugin are removed, auditing turns on where it was never configured, personal tokens unused for 90 days stop working, and existing tenants need Repair permissions and an AI user limit.
Highlights
1. Subscriptions and metric alerts
- Subscribe in a dashboard's toolbar sends the dashboard on a schedule (daily, workdays, weekly, monthly, or only on Run now): a screenshot, the values of its cards, a PDF, Excel files of up to five tables, and an optional AI brief, for the whole page or one tab, in the desktop or mobile layout. Filters follow the report's defaults or use the report's own relative dates, such as Last Month, recalculated at every send. Send me a test sends it to you only. The editor warns when the owner has no permission on a model the dashboard uses.
- Each person gets their own data. A subscription is rendered with each recipient's permissions, row-level security included; people with the same permissions share one render. A message posted to a channel is rendered once with the owner's permissions.
- Metric alerts check one measure hourly, daily, weekly or monthly and send only when a condition is met: above or below a value, outside a range, a change against the previous period or the same period last year, no new data for N days, or unusual movement. Periods are calendar periods such as Last month or This year (to date), or the latest period that has data (Latest month with data). Check separately evaluates each member of a field, for example each region. An alert notifies once when it becomes abnormal or keeps reminding, can notify on recovery, and can attach an AI breakdown of what drove the change. While you edit, the editor checks the condition against current data and says whether it would fire. Values in the message use the measure's own number format.
- Start an alert from ⋮ › Set alert on a chart, from Set alert on a Metrics Library metric, or by asking the AI assistant in a dashboard, for example tell me when net sales drop more than 10% month on month. The assistant does the same for subscriptions (send me this dashboard every Monday at 8): its suggestion card opens the editor with the fields filled in, repeats the suggestion at the top, and marks the period or filters Check this, because those are not filled in for you.
- Readers can subscribe for themselves and set restricted alerts on charts they can see.
- Recipients are people and roles; a role is expanded at every run. Each person chooses how to receive in My account › My subscriptions & alerts › How I receive: email, a direct message in a connected IM app, or both. Post to channels adds Slack and Teams channels and the group robots and webhooks an administrator has set up.
- Your own list: My account › My subscriptions & alerts shows under Created by me your subscriptions and alerts, dashboard and paginated report subscriptions in one table, and under Sent to me what other people send you. Turn Receive off to stop getting one; the owner sees that you stopped, and you can turn it back on. Every message links to Manage what I receive. On a phone the lists show as cards.
- Administrators use Settings › Notifications › Subscriptions & alerts, with Overview, Subscriptions, Alerts, Run history and Settings tabs. The overview lists only the problems an administrator has to fix; problems the owner can fix go to the owner. Administrators can edit and delete anyone's subscriptions and alerts and Transfer one or several to another owner, who then runs them with their own permissions; both owners are notified. Settings holds the default receiving method, limits per user type, message templates with a preview, AI budgets and retention.
Subscriptions and alerts are the datafor-notify plugin. Screenshots, PDF, Excel and the AI brief come from a new render service installed with the AI Agent; without it a subscription sends its message and link only. See What the server needs.
Understanding Subscriptions and Alerts · Subscribing to a Dashboard · Metric Alerts · Managing Your Subscriptions and Alerts · Setting Up Delivery · Delivery Channels
2. IM platforms
- Settings › Notifications › IM platforms connects Datafor to WeCom, DingTalk, Feishu, Slack and Microsoft Teams apps, with a setup guide per platform, Check credentials that shows the platform's own error code, and a test message.
- Direct messages carry subscriptions and alerts as cards with Open report, and for alerts Ask the AI assistant and Silence. Teams cannot receive files, so attachments come as download buttons.
- Ask questions in chat (all platforms except Teams): the answer is calculated with the asker's permissions, clarifications are answered by number, and a reply within 30 minutes is a follow-up. Chat commands list, pause and resume subscriptions and alerts and silence alerts.
- Sign-in and linking: in WeCom, DingTalk and Feishu, opening the app signs the person in to Datafor; the first time they link their account once. Slack and Teams accounts are matched by email. Directory sync links members to Datafor users on a schedule and can create Reader users.
- Settings for all apps (receiving messages, asking in chat, creating Readers during sync, messages per person per minute) are changed on the page, without a restart.
- Sync history says per run who was created, re-linked, left unmatched (with the reason) or marked as left, which fields the platform returned, and which permission the app is missing. A run that could not read all members marks nobody as left, and guests are never created as users.
- Answers in chat end with Continue in the Datafor AI assistant. An empty result, or a question the model cannot answer, gets a reply that says so. New credentials take effect without a restart.
This replaces the earlier WeCom integration; see Upgrade notes.
IM Platforms · Using Datafor in IM Apps
3. Audit log
Settings › Operations › Audit log is rebuilt, with three tabs:
- Overview shows three dashboards built from the audit records: Platform usage overview (active users, report opens, exports and AI questions), Content usage (most opened and slowest reports, reports nobody has opened for a long time) and Security and exceptions (failed sign-ins, failed operations, top exporters, changes to data security, data sources, tokens and system settings). They are read-only, also for administrators.
- Activity lists the records with filters for time, user, operation, result, keyword and object, and quick filters per kind. A record opens a details panel with the changed values, and for a move or rename the Original location and New name; failed sign-ins show the reason, such as Wrong username or password or Wrong verification code, and people who were not signed in appear as Anonymous visitor. Results export to CSV. View activity in the row menu of content, models and data sources opens the records of that object; users have View this user's activity and View changes to this account.
- Settings chooses what to record by kind: Sign-ins and changes (always on while auditing is on), Viewing (report and share-link opens, AI questions) and Scheduled tasks (runs of subscriptions, alerts and directory syncs), each with its share of the last 7 days and its list of operations. Viewing and scheduled tasks can be kept for fewer days than sign-ins and changes. Turning recording off or shortening retention asks for confirmation first, with the number of records that will be deleted.
What changes underneath:
- Records are stored in a database table instead of
PentahoAuditLog.log, and expired records are deleted every day. - New operations are recorded: failed sign-ins, also on the sign-in page, sign-outs with the reason (sign-out, timeout or server shutdown), copying, moving, renaming, restoring and permanently deleting reports and folders, creating, changing, disabling, importing and deleting users, password changes and resets, roles, access permission changes on reports, folders, data sources, models, tokens and AI services, backups and restores, subscriptions, alerts (including transfers and stopped receiving), IM apps, and AI questions (without the question text). Share records name the shared report.
- Opening the audit dashboards is recorded as View audit statistics, not as a report open, and they do not appear under recent items on the home page.
- Exporting a component to Excel or CSV and exporting a paginated report are recorded as Export data, with the report.
- The dashboards leave out what the server does on its own: the render service opening a dashboard for each recipient of a subscription or alert does not count as report opens or sign-ins. Anonymous visitors of share links are not active users.
- Statistics count days in each tenant's time zone.
- Administrators see a notice in the console when auditing is off, when records cannot be written, or when storage at full retention would exceed the warning level.
4. Backup and restore
- Content and settings are exported with
pg_dump, a consistent snapshot taken while Datafor keeps running. Each package carries a manifest with the version, the parts and a checksum of each export. - Before a restore stops anything, Datafor checks the record, the file, the package and the restore script; if a check fails, it says why and keeps running. The restore backs up the current state first (optional), renames the current databases and folders instead of deleting them, and puts them back if any step fails. The result is shown at the top of the page after the restart.
- The page shows how old the last backup with content and settings is (red when there is none, with Create a daily backup schedule), the source, size and duration of each backup, and files that are missing from disk. Schedules can be paused and resumed and run at once.
- Backup settings: the backup folder, and who is notified when a backup or restore fails (needs the subscriptions and alerts plugin). The 3 most recent backups with content and settings are always kept, whatever the retention period.
- When the repository databases are on your own PostgreSQL server, Content and settings is skipped and the page says so.
5. Automatic mobile layout
- Reports without a mobile layout work on phones. Their components are arranged from the desktop page in reading order: the page title, then filters, small filters and cards two per row, charts, tables and maps at full width, the contents of Tabs in the same tabs. Components on the same background shape stay together, and shapes with text become labels; empty shapes and lines are left out. Earlier, phones showed the desktop page.
- The mobile designer starts from it. It opens with the generated layout on the canvas; adjust it and save. Auto layout in the header of Components rebuilds the layout from the desktop page at any time.
- Desktop page on phones is still possible: empty the phone canvas, for example with Clean all, and save.
6. AI clients sign in with one click
claude.ai custom connectors and ChatGPT apps no longer ask for a pasted personal token. The browser opens a Datafor page that names the app and the site it returns to; click Allow, and Datafor creates a personal token for the app, listed as AI client · app name under My account › Personal tokens. If you are not signed in to Datafor, you sign in first and come back to the page. With an older Datafor server, the MCP server falls back to the paste-a-token page.
Connecting an app again replaces its earlier connection and revokes the old token; the token is named AI client · app name · date. Personal tokens are valid for at most one year and stop working after 90 days without use (status Inactive). Users of tenants connect with the same address and are signed in to their own tenant.
Report editor and viewer
- Component menu › Visible to readers hides single toolbar buttons from readers, such as the drill-through or drill-down switch, Conditions or More, instead of hiding the whole toolbar. The editor always shows every button. A component whose drill switch is hidden keeps the interaction mode it was saved with.
- Drill through no longer shows the Drill-through filters bar or adds
__drillBackand__drillPopupto the address. The clicked members are set on the target page's filter for the same field, so readers can change them or choose All. Values that cannot go into a filter (exclusions, expressions, date or numeric ranges, filters bound to a parameter, levels below the first) still filter the page without being shown. In the SDK,drillFiltersstill reach the host. - Empty components show only the message, without View conditions or Clear links buttons. Their toolbar appears on hover as for any component, and Conditions lists the conditions and clears links. See Empty Data and Error Messages.
- Subscribe in the view toolbar and Set alert in a component's ⋮ menu appear when the subscriptions and alerts plugin is installed. Set alert fills in the field captions the chart shows.
- Component toolbars sit above chart tooltips, and their buttons are easier to hit.
- Dialogs fade in and out together with their backdrop instead of flashing.
- Save is the highlighted button of the editor. Leaving the editor for another console page with unsaved changes asks first, also when the editor was opened with a report's Edit.
- The Date component's Write to parameter lists parameters by name, marks global ones and greys out numeric ones. A single-select Dropdown with search puts the selected name into the search box when it opens.
- The first report opened after a restart loads faster: the viewer's scripts load in parallel and stay cached across restarts.
- Decomposition tree: + appears when you point to any node, without selecting it first.
- Dimension field card: new List multiple values option. Cards created before 10.00 show only the first value again, as they did before.
- Default titles follow drill down and drill up, for example Sales by Province after drilling down from Region. Titles you typed stay as they are.
- Script editors no longer open in Vim mode, and the Vim switch is gone.
- An action script with a syntax error makes the component show Failed to load data with Details naming the script, instead of leaving it blank.
- Custom page CSS that you clear is removed at once, and no longer carries over to the next report opened in the console.
- The mobile designer's phone frame is drawn as a full-screen phone.
- Month and weekday names in time axes and calendar charts follow the interface language in Traditional Chinese, Japanese, French, German, Spanish, Italian and Portuguese; Traditional Chinese texts are reviewed for Taiwan usage.
Charts and tables
- HTML in table cells and headers, and in Hierarchy table filters: links, bold text and styled tags show as intended again; scripts, event attributes and
javascript:addresses are removed. 10.01 showed such content as source text. - Column and bar charts: labels outside negative bars sit at the end of the bar.
- Long axis names are cut with an ellipsis instead of overflowing the chart.
- Line and area charts: a marker size of 0 hides the markers.
- Combo charts: Data labels apply to columns or lines works per series.
- Heat matrix: axis names set in the Style panel are used.
- Grouped pie: the font color of inside labels applies; switching back to outside labels leaves no padding.
- Reference lines and bands included in the axis range no longer push a column chart below zero.
- Gauge: negative horizontal and vertical offsets move it left and up.
- Ring progress: a negative value leaves the ring empty and keeps the minus sign in the label.
- Dynamic image keeps not an image address and image failed to load after you change its empty-data settings.
- The AI insight button's corner radius applies when the report opens.
- Component filter advanced conditions accept values with brackets, dots and quotes.
- Mapbox geocoding looks for administrative areas first, so city names such as Chengdu or Nanjing no longer land on similarly named places abroad. Clear the Mapbox geocoding cache once after upgrading (see Upgrade notes).
- Tree table exports to Excel have the right header in the tree column.
- CSV export: empty row headers stay empty instead of repeating the row above, and whole numbers have no
.0.
Paginated reports
- Distribution is now Subscriptions, and the distribution list is the recipient list.
- Delivery goes through the subscriptions and alerts plugin: each recipient receives the way they chose in My account, subscriptions can Post to channels, recipients can be roles, and the schedule offers Workdays. Attachments too large for a message become links that need sign-in, and the message ends with Open report. Before saving, the editor lists who would be skipped and the next run.
- Different parameters per person replaces the copies per list entry: fill in a table in the editor, import it from Excel or CSV (a Recipient column, Download template, problems listed by row after the import), or keep using SQL. When the report takes the current user as a parameter, each person gets a copy with their own user name.
- Parameters are set in the subscription editor, with the same panel as the viewer; relative date defaults you leave alone are stored as keywords. A subscription that produces one file per parameter value says so in the message, for example One file per Region, 6 in total.
- The subscription list shows the first problems of a failed run on hover; a click opens its runs.
- Send me a test; a subscription that fails 5 times in a row on schedule turns itself off and the owner is told. Run history notes recipients who stopped receiving it.
- Times are in the tenant's time zone. Paginated report subscriptions also appear in My account › My subscriptions & alerts and on the administrators' page, with their run history.
- The viewer shows Edit only to people who can edit the report, and uses the same Subscribe icon as dashboards. Scrollbars are always visible.
Paginated Report Subscriptions
Console, modeling and data
- Settings has a Notifications group: Email, IM platforms, Delivery channels and Subscriptions & alerts. Access & Integration keeps single sign-on, site address, embed tokens and cross-origin access. Trusted domains moved from the site address page to Cross-origin access (CORS).
- Time zone in Settings › General › System configuration: the Platform time zone (default tenant, platform administrators only; by default the server's zone) and, in every other tenant, a System time zone that follows the platform or is set by the tenant's administrators. It is used by subscription, alert and paginated report schedules, relative dates, message dates, IM and audit statistics. See Time zone.
- The Empty data message in System configuration applies to every report and component without its own text when it opens, not only to new reports. Auto-build knowledge index moved to the top of Settings › AI Agent › Knowledge indexes.
- Branding has a Primary color for the console's buttons, links and selected items. Reports, the editor and the viewer keep their colors.
- Settings pages with long lists scroll.
- SQL views in the modeler explain why SQL failed (table not found, column not found, syntax, permission) and why the read-only check refused it. A table on the canvas whose fields cannot be read shows the reason.
- Lineage no longer counts a data source as missing because a non-administrator cannot read it.
- Modeler: the Usage section of the property panel and the not used by any report diagnostic are removed; delete confirmations open at once and fill in the affected reports and metrics when the check returns. Picking another Data source for a model that has tables asks first and names the tables the new source lacks. The Schema list shows which schemas the model uses, with their table counts. A table that the data source does not have is a diagnostics error. Rename alias reports empty and duplicate aliases under the field.
- File datasets: names are unique across the server, and the uploads, original files and previews of a dataset need Edit on it.
- Metrics Library: Generate from model lists only models you can edit.
- The model behind the audit dashboards is a system model and cannot be opened in the modeler.
- Branding: choosing a sample page loads folders level by level instead of reading the whole public tree.
- My account › Report downloads and the file list of file datasets keep their action columns visible in narrow windows.
- Password reset accepts the email address as well as the user name.
- Moving a report or folder in the console needs Delete permission on it, as deleting does, and updates lineage. Move and Copy to are offered only to people who can use them.
- Labels are consistent across the console: Data sources with the Database connections tab and Test connection, Created, Created by, Last modified, Location, and Enabled instead of Active. The admin account cannot be selected for bulk actions on Users.
AI Agent
- Action proposals: in a dashboard or on the console's AI assistant page, the assistant can propose a subscription or an alert; Create opens the editor, and nothing is saved until you save it.
- IM channel: questions asked in IM apps run as the asker and count against their daily AI quota.
- Alert analyses run as background tasks with their own daily budget on the AI Agent operations page and do not count against anyone's personal quota; neither do AI briefs. The operations summary splits usage by channel. See Quotas for the subscriptions and alerts side.
- AI questions are recorded in the audit log (operation, user, channel; not the question).
/biagentreadsq=andmodel=from the address to prefill a question.- A model named in the question is used, by name or full title; Metrics Library bindings no longer move the question to another model.
- Traditional Chinese texts no longer fall back to Simplified Chinese.
Multi-tenancy
- Time zone per tenant, see Console, modeling and data.
- New tenant asks for the tenant administrator's password (generated, editable) and shows it once with the sign-in address. Reset admin password gives a locked-out tenant administrator a new one. There is no default password any more.
- AI User Limit per tenant. The limits of all tenants must fit the license, and inside the tenant the limit is checked when AI is turned on for a user. Seat and AI limits cannot be saved above the license or below current use.
- The end date is a date or Follows license.
- Repair permissions fixes tenants whose template files still point at the default tenant's roles, so that their users see the template's models and connections again.
- Disabling or deleting a tenant signs its users out at once and blocks every way of signing in, including tokens, single sign-on, LDAP and IM apps.
- The Site URL is one value for the server; tenant administrators no longer see it. Embed token configurations and AI services belong to the tenant they are created in. A platform configuration with Share with all tenants lets tenant users create personal tokens and connect AI clients.
- Tenant users whose session expires return to their tenant's sign-in page. Forgot password finds tenant users by email.
- The license page counts tenant usage correctly.
Platform and operations
- Render service (
ai-agent-render): a headless Chromium that renders dashboards for subscriptions, installed and started with the AI Agent. Plan about 1 GB of memory. See Render service. - The stop scripts stop Tomcat and wait for it to exit before they stop PostgreSQL, so sessions and the audit queue close properly. Datafor now shuts down in seconds instead of waiting a minute to be killed.
- Security:
- Password reset no longer tells whether an account exists or shows the email address the code went to, and a code works only once.
- Responses of the Datafor and modeler APIs are no longer cached by browsers or proxies.
- Anonymous requests for the current user no longer return user ID, tenant, roles or plugins.
- New installations no longer send the
session-expiryandserver-timecookies (see Upgrade notes for existing ones). - SQL on an uploaded file dataset can read only that dataset's tables and a list of allowed functions, also inside models, so a model can no longer read the data of another file dataset.
- Silencing an alert from a message link needs a confirmation, so mail scanners that open links cannot silence alerts.
- Rich text and HTML in table cells can no longer use positioning that covers the page.
- Changing map settings needs an administrator.
- The public
appearance.jsonno longer contains a demo account's password.
Upgrade notes
- Earlier alerts are removed. The alert API (
/plugin/datafor/api/alert) is gone. After the first start, Datafor deletes the old alert definitions and their scheduled tasks. Set the alerts up again as metric alerts. - WeCom sign-in and directory sync move to IM platforms. The
datafor-wechatplugin is removed together with its sync task; its settings are not carried over. Register the WeCom app again under Settings › Notifications › IM platforms, set its home page to the App home page URL shown there, and sync the directory again or let people link themselves. The old?code=&appKey=sign-in addresses stop working. The plugin's database tables are not deleted. - Security configuration. The platform patch and
applicationContext-spring-security.xmlmust be updated together, or Datafor does not start. The update package edits and checks the file. If you maintain it yourself, replacewecomFilterwithimFilterand add anonymous rules for\A/plugin/datafor-notify/api/asset/.*\Z,\A/plugin/datafor-im/api/(sso|callback|bind)/.*\Zand\A/plugin/datafor-notify/api/alert/.*/silence-link.*\Zbefore\A/plugin/.*\Z. - Audit log. With the audit plugin installed, a system or tenant that never saved audit settings starts recording after the upgrade and keeps records for 180 days; one that did keeps its choices and retention. Turn auditing or Viewing off under Settings › Operations › Audit log if you do not want it. Datafor operations are no longer written to
PentahoAuditLog.log; the file is kept as it is. The update package adds the audit library toWEB-INF/liband moves aside old copies of four sign-in classes inWEB-INF/classesthat would otherwise stop sign-in from working. - Render service. When you upgrade the AI Agent from a version without it, copy all of these from the new package, not only the files that already exist: the
ai-agent-renderprogram, its start scripts,render-runtime-*.propertiesand the wholebrowsersfolder. Without them Datafor starts normally, but subscriptions go out without screenshots and PDF. On Linux, install the system libraries and fonts listed in Render service. - Paginated report subscriptions need the subscriptions and alerts plugin to send anything: without it, a scheduled run records that nothing was sent. Saving the files to a repository folder is gone: a subscription that only saved to a folder still runs but delivers nothing, and each run records that it has no recipients. Add recipients to such subscriptions or delete them. Schedules now use the system time zone instead of their own; check the times of existing subscriptions.
- Personal tokens that were not used for 90 days stop working right after the upgrade; the last use already recorded counts. Users create a new token, or click Allow again in their AI client.
- Tenants. Run Repair permissions on each existing tenant and on template0, and set each tenant's AI User Limit (it starts at 0). Site addresses saved inside tenants are ignored. An embed token configuration of the default tenant no longer signs in to tenants with
?tenantId=; create one in each tenant. See Upgrading tenants to 10.02. - File datasets: give Edit to the people who maintain a dataset's uploads; with Read they no longer see the uploads, original files or previews.
- Moving content needs Delete permission on what you move. People who could move reports with only Write permission can no longer do so.
- Drill-through targets show the passed members in their filters instead of the Drill-through filters bar, and the bar's ← Back and clear links are gone.
- File datasets. Saving a model on an uploaded file dataset is refused when its tables or SQL reach outside that dataset, also for administrators, and previewing your own SQL on a file dataset needs permission to manage the connection. To list existing models that break the rule, call
GET /plugin/datafor-modeler/api/mondrian/uploadScopeAuditas an administrator. - Cookies on existing installations. To stop the
session-expiryandserver-timecookies, setsession-expired-dialogtofalseinpentaho-solutions/system/pentaho.xmland restart. - Mapbox maps. Open Settings › Data › Maps and click Clear geocoding cache on the Mapbox card, so places geocoded wrongly before are looked up again.
- Phones and reports without a mobile layout: phones now open such reports in the automatic mobile layout instead of the desktop page. To keep the desktop page for a report, open its mobile designer, click Clean all, and save. Tablets still open the desktop page.