Microsoft 365 Community Development, 22 Feb 2017

Previous Meeting Next Meeting

⏯

youtube image

►

From YouTube: PnP Core, PowerShell and Provisioning Engine SIG - February 22nd, 2017

Description

Recording of the PnP Core, PowerShell and Provisioning Engine SIG from February 22nd 2017. Details on the covered topics always available from TBD.

A

Welcome everybody: this is the special interest group for PMP site score and PowerShell, and this one we do have two different demos coming up today as well, one from Bert and one from Paolo. But let's get moving on the on the slide so that we have plenty of time for the live demos and also for the Q&A section.

A

So, first of all, quick, intro, sharepoint commerce and practices is owned by the sharepoint engineering, but we work together with community, as in people like you, helping us to us to provide code samples, guidance and real-world process and patterns, how to make customizations and sharepoint online and that's really the key point of PMP. So it's not the people in redmond sitting and coming up with the scenarios we work together with community members like every piece to make these things happen and the guidance happen as well.

A

Now that's brand AKMs to sharepoint PMP is the one address to remember, but let's actually ongoing on the slides. So, first of all, I have one slide on a really early February 2017 stats.

A

So that's going to be relatively fast, just showing you guys where we are from a usage perspective and the really the key point why we are showing always this that this takes us to essentially show you that if you're, considering that hey, maybe I'll start using two BNP core component, if I the first one am I, the only one don't read us know, there's quite a lot of other people using that as well, and the community is growing quite fast.

A

So it's a great great great great growth for the PMP, and you know that there's other people using the same components. So you can actually rely on getting answers for your questions and all of that and then we do have one slide around the BMP powershell documentation in a misty answer. Let's cover that one here as well.

A

There's one of small update on the modern side creation, so we're working on an updated guidance on that one I'll come back on that one in a second and then we have few slides around the manage more manage modern pages programmatically, including a demo from perkinston, and this is really around the modern pages in the modern SharePoint sites or in the classic sites and how you can programmatically create them, how you can modify the pages using a native seasoned or managed code or rest and then also, how do you?

A

How do you modify or add even custom webparts on those pages, and then we do have a demo on the PMP apartment back or installer resort around that phone from Paulo and Paulo is going to show in practice how to get that starter kit installed and more easily running if you download that from the github as well.

A

But Paulo is gonna cover that in the demo, and we should have time for Q&A today, but let's see how the demos actually move along, so we'll probably spend majority of the time in Bert's slides and a demo BMP partner back. Yes, there is a small T mode as typo on the slide that happens, cool, so quick notes on the February 2017 usage, so the numbers are pretty impressive. Paper is going to be a slightly shorter month because we only have 28 days but we're already. At this point we are above 1 billion.

A

It's the DPA requests going sure the PMP core component and paint a PowerShell. The core component is now at 1, well, 1 billion 80 million requests and the PowerShell is at 40 and 94 million requests as well and and for my overall tenants use it perspective. We have more than 3400 tenants using the PMP assets within the SharePoint Online for own premises.

A

We don't know burst to get this kind of statistics, because we don't have access on the understanding where it's actually being used and all of that so that's kind of understandable, but based on the new ket's downloads and placed on powershell downloads, we can kind of a predict that the on-premises is one third additional from a number of perspective.

A

If we kind of make that conclusion out of the the numbers of how many on-premises no get packages of powershell commandlets are being installed from a PNP power provisioning engine perspective, we are now at 936 tenants in SharePoint Online for this month and we do have a 1 additional weeks till the go. So most likely will break that magical. One thousand tenants using the provisioning engine in SharePoint Online.

A

Let's see if we get there from a provisioning engine, let's say the general users perspective it's kind of an interesting as the distaste because we can see that the half of the people and half of the customers and partners are using the site score. It's the native code, using Visual, Studio and half of the people are using PMP PowerShell, which in sight is using the core as well.

A

So a lot of people are using the powershell for the provisioning automation within their deployments, which is kind of an interesting statistic as well from a global usage perspective. These are always kind of an interesting if we can get some some level of a competition between countries, and this is the top 10 countries from a httprequest perspective.

A

Us absolutely number one UK is super high this month do reasons or another, and if you actually divide Dover or HTTP requests in UK divided by the count of tenants, you can actually state that it's much higher than in us, so the UK is actually catching up quite fast, Finland, decimation, amazingly high as well Netherlands, Denmark, Germany, Sweden, Switzerland and Norway, and Iceland is first time ever in the top 10 from httprequest perspective can be interesting.

A

