Поделиться через


Экспорт данных Viva Engage и управление ими

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

Экспорт данных

Примечание.

Чтобы перенести данные между клиентами Viva Engage, узнайте о переносе содержимого.

Использование этого метода экспорта данных Для этой цели
Экспорт списка пользователей и администраторов Определите состояние текущих администраторов и пользователей. Для каждого пользователя вы получаете адрес электронной почты, название, расположение и отдел.
Экспорт данных клиента по диапазону дат Просмотр и аудит данных клиента для всех пользователей из домашней сети для определенного диапазона дат. Параметры также позволяют включать файлы вложений и данные из внешних сетей.
Экспорт данных для одного пользователя Извлечение всех данных, связанных с одним пользователем. Используйте этот метод для определения данных, которые необходимо удалить в соответствии с запросом субъекта данных GDPR.
Автоматизация экспорта данных Автоматизация повторяющегося экспорта для соответствия требованиям с помощью API экспорта данных.
Экспорт файлов Engage с помощью API При экспорте больших объемов файлов используйте API. Можно указать диапазон дат и включить файлы из внешних сетей. Этот метод лучше всего подходит для архивации данных.

Доступ к параметрам экспорта данных

Получите доступ ко всем параметрам экспорта на странице Экспорт данных на портале администрирования Engage.

  1. Перейдите на вкладку Управление и соответствие требованиям .

  2. Выберите Экспорт данных.

    Снимок экрана: вкладка

Экспорт списка пользователей и администраторов

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

  1. На странице Экспорт данных выберите Экспорт данных для всехпользователей.

  2. Укажите диапазон дат и другие параметры.

    • Диапазон дат: Укажите диапазон дат, для которого нужны данные. Текущая дата отображается в качестве конечной даты.
    • Включить вложения: Оставьте невыбранными, чтобы получить список имен файлов. Выберите , чтобы получить список и папку Files для всех вложений в собственном формате.
    • Включить внешние сети: Не выбирать, чтобы получать данные только из домашней сети. Выберите , чтобы получить данные для каждой сети в отдельной папке (имя папки — идентификатор сети). Полные имена сетей перечислены в Networks.csv.
  3. Выберите Скачать CSV. Он сохраняется как сжатый ZIP-файл.

  4. Перейдите к расположению, где сохранен сжатый файл, и откройте его. Экспорт данных содержит следующие файлы:

    File Содержание
    log.txt Сводка по экспорту
    request.txt Параметры экспорта
    Admins.csv Списки текущих администраторов, их адреса электронной почты и соответствующие роли
    Дополнительные сведения о типах администраторов в Viva Engage см. в статье Управление ролями администраторов в Viva Engage.
    Answers.csv Списки id, messageId, networkId, threadId, voterID, createdAt timestamp и updatedAt timestamp of Answer Votes
    Campaigns.csv Предоставляет данные для кампаний, включая хэштег, дату создания, состояние и т. д. Атрибут scope_type отличает официальные (сетевые) кампании и кампании сообщества (группы). Атрибут scope_id определяет сеть или сообщество, в которых размещена кампания сообщества. Дополнительные сведения о кампании о сети или сообществе см. в файле networks.csv или в файле groups.csv соответственно.
    Networks.csv Сведения о домашней сети и любых внешних сетях, включая имя, URL-адрес, дату создания, количество пользователей, а также о том, является ли она модерирована или имеет политику использования.
    Users.csv Списки данных пользователя. К свойствам относятся: Идентификатор, имя, адрес электронной почты, должность, расположение, отдел, идентификатор пользователя, состояние удаления (дата, имя и идентификатор лица, выполнившего удаление), дата присоединения, состояние приостановки (дата, имя и идентификатор лица, выполнившего деактивацию) и состояние пользователя (активный или soft_delete). Soft_delete: Ожидание, если не сопровождается другими значениями; Приостановлено (деактивировано), если он сопровождается suspended_at и не deleted_at значением; или Удалено, если он сопровождается значением deleted_at. Определите гостей по адресу электронной почты, который не соответствует домену домашней сети.

    Api_url предоставляет метаданные пользователя. Дополнительные сведения об использовании данных в этом поле см. в разделе REST API.
    Папка "Файлы" Содержит файлы, которые хранятся в Viva Engage и были созданы или изменены в течение указанного периода времени. Файлы именуются по идентификатору учетной записи и имеют собственный формат. Например, презентация PowerPoint может быть указана как 127815379.pptx.

