Отправка данных организации (первая отправка)
Данные организации могут отображаться в приложении расширенной аналитики Microsoft Viva Insights одним из двух способов: с помощью идентификатора Microsoft Entra, который является источником по умолчанию, или через .csv файл, который вы отправляете как администратор.
В этой статье рассматривается второй вариант: отправка файла .csv.
Важно!
Выполните следующие действия, только если вы впервые отправляете данные организации. Если это не первая отправка, см . раздел Отправка организационных данных (последующие отправки), чтобы обновить ранее отправленные данные.
Для клиентов, поступающих из нашего устаревшего приложения:
Если вы выполняете миграцию из устаревшего приложения расширенной аналитики и впервые отправляете данные организации в Viva Аналитику, рекомендуется использовать только новое приложение для отправки данных. Использование нового приложения предотвращает несоответствие данных.
Рабочий процесс
После подготовки исходных данных выполните следующие действия.
- Вы отправляете файл .csv.
- Вы сопоставляете поля.
- Приложение проверяет данные. (Если проверка не прошла успешно, можно выбрать один из нескольких вариантов, описанных в разделе Сбой проверки.)
- Приложение обрабатывает ваши данные. (Если обработка не выполнена успешно, можно выбрать один из нескольких вариантов, описанных в разделе Сбой обработки.)
После успешной проверки и обработки данных вы завершите работу с общей задачей отправки данных.
File upload
Чтобы отправить файл .csv, выполните следующие действия.
Откройте интерфейс администрирования приложения advanced insights .
На странице Центр данных перейдите к карточке .csv отправки в правой части экрана под разделом Источник данных.
Нажмите кнопку Пуск.
В разделе Шаг 1 из 2. Подготовка и отправка:
- Введите имя отправки.
- В разделе Отправить файл выберите .csv файл, который нужно отправить.
Убедитесь, что файл .csv:
В кодировке UTF-8.
Не открывается в другой программе при запуске процесса отправки.
Размер не превышает 1 ГБ.
Примечание.
Чтобы просмотреть структуру и рекомендации для .csv файлов и избежать распространенных проблем во время отправки, можно скачать шаблон по ссылке Скачать .csv шаблон .
- Чтобы отправить, нажмите кнопку Далее. Чтобы отменить отправку, нажмите кнопку Отмена.
Сопоставление полей
После отправки файла вы увидите страницу Шаг 2 из 2. Сопоставление . Чтобы просмотреть аналитические сведения из данных, необходимо сопоставить поля (столбцы) из файла .csv с именами полей, распознаваемые приложением.
Существует два типа полей: system default и Custom.
Системное значение по умолчанию (обязательное или необязательное)
Системные поля по умолчанию могут быть обязательными ( PersonId, ManagerId и Organization) или зарезервированными необязательными. Эти поля представляют атрибуты, которые Viva Аналитика знает и использует в конкретных вычислениях, помимо группирования и фильтрации.
Важно!
Каждое обязательное поле должно иметь допустимое значение, отличное от NULL, в каждой строке. Необходимо сопоставить все необходимые значения Viva Аналитики, даже если заголовки столбцов в файлах .csv не соответствуют имени значения Viva Аналитики.
Необязательные поля — это часто встречающиеся системные поля, которые приложение предлагает использовать. Вам не нужно сопоставлять необязательные поля, если в вашей организации нет данных для них.
Чтобы узнать, является ли поле обязательным или необязательным, обратитесь к разделу Атрибуты Viva справа от списка сопоставления. Обязательные атрибуты имеют метку "Обязательный" под именем поля, в то время как необязательные атрибуты имеют метку "Зарезервировано необязательно".
Если требуется определение поля, наведите указатель мыши на значок сведений (i).
Пользовательский
Настраиваемые поля — это необязательные атрибуты, которые можно создать. В следующем разделе объясняется сопоставление и именование пользовательского атрибута.
Сопоставление полей
Выполните следующие действия, чтобы сопоставить данные .csv с атрибутами Viva Аналитики.
Важно!
Все поля заголовка .csv, которые отображаются в разделе Имя исходного столбца, должны быть сопоставлены, прежде чем вы сможете перейти к следующей части процесса отправки.
Для каждого обязательного поля Viva Аналитики:
- Найдите соответствующий заголовок столбца в разделе Имя исходного столбца. Чтобы предотвратить ошибку проверки позже, убедитесь, что этот столбец является правильным типом данных.
- В столбце "Сопоставление с полем Viva Аналитика " откройте раскрывающийся список и выберите атрибут Viva Аналитика, соответствующий заголовку столбца, указанному на шаге 1a.
Повторите шаги 1a и 1b для настраиваемых и необязательных полей.
Чтобы добавить настраиваемое поле, просто добавьте его в качестве столбца в файл данных. Приложение автоматически назначит ему имя и сопоставит его. В этом выпуске Viva Аналитики всем настраиваемым атрибутам присваивается имя по умолчанию и их можно классифицировать только как типы данных String .
Важно!
Не загружайте TimeZone в качестве столбца. Появится сообщение об ошибке.
Завершив сопоставление атрибутов, нажмите кнопку Далее в левом нижнем углу экрана.
После сопоставления полей приложение проверяет и обрабатывает данные, как описано в следующих разделах. Если проверка и обработка успешно завершены, вы выполните часть процесса отправки.
Проверка
После сопоставления атрибутов приложение начнет проверку данных.
В большинстве случаев проверка файла должна завершиться быстро. Если файл данных организации большой, проверка может занять до одной или двух минут.
После завершения этого этапа проверка прошла успешно или не удалось. В зависимости от результата вы получите уведомление об успешном выполнении или об ошибке в правом верхнем углу экрана Подключения к данным .
Сведения о дальнейших событиях см. в соответствующем разделе:
Проверка выполнена успешно
После успешной проверки Viva Аналитика начинает обработку новых данных. Обработка может занять от нескольких часов до дня или примерно. Во время обработки вы увидите состояние "Обработка" в таблице Отправка или удаление подключений к > данным в ходе выполнения .
После завершения обработки она либо успешно, либо не выполнена. В зависимости от результата вы получите уведомление об успешном выполнении или об ошибке в правом верхнем углу экрана Подключения к данным .
Обработка выполнена успешно
При успешной обработке вы увидите состояние "Успешно" в таблице журнала отправки или удаления . На этом этапе процесс отправки завершен.
Ниже приведено обычное время, необходимое для отражения организационных данных после их отправки в следующих интерфейсах:
Состояние успешного выполнения отображается в журнале импорта подключений к > данным: несколько часов
Вкладка "Качество данных", гибкие запросы и шаблоны Power BI: от одного до двух дней
Отчет руководителя и руководителя в приложении Teams: следующее еженедельное обновление
После получения состояния "Успешно" вы можете:
- Щелкните значок представления (глаза), чтобы просмотреть сводку результатов проверки.
- Щелкните значок сопоставления, чтобы просмотреть параметры сопоставления для рабочего процесса.
Примечание.
Каждый клиент может одновременно выполнять только одну отправку. Перед началом рабочего процесса следующего файла данных необходимо завершить рабочий процесс одного файла данных. Это означает, что вы либо будете направлять его к успешной проверке и обработке, либо отказаться от него. Состояние или этап рабочего процесса отправки отображается на вкладке Подключения к данным .
Сбой обработки
Если обработка завершается сбоем, в таблице Отправка или удаление выполняется, вы увидите состояние сбоя. Если щелкнуть ссылку в состоянии, вы запустите объяснение сбоя.
Выберите Изменить или начните новую отправку. Эта кнопка позволяет снова начать процесс отправки.
Примечание.
Сбои обработки, как правило, вызваны внутренними ошибками. Если вы видите постоянные сбои обработки и вы исправили данные в отправленном файле, запишите запрос в службу поддержки.
Сбой проверки
Если проверка данных завершается сбоем, вы увидите новый экран с ошибкой "Проверка завершилась ошибкой" и некоторыми сведениями о сбое. Если вы не хотите продолжать процесс отправки, нажмите кнопку Отмена отправки .
Прежде чем внести изменения в исходный файл и повторить попытку отправки, можно выбрать Скачивание проблем. В этом файле журнала описываются проблемы в данных, которые могли вызвать ошибки проверки. Используйте эти сведения, чтобы решить, что делать дальше: исправить исходные данные или изменить параметры сопоставления.
Рекомендации по исправлению ошибок в данных
Если какая-либо строка или столбец данных имеет недопустимое значение для любого атрибута, вся отправка завершится ошибкой, пока не будет исправлен исходный файл (или вы не исправите сопоставление атрибутов).
Сведения о форматировании файла для предотвращения ошибок см. в статье Правила файлов и ошибки проверки.