That is my visitor, or with only 18 tenants in sharepoint online, using BMP and sharepoint online and then from a count of tenant perspective. Us absolutely number one which we can say from the previous chart as well. Unit UK, 320, netherlands, is catching in to the UK will see if they can actually catch them to ministry in Norway, Austria, Australia, Denmark, France and Finland. So a lot of us a lot of European and then also Australia, is actually pretty high from a user's perspective or a count of numbers perspective as well good.

A

Just to let you know this was more around like mentioned. This is more around kind of showing you the pay. You are not alone using this kind of very usable, tooling and the PowerShell or the core component there's a lot of other people actually using the same tooling as well, which will hopefully help you to understand that you will get better support as well. Also, the numbers are for ship on the engineering and for the BMV initiative.

A

They helped us to essentially give us the right resources, because, if use it as high, we get more resources to fix stuff and make sure that everything is running smoothly in production as well.

A

A few notes around this one last week to SharePoint PMP, powershell commandlets reference, went live to the MSDN and I well their release, I'm just afraid that they are missed the URL. If you go a kms SBB and be the publisher, you'll actually learn to the documentation in MSDN. This is fully automatic documentation.

A

So, even though those documents are actually in the key table, they are being generated automatically, and that means that every single month, when we will do a monthly, merge and monthly release for the PMP, will update this documentation as well. If a final typo or you want to add an acceptable on this document themselves, do not modify the key top files to actually go and submit a change on the PMP PowerShell code itself, because everything what you say in here, except the welcome page, is fully automatically generated and kind of related on this one.

A

Just for the future reference as well. So we're looking into doing exactly the same for the PMP slide score. So the minutes core component to see some extension and then not related on BMD, but from a shape on the engineering perspective. We are actually working on doing monthly updates, also for the client-side object model, the native season, documentation and also we are trying to figure out. How do we do monthly releases for the full REST API surface? What we have on the SharePoint that will still take some time.

A

Unfortunately, do resource constraints and timing constraints, but sooner or later you will actually see the full REST API documentation available, also in in MSDN slash the future location of MSDN, because MSDN is gonna, be actually killed at some point, but that's a different topic: let's not actually even start that discussion, but anyway, so the PMP powershell reference documentation now in immersed in and for a lot of the other stuff will be documentation will be improved for the native SharePoint documentation.

A

Also for the PMP documentation in Emma stands well good, quit one slider for the modern sites creation- and this is successful updates.

A

We are working on something which were unable to get to fully ready for this today server and we are unable to demonstrate this one today, but within two weeks within the next special interest group call, which is on 8th of March, we will absolutely have this one ready so we're working on updated guidance and updated API guidance for creating modern team sites or modern or, let's say, unified groups together with that modern sharepoint site, which will is actually possible using sharepoint api's. So you do not need to hit the Microsoft graph endpoints.

A

We are, however, in the journey of making this documentation and the right support ability statement for those api's and that's the reason why we're not explicitly showing how to do that right now and just to be clear also in this one. So we will not support upon creation for modern sites in the future either.

A

The problem really is around the fact that and the azure ad and the exchange actually requires that there is a user context when you're creating the required assets, even though shape on technically we don't actually require them, and we are only in the sharepoint context, means that you will be running in a system account mode, and that means that you don't actually have a user context and that that why asha ad and the exchange operations would actually fail for the unified recruit to be created.

A

But essentially what it means is that you need to dedicate an account for your code, which is then running in the user in in quotes in a user context, which means that you can still use our share functions. You can still use a share webshops or whatever is your chosen pattern for the site provisioning, but you just need to use a specific account to folder operations and we're looking into obviously from a PNP perspective.

A

Released, simplified, see some extension methods for the new model, and this are targeted to be available in the PNP March 20 March 2017 release, which is going to happen on 10th of March, so the next monthly release on 8th. We are pretty close already on the on the most image and we can actually show on all of the new methods in practice.

A

Simplifying story. What it means is that you do not need to sign in against Russia ad. You can actually do classic SharePoint, client credentials or SharePoint Online credentials, access on SharePoint, and you can hit those endpoints and get a modern group to be created as well.

A

There is a question from Rolf: does this mean that we can avoid servers? We can support provisioning with the store apps. Well. Theoretically, yes, in practice, no, the theoretically.

A

Yes, it would mean that if the store apps would support a full trust, permissions and right now, the store apps do not support fortress permissions because you need to have a tenant level permissions still for the operations and also there's the requirement of using a specific account for this operations, which could be challenging to create if you have a store app but there's multiple, maybe theoretical options to make that happen whenever and if we will enable for trusts add-ins in or as well not gonna actually even start that discussion in this call, but let's actually move on and I.

A

Think Bert is gonna. Take Paul on from this slide forward. So Bert, please tell the control.

