@pnp/sp 2.7.0 → 2.11.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.
Files changed (309) hide show
  1. package/LICENSE +25 -25
  2. package/appcatalog/index.d.ts +8 -8
  3. package/appcatalog/index.js +30 -30
  4. package/appcatalog/types.d.ts +81 -81
  5. package/appcatalog/types.js +177 -177
  6. package/appcatalog/web.d.ts +16 -16
  7. package/appcatalog/web.js +6 -6
  8. package/attachments/index.d.ts +2 -2
  9. package/attachments/index.js +2 -2
  10. package/attachments/item.d.ts +12 -12
  11. package/attachments/item.js +4 -4
  12. package/attachments/types.d.ts +92 -92
  13. package/attachments/types.js +240 -240
  14. package/batch.d.ts +17 -17
  15. package/batch.js +223 -223
  16. package/batch.js.map +1 -1
  17. package/clientside-pages/funcs.d.ts +22 -22
  18. package/clientside-pages/funcs.js +25 -25
  19. package/clientside-pages/index.d.ts +2 -2
  20. package/clientside-pages/index.js +2 -2
  21. package/clientside-pages/types.d.ts +496 -494
  22. package/clientside-pages/types.d.ts.map +1 -1
  23. package/clientside-pages/types.js +1496 -1485
  24. package/clientside-pages/types.js.map +1 -1
  25. package/clientside-pages/web.d.ts +41 -41
  26. package/clientside-pages/web.js +57 -57
  27. package/column-defaults/folder.d.ts +27 -27
  28. package/column-defaults/folder.js +82 -82
  29. package/column-defaults/index.d.ts +3 -3
  30. package/column-defaults/index.js +2 -2
  31. package/column-defaults/list.d.ts +19 -19
  32. package/column-defaults/list.js +198 -198
  33. package/column-defaults/types.d.ts +21 -21
  34. package/column-defaults/types.js +1 -1
  35. package/comments/clientside-page.d.ts +57 -57
  36. package/comments/clientside-page.d.ts.map +1 -1
  37. package/comments/clientside-page.js +136 -136
  38. package/comments/index.d.ts +2 -2
  39. package/comments/index.js +2 -2
  40. package/comments/item.d.ts +29 -29
  41. package/comments/item.js +47 -47
  42. package/comments/types.d.ts +107 -107
  43. package/comments/types.d.ts.map +1 -1
  44. package/comments/types.js +145 -145
  45. package/comments/types.js.map +1 -1
  46. package/content-types/index.d.ts +4 -4
  47. package/content-types/index.js +4 -4
  48. package/content-types/item.d.ts +12 -12
  49. package/content-types/item.js +4 -4
  50. package/content-types/list.d.ts +12 -12
  51. package/content-types/list.js +4 -4
  52. package/content-types/types.d.ts +107 -107
  53. package/content-types/types.js +166 -166
  54. package/content-types/web.d.ts +12 -12
  55. package/content-types/web.js +4 -4
  56. package/decorators.d.ts +11 -11
  57. package/decorators.js +28 -28
  58. package/features/index.d.ts +3 -3
  59. package/features/index.js +3 -3
  60. package/features/site.d.ts +12 -12
  61. package/features/site.js +4 -4
  62. package/features/types.d.ts +47 -47
  63. package/features/types.js +109 -109
  64. package/features/web.d.ts +12 -12
  65. package/features/web.js +4 -4
  66. package/fields/index.d.ts +4 -4
  67. package/fields/index.js +4 -4
  68. package/fields/list.d.ts +12 -12
  69. package/fields/list.js +4 -4
  70. package/fields/types.d.ts +368 -361
  71. package/fields/types.d.ts.map +1 -1
  72. package/fields/types.js +624 -609
  73. package/fields/types.js.map +1 -1
  74. package/fields/web.d.ts +17 -17
  75. package/fields/web.js +5 -5
  76. package/files/folder.d.ts +12 -12
  77. package/files/folder.js +4 -4
  78. package/files/index.d.ts +4 -4
  79. package/files/index.js +4 -4
  80. package/files/item.d.ts +12 -12
  81. package/files/item.js +4 -4
  82. package/files/types.d.ts +421 -421
  83. package/files/types.js +853 -853
  84. package/files/types.js.map +1 -1
  85. package/files/web.d.ts +35 -35
  86. package/files/web.js +15 -15
  87. package/folders/index.d.ts +4 -4
  88. package/folders/index.js +4 -4
  89. package/folders/item.d.ts +9 -9
  90. package/folders/item.js +4 -4
  91. package/folders/list.d.ts +12 -12
  92. package/folders/list.js +4 -4
  93. package/folders/types.d.ts +207 -207
  94. package/folders/types.js +433 -433
  95. package/folders/types.js.map +1 -1
  96. package/folders/web.d.ts +39 -39
  97. package/folders/web.js +15 -15
  98. package/forms/index.d.ts +2 -2
  99. package/forms/index.js +2 -2
  100. package/forms/list.d.ts +9 -9
  101. package/forms/list.js +4 -4
  102. package/forms/types.d.ts +35 -35
  103. package/forms/types.js +41 -41
  104. package/hubsites/index.d.ts +12 -12
  105. package/hubsites/index.js +15 -15
  106. package/hubsites/site.d.ts +26 -26
  107. package/hubsites/site.js +39 -39
  108. package/hubsites/types.d.ts +55 -55
  109. package/hubsites/types.js +53 -53
  110. package/hubsites/web.d.ts +21 -21
  111. package/hubsites/web.js +23 -23
  112. package/index.d.ts +14 -14
  113. package/index.js +13 -13
  114. package/items/index.d.ts +2 -2
  115. package/items/index.js +2 -2
  116. package/items/list.d.ts +9 -9
  117. package/items/list.js +4 -4
  118. package/items/types.d.ts +226 -219
  119. package/items/types.d.ts.map +1 -1
  120. package/items/types.js +549 -511
  121. package/items/types.js.map +1 -1
  122. package/lists/index.d.ts +2 -2
  123. package/lists/index.js +2 -2
  124. package/lists/types.d.ts +495 -495
  125. package/lists/types.js +522 -522
  126. package/lists/types.js.map +1 -1
  127. package/lists/web.d.ts +43 -43
  128. package/lists/web.js +27 -27
  129. package/navigation/index.d.ts +8 -8
  130. package/navigation/index.js +14 -14
  131. package/navigation/types.d.ts +154 -154
  132. package/navigation/types.js +219 -219
  133. package/navigation/web.d.ts +13 -13
  134. package/navigation/web.js +4 -4
  135. package/odata.d.ts +5 -5
  136. package/odata.js +90 -90
  137. package/odata.js.map +1 -1
  138. package/operations.d.ts +9 -9
  139. package/operations.js +63 -63
  140. package/package.json +4 -4
  141. package/presets/all.d.ts +72 -72
  142. package/presets/all.js +72 -72
  143. package/presets/core.d.ts +11 -11
  144. package/presets/core.js +11 -11
  145. package/profiles/index.d.ts +7 -7
  146. package/profiles/index.js +13 -13
  147. package/profiles/types.d.ts +357 -357
  148. package/profiles/types.js +454 -454
  149. package/readme.md +21 -21
  150. package/regional-settings/content-type.d.ts +7 -7
  151. package/regional-settings/content-type.js +4 -4
  152. package/regional-settings/field.d.ts +7 -7
  153. package/regional-settings/field.js +4 -4
  154. package/regional-settings/funcs.d.ts +2 -2
  155. package/regional-settings/funcs.js +8 -8
  156. package/regional-settings/index.d.ts +6 -6
  157. package/regional-settings/index.js +6 -6
  158. package/regional-settings/list.d.ts +7 -7
  159. package/regional-settings/list.js +4 -4
  160. package/regional-settings/types.d.ts +111 -111
  161. package/regional-settings/types.js +159 -159
  162. package/regional-settings/user-custom-actions.d.ts +7 -7
  163. package/regional-settings/user-custom-actions.js +4 -4
  164. package/regional-settings/web.d.ts +12 -12
  165. package/regional-settings/web.js +7 -7
  166. package/related-items/index.d.ts +1 -1
  167. package/related-items/index.js +1 -1
  168. package/related-items/types.d.ts +76 -76
  169. package/related-items/types.js +103 -103
  170. package/related-items/web.d.ts +12 -12
  171. package/related-items/web.js +9 -9
  172. package/rest.d.ts +44 -44
  173. package/rest.js +72 -72
  174. package/search/index.d.ts +30 -30
  175. package/search/index.js +25 -25
  176. package/search/query.d.ts +62 -62
  177. package/search/query.js +302 -302
  178. package/search/suggest.d.ts +76 -76
  179. package/search/suggest.js +66 -66
  180. package/search/types.d.ts +426 -426
  181. package/search/types.js +57 -57
  182. package/security/funcs.d.ts +43 -43
  183. package/security/funcs.js +142 -142
  184. package/security/index.d.ts +4 -4
  185. package/security/index.js +4 -4
  186. package/security/item.d.ts +7 -7
  187. package/security/item.js +14 -14
  188. package/security/list.d.ts +7 -7
  189. package/security/list.js +14 -14
  190. package/security/types.d.ts +318 -318
  191. package/security/types.js +399 -399
  192. package/security/web.d.ts +9 -9
  193. package/security/web.js +15 -15
  194. package/sharepointqueryable.d.ts +135 -135
  195. package/sharepointqueryable.js +265 -265
  196. package/sharing/file.d.ts +18 -18
  197. package/sharing/file.d.ts.map +1 -1
  198. package/sharing/file.js +116 -15
  199. package/sharing/file.js.map +1 -1
  200. package/sharing/folder.d.ts +9 -9
  201. package/sharing/folder.js +136 -136
  202. package/sharing/funcs.d.ts +62 -62
  203. package/sharing/funcs.js +239 -239
  204. package/sharing/funcs.js.map +1 -1
  205. package/sharing/index.d.ts +5 -5
  206. package/sharing/index.js +5 -5
  207. package/sharing/item.d.ts +16 -16
  208. package/sharing/item.js +15 -15
  209. package/sharing/types.d.ts +583 -583
  210. package/sharing/types.js +113 -113
  211. package/sharing/web.d.ts +19 -19
  212. package/sharing/web.js +76 -76
  213. package/site-designs/index.d.ts +8 -8
  214. package/site-designs/index.js +14 -14
  215. package/site-designs/types.d.ts +319 -319
  216. package/site-designs/types.js +203 -203
  217. package/site-designs/web.d.ts +25 -25
  218. package/site-designs/web.js +11 -11
  219. package/site-groups/index.d.ts +2 -2
  220. package/site-groups/index.js +2 -2
  221. package/site-groups/types.d.ts +89 -89
  222. package/site-groups/types.js +125 -125
  223. package/site-groups/web.d.ts +40 -40
  224. package/site-groups/web.js +30 -30
  225. package/site-scripts/index.d.ts +9 -9
  226. package/site-scripts/index.js +15 -15
  227. package/site-scripts/list.d.ts +12 -12
  228. package/site-scripts/list.js +24 -24
  229. package/site-scripts/types.d.ts +183 -183
  230. package/site-scripts/types.js +141 -141
  231. package/site-scripts/web.d.ts +13 -13
  232. package/site-scripts/web.js +5 -5
  233. package/site-users/index.d.ts +2 -2
  234. package/site-users/index.js +2 -2
  235. package/site-users/types.d.ts +138 -138
  236. package/site-users/types.js +122 -122
  237. package/site-users/web.d.ts +31 -31
  238. package/site-users/web.js +27 -27
  239. package/sites/index.d.ts +7 -7
  240. package/sites/index.js +13 -13
  241. package/sites/types.d.ts +147 -147
  242. package/sites/types.js +321 -321
  243. package/social/index.d.ts +10 -10
  244. package/social/index.js +13 -13
  245. package/social/types.d.ts +309 -309
  246. package/social/types.js +322 -322
  247. package/sphttpclient.d.ts +18 -18
  248. package/sphttpclient.js +189 -189
  249. package/splibconfig.d.ts +22 -22
  250. package/splibconfig.js +13 -13
  251. package/sputilities/index.d.ts +7 -7
  252. package/sputilities/index.js +13 -13
  253. package/sputilities/types.d.ts +130 -130
  254. package/sputilities/types.js +118 -118
  255. package/subscriptions/index.d.ts +2 -2
  256. package/subscriptions/index.js +2 -2
  257. package/subscriptions/list.d.ts +13 -13
  258. package/subscriptions/list.js +4 -4
  259. package/subscriptions/types.d.ts +54 -54
  260. package/subscriptions/types.js +111 -111
  261. package/taxonomy/index.d.ts +7 -7
  262. package/taxonomy/index.js +13 -13
  263. package/taxonomy/types.d.ts +200 -200
  264. package/taxonomy/types.js +347 -347
  265. package/taxonomy/types.js.map +1 -1
  266. package/telemetry.d.ts +12 -12
  267. package/telemetry.js +48 -48
  268. package/types.d.ts +218 -218
  269. package/types.js +79 -79
  270. package/user-custom-actions/index.d.ts +4 -4
  271. package/user-custom-actions/index.js +4 -4
  272. package/user-custom-actions/list.d.ts +12 -12
  273. package/user-custom-actions/list.js +4 -4
  274. package/user-custom-actions/site.d.ts +12 -12
  275. package/user-custom-actions/site.js +4 -4
  276. package/user-custom-actions/types.d.ts +82 -82
  277. package/user-custom-actions/types.js +93 -93
  278. package/user-custom-actions/web.d.ts +15 -15
  279. package/user-custom-actions/web.js +4 -4
  280. package/utils/escapeQueryStrValue.d.ts +1 -1
  281. package/utils/escapeQueryStrValue.js +19 -19
  282. package/utils/extractweburl.d.ts +1 -1
  283. package/utils/extractweburl.js +15 -15
  284. package/utils/file-names.d.ts +17 -17
  285. package/utils/file-names.js +38 -38
  286. package/utils/metadata.d.ts +5 -5
  287. package/utils/metadata.js +5 -5
  288. package/utils/objectToSPKeyValueCollection.d.ts +20 -20
  289. package/utils/objectToSPKeyValueCollection.js +16 -16
  290. package/utils/toResourcePath.d.ts +7 -7
  291. package/utils/toResourcePath.js +6 -6
  292. package/utils/toabsoluteurl.d.ts +7 -7
  293. package/utils/toabsoluteurl.js +61 -61
  294. package/views/index.d.ts +2 -2
  295. package/views/index.js +2 -2
  296. package/views/list.d.ts +23 -23
  297. package/views/list.js +8 -8
  298. package/views/types.d.ts +140 -140
  299. package/views/types.js +184 -184
  300. package/webparts/file.d.ts +15 -15
  301. package/webparts/file.js +6 -6
  302. package/webparts/index.d.ts +2 -2
  303. package/webparts/index.js +2 -2
  304. package/webparts/types.d.ts +83 -83
  305. package/webparts/types.js +117 -117
  306. package/webs/index.d.ts +16 -16
  307. package/webs/index.js +16 -16
  308. package/webs/types.d.ts +210 -210
  309. package/webs/types.js +295 -295
