Microsoft 365 Community Community Demos, 11 Apr 2019

Previous Meeting Next Meeting

⏯

youtube image

►

From YouTube: Community Demo - Tooling to automatically transform classic publishing pages to modern

Description

This community call demo is taken from the SharePoint Developer April 2019 monthly community call on the 9th of April 2019. In this video, Bert Jansen (Microsoft) demonstrates open-source tooling to automatically transform classic publishing pages to modern pages in SharePoint Online.

Presenter - Bert Jansen (Microsoft) - @o365bert

Full details on the community call from https://developer.microsoft.com/en-us/sharepoint/blogs/sharepoint-dev-community-pnp-april-2019-monthly-community-call-recording/

More details on the transformation tools can be found from https://aka.ms/sppnp-pagetransformation
.
More details on the SharePoint dev community calls from http://aka.ms/sppnp.

A

So, while I'm sharing the screen, the demo is around a new capability that we released with the April release of being PowerShell and that's around the page transformation for publishing pages. So for folks, we've been in these meetings before you might have heard about the page transmission technology that we have where we essentially allow you to take a wiki or web page and generate a modern client-side page from that particular page. There was a high demand for having this for publishing pages as well, and oh you're this meaning it doesn't preview.

A

It is available in the April release. So if you don't let the people at least you can use it or if you pull down the packages, you can use it as well directly, not net. If you kind of want to extend around it, etcetera now only fonts light and there's actually, this one address slash HP, pnp, page transformation. So in this this link brings you to dr. Markham, with all the commentation around page transformation.

A

The docs on the publishing support arm a little bit light that webcast series having eight videos shown like how to do patient summation, different aspects, different options, etc. So rest assured, more documentation is coming now: let's close this rights and do with them, what I have here is a basic classic option portal and a couple of pages.

A

So, let's first go to the 95 specs page I'm, going to show you guys two pages to be transformed, one using after box layout like a very basic, simple one and then a slightly more complex one, just to show you the options and before someone makes a comment: I'm, not a designer I'm, not good, at making fancy pages. So this is just the demo page. Maybe doesn't look really nice, but I think I, hope you can get the tidy behind.

A

This is a classic publishing page with some properties, so page image, some rich text content a byline article date, so formatted text a table and then a rollup image. Now, how does this look? Like is a model page when we convert it so for that we need to be powershell a little bigger and let's sign in to our powershell session, so I'm going to sign in to my page transformation. Demo portal I use the SQL management shell option because that's an option to authenticate that kind of works in all situations. So, if you.

B

A

Two-Factor authentication, for example, this one works nicely.

A

A

Alright done now, let's convert this first page and to convert a classic page into a modern page. There's one commando to remember: let's convert to being a client-side page, the same command, let works for both wiki and web pages, but also for publishing pages. When you do a publishing page transformation, you have to specify this publishing page parameter and you have to specify a target web URL. Why?

A

Because publishing page transformation always goes to a new site collection, so we don't support you having like modern pages mixed together with classic clerkship pages in the same site, collection that doesn't work, that's not supported, so we can do that. However, when you specify target material 42 in this case, a communication site, your modern version of the publishing page will end up over there. So this all looks good. So, let's give it a try I'm. Actually, just let me open up my target quick.

A

So this is my dog aside collection with a page will be created over the pages. It should be empty and yes, it is so all right. Let's go keep your fingers crossed well, this one is running. It will create the page in the novel side- collection, which also implies kind of me. You might depression, might pop up like what about assets, meaning my page has images like I saw on my demo. What I do with those images now these images are copied over to the target page.

A

So if you go to the target page I already see this page being created over here and before we look at the patients. Go to site contents go to site assets, so you see that we are creating a site pages folder and in here we have images, so the transformation tech actually does copy the images that are needed to make the page work. Let's go back to site pages, so does pages over here and let's have a look at our page, so the page transformation is done, opening up the page and voila.

A

This is our modern publishing page. So we see that we've taken over the header, the content is there like looks pretty nice. It's a basic page, let's kind of make it slightly more complex. Let's go back to our, but.

B

As a quick question, so if you yeah, so if you add to this page, will it keep all the formatting or so.

A

If you edit, the page, is a modern page, meaning it's, you can then play around and change the header. If you want and I want to play header image header, it's like a a classic classic model of beta cells for you. But it's a modern page that you can just start editing here and then publish once you're ready.

A

A

It answers the question become yes,.

B

All right awesome.

A

Now, of course, no one makes publishing pages using the default page layout or the custom master page. It was very simple demo now what if we have a slightly more complex page. So if I go back to my pages library and let's open up 88 about drawing at this page, still doesn't look pretty, but is a pretty. It has a bit more confident in it. So that's what is in edit mode.

A

First of all, what you see here is that this page, as in both its custom page note, custom page layout, hasn't fixed the path, so folks tend to kind of with a webpart inside a page layout and then appears on all the pages based upon the page layout. So that's what we have here and furthermore, it has a webpart zone.

A

So if I actually pull up the page layout file scrolling down a little bit, you see here that we have a web browser own in the page layout and we have a fixed content at the web part in there, which contains some HTML waiting to some images, etc. So what you see on the page over here, if you go back, is actually they. This is the confident of HTML which is embedded in the page layout.

A

The buffer zone has one report on it, and then we have the usual page content, so the rich text, page content, the page image and some properties, and furthermore, we have, if I go to the page properties here there is also some additional metadata. So we have a contact and we have some scroll down.

B

I think we have some.

A