B

Yep, that's running so upcoming slides will give a bit more information around the work. We've been doing around how to program modern pages. So all of this is kind of. Let's call the preview think it does work, but it's not yet released. So we share this information with you already early, so you can offer feedback or suggestions. So if you see something that you think like, maybe we can do things differently or better, please let us know so.

B

A first step is creating a modern page, and actually that turned out to be relatively simple, because what is modern page, it's a list item in the site pages library list.

B

So essentially we have this add template file method, which is the first line on the code that you that I pasted it in which gives you a list item and a page library. Then the trick is to set the right content type. So modern pages do have a different content type compared to wiki pages, which also comprise that you can still mix and match different types of pages on one library. If you would want I to do so.

B

But if you want to create a modern page, just going to type use, what else is important to know here? Is it's this client-side application ID? Essentially, this is a feature ID linking to the modern pages infrastructure that we have in SharePoint Online. So you need to set this particular feature. Id a page has a layout type. Apparently it's always article might change in the future. But today it's article and then the most important field, I would say, is the canvas content, one field, so why you see this div tag today in a sample?

B

It's like the wiki pages, where we get the the content via HTML I. Just that's all refresh my memory, which exec field, but anyhow we have a field for wiki pages as well, but we saw all the HTML data and the same concept applies from modern pages. So, but in this case we saw it on a canvas content, one field.

B

So what? How does this canvas content? One field needs to be filled because that's the key to the next step being programming. Modern pages like I, want to essentially being able to add web parts. Clients have a pass on modern pages. How do we do that so before we go to the actual PHP support for doing that, I want to give you like a little bit of information on how the page is structured, and this information by the way is also available on Amazon already also in preview.

B

But if you go to our guidance around customizing modern experiences, there is a page for her. That explains how to customize modern pages, and this content is in that page here already today. So an empty page, really simple: empty div, clean HTML, plain simple, empty div.

B

Whenever you want to add controls on that page and a control can be a client-side web part or a text control. So rich text editor control, we they're slightly different. So that's why I talk about the different flavors, but you can add those type of controls on a page. Each control that you want to add on a page is surrounded by the read if tag weather data SP canvas control accurate. So when you see this guy, it means like there's a control inside this div tag.

B

This distich has some JSON data, so the data SP report data is a JSON object, describing the control inside the div tag on this case in the sample, this control type 4, which means the text control. The bottom sample is slightly more complex one. Essentially, this is an out-of-the-box image web part being brittle on a page.

B

So you can see this upper level differ at the data. Sp canvas control tank this case control data is slightly different because it says control type equal to 3, which points to a client-side web part and then inside there is a dip with data ESP web part and additional properties, and a lot of JSON data describing the actual web part directions the title to a path description. Is there the parameters of the report? Are there everything that kind of controls? Where path is there?

B

It's similar to the old web browser data that you would need to prove a give the sharePort when you would put a classic web part on a classic page, but then in the modern variant in case on this case, you quit of course craft your own codes. That kind of spits it out and puts- and if you get this rights- and you put it on a page- it works and you have a modern page spot but yeah that's a lot of work to do and these things might evolve over time.

B

If we add new capabilities, so I think the advice way to work with this currently is to work with the PP modern page object model of whatever. We want to call me to think about a name that serve to really give this app a clean name. But so this is a really preview.

B

What do we have and I will show a demo of this? First of all, this new extension methods on the web object. So if you have a web object, type dot, you can say add client-side page provide, give the name and create a new client sites, page empty client-side, page there's a second extension methods, load clients, a page where you can take an existing which can have like ten controls on it and you load it inside the PNP. A client set H object model.

B

So essentially, this load client side will give you a client side, page loss instance. So the one pop right and then you can start manipulating that that page in memory, so you can start adding controls if you move the controls are shifting controls around all that and then position back to SharePoint. That's kind of the idea around this guy into this object model.

B

Now I think demo will make things more clear. So, let's do it and just again repeating this is a preview things might change with definite targets to have it available in the March release, and if you want experiment with it's right now, you can of course always ready grab this from the dev branch because it is checked in and to death. Just confirming. Can everyone see my screen I.

A

B

Yeah right good, so little simple, demo, application. This is a console application and I've. Just hooked up offers FTM be called def code base. Essentially because, if I don't have you to package it with as of March you you can just do the same with the nougat package.

B

So what I will be doing a demo is creating a SharePoint client context using the litigation manager class, then I have five little demos, so I'm gonna, just click off them already. An established that run over them will show you the results. So let me press f5 kick off this small application.

B

It will ask my passwords.

B

