RSS

WikiTraccs 2.0.27 (Prerelease)

By Heinrich Ulbricht |
Tags:

This is a big update, driven by the introduction of Content Decision Lists. This required changes to the page processing pipeline of WikiTraccs that lead to a whole list of additional adjustments. This prerelease has proven quite stable so far. More updates will follow as well as additional documentation, which is still lacking for the new features.

Supply chain hygiene note: WikiTraccs now runs on .NET 10 instead of .NET 8, which reaches its end of support on November 10, 2026. The release package includes the runtime. WikiTraccs also uses updated libraries and fewer third-party dependencies.

(Pre)release Evolution

Features

  • new: Content Decision Lists (CDLs) let you include or include subtrees or single pages for migration; routing to different sites is also possible (tutorial video)
  • new: missing target sites can now be automatically created, if permissions allow (opt-in via settings)
  • new: WikiTraccs converts several Linchpin Intranet Suite macros
  • new: files attached to a Confluence comment or reply, including Confluence Cloud footer comments, now migrate together with the comment
  • new: Confluence Data Center: a link to a person’s Confluence profile (/display/~name, or a user profile link) becomes a SharePoint mention of that person.
  • new: WikiTraccs.GUI shows a status picture of your SharePoint sites while it prepares them, migrates a Content Decision List, or updates the Space Inventory list
  • new: the Broken Links inventory report shows broken links for each space. It groups links by destination and shows the source pages that contain them. This includes links to pages, attachments, images, and Jira content.
  • new: optional Telegram notifications let you monitor an unattended run. They show progress, requests that need attention, and the final run status. Telegram notifications must be configured before use.
  • new: access the WikiTraccs.GUI log directly in the blue WikiTraccs window; turn it on in the menu bar

Improvements

  • improved: attachments: WikiTraccs migrates attachments from archived Confluence Cloud pages, distributes uploads by file count and size, reduces parallel work when SharePoint limits requests, and retries temporary SharePoint gateway failures.
  • improved: run time: large spaces take less time to scan and compare with existing target pages, link processing makes fewer Confluence requests when many source content selectors use CQL.
  • improved: inventory reports include team calendar names and counts, the reason a page could not convert (Flagged Pages), and the download status of each attachment (Attachment Linkage).
  • improved: the Confluence Space Inventory list has clearer column names, quick access controls, colors for column groups, links to the Confluence spaces, each space’s labels and description (you can filter by them), a Ready Page Count, and a WikiTraccs Notes column that explains the last check. The WikiTraccs columns of the Site Assets library show readable names instead of technical names.
  • improved: progress log files give more detail about each source content selector, target site, and result, in separate files for the start and the end of a run.
  • improved: the progress display shows more detail during source discovery, SharePoint preparation, and selector start-up, shows when WikiTraccs stops or finishes, and shows a “waiting for more pages” indicator between batches of work.
  • improved: sign-in and browser: Microsoft 365 browser sign-in will be reused when you start a migration from WikiTraccs.GUI; browser startup reuses an installed Chrome driver; Confluence DC browser sign-in keeps the session of an XRPX access gateway; and Confluence Cloud connection messages identify Windows security settings that prevent a secure connection to Atlassian.
  • improved: messages and settings: Watch Tower shows where settings come from and which ones need attention, SharePoint connection and preparation messages name every missing field and what WikiTraccs is about to create, folder access checks report unusable folders before the run starts, and you can set a separate log folder.
  • improved: macros: content inside a Scroll Ignore macro is kept, a Scroll Export Button becomes a short note, the Communardo Contact Person macro keeps the Microsoft account ID (Confluence Cloud), the Lorem Ipsum macro shows generated text instead of a note, and the Brikit Theme Press link and display macros become real links and values (the link macros also on Confluence Cloud).
  • improved: the capture of a whiteboard’s full content (Export raw whiteboard data) now also works with a Confluence Cloud API token.
  • improved: component updates for outdated components.
  • improved: links: the link fixer now repairs more links.

