Skip to content

Commit 16bb479

Browse files
authored
Merge branch 'master' into master
2 parents d573ba0 + 07fbc37 commit 16bb479

File tree

719 files changed

+35073
-11871
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

719 files changed

+35073
-11871
lines changed

.openpublishing.publish.config.json

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -23,13 +23,15 @@
2323
}
2424
],
2525
"notification_subscribers": [
26-
26+
27+
28+
2729
],
2830
"branches_to_filter": [],
31+
"git_repository_branch_open_to_public_contributors": "master",
2932
"skip_source_output_uploading": false,
3033
"need_preview_pull_request": false,
3134
"contribution_branch_mappings": {},
32-
"git_repository_branch_open_to_public_contributors": "master",
3335
"dependent_repositories": [
3436
{
3537
"path_to_root": "_themes",
@@ -55,4 +57,4 @@
5557
"nuget_feed": "https://www.myget.org/F/op/api/v2"
5658
}
5759
]
58-
}
60+
}

docs/apis/communication-site-creation-rest.md

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -38,7 +38,10 @@ body:
3838
}
3939
```
4040

41-
Note: New in this API is the concept of SiteDesignID. Much like the in-product site creation flow, the SiteDesignID parameter maps to the included site designs. They are:
41+
> [!IMPORTANT]
42+
> lcid parameter is not currently supported with this API. You can currently only create English sites.
43+
44+
New in this API is the concept of SiteDesignID. Much like the in-product site creation flow, the SiteDesignID parameter maps to the included site designs. They are:
4245

4346
- Topic: null
4447
- Showcase: 6142d2a0-63a5-4ba0-aede-d9fefca2c767

docs/apis/rest/determine-sharepoint-rest-service-endpoint-uris.md

Lines changed: 12 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
---
1+
---
22
title: Determine SharePoint REST service endpoint URIs
33
ms.date: 09/25/2017
44
ms.prod: sharepoint
@@ -8,15 +8,16 @@ ms.prod: sharepoint
88
# Determine SharePoint REST service endpoint URIs
99
Learn general guidelines for determining SharePoint REST endpoint URIs from the signature of the corresponding client object model APIs.
1010

11-
**Before you start**
11+
**Before you start**
1212

1313
- [Get to know the SharePoint REST service](get-to-know-the-sharepoint-rest-service.md)
1414
- [Navigate the SharePoint data structure represented in the REST service](navigate-the-sharepoint-data-structure-represented-in-the-rest-service.md)
1515

16-
**Next steps**
16+
**Next steps**
1717

1818
- [Use OData query operations in SharePoint REST requests](use-odata-query-operations-in-sharepoint-rest-requests.md)
1919

20+
2021
## SharePoint REST endpoint URI structure
2122
Before you can access a SharePoint resource using the REST service, you first have to figure out the URI endpoint that points to that resource. Whenever possible, the URI for these REST endpoints closely mimics the API signature of the resource in the SharePoint client object model. For example:
2223

@@ -27,6 +28,7 @@ List.GetByTitle(listname).GetItems()
2728
```
2829

2930
*REST endpoint:*
31+
3032
```
3133
http://server/site/_api/lists/getbytitle('listname')/items
3234
```
@@ -36,6 +38,7 @@ In some cases, however, the endpoint URI differs from the corresponding client o
3638
The following figure shows the general syntax structure of SharePoint REST URIs.
3739

3840
**SharePoint REST URI syntax structure**
41+
3942
![SharePoint REST request syntax](../../images/REST_OverallSyntax.png)
4043

4144
Some endpoints for SharePoint resources deviate from this syntax structure:
@@ -51,6 +54,7 @@ Some endpoints for SharePoint resources deviate from this syntax structure:
5154

5255

5356
## Determine SharePoint REST service endpoints
57+
5458
To construct a REST endpoint for a SharePoint resource, follow these steps:
5559

5660
1. Start with the REST service reference:
@@ -68,10 +72,12 @@ To construct a REST endpoint for a SharePoint resource, follow these steps:
6872
`http://server/site/_api/web/lists/getbytitle('listname')`
6973

7074
### Reference the SharePoint REST service in your endpoint URI
75+
7176
Use `_api` to denote the SharePoint REST service in your endpoint URIs. The REST service is part of the client.svc web service. However, to make REST URI construction easier and to shorten the base REST URI path, the REST service uses `_api` to abstract away the need to explicitly reference the client.svc web service. The REST service still recognizes and accepts URIs that reference the client.svc web service. For example, you can use `http://server/site/_vti_bin/client.svc/web/lists` instead of `http://server/site/_api/web/lists`. However, using `_api` is the preferred convention. URLs have a 256 character limit, so using `_api` shortens the base URI, leaving more characters for use in constructing the rest of the URL.
7277

7378

7479
### Specify entry points for the SharePoint REST service
80+
7581
The main entry points for the REST service represent the site collection and site of the specified context. In this way, these entry points correspond to the **ClientContext.Site** property and **ClientContext.Web** property in the client object models.
7682

7783
To access a specific site collection, use the following construction:
@@ -94,9 +100,9 @@ In addition to `/site` and `/web`, the REST service includes several other acce
94100
|Search|http:// _server/site_/_api/search|
95101

