Skip to content

docs: document how to backfill tracking for legacy BDM data — BPA-441#3300

Open
tmarie-bonitasoft wants to merge 1 commit intodocs/BPA-439-bdm-data-retentionfrom
docs/BPA-441-legacy-data-migration
Open

docs: document how to backfill tracking for legacy BDM data — BPA-441#3300
tmarie-bonitasoft wants to merge 1 commit intodocs/BPA-439-bdm-data-retentionfrom
docs/BPA-441-legacy-data-migration

Conversation

@tmarie-bonitasoft
Copy link
Copy Markdown

@tmarie-bonitasoft tmarie-bonitasoft commented Apr 13, 2026

Summary

Documents the manual migration procedure to bring BDM instances that existed before the data retention feature under retention control.

Added to the BDM data retention page:

  • New Handling legacy data section (#legacy-data anchor)
  • Explanation of why pre-existing BDM instances are not tracked
  • 3-step procedure: identify → insert → verify
  • PostgreSQL example query for backfilling the `data_retention_bdm_tracking` table

Cross-linked from the GDPR design guide.

Closes BPA-441.

Depends on

Based on #3299 (BPA-439) which creates the BDM data retention page this PR enriches. Retarget to `2026.1` once #3299 is merged.

Test plan

  • Built locally with Antora and reviewed in the browser
  • SQL example validated against a legacy Bonita deployment (reviewer step)

@CLAassistant
Copy link
Copy Markdown

CLA assistant check
Thank you for your submission! We really appreciate it. Like many open source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution.
You have signed the CLA already but the status is still pending? Let us recheck it.

@github-actions
Copy link
Copy Markdown
Contributor

📝 Contribution Summary

To merge this Pull Request, you need to check your updates with the following URL.

🔗 Updated pages

Note

The following pages were updated, please ensure that the display is correct:

@bonita-ci
Copy link
Copy Markdown
Contributor

bonita-ci commented Apr 13, 2026

🎊 PR Preview f5ec5bc has been successfully built and deployed to https://bonitasoft-bonita-doc-deploy-pr-3300.surge.sh

🕐 Build time: 0.011s

🤖 By surge-preview

@tmarie-bonitasoft tmarie-bonitasoft force-pushed the docs/BPA-441-legacy-data-migration branch from d723c08 to 0893ffb Compare April 13, 2026 14:46
Add a 'Handling legacy data' section to the BDM data retention page:
- Explain why pre-existing BDM instances are not tracked
- Step-by-step migration procedure (identify, insert, verify)
- PostgreSQL example query for backfilling the
  data_retention_bdm_tracking table

Cross-link from the GDPR design guide.
@tmarie-bonitasoft tmarie-bonitasoft force-pushed the docs/BPA-441-legacy-data-migration branch from 0893ffb to f5ec5bc Compare April 14, 2026 08:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants