@pnp/cli-microsoft365 10.10.0-beta.eb74779 → 10.10.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/allCommands.json +1 -1
- package/allCommandsFull.json +1 -1
- package/dist/m365/entra/commands/organization/organization-set.js +104 -0
- package/dist/m365/entra/commands.js +1 -0
- package/dist/m365/spo/commands/homesite/homesite-remove.js +57 -37
- package/dist/m365/spo/commands/list/list-view-add.js +140 -87
- package/dist/m365/spo/commands/page/clientsidepages.js +4 -0
- package/dist/m365/spo/commands/page/page-section-add.js +73 -13
- package/docs/docs/cmd/entra/organization/organization-set.mdx +84 -0
- package/docs/docs/cmd/spo/homesite/homesite-remove.mdx +6 -3
- package/docs/docs/cmd/spo/list/list-view-add.mdx +53 -10
- package/docs/docs/cmd/spo/page/page-section-add.mdx +22 -2
- package/package.json +2 -2
|
@@ -22,10 +22,12 @@ class SpoPageSectionAddCommand extends SpoCommand {
|
|
|
22
22
|
constructor() {
|
|
23
23
|
super();
|
|
24
24
|
_SpoPageSectionAddCommand_instances.add(this);
|
|
25
|
-
this.sectionTemplate = ['OneColumn', 'OneColumnFullWidth', 'TwoColumn', 'ThreeColumn', 'TwoColumnLeft', 'TwoColumnRight', 'Vertical'];
|
|
25
|
+
this.sectionTemplate = ['OneColumn', 'OneColumnFullWidth', 'TwoColumn', 'ThreeColumn', 'TwoColumnLeft', 'TwoColumnRight', 'Vertical', 'Flexible'];
|
|
26
26
|
this.zoneEmphasis = ['None', 'Neutral', 'Soft', 'Strong', 'Image', 'Gradient'];
|
|
27
27
|
this.iconAlignment = ['Left', 'Right'];
|
|
28
28
|
this.fillMode = ['ScaleToFill', 'ScaleToFit', 'Tile', 'OriginalSize'];
|
|
29
|
+
this.zoneReflowStrategy = ['TopToBottom', 'LeftToRight'];
|
|
30
|
+
this.MINIMUM_ZONE_HEIGHT = 34;
|
|
29
31
|
__classPrivateFieldGet(this, _SpoPageSectionAddCommand_instances, "m", _SpoPageSectionAddCommand_initTelemetry).call(this);
|
|
30
32
|
__classPrivateFieldGet(this, _SpoPageSectionAddCommand_instances, "m", _SpoPageSectionAddCommand_initOptions).call(this);
|
|
31
33
|
__classPrivateFieldGet(this, _SpoPageSectionAddCommand_instances, "m", _SpoPageSectionAddCommand_initValidators).call(this);
|
|
@@ -50,6 +52,12 @@ class SpoPageSectionAddCommand extends SpoCommand {
|
|
|
50
52
|
};
|
|
51
53
|
const res = await request.get(requestOptions);
|
|
52
54
|
canvasContent = JSON.parse(res.CanvasContent1 || "[{\"controlType\":0,\"pageSettingsSlice\":{\"isDefaultDescription\":true,\"isDefaultThumbnail\":true}}]");
|
|
55
|
+
if (args.options.sectionTemplate === 'OneColumnFullWidth') {
|
|
56
|
+
this.ensureFullWidthSectionCanBeAdded(canvasContent);
|
|
57
|
+
}
|
|
58
|
+
if (args.options.sectionTemplate === 'Vertical') {
|
|
59
|
+
this.ensureVerticalSectionCanBeAdded(canvasContent);
|
|
60
|
+
}
|
|
53
61
|
if (!res.IsPageCheckedOutToCurrentUser) {
|
|
54
62
|
await Page.checkout(pageFullName, args.options.webUrl, logger, this.verbose);
|
|
55
63
|
}
|
|
@@ -142,6 +150,9 @@ class SpoPageSectionAddCommand extends SpoCommand {
|
|
|
142
150
|
case 'Vertical':
|
|
143
151
|
columns.push(this.getVerticalColumn(args, zoneId));
|
|
144
152
|
break;
|
|
153
|
+
case 'Flexible':
|
|
154
|
+
columns.push(this.getFlexibleColumn(zoneIndex, sectionIndex++, args, zoneId));
|
|
155
|
+
break;
|
|
145
156
|
case 'OneColumn':
|
|
146
157
|
default:
|
|
147
158
|
columns.push(this.getColumn(zoneIndex, sectionIndex++, 12, args, zoneId));
|
|
@@ -162,9 +173,9 @@ class SpoPageSectionAddCommand extends SpoCommand {
|
|
|
162
173
|
},
|
|
163
174
|
emphasis: {}
|
|
164
175
|
};
|
|
165
|
-
if (zoneEmphasis && ['none', 'neutral', 'soft', 'strong'].includes(zoneEmphasis?.
|
|
176
|
+
if (zoneEmphasis && ['none', 'neutral', 'soft', 'strong'].includes(zoneEmphasis?.toLowerCase())) {
|
|
166
177
|
// Just these zoneEmphasis values should be added to column emphasis
|
|
167
|
-
const zoneEmphasisValue = ['none', 'neutral', 'soft', 'strong'].indexOf(zoneEmphasis.
|
|
178
|
+
const zoneEmphasisValue = ['none', 'neutral', 'soft', 'strong'].indexOf(zoneEmphasis.toLowerCase());
|
|
168
179
|
columnValue.emphasis = { zoneEmphasis: zoneEmphasisValue };
|
|
169
180
|
}
|
|
170
181
|
if (isCollapsibleSection) {
|
|
@@ -172,8 +183,9 @@ class SpoPageSectionAddCommand extends SpoCommand {
|
|
|
172
183
|
type: 1,
|
|
173
184
|
isExpanded: !!isExpanded,
|
|
174
185
|
showDividerLine: !!showDivider,
|
|
175
|
-
iconAlignment: iconAlignment && iconAlignment.
|
|
176
|
-
displayName: collapsibleTitle
|
|
186
|
+
iconAlignment: iconAlignment && iconAlignment.toLowerCase() === "right" ? "right" : "left",
|
|
187
|
+
displayName: collapsibleTitle,
|
|
188
|
+
headingLevel: args.options.headingLevel ? args.options.headingLevel : 2 //2 is a default heading level
|
|
177
189
|
};
|
|
178
190
|
}
|
|
179
191
|
return columnValue;
|
|
@@ -185,6 +197,14 @@ class SpoPageSectionAddCommand extends SpoCommand {
|
|
|
185
197
|
columnValue.position.controlIndex = 1;
|
|
186
198
|
return columnValue;
|
|
187
199
|
}
|
|
200
|
+
getFlexibleColumn(zoneIndex, sectionIndex, args, zoneId) {
|
|
201
|
+
const columnValue = this.getColumn(zoneIndex, sectionIndex, 100, args, zoneId);
|
|
202
|
+
columnValue.zoneReflowStrategy = { axis: args.options.zoneReflowStrategy ? this.zoneReflowStrategy.indexOf(args.options.zoneReflowStrategy) : 0 };
|
|
203
|
+
if (args.options.zoneHeight) {
|
|
204
|
+
columnValue.zoneHeight = args.options.zoneHeight;
|
|
205
|
+
}
|
|
206
|
+
return columnValue;
|
|
207
|
+
}
|
|
188
208
|
setBackgroundControl(zoneId, backgroundControl, args) {
|
|
189
209
|
const { overlayColor, overlayOpacity, useLightText, imageUrl } = args.options;
|
|
190
210
|
const backgroundDetails = this.getBackgroundDetails(args);
|
|
@@ -237,6 +257,18 @@ class SpoPageSectionAddCommand extends SpoCommand {
|
|
|
237
257
|
}
|
|
238
258
|
return backgroundDetails;
|
|
239
259
|
}
|
|
260
|
+
ensureFullWidthSectionCanBeAdded(canvasContent) {
|
|
261
|
+
const hasVerticalSection = canvasContent.some((c) => c.position?.layoutIndex === 2 && c.position.sectionFactor === 12);
|
|
262
|
+
if (hasVerticalSection) {
|
|
263
|
+
throw "A vertical section already exists on the page. A full-width section cannot be added to a page that already has a vertical section.";
|
|
264
|
+
}
|
|
265
|
+
}
|
|
266
|
+
ensureVerticalSectionCanBeAdded(canvasContent) {
|
|
267
|
+
const hasFullWidthSection = canvasContent.some((c) => c.position?.layoutIndex === 1 && c.position.sectionFactor === 0);
|
|
268
|
+
if (hasFullWidthSection) {
|
|
269
|
+
throw "A full-width section already exists on the page. A vertical section cannot be added to a page that already has a full-width section.";
|
|
270
|
+
}
|
|
271
|
+
}
|
|
240
272
|
}
|
|
241
273
|
_SpoPageSectionAddCommand_instances = new WeakSet(), _SpoPageSectionAddCommand_initTelemetry = function _SpoPageSectionAddCommand_initTelemetry() {
|
|
242
274
|
this.telemetry.push((args) => {
|
|
@@ -256,7 +288,10 @@ _SpoPageSectionAddCommand_instances = new WeakSet(), _SpoPageSectionAddCommand_i
|
|
|
256
288
|
useLightText: !!args.options.useLightText,
|
|
257
289
|
overlayColor: typeof args.options.overlayColor !== 'undefined',
|
|
258
290
|
overlayOpacity: typeof args.options.overlayOpacity !== 'undefined',
|
|
259
|
-
collapsibleTitle: typeof args.options.collapsibleTitle !== 'undefined'
|
|
291
|
+
collapsibleTitle: typeof args.options.collapsibleTitle !== 'undefined',
|
|
292
|
+
zoneReflowStrategy: typeof args.options.zoneReflowStrategy !== 'undefined',
|
|
293
|
+
zoneHeight: typeof args.options.zoneHeight !== 'undefined',
|
|
294
|
+
headingLevel: typeof args.options.headingLevel !== 'undefined'
|
|
260
295
|
});
|
|
261
296
|
});
|
|
262
297
|
}, _SpoPageSectionAddCommand_initOptions = function _SpoPageSectionAddCommand_initOptions() {
|
|
@@ -302,11 +337,18 @@ _SpoPageSectionAddCommand_instances = new WeakSet(), _SpoPageSectionAddCommand_i
|
|
|
302
337
|
option: '--overlayOpacity [overlayOpacity]'
|
|
303
338
|
}, {
|
|
304
339
|
option: '--collapsibleTitle [collapsibleTitle]'
|
|
340
|
+
}, {
|
|
341
|
+
option: '--zoneReflowStrategy [zoneReflowStrategy]',
|
|
342
|
+
autocomplete: this.zoneReflowStrategy
|
|
343
|
+
}, {
|
|
344
|
+
option: '--zoneHeight [zoneHeight]'
|
|
345
|
+
}, {
|
|
346
|
+
option: '--headingLevel [headingLevel]'
|
|
305
347
|
});
|
|
306
348
|
}, _SpoPageSectionAddCommand_initValidators = function _SpoPageSectionAddCommand_initValidators() {
|
|
307
349
|
this.validators.push(async (args) => {
|
|
308
350
|
if (!(args.options.sectionTemplate in CanvasSectionTemplate)) {
|
|
309
|
-
return `${args.options.sectionTemplate} is not a valid section template. Allowed values are OneColumn|OneColumnFullWidth|TwoColumn|ThreeColumn|TwoColumnLeft|TwoColumnRight|Vertical`;
|
|
351
|
+
return `${args.options.sectionTemplate} is not a valid section template. Allowed values are OneColumn|OneColumnFullWidth|TwoColumn|ThreeColumn|TwoColumnLeft|TwoColumnRight|Vertical|Flexible`;
|
|
310
352
|
}
|
|
311
353
|
if (typeof args.options.order !== 'undefined') {
|
|
312
354
|
if (!Number.isInteger(args.options.order) || args.options.order < 1) {
|
|
@@ -314,7 +356,7 @@ _SpoPageSectionAddCommand_instances = new WeakSet(), _SpoPageSectionAddCommand_i
|
|
|
314
356
|
}
|
|
315
357
|
}
|
|
316
358
|
if (typeof args.options.zoneEmphasis !== 'undefined') {
|
|
317
|
-
if (!this.zoneEmphasis.some(zoneEmphasisValue => zoneEmphasisValue.
|
|
359
|
+
if (!this.zoneEmphasis.some(zoneEmphasisValue => zoneEmphasisValue.toLowerCase() === args.options.zoneEmphasis?.toLowerCase())) {
|
|
318
360
|
return `The value of parameter zoneEmphasis must be ${this.zoneEmphasis.join(', ')}`;
|
|
319
361
|
}
|
|
320
362
|
}
|
|
@@ -324,20 +366,30 @@ _SpoPageSectionAddCommand_instances = new WeakSet(), _SpoPageSectionAddCommand_i
|
|
|
324
366
|
}
|
|
325
367
|
}
|
|
326
368
|
if (typeof args.options.iconAlignment !== 'undefined') {
|
|
327
|
-
if (!this.iconAlignment.some(iconAlignmentValue => iconAlignmentValue.
|
|
369
|
+
if (!this.iconAlignment.some(iconAlignmentValue => iconAlignmentValue.toLowerCase() === args.options.iconAlignment?.toLowerCase())) {
|
|
328
370
|
return `The value of parameter iconAlignment must be ${this.iconAlignment.join(', ')}`;
|
|
329
371
|
}
|
|
330
372
|
}
|
|
331
373
|
if (typeof args.options.fillMode !== 'undefined') {
|
|
332
|
-
if (!this.fillMode.some(fillModeValue => fillModeValue.
|
|
374
|
+
if (!this.fillMode.some(fillModeValue => fillModeValue.toLowerCase() === args.options.fillMode?.toLowerCase())) {
|
|
333
375
|
return `The value of parameter fillMode must be ${this.fillMode.join(', ')}`;
|
|
334
376
|
}
|
|
335
377
|
}
|
|
336
|
-
if (args.options.
|
|
378
|
+
if (typeof args.options.zoneReflowStrategy !== 'undefined') {
|
|
379
|
+
if (!this.zoneReflowStrategy.some(zoneReflowStrategyValue => zoneReflowStrategyValue.toLowerCase() === args.options.zoneReflowStrategy?.toLowerCase())) {
|
|
380
|
+
return `The value of parameter zoneReflowStrategy must be ${this.zoneReflowStrategy.join(', ')}`;
|
|
381
|
+
}
|
|
382
|
+
}
|
|
383
|
+
if (typeof args.options.headingLevel !== 'undefined') {
|
|
384
|
+
if (![2, 3, 4].some(headingLevelValue => headingLevelValue === args.options.headingLevel)) {
|
|
385
|
+
return `The value of parameter headingLevel must be 2, 3 or 4`;
|
|
386
|
+
}
|
|
387
|
+
}
|
|
388
|
+
if (args.options.zoneEmphasis?.toLowerCase() !== 'image' && (args.options.imageUrl || args.options.imageWidth ||
|
|
337
389
|
args.options.imageHeight || args.options.fillMode)) {
|
|
338
390
|
return 'Specify imageUrl, imageWidth, imageHeight or fillMode only when zoneEmphasis is set to Image';
|
|
339
391
|
}
|
|
340
|
-
if (args.options.zoneEmphasis?.
|
|
392
|
+
if (args.options.zoneEmphasis?.toLowerCase() === 'image' && !args.options.imageUrl) {
|
|
341
393
|
return 'Specify imageUrl when zoneEmphasis is set to Image';
|
|
342
394
|
}
|
|
343
395
|
if (args.options.zoneEmphasis?.toLowerCase() !== 'gradient' && args.options.gradientText) {
|
|
@@ -355,10 +407,18 @@ _SpoPageSectionAddCommand_instances = new WeakSet(), _SpoPageSectionAddCommand_i
|
|
|
355
407
|
if (!(args.options.zoneEmphasis && ['image', 'gradient'].includes(args.options.zoneEmphasis.toLowerCase())) && (args.options.overlayColor || args.options.overlayOpacity || args.options.useLightText)) {
|
|
356
408
|
return 'Specify overlayColor or overlayOpacity only when zoneEmphasis is set to Image or Gradient';
|
|
357
409
|
}
|
|
410
|
+
if (args.options.sectionTemplate?.toLowerCase() !== 'flexible' && (args.options.zoneReflowStrategy || args.options.zoneHeight)) {
|
|
411
|
+
return 'Specify zoneReflowStrategy or zoneHeight only when sectionTemplate is set to Flexible';
|
|
412
|
+
}
|
|
413
|
+
if (typeof args.options.zoneHeight !== 'undefined') {
|
|
414
|
+
if (!Number.isInteger(args.options.zoneHeight) || args.options.zoneHeight < this.MINIMUM_ZONE_HEIGHT) {
|
|
415
|
+
return `The value of parameter zoneHeight must be ${this.MINIMUM_ZONE_HEIGHT} or higher`;
|
|
416
|
+
}
|
|
417
|
+
}
|
|
358
418
|
return validation.isValidSharePointUrl(args.options.webUrl);
|
|
359
419
|
});
|
|
360
420
|
}, _SpoPageSectionAddCommand_initTypes = function _SpoPageSectionAddCommand_initTypes() {
|
|
361
|
-
this.types.string = ['pageName', 'webUrl', 'sectionTemplate', 'zoneEmphasis', 'iconAlignment', 'gradientText', 'imageUrl', 'fillMode', 'overlayColor', 'collapsibleTitle'];
|
|
421
|
+
this.types.string = ['pageName', 'webUrl', 'sectionTemplate', 'zoneEmphasis', 'iconAlignment', 'gradientText', 'imageUrl', 'fillMode', 'overlayColor', 'collapsibleTitle', 'zoneReflowStrategy'];
|
|
362
422
|
this.types.boolean = ['isLayoutReflowOnTop', 'isCollapsibleSection', 'showDivider', 'isExpanded', 'useLightText'];
|
|
363
423
|
};
|
|
364
424
|
export default new SpoPageSectionAddCommand();
|
|
@@ -0,0 +1,84 @@
|
|
|
1
|
+
import Global from '/docs/cmd/_global.mdx';
|
|
2
|
+
import Tabs from '@theme/Tabs';
|
|
3
|
+
import TabItem from '@theme/TabItem';
|
|
4
|
+
|
|
5
|
+
# entra organization set
|
|
6
|
+
|
|
7
|
+
Updates info about the organization
|
|
8
|
+
|
|
9
|
+
## Usage
|
|
10
|
+
|
|
11
|
+
```sh
|
|
12
|
+
m365 entra organization set [options]
|
|
13
|
+
```
|
|
14
|
+
|
|
15
|
+
## Options
|
|
16
|
+
|
|
17
|
+
```md definition-list
|
|
18
|
+
`-i, --id [id]`
|
|
19
|
+
: The id of the organization. Specify either `id` or `displayName`, but not both.
|
|
20
|
+
|
|
21
|
+
`-d, --displayName [displayName]`
|
|
22
|
+
: The name of the organization. Specify either `id` or `displayName`, but not both.
|
|
23
|
+
|
|
24
|
+
`--marketingNotificationEmails [marketingNotificationEmails]`
|
|
25
|
+
: The comma separated list of marketing notification emails.
|
|
26
|
+
|
|
27
|
+
`--securityComplianceNotificationMails [securityComplianceNotificationMails]`
|
|
28
|
+
: The comma separated list of security compliance notification emails.
|
|
29
|
+
|
|
30
|
+
`--securityComplianceNotificationPhones [securityComplianceNotificationPhones]`
|
|
31
|
+
: The comma separated list of security compliance notification phones.
|
|
32
|
+
|
|
33
|
+
`--technicalNotificationMails [technicalNotificationMails]`
|
|
34
|
+
: The comma separated list of technical notification emails.
|
|
35
|
+
|
|
36
|
+
`--contactEmail [contactEmail]`
|
|
37
|
+
: A valid smtp email address for the privacy statement contact
|
|
38
|
+
|
|
39
|
+
`--statementUrl [statementUrl]`
|
|
40
|
+
: The URL that directs to the company's privacy statement
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
<Global />
|
|
44
|
+
|
|
45
|
+
## Permissions
|
|
46
|
+
|
|
47
|
+
<Tabs>
|
|
48
|
+
<TabItem value="Delegated">
|
|
49
|
+
|
|
50
|
+
| Resource | Permissions |
|
|
51
|
+
|-----------------|--------------------------------------------------|
|
|
52
|
+
| Microsoft Graph | Organization.ReadWrite.All |
|
|
53
|
+
|
|
54
|
+
</TabItem>
|
|
55
|
+
<TabItem value="Application">
|
|
56
|
+
|
|
57
|
+
| Resource | Permissions |
|
|
58
|
+
|-----------------|----------------------------------------------------------|
|
|
59
|
+
| Microsoft Graph | Organization.ReadWrite.All |
|
|
60
|
+
|
|
61
|
+
</TabItem>
|
|
62
|
+
</Tabs>
|
|
63
|
+
|
|
64
|
+
## Examples
|
|
65
|
+
|
|
66
|
+
Updates properties of an organization specified by id
|
|
67
|
+
|
|
68
|
+
```sh
|
|
69
|
+
m365 entra organization set --id 84841066-274d-4ec0-a5c1-276be684bdd3 --marketingNotificationEmails 'marketing@contoso.com'
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
Updates properties of an organization specified by displayName
|
|
73
|
+
|
|
74
|
+
```sh
|
|
75
|
+
m365 entra organization set --displayName Contoso --marketingNotificationEmails 'marketing@contoso.com'
|
|
76
|
+
```
|
|
77
|
+
|
|
78
|
+
## Response
|
|
79
|
+
|
|
80
|
+
The command won't return a response on success
|
|
81
|
+
|
|
82
|
+
## More information
|
|
83
|
+
|
|
84
|
+
- Organization: https://learn.microsoft.com/graph/api/organization-update
|
|
@@ -4,7 +4,7 @@ import TabItem from '@theme/TabItem';
|
|
|
4
4
|
|
|
5
5
|
# spo homesite remove
|
|
6
6
|
|
|
7
|
-
Removes
|
|
7
|
+
Removes a Home Site
|
|
8
8
|
|
|
9
9
|
## Usage
|
|
10
10
|
|
|
@@ -15,6 +15,9 @@ m365 spo homesite remove [options]
|
|
|
15
15
|
## Options
|
|
16
16
|
|
|
17
17
|
```md definition-list
|
|
18
|
+
`-u, --url [url]`
|
|
19
|
+
: URL of the home site to remove.
|
|
20
|
+
|
|
18
21
|
`-f, --force`
|
|
19
22
|
: Do not prompt for confirmation before removing the Home Site.
|
|
20
23
|
```
|
|
@@ -31,10 +34,10 @@ To use this command you must be either **SharePoint Administrator** or **Global
|
|
|
31
34
|
|
|
32
35
|
## Examples
|
|
33
36
|
|
|
34
|
-
Removes
|
|
37
|
+
Removes a Home site specified by URL without prompting for confirmation.
|
|
35
38
|
|
|
36
39
|
```sh
|
|
37
|
-
m365 spo homesite remove --force
|
|
40
|
+
m365 spo homesite remove --url "https://contoso.sharepoint.com/sites/testcomms" --force
|
|
38
41
|
```
|
|
39
42
|
|
|
40
43
|
## Response
|
|
@@ -30,12 +30,33 @@ m365 spo list view add [options]
|
|
|
30
30
|
`--title <title>`
|
|
31
31
|
: Title of the view to be created for the list.
|
|
32
32
|
|
|
33
|
-
`--
|
|
34
|
-
:
|
|
33
|
+
`--type [type]`
|
|
34
|
+
: Type of the view. Possible values are: `list`, `calendar`, `gallery`, `kanban`. Defaults to `list`.
|
|
35
|
+
|
|
36
|
+
`--fields [fields]`
|
|
37
|
+
: Comma-separated list of **case-sensitive** internal names of the fields to add to the view. Optional when `type` is set to `calendar`.
|
|
35
38
|
|
|
36
39
|
`--viewQuery [viewQuery]`
|
|
37
40
|
: XML representation of the list query for the underlying view.
|
|
38
41
|
|
|
42
|
+
`--calendarStartDateField [calendarStartDateField]`
|
|
43
|
+
: Internal name of the field that contains the start date of the calendar event. Required when `type` is set to `calendar`.
|
|
44
|
+
|
|
45
|
+
`--calendarEndDateField [calendarEndDateField]`
|
|
46
|
+
: Internal name of the field that contains the end date of the calendar event. Required when `type` is set to `calendar`.
|
|
47
|
+
|
|
48
|
+
`--calendarTitleField [calendarTitleField]`
|
|
49
|
+
: Internal name of the field that contains the title of the calendar event. Required when `type` is set to `calendar`.
|
|
50
|
+
|
|
51
|
+
`--calendarSubTitleField [calendarSubTitleField]`
|
|
52
|
+
: Internal name of the field that contains the subtitle of the calendar event.
|
|
53
|
+
|
|
54
|
+
`--calendarDefaultLayout [calendarDefaultLayout]`
|
|
55
|
+
: Default layout of the calendar view. Possible values are: `month`, `week`, `workWeek`, `day`. Defaults to `month`.
|
|
56
|
+
|
|
57
|
+
`--kanbanBucketField [kanbanBucketField]`
|
|
58
|
+
: Internal name of the field that contains the bucket for the Kanban board view. Required when `type` is set to `kanban`.
|
|
59
|
+
|
|
39
60
|
`--personal`
|
|
40
61
|
: View will be created as personal view, if specified.
|
|
41
62
|
|
|
@@ -53,32 +74,54 @@ m365 spo list view add [options]
|
|
|
53
74
|
|
|
54
75
|
## Remarks
|
|
55
76
|
|
|
77
|
+
:::tip
|
|
78
|
+
|
|
56
79
|
We recommend using the `paged` option. When specified, the view supports displaying more items page by page (default behavior). When not specified, the `rowLimit` is absolute, and there is no link to see more items.
|
|
57
80
|
|
|
81
|
+
:::
|
|
82
|
+
|
|
58
83
|
## Examples
|
|
59
84
|
|
|
60
|
-
Add a view called
|
|
85
|
+
Add a list view called to a list with specific title.
|
|
86
|
+
|
|
87
|
+
```sh
|
|
88
|
+
m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --listTitle "Customers" --title "All customers" --fields "LinkTitle,Country,Sector,Country,Address,Contact" --paged
|
|
89
|
+
```
|
|
90
|
+
|
|
91
|
+
Add a gallery view as default view to a list with a specific URL.
|
|
92
|
+
|
|
93
|
+
```sh
|
|
94
|
+
m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --listUrl "/Lists/Customers" --title "All customers" --type gallery --fields "LinkTitle,Country,Sector,Country,Address,Contact" --paged --default
|
|
95
|
+
```
|
|
96
|
+
|
|
97
|
+
Add a view with defined filter and sorting.
|
|
98
|
+
|
|
99
|
+
```sh
|
|
100
|
+
m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --listTitle "Customers" --title "Transport customers" --fields "LinkTitle,Country,Country,Address,Contact" --viewQuery "<OrderBy><FieldRef Name='LinkTitle' Ascending='TRUE' /></OrderBy><Where><Eq><FieldRef Name='Sector' /><Value Type='Text'>Transportation</Value></Eq></Where>" --paged
|
|
101
|
+
```
|
|
102
|
+
|
|
103
|
+
Add a gallery view as personal view.
|
|
61
104
|
|
|
62
105
|
```sh
|
|
63
|
-
m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/
|
|
106
|
+
m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --listTitle "Customers" --title "All customers" --type gallery --fields "LinkTitle,Country,Sector,Country,Address,Contact" --paged --personal
|
|
64
107
|
```
|
|
65
108
|
|
|
66
|
-
Add a
|
|
109
|
+
Add a calendar view with month layout.
|
|
67
110
|
|
|
68
111
|
```sh
|
|
69
|
-
m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/
|
|
112
|
+
m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --listTitle "Events" --title "All events" --type calendar --fields "EventType,InternalExternal" --calendarStartDateField EventStartDate --calendarEndDateField EventEndDate --calendarTitleField LinkTitle --paged
|
|
70
113
|
```
|
|
71
114
|
|
|
72
|
-
Add a
|
|
115
|
+
Add a calendar view with week layout and subtitle.
|
|
73
116
|
|
|
74
117
|
```sh
|
|
75
|
-
m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/
|
|
118
|
+
m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --listTitle "Events" --title "All events" --type calendar --fields "EventType,InternalExternal" --calendarStartDateField EventStartDate --calendarEndDateField EventEndDate --calendarTitleField LinkTitle --calendarSubTitleField Location --calendarDefaultLayout week --paged
|
|
76
119
|
```
|
|
77
120
|
|
|
78
|
-
Add a
|
|
121
|
+
Add a Kanban board view.
|
|
79
122
|
|
|
80
123
|
```sh
|
|
81
|
-
m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/
|
|
124
|
+
m365 spo list view add --webUrl https://contoso.sharepoint.com/sites/Sales --listTitle "Tasks" --title "All tasks" --type kanban --fields "Title,AssignedTo" --kanbanBucketField Status --paged
|
|
82
125
|
```
|
|
83
126
|
|
|
84
127
|
## Response
|
|
@@ -20,7 +20,7 @@ m365 spo page section add [options]
|
|
|
20
20
|
: URL of the site where the page to retrieve is located.
|
|
21
21
|
|
|
22
22
|
`-t, --sectionTemplate <sectionTemplate>`
|
|
23
|
-
: Type of section to add. Allowed values `OneColumn`, `OneColumnFullWidth`, `TwoColumn`, `ThreeColumn`, `TwoColumnLeft`, `TwoColumnRight`, `Vertical`.
|
|
23
|
+
: Type of section to add. Allowed values `OneColumn`, `OneColumnFullWidth`, `TwoColumn`, `ThreeColumn`, `TwoColumnLeft`, `TwoColumnRight`, `Vertical`, `Flexible`.
|
|
24
24
|
|
|
25
25
|
`--order [order]`
|
|
26
26
|
: Order of the section to add.
|
|
@@ -43,6 +43,9 @@ m365 spo page section add [options]
|
|
|
43
43
|
`--isExpanded`
|
|
44
44
|
: Sets the default display state of the collapsible section. Sets `false` if not specified.
|
|
45
45
|
|
|
46
|
+
`--headingLevel [headingLevel]`
|
|
47
|
+
: Heading level of collapsible section Allowed values `2`, `3`, `4`.
|
|
48
|
+
|
|
46
49
|
`--gradientText [gradientText]`
|
|
47
50
|
: Sets the gradient setting of the background of a section. Required when `zoneEmphasis` is `Gradient`.
|
|
48
51
|
|
|
@@ -68,7 +71,13 @@ m365 spo page section add [options]
|
|
|
68
71
|
: The overlay opacity for the background. Applied only when `zoneEmphasis` is `Image` or `Gradient`. Sets `60` value if not specified.
|
|
69
72
|
|
|
70
73
|
`--collapsibleTitle [collapsibleTitle]`
|
|
71
|
-
: The display name of the collapsible section
|
|
74
|
+
: The display name of the collapsible section.
|
|
75
|
+
|
|
76
|
+
`--zoneReflowStrategy [zoneReflowStrategy]`
|
|
77
|
+
: Mobile and email reflow. Allowed values `TopToBottom`, `LeftToRight`. Applied only for `Flexible` section.
|
|
78
|
+
|
|
79
|
+
`--zoneHeight [zoneHeight]`
|
|
80
|
+
: Section height. Minimum value is `34`. Applied only for `Flexible` section.
|
|
72
81
|
```
|
|
73
82
|
|
|
74
83
|
<Global />
|
|
@@ -115,6 +124,12 @@ Add OneColumn section as a collapsible section as expanded with icon aligned to
|
|
|
115
124
|
m365 spo page section add --pageName home.aspx --webUrl https://contoso.sharepoint.com/sites/newsletter --sectionTemplate OneColumn --isCollapsibleSection --isExpanded --iconAlignment Left
|
|
116
125
|
```
|
|
117
126
|
|
|
127
|
+
Add OneColumn section as a collapsible section as expanded with headingLevel 3
|
|
128
|
+
|
|
129
|
+
```sh
|
|
130
|
+
m365 spo page section add --pageName home.aspx --webUrl https://contoso.sharepoint.com/sites/newsletter --sectionTemplate OneColumn --isCollapsibleSection --isExpanded --headingLevel 3
|
|
131
|
+
```
|
|
132
|
+
|
|
118
133
|
Add TwoColumn section with Image background
|
|
119
134
|
|
|
120
135
|
```sh
|
|
@@ -127,6 +142,11 @@ Add OneColumn section with Gradient background
|
|
|
127
142
|
m365 spo page section add --pageName home.aspx --webUrl https://contoso.sharepoint.com/sites/newsletter --sectionTemplate TwoColumn --zoneEmphasis Gradient --gradientText "linear-gradient(72.44deg, #E6FBFE 0%, #EDDDFB 100%)"
|
|
128
143
|
```
|
|
129
144
|
|
|
145
|
+
Add a Flexible section to the modern page with mobile and email reflow and section height.
|
|
146
|
+
|
|
147
|
+
```sh
|
|
148
|
+
m365 spo page section add --pageName home.aspx --webUrl https://contoso.sharepoint.com/sites/newsletter --sectionTemplate Flexible --zoneHeight 100 --zoneReflowStrategy LeftToRight
|
|
149
|
+
```
|
|
130
150
|
|
|
131
151
|
## Response
|
|
132
152
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@pnp/cli-microsoft365",
|
|
3
|
-
"version": "10.10.0
|
|
3
|
+
"version": "10.10.0",
|
|
4
4
|
"description": "Manage Microsoft 365 and SharePoint Framework projects on any platform",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"main": "./dist/api.js",
|
|
@@ -315,4 +315,4 @@
|
|
|
315
315
|
"sinon": "^21.0.0",
|
|
316
316
|
"source-map-support": "^0.5.21"
|
|
317
317
|
}
|
|
318
|
-
}
|
|
318
|
+
}
|