Этот экспорт данных не включает в себя:

  • Данные, доступные в параметрах пользователя, в том числе:
    • Профиль пользователя
    • клиенты (сети), членом которых является пользователь
    • действия с учетной записью пользователя, приложения, уведомления и языковые предпочтения
    • организационная диаграмма
  • Данные о действиях пользователей
  • Сообщения с закладками
  • Участие в группе
  • Отслеживаемая или отслеживаемая пользователей или отслеживаемая статья
  • Вложения файлов, хранящиеся в SharePoint

Экспорт данных клиента по диапазону дат

Используйте этот метод для экспорта данных для Viva Engage сети.

Важно!

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

  1. На странице Экспорт данных выберите Экспорт данных клиента.

  2. Укажите диапазон дат и другие параметры.

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

    • Диапазон дат: Включает только данные в указанном диапазоне дат. Текущая дата автоматически заполняется в качестве конечной даты.
    • Включить вложения: Если этот параметр не выбран, экспортируется только список файлов. Если выбран параметр, экспортируется папка Files , содержащая все файлы в собственном формате.
    • Включить внешние сети: Если этот параметр не выбран, экспортируются только данные из домашней сети. Если выбран параметр, экспортируется отдельная папка данных из каждой сети. Каждая сеть идентифицируется по ее идентификатору, а полные имена сети перечислены в Networks.csv.
  3. Выберите Скачать CSV. Данные экспортируются в файл .zip.

  4. Перейдите к расположению, где сохранен сжатый файл, и откройте его.

    При экспорте нескольких сетей создается отдельная папка для каждой сети.

Экспорт данных содержит следующие файлы:

File Содержание
log.txt Сводка по экспорту
request.txt Параметры экспорта
Admins.csv Список администраторов для каждой выбранной сети, включая имя, адрес электронной почты и тип администратора.
Campaigns.csv Список всех кампаний в сети. К свойствам относятся: имя создания, URL-адрес, хэштег, дата создания, идентификатор создателя и состояние.
EngageTopicMigrationLog.csv Список разделов, перенесенных или не импортированных из Viva Topics или упрощенных разделов в Viva Engage. К свойствам относятся: Cortex_topic_ID, migrated_at, migrated_action
EngageTopicApplicationMigrationLog.csv Список тематических приложений, не импортированных из Viva Topics или упрощенных разделов для Viva Engage. К свойствам относятся: Cortex_topic_id, target_id, target_type, migrated_at, migration_action
Files.csv Список вложенных файлов, которые были добавлены или изменены в диапазоне дат. Files.csv не содержит фактических файлов. К свойствам относятся: идентификатор учетной записи, тип файла, имя, описание и путь к файлу, а также метаданные, включающие группу, в которую он был размещен.

Если выбран параметр Включить вложения, в папку Файлы ZIP-файла экспортируются только файлы, хранящиеся в Viva Engage.

Примечание. Чтобы скачать файлы из SharePoint, используйте столбец download_url .
Если файлы SharePoint не имеют маркеров Microsoft Entra, необходимо создать приложение Microsoft Entra. Кроме того, используйте поиск содержимого в Microsoft 365 , чтобы найти файлы в SharePoint для указанного диапазона дат.
Чтобы определить файлы в папке Файлы , используйте столбцы file_ID и пути .

Важный: Если файлы хранятся в Viva Engage и SharePoint, удалите их из Viva Engage, чтобы удалить метаданные из обоих расположений.
Groups.csv Все группы, созданные или измененные в течение указанного диапазона дат. К свойствам относятся: идентификатор учетной записи, имя, описание, состояние конфиденциальности, независимо от того, является ли группа внутренней или внешней, ссылка на группу, кто создал группу, дата создания и дата обновления.
Messages.csv Все сообщения, отправленные или измененные в течение указанного диапазона дат, включая сообщения, созданные из файлов (с помощью Intelligent Importer). К свойствам относятся: идентификатор сообщения, идентификатор потока, идентификатор группы, имя группы, URL-адрес удаления GDPR (gdpr_delete_url), состояние конфиденциальности, идентификатор отправителя, имя и адрес электронной почты, полный текст сообщения, вложения, сведения о создании и удалении, а также состояние черновика.
MessageThreadsOutbound.csv Содержит идентификаторы внешних участников в исходящих сообщениях.
MessageVersions.csv Содержит идентификаторы и сведения об изменениях для сообщений, которые были отредактированы.
Networks.csv Перечисляет домашнюю сеть и все внешние сети, включенные в экспорт.
Pages.csv Списки идентификаторы, даты и владельцы страниц для любой страницы, созданной или измененной в течение указанного диапазона дат.
Topics.csv Списки сведения о создании и ссылку на любую статью, созданную в течение указанного диапазона дат.
Users.csv Списки данные для всех пользователей, которые присоединились, были удалены или приостановлены в течение указанного диапазона дат. К свойствам относятся: адрес электронной почты, должность, расположение, отдел, ссылка на пользователя и сведения о текущем состоянии пользователя (активное или soft_delete).
Soft_delete: Ожидание, если не сопровождается другими значениями; Приостановлено (деактивировано), если он сопровождается suspended_at и не deleted_at значением; или Удалено, если он сопровождается значением deleted_at.