We have some some real eggs, so all this is defined as part of the classic publishing page. Now, how do you move this over to a model page?

A

You can imagine that it's quite hard to automatically figure out. We have to put words etc. So that's why we have introduced the concept of a page layout mapping which is example of air I. Why was the notation of mapping in a previous page because I wasn't out of the box page, so we have a built-in way to drive mappings for any of the box page layout. But if you have a custom page layout, we try to do like a best efforts.

A

We generate the patiently out on the fly and use that, but that gives you like a single column. Everything in there boom dump into one big column. Now, if you won't have a bit more fancy, you can generate a page layout yourself. So actually there is like this exports we'd be flying inside page mapping. You just specify built-in page there sorry custom, patient mapping it entered and we'll analyze all the page layouts in your publishing portal and generate XML file.

A

Like this kind of all, right, listen cleanup in this one, because I want to show you some key things here. First of all, you.

A

Can control how the header is built? So here we say like publishing: roll-up image goes to the header image server. Health of your L article by Lynn fill up. The publishing page goes to the topic header of the modern header, etc. So you can control that you can control metadata. So in this case the taxonomy field called drone category which I will copy to drone types.

A

What else we have content on the page.

B

Custom functions are as well I say with two author and to a mushy RL.

A

Yes, service functions, kind of fever, as we write the text little bit like this case to image URL when you get a publishing page image field is an image tag, but we need only the image URL. So we kind of strip away a lot of stuff you disgustin function and this all extendable, you can write your own functions, etc. That goes way too far for this quick demo, but you can kind of control the visual content. What will be a web part so remember? The publishing page is metadata and visual content.

A

Now, with classic pages all these are all fields in a modern page. You have to kind of think about what will be on the page. What will be metadata, so this will be the content on the page, so an image, rich text content and some links F a web post zone. So we we tell where the zone lives, Row, 3, column, 1, and then we have the six paths which is in there as well.

A

This all together drives the patient submission for the for the smoke advanced page. So let's see how that works so wait.

A

Let's I'm gonna copy it a command line, real quick. Let's do that here, just a sec.

A

Paste so the same cover stupid. The classic command different now is that we have this page start mapping where we point to our custom mapping that we created for the rest is kind of the same so when it entered right now, we'll do the conversion of this d88 page into our target site collection, so I'm going to cancel this one here, let's lose this one. Let's go over here you see the page already being created. It might not yet be fully finished, I'm so busy, but typically it was already good to have a look at.

A

So let's, let's wait. A second.

A

Let's open up the page, and here we have our D 88 modern version of the page. Again, you see the same, pretty cool head of hair, so the page whole up image becomes to edit image by line etc. Has taken over us being the the tag here we have our rich contents. It all looks good.

A

We have our hair Quick Links, so you can see slightly better. If you remember that we had those summary links, the links are converted into quick links now by default. We take this this view, but if you put this example in the filmstrip view what it looks better right, so nice image, these images are also kind of converted to the other side, the new site collection. Here we have the embedded content. In a page note, it's now actual content on the page. And finally, we have our list view web part. So.

B

So is there some documentation who tells you what's supported or features in the old publishing with and what they will be translated to in the modern pages? Yes,.

A

A

Aikido Thomas link page transformation, and there is this: let me see a transformation, let's see we're back the model mapping this one, which explains which classical parts that we have, but with immortal equivalents, some comments and whether cross site is for that. So not everything works in a cross site mode and sometimes there are some restrictions. So it is all documented here, there's also this PowerShell page showing how to use this from PowerShell like I'm doing right now from God nets.

A

If you want, let's address, there's all documentation there and there will be like a video series on this as well coming case and.

B

If someone is missing our little box, all the way part which should translate the new airport feel free to logon issue on that over on the PMP site, and we look into it or if you want to contribute yourself.

A

See I would like to call Isaac Unni. This gif is a try. This is the first time that we are publishing. Support, isn't preview I. Would we have done testing, of course, but we don't have like a real life portal. So if you have real life portals, just give the try, let us now it works to create your mapping files and play around and see and give us feedback. This is open source or the feedback here there is this: if you go to the github Shepherd organization,.

A

B

B

So, what's the website people log issues for the patrons transformation to the login in the power celery power or in the transformation repower? That's in preferably.

A

In the transformation process, so this spdf mobilization contains all the tools and guidance and around monetization, including page transformation. So please created an issue list over here so that we can track it if it's in PowerShell, meaning we'll pick it up as well. But I think this is the best place to put the issue also.

B

A

Looking at the questions, if she comes asking all about customer pass, yes, you can use a custom mapping file as well, there's no time to demo it today, but you can specify your own map of nothing file or you can kind of say like I. Have this whole process which goes to my custom, builds here per frame of a craft? So it's fully extendable and tweak it and tailor it to fit your needs, but I hope it gives this guy.

A

If you like it kind of a it's small teacher and I hope, you guys want to try it out and provide feedback and.

B

Maybe I should add a blocker. So if someone uses old script webpart they cannot map it to.

A

The modern scripted or.

B

A

B

Like a warning, at least I saw.

A

That but yeah all right, xpeke, oh I, think back to you yeah.

B

Thank you. Thank you very much. Awesome stuff, I think this. Actually, it was I use a little bit myself for a wiki pages and I have a client right now. We're actually do modern pages side by side with publishing pages. I know it's not supported, but we're actually doing it, and this will actually help moving those last pages over to the site pages, slow brown, and then we can kill off the pages. Library, maybe create a new site.