Соединитель Microsoft SharePoint в Power Automate
В Power Automate соединитель Microsoft SharePoint поддерживает следующие триггеры и действия потока.
Триггеры SharePoint
Триггеры SharePoint позволяют создавать потоки, отслеживающие изменения в списке или библиотеке SharePoint. Если в списке с подпиской происходит одно или несколько изменений, запускается этот поток.
При создании элемента
Активирует поток при создании элемента в списке SharePoint.
Создание или изменение элемента
Активирует поток при создании элемента и при каждом его изменении в списке SharePoint.
При изменении элемента или файла
Активирует поток при изменении элемента или файла в списке SharePoint или библиотеке документов.
Дополнительные сведения об использовании этого триггера см. в этом учебном видео: Знакомство с триггером "когда изменен элемент или файл" и действием "Получить изменения".
При удалении элемента
Активирует поток при удалении элемента в списке. Чтобы получить свойства удаленного элемента, необходимо подключить этот триггер к связанному сайту SharePoint, на котором он должен выполняться, с помощью учетной записи пользователя семейства веб-сайтов.
Для выбранного элемента
Позволяет пользователям списков активировать поток после выбора элемента в списке.
Примечание.
Из списка SharePoint можно вручную выполнять только потоки в среде по умолчанию.
Когда файл классифицируется по модели распознавания содержимого
Активирует поток, когда модель распознавания содержимого Microsoft Syntex классифицирует файл, показанный в свойстве даты классификации файла.
Дополнительные сведения о том, когда Microsoft Syntex и как он классифицирует файлы, см. в статье Введение в Microsoft Microsoft Syntex
При создании файла (только для свойств)
Активирует поток при создании файла в библиотеке документов и возвращает только пользовательские свойства файла, связанные с этим файлом.
При создании файла в папке [не рекомендуется]
Примечание.
Этот триггер не рекомендуется использовать и может работать неправильно.
Активирует поток при создании файла в папке SharePoint. Этот триггер не запускается при добавлении или обновлении файла во вложенной папке внутри папки, с помощью этого триггера. Если поток должен активироваться во вложенных папках, создайте разные потоки для одной или нескольких вложенных папок.
При создании или изменении файла (только для свойств)
Активирует поток при создании файла и при каждом изменении свойств файла в библиотеке. Укажите значение в свойстве Folder для конкретной папки; В противном случае триггер применяется ко всей библиотеке. Возвращает только настраиваемые свойства файла, связанные с этим файлом.
При создании или изменении файла в папке [не рекомендуется]
Примечание.
Этот триггер не рекомендуется использовать и может работать неправильно.
Активируется при создании файла, а также при каждом его изменении в папке SharePoint. Триггер не срабатывает, если файл добавляется или обновляется во вложенной папке. Если требуется активировать во вложенных папках, необходимо создать несколько триггеров.
При удалении файла
Активирует поток при удалении файла в библиотеке документов. При необходимости можно указать папку для watch. При удалении папки триггер активирует только один раз для удаленной папки, включая ее вложенные папки. Чтобы получить свойства удаленного файла, необходимо подключить этот триггер к связанному сайту SharePoint, на котором ожидается запуск триггера, с помощью учетной записи пользователя семейства веб-сайтов.
Для выбранного файла
Позволяет пользователям библиотек документов активировать поток после выбора файла.
Примечание.
Из библиотеки SharePoint вручную можно выполнять только потоки в среде по умолчанию.
Когда сайт запросил присоединение к центральному сайту
Активирует поток при запросе на утверждение присоединения к центральному сайту.
Действия SharePoint
Добавление вложения
Добавляет новое вложение в указанный элемент списка.
Утвердить запрос на присоединение к сайту концентратора
Утверждает запрос на присоединение к сайту концентратора. Это действие возвращает маркер утверждения для выполнения запроса на присоединение с помощью действия сайта концентратора соединения.
Отмена запроса на присоединение к сайту концентратора
Отменяет запрос на присоединение к концентратору. Если применимо, укажите тот же идентификатор корреляции утверждения, который использовался в действии Задать состояние присоединения к сайту концентратора в ожидании .
Файл возврата
Выполняет проверку извлеченного файла в библиотеке документов, что делает версию документа доступной другим пользователям.
Извлечь файл
Извлекает файл в библиотеке документов, чтобы другие пользователи не могли редактировать документ, а изменения не будут видны, пока вы не проверка в документе.
Копирование файла
Копирует файл. Работает аналогично команде Copy to в библиотеках SharePoint. После копирования возвращает сведения о новом файле.
Копирование файла [не рекомендуется]
Примечание.
Это действие не рекомендуется и может работать неправильно.
Копирует файл на сайт SharePoint.
Копирование папки
Копирует папку. Работает аналогично команде Copy to в библиотеках SharePoint. После копирования возвращает сведения о новой папке.
Создание файла
Отправляет файл на сайт SharePoint. Обязательно выберите существующую библиотеку.
Создание элемента
Создает новый элемент в списке SharePoint.
Создание папки
Создает новую папку или путь к папке.
Создание ссылки для общего доступа для файла или папки
Создает ссылку для общего доступа для файла или папки.
Удаление вложения
Удаляет указанное вложение.
Удаление файла
Удаляет файл, указанный идентификатором файла.
Удаление элемента
Удаляет элемент из списка SharePoint.
Отмена оформления заказа
Отменяет извлечение, а не сохраняет файл, если вы проверка файл и не вносите в него изменений или вносите изменения, которые не хотите сохранять. Если ваша организация отслеживает версии, при каждом проверка в файле в библиотеку создается новая версия. Отменив извлечение, вы можете избежать создания новых версий, если вы не внесли никаких изменений в файл.
Извлечь папку
Извлекает архивный файл в папку SharePoint (например, .zip).
Получение всех списков и библиотек
Возвращает все списки и библиотеки.
Получение содержимого вложения
Возвращает содержимое файла с использованием идентификатора файла. Содержимое можно скопировать в другое место или использовать в качестве вложения.
Получение вложений
Возвращает список вложений для указанного элемента списка. Чтобы получить сведения о содержимом файла, добавьте шаг Получить содержимое вложения и используйте свойство Идентификатор файла , возвращаемое этим действием.
Получение изменений для элемента или файла (только для свойств)
Возвращает все столбцы или свойства файла, измененные с момента и до указанного интервала времени. Чтобы изменить все столбцы при изменении элемента или файла, выполните следующие действия:
- Используйте при изменении элемента или файла триггер, а также
- Используйте маркер запуска окна триггера & выходные данные маркера конца окна триггерапри изменении элемента или файла триггера, чтобы определить, какие столбцы изменились с момента последней проверки потока обновления элемента или файла.
Дополнительные сведения об использовании этого действия см. в этом учебном видео: Знакомство с триггером "при изменении элемента или файла" и действием "Получить изменения"
Примечание.
- В списке или библиотеке должно быть настроено управление версиями, чтобы определить, какие столбцы или свойства были изменены с момента последнего изменения.
- Для списков и библиотек поддерживаются только изменения столбцов.
- Изменения содержимого файла не поддерживаются.
- Изменения вложений не поддерживаются.
- Маркер запуска окна триггера & маркер конца окна триггера доступен только при изменении триггера элемента или файла .
Получение содержимого файла
Возвращает содержимое файла с помощью идентификатора файла. Содержимое можно скопировать в другое место или использовать в качестве вложения.
Получение содержимого файла с помощью пути
Возвращает содержимое файла, используя путь к файлу.
Получение метаданных файла
Возвращает сведения о файле, такие как размер, etag, дата создания и т. д. Использует идентификатор файла для выбора файла. Чтобы получить значения, хранящиеся в столбцах библиотеки, используйте действие Получить свойства файла .
Получение метаданных файла с помощью пути
Возвращает сведения о файле, такие как размер, etag, дата создания и т. д. Использует путь к файлу для выбора файла. Чтобы получить значения, хранящиеся в столбцах библиотеки, используйте действие Получить свойства файла .
Получение свойств файла
Возвращает свойства, сохраненные в столбцах в библиотеке для элемента, указанного идентификатором элемента. Чтобы получить сведения о содержимом файла, добавьте шаг "Получить содержимое файла" и используйте свойство "Идентификатор файла", возвращаемое этим действием. При использовании с локальным шлюзом данных может потребоваться вручную ввести имя библиотеки для подключения.
Получение файлов (только для свойств)
Возвращает свойства, сохраненные в столбцах библиотеки для всех папок и файлов, хранящихся в библиотеке. Вы также можете отфильтровать элементы, соответствующие условию. Чтобы работать с выходными данными этого действия, используйте раздел Применить к каждому . При использовании с локальным шлюзом данных может потребоваться вручную ввести имя библиотеки для подключения. Дополнительные сведения об этом действии см. в статье Подробный анализ действий Получения элементов и Получения файлов SharePoint для потоков в Power Automate.
Получение метаданных папки
Возвращает сведения о папке. Использует идентификатор файла для выбора папки.
Получение метаданных папки с помощью пути
Возвращает сведения о папке. Использует путь к папке для выбора папки.
Получение элемента
Получает один элемент по его идентификатору из списка SharePoint.
Получение элементов
Возвращает элементы из списка SharePoint. Дополнительные сведения об этом действии см. в статье Подробный анализ действий Получения элементов и Получения файлов SharePoint для потоков в Power Automate.
Получение представлений списка
Возвращает представления из списка SharePoint.
Получение списков
Получает списки SharePoint с сайта.
Предоставление доступа к элементу или папке
Предоставляет доступ к элементу или папке в SharePoint определенным пользователям.
Присоединение к сайту концентратора
Присоединяет запрошенный сайт к центральному сайту. Маркер утверждения требуется для успешного завершения присоединения, если для этого концентратора требуется утверждение. Если применимо, укажите тот же идентификатор корреляции утверждения, который использовался в действии Задать состояние присоединения к сайту концентратора в ожидании .
Папка List
Возвращает файлы, содержащиеся в папке SharePoint.
Перечисление корневой папки
Возвращает файлы в корневой папке SharePoint.
Переместить файл
Перемещает файл. Работает аналогично команде Move to в библиотеках SharePoint. Возвращает сведения о новом файле после его перемещения.
Переместить папку
Перемещает папку. Работает аналогично команде Move to в библиотеках SharePoint. Возвращает сведения о новой папке после ее перемещения.
Разрешение пользователя
Возвращает одно соответствующее значение пользователя, чтобы его можно было назначить столбцу типа person. Если совпадений нет или несколько совпадений, это действие выключает ошибку.
Отправка HTTP-запроса в SharePoint
Создает REST API SharePoint для вызова. Дополнительные сведения об этом действии см. в статье Работа с действием потока ОТПРАВКИ HTTP-запросов SharePoint в Power Automate.
Важно!
Это действие может выполнять любой REST API SharePoint, к которым у вас есть доступ. Продолжайте с осторожностью.
Установка состояния утверждения контента
Задает состояние утверждения содержимого для элемента в списке или библиотеке, для которого включено утверждение содержимого. Необходимо указать ETag для страниц и файлов. ETag можно получить с помощью действия Получить метаданные файла. Это действие доступно только для SharePoint Online и SharePoint 2019.
Установка состояния присоединения к сайту концентратора в ожидании
Задает состояние запроса на присоединение к центру запрашиваемого сайта в ожидание. Идентификатор корреляции утверждения является необязательным параметром, который помогает SharePoint определить конкретный запрос на присоединение к концентратору. Запрашивающий сайт может иметь только один ожидающий запрос в данный момент времени.
Прекращение общего доступа к элементу или файлу
Удаляет все ссылки, предоставляющие доступ к элементу или файлу, и удаляет всех пользователей с прямым доступом, кроме владельцев.
Обновление файла
Обновления содержимое файла, указанного идентификатором файла.
Обновление свойств файла
Обновления свойства, хранящиеся в столбцах в библиотеке, для элемента, указанного идентификатором элемента. Чтобы обновить содержимое файла, используйте действие Обновить файл . При использовании с локальным шлюзом данных может потребоваться вручную ввести имя библиотеки для подключения.
Обновление элемента
Обновления элемент в списке SharePoint.
Поддержка SharePoint Server
В следующих таблицах перечислены все действия и триггеры, которые поддерживаются для SharePoint On-Premises 2013, 2016 или 2019. Все действия или триггеры, которые не указаны, не поддерживаются.
Поддерживаемые триггеры
| Триггер | SharePoint 2013 | SharePoint 2016 | SharePoint 2019 |
|---|---|---|---|
| При создании файла в папке | Да | Да | Да |
| Создание или изменение файла в папке | Да | Да | Да |
| При создании элемента | Да1 | Да1 | Да1 |
| Создание или изменение элемента | Да1 | Да1 | Да1 |
| При создании файла (только для свойств) | Нет | Нет | Да1 |
| При создании или изменении файла (только для свойств) | Нет | Нет | Да1 |
| При удалении элемента | Нет | Нет | Да2 |
| При удалении файла | Нет | Нет | Да2 |
| Разрешение пользователя | Нет | Нет | Да |
| Установка состояния утверждения контента | Нет | Нет | Да |
Примечание.
- Не поддерживает параметр "Ограничение столбцов по представлению".
- Хотя этот триггер поддерживается для SharePoint 2019, потоки, созданные с помощью этого триггера, могут столкнуться со следующими проблемами:
- Если в списке нет действий в течение более 60 дней или есть некоторые действия, но никакие элементы не удаляются в течение 60 дней, триггер не будет активирован.
- При удалении элементов списка системным пользователем активируется триггер.
Поддерживаемые действия
| Действие | SharePoint 2013 | SharePoint 2016 | SharePoint 2019 |
|---|---|---|---|
| Получение метаданных файла | Да | Да | Да |
| Получение метаданных файла с помощью пути | Да | Да | Да |
| Получение метаданных папки | Да | Да | Да |
| Получение метаданных папки с помощью пути | Да | Да | Да |
| Получение содержимого файла | Да | Да | Да |
| Создание файла | Да1 | Да1 | Да1 |
| Обновление файла | Да | Да | Да |
| Копирование файла [не рекомендуется]2 | Да | Да | Да |
| Папка List | Да | Да | Да |
| Извлечь папку | Да | Да | Да |
| Получение вложений | Да | Да | Да |
| Добавление вложения | Да | Да | Да |
| Удаление вложения | Да | Да | Да |
| Получение элементов | Да3 | Да3 | Да3 |
| Получение элемента | Да4 | Да4 | Да4 |
| Создание элемента | Да4 | Да4 | Да4 |
| Обновление элемента | Да4 | Да4 | Да4 |
| Удаление элемента | Да | Да | Да |
| Отправка HTTP-запроса в SharePoint | Да | Да | Да |
Примечание.
- Не поддерживает создание большого файла путем его отправки в виде набора блоков.
- Это действие включает "[не рекомендуется]" в отображаемом имени. Действие "Копировать файл" отличается от этого действия.
- Это действие поддерживает только параметры OData, которые исключают такие параметры, как "Ограничить записи в папку", "Включить вложенные элементы" и "Ограничить столбцы по представлению".
- Не поддерживает параметр "Ограничение столбцов по представлению".
Нерекомендуемые триггеры и действия
Эти триггеры устарели и больше не поддерживаются активно. Хотя они по-прежнему присутствуют в соединителе Microsoft SharePoint, мы не рекомендуем использовать устаревшие триггеры или действия в новых приложениях или решениях.
| Имя | Тип | Поддерживаемая версия | Предлагаемый альтернативный вариант |
|---|---|---|---|
| При создании файла в папке [не рекомендуется] | Триггер | SharePoint 2019 | При создании файла (только для свойств) |
| При создании или изменении файла в папке [не рекомендуется] | Триггер | SharePoint 2019 | При создании или изменении файла (только для свойств) |
| Копирование файла [не рекомендуется] | Действие | SharePoint 2019 | Копирование файла |
Известные ограничения
Поддерживаемые шаблоны списков и библиотек
Потоки Power Automate для списков поддерживаются только в универсальных списках (100) и универсальных библиотеках документов (101). В настоящее время мы не поддерживаем настраиваемые шаблоны списков и библиотек, включая, помимо прочего, такие списки, как объявления, контакты и задачи.
Запуски потока
При создании потока Power Automate, активируемого для элемента или для создания или изменения файла, Power Automate периодически проверяет наличие изменений в списке или библиотеке, настроенных в триггере потока. В большинстве случаев при наличии одного изменения в списке или библиотеке выполнение потока может произойти в течение нескольких минут после этого изменения. Однако ожидается, что поток может собирать несколько изменений в последующих запусках потока из-за времени между интервалом потока с момента последнего допустимого изменения или последующих изменений элемента или файла.
Перемещение файлов и запуски потока
При перемещении одного или нескольких файлов из одной библиотеки документов в другую исходный файл перемещается из исходной библиотеки в целевую библиотеку. Перемещение файла не изменяет пользовательские метаданные, в том числе время создания и изменения файла. Следовательно, это действие не активирует потоки для обновлений файлов, связанных с библиотекой, в которой оно было перемещено.
Синхронизация файлов с библиотеками документов OneDrive для бизнеса и SharePoint
Когда пользователи синхронизируют один или несколько файлов из одной библиотеки документов с другой, исходный файл перемещается (синхронизируется) из клиента в целевую библиотеку. Синхронизация файла не приведет к изменению пользовательских метаданных, включая время создания и изменения файла. Таким образом, это действие не активирует потоки для синхронизации файлов в этой библиотеке или в OneDrive для бизнеса.
Поддерживаемые столбцы подстановки
Если в списке или библиотеке есть столбцы подстановки, действия Get items и Get files поддерживают возврат элементов с максимум 12 столбцами подстановки. Если список или библиотека превышает это пороговое значение, поток в Power Automate завершается сбоем.