Right so, first demo, let's create an empty page. So, first of all, just to show you guys if I'm, not cheating and I, need to drag this room to the right screen. Here we are. This is my test site with a number of pages. There is no PNP rocks page. Currently, so let's create a PNP rocks of a specs page, the site. Then it will run, and hopefully we don't get an error which is good, and we should have this page going back to the library refreshing, the page.

B

Let's give us a PNP rocks page going over here. You'll see this is a plain empty water. On page nothing's, on the cone. Nothing is on the page, just simple empty page, but.

A

You have a custom friending, yay yeah.

B

It's actually really old branding as well. You recall it for college for.

A

Networking 2014.

B

Sharepoint conference 2014 yeah, but you see a size laying around which I miss you is for testing all right. So we created this page, and this is also an example of our extension method. So you CCC built web and then it's like the head, client side, page extension method.

B

It does give you a page object back, so you couldn't start from here and then do something more with the page and then save it back. But we come to that in a second. So in a second demo, I'm gonna start from a template page, so I'll give you I have summary page, which I want to this case. I'm gonna copy this page and extend it or I could just change the page as well. So if you want to add a copy of change a page, you will need to load it first and this.

B

What is it? What I'm doing here so I'm? Creating a client-side page object by calling a static here, methods loads on the concert pitch class, providing the client context and the name of the page that I want to load so going over. Here there is the template page, which does contain an image. So it's fairly simple page one control on the page, an image so I'm gonna load, this page, pressing, f10 and now I have an object model to manipulate the pitch. So I have a page object. The page object has controls.

B

There is one control, an error and the control has properties. So this is an immature one. So we see there mr. crawled down. You see the type the client-side web part.

B

So there's a lot of data being fetched from the HTML and put in this object model which allows you to then start manipulating it. So, let's add a client-side text control. So a rich text, editor control with the text feed erupts, let's create a control, so it's created, let's edit, with order minus one. Essentially I want to have this control on top I want to be the first one right.

B

So at this point it is edit in memory in my ear page, so I have two controls right now, but it's not yet on the actual share one day: she because it didn't save it. So it's in memory. What else can we do? I already deployed a custom client-side report that I created to that site with the name hello world?

B

So let's put that custom price of a part on the page as well to do so, you could instantiate your own client-side web browser control and correct and try to set everything up correctly, but the easiest way to do so is actually ask the page. What are the client-side components that are available for us? Actually ask the SharePoint site give me all the kinds of components that you can put on a page which is this available, client-side components method. So it gives me back a long list of client side components that I could use.

B

This contains all the out-of-the-box components like the image of a pair of the image gallery. The news feeds all of those things. This case I'm actually interested in finding my preferred name, hello world. So, let's find it so we're for one instance of the web found and I'm now going to instantiate the class of web parts, starting from my web path, is seated in the constructor I pass.

B

The information I received from the page around sneller over part posit inside the constructor to create a client-side web browser control, which you then add on the page and finally, just to close down I'm gonna save the page to a new name, so I load it from template page today speaks I'm, gonna, save it as page which controls at hpx. Then what happens right? The sees is that the implementation will render the proper HTML and update the canvas content one field in the list item.

B

So let's go back to this over here to the pages library we have a new page, called page with controls. Let's open up, you see that we have now PNP rocks on top scroll down. You see here that we have our famous well this guy, our famous hello world's worth, showing all the libraries in the site so work all right there mode 3.

B

What's what if you could also add an existing out of the box where path to a page, and we can so this time, I'm gonna start from a an empty client side, page I'm, just gonna, it's a seared classic page and the constructor I pass. The client context object as soon as you need to interact with SharePoint. You need to have client conflicts object in the page model, otherwise it will throw an exception and context, I'm, gonna, in-state and out of the box web part.

B

So what I'm gonna do is, let's similar to previously I'm gonna, ask the page what are all available web parts and pick the right one now in this case, to make the easier for you to pick the right one. We have this this enum, let's Jim listing all the possible of the buffer process that you can pick from. So you picked the right one, this case image and will pre-populate and pre create. Actually you control, which already this the properties set for the image of a part.

B

Then you need to configure your image of a path so for the folks who are already try to ensure part, when you add it to a a page as the end user, it will ask you to select an image if you promote eclis, do this, you have to provide that information programmatically.

B

So in this case, what happens is that image webparts just have a properties of any clients that reproduction it does have a properties.

B

Attribute, which is of the type J, the J key token J objects are each a object type which allows you to just kind of on easy way. Write an update. The JSON string inside so essentially I'm this construct over here, where I'm setting the actual properties will eternally update this type of JSON string that we have inside this object.

B

