Подключение к SharePoint из приложения на основе холста

SharePoint.

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

В зависимости от того, где находятся ваши данные, вы можете использовать один или оба следующих подхода:

  • Показать данные из списка на сайте SharePoint Online или локальном сайте.
  • Показывать изображения и воспроизводить видео- или аудиофайлы в библиотеке (только SharePoint Online).

Создание приложения

Если вы хотите управлять данными в списке, Power Apps может автоматически сгенерировать для вас приложение с тремя экранами. Пользователи могут просматривать список на первом экране, отображать сведения об элементе на втором экране и создавать или обновлять элементы на третьем экране.

Примечание

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

Создание подключения

  1. Войдите в Power Apps, выберите Данные > Подключения в левой панели навигации, затем выберите Новое подключение около верхнего левого угла.

    Выберите "Данные > Подключения" в левой панели навигации, затем выберите "Новое подключение" около верхнего левого угла.

  2. Выберите параметр SharePoint.

    Выберите SharePoint.

  3. Выполните один из следующих наборов действий.

    • Для подключения к SharePoint Online выберите Прямое подключение (облачные службы), выберите Создать, затем предоставьте учетные данные (если будет предложено).

      Для подключения к SharePoint Online выберите "Прямое подключение (облачные службы)".

      Соединение создано, и вы можете добавить данные в существующее приложение или создать приложение с нуля.

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

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

      Выберите Windows в качестве типа проверки подлинности, затем введите учетные данные. (Если учетные данные содержат имя домена, укажите его в формате домен\псевдоним.)

      Ввод учетных данных.

      В пункте Выберите шлюз выберите шлюз, который вы хотите использовать, затем выберите Создать.

      Примечание

      Если у вас нет локального шлюза данных, установите его, затем выберите значок, чтобы обновить список шлюзов.

      Выбор шлюза.

      Соединение создано, и вы можете добавить данные в существующее приложение или создать приложение с нуля.

Добавление данных в существующее приложение

  1. В Power Apps Studio откройте приложение, которое вы хотите обновить, выберите Данные в левой области.

    Выберите «Данные» в левой области.

  2. Выберите Добавить данные > Соединители > SharePoint.

  3. В разделе Подключиться к сайту SharePoint выберите запись в списке Последние сайты (или введите либо вставьте URL-адрес сайта, который вы хотите использовать), затем выберите Подключить.

    Выберите сайт.

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

    В разделе «Выберите список» установите флажок для одного или нескольких списков, которые вы хотите использовать, и выберите «Подключиться».

    По умолчанию отображаются не все типы списков. Power Apps поддерживает списки не на основе шаблона. Если имя списка, который вы хотите использовать, отсутствует, прокрутите окно вниз, а затем введите имя списка в поле, содержащее текст Введите название пользовательской таблицы.

    Введите имя списка в поле, содержащее Введите имя списка. Источник или источники данных добавлены в приложение.

Создание собственного приложения с нуля

Примените концепции из раздела Создание приложения с нуля к SharePoint, а не к Excel.

Если ваш список содержит какие-либо из этих типов столбцов, отобразите данные в элементе управления Галерея, используя строку формул, чтобы задать свойство Text одного или нескольких элементов управления Подпись этой коллекции:

  • Чтобы отобразить данные в столбце Выбор и Подстановка, укажите значение ThisItem.ИмяСтолбца.Value.

    Например, если вы используете столбец Выбор с именем Location, укажите значение ThisItem.Location.Value. Если же вы используете столбец Подстановка с именем PostalCode, укажите значение ThisItem.PostalCode.Value.

  • Чтобы отобразить имя пользователя или группы, укажите значение ThisItem.ИмяСтолбца.DisplayName для столбца Пользователь или группа.

    Например, укажите значение ThisItem.Manager.DisplayName, чтобы отобразить имя из столбца Пользователь или группа с именем Manager.

    Вы также можете отобразить другие сведения о пользователях, например адрес электронной почты или должность. Чтобы отобразить полный список вариантов, укажите ThisItem.ИмяСтолбца. (включая точку в конце).

    Примечание

    Для столбца CreatedBy укажите значение ThisItem.Author.DisplayName, чтобы отобразить имена пользователей, создавших элементы в списке. Для столбца ModifiedBy укажите значение ThisItem.Editor.DisplayName, чтобы отобразить имена пользователей, изменивших элементы в списке.

  • Чтобы отобразить данные в столбце Управляемые метаданные, укажите значение ThisItem.ИмяСтолбца.Label.

    Например, при наличии столбца Управляемые метаданные с именем Languages укажите значение ThisItem.Languages.Label.

Отображение данных из библиотеки

