This is the multi-page printable view of this section. Click here to print.

Return to the regular view of this page.

Whiteboards

WikiTraccs migrates Confluence Cloud whiteboards as image, optionally plus a draw.io file attachment.

WikiTraccs can migrate Confluence Cloud whiteboards to SharePoint. There are two independent modes that can be combined:

  • Whiteboard as image: the whiteboard becomes a static image on the migrated SharePoint page.
  • Whiteboard as draw.io file: the whiteboard content is converted to a draw.io diagram file and added as a page attachment. This conversion is experimental and best effort: expect converted diagrams to need manual rework, and expect the conversion to fail entirely for some whiteboards.

What you get

The whiteboard keeps its position in the page tree: it becomes a SharePoint page that shows the exported image. With the draw.io mode enabled, the page additionally gets a .drawio file attachment.

Requirements

  • Confluence Cloud only. Whiteboards are a Confluence Cloud feature.
  • Interactive Login is required for both modes. API tokens and anonymous access do not work.
  • A locally installed Chrome or Edge browser. WikiTraccs drives it to open and export the whiteboard (see Adding Edge Browser Support).

Whiteboard export failures do not fail or stop page migration; check the migration log.

Learn more

Blog posts with examples and background: Migrating Confluence Cloud Whiteboards, Migrating Whiteboards as draw.io, and Inside Confluence Whiteboards (technical deep dive).

1 - Whiteboards: What Is Migrated, What Is Not

Supported and unsupported features of the whiteboard migration.

The target of the whiteboard migration is a static image on a SharePoint page. There is no interactive whiteboard in SharePoint. See the Whiteboards overview for how the migration works.

What is migrated

  • The current visual state of the whiteboard, exported as an image and placed on the migrated SharePoint page.
  • The position in the page tree: the whiteboard becomes a SharePoint page like any other content.
  • When the experimental draw.io mode is enabled, additionally a .drawio file as page attachment, converted from the whiteboard content on a best effort basis.

What is not migrated

  • Interactivity. The image is static. There is no editing, no collaboration, no whiteboard experience in SharePoint.
  • The optional draw.io attachment is an experimental, best effort conversion, not a copy: it is not editable inside SharePoint, elements without a draw.io equivalent are lost or wrong, and reworking it requires an external draw.io editor. Treat the image as the faithful representation.

For examples of what the results look like, see the blog posts Migrating Confluence Cloud Whiteboards and Migrating Whiteboards as draw.io.

2 - Whiteboards: Configuration

How to enable and configure the whiteboard migration.

Both whiteboard modes are toggled in WikiTraccs.GUI: dialog Transformation Settings, tab Migration, group Gray Settings. Both are off by default and can be combined:

  • Migrate whiteboards as image [Cloud]
  • Migrate whiteboards to draw.io file [Cloud, best effort]

The Gray Settings page describes both settings and why they are gray.

Prerequisites

  • Use Interactive Login for Confluence. Both modes need a signed-in browser session; API tokens and anonymous access do not work.
  • Have Chrome or Edge installed on the migration machine. WikiTraccs uses Chrome by default (if available); the setting Use Edge instead of Chrome as remote controlled browser switches to Edge (see Adding Edge Browser Support).

Verifying results

Whiteboard export failures do not fail or stop page migration. To find affected whiteboards after a run, use the Site Pages library of the target site; migrated pages carry WikiTraccs metadata columns there (see Monitoring per page progress):

  1. Filter the column WT_In_CfContentType by the value Whiteboard to list all migrated whiteboard pages.
  2. Among those, look at the column WT_Out_CfFailedTransformationsCount: a value greater than zero means the image export failed for that whiteboard. Such a page shows no image.

The migration log contains the details for each failure.