Because that's what, when you say back to SharePoint SharePoint needs to have this data in JSON format and the control will handle that, for you, so no worries it offers you an easy way to sets the right opportunity, control.

A

And Burt, if I may quick jump on on on this particular status and topic, so obviously those properties which Burt are feeling right now are with part dependent, so every single webpart have their own client-side web part properties, and these are the ones if you, if you haven't done, for example, SharePoint framework tutorials, you actually define web part photo for your custom web part as part of the tutorial. So this is slightly awkward.

A

Noise, so let's actually meet there. We go so this it's slightly awkward that you need to figure out those individual properties per web part, but that really comes down on the fact that every single web part has their own properties and they are decided by the developer of the web part either in engineering as a first party web part or a third party web part, which is when it's coming outside of Microsoft engineering.

A

What we're looking into! Actually, we already had a internal discussion into engineering around this requirement, because the remote provisioning is a obviously well-known and highly demanded capability. We're looking into having in the web part workbench a capability where you can get all of the properties as a JSON plop.

A

So essentially you can configure the web part in the web, part workbench and then you are able to say, hey give me the plop and you'll, get the needed properties or you'll get the list of properties exposed in the workbench as well yeah and that's a future development for the workbench. Just jumping on between on the discussion. No.

B

That's correct: well, if you look it's the old classic web parts, you would also have to understand the properties, if you so that you could kind of indeed grab from SharePoint sites. So you have some complex, but you know the same here, so you could perfectly reverse-engineer which put over the web part on the page grabs the the content in the canvas content and investigate Howard I was Jason or figured what the prophetess mean.

B

So you can today already do some kind of reverse engineering to figure out what it means and then set the right values.

B

One other thing we have been thinking about that we didn't do yet, so we might not do at all. But maybe we can ask for feedback it's like. We now have I canvas control class. Then we have clients a rapid control which inherits from the canvas control class. We could have an in client side image control which has on the client side web control, which makes it easier for us developer to configure this.

B

The gender downside is that we have to always kind of keep going to try running, maybe running after-effects, hopefully running before defects, but it's yeah. It will be more work here, and so we were kind of doubting whether that's will be worth the effort or not. So initially we will release it with this. This model, where you have a class of a path that you can configure and as fast to mention, you can get them all free diffusion properties using the workbench.

B

Alternatively, donnelly is that when you associate the web part with this guy over here, the default property set is already available. So when you design a web part in a manifest there is the default properties set as well, so that information will already be available for you, which already does help a little bit all right going back over here, so properties, assets, I'm, gonna, add the control again. Some of the previous demos had this a mature part to the page and then I'm gonna save the page.

B

So the page is saved as a name page with image. Let's go over here, whereas my Chrome, they just reach with image and voila, pretty simple page with one image showing in this case as your web book function.

B

Okay, just to complete the small demos, I can delete the page as well, so you load the page page with controls is gone, so no page with controls anymore same way same way. We can also delete the web part, so I could get the first control of the page and save it again, and then this case the image will be removed from my page with image load this one again, it's empty should be empty. It is empty. Alright.

B

What else can you do? You can play around with the order of the controls? I think that's kind of sums up most of the capabilities in this current version. We have well.

A

The question Bert would be what else capabilities would be needed, so we can create a page. We can delete the page, we can add stuff on the page. We can add web parts on the bait. We can add. First party third party web parts on the page, I think they're pretty complete from that perspective. So at least for now so I.

B

Think as well good create.

A

Demo and great to have these extensions in the PMP, which will no doubt simplify how to manipulate the stuff from a within a sharepoint pages and then, obviously, right now they are in a core component, we're looking into having piped powershell commandlets for some of these operations as well, so you're able to actually create ATS and everything else from a powershell as well and then being a provisioning. Engine.

A

Support will, however, require schema level changes, so we're looking into those ones as well in the future, but step number one is always to have the right: the the capability implemented in the PNP side score. Unless it's in the native system and from there we can start expanding the PNP, powershell and provisioning engine, but great demo.

A

Thank you, good I think the following thing: maybe we'll jump right away on Paulo and then we can do a Q&A after Paulo as well, because there will be just a slide where we're introducing Paolo's demo, Sao Paulo feel free to take a take. The screen sharing, okay,.

C

Thank you, visa and Thank You Bert. Let me start sharing my screen and please let me know when you will see it. Yes,.

C

Loading was likely not.

A

Yet actually yeah.

C

Okay, can you see it now nope.

A

C

Okay, so this demo is about the new setup wizard that we are going to release in the PNP partner pack v2 and just to set the context. If you already install the PNP partner pack, you know that we made available a long document with a full list of steps that you have to follow in order to setup the PNP partner pack and in a manual setup guide.