Определите гостей по адресу электронной почты, который не соответствует домену домашней сети.

Api_url предоставляет метаданные пользователя. Дополнительные сведения об использовании данных в этом поле см. в разделе REST API.
VivaTopicApplications.csv Для любого раздела, примененного к записи, выводит сведения о каждом приложении для указанного диапазона дат (если таковой имеется).
VivaTopicCurationStateLogs.csv Применяется только к ответам в Viva.

Содержит журналы состояния курирования для избранных разделов.

cortex_topic_id можно использовать с содержимым VivaTopics.csv для получения других сведений, относящихся к этому разделу.
VivaTopics.csv Любой созданный или обновленный раздел отображается для указанного диапазона дат (при наличии).

Идентификатор ссылается на идентификатор Viva раздела.

Api_url — это URL-адрес, используемый для получения метаданных раздела.
Папка "Файлы" Содержит файлы, которые хранятся в Viva Engage и были созданы или изменены в течение указанного периода времени.

Файлы именуются по идентификатору учетной записи и имеют собственный формат. Например, презентация PowerPoint может быть указана как 127815379.pptx.

Этот экспорт данных не включает в себя:

  • Данные, доступные в параметрах пользователя, в том числе:
    • Профиль пользователя
    • клиенты (сети), членом которых является пользователь
    • действия с учетной записью пользователя, приложения, уведомления и языковые предпочтения
    • организационная диаграмма
  • Данные о действиях пользователей
  • Сообщения с закладками
  • Участие в группе
  • Отслеживаемая или подписываемая пользователи или разделы
  • Вложения файлов, хранящиеся в SharePoint

Экспорт данных для одного пользователя

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

  1. На странице Экспорт данных выберите Экспорт данных для одногопользователя.

  2. Введите имя пользователя, выберите пользователя и нажмите кнопку Экспорт.
    Данные пользователя экспортируются в .zip файл, содержащий эти файлы.
    Когда данные о действиях учетной записи пользователя будут готовы, в папке "Входящие" Viva Engage появится сообщение со ссылкой на эти данные.

  3. Щелкните ссылку, чтобы открыть.

Экспорт данных содержит следующие файлы:

File Содержание
log.txt Суммирует количество записей в каждом файле .csv и выводит список ошибок, возникающих во время экспорта.
request.txt Параметры, используемые для экспорта
Broadcast.csv Включается, если пользователь опубликовал видео трансляции. Списки идентификатор сети, идентификатор группы и имя, заголовок, описание, ссылки на видео и дополнительные сведения о видео.
Видеоконтент исключается из экспорта. Видео сохраняется в OneDrive пользователя, который начал запись. Чтобы изменить метаданные или удалить видео, его можно открыть в режиме Microsoft Stream администрирования. Дополнительные сведения см. в разделе Администратор возможности в Microsoft Stream и запросы субъектов данных Microsoft 365 для GDPR.
Files.csv Списки все файлы, добавленные или измененные пользователем из Viva Engage. К свойствам относятся: идентификатор учетной записи, тип файла, имя, описание и путь к файлу, а также метаданные, включая группу, в ней была размещена. В столбце storage_path показано, хранится ли файл в Viva Engage или SharePoint.
Файлы, хранящиеся в Viva Engage, экспортируются в собственном формате в папку Файлы ZIP-файла. Файлы, хранящиеся в SharePoint, не экспортируются.
Чтобы определить файлы в папке Файлы , используйте столбцы file_ID и путь.

