Смарт-лист

Smartsheet — это мощный инструмент управления работой и совместной работы, который позволяет легко отслеживать работу и управлять ими, чтобы вы и ваша команда могли работать эффективнее, чем когда-либо. Используйте его для совместной работы с другими пользователями, отслеживания хода выполнения любого проекта, автоматизации процессов и повышения структуры работы.

Этот соединитель доступен в следующих продуктах и регионах:

Услуга	Class	Регионы
Copilot Studio	Стандарт	Все регионы Power Automate , кроме следующих: - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD)
Логические приложения	Стандарт	Все регионы Logic Apps , кроме следующих: — Регионы Azure Для Китая - Министерство обороны США (DoD)
Power Apps	Стандарт	Все регионы Power Apps , кроме следующих: - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD)
Power Automate	Стандарт	Все регионы Power Automate , кроме следующих: - Правительство США (GCC High) — Облако Китая, управляемое 21Vianet - Министерство обороны США (DoD)

Контакт
Имя	Microsoft
URL	Поддержка Microsoft LogicApps Поддержка Microsoft Power Automate Поддержка Microsoft Power Apps

Метаданные соединителя
Publisher	Microsoft
Website	https://www.smartsheet.com/
Политика конфиденциальности	https://www.smartsheet.com/legal/privacy

Чтобы использовать эту интеграцию, вам потребуется доступ к учетной записи Smartsheet. Чтобы сделать подключение, нажмите кнопку "Войти". Вам будет предложено указать сведения о учетной записи Smartsheet, следуйте остальным экранам, чтобы создать подключение.

Теперь вы готовы начать использовать эту интеграцию.

Ограничения регулирования

Имя	Вызовы	Период обновления
Частота опросов триггеров	1	15 секунд

Действия

Вставка строки	Вставьте строку в определенный лист.
Вывод списка листов	Получите список листов.
Добавление комментария в обсуждение	Добавьте комментарий в существующее обсуждение.
Добавление обсуждения в строку	Добавьте обсуждение в определенную строку на листе.
Добавление обсуждения на лист	Добавление обсуждения на лист
Получение вложенных папок папки	Получение вложенных папок определенной папки.
Получение данных листа (динамическая схема)	Получение данных определенного листа.
Получение листа	Получите определенный лист.
Получение обсуждений для листа	Получите обсуждения для определенного листа.
Получение обсуждения	Получите определенное обсуждение.
Получение столбцов листа	Получение столбцов определенного листа.
Получение столбцов листа (динамическая схема)	Получение столбцов определенного листа в динамическом формате схемы.

Вставка строки

Идентификатор операции:: InsertRow

Вставьте строку в определенный лист.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор листа	sheetId	True	string	Уникальный идентификатор листа.
Row	row	True	dynamic	Строка для вставки.

Возвращаемое значение

Ответ на операцию InsertRow.

Тело: InsertRowResponse

Вывод списка листов

Идентификатор операции:: ListSheets

Получите список листов.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор папки (по умолчанию для всех)	optionalFolderId		string	Уникальный идентификатор папки, содержащей листы. Если этот параметр не указан, по умолчанию будет использоваться для всех.

Возвращаемое значение

Распространенный шаблон запроса коллекций из Smartsheet.

Тело: SmartsheetCollection[Sheet]

Добавление комментария в обсуждение

Идентификатор операции:: AddCommentToDiscussion

Добавьте комментарий в существующее обсуждение.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор листа	sheetId	True	string	Уникальный идентификатор листа.
Обсуждение	discussionId	True	string	Обсуждение, в который добавляется комментарий.
Текст	text		string	Текст комментария.

Возвращаемое значение

Объект ответа для создания комментария.

Тело: CreateCommentResponse

Добавление обсуждения в строку

Идентификатор операции:: AddDiscussionToRow

Добавьте обсуждение в определенную строку на листе.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Лист	sheetId	True	string	Уникальный идентификатор листа.
Идентификатор строки	rowId	True	string	Уникальный идентификатор строки.
Название	title		string	Название обсуждения.
Текст	text		string	Текст комментария.

Возвращаемое значение

Объект ответа для create Discussion.

Тело: DiscussionResponse

Добавление обсуждения на лист

Идентификатор операции:: AddDiscussionToSheet

Добавление обсуждения на лист

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор листа	sheetId	True	string	Лист для добавления обсуждения
Название	title		string	Название обсуждения.
Текст	text		string	Текст комментария.

Возвращаемое значение

Объект ответа для create Discussion.

Тело: DiscussionResponse

Получение вложенных папок папки

Идентификатор операции:: ListSubFolders

Получение вложенных папок определенной папки.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор папки	id	True	string	Идентификатор папки.

Возвращаемое значение

Распространенный шаблон запроса коллекций из Smartsheet.

Тело: SmartsheetCollection[Folder]

Получение данных листа (динамическая схема)

Идентификатор операции:: GetSheetData

Получение данных определенного листа.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор листа	sheetId	True	string	Уникальный идентификатор листа.
Разделенные запятыми столбцы для возврата	columns		string	Список возвращаемых столбцов

Возвращаемое значение

Выходные данные этой операции являются динамическими.

Получение листа

Идентификатор операции:: GetSheet

Получите определенный лист.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор листа	sheetId	True	string	Уникальный идентификатор листа.
Разделенные запятыми столбцы для возврата	columns		string	Список возвращаемых столбцов

Возвращаемое значение

Лист Smartsheet со строками.

Тело: SheetWithRows

Получение обсуждений для листа

Идентификатор операции:: GetDiscussionsForSheet

Получите обсуждения для определенного листа.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор листа	sheetId	True	string	Уникальный идентификатор листа.

Возвращаемое значение

Распространенный шаблон запроса коллекций из Smartsheet.

Тело: SmartsheetCollection[GetDiscussionResponse]

Получение обсуждения

Идентификатор операции:: GetDiscussion

Получите определенное обсуждение.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор листа	sheetId	True	string	Уникальный идентификатор листа.
Идентификатор обсуждения	discussionId	True	string	Уникальный идентификатор обсуждения на указанном листе.

Возвращаемое значение

Данные, относящиеся к созданному обсуждению.

Тело: DiscussionData

Получение столбцов листа

Идентификатор операции:: GetColumns

Получение столбцов определенного листа.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор листа	sheetId	True	string	Уникальный идентификатор листа.

Возвращаемое значение

Распространенный шаблон запроса коллекций из Smartsheet.

Тело: SmartsheetCollection[Column]

Получение столбцов листа (динамическая схема)

Идентификатор операции:: GetColumnsSchema

Получение столбцов определенного листа в динамическом формате схемы.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор листа	sheetId	True	string	Уникальный идентификатор листа.

Триггеры

При добавлении комментария в обсуждение	Активирует при добавлении комментария в определенное обсуждение.
При добавлении комментария на лист	Активирует при добавлении комментария на определенный лист.
При добавлении обсуждения на лист	Активирует при добавлении обсуждения на лист.
При обновлении листа	Активирует при обновлении определенного листа.
При обновлении любого листа	Активирует при обновлении любого листа.
При создании нового листа	Активирует при создании нового листа.
При создании новой строки	Активирует при создании новой строки на определенном листе.

При добавлении комментария в обсуждение

Идентификатор операции:: OnCommentAdded

Активирует при добавлении комментария в определенное обсуждение.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор листа	sheetId	True	string	Уникальный идентификатор листа.
Идентификатор обсуждения	discussionId	True	string	Уникальный идентификатор обсуждения.

Возвращаемое значение

Объект ответа для Comment.

Тело: CommentResponse

При добавлении комментария на лист

Идентификатор операции:: OnNewComment

Активирует при добавлении комментария на определенный лист.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор листа	sheetId	True	string	Уникальный идентификатор листа.

Возвращаемое значение

Распространенный шаблон запроса коллекций из Smartsheet.

Тело: SmartsheetCollection[DiscussionComment]

При добавлении обсуждения на лист

Идентификатор операции:: OnDiscussionCreated

Активирует при добавлении обсуждения на лист.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор листа	sheetId	True	string	Уникальный идентификатор листа.

Возвращаемое значение

Распространенный шаблон запроса коллекций из Smartsheet.

Тело: SmartsheetCollection[GetDiscussionResponse]

При обновлении листа

Идентификатор операции:: OnUpdatedSpecificSheet

Активирует при обновлении определенного листа.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор листа	sheetId	True	string	Уникальный идентификатор листа.
Возвращаемые столбцы	columns		string	Возвращаемый запятыми список возвращаемых столбцов.

Возвращаемое значение

Распространенный шаблон запроса коллекций из Smartsheet.

Тело: SmartsheetCollection[SheetWithRows]

При обновлении любого листа

Идентификатор операции:: OnUpdatedSheet

Активирует при обновлении любого листа.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Папка (по умолчанию для всех)	optionalFolderId		string	Уникальный идентификатор папки, содержащей листы. Если этот параметр не указан, по умолчанию будет использоваться для всех.

Возвращаемое значение

Распространенный шаблон запроса коллекций из Smartsheet.

Тело: SmartsheetCollection[Sheet]

При создании нового листа

Идентификатор операции:: OnNewSheet

Активирует при создании нового листа.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор папки (по умолчанию для всех)	optionalFolderId		string	Уникальный идентификатор папки, содержащей листы. Если этот параметр не указан, по умолчанию будет использоваться для всех.

Возвращаемое значение

Распространенный шаблон запроса коллекций из Smartsheet.

Тело: SmartsheetCollection[Sheet]

При создании новой строки

Идентификатор операции:: OnRowCreated

Активирует при создании новой строки на определенном листе.

Параметры

Имя	Ключ	Обязательно	Тип	Описание
Идентификатор листа	sheetId	True	string	Уникальный идентификатор листа.
Колонны	columns		string	Разделенный запятыми список столбцов.

Возвращаемое значение

Объект ответа для OnRowCreated.

Тело: RowResponse

Определения

SmartsheetCollection[Лист]

Распространенный шаблон запроса коллекций из Smartsheet.

Имя	Путь	Тип	Описание
Данные	data	array of Sheet	Коллекция моделей Smartsheet.

Лист

Лист Smartsheet.

Имя	Путь	Тип	Описание
Уровень доступа	accessLevel	string	Уровень доступа листа.
Идентификатор	id	integer	Уникальный идентификатор листа.
Имя	name	string	Имя листа.
URL-адрес	permalink	string	URL-адрес листа.
Создано в	createdAt	date-time	Дата создания листа.
Изменено в	modifiedAt	date-time	Дата изменения листа.

SmartsheetCollection[DiscussionComment]

Распространенный шаблон запроса коллекций из Smartsheet.

Имя	Путь	Тип	Описание
Данные	data	array of DiscussionComment	Коллекция моделей Smartsheet.

DiscussionComment

Комментарий к обсуждению.

Имя	Путь	Тип	Описание
Текст примечания	text	string	Текст комментария.
Идентификатор комментария	id	integer	Идентификатор комментария.
создано кем	createdBy	DiscussionCommentUser	Пользователь, создавший комментарий.
Создано в	createdAt	date-time	Дата создания комментария.
Изменено в	modifiedAt	date-time	Дата изменения комментария.

DiscussionCommentUser

Пользователь, создавший комментарий.

Имя	Путь	Тип	Описание
Создано по имени	name	string	Имя пользователя, создавшего комментарий.
Создано (электронная почта)	email	string	Сообщение электронной почты пользователя, создавшего комментарий.

SheetWithRows

Лист Smartsheet со строками.

Имя	Путь	Тип	Описание
Html-код листа	rowHTML	string	Представление таблицы HTML листа.
Уровень доступа	accessLevel	string	Уровень доступа листа.
Идентификатор	id	integer	Уникальный идентификатор листа.
Имя	name	string	Имя листа.
URL-адрес	permalink	string	URL-адрес листа.
Создано в	createdAt	date-time	Дата создания листа.
Изменено в	modifiedAt	date-time	Дата изменения листа.
Колонны	columns	array of Column	Массив столбцов.
Rows	rows	array of RowData	Массив строк.

SmartsheetCollection[Столбец]

Распространенный шаблон запроса коллекций из Smartsheet.

Имя	Путь	Тип	Описание
Данные	data	array of Column	Коллекция моделей Smartsheet

колонна

Столбец Smartsheet.

Имя	Путь	Тип	Описание
Идентификатор столбца	id	integer	Уникальный идентификатор столбца.
Индекс столбца	index	integer	Порядковое положение столбца.
Название	title	string	Заголовок столбца.
Тип данных	type	string	Тип данных столбца (например, text_number или datetime).
Основной	primary	boolean	Логическое значение (true, false) определяет, является ли столбец основным столбцом.
Ширина	width	integer	Ширина в пикселях столбца,

InsertRowResponse

Ответ на операцию InsertRow.

Имя	Путь	Тип	Описание
результат	result	InsertRowResponseResult

InsertRowResponseResult

Имя	Путь	Тип	Описание
Идентификатор листа	sheetId	integer	Идентификатор измененного листа.
Номер строки	rowNumber	integer	Номер строки вновь вставленной строки.
Создано в	createdAt	date-time	Дата создания листа.
Изменено в	modifiedAt	date-time	Дата изменения листа.

SmartsheetCollection[SheetWithRows]

Распространенный шаблон запроса коллекций из Smartsheet.

Имя	Путь	Тип	Описание
Данные	data	array of SheetWithRows	Коллекция моделей Smartsheet.

SmartsheetCollection[Папка]

Распространенный шаблон запроса коллекций из Smartsheet.

Имя	Путь	Тип	Описание
Данные	data	array of Folder	Коллекция моделей Smartsheet.

Folder

Папка Smartsheet.

Имя	Путь	Тип	Описание
Идентификатор	id	integer	Уникальный идентификатор папки.
Имя	name	string	Имя папки.
URL-адрес	permalink	string	URL-адрес папки.

ОбсуждениеResponse

Объект ответа для create Discussion.

Имя	Путь	Тип	Описание
результат	result	DiscussionData	Данные, относящиеся к созданному обсуждению.

DiscussionData

Данные, относящиеся к созданному обсуждению.

Имя	Путь	Тип	Описание
Идентификатор обсуждения	id	integer	Идентификатор для обсуждения.
Название обсуждения	title	string	Название обсуждения.
Comments	comments	array of DiscussionComment	Комментарии в обсуждении.
создано кем	createdBy	DiscussionUser	Пользователь, создавший обсуждение.

ОбсуждениеUser

Пользователь, создавший обсуждение.

Имя	Путь	Тип	Описание
Создано по имени	name	string	Имя пользователя, создавшего обсуждение.
Создано (электронная почта)	email	string	Сообщение электронной почты пользователя, создавшего обсуждение.

SmartsheetCollection[GetDiscussionResponse]

Распространенный шаблон запроса коллекций из Smartsheet.

Имя	Путь	Тип	Описание
Данные	data	array of GetDiscussionResponse	Коллекция моделей Smartsheet.

GetDiscussionResponse

Объект ответа для Get Discussions.

Имя	Путь	Тип	Описание
Идентификатор обсуждения	id	integer	Уникальный идентификатор обсуждения.
Название обсуждения	title	string	Название обсуждения.
создано кем	createdBy	DiscussionUser	Пользователь, создавший обсуждение.
Уровень доступа	accessLevel	string	Уровень доступа для обсуждения.
Родительский тип	parentType	string	Родительский тип для обсуждения.
Read-Only	readOnly	boolean	Логическое значение (true, false) определяет, является ли обсуждение только для чтения.
Последнее примечание	lastCommentedAt	date-time	Дата и время последнего комментария

RowResponse

Объект ответа для OnRowCreated.

Имя	Путь	Тип	Описание
Rows	rows	array of RowData	Содержимое созданной строки.

RowData

Строка

Имя	Путь	Тип	Описание
Идентификатор строки	id	integer	Уникальный идентификатор строки.
Идентификатор листа	sheetId	integer	Идентификатор листа, в который была добавлена строка.
URL-адрес	permalink	string	URL-адрес листа, в который была добавлена строка.
Создано в	createdAt	date-time	Дата создания строки.
Изменено в	modifiedAt	date-time	Дата изменения строки.
Номер строки	rowNumber	integer	Номер строки.
Клетки	cells	array of RowCell	Сведения о ячейке в строке.
HTML-код строки	rowHTML	string	Представление таблицы HTML новой строки.

RowCell

Ячейка в строке

Имя	Путь	Тип	Описание
Идентификатор столбца	columnId	integer	Идентификатор столбца для этой ячейки.
Значение ячейки	value		Значение ячейки.
Отображаемое значение ячейки	displayValue	string	Отображаемое значение ячейки.

CreateCommentResponse

Объект ответа для создания комментария.

Имя	Путь	Тип	Описание
результат	result	DiscussionComment	Комментарий к обсуждению.

CommentResponse

Объект ответа для Comment.

Имя	Путь	Тип	Описание
Comments	comments	array of DiscussionComment	Комментарии в этом обсуждении.