Соединитель Microsoft SharePoint в Power Automate

В Power Automate соединитель Microsoft SharePoint поддерживает следующие триггеры и действия потока.

Триггеры SharePoint

Триггеры SharePoint позволяют создавать потоки, которые отслеживают изменения в списке или библиотеке SharePoint. Если в списке, подписанном на подписку, происходит одно или несколько изменений, этот поток запускается.

При создании элемента

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

При создании или изменении элемента

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

При изменении элемента или файла

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

Дополнительные сведения об использовании этого триггера см. в этом видео руководства: введение в триггер "При изменении элемента или файла" и действие "Получить изменения"

При удалении элемента

Активирует поток при удалении элемента в списке. Чтобы получить свойства удаленного элемента, необходимо подключить этот триггер к связанному сайту SharePoint, на котором он должен выполняться, с помощью учетной записи пользователя семейства веб-сайтов.

Для выбранного элемента

Позволяет пользователям списков активировать поток после выбора элемента в списке.

Примечание

Только потоки в среде по умолчанию могут выполняться вручную из списка SharePoint.

Когда файл классифицируется по модели осмысления содержимого

Активирует поток, SharePoint Syntex модель осмысления содержимого классифицирует файл, показанный в свойстве даты классификации файла.

Дополнительные сведения о том, когда SharePoint Syntex и как он классифицирует файлы, см. в статье "Общие сведения о microsoft SharePoint Syntex

При создании файла (только свойства)

Активирует поток при создании файла в библиотеке документов и возвращает только пользовательские свойства файла, связанные с этим файлом.

При создании файла в папке

Активирует поток при создании файла в папке SharePoint. Этот триггер не запускается, если вы добавляете или обновляете файл во вложенной папке в папке, в которую работает этот триггер. Если поток требуется для активации вложенных папок, создайте разные потоки для одной или нескольких вложенных папок.

При создании или изменении файла (только свойства)

Активирует поток при создании файла и при каждом изменении свойств файла в библиотеке. Возвращает только пользовательские свойства файла, связанные с этим файлом.

При создании или изменении файла в папке (только свойства)

Активирует поток при создании файла и при каждом изменении свойств файла в выбранной папке SharePoint. Триггер не активируется при добавлении или обновлении файла во вложенной папке. Если поток требуется для активации вложенных папок, создайте разные потоки для одной или нескольких вложенных папок.

При удалении файла

Активирует поток при удалении файла в библиотеке документов. При необходимости можно указать папку для просмотра. При удалении папки триггер активируется только один раз для удаленной папки, включая ее вложенные папки. Чтобы получить свойства удаленного файла, необходимо подключить этот триггер к связанному сайту SharePoint, на котором запущен триггер, используя учетную запись пользователя семейства веб-сайтов.

Для выбранного файла

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

Примечание

Только потоки в среде по умолчанию могут выполняться вручную из библиотеки SharePoint.

Когда сайт запрашивает присоединение к центральному сайту

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

Действия SharePoint

Добавление вложения

Добавляет новое вложение в указанный элемент списка.

Утверждение запроса на присоединение к центральному сайту

Утверждает запрос на присоединение к центральному сайту. Это действие возвращает маркер утверждения для выполнения запроса на присоединение с помощью действия сайта центра присоединения.

Отмена запроса на присоединение к центральному сайту

Отменяет запрос на присоединение к концентратору. Если применимо, укажите тот же идентификатор корреляции утверждения, который используется в состоянии присоединения центрального сайта к ожидающим действию .

Возврат файла

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

Извлечение файла

Извлекает файл в библиотеке документов, чтобы запретить другим пользователям редактировать документ, и ваши изменения не будут видны до тех пор, пока вы не возвратите документ.

Копирование файла

Копирует файл. Работает аналогично команде "Копировать в " в библиотеках SharePoint. После копирования возвращает сведения о новом файле.

Копирование файла (не рекомендуется)

Копирует файл на сайт SharePoint.

Копирование папки

Копирует папку. Работает аналогично команде "Копировать в " в библиотеках SharePoint. После копирования возвращает сведения о новой папке.

Создание файла

Отправляет файл на сайт SharePoint. Обязательно выберите существующую библиотеку.

Создание элемента

Создает новый элемент в списке SharePoint.

Создание папки

Создает новую папку или путь к папке.

Создает ссылку для общего доступа к файлу или папке.

Удаление вложения

Удаляет указанное вложение.

Удаление файла

Удаляет файл, указанный идентификатором файла.

Удаление элемента

Удаляет элемент из списка SharePoint.

Отменить извлечение

