SharePoint
Страницы и списки SharePoint
SharePoint — сайты, страницы, списки и библиотеки документов Microsoft 365.
С SharePoint в Pailot вы можете:
- Создавать и читать страницы, смотреть сайты
- Создавать списки, читать метаданные, добавлять и обновлять элементы
- Загружать файлы в библиотеку документов
Нужен OAuth (вход по разрешению сервиса) Microsoft. Блок ставят на холст как отдельный шаг или прикрепляют к агенту.
Создать страницу на сайте SharePoint.
| Параметр | Тип | Обязательный | Описание |
|---|
siteId | string | Нет | ID сайта SharePoint (внутреннее) |
siteSelector | string | Нет | Выбор сайта SharePoint |
pageName | string | Да | Имя страницы |
pageTitle | string | Нет | Заголовок (если нет — как имя) |
pageContent | string | Нет | Содержимое страницы |
| Параметр | Тип | Описание |
|---|
page | object | Созданная страница |
↳ id | string | ID страницы |
↳ name | string | Имя |
↳ title | string | Заголовок |
↳ webUrl | string | URL страницы |
↳ pageLayout | string | Тип макета |
↳ createdDateTime | string | Когда создана |
↳ lastModifiedDateTime | string | Когда изменена |
Прочитать страницу сайта SharePoint.
| Параметр | Тип | Обязательный | Описание |
|---|
siteSelector | string | Нет | Выбор сайта SharePoint |
siteId | string | Нет | ID сайта SharePoint (внутреннее) |
pageId | string | Нет | ID страницы |
pageName | string | Нет | Имя страницы (вместо pageId) |
maxPages | number | Нет | Максимум страниц при списке всех (по умолчанию 10, макс. 50) |
| Параметр | Тип | Описание |
|---|
page | object | Данные страницы |
↳ id | string | ID страницы |
↳ name | string | Имя |
↳ title | string | Заголовок |
↳ webUrl | string | URL страницы |
↳ pageLayout | string | Тип макета |
↳ createdDateTime | string | Когда создана |
↳ lastModifiedDateTime | string | Когда изменена |
pages | array | Список страниц |
↳ page | object | ID страницы |
↳ id | string | ID страницы |
↳ name | string | Имя |
↳ title | string | Заголовок |
↳ webUrl | string | URL страницы |
↳ pageLayout | string | Тип макета |
↳ createdDateTime | string | Когда создана |
↳ lastModifiedDateTime | string | Когда изменена |
↳ id | string | ID страницы |
↳ name | string | Имя |
↳ title | string | Заголовок |
↳ webUrl | string | URL страницы |
↳ pageLayout | string | Тип макета |
↳ createdDateTime | string | Когда создана |
↳ lastModifiedDateTime | string | Когда изменена |
↳ content | string | Извлечённый текст страницы |
↳ canvasLayout | object | Сырой макет холста SharePoint |
content | object | Содержимое страницы |
↳ content | string | Извлечённый текст |
↳ canvasLayout | object | Сырой макет холста SharePoint |
totalPages | number | Сколько страниц найдено |
Список сайтов SharePoint.
| Параметр | Тип | Обязательный | Описание |
|---|
siteSelector | string | Нет | Выбор сайта SharePoint |
groupId | string | Нет | ID группы для командного сайта |
| Параметр | Тип | Описание |
|---|
site | object | Текущий сайт |
↳ id | string | ID сайта |
↳ name | string | Имя |
↳ displayName | string | Отображаемое имя |
↳ webUrl | string | URL сайта |
↳ description | string | Описание |
↳ createdDateTime | string | Когда создан |
↳ lastModifiedDateTime | string | Когда изменён |
↳ isPersonalSite | boolean | Личный сайт |
↳ root | object | Относительный URL на сервере |
↳ serverRelativeUrl | string | Относительный URL на сервере |
↳ serverRelativeUrl | string | Относительный URL на сервере |
↳ siteCollection | object | Хост коллекции сайтов |
↳ hostname | string | Хост коллекции сайтов |
↳ hostname | string | Хост коллекции сайтов |
sites | array | Доступные сайты |
↳ id | string | ID сайта |
↳ name | string | Имя |
↳ displayName | string | Отображаемое имя |
↳ webUrl | string | URL сайта |
↳ description | string | Описание |
↳ createdDateTime | string | Когда создан |
↳ lastModifiedDateTime | string | Когда изменён |
Создать список на сайте SharePoint.
| Параметр | Тип | Обязательный | Описание |
|---|
siteId | string | Нет | ID сайта SharePoint (внутреннее) |
siteSelector | string | Нет | Выбор сайта SharePoint |
listDisplayName | string | Да | Отображаемое имя списка |
listDescription | string | Нет | Описание списка |
listTemplate | string | Нет | Шаблон списка (например genericList) |
pageContent | string | Нет | JSON колонок: массив определений или объект { columns: [...] } |
| Параметр | Тип | Описание |
|---|
list | object | Созданный список |
↳ id | string | ID списка |
↳ displayName | string | Отображаемое имя |
↳ name | string | Внутреннее имя |
↳ webUrl | string | URL списка |
↳ createdDateTime | string | Когда создан |
↳ lastModifiedDateTime | string | Когда изменён |
↳ list | object | Свойства списка (например шаблон) |
Метаданные списка (и при необходимости колонки и элементы).
| Параметр | Тип | Обязательный | Описание |
|---|
siteSelector | string | Нет | Выбор сайта SharePoint |
siteId | string | Нет | ID сайта SharePoint (внутреннее) |
listId | string | Нет | ID списка |
| Параметр | Тип | Описание |
|---|
list | object | Данные списка |
↳ id | string | ID элемента |
↳ displayName | string | Отображаемое имя |
↳ name | string | Внутреннее имя |
↳ webUrl | string | URL списка |
↳ createdDateTime | string | Когда создан |
↳ lastModifiedDateTime | string | Когда изменён |
↳ list | object | Свойства списка (например шаблон) |
↳ columns | array | Определения колонок |
↳ fields | object | Значения полей элемента |
lists | array | Все списки сайта, если listId не задан |
Обновить поля элемента списка SharePoint.
| Параметр | Тип | Обязательный | Описание |
|---|
siteSelector | string | Нет | Выбор сайта SharePoint |
siteId | string | Нет | ID сайта SharePoint (внутреннее) |
listId | string | Нет | ID списка с элементом |
itemId | string | Да | ID элемента |
listItemFields | object | Да | Новые значения полей |
| Параметр | Тип | Описание |
|---|
item | object | Обновлённый элемент |
↳ id | string | ID элемента |
↳ fields | object | Обновлённые поля |
Добавить элемент в список SharePoint.
| Параметр | Тип | Обязательный | Описание |
|---|
siteSelector | string | Нет | Выбор сайта SharePoint |
siteId | string | Нет | ID сайта SharePoint (внутреннее) |
listId | string | Да | ID списка |
listItemFields | object | Да | Значения полей нового элемента |
| Параметр | Тип | Описание |
|---|
item | object | Созданный элемент |
↳ id | string | ID элемента |
↳ fields | object | Поля нового элемента |
Загрузить файлы в библиотеку документов SharePoint.
| Параметр | Тип | Обязательный | Описание |
|---|
siteId | string | Нет | ID сайта SharePoint |
driveId | string | Нет | ID библиотеки (drive). Если нет — библиотека по умолчанию |
folderPath | string | Нет | Путь папки в библиотеке (например /Documents/Subfolder) |
fileName | string | Нет | Подставить своё имя файла |
files | file[] | Нет | Файлы для загрузки |
| Параметр | Тип | Описание |
|---|
uploadedFiles | array | Загруженные файлы |
↳ id | string | ID файла |
↳ name | string | Имя файла |
↳ webUrl | string | URL файла |
↳ size | number | Размер в байтах |
↳ createdDateTime | string | Когда создан |
↳ lastModifiedDateTime | string | Когда изменён |
fileCount | number | Сколько файлов загружено |