C

If you scroll down to the installation steps you can see, they have a bunch of steps to accomplish to properly configure the PNP partner back in the target of history's five tenant. So we decided a few months ago to build a solution which will automate all of these steps for you, so that you can simply focus on some input argument that you will have to provide to this tool and you will be ready to have the entire PNP partner back fully set up for you without any kind of issue or typo or error.

C

That could happen whenever you do the manual setup of the entire environment. So let me show you the sorry about that I've above I've, some kind of curve. So maybe some time I will have to stop coughing and sorry about that. But let me start with the setup tool, application and then I will show you how it works under the cover. So I will move to visual studio in which I have the PNP partner pack solution. There I added a new set up project.

C

This guy off is the PNP partner pack setup and through this tool you can do the automated setup. The idea is not to provide you a kind of double click.

C

100% set up as like, as you would setting up a classic desktop application, because there are a bunch of things you have to do or a bunch of settings you have to provide to the tool, so you can simply execute the tool from register if you like or from the file system, but you will have to do a download full download. Other of the master branch right now to set up tool is just in the dev branch.

C

By the way you will have to get a full download of the branch or you can do a fork and then pull the source code on your environment, and then you will be ready to build the tool and run it. The tool knows where are the other projects that made up the entire partner pack solution and will build them for you with publish them on Azure and so on so forth? So that's why I'm, starting right now from visual studio and just to keep the demo faster I already created the infrastructure as a collection.

C

That is one of the requirements of the PHP partner Packer because, as you probably know, preheating a fresh new set collection in SharePoint Online requires some time takes quite a long time.

C

So, instead of wasting ten minutes watching a progress bar becoming wider and wider I prefer to create a fresh new set collection before the execution of this demo, and so my test tenant that I created I already have a PNP partner pack infrastructure asset collection, which is the well-known one for those of you already installed that the partner pack, but the tool will create it for you and will apply all the provisioning template onto the target site for you. I will just skip this step in my own demo.

C

I already have also an office 3 space or a nature subscription ready completely empty right now, because I will use this subscription to host all of these services and the content needed for the PNP partner pack. But right now, as you can see, it is completely empty. So let me start the application and let me show you how it works, usually, on average, it takes about 20-25 minutes to do the full setup of the solution.

C

I mean the tool will need between 20 and 25 minutes to create all of the artifacts, so we will not most likely. We will not wait for this long time, just watching the video I will show you some information about the code under recover and if we will be lucky and the setup will complete before the end of this call, that's okay. Otherwise, just let you know in here coming days, I will record with the visa a webcast in which we will see the full setup process.

C

So, first of all, in order to and this tool you have to provide the office. This is five connections that will be used to configure the needed artifacts in SharePoint Online, as well as in the issue of subscription that you will need to have under the cover of your office. This is five a tenant because, for example, there will be the need to register the office trees, five application inside the rack, the directory that sits under the cover of your office. This is 510 and in fact it yeah.

C

We say: okay, please provide the credentials of an officer, 510 and global admin, and you will need to add Microsoft Azure subscription active. If you don't have that one. We cannot automated that step. So you will have to create a subscription, and then you will be ready to play with the tool by clicking on the login button using ADL. We can do the login against the target. Tenant I will use this test user in this test environment and, as you can see, the tool will infer a bunch of information from the tenant.

C

So if you like, you can just provide the login credentials and then you will find a bunch of information already filled in by you there. For you, sorry, of course, if you want you can change the values. If you want to do an easy setup, you will have to provide just three information. The login I showed you the password for the x.509 certificate that will be generated by the tool for you or if you want to use a certificate of your own, you can upload it. Selecting the upload option.

C

I will provide a password here and I will how to generate the certificate. Then it will also provide the URL for the infrastructure set collection and all the settings needed to create that one. Even if in this demo, we already did it and after that, you will also have to provide the third and last input minimally input.

C

I would say, which is the one for accessing the issue subscription, the one in which you will publish through the tool, the issue website, the block storage, the 5:09 certificate and all the other stuff needed by the PNP partner Peck. So let me log in one more time and it's a different looking could be exactly the same if you want to share the same issues, affliction for the services and for the office by tenant, but usually I, suggest to separate them.

C

I would provide my password for my account here and because I have a bunch of subscription as like, as many of us I will have to select the target one. The list of subscriptions has been downloaded using the api's of issue, as well as the location in which I wanna place the services that will be created again. I have a couple of auto-generated names for the app service name and for the blob storage name. If you want, you can change them.

C