Отменяет извлечение, а не сохраняет файл, если вы извлечены файл и не вносите в него изменения или вносите изменения, которые не хотите сохранять. Если ваша организация отслеживает версии, новая версия создается каждый раз при возврате файла в библиотеку. Отменив извлечение, можно избежать создания новых версий, если вы не внесли никаких изменений в файл.

Извлечение папки

Извлекает архивный файл в папку SharePoint (например, .zip).

Получение всех списков и библиотек

Возвращает все списки и библиотеки.

Получение содержимого вложения

Возвращает содержимое файла с использованием идентификатора файла. Содержимое можно скопировать в другое место или использовать в качестве вложения.

Получение вложений

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

Получение изменений для элемента или файла (только свойства)

Возвращает все столбцы или свойства файла, измененные с момента и до указанного интервала времени. Чтобы изменить все столбцы при изменении элемента или файла:

  • Используйте триггер изменения элемента или файла, а также
  • Используйте выходные данные конечного маркера окна запуска маркера запуска из триггера изменения элемента или файла, чтобы определить, какие столбцы изменились с момента последней проверки потока на наличие обновлений элемента или файла. &

Дополнительные сведения о том, как использовать это действие, см. в этом видео руководства: введение в триггер "При изменении элемента или файла" и действие "Получить изменения"

Примечание

  • В списке или библиотеке должно быть настроено управление версиями, чтобы определить, какие столбцы или свойства были изменены с момента последнего изменения.
  • Для списков и библиотек поддерживаются только изменения столбцов.
  • Изменения содержимого файла не поддерживаются.
  • Изменения вложений не поддерживаются.
  • Начальный токен окна триггера & Конечный маркер окна триггера доступен только при использовании триггера изменения элемента или файла.

Получение содержимого файла

Возвращает содержимое файла с помощью идентификатора файла. Вы можете скопировать содержимое в другое место или использовать его в качестве вложения.

Получение содержимого файла с помощью пути

Возвращает содержимое файла, используя путь к файлу.

Получение метаданных файла

Возвращает сведения о файле, такие как размер, тег etag, дата создания и т. д. Использует идентификатор файла для выбора файла. Чтобы получить значения, хранящиеся в столбцах библиотеки, используйте действие "Получить свойства файла ".

Получение метаданных файла с помощью пути

Возвращает сведения о файле, такие как размер, тег etag, дата создания и т. д. Использует путь к файлу для выбора файла. Чтобы получить значения, хранящиеся в столбцах библиотеки, используйте действие "Получить свойства файла ".

Получение свойств файла

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

Получение файлов (только свойства)

Возвращает свойства, сохраненные в столбцах библиотеки для всех папок и файлов, хранящихся в библиотеке. Можно также отфильтровать элементы, соответствующие условию. Для работы с выходными данными этого действия используйте команду "Применить к каждому разделу ". При использовании этого параметра с локальным шлюзом данных может потребоваться вручную ввести имя библиотеки для подключения. Дополнительные сведения об этом действии см. в статье "Подробный анализ получения элементов и получения файлов действий SharePoint для потоков в Power Automate".

Получение метаданных папки

Возвращает сведения о папке. Использует идентификатор файла для выбора папки.

Получение метаданных папки с помощью пути

Возвращает сведения о папке. Использует путь к папке для выбора папки.

Получение элемента

Получает один элемент по его идентификатору из списка SharePoint.

Получение элементов

Возвращает элементы из списка SharePoint. Дополнительные сведения об этом действии см. в статье "Подробный анализ получения элементов и получения файлов действий SharePoint для потоков в Power Automate".

Получение представлений списка

Возвращает представления из списка SharePoint.

Получение списков

Возвращает списки SharePoint с сайта.

Предоставление доступа к элементу или папке

Предоставляет доступ к элементу или папке в SharePoint определенным пользователям.

Присоединение к центральному сайту

Присоединяет запрашиваемый сайт к центральному сайту. Для успешного завершения присоединения требуется маркер утверждения, если для этого концентратора требуется утверждение. Если применимо, укажите тот же идентификатор корреляции утверждения, который используется в состоянии присоединения центрального сайта к ожидающим действию .

Папка списка

Возвращает файлы, содержащиеся в папке SharePoint.

Перечисление корневой папки

Возвращает файлы в корневой папке SharePoint.

Перемещение файла

Перемещает файл. Работает аналогично команде "Переместить в " в библиотеках SharePoint. Возвращает сведения о новом файле после его перемещения.

Перемещение папки

Перемещает папку. Работает аналогично команде "Переместить в " в библиотеках 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 2013, 2016 или 2019. Все действия или триггеры, которые не упоминаются, не поддерживаются.

Поддерживаемые триггеры

