Fljótur og Þægilegur: Búa til SharePoint Site Using REST

There are a lot of resources around that show how to do this, but I couldn’t find a comprehensive go-to link, so here we are.

You can create a SharePoint site using the REST API.  Here’s a fully baked example:

<!--
    SiteRequestForm.html: Collect information and create a site for the user.
-->

<miðstöð>
<borð>
    <tr>
        <td>Site Name:</td>
        <td><inntak tegund= "Texti" nafn="SiteName" id="SiteName" /></td>
    </tr>
    <tr>
        <td colspan="2">
            <inntak tegund="submit" id="CreateSiteButton" gildi="Create the Site" />
        </td>
    </tr>
</borð>
</miðstöð>

<handrit src="../Plugins/jquery-1.11.0.min.js"></handrit>

<handrit>
var CreateSiteLogicContainer = {

    createSiteData: {
            "parameters": {
                __metadata: { "type": "SP.WebInfoCreationInformation" },
                Url: "Paultest1",
                Titill: "Paultest1",
                Lýsing: "rest-created web by Paul!",
                Tungumál: 1033,
                WebTemplate: "sts",
                UseUniquePermissions: ósatt
            }
    },

    createSite: virka () {

        jQuery.support.cors = satt;

        CreateSiteLogicContainer.createSiteData.parameters.Url = $("#SiteName").Val();
        
        $.ajax({
            url: "https://bigapplesharepoint.sharepoint.com/NBAIADev/_api/web/webinfos/add",
            aðferð: "POST",

            headers: {
                "Accept": "application/json; odata=verbose",
                "content-type": "application/json;odata=verbose",
                "X-RequestDigest": $("#__REQUESTDIGEST").Val()
            },

            gögn: JSON.stringify(CreateSiteLogicContainer.createSiteData),

            success: virka () { alert("success"); },
            villa: virka () { alert("error"); }

        });
    },

    wireUpForm: virka () {
        $("#CreateSiteButton").smelltu(virka () {
            alert("About to try and create the site.");
            CreateSiteLogicContainer.createSite();
        });
    }


}

CreateSiteLogicContainer.wireUpForm();

</handrit>

When successful, you get a JSON packet in response like this:

image

My key thoughts and learnings from this include:

  • This approach uses jQuery.  Í mínu tilfelli, my jQuery library is located in “../plugins.”  You’ll want to change that to point to your favorite JQ location.
  • You can copy and paste that whole snippet into a Content Editor Web Part on a page and it should work just fine.  You’ll want to change the end point of the API call and make sure you reference JQ correctly.
  • The URL is relative to your API’s endpoint.  Í mínu tilfelli, it’s creating sub-sites underneath https://bigapplesharepoint.com
  • You don’t need to provide a content-length. Some blog posts and MSDN document implies that you do, but happened for me automatically, which I assume is being handled by the $.ajax call itself.
  • This line is required in order to avoid a “forbidden” response: "X-RequestDigest": $("#__REQUESTDIGEST").Val().  There are other ways to do it, but this is pretty nice.  I have lost the link to blog that provided this shortcut.  H/T to you, mysterious blogger!

Good luck and hope this helps someone out.

</enda>

undefinedGerast áskrifandi að bloggið mitt.

Fylgdu mér á Twitter á http://www.twitter.com/pagalvin

Eftir svar

Netfangið þitt verður ekki birt. Nauðsynlegir reitir eru merktir *