Skip to content
Permalink
Branch: master
Find file Copy path
Find file Copy path
Fetching contributors…
Cannot retrieve contributors at this time
260 lines (175 sloc) 13.8 KB

Modernization Framework release notes

How to get and use

How to get

How to use

[July release - version 1.0.1907.0]

Added

  • Custom URL mapping logic: provide a csv file with source and target values and these will be used by the url mapper #135
  • Option to override default QuickLinks configuration in publishing page transformation scenarios #191
  • Option to "map" web parts inside a web part zone #167
  • Support for multiple source field "name" values in page layout mapping files, allows to define "overrides" if a given field is not populated in the source page #201 [MartinHatch]

Changed

  • User fields are now correctly copied over in cross site publishing transformation scenarios #184
  • Mapping Files Version Change Notice #188
  • Set TargetPageName is now used to construct the return URL value #194
  • Correctly detect 'empty' text parts #192

[June release - version 1.0.1906.0]

Added

  • Preview On-Premises publishing page to SharePoint Online modern page support #165 [pkbullock]
  • Support for transforming web part pages living outside of a library (so in the root folder of the site)
  • Support for provisioning the Page Properties web part on a page (only for publishing page transformation). #171

Changed

  • Reporting improvements for on-premises as source + correct log level for some log entries #169 [pkbullock]
  • Logic added that disables item level permissions copy in cross-farm scenarios #178 [pkbullock]
  • In publishing scenarios it's common to not have all fields defined in the page layout mapping filled. By default we'll not map empty fields as that will result in empty web parts which impact the page look and feel. Using the RemoveEmptySectionsAndColumns flag this behaviour can be turned off. #156

[May release (prod) - version 1.0.1905.3]

  • Intermediate release due to needed intermediate release of the used PnP Sites Core library

[May release (prod) - version 1.0.1905.2]

  • Intermediate release due to needed intermediate release of the used PnP Sites Core library

[May release (prod) - version 1.0.1905.1]

  • Intermediate release due to needed intermediate release of the used PnP Sites Core library

[May release (prod) - version 1.0.1905.0]

Added

  • Support for static parameter values in function definitions. Use the new StaticString function, e.g. StaticString('your static string') to define a static value. Fixes #119
  • Support for running a function on MetaData field mappings (single function can be added per field, not supported for taxonomy fields)
  • Added ToPreviewImageUrl built in function which allows to control the page preview image via either a dynamic value (field of the source page list item) or a static string
  • Added mapping for image anchor (wiki and publishing) and image caption (publishing) to modern image web part
  • Simple URL rewrite engine for publishing page transformation
  • Summary report generation #141 [pkbullock]