Триггер SharePoint 2013 SharePoint 2016 SharePoint 2019
При создании файла в папке Да Да Да
При создании или изменении файла в папке Да Да Да
При создании элемента Да1 Да1 Да1
При создании или изменении элемента Да1 Да1 Да1
При создании файла (только свойства) Нет Нет Да1
При создании или изменении файла (только свойства) Нет Нет Да1
При удалении элемента Нет Нет Да2
При удалении файла Нет Нет Да2
Разрешить пользователя Нет Нет Да
Установка состояния утверждения контента Нет Нет Да

Примечание

  1. Не поддерживает "Ограничение столбцов по представлению".
  2. Хотя этот триггер поддерживается для SharePoint 2019, потоки, созданные с помощью этого триггера, могут столкнуться со следующими ошибками:
    • Если в списке нет действий в течение более 60 дней или если есть какие-либо действия, но элементы не удаляются в течение более 60 дней, триггер не будет активироваться.
    • Удаление элементов списка системным пользователем активирует триггер.

Поддерживаемые действия

Action SharePoint 2013 SharePoint 2016 SharePoint 2019
Получение метаданных файла Да Да Да
Получение метаданных файла с помощью пути Да Да Да
Получение метаданных папки Да Да Да
Получение метаданных папки с помощью пути Да Да Да
Получение содержимого файла Да Да Да
Создание файла Да1 Да1 Да1
Обновление файла Да Да Да
Копирование файла (не рекомендуется)2 Да Да Да
Папка списка Да Да Да
Извлечение папки Да Да Да
Получение вложений Да Да Да
Добавление вложения Да Да Да
Удаление вложения Да Да Да
Получение элементов Да3 Да3 Да3
Получение элемента Да4 Да4 Да4
Создание элемента Да4 Да4 Да4
Обновление элемента Да4 Да4 Да4
Удаление элемента Да Да Да
Отправка HTTP-запроса в SharePoint Да Да Да

Примечание

  1. Не поддерживает создание большого файла путем его отправки в виде набора блоков.
  2. Это действие включает в свое отображаемое имя "(не рекомендуется)". Действие "Копировать файл" отличается от этого действия.
  3. Это действие поддерживает только параметры OData, которые исключают такие параметры, как "Ограничить записи папкой", "Включить вложенные элементы" и "Ограничить столбцы по представлению".
  4. Не поддерживает "Ограничение столбцов по представлению".

Нерекомендуемые триггеры

Эти триггеры являются нерекомендуемыми и больше не поддерживаются активно. Хотя они по-прежнему присутствуют в Соединителе Microsoft SharePoint, мы не рекомендуем использовать устаревшие триггеры или действия в новых приложениях или решениях.

Триггер Поддерживаемая версия Рекомендуемая альтернатива
При создании файла в папке SharePoint 2019 При создании файла (только свойства)
При создании или изменении файла в папке SharePoint 2019 При создании или изменении файла (только свойства)

Известные ограничения

Поддерживаемые шаблоны списков и библиотек

Потоки Power Automate для списков поддерживаются только в универсальных списках (100) и универсальных библиотеках документов (101). В настоящее время мы не поддерживаем настраиваемые шаблоны списков и библиотек, включая, помимо прочего, такие списки, как объявления, контакты и задачи.

Запуски потоков

При создании потока Power Automate, который будет активироваться для элемента или для создания или изменения файла, Power Automate периодически проверяет наличие изменений в списке или библиотеке, настроенных в триггере потока. В большинстве случаев при наличии одного изменения в списке или библиотеке выполнение потока может произойти в течение нескольких минут после этого изменения. Однако ожидается, что поток может собрать несколько изменений в последующих запусках потока из-за времени между интервалом потока с момента последнего допустимого изменения или последующих изменений в элементе или файле.

Перемещение файлов и потоков

При перемещении одного или нескольких файлов из одной библиотеки документов в другую исходный файл перемещается из исходной библиотеки в конечную библиотеку. Перемещение файла не приводит к изменению пользовательских метаданных, в том числе при создании и изменении файла. Таким образом, это действие не активирует потоки для обновлений файлов, связанных с библиотекой, в которую оно было перемещено.

Синхронизация файлов с библиотеками документов OneDrive для бизнеса и SharePoint

Когда пользователь синхронизирует один или несколько файлов из одной библиотеки документов в другую, исходный файл перемещается (синхронизируется) из клиента в конечную библиотеку. Синхронизация файла не приведет к изменению пользовательских метаданных, в том числе при создании и изменении файла. Таким образом, это действие не активирует потоки для синхронизации файлов в этой библиотеке или в OneDrive для бизнеса.

Поддерживаемые столбцы подстановки

Если в списке или библиотеке есть столбцы подстановки , действия "Получить элементы" и "Получить файлы" поддерживают возврат элементов с максимум 12 столбцами подстановки. Если список или библиотека превышает это пороговое значение, поток в Power Automate завершается сбоем.