So, by clicking the setup button and just providing these three information, we will be ready, as you can see, I intentionally put a breakpoint here, because I want you to show you that I commented just for these Leah Modi creation on the first natural, safe collection. But now I will move on and, as you will see, the application will do a bunch of stuff for you. It will create an external certificate, it will register the application in is already in the issue.

C

Ad of the officer is 5 10 and it will create the issue resource group, a Europe service and the Asia blob storage. It will configure the office thesis 5 application to use an exponent certificate in order to do up only access against the tenant and SharePoint Online in particular, and so it will have also to upload and configure that certificate in the Europe service that will be created.

C

Usually it takes a while to provision all the issue artifacts, so I will move to the cold side of the demo and I just want to show you what are the main steps covered by the tool which are all the steps needed by the way. So, as you can see, we create infrastructure as a collection. We created cyber 9 certificate, we create the user ID application, we create an Asia or the users group drops, though rich in the up service.

C

Once we have done all of these steps, we are able to update the config files of the projects and I use the plural known because we have the web project and we have four timer jobs, sorry web jobs in issue, and so just after having a customize the settings in the config files, it will build and publish on the issue of service the pnp partner pack website, and then it will build em published before time of jobs that we have again sorry web jobs that we have in the PHP partner pack using exactly the same up service as before.

C

So let me go back for a while to the tool. Just to see where it is okay, it already created all of these services connection, and now it is building the project and the uploading the project onto the page web service, which takes quite a long time as usually especially today that I don't have a very good bandwidth and sorry about that.

C

But if I refresh this UI, you will see that I already have a resource group created for me and I have an issue of service as well as, if I go to all of my resources.

C

I also have a blob storage that will be used to store messages in the cube storage, cube that we use for the continuously running job, and if we will be lucky from a timing perspective at the end of the setup process, I will be able to show you the web jobs configured inside the app service on the other side in the infrastructure set collection.

C

Of course, we already have the libraries that we need to store the template, the provisioning templates and the jobs, and if we go to the issue, ID tenant, which sits under the cover of our office versus five, a tenant I will be able to show you that within the Active Directory of my tenant, which is this guy okay, here it is almost as soon as the up registrations link will be ready. I will be able to show you that we have the TMP partner pack application produced read here.

C

It is with all of the needed information like, for example, the client ID, the home page URL, but we will also have the client ID. Yes, the client ID and the shared secret for our application already created, and we will have all of the permissions set up in the environment for consuming offices.

C

Five and SharePoint Online especially, is ready and Microsoft graph, so it is doing all of the stuff for us and for you it is still publishing, building and publishing the application, as I told you, it takes a while because it has to do the full build of the application. It has to do the upload of all of the files onto the target environment and it can be faster if it was fast bandwidth, but really depends on the bandwidth you have.

C

So, if I go back here, just to show you a few examples of how it works. Of course, when we create infrastructure estate collection, we just used PNP core, and you should already know how to do that when we create a x.509 certificate, we have some helper methods or utility methods that create for us this certificate, using the api's provided by comm in Windows and, moreover, for example, to focus on the registration of the usually the application.

C

Here we use the Microsoft API, the beta version of the API, so that we are able to upload a JSON file like this one, which will have to be filled in by the application before uploading this file, and this will be the manifest of the application that we will create here. You can see in the required resources property.

C

We have an array of all of the required permissions that we need in our application here, I simply load that file I set. Some of the properties of the file and then I use the graph API I get an access token and I use the graph API to do the upload of the issue ready application.

C

Let me show you here: I just make an HTTP request: I make a post request targeting the applications and point of the micrograph API beta, endpoint and I provide the application manifest as an object, which will be sterilized as a JSON message and will be used by the browser to create the application so really really powerful. If I go back here, sorry, okay, if I go back, I can also show you that we create all of the Asia artifacts still using the same approach.

C

So, for example, when we create the resource group, we simply configure the name of the start we need to create, and then we have some helper methods that again we'll just make HTTP requests or get or post or put depending on what we want to do. Using the issue. Management api's, which are a set of REST API, is available that you can use to create so to make the creation of artifacts and services on Asia. At the very end, we do the we build the solution, and here we have. Let me close this guy oops.

C

Okay, we to build the application and in order to build and publish the application, we use a PowerShell file and a standard PowerShell file, which is this one for the website in which we simply use the Microsoft unless build tool which we get from the registry, just to be sure that we have the right part of the tool and we will run ms builder providing a bunch of parameters that will instruct the tool to do the release builder of the project and to deploy on build based on a publishing settings file.

C

Sorry, my publisher, satisfied that you can download from the issue management API and that's what we do in this tool. So let me go back just for a few seconds. It is still publishing. So maybe we can open the my question. Meantime. Yes,.

A