package/fields/types.d.ts CHANGED
@@ -1,362 +1,369 @@
1
- import { _SharePointQueryableInstance, _SharePointQueryableCollection, IDeleteable } from "../sharepointqueryable.js";
2
- import { ITypedHash } from "@pnp/common";
3
- export declare class _Fields extends _SharePointQueryableCollection<IFieldInfo[]> {
4
- /**
5
- * Creates a field based on the specified schema
6
- *
7
- * @param xml A string or XmlSchemaFieldCreationInformation instance descrbing the field to create
8
- */
9
- createFieldAsXml(xml: string | IXmlSchemaFieldCreationInformation): Promise<IFieldAddResult>;
10
- /**
11
- * Gets a field from the collection by id
12
- *
13
- * @param id The Id of the list
14
- */
15
- getById(id: string): IField;
16
- /**
17
- * Gets a field from the collection by title
18
- *
19
- * @param title The case-sensitive title of the field
20
- */
21
- getByTitle(title: string): IField;
22
- /**
23
- * Gets a field from the collection by using internal name or title
24
- *
25
- * @param name The case-sensitive internal name or title of the field
26
- */
27
- getByInternalNameOrTitle(name: string): IField;
28
- /**
29
- * Adds a new field to the collection
30
- *
31
- * @param title The new field's title
32
- * @param fieldType The new field's type (ex: SP.FieldText)
33
- * @param properties Differ by type of field being created (see: https://msdn.microsoft.com/en-us/library/office/dn600182.aspx)
34
- */
35
- add(title: string, fieldType: string, properties: IFieldCreationProperties & {
36
- FieldTypeKind: number;
37
- }): Promise<IFieldAddResult>;
38
- /**
39
- * Adds a new SP.FieldText to the collection
40
- *
41
- * @param title The field title
42
- * @param maxLength The maximum number of characters allowed in the value of the field.
43
- * @param properties Differ by type of field being created (see: https://msdn.microsoft.com/en-us/library/office/dn600182.aspx)
44
- */
45
- addText(title: string, maxLength?: number, properties?: IFieldCreationProperties): Promise<IFieldAddResult>;
46
- /**
47
- * Adds a new SP.FieldCalculated to the collection
48
- *
49
- * @param title The field title.
50
- * @param formula The formula for the field.
51
- * @param dateFormat The date and time format that is displayed in the field.
52
- * @param outputType Specifies the output format for the field. Represents a FieldType value.
53
- * @param properties Differ by type of field being created (see: https://msdn.microsoft.com/en-us/library/office/dn600182.aspx)
54
- */
55
- addCalculated(title: string, formula: string, dateFormat: DateTimeFieldFormatType, outputType?: FieldTypes, properties?: IFieldCreationProperties): Promise<IFieldAddResult>;
56
- /**
57
- * Adds a new SP.FieldDateTime to the collection
58
- *
59
- * @param title The field title
60
- * @param displayFormat The format of the date and time that is displayed in the field.
61
- * @param calendarType Specifies the calendar type of the field.
62
- * @param friendlyDisplayFormat The type of friendly display format that is used in the field.
63
- * @param properties Differ by type of field being created (see: https://msdn.microsoft.com/en-us/library/office/dn600182.aspx)
64
- */
65
- addDateTime(title: string, displayFormat?: DateTimeFieldFormatType, calendarType?: CalendarType, friendlyDisplayFormat?: DateTimeFieldFriendlyFormatType, properties?: IFieldCreationProperties): Promise<IFieldAddResult>;
66
- /**
67
- * Adds a new SP.FieldNumber to the collection
68
- *
69
- * @param title The field title
70
- * @param minValue The field's minimum value
71
- * @param maxValue The field's maximum value
72
- * @param properties Differ by type of field being created (see: https://msdn.microsoft.com/en-us/library/office/dn600182.aspx)
73
- */
74
- addNumber(title: string, minValue?: number, maxValue?: number, properties?: IFieldCreationProperties): Promise<IFieldAddResult>;
75
- /**
76
- * Adds a new SP.FieldCurrency to the collection
77
- *
78
- * @param title The field title
79
- * @param minValue The field's minimum value
80
- * @param maxValue The field's maximum value
81
- * @param currencyLocalId Specifies the language code identifier (LCID) used to format the value of the field
82
- * @param properties Differ by type of field being created (see: https://msdn.microsoft.com/en-us/library/office/dn600182.aspx)
83
- */
84
- addCurrency(title: string, minValue?: number, maxValue?: number, currencyLocalId?: number, properties?: IFieldCreationProperties): Promise<IFieldAddResult>;
85
- /**
86
- * Adds a new SP.FieldMultiLineText to the collection
87
- *
88
- * @param title The field title
89
- * @param numberOfLines Specifies the number of lines of text to display for the field.
90
- * @param richText Specifies whether the field supports rich formatting.
91
- * @param restrictedMode Specifies whether the field supports a subset of rich formatting.
92
- * @param appendOnly Specifies whether all changes to the value of the field are displayed in list forms.
93
- * @param allowHyperlink Specifies whether a hyperlink is allowed as a value of the field.
94
- * @param properties Differ by type of field being created (see: https://msdn.microsoft.com/en-us/library/office/dn600182.aspx)
95
- *
96
- */
97
- addMultilineText(title: string, numberOfLines?: number, richText?: boolean, restrictedMode?: boolean, appendOnly?: boolean, allowHyperlink?: boolean, properties?: IFieldCreationProperties): Promise<IFieldAddResult>;
98
- /**
99
- * Adds a new SP.FieldUrl to the collection
100
- *
101
- * @param title The field title
102
- */
103
- addUrl(title: string, displayFormat?: UrlFieldFormatType, properties?: IFieldCreationProperties): Promise<IFieldAddResult>;
104
- /** Adds a user field to the colleciton
105
- *
106
- * @param title The new field's title
107
- * @param selectionMode The selection mode of the field
108
- * @param selectionGroup Value that specifies the identifier of the SharePoint group whose members can be selected as values of the field
109
- * @param properties
110
- */
111
- addUser(title: string, selectionMode: FieldUserSelectionMode, properties?: IFieldCreationProperties): Promise<IFieldAddResult>;
112
- /**
113
- * Adds a SP.FieldLookup to the collection
114
- *
115
- * @param title The new field's title
116
- * @param lookupListId The guid id of the list where the source of the lookup is found
117
- * @param lookupFieldName The internal name of the field in the source list
118
- * @param properties Set of additional properties to set on the new field
119
- */
120
- addLookup(title: string, lookupListId: string, lookupFieldName: string, properties?: IFieldCreationProperties): Promise<IFieldAddResult>;
121
- /**
122
- * Adds a new SP.FieldChoice to the collection
123
- *
124
- * @param title The field title.
125
- * @param choices The choices for the field.
126
- * @param format The display format of the available options for the field.
127
- * @param fillIn Specifies whether the field allows fill-in values.
128
- * @param properties Differ by type of field being created (see: https://msdn.microsoft.com/en-us/library/office/dn600182.aspx)
129
- */
130
- addChoice(title: string, choices: string[], format?: ChoiceFieldFormatType, fillIn?: boolean, properties?: IFieldCreationProperties): Promise<IFieldAddResult>;
131
- /**
132
- * Adds a new SP.FieldMultiChoice to the collection
133
- *
134
- * @param title The field title.
135
- * @param choices The choices for the field.
136
- * @param fillIn Specifies whether the field allows fill-in values.
137
- * @param properties Differ by type of field being created (see: https://msdn.microsoft.com/en-us/library/office/dn600182.aspx)
138
- */
139
- addMultiChoice(title: string, choices: string[], fillIn?: boolean, properties?: IFieldCreationProperties): Promise<IFieldAddResult>;
140
- /**
141
- * Adds a new SP.FieldBoolean to the collection
142
- *
143
- * @param title The field title.
144
- * @param properties Differ by type of field being created (see: https://msdn.microsoft.com/en-us/library/office/dn600182.aspx)
145
- */
146
- addBoolean(title: string, properties?: IFieldCreationProperties): Promise<IFieldAddResult>;
147
- /**
148
- * Creates a secondary (dependent) lookup field, based on the Id of the primary lookup field.
149
- *
150
- * @param displayName The display name of the new field.
151
- * @param primaryLookupFieldId The guid of the primary Lookup Field.
152
- * @param showField Which field to show from the lookup list.
153
- */
154
- addDependentLookupField(displayName: string, primaryLookupFieldId: string, showField: string): Promise<IFieldAddResult>;
155
- /**
156
- * Adds a new SP.FieldLocation to the collection
157
- *
158
- * @param title The field title.
159
- * @param properties Differ by type of field being created (see: https://msdn.microsoft.com/en-us/library/office/dn600182.aspx)
160
- */
161
- addLocation(title: string, properties?: IFieldCreationProperties): Promise<IFieldAddResult>;
162
- }
163
- export interface IFields extends _Fields {
164
- }
165
- export declare const Fields: import("../sharepointqueryable.js").ISPInvokableFactory<IFields>;
166
- export declare class _Field extends _SharePointQueryableInstance<IFieldInfo> {
167
- delete: (this: import("../sharepointqueryable.js").ISharePointQueryable<any>) => Promise<void>;
168
- /**
169
- * Updates this field instance with the supplied properties
170
- *
171
- * @param properties A plain object hash of values to update for the list
172
- * @param fieldType The type value such as SP.FieldLookup. Optional, looked up from the field if not provided
173
- */
174
- update(properties: any, fieldType?: string): Promise<IFieldUpdateResult>;
175
- /**
176
- * Sets the value of the ShowInDisplayForm property for this field.
177
- */
178
- setShowInDisplayForm(show: boolean): Promise<void>;
179
- /**
180
- * Sets the value of the ShowInEditForm property for this field.
181
- */
182
- setShowInEditForm(show: boolean): Promise<void>;
183
- /**
184
- * Sets the value of the ShowInNewForm property for this field.
185
- */
186
- setShowInNewForm(show: boolean): Promise<void>;
187
- }
188
- export interface IField extends _Field, IDeleteable {
189
- }
190
- export declare const Field: import("../sharepointqueryable.js").ISPInvokableFactory<IField>;
191
- /**
192
- * This interface defines the result of adding a field
193
- */
194
- export interface IFieldAddResult {
195
- data: Partial<IFieldInfo>;
196
- field: IField;
197
- }
198
- /**
199
- * This interface defines the result of updating a field
200
- */
201
- export interface IFieldUpdateResult {
202
- data: Partial<IFieldInfo>;
203
- field: IField;
204
- }
205
- /**
206
- * Specifies the type of the field.
207
- */
208
- export declare enum FieldTypes {
209
- Invalid = 0,
210
- Integer = 1,
211
- Text = 2,
212
- Note = 3,
213
- DateTime = 4,
214
- Counter = 5,
215
- Choice = 6,
216
- Lookup = 7,
217
- Boolean = 8,
218
- Number = 9,
219
- Currency = 10,
220
- URL = 11,
221
- Computed = 12,
222
- Threading = 13,
223
- Guid = 14,
224
- MultiChoice = 15,
225
- GridChoice = 16,
226
- Calculated = 17,
227
- File = 18,
228
- Attachments = 19,
229
- User = 20,
230
- Recurrence = 21,
231
- CrossProjectLink = 22,
232
- ModStat = 23,
233
- Error = 24,
234
- ContentTypeId = 25,
235
- PageSeparator = 26,
236
- ThreadIndex = 27,
237
- WorkflowStatus = 28,
238
- AllDayEvent = 29,
239
- WorkflowEventType = 30
240
- }
241
- export declare enum DateTimeFieldFormatType {
242
- DateOnly = 0,
243
- DateTime = 1
244
- }
245
- export declare enum DateTimeFieldFriendlyFormatType {
246
- Unspecified = 0,
247
- Disabled = 1,
248
- Relative = 2
249
- }
250
- /**
251
- * Specifies the control settings while adding a field.
252
- */
253
- export declare enum AddFieldOptions {
254
- /**
255
- * Specify that a new field added to the list must also be added to the default content type in the site collection
256
- */
257
- DefaultValue = 0,
258
- /**
259
- * Specify that a new field added to the list must also be added to the default content type in the site collection.
260
- */
261
- AddToDefaultContentType = 1,
262
- /**
263
- * Specify that a new field must not be added to any other content type
264
- */
265
- AddToNoContentType = 2,
266
- /**
267
- * Specify that a new field that is added to the specified list must also be added to all content types in the site collection
268
- */
269
- AddToAllContentTypes = 4,
270
- /**
271
- * Specify adding an internal field name hint for the purpose of avoiding possible database locking or field renaming operations
272
- */
273
- AddFieldInternalNameHint = 8,
274
- /**
275
- * Specify that a new field that is added to the specified list must also be added to the default list view
276
- */
277
- AddFieldToDefaultView = 16,
278
- /**
279
- * Specify to confirm that no other field has the same display name
280
- */
281
- AddFieldCheckDisplayName = 32
282
- }
283
- export interface IXmlSchemaFieldCreationInformation {
284
- Options?: AddFieldOptions;
285
- SchemaXml: string;
286
- }
287
- export declare enum CalendarType {
288
- Gregorian = 1,
289
- Japan = 3,
290
- Taiwan = 4,
291
- Korea = 5,
292
- Hijri = 6,
293
- Thai = 7,
294
- Hebrew = 8,
295
- GregorianMEFrench = 9,
296
- GregorianArabic = 10,
297
- GregorianXLITEnglish = 11,
298
- GregorianXLITFrench = 12,
299
- KoreaJapanLunar = 14,
300
- ChineseLunar = 15,
301
- SakaEra = 16,
302
- UmAlQura = 23
303
- }
304
- export declare enum UrlFieldFormatType {
305
- Hyperlink = 0,
306
- Image = 1
307
- }
308
- export declare enum FieldUserSelectionMode {
309
- PeopleAndGroups = 1,
310
- PeopleOnly = 0
311
- }
312
- export interface IFieldCreationProperties extends ITypedHash<string | number | boolean> {
313
- DefaultFormula?: string;
314
- Description?: string;
315
- EnforceUniqueValues?: boolean;
316
- FieldTypeKind?: number;
317
- Group?: string;
318
- Hidden?: boolean;
319
- Indexed?: boolean;
320
- Required?: boolean;
321
- Title?: string;
322
- ValidationFormula?: string;
323
- ValidationMessage?: string;
324
- }
325
- export declare enum ChoiceFieldFormatType {
326
- Dropdown = 0,
327
- RadioButtons = 1
328
- }
329
- export interface IFieldInfo {
330
- DefaultFormula: string | null;
331
- DefaultValue: string | null;
332
- Description: string;
333
- Direction: string;
334
- EnforceUniqueValues: boolean;
335
- EntityPropertyName: string;
336
- FieldTypeKind: FieldTypes;
337
- Filterable: boolean;
338
- FromBaseType: boolean;
339
- Group: string;
340
- Hidden: boolean;
341
- Id: string;
342
- Indexed: boolean;
343
- IndexStatus: number;
344
- InternalName: string;
345
- JSLink: string;
346
- PinnedToFiltersPane: boolean;
347
- ReadOnlyField: boolean;
348
- Required: boolean;
349
- SchemaXml: string;
350
- Scope: string;
351
- Sealed: boolean;
352
- ShowInFiltersPane: number;
353
- Sortable: boolean;
354
- StaticName: string;
355
- Title: string;
356
- TypeAsString: string;
357
- TypeDisplayName: string;
358
- TypeShortDescription: string;
359
- ValidationFormula: string | null;
360
- ValidationMessage: string | null;
361
- }
1
+ import { _SharePointQueryableInstance, _SharePointQueryableCollection, IDeleteable } from "../sharepointqueryable.js";
2
+ import { ITypedHash } from "@pnp/common";
3
+ export declare class _Fields extends _SharePointQueryableCollection<IFieldInfo[]> {
4
+ /**
5
+ * Creates a field based on the specified schema
6
+ *
7
+ * @param xml A string or XmlSchemaFieldCreationInformation instance descrbing the field to create
8
+ */
9
+ createFieldAsXml(xml: string | IXmlSchemaFieldCreationInformation): Promise<IFieldAddResult>;
10
+ /**
11
+ * Gets a field from the collection by id
12
+ *
13
+ * @param id The Id of the list
14
+ */
15
+ getById(id: string): IField;
16
+ /**
17
+ * Gets a field from the collection by title
18
+ *
19
+ * @param title The case-sensitive title of the field
20
+ */
21
+ getByTitle(title: string): IField;
22
+ /**
23
+ * Gets a field from the collection by using internal name or title
24
+ *
25
+ * @param name The case-sensitive internal name or title of the field
26
+ */
27
+ getByInternalNameOrTitle(name: string): IField;
28
+ /**
29
+ * Adds a new field to the collection
30
+ *
31
+ * @param title The new field's title
32
+ * @param fieldType The new field's type (ex: SP.FieldText)
33
+ * @param properties Differ by type of field being created (see: https://msdn.microsoft.com/en-us/library/office/dn600182.aspx)
34
+ */
35
+ add(title: string, fieldType: string, properties: IFieldCreationProperties & {
36
+ FieldTypeKind: number;
37
+ }): Promise<IFieldAddResult>;
38
+ /**
39
+ * Adds a new SP.FieldText to the collection
40
+ *
41
+ * @param title The field title
42
+ * @param maxLength The maximum number of characters allowed in the value of the field.
43
+ * @param properties Differ by type of field being created (see: https://msdn.microsoft.com/en-us/library/office/dn600182.aspx)
44
+ */
45
+ addText(title: string, maxLength?: number, properties?: IFieldCreationProperties): Promise<IFieldAddResult>;
46
+ /**
47
+ * Adds a new SP.FieldCalculated to the collection
48
+ *
49
+ * @param title The field title.
50
+ * @param formula The formula for the field.
51
+ * @param dateFormat The date and time format that is displayed in the field.
52
+ * @param outputType Specifies the output format for the field. Represents a FieldType value.
53
+ * @param properties Differ by type of field being created (see: https://msdn.microsoft.com/en-us/library/office/dn600182.aspx)
54
+ */
55
+ addCalculated(title: string, formula: string, dateFormat: DateTimeFieldFormatType, outputType?: FieldTypes, properties?: IFieldCreationProperties): Promise<IFieldAddResult>;
56
+ /**
57
+ * Adds a new SP.FieldDateTime to the collection
58
+ *
59
+ * @param title The field title
60
+ * @param displayFormat The format of the date and time that is displayed in the field.
61
+ * @param calendarType Specifies the calendar type of the field.
62
+ * @param friendlyDisplayFormat The type of friendly display format that is used in the field.
63
+ * @param properties Differ by type of field being created (see: https://msdn.microsoft.com/en-us/library/office/dn600182.aspx)
64
+ */
65
+ addDateTime(title: string, displayFormat?: DateTimeFieldFormatType, calendarType?: CalendarType, friendlyDisplayFormat?: DateTimeFieldFriendlyFormatType, properties?: IFieldCreationProperties): Promise<IFieldAddResult>;
66
+ /**
67
+ * Adds a new SP.FieldNumber to the collection
68
+ *
69
+ * @param title The field title
70
+ * @param minValue The field's minimum value
71
+ * @param maxValue The field's maximum value
72
+ * @param properties Differ by type of field being created (see: https://msdn.microsoft.com/en-us/library/office/dn600182.aspx)
73
+ */
74
+ addNumber(title: string, minValue?: number, maxValue?: number, properties?: IFieldCreationProperties): Promise<IFieldAddResult>;
75
+ /**
76
+ * Adds a new SP.FieldCurrency to the collection
77
+ *
78
+ * @param title The field title
79
+ * @param minValue The field's minimum value
80
+ * @param maxValue The field's maximum value
81
+ * @param currencyLocalId Specifies the language code identifier (LCID) used to format the value of the field
82
+ * @param properties Differ by type of field being created (see: https://msdn.microsoft.com/en-us/library/office/dn600182.aspx)
83
+ */
84
+ addCurrency(title: string, minValue?: number, maxValue?: number, currencyLocalId?: number, properties?: IFieldCreationProperties): Promise<IFieldAddResult>;
85
+ /**
86
+ * Adds a new SP.FieldMultiLineText to the collection
87
+ *
88
+ * @param title The field title
89
+ * @param numberOfLines Specifies the number of lines of text to display for the field.
90
+ * @param richText Specifies whether the field supports rich formatting.
91
+ * @param restrictedMode Specifies whether the field supports a subset of rich formatting.
92
+ * @param appendOnly Specifies whether all changes to the value of the field are displayed in list forms.
93
+ * @param allowHyperlink Specifies whether a hyperlink is allowed as a value of the field.
94
+ * @param properties Differ by type of field being created (see: https://msdn.microsoft.com/en-us/library/office/dn600182.aspx)
95
+ *
96
+ */
97
+ addMultilineText(title: string, numberOfLines?: number, richText?: boolean, restrictedMode?: boolean, appendOnly?: boolean, allowHyperlink?: boolean, properties?: IFieldCreationProperties): Promise<IFieldAddResult>;
98
+ /**
99
+ * Adds a new SP.FieldUrl to the collection
100
+ *
101
+ * @param title The field title
102
+ */
103
+ addUrl(title: string, displayFormat?: UrlFieldFormatType, properties?: IFieldCreationProperties): Promise<IFieldAddResult>;
104
+ /** Adds a user field to the colleciton
105
+ *
106
+ * @param title The new field's title
107
+ * @param selectionMode The selection mode of the field
108
+ * @param selectionGroup Value that specifies the identifier of the SharePoint group whose members can be selected as values of the field
109
+ * @param properties
110
+ */
111
+ addUser(title: string, selectionMode: FieldUserSelectionMode, properties?: IFieldCreationProperties): Promise<IFieldAddResult>;
112
+ /**
113
+ * Adds a SP.FieldLookup to the collection
114
+ *
115
+ * @param title The new field's title
116
+ * @param lookupListId The guid id of the list where the source of the lookup is found
117
+ * @param lookupFieldName The internal name of the field in the source list
118
+ * @param properties Set of additional properties to set on the new field
119
+ */
120
+ addLookup(title: string, lookupListId: string, lookupFieldName: string, properties?: IFieldCreationProperties): Promise<IFieldAddResult>;
121
+ /**
122
+ * Adds a new SP.FieldChoice to the collection
123
+ *
124
+ * @param title The field title.
125
+ * @param choices The choices for the field.
126
+ * @param format The display format of the available options for the field.
127
+ * @param fillIn Specifies whether the field allows fill-in values.
128
+ * @param properties Differ by type of field being created (see: https://msdn.microsoft.com/en-us/library/office/dn600182.aspx)
129
+ */
130
+ addChoice(title: string, choices: string[], format?: ChoiceFieldFormatType, fillIn?: boolean, properties?: IFieldCreationProperties): Promise<IFieldAddResult>;
131
+ /**
132
+ * Adds a new SP.FieldMultiChoice to the collection
133
+ *
134
+ * @param title The field title.
135
+ * @param choices The choices for the field.
136
+ * @param fillIn Specifies whether the field allows fill-in values.
137
+ * @param properties Differ by type of field being created (see: https://msdn.microsoft.com/en-us/library/office/dn600182.aspx)
138
+ */
139
+ addMultiChoice(title: string, choices: string[], fillIn?: boolean, properties?: IFieldCreationProperties): Promise<IFieldAddResult>;
140
+ /**
141
+ * Adds a new SP.FieldBoolean to the collection
142
+ *
143
+ * @param title The field title.
144
+ * @param properties Differ by type of field being created (see: https://msdn.microsoft.com/en-us/library/office/dn600182.aspx)
145
+ */
146
+ addBoolean(title: string, properties?: IFieldCreationProperties): Promise<IFieldAddResult>;
147
+ /**
148
+ * Creates a secondary (dependent) lookup field, based on the Id of the primary lookup field.
149
+ *
150
+ * @param displayName The display name of the new field.
151
+ * @param primaryLookupFieldId The guid of the primary Lookup Field.
152
+ * @param showField Which field to show from the lookup list.
153
+ */
154
+ addDependentLookupField(displayName: string, primaryLookupFieldId: string, showField: string): Promise<IFieldAddResult>;
155
+ /**
156
+ * Adds a new SP.FieldLocation to the collection
157
+ *
158
+ * @param title The field title.
159
+ * @param properties Differ by type of field being created (see: https://msdn.microsoft.com/en-us/library/office/dn600182.aspx)
160
+ */
161
+ addLocation(title: string, properties?: IFieldCreationProperties): Promise<IFieldAddResult>;
162
+ /**
163
+ * Adds a new SP.FieldLocation to the collection
164
+ *
165
+ * @param title The field title.
166
+ * @param properties Differ by type of field being created (see: https://msdn.microsoft.com/en-us/library/office/dn600182.aspx)
167
+ */
168
+ addImageField(title: string, properties?: IFieldCreationProperties): Promise<IFieldAddResult>;
169
+ }
170
+ export interface IFields extends _Fields {
171
+ }
172
+ export declare const Fields: import("../sharepointqueryable.js").ISPInvokableFactory<IFields>;
173
+ export declare class _Field extends _SharePointQueryableInstance<IFieldInfo> {
174
+ delete: (this: import("../sharepointqueryable.js").ISharePointQueryable<any>) => Promise<void>;
175
+ /**
176
+ * Updates this field instance with the supplied properties
177
+ *
178
+ * @param properties A plain object hash of values to update for the list
179
+ * @param fieldType The type value such as SP.FieldLookup. Optional, looked up from the field if not provided
180
+ */
181
+ update(properties: any, fieldType?: string): Promise<IFieldUpdateResult>;
182
+ /**
183
+ * Sets the value of the ShowInDisplayForm property for this field.
184
+ */
185
+ setShowInDisplayForm(show: boolean): Promise<void>;
186
+ /**
187
+ * Sets the value of the ShowInEditForm property for this field.
188
+ */
189
+ setShowInEditForm(show: boolean): Promise<void>;
190
+ /**
191
+ * Sets the value of the ShowInNewForm property for this field.
192
+ */
193
+ setShowInNewForm(show: boolean): Promise<void>;
194
+ }
195
+ export interface IField extends _Field, IDeleteable {
196
+ }
197
+ export declare const Field: import("../sharepointqueryable.js").ISPInvokableFactory<IField>;
198
+ /**
199
+ * This interface defines the result of adding a field
200
+ */
201
+ export interface IFieldAddResult {
202
+ data: Partial<IFieldInfo>;
203
+ field: IField;
204
+ }
205
+ /**
206
+ * This interface defines the result of updating a field
207
+ */
208
+ export interface IFieldUpdateResult {
209
+ data: Partial<IFieldInfo>;
210
+ field: IField;
211
+ }
212
+ /**
213
+ * Specifies the type of the field.
214
+ */
215
+ export declare enum FieldTypes {
216
+ Invalid = 0,
217
+ Integer = 1,
218
+ Text = 2,
219
+ Note = 3,
220
+ DateTime = 4,
221
+ Counter = 5,
222
+ Choice = 6,
223
+ Lookup = 7,
224
+ Boolean = 8,
225
+ Number = 9,
226
+ Currency = 10,
227
+ URL = 11,
228
+ Computed = 12,
229
+ Threading = 13,
230
+ Guid = 14,
231
+ MultiChoice = 15,
232
+ GridChoice = 16,
233
+ Calculated = 17,
234
+ File = 18,
235
+ Attachments = 19,
236
+ User = 20,
237
+ Recurrence = 21,
238
+ CrossProjectLink = 22,
239
+ ModStat = 23,
240
+ Error = 24,
241
+ ContentTypeId = 25,
242
+ PageSeparator = 26,
243
+ ThreadIndex = 27,
244
+ WorkflowStatus = 28,
245
+ AllDayEvent = 29,
246
+ WorkflowEventType = 30
247
+ }
248
+ export declare enum DateTimeFieldFormatType {
249
+ DateOnly = 0,
250
+ DateTime = 1
251
+ }
252
+ export declare enum DateTimeFieldFriendlyFormatType {
253
+ Unspecified = 0,
254
+ Disabled = 1,
255
+ Relative = 2
256
+ }
257
+ /**
258
+ * Specifies the control settings while adding a field.
259
+ */
260
+ export declare enum AddFieldOptions {
261
+ /**
262
+ * Specify that a new field added to the list must also be added to the default content type in the site collection
263
+ */
264
+ DefaultValue = 0,
265
+ /**
266
+ * Specify that a new field added to the list must also be added to the default content type in the site collection.
267
+ */
268
+ AddToDefaultContentType = 1,
269
+ /**
270
+ * Specify that a new field must not be added to any other content type
271
+ */
272
+ AddToNoContentType = 2,
273
+ /**
274
+ * Specify that a new field that is added to the specified list must also be added to all content types in the site collection
275
+ */
276
+ AddToAllContentTypes = 4,
277
+ /**
278
+ * Specify adding an internal field name hint for the purpose of avoiding possible database locking or field renaming operations
279
+ */
280
+ AddFieldInternalNameHint = 8,
281
+ /**
282
+ * Specify that a new field that is added to the specified list must also be added to the default list view
283
+ */
284
+ AddFieldToDefaultView = 16,
285
+ /**
286
+ * Specify to confirm that no other field has the same display name
287
+ */
288
+ AddFieldCheckDisplayName = 32
289
+ }
290
+ export interface IXmlSchemaFieldCreationInformation {
291
+ Options?: AddFieldOptions;
292
+ SchemaXml: string;
293
+ }
294
+ export declare enum CalendarType {
295
+ Gregorian = 1,
296
+ Japan = 3,
297
+ Taiwan = 4,
298
+ Korea = 5,
299
+ Hijri = 6,
300
+ Thai = 7,
301
+ Hebrew = 8,
302
+ GregorianMEFrench = 9,
303
+ GregorianArabic = 10,
304
+ GregorianXLITEnglish = 11,
305
+ GregorianXLITFrench = 12,
306
+ KoreaJapanLunar = 14,
307
+ ChineseLunar = 15,
308
+ SakaEra = 16,
309
+ UmAlQura = 23
310
+ }
311
+ export declare enum UrlFieldFormatType {
312
+ Hyperlink = 0,
313
+ Image = 1
314
+ }
315
+ export declare enum FieldUserSelectionMode {
316
+ PeopleAndGroups = 1,
317
+ PeopleOnly = 0
318
+ }
319
+ export interface IFieldCreationProperties extends ITypedHash<string | number | boolean> {
320
+ DefaultFormula?: string;
321
+ Description?: string;
322
+ EnforceUniqueValues?: boolean;
323
+ FieldTypeKind?: number;
324
+ Group?: string;
325
+ Hidden?: boolean;
326
+ Indexed?: boolean;
327
+ Required?: boolean;
328
+ Title?: string;
329
+ ValidationFormula?: string;
330
+ ValidationMessage?: string;
331
+ }
332
+ export declare enum ChoiceFieldFormatType {
333
+ Dropdown = 0,
334
+ RadioButtons = 1
335
+ }
336
+ export interface IFieldInfo {
337
+ DefaultFormula: string | null;
338
+ DefaultValue: string | null;
339
+ Description: string;
340
+ Direction: string;
341
+ EnforceUniqueValues: boolean;
342
+ EntityPropertyName: string;
343
+ FieldTypeKind: FieldTypes;
344
+ Filterable: boolean;
345
+ FromBaseType: boolean;
346
+ Group: string;
347
+ Hidden: boolean;
348
+ Id: string;
349
+ Indexed: boolean;
350
+ IndexStatus: number;
351
+ InternalName: string;
352
+ JSLink: string;
353
+ PinnedToFiltersPane: boolean;
354
+ ReadOnlyField: boolean;
355
+ Required: boolean;
356
+ SchemaXml: string;
357
+ Scope: string;
358
+ Sealed: boolean;
359
+ ShowInFiltersPane: number;
360
+ Sortable: boolean;
361
+ StaticName: string;
362
+ Title: string;
363
+ TypeAsString: string;
364
+ TypeDisplayName: string;
365
+ TypeShortDescription: string;
366
+ ValidationFormula: string | null;
367
+ ValidationMessage: string | null;
368
+ }
362
369
  //# sourceMappingURL=types.d.ts.map