Update site-design-json-schema.md

Updated for Spring 2018 release. Changes include: attribute updates for addSPField; addSPFieldXml; createSiteColumn; addSiteColumn; createContentType; addSPView; removeSPView; installSPFXSolution; setRegionalSettings

Author: seansquires

docs/declarative-customization/site-design-json-schema.md

@@ -91,10 +91,12 @@ Adds a new field.
 
 JSON values:
 
-- **fieldType** - The field type can be set to **Text**, **Note**, **Number**, **Boolean**, **User**, or **DateTime**.
+- **fieldType** - The field type can be set to **Text**, **Note**, **Number**, **Boolean**, **User**, or **DateTime**. For other data types see the addSPFieldXml action.
 - **displayName** - The display name of the field.
+- **internalName** - An optional attribute. If provided, specifies the internal name of the field. If not provided, the internal name will be based on the display name.
 - **isRequired** - True if this field is required to contain information; otherwise, false.
 - **addToDefaultView** - True if the field will be added to the default view; otherwise, false.
+- **enforceUnique** - An optional attribute that defaults to false. If true, then all values for this field must be unique.
 
 Example:
 
@@ -125,9 +127,193 @@ Example:
 }
 ```
 
+### addSPFieldXml
+
+Enables defining fields and their elements using Collaborative Application Markup Language (CAML). For reference see: https://msdn.microsoft.com/en-us/library/office/aa979575.aspx 
+
+Currently these field constructs cannot be designated as site columns nor added to content types.
+
+JSON value:
+
+- **schemaXml** - The CAML block to define the field.
+- **addToDefaultView** - True if the field will be added to the default view; otherwise, false.
+
+Example:
+
+```json
+{
+    "verb": "addSPFieldXml",
+    "schemaXml": "<Field Type=\"Choice\" DisplayName=\"Project Category\" Required=\"FALSE\" Format=\"Dropdown\" StaticName=\"ProjectCategory\" Name=\"ProjectCategory\"><Default>Operations</Default><CHOICES><CHOICE>Operations</CHOICE><CHOICE>IT</CHOICE><CHOICE>Legal</CHOICE><CHOICE>Engineering</CHOICE></CHOICES></Field>"
+}
+```
+
+### addSPView
+
+Defines and adds a view to the list. Use this action to specify the desired columns and how you want the list items displayed (using a CAML query). Subactions allow you to specify row limits, whether the view is paged, and recurses over items in nested folders or not. You can also designate your constructed view as the default.
+
+JSON value:
+
+- **name** - The name of the view.
+- **viewFields** - an array of the internal names of the fields in your view.
+- **query** - A CAML query string that contains the where clause for the view's query. See https://msdn.microsoft.com/en-us/library/ms462365
+- **rowLimit** - The row limit of the view.
+- **isPaged** - Specifies whether the view is paged.
+- **makeDefault** - If true, the view will be made the default for the list; otherwise, false.
+- **scope** - An optional setting to specify the scope of the view. For more details see See https://msdn.microsoft.com/en-us/library/microsoft.sharepoint.spviewscope.aspx
+
+Example:
+
+```json
+{
+    "verb": "addSPView",
+    "name": "Contoso Projects by Category",
+    "viewFields": 
+    [
+        "ID", 
+        "Title",
+        "siteColumnUser",
+        "ProjectCategory"
+    ],
+    "query": "<OrderBy><FieldRef Name=\"ProjectCategory\" /><FieldRef Name=\"siteColumnUser\" Ascending=\"FALSE\" /></OrderBy>",
+    "rowLimit": 100,
+    "isPaged": true,
+    "makeDefault": true
+}
+```
+
+### removeSPView
+
+Removes a view from a list. This action can also be used to remove a view applied by the site template.
+
+JSON value:
+
+- **name** - The name of the view to remove.
+
+Example:
+
+```json
+{
+    "verb": "removeSPView",
+    "name": "All Items"
+}
+```
+
+### createSiteColumn
+
+Defines a new site column that can then be associated to a list directly or using the addContentType action. 
+
+JSON value:
+
+> [!NOTE]
+> When referencing the content type ID only one of the three references are required - ID, parentName, or parentId  
+
+- **fieldType** - The type of column to add. Supported values - like SPField - are Text, Note, Number, Boolean, User, and DateTime. For other data types refer to the addSPFieldXml script action. 
+- **internalName** - The internal name of the site column.
+- **displayName** - The display name of the site column.  
+- **isRequired** - True if this field is required to contain information; otherwise, false.
+- **group** - An optional attribute to designate the column group.
+- **enforceUnique** - An optional attribute that defaults to false. If true, then all values for this field must be unique.
+
+Example:
+
+```json
+{
+    "verb": "createSiteColumn",
+    "fieldType": "User",
+    "internalName": "siteColumn4User",
+    "displayName": "Project Owner",
+    "isRequired": false
+}
+```
+
+### addSiteColumn
+
+Subaction to add a previously defined site column directly to a list or content type (exisiting or created through the site script).
+
+> [!NOTE]
+> This action can be used to add created site columns to a list or content type.  
+
+JSON value:
+
+- **internalName** - The internal name of the site column to add.
+
+Example:
+
+```json
+ {
+    "verb": "addSiteColumn",
+    "internalName": "siteColumnUser"
+ }
+ ```
+
+### removeSiteColumn
+
+Subaction to remove a site column from a list or content type. 
+
+JSON value:
+
+- **internalName** - The internal name of the site column to remove.
+
+Example:
+
+```json
+ {
+    "verb": "removeSiteColumn",
+    "internalName": "siteColumnUser"
+ }
+ ```
+
+### createContentType
+
+Defines a new content type that can then be associated to a list using the addContentType action. 
+
+JSON value:
+
+> [!NOTE]
+> When referencing the content type ID only one of the three references are required - ID, parentName, or parentId  
+
+- **name** - The name of the content type to create.
+- **description** - The optional description of the content type.
+- **parentName** - Name of the parent content type. 
+- **parentId** - ID of the parent content type.
+- **id** - ID of the content type.
+- **hidden** - Specifies whether the content type is visible or hidden.
+- **subactions** - Specifies subactions to run on the content type. These are used to designate the site columns to add.
+
+Example:
+
+```json
+{
+    "verb": "createContentType",
+    "name": "Contoso Projects",
+    "description": "custom list content type",
+    "parentName": "Item",
+    "hidden": false,
+    "subactions":
+        [
+            {
+                "verb": "addSiteColumn",
+                "internalName": "siteColumn1Text"
+            },
+            {
+                "verb": "addSiteColumn",
+                "internalName": "siteColumn2Number"
+                },
+            {
+                "verb": "addSiteColumn",
+                "internalName": "siteColumn3Note"
+            }
+        ]
+}
+```
+
 ### addContentType
 
-Adds a content type to the list. Currently these are limited to only the default content types included in the site template.
+Adds a content type to the list. Currently these are limited to the default content types included in the site template or ones defined in a script using the createContentType action.
+
+
+> [!NOTE]
+> Currently we do not support adding enterprise content types.  
 
 JSON value:
 
@@ -274,6 +460,9 @@ Example:
 
 Use the **createPage** verb to create a new page on the site.
 
+> [!NOTE]
+> The createPage site script action is in preview and is subject to change. It is not currently supported for use in production environments.
+
 JSON values:
 
 - **fileName** - The name of the file.
@@ -304,7 +493,10 @@ Example:
 
 ## Set a site logo
 
-Use the **setSiteLogo** verb to specify a logo for your site. This action only works on the communication site template (68).
+Use the **setSiteLogo** verb to specify a logo for your site. 
+
+> [!NOTE]
+> This action only works on the communication site template (68).
 
 JSON value:
 
@@ -326,13 +518,14 @@ Use the **joinHubSite** verb to join the site to a designated hub site.
 JSON value:
 
 - **hubSiteId** - The ID of the hub site to join.
+- **name** - An optional string specifying the name of the hub site.
 
 Example:
 
 <!-- TBD: add link to Dave's hub site documentation -->
 
 > [!NOTE]
-> Hub sites are a new feature that are just rolling out to customers in Targeted Release in March 2018. 
+> Hub sites are a new feature that are just rolling out to customers in Targeted Release in March 2018. This action might not be available for use in your environment. To learn more check out https://docs.microsoft.com/en-us/sharepoint/dev/features/hub-site/hub-site-overview
 
 ```json
 {
@@ -341,6 +534,27 @@ Example:
 }
 ```
 
+## installSPFXSolution
+
+Use the **installSPFXSolution** action to register a deployed solution from the app catalog. 
+
+JSON values:
+
+- **id** - The id of the catalog solution. 
+
+Example:
+
+> [!NOTE]
+> To get the solution ID login to a site using Connect-PnPOnline cmdlet and then run Get-PnPApp. This will return a list of your deployed solutions.
+
+```json
+{
+    "verb": "installSPFXSolution",
+    "id": "d40e4edc-a6da-4cd8-b82d-bba970976803"
+}
+```
+
+
 ## Trigger a flow
 
 Use the **triggerFlow** verb to kick off a custom flow.
@@ -365,6 +579,30 @@ Example:
     }
 }
 ```
