Справочник по коннектору Elastic для SharePoint Server

Этот коннектор доступен как управляемая служба с Elastic 8.15.0. Для использования этого коннектора необходимо выполнить все требования к управляемым коннекторам.

Чтобы создать новый коннектор SharePoint Server:

Дополнительные операции см. в Пользовательском интерфейсе коннекторов в Kibana.

Вы можете использовать Elasticsearch API создания коннекторов, чтобы создать новый нативный коннектор SharePoint Server.

Например:

resp = client.connector.put(
    connector_id="my-{service-name-stub}-connector",
    index_name="my-elasticsearch-index",
    name="Content synced from {service-name}",
    service_type="{service-name-stub}",
    is_native=True,
)
print(resp)

const response = await client.connector.put({
  connector_id: "my-{service-name-stub}-connector",
  index_name: "my-elasticsearch-index",
  name: "Content synced from {service-name}",
  service_type: "{service-name-stub}",
  is_native: true,
});
console.log(response);

PUT _connector/my-sharepoint_server-connector
{
  "index_name": "my-elasticsearch-index",
  "name": "Content synced from SharePoint Server",
  "service_type": "sharepoint_server",
  "is_native": true
}

Подробную информацию обо всех доступных API коннекторов см. в документации API Elasticsearch.

См. Управляемые коннекторы Elastic.

Дополнительные операции см. в Пользовательском интерфейсе коннекторов в Kibana.

Совместимые версии SharePoint Server:

Для настройки коннектора необходимы следующие поля конфигурации:

Коннектор синхронизирует следующие типы объектов SharePoint:

Полные синхронизации по умолчанию поддерживаются для всех коннекторов.

Этот коннектор также поддерживает инкрементные синхронизации.

Безопасность на уровне документа (DLS) позволяет ограничивать доступ к документам на основе разрешений пользователя. См. настройку на этой странице, чтобы включить DLS для этого коннектора.

Основные правила синхронизации одинаковы для всех коннекторов и доступны по умолчанию.

Дополнительные правила синхронизации в текущей версии для этого коннектора недоступны. Фильтрация в настоящее время контролируется через конвейеры загрузки.

См. Извлечение содержимого.

В настоящее время для этого коннектора нет известных проблем. Список известных проблем для всех коннекторов см. в Известных проблемах.

См. Поиск и устранение неисправностей.

См. Безопасность.

Этот коннектор написан на Python с использованием фреймворка коннекторов Elastic.

Просмотреть исходный код этого коннектора (ветка 8.17, совместима с Elastic 8.17).

Этот коннектор доступен в виде самостоятельного самостоятельного коннектора. Этот самостоятельный коннектор совместим с версиями Elastic 8.9.0+. Для использования этого коннектора, выполните все требования к самостоятельному коннектору.

Для создания нового коннектора SharePoint Server:

Вы можете использовать Elasticsearch API создания коннектора для создания нового самостоятельного коннектора SharePoint Server.

Например:

resp = client.connector.put(
    connector_id="my-{service-name-stub}-connector",
    index_name="my-elasticsearch-index",
    name="Content synced from {service-name}",
    service_type="{service-name-stub}",
)
print(resp)

const response = await client.connector.put({
  connector_id: "my-{service-name-stub}-connector",
  index_name: "my-elasticsearch-index",
  name: "Content synced from {service-name}",
  service_type: "{service-name-stub}",
});
console.log(response);

PUT _connector/my-sharepoint_server-connector
{
  "index_name": "my-elasticsearch-index",
  "name": "Content synced from SharePoint Server",
  "service_type": "sharepoint_server"
}

Обратитесь к документации API Elasticsearch для получения подробной информации обо всех доступных API коннекторов.

Для использования этого коннектора как самостоятельного коннектора, см. Самостоятельные коннекторы.

Для дополнительных операций, см. Пользовательский интерфейс коннекторов в Kibana.

Следующие версии SharePoint Server совместимы со средой коннекторов Elastic:

Для настройки коннектора требуются следующие поля конфигурации:

Вы можете развернуть коннектор SharePoint Server в виде самостоятельного коннектора с помощью Docker. Следуйте этим инструкциям.

curl https://raw.githubusercontent.com/elastic/connectors/main/config.yml.example --output ~/connectors-config/config.yml

# When connecting to your cloud deployment you should edit the host value
elasticsearch.host: http://host.docker.internal:9200
elasticsearch.api_key: <ELASTICSEARCH_API_KEY>

connectors:
  -
    connector_id: <CONNECTOR_ID_FROM_KIBANA>
    service_type: sharepoint_server
    api_key: <CONNECTOR_API_KEY_FROM_KIBANA> # Optional. If not provided, the connector will use the elasticsearch.api_key instead

docker run \
-v ~/connectors-config:/config \
--network "elastic" \
--tty \
--rm \
docker.elastic.co/enterprise-search/elastic-connectors:8.17.3 \
/app/bin/elastic-ingest \
-c /config/config.yml

См. DOCKER.md в репозитории elastic/connectors для получения более подробной информации.

Найдите все доступные Docker-изображения в официальном репозитории.

Коннектор синхронизирует следующие типы объектов SharePoint:

Полные синхронизации поддерживаются по умолчанию для всех коннекторов.

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

Безопасность на уровне документов (DLS) позволяет ограничить доступ к документам на основе разрешений пользователя. Обратитесь к настройкам на этой странице, чтобы узнать, как включить DLS для этого коннектора.

Основные правила синхронизации одинаковы для всех коннекторов и доступны по умолчанию.

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

См. Извлечение содержимого.

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

Для выполнения E2E-тестирования для коннектора SharePoint запустите следующую команду:

$ make ftest NAME=sharepoint_server

Для более быстрых тестов добавьте флаг DATA_SIZE=small:

make ftest NAME=sharepoint_server DATA_SIZE=small

В настоящее время для этого коннектора нет известных проблем. См. Известные проблемы для списка известных проблем для всех коннекторов.

См. Устранение неполадок.

См. Безопасность.

Этот коннектор написан на Python с использованием фреймворка Elastic для коннекторов.

Посмотрите исходный код этого коннектора (ветка 8.17, совместимая с Elastic 8.17).