Bug fixes

  • fix: page change detection: a changed page could be skipped when the computer and SharePoint used different time zones, on bulk edits with small time differences, or when an old copy of the page existed in another space. WikiTraccs now compares consistent times, and also detects a change by the page version number.
  • fix: progress and progress log files-related fixes.
  • fix: inventory results: link-related improvements; removed some false positives regarding hidden images, removed images, and profile images.
  • fix: browser automation: changed sign-in cookies could end a valid Confluence session.
  • fix: comments: Confluence Cloud comments could show the last edit time as the creation time, or incomplete author or editor names.
  • fix: page content: Roadmap Planner images (Confluence Cloud) could be missing, PlantUML images lost their alignment, a Confluence Cloud layout section without a column type stopped the whole page, a Brikit Theme Press layout with more than six columns repeated its first columns, a link without a destination or outside the migration scope lost its text or counted as a failed transformation, text with ]]> broke page processing, and a fallback search for a page title could select the wrong space.
  • fix: whiteboards and draw.io: a Confluence Cloud whiteboard preview image could be empty (emoji characters), missing (the image took more than 30 seconds, or the whiteboard app was not ready), or without data (Confluence rejected the token request); draw.io preview export could select the wrong file format, or lose a completed image after a browser timeout.
  • fix: selecting “Stop” could be reported as an error in the log.
  • fix: WikiTraccs.GUI: when typing, the input fields could replace text that you had just entered, the Tab key and the mouse wheel could move to the wrong place, the Start and connection test buttons could be active at the wrong moment.

2.0.12 → 2.0.25

Features

  • new: optionally upload a run’s Console logs as a ZIP file to the default documents library of the WikiTraccs site when the run finishes or is stopped. Enable Upload logs to WikiTraccs site in the transformation settings.