+
+## setRegionalSettings
+
+Use the **setRegionalSettings** action to configure the regional settings of the site (/_layouts/15/regionalsetng.aspx). 
+
+JSON values:
+
+- **timeZone** - A number specifying the time zone. For list of permissible values see https://msdn.microsoft.com/library/microsoft.sharepoint.spregionalsettings.timezones.aspx
+- **locale** - A number specifying the culture LCID. For list of permissible values see https://msdn.microsoft.com/en-us/library/ms912047(v=winembedded.10).aspx
+- **sortOrder** - A number specifying the sort order. For list of permissible values see https://msdn.microsoft.com/en-us/library/microsoft.sharepoint.spregionalsettings.collation.aspx
+- **hourFormat** - Specifies whether the site should use 12-hour or 24-hour time format.
+
+Example:
+
+```json
+{
+    "verb": "setRegionalSettings",
+    "timeZone": 2, /* Greenwich Mean Time */
+    "locale": 1050, /* Croatia */
+    "sortOrder": 6, /* Croatian */
+    "hourFormat": "24"
+}
+```
+
 ## setSiteExternalSharingCapability
 
 Use the **setSiteExternalSharingCapability** to manage guest access. For details on these settings refer to: https://support.office.com/en-us/article/Manage-external-sharing-for-your-SharePoint-Online-environment-C8A462EB-0723-4B0B-8D0A-70FEAFE4BE85