Чтобы скачать файлы, хранящиеся в SharePoint, используйте столбец download_url. Если файлы SharePoint не имеют маркеров Microsoft Entra, необходимо создать приложение Microsoft Entra. Кроме того, можно найти файлы, хранящиеся в SharePoint для определенного диапазона дат, с помощью поиска контента в Microsoft 365.
Всегда удаляйте сохраненные файлы из Viva Engage для удаления файлов и метаданных в SharePoint и Viva Engage. При удалении файла из SharePoint метаданные сохраняются в Viva Engage.
Groups.csv Списки все группы, созданные или измененные пользователем. К свойствам относятся: идентификатор группы, имя, описание, состояние конфиденциальности, внутреннее или внешнее, дата создания, дата обновления и ссылка на группу.
Дополнительные сведения включают агрегированное общее количество опросов, по результатам которых проголосовал пользователь, и опросы, созданные пользователем.
LikedMessages.csv Списки все сообщения, понравились пользователю. К свойствам относятся: идентификатор сообщения, идентификатор потока, идентификатор группы, имя группы, состояние конфиденциальности, идентификатор отправителя, имя и адрес электронной почты, полный текст сообщения, вложения*, а также сведения о создании и удалении. Также предоставляется список созданных опросов. Для объявлений включает название объявления. Вместе с вложениями экспортируются сведения об объекте Open Graph: идентификатор, URL-адрес, заголовок и описание.
Messages.csv Списки все сообщения, отправленные или измененные пользователем, включая сообщения, созданные из файлов (с помощью Intelligent Importer). К свойствам относятся: идентификатор сообщения, идентификатор потока, идентификатор группы, имя группы, состояние конфиденциальности, идентификатор отправителя, имя и адрес электронной почты, полный текст сообщения, вложения, сведения о создании и удалении, а также состояние черновика. Также предоставляет список опросов, созданных пользователем, и заголовки любых опубликованных объявлений.
Вместе с вложениями экспортируются сведения об объекте Open Graph (OGO): идентификатор, URL-адрес, заголовок и описание.
BestReplyMessages.csv Списки все сообщения, помеченные пользователем как лучшие ответы. К свойствам относятся: идентификатор сообщения, идентификатор потока, идентификатор группы, имя группы, состояние конфиденциальности, идентификатор отправителя, имя и адрес электронной почты, полный текст сообщения, идентификаторы вложений, сведения о создании и удалении.
Topics.csv Списки все разделы, созданные пользователем в течение указанного диапазона дат, включая сведения о создании и ссылку на раздел.
VivaTopicApplications.csv Для любого раздела, примененного к записи, выводит сведения о каждом приложении для указанного диапазона дат (если таковой имеется).
VivaTopicCurationStateLogs.csv Применяется только к ответам в Viva.

Содержит журналы состояния курирования для избранных разделов.

cortex_topic_id можно использовать с содержимым VivaTopics.csv для получения других сведений, относящихся к этому разделу.
VivaTopics.csv Любой созданный или обновленный раздел отображается для указанного диапазона дат (при наличии).

Идентификатор ссылается на идентификатор Viva раздела.

Api_url — это URL-адрес, используемый для получения метаданных раздела.
Папка "Файлы" Содержит файлы, хранящиеся в Viva Engage созданные или измененные пользователем в течение указанного периода времени. Engage файлы, хранящиеся в SharePoint, исключаются.

Файлы имеют собственный формат и именуются с идентификатором учетной записи. Например, презентация PowerPoint может быть указана как 127815379.pptx.

Этот экспорт данных не включает в себя:

  • Сообщения с закладками
  • Диаграмма членства в группе или организации
  • Отслеживаемые пользователи, следующие пользователи, следующие разделы
  • Уведомления пользователей от Viva Engage (или в Microsoft Teams или Microsoft Outlook)
  • Параметры приложения и языка

Примечание.

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

Экспорт разделов, созданных в Viva Engage, с помощью PowerShell

С помощью PowerShell можно экспортировать разделы, созданные пользователем в Viva Engage (также известной как Lite Topics) в файл .csv. Topics включают те, которые были созданы перед включением интеграции с Viva Engage. Дополнительные сведения см. в статье Экспорт разделов, созданных в Viva Engage с помощью PowerShell.

Устранение неполадок с экспортом данных

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

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

Автоматизация экспорта данных

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

Экспорт больших томов файлов с помощью API

Проверенные администраторы могут использовать API экспорта данных для архивации и экспорта файлов в хранилище Viva Engage асинхронно. Этот API предназначен для экспорта больших объемов файлов из Viva Engage. Дополнительные сведения см. в разделе API экспорта данных.

См. также

Обзор Центра администрирования Viva Engage

Управление ролями администратора в Viva Engage

Настройка Центра администрирования Viva Engage