Бөлісу құралы:

Соединитель CSV

  • Мақала

Соединитель CSV Graph позволяет вашей организации принимать содержимое из CSV-файлов, хранящихся в библиотеках SharePoint и Azure Data Lake Storage (ADLS). После настройки соединителя и индексирования содержимого из этих источников конечные пользователи смогут находить CSV-файлы в поиске (Майкрософт).

Примечание.

Ознакомьтесь со статьей Настройка соединителя Graph , чтобы понять общие инструкции по настройке соединителей Graph.

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

Перед началом работы

Убедитесь, что в заголовках CSV нет пробелов. Для источника данных SharePoint необходимо создать приложение SharePoint с конфигурацией Oauth. Для источника данных ADLS необходимо создать учетную запись хранения ADLS.

Создание приложения SharePoint с конфигурацией Oauth

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

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

  1. Перейдите по адресу https://Org-Name.sharepoint.com/sites/mysite/_layouts/15/appregnew.aspx.
  2. В полях Идентификатор клиента и Секрет клиента выберите Создать.
  3. В поле Заголовок введите имя приложения.
  4. В поле Домен приложения введите www.gcs.com.
  5. В поле URL-адрес перенаправления введите https://www.gcs.com.
  6. Нажмите Создать.
  7. Скопируйте сведения о конфигурации приложения, включая идентификатор клиента и секрет клиента. Он понадобится при настройке соединителя CSV.

Включение разрешений приложения для разрешения CustomAppAuthentication

В PowerShell (командная консоль SharePoint Online) выполните эти команды в режиме администрирования. Используйте адрес электронной почты администратора, настроив соединитель, и название вашей организации. Когда появится всплывающее окно пароля, администратор должен ввести свой пароль.

Install-Module -Name Microsoft.Online.SharePoint.PowerShell
$adminUPN=”<admin@contoso.onmicrosoft.com>”
$orgName=“<contoso>”
$userCredential = Get-Credential -UserName $adminUPN -Message "Enter your password."
Connect-SPOService -Url https://$orgName-admin.sharepoint.com -Credential $userCredential
Set-spotenant –DisableCustomAppAuthentication $false

Примечание.

Если вы используете PowerShell 7, сначала используйте эту команду. Import-Module microsoft.online.sharepoint.powershell -UseWindowsPowerShell

Примечание.

Если вы используете многофакторную проверку подлинности, используйте .Connect-SPOService -Url https://$orgName-admin.sharepoint.com

Завершение настройки приложения

  1. Перейдите по адресу https://Org-Name.sharepoint.com/sites/mysite/_layouts/15/appinv.aspx.
  2. В поле Идентификатор приложения вставьте идентификатор клиента приложения SharePoint и выберите Поиск.
  3. В поле XML-запроса на разрешение вставьте этот код и нажмите кнопку Создать.
<AppPermissionRequests AllowAppOnlyPolicy="true">
    <AppPermissionRequest Scope="http://sharepoint/content/sitecollection/web" Right="Read" />
</AppPermissionRequests>
  1. Нажмите кнопку Доверять.

Создание учетной записи хранения ADLS

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

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

Шаг 1. Добавление соединителя Graph в Центр администрирования Microsoft 365

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

Следуйте общим инструкциям по настройке.

Шаг 2. Выбор возможностей

В настоящее время соединитель CSV поддерживает только возможности поиска.

Соединитель CSV с выбранным интерфейсом поиска (Майкрософт).

Шаг 3. Присвойте соединению имя

Следуйте общим инструкциям по настройке.

Шаг 4. Настройка параметров подключения

Параметры источника данных для SharePoint и ADLS отличаются.

Примечание.

Убедитесь, что csv-файл не имеет форматирования или пробелов (' ') в строках заголовков.

Для источника SharePoint

  1. В параметрах источника данных выберите SharePoint в качестве источника данных.
  2. На сайте SharePoint введите, например, https://Org-Name.sharepoint.com/Site-NameURL-адрес сайта.
  3. В поле Библиотека документов введите имя библиотеки, в которой хранятся файлы .csv.
  4. В поле Тип проверки подлинности выберите Oauth2.0 (учетные данные клиента).
  5. Введите идентификатор клиента и секрет клиента, скопированные при создании приложения SharePoint.
  6. Выберите Проверить подключение. Должно появиться сообщение Об успешном подключении .

Соединитель CSV с параметрами источника данных для сайта SharePoint.

Чтобы управлять доступом на уровне файла, введите Microsoft Entra пользователей или групп.

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

Для источника ADLS

  1. В параметрах источника данных выберите Azure Data Lake Storage(ADLS) в качестве источника данных.
  2. В строка подключения основного хранилища введите скопированный строка подключения.
  3. Введите имя контейнера и имя файла.
  4. Выберите Проверить подключение. Должно появиться сообщение Об успешном подключении .

Соединитель CSV с параметрами источника данных для Azure Data Lake Storage источника.

Примечание.

Если источник данных содержит несколько .csv файлов с одинаковыми заголовками, выберите включить все CSV-файлы в расположении.

Чтобы управлять доступом на уровне файла, введите Microsoft Entra пользователей или групп.

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

Шаг 5. Разделитель нескольких элементов (необязательно)

Если исходные столбцы могут принимать несколько значений, введите разделитель с несколькими элементами, точку с запятой (например, ;).

Шаг 6. Анализ параметров свойств

Эта страница возвращает первую строку из файла .csv в качестве свойства источника. Чтобы изменить тип данных, в списке Уникальный идентификатор выберите хотя бы один параметр.

Чтобы управлять доступом на уровне элемента, выберите столбцы, сопоставленные с разрешенными пользователями и разрешенными группами. В файл .csv следует включить два столбца: AllowedUsers и AllowedGroups. Каждая строка должна содержать идентификаторы Microsoft Entra.

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

Примечание.

Соединитель CSV поддерживает управление доступом на уровне файлов или элементов. Если оба параметра включены, применяется только управление доступом на уровне файлов.

Шаг 7. Назначение меток свойств

Следуйте общим инструкциям по настройке.

Примечание.

Метка IconURL заполняется по умолчанию, и сопоставление изменить нельзя.

Шаг 8. Управление схемой

Следуйте общим инструкциям по настройке.

Шаг 9. Управление разрешениями поиска

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

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

Шаг 10. Выбор параметров обновления

Следуйте общим инструкциям по настройке.

Шаг 11. Проверка подключения

Следуйте общим инструкциям по настройке.

Ограничения

Ниже приведены известные ограничения соединителя CSV.

  • В настоящее время сценарии обогащения профилей не поддерживаются.