Changed

  • Added filter for ASPX files and additional error handling #102 [pkbullock]
  • Duplicate analyser mappings produced #100 [pkbullock]
  • Amended Page Transformator to check target site for existing file #117 [pkbullock]
  • Fixed CDATA handling in page layout analyzer
  • Support table structures with mixed TD and TH cells in the same TR
  • Content Editor web part title is taking over when the web part's "ChromeType" differs from "None" or "Border-only" #120
  • Fix: Table size detection issues #123 and #124
  • Fix: Performance improvements around asset transfer #125 (fixes #111) [pkbullock]
  • Fix: Take over text alignment in table cells #104
  • Fix: Integrate "enhanced" processing of content editor text content also in web part page analyzer flow #106
  • Fix: capacity was less than the current size. #130
  • PageLayoutAnalyser.AnalyseAll now can skip OOB page layouts
  • Fix: Page layout analyzer can handle fields specified by id instead of name #131 and #133 [pkbullock]
  • Fix: Web part title (when the web part's "ChromeType" differs from "None" or "Border-only") is retained when summarylinks are transformed to html #137
  • Fix: switch to FIPS compliant hash method #146
  • Fix: order can be set also for web part zones and fields that transform into web parts allowing to now set order for all visible components on the page #148

[April release (prod) - version 1.0.1904.0]

Added

  • Publishing page support!
  • Transformation Reporting. Get (verbose) logging as md file, page in SharePoint, console or a combination of these #82 [pkbullock]
  • Page Layout Mapping #86 [pkbullock]
  • UserDocsWebPart transformation support: this web part is transformed to the highlighted content web part showing the current user's active pages
  • PublishCreatedPage configuration option: allows to define if a page needs to be published or not
  • DisablePageComments configuration option: allows to define if page comments needs to be disabled or not

Changed

  • Transforming Summary Links to Quick Links json encoding Bug #74
  • Tables with col/row spans: split cells and put the content in the first cell of the split #77
  • Transform nested tables as individual tables #75
  • Support transformation from pages living outside of the sitepages library #80
  • Content editor: if content is recognized as transformable html (so no script) then it will be treated as wiki content, hence embedded images and videos will be created as separate image and video web part + in cross site scenarios the images are copied over to the target site

[March release (prod) - version 1.0.1903.0]

Added

  • Support for creating the modern site pages in another site collection. Does support asset transfer to the target site collection for a limited set of web parts decorated with the CrossSiteTransformationSupported="true" attribute. #59, #65, #66 and #71 [pkbullock]
  • Support for using Boolean as return type of functions used in the web part transformation model
  • XSLTListView transformation: map the web part toolbar configuration to the hideCommandBar property
  • Transformation support for ContentBySearchWebPart and ResultScriptWebPart
  • Drop "empty" text parts...text parts with html tags without visual presentation are useless. Wiki pages, especially with multi section/column layouts, tend to have these
  • Drop empty sections and columns to optimize the screen real estate - also better aligns with how web part pages and wiki pages behave in classic. This behavior is on by default, but can be turned off via the RemoveEmptySectionsAndColumns flag in the PageTransformationInformation class
  • ExcelWebRenderer transformation: take over the configured named item (table, chart, range)
  • SummaryLinks transformation: new default is transform to QuickLinks, optionally you still transform to text by setting the SummaryLinksToQuickLinks mapping property to false
  • ContactFieldControl transformation support: this web part transforms to the People web part
  • Support for defining functions on a mapping: this allows to execute code only when a specific mapping was chosen

Changed

  • ContentEditor transformation: when not using 3rd party script editor embedded and file contents without script references is not treated as text
  • Content by query transformation:
    • Support for site collection and sub site scoped queries, including filters and sorting for those type of queries
    • Specific support for SitePages library queries in the list scoped query handling
    • More detailed content type filter handling
    • Switched to version 2.2 of data model
  • SummaryLinks transformation: links without heading are now correctly transformed to html
  • Mapping properties allow for mapping based up on configuration: the UseCommunityScriptEditor property can be set to use the community script editor, no need for changing mapping files to support this scenario
  • MembersWebPart transformation: now shows a text making users aware of the OOB Site Permissions feature that replaces this web part's functionality

[February release (prod) - version 1.0.1902.0]

Added

  • Support for pages living inside a folder (issue #34)
  • Support for copying of metadata (issue #35)

Changed

  • Wiki page parser: check if this element is nested in another already processed element...this needs to be skipped to avoid content duplication and possible processing errors (issue #37)
  • Improved item level permission copy logic
  • Check for proper permissions before attempting item level copy, if insufficient permissions the item level permissions are not copied but the transformation will still succeed
  • Only transform content editor web part pointing to .aspx file to contentembed, .html files result in a file download instead of a file load

[January release (prod) - version 1.0.1901.1]

Changed

  • Fix for issue #30 to enable page transformation for pages in tenant root web in combination with XSLTListView web part transformation

[January release (prod) - version 1.0.1901.0]

Added

  • Support for new 1st party web parts: these can now be included in your webpartmapping.xml files

Changed

  • Massive performance improvements (double as fast) for page transformation. Also improves performance of the (publishing) page scanner components

[December release (prod) - version 1.0.1812.1]

Changed

  • Using December 2018 PnP Sites core package

[December release (prod) - version 1.0.1812.0]

Added

  • Return site relative URL of the created modern page

Changed

  • Compiled using .Net Framework version 4.5 instead of 4.5.1 to allow inclusion in 4.5 projects (like PnP PowerShell)

[November release (prod) - version 1.0.1811.2]

Changed

[November release (prod) - version 1.0.1811.1]

Changed

  • Added Page Propertybag entry with version stamp of modernization framework used to generate the page
  • Added Azure AppInsights based telemetry, only anonymous data is sent

[November release (prod) - version 1.0.1811.0]

Changed

  • Updates when transforming wiki html:
    • H4 to H6 elements now retain their formatting when converted to text
    • Combining italic/underline/bold in combination with other type of formatting now works stable
    • Strip out the "zero width space characters"
    • Drop wiki font information
    • Handle additional styles (ms-rteStyle-Quote,ms-rteStyle-IntenseQuote,ms-rteStyle-Emphasis,ms-rteStyle-IntenseEmphasis,ms-rteStyle-References,ms-rteStyle-IntenseReference,ms-rteStyle-Accent1,ms-rteStyle-Accent2)
    • Better handling complex nested styles
    • Full rewrite of indent handling: now supports complex formatting inside indents, indenting of blocks and unlimited indent depth
    • Switch default table style to borderHeaderTableStyleNeutral - this allows highlighted text to show as highlighted, plain table style suppresses this
    • Assume a table width of 800px and spread evenly across available columns
    • Improved reliability in detecting images/videos inside wiki text fragments
    • Clean wiki html before/after processing to drop nodes which are not support in RTE
    • Full rewrite of wiki splitting...better reliability, better results and better performance

[October release (prod) - version 1.0.1810.2]

Changed

  • Fixed issue with default page layout transformation for "One Column with Sidebar" wiki pages

[October release (prod) - version 1.0.1810.1]

Added

  • Support for adding a web part of choice as banner on all generated pages. Used to give end users an option to accept/decline the generated page

Changed

  • Lowered minimal .Net framework version from 4.7 to 4.5.1
  • Expose the swap pages logic so that it can be used by folks using the page transformation engine

[October release (prod) - version 1.0.1810.0]

Added

  • Wiki text handling: Headers (H1 to H3), STRONG and EM tags with custom formatting do retain their formatting
  • Supported formatting in table cells is retained when the table html is rewritten

Changed

  • Approach to give newly created modern page the same name as the source page has been fixed: now url's to these pages in navigation or other pages are not rewritten

[Beta release - version 0.1.1808.0]

Added

  • Header (H1 to H4) alignment is retained when transforming wiki text
  • Combined styles (e.g. forecolor with strike-through and font size) are now correctly handled when transforming wiki text
  • Documentation for functions and selectors is now autogenerated (https://docs.microsoft.com/en-us/sharepoint/dev/transform/modernize-userinterface-site-pages-api)
  • Support added for having text before and after the web part but inside the div surrounding the web part
  • Theme colors are transformed now
  • Source page item level permissions are copied to the target page (can be optionally turned off)

Changed

  • Page title handling got improved
  • Improved handing of BR tags
  • Improved reliability in handling image URL's outside of the current web
  • Fixed layout transformation for HeaderRightColumnBody and HeaderLeftColumnBody web part page layouts
  • Fixed "duplicate key" issue when transforming multiple pages in sequence
  • Fixed ListId datatype in model
  • Calendar is now transformed to the Events web part
  • Tasks web part is not transformed anymore
  • Correctly identify a discussion board
You can’t perform that action at this time.