Improvements

  • improved: page permission migration:
    • improved: pages with edit restrictions and no viewing restrictions now grant Read to the target site’s standard Visitors, Members, and Owners groups instead of Everyone except external users.
    • improved: messages about incomplete permission calculations name the page, its restricted ancestors, and the affected users or groups.
    • fix: permission migration now finds existing permission snapshots when the configured Confluence URL has a trailing slash.
    • fix: permission migration no longer reports a hierarchy error for unrestricted ancestors or for restrictions that can be calculated exactly.
    • fix: an edit restriction on a child page no longer bypasses an ancestor’s viewing restriction. Users that the ancestor excludes no longer get edit access, and Everyone except external users can no longer get Read access to the page.
    • fix: a parent’s edit restriction is no longer copied to a child page that has no direct restrictions. Inherited viewing restrictions still apply.
    • fix: missing or incomplete restriction data is no longer treated as proof that a page is unrestricted.
  • improved: Aura macro migration:
    • improved: Aura Title and Divider macros retain more text formatting, including color, font size, and font weight.
    • improved: Aura Cards use bold titles and paragraph descriptions.
    • fix: Aura links to pages and attachments now retain their configured link labels.
    • fix: Confluence Cloud: Aura Tabs now become one section for each tab, with the tab title and its content.
  • improved: Gliffy diagram migration:
    • fix: a Gliffy diagram with its preview image on another page now migrates as an image, if the other page also migrates.
    • improved: Gliffy diagrams can use a PNG or SVG preview image and keep their configured display size.
    • improved: a Gliffy diagram with no readable preview image becomes a placeholder.
    • fix: Confluence Cloud: more forms of the Gliffy macro now find their preview image, for example with an empty page reference or a preview image on the container page.
    • fix: Confluence Cloud: if a page has more than one file with the same name, the version number in the Gliffy macro now selects the file.
  • improved: large diagrams migrated as Image web parts now link to the migrated image file, which opens in a new tab instead of showing an unreadable lightbox preview. (issue #186)
  • improved: Microsoft 365 sign-in handover from WikiTraccs.GUI to Console now also supports Device Login and Credentials. This can avoid a second sign-in when the migration starts.
  • improved: the WT: Transformation Log column of a migrated page now lists failures first and writes each result once.
  • improved: clearer common log files, with more details in retry and error messages and fewer repeated warnings.
  • improved: the inventory preview has been extended to March 1, 2027, at 00:00 UTC.

Bug fixes

  • fix: Confluence connection recovery:
    • Confluence reads now retry after temporary DNS failures, such as when a laptop reconnects after sleep.
    • an expired Confluence session that returns an HTML sign-in page is now detected as a sign-in problem. Migration pauses, shows the reason in the GUI, and resumes when access is restored.
    • Confluence Cloud: asynchronous content conversion now waits up to two minutes for a task instead of stopping after 20 seconds.
  • fix: GUI stability:
    • invalid links in the single-location and Atlassian Marketplace dialogs now show an Invalid Link message. Incomplete site addresses no longer cause errors.
    • fix: unexpected GUI errors are now recorded in a separate crash file in the temporary folder and, when available, the GUI log.
  • fix: table migration and editing in SharePoint:
    • calculated table widths now more reliably fit the SharePoint column and stay the same when the page is edited and saved.
    • Status badge backgrounds in table cells no longer spread across the whole cell after editing in SharePoint.
  • fix: repeat migrations no longer create duplicate content location records when the Confluence URL has a different supported spelling.
  • fix: change detection now compares known page versions before modification dates, so a time-zone difference alone no longer migrates the same page version again.
  • fix: saving content and permission snapshots now retries when a newly prepared SharePoint library is not yet available (right after creating a new site).
  • fix: the Confluence Space Inventory list now shows the Quick Access column only once after you change the view columns in SharePoint. Site preparation repairs the view.
  • fix: links to files with special Unicode spaces in their names, such as macOS screen recordings, no longer fail with HTTP 404: SharePoint file names now use plain spaces. A page migrated earlier with such a space in its title gets a new file name on a repeat migration, which gives a second page, as after a Confluence title change.
  • fix: automated browser stability: WikiTraccs can now recover from closed browsers and failed browser starts or shutdowns, and concurrent runs no longer lock the same table browser profile.
  • fix: when a document preview image, such as a PDF thumbnail, is unavailable, the migrated page now retains a text link to the document.
  • fix: text next to a page layout is now retained when WikiTraccs removes a surrounding layout wrapper.
  • fix: emoji image conversion now retains surrounding text, adjacent elements, and table cells.
  • fix: short Code macros with the language value python now retain their title line.
  • fix: translucent background colors now become solid colors, so SharePoint no longer removes them when the page is edited.

2.0.25 → 2.0.27

Improvements

  • improved: Confluence headings 1 to 4 now keep their level on the SharePoint page. The shift h1->h2, h2->h3, h3->h4 is gone, it was a leftover from an older SharePoint editor version.
  • improved: run time on large Confluence instances:
    • speed increase when running on tens of thousands of pages.
    • pages with many empty paragraphs, long Expand macros, large tables, or many tables inside other tables now convert faster.
    • more efficient lookup of Confluence users with no visible email address.
  • improved: inventory report times now use UTC and show the label UTC.
  • improved: Confluence emoticons:
    • red, green, blue, and gray stars now keep their star shape and color instead of becoming colored circles.
    • more emoticons now become text emoji, for example hearts, tongue, big grin, and light bulb.
  • improved: pages now wait less for external images whose host limits downloads.

Bug fixes

  • fix: Confluence Data Center: a two-dimensional Jira chart now becomes a table with its summary and a link to the issues in Jira.
  • fix: Confluence Data Center: interactive login now also succeeds while the page is still loading. The message Could not get authenticated data context for Confluence no longer appears in that case.
  • fix: Refresh auth cookies setting now should really keep the Confluence session alive behind a sign-in gateway.
  • fix: an external image that its host does not deliver now counts as unavailable instead of as a failed transformation.
  • fix: when a Confluence file download gets no answer in time (couple of minutes), the page now fails, so that a later run handles it again. An inventory no longer waits for hours on such a download.
  • fix: Confluence Data Center: a link to a space logo no longer makes the page fail with an error. WikiTraccs does not migrate space logos.
  • fix: an error in the local cache file no longer makes a page fail.

Upgrade notes

  • Create new progress log files before you use them as migration input (a rarely used feature). Files from the previous format cannot be used for this purpose.
  • WikiTraccs now adds an empty Content Decision List Registry list to every WikiTraccs site it prepares, even when you do not use Content Decision Lists.