Если у вас есть несколько изображений в библиотеке SharePoint, вы можете добавить элемент управления Раскрывающийся список в ваше приложение, чтобы пользователи могли указать, какое изображение показывать. Вы также можете применять те же принципы к другим элементам управления, таким как элементы управления Галерея, и другим типам данных, таким как видео.

  1. Если вы еще этого не сделали, создайте подключение, затем добавьте данные в существующее приложение.

  2. Добавьте элемент управления Раскрывающийся список и назовите его ImageList.

  3. Установите для свойства Items элемента управления ImageList значение Документы.

  4. На вкладке Свойства на правой панели откройте список Значение, затем выберите Имя.

    Имена файлов изображений в вашей библиотеке отображаются в ImageList.

    Список изображений.

  5. Добавьте элемент управления Изображение и задайте для его свойства Изображение следующее выражение:

    ImageList.Selected.'Link to item'

  6. Нажмите F5, затем выберите другое значение в ImageList.

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

    Список изображений.

Вы можете скачать пример приложения, который демонстрирует более сложный подход к отображению данных из библиотеки SharePoint.

  1. После загрузки приложения откройте Power Apps Studio, выберите Открыть в левой панели навигации, затем выберите Обзор.
  2. В диалоговом окне Открыть найдите и откройте загруженный файл, затем добавьте библиотеку SharePoint как источник данных, выполнив первые две процедуры в этой теме.

Примечание

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

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

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

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

Образец изображения.

Известные проблемы

При совместном использовании приложений на основе холста с помощью соединителя SharePoint Power Apps не будет отображать приложения на основе холста, подключающиеся к SharePoint, общий доступ к которым предоставлен только с параметром Все, если только вы не являетесь создателем приложения ИЛИ вам явно не был предоставлен общий доступ к приложению (как пользователю или совладельцу) через членство в группе или непосредственно через назначение пользователя. Чтобы выполнять такие приложения, используйте прямую ссылку на приложение.

Списки

Power Apps может считывать имена столбцов, содержащие пробелы, но при этом пробелы заменяются шестнадцатеричным escape-кодом "_x0020_". Например, столбец "Имя столбца" из SharePoint будет отображаться как "Имя_x0020_столбца" в Power Apps при отображении в структуре данных или использовании в формуле.

Поддерживаются не все типы столбцов, и не все типы столбцов поддерживают все типы карточек.

Тип столбца Поддержка Карточки по умолчанию
Однострочный текст Да Просмотреть текст
Несколько строк текста Да Просмотреть текст
Набор выбора Да Просмотреть подстановку
Изменить подстановку
Просмотреть множественный выбор (только SharePoint Online)
Изменить множественный выбор (только SharePoint Online)
Номер Да Просмотреть процентное значение
Просмотреть оценку
Просмотреть текст
Валюта Да Просмотреть процентное значение
Просмотреть оценку
Просмотреть текст
Дата и время Да Просмотреть текст
Подстановка Да Просмотреть подстановку
Изменить подстановку
Просмотр полей с множественным выбором
Редактирование полей с множественным выбором
Логическое значение (да или нет) Да Просмотреть текст
Просмотреть переключатель
"Пользователь" или "Группа"; Да Просмотреть подстановку
Изменить подстановку
Просмотр полей с множественным выбором
Редактирование полей с множественным выбором
Гиперссылка Да Представление URL
Просмотреть текст
Рисунок Да (только для чтения) Просмотреть изображение
Просмотреть текст
Вложение Да (только для чтения) Просмотр вложений
Вычисляемое Да (только для чтения)
Образ Нет
Результат задачи Нет
Внешние данные Нет
Управляемые метаданные Да (только для чтения)
Рейтинг Нет

Библиотеки

  • Вы не можете загружать файлы из Power Apps в библиотеку.
  • Вы не можете отображать PDF-файлы из библиотеки в элементе управления "средство просмотра PDF".
  • Power Apps Mobile не поддерживает функцию Скачать.
  • Если ваши пользователи будут запускать приложение в Power Apps Mobile или в приложении для Windows 10, используйте функцию Launch для отображения содержимого библиотеки в галерее.

Изображения библиотеки документов SharePoint отображаются с перебоями

Списки со ссылками на изображения, хранящиеся в библиотеках документов SharePoint, могут не отображаться внутри Power Apps с ошибками аутентификации.

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

В качестве решения для таких сценариев храните изображения в источнике с поддержкой CORS, таком как Хранилище Azure, или в службе CDN, например Azure CDN, что позволяет анонимный доступ.

Дальнейшие шаги

См. также

Примечание

Каковы ваши предпочтения в отношении языка документации? Пройдите краткий опрос (обратите внимание, что этот опрос представлен на английском языке).

Опрос займет около семи минут. Личные данные не собираются (заявление о конфиденциальности).