There's a good question from Cho from the iron window already on this one. So could we be use this? One also updates to push updates on the provisioning engine.

C

Not on the provisioning engine but on the PNP partner pack, I mean this tool. Right now creates a fresh new installation, but I'm already working on adding the duty to update an already existing application and to be fair already, almost 50 percent of these steps are able to handle in update instead of an install but I plan to be able to do a full upgrade of the PM paternal pack.

C

So whenever we will release a new version, you can just download it and run again the tool providing the same input parameters and it will will update your environment.

C

A

Actually update the provisioning engine as well, because.

A

The other point of what I wanted to kind of call out is that the whole source code, what you're seeing here, is available already in a github in the inter PNP partner back, and this is actually a create demonstration how to perform automation against office, 365 I'm, not sure so. The value of this one and this tool- and this wizard is not just the fact that you can easily set up a PMP portable. It's also the fact that he quite often people need to automate this kind of things for the customer deployments.

A

It actually shows how to make that happen.

C

Yeah and you are fully free to reuse, whatever you like in the source code, of course as there's, always because it's PMP so sharing is caring, indie still working on it. So if there are more questions, I think we can take them visa. We can come back to the user screen. Maybe we will be lucky enough to see the fully running a website, maybe not, as I told you it takes between 2025 minutes to do the full setup. Yeah.

A

I think we started that that provisioning, when we had 18 minutes time within our, but we have 4 minutes if there's any random other questions on, let's say the modern provisioning and debate is for Bert or me or engineering, or for Paolo or whatever feel free to ask any questions. While we wait things to complete in this sign, if there is any questions, no questions whatsoever because I don't want to actually flip on the slides.

A

So it's the web part I'd on a site and a web, so the client-side web parts when you provision a client-side web part, it is, it depends on a web form. So if it's a client-side web part which do not have any site level assets like lists and content types and fields which actually it can have, you do not need to install anything on the site.

A

So it's a tenant level, deployment of the web part and whenever you are then hitting the API for getting the list of client-side web parts, you will actually say that web part available. If the web part has in the in the web part deployment file or in the app file it. If it actually has a dependency on a list, for example list instance to exists on a sign, then it has.

A

It is kind of a considered as a list level instance from that sign, we're working on it or updated documentation on that one as well, and that lands in the left of Stratcom slash SharePoint within few days. So that should be fun. Mr.

B

So, in the latter case, you have to actually install the client server first first to decide an app the correct webparts. Yes, because the PK 18 so lot insight at that point. Api will see it and will return this possible correct. Yes,.

C

Just a quick update, the website has been created and now we are uploading building and applauding before web jobs, but if you like, visa I can, in the meantime, take a few seconds to show you sorry here, but within the issued website now we have all of the settings should take just a few seconds in the application settings come on okay. Here we are application settings, and here we have the needed settings to run. Oh come on, it's not deleted. So please refresh.

C

Sometimes it happens when you have just created the app service using the agent management API. It could happen that you cannot find all of the information in the portal.

C

It takes a while some time to update information on the other side, and it looks like right now it is taking a while, but we will have the settings and the SSL certificate uploaded. So just let's wait and see what happens.

A

B

Any other question.

A

We're hitting the on the hour as well so I think it's we're forced to close up it's pretty close anyway, like Paula mentioned for the PMP part at least hard. We will record a webcast PMP webcast later this week and that will go most likely live next Monday. So there will be a video where we will then edit all of the wait times and everything else.

A

If there is any so you can actually see when it's done and completed and all of that, but for now I think it's time to close up our okay, our today's session, so I'm just gonna quickly go to the slide and just do a closing slide just for the sake of the video, nothing more than them, but Thank You Bert for the great demo on the site, page beta site modifications and just a reminder on that forum. So Dynasty, an article related on that one has been already updated.

A

So we do have an MST and guidance on how to provide manipulate the modern pages and on the BMP partner backs and setup site like mentioned it is it's already available in a dev branch. It's gonna be released in the March release of the PMP, so we will do some additional testing on that one. This is a preview of the capability, but it shouldn't be changing that months at this point anymore, because Paulo doesn't do any box, he never does that.

A

He just writes everything at once, of course cool. But thank you everybody for joining. Thank you for watching and we'll hoping to see you in a few weeks. Next, in a next week, we will have special interest group for SharePoint framework and the week after that we will have another special interest group for PNP site score and PowerShell and provisioning on that one.

A

We will absolutely demonstrate the new API support for the modern site creation without the requirement of going to the Microsoft craft, but thank you everybody, let's close up for the day and please keep on submitting issues and having comments and discussions in the Microsoft tech communities and everything else. Let us know how things are moving. Thank you.