96102
### Navigate to the specific resources you want to access
97-
From here, construct more specific REST endpoints by ''walking" the object model, using the names of the APIs from the client object model separated by a forward slash (/). The table below shows examples of client object model calls and the equivalent REST endpoint.
103+
From here, construct more specific REST endpoints by "walking" the object model, using the names of the APIs from the client object model separated by a forward slash (/). The table below shows examples of client object model calls and the equivalent REST endpoint.
98104

99-
|**Client object model API **|**REST endpoint**|
105+
|**Client object model API**|**REST endpoint**|
100106
|:-----|:-----|
101107
|ClientContext.Web.Lists|http:// _server_/ _site_/_api/web/lists|
102108
|ClientContext.Web.Lists[guid]|http:// _server_/ _site_/_api/web/lists(' _guid_')|
@@ -185,7 +191,7 @@ If your REST URI terminates in a method call, you can use query string syntax to
185191

186192
`http://<server>/<site>/_api/web/applyWebTemplate?template="STS#0"`
187193

188-
the figure below shows the REST service syntax for parameters in query string.
194+
The figure below shows the REST service syntax for parameters in query string.
189195

190196
**REST service syntax for parameters in query string**
191197
![REST service syntax for parameters in query string](../../images/REST_parameterQuerySyntax.png)

docs/declarative-customization/column-formatting.md

Lines changed: 57 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -74,29 +74,58 @@ The following image shows an example of conditional formatting applied to a numb
7474

7575
![Severity warning of 70 with orange background](../images/sp-columnformatting-conditionalbasic.png)
7676

77-
This example customizes a number field to color that field yellow when its value is 70 or less. This example adds a style attribute to the parent `<div />` element, specifies a CSS class (`sp-field-severity--warning`) to apply to that item if the value inside the field is less than or equal to 70, and specifies no color if the value is outside that range (in which case it will use the default color for values in that list view).
78-
Note: this example uses a binary operation with the less than operator, "<", nested inside the conditional operation indicated by the operator, "?". Another description of the section in the following example is: If @currentField <= 70 Then class = sp-field-severity--warning.
77+
This example uses the conditional operator `?` to apply a class (`sp-field-severity--warning`) to the parent `<div />` element when the value in the current field is less than or equal to 70. This causes the field to be highlighted when the value is less than or equal to 70, and appear normally if it's greater than 70.
7978

8079
```JSON
8180
{
82-
"elmType": "div",
83-
"txtContent": "@currentField",
84-
"attributes": {
85-
"class": {
86-
"operator": "?",
87-
"operands": [
88-
{
89-
"operator": "<=",
90-
"operands": [
91-
"@currentField",
92-
70
93-
]
81+
"$schema": "http://columnformatting.sharepointpnp.com/columnFormattingSchema.json",
82+
"debugMode": true,
83+
"elmType": "div",
84+
"attributes": {
85+
"class": {
86+
"operator": "?",
87+
"operands": [
88+
{
89+
"operator": "<=",
90+
"operands": [
91+
"@currentField",
92+
70
93+
]
94+
},
95+
"sp-field-severity--warning",
96+
""
97+
]
98+
}
99+
},
100+
"children": [
101+
{
102+
"elmType": "span",
103+
"style": {
104+
"display": "inline-block",
105+
"padding": "0 4px"
94106
},
95-
"sp-field-severity--warning",
96-
""
97-
]
98-
}
99-
}
107+
"attributes": {
108+
"iconName": {
109+
"operator": "?",
110+
"operands": [
111+
{
112+
"operator": "<=",
113+
"operands": [
114+
"@currentField",
115+
70
116+
]
117+
},
118+
"Error",
119+
""
120+
]
121+
}
122+
}
123+
},
124+
{
125+
"elmType": "span",
126+
"txtContent": "@currentField"
127+
}
128+
]
100129
}
101130
```
102131

@@ -433,7 +462,7 @@ You can use column formatting to render quick action links next to fields. The f
433462
"@currentField.email",
434463
"?subject=Task status&body=Hey, how is your task coming along?.\r\n---\r\n",
435464
"@currentField.title",
436-
"\r\nClick this link for more info. https://msft.spoppe.com/sites/LincolnsFunHouse2/Lists/Conference%20Prep/DispForm.aspx?ID=",
465+
"\r\nClick this link for more info. http://contoso.sharepoint.com/sites/ConferencePrep/Tasks/Prep/DispForm.aspx?ID=",
437466
"[$ID]"
438467
]
439468
}
@@ -563,7 +592,7 @@ This example relies on two number fields, `Before` and `After`, for which the va
563592

564593
## Supported Column Types
565594
The following column types support column formatting:
566-
* Single line of text
595+
* Single line of text
567596
* Number
568597
* Choice
569598
* Person or Group
@@ -572,7 +601,13 @@ The following column types support column formatting:
572601
* Picture
573602
* Date/Time
574603
* Lookup
575-
The Name and Title fields are also supported.
604+
* Title (in Lists)
605+
606+
The following are not currently supported:
607+
* Managed Metadata
608+
* Filename (in Document Libraries)
609+
* Calculated
610+
* Retention Label
576611

577612
## Style guidelines
578613

0 commit comments

Comments
 (0)