Отправка данных организации (последующая отправка)
Если данные организации уже были отправлены в приложение advanced insights, вы, как администратор, можете использовать сведения, приведенные в этой статье, чтобы:
- Изменение существующих данных.
- Замените существующие данные.
- Удаление атрибутов организации из существующих данных.
Выполните эти действия после подготовки данных, как описано в разделе Подготовка данных организации.
Важно!
Выполните эти действия, только если это не первый раз, когда вы отправляете данные организации. Если это первая отправка, выполните действия, описанные в разделе Отправка данных организации (первая отправка).
Для клиентов, поступающих из нашего устаревшего приложения:
При миграции из устаревшего приложения расширенной аналитики данные, отправленные в устаревшее приложение, будут автоматически доступны в новом приложении. После того как вы начнете использовать новое приложение для отправки данных, выполните все последующие отправки здесь. Продолжение использования нового приложения предотвращает несогласованность данных.
Рабочий процесс
После подготовки исходных данных процесс отправки выполняет следующие действия, которые описаны в следующих разделах:
Вы отправляете файл .csv.
Вы сопоставляете поля.
Приложение проверяет данные. (Если проверка не прошла успешно, можно выбрать один из нескольких вариантов, описанных в разделе Сбой проверки.)
Приложение обрабатывает ваши данные. (Если обработка не выполнена успешно, можно выбрать один из нескольких вариантов, описанных в разделе Сбой обработки.)
После успешной проверки и обработки данных общая задача отправки данных будет завершена.
Обновление, замена или удаление данных
Для всех трех действий используются одни и те же два первых шага:
Нажмите кнопку Пуск на вкладке Центр данных или кнопку Изменить или начать новую отправку на вкладке Подключения к данным .
На результирующей странице перечислены три варианта:
- Добавление или изменение данных
- Удаление необязательных полей
- Замена всех данных
Выберите нужные действия, а затем перейдите к соответствующему разделу ниже для шага 3.
Действие Раздел Comments Добавление новых сотрудников (строк) Обновление существующих данных организации Файл должен содержать все обязательные поля (PersonId, ManagerId и Organization) и другие необязательные поля. Добавление новых полей (столбцов) Обновление существующих данных организации Файл должен содержать PersonId и другие необязательные поля. Изменение полей (столбцов) Обновление существующих данных организации Файл должен содержать PersonId и другие необязательные поля. Удаление атрибутов Удаление необязательных полей из существующих организационных данных Удалить можно только необязательные атрибуты. При удалении полей, используемых в запросах автоматического переключения, эти запросы будут отключены. Замена всех существующих данных организации Замена существующих данных Этот параметр безвозвратно удаляет все организационные данные, отправленные ранее. Если в файле отсутствуют какие-либо поля, автоматические запросы, использующие эти поля, будут отключены.
Обновление и замена существующих данных
Обновление существующих данных
File upload
В разделе Отправить файл выберите файл, который нужно отправить, а затем нажмите кнопку Далее.
Теперь вы готовы к сопоставлению полей. Для дальнейших действий перейдите в раздел Сопоставление полей.
Пример: добавление нового столбца данных
Предположим, вы хотите передать новое значение оценки вовлеченности для каждого сотрудника. Вы уже отправили рекомендуемые данные за 13 месяцев или более snapshot, которые включали необходимые столбцы для всех сотрудников. Теперь вы хотите применить значение оценки вовлеченности ко всем этим историческим данным. Выберите параметр Обновить существующие данные организации . Чтобы отправить новый столбец данных EngagementScore , необходимо отправить файл, содержащий его.
Важные шаги для редактирования атрибутов организации
Если вы хотите изменить прошлые атрибуты, файл .csv должен содержать обновленные значения с правильными значениями EffectiveDates, чтобы обеспечить применение обновленных значений за правильный период времени.
Например, рассмотрим следующее начальное состояние данных организации в Viva Insights:
| StartDate | EndDate | PersonId | ManagerId | BadgeData | Комментарии |
|---|---|---|---|---|---|
| 01/01/0001 | 09/01/2023 | W@contoso.com | R@contoso.com | - | В этот период BadgeData имеет значение : |
| 09/01/2023 | 09/08/2023 | W@contoso.com | R@contoso.com | 102 | В этот период BadgeData имеет значение 102 |
| 09/08/2023 | 12/31/9999 | W@contoso.com | R@contoso.com | 106 | В этот период BadgeData имеет значение 106. |
В этом сценарии, если вы хотите изменить значение ManagerId, начиная с 06.09.2023 г., и вы хотите, чтобы новое значение применялось бесконечно в будущем, вам потребуется обновить Значение ManagerId для каждого элемента EffectiveDate, начиная с 06.09.2023 г., из всех предыдущих добавочных передач, даже если поле ManagerId не было частью этих добавочных передач.
Таким образом, новая отправка будет выглядеть следующим образом:
| EffectiveDate | PersonId | ManagerId |
|---|---|---|
| 09/06/2023 | W@contoso.com | D@contoso.com |
| 09/08/2023 | W@contoso.com | D@contoso.com |
После этой отправки данные организации будут выглядеть следующим образом. Обратите внимание, что для 06.09.2023 и 08.09.2023 значение ManagerId было обновлено до "D".
| StartDate | EndDate | PersonId | ManagerId | BadgeData | Комментарии |
|---|---|---|---|---|---|
| 01/01/0001 | 09/01/2023 | W@contoso.com | R@contoso.com | - | |
| 09/01/2023 | 09/06/2023 | W@contoso.com | R@contoso.com | 102 | |
| 09/06/2023 | 09/08/2023 | W@contoso.com | D@contoso.com | 102 | Эта строка была добавлена, но имеет значение EndDate от 08.09.2023 г., так как у нас есть запись в будущем. |
| 09/08/2023 | 12/31/9999 | W@contoso.com | D@contoso.com | 106 |
Или давайте представим себе другой сценарий. Если вы хотите изменить ManagerId только для дат с 06.09.2023 по 08.09.2023 г., это будет ваша отправка:
| EffectiveDate | PersonId | ManagerId |
|---|---|---|
| 09/06/2023 | W@contoso.com | D@contoso.com |
После этой отправки данные организации будут выглядеть следующим образом. Обратите внимание, что после 08.09.2023 значение ManagerId по-прежнему будет "R", так как 08.09.2023 г. для предыдущей записи не было внесено никаких изменений.
| StartDate | EndDate | PersonId | ManagerId | BadgeData | Комментарии |
|---|---|---|---|---|---|
| 01/01/0001 | 09/01/2023 | W@contoso.com | R@contoso.com | - | |
| 09/01/2023 | 09/06/2023 | W@contoso.com | R@contoso.com | 102 | |
| 09/06/2023 | 09/08/2023 | W@contoso.com | D@contoso.com | 102 | Эта строка была добавлена, но имеет значение EndDate от 08.09.2023 г., так как у нас есть запись в будущем. |
| 09/08/2023 | 12/31/9999 | W@contoso.com | R@contoso.com | 106 |
Наконец, если вы не помните предыдущие значения поля EffectiveDate, удалите столбцы, которые необходимо изменить, и снова отправьте столбцы с обновленными значениями. Или, если есть несколько столбцов, которые необходимо изменить, вы также можете заменить все прошлые данные новой отправкой с обновленными значениями.
Замена существующих данных
File upload
- Замените существующие данные:
Введите имя отправки.
В разделе Отправить файл выберите .csv файл, который нужно отправить.
Убедитесь, что файл .csv:
- В кодировке UTF-8
- Не открывается в другой программе при запуске процесса отправки
- Размер не превышает 1 ГБ
Примечание.
Чтобы просмотреть структуру и рекомендации для .csv файлов и избежать распространенных проблем во время отправки, можно скачать шаблон, перейдя по ссылке Скачать шаблон .csv .
Отправьте файл, нажав кнопку Далее. Если необходимо отменить отправку, выберите Отмена.
Теперь вы готовы к сопоставлению полей. Для дальнейших действий перейдите в раздел Сопоставление полей.
Удаление необязательных полей из существующих организационных данных
- Удаление полей:
Назовите действие удаления, чтобы вы могли ссылаться на него позже.
Определите атрибут, который требуется удалить, а затем проверка соответствующее поле.
На открывающемся экране перечислены атрибуты, которые были удалены. Нажмите кнопку Назад , чтобы вернуться в центр данных.
Процесс удаления завершен.
Важно!
Следующие разделы применяются только для отправки и замены действий.
Сопоставление полей
После отправки файла вы увидите страницу сопоставления полей. Чтобы просмотреть аналитические сведения из данных, необходимо сопоставить поля (столбцы) из файла .csv с именами полей, распознаваемые приложением.
Существует два типа полей: system default и Custom.
Системное значение по умолчанию (обязательное или необязательное)
Системные поля по умолчанию могут быть обязательными ( PersonId, ManagerId и Organization) или необязательными. Эти обязательные и необязательные поля представляют атрибуты, которые Viva Insights знает и использует в конкретных вычислениях, помимо группирования и фильтрации.
Важно!
Каждое обязательное поле должно иметь допустимое значение, отличное от NULL, в каждой строке. Необходимо сопоставить все необходимые Viva Insights значения, даже если заголовки столбцов в файлах .csv не соответствуют имени Viva Insights значений.
Необязательные поля — это часто встречающиеся системные поля, которые приложение предлагает для использования. Вам не нужно сопоставлять необязательные поля, если в вашей организации нет данных для них.
Чтобы узнать, является ли поле обязательным или необязательным, обратитесь к разделу атрибутов Viva справа от списка сопоставления. Обязательные атрибуты имеют метку "Обязательный", а необязательные атрибуты имеют метку "Необязательный".
Пользовательский
Настраиваемые поля — это необязательные атрибуты, которые можно создать. В следующем разделе, шаг 5a, объясняется, как сопоставить настраиваемый атрибут и присвоить ей имя.
Сопоставление полей
Выполните следующие действия, чтобы сопоставить данные .csv с атрибутами Viva Insights.
Важно!
Все поля заголовка .csv, которые отображаются в разделе Имя исходного столбца, должны быть сопоставлены, прежде чем вы сможете перейти к следующей части процесса отправки.
Для каждого поля обязательных Viva Insights:
Найдите соответствующий заголовок столбца в разделе Имя исходного столбца. Чтобы предотвратить ошибку проверки позже, убедитесь, что этот столбец является правильным типом данных.
В столбце Сопоставление с полем Viva Insights откройте раскрывающийся список и выберите атрибут Viva Insights, соответствующий заголовку столбца, указанному на шаге а.
Совет
Наведите указатель мыши на имя атрибута, чтобы прочитать его описание.
При обновлении данных можно выбрать отображение только добавленных новых столбцов или измененных заголовков столбцов. Для этого выберите переключатель Показывать только недопустимые поля .
Повторите шаги 4a и 4b для настраиваемых и необязательных полей.
- Чтобы добавить настраиваемое поле, просто добавьте его в качестве столбца в файл данных. Приложение автоматически назначит ему имя и сопоставит его. В этом выпуске Viva Insights всем настраиваемым атрибутам присваивается имя по умолчанию и их можно классифицировать только как типы данных String.
Важно!
Не загружайте TimeZone в качестве столбца. Появится сообщение об ошибке.
- Чтобы добавить настраиваемое поле, просто добавьте его в качестве столбца в файл данных. Приложение автоматически назначит ему имя и сопоставит его. В этом выпуске Viva Insights всем настраиваемым атрибутам присваивается имя по умолчанию и их можно классифицировать только как типы данных String.
После сопоставления полей приложение проверяет и обрабатывает данные, как описано в следующих разделах. Если проверка и обработка прошли успешно, входные данные для процесса отправки будут завершены.
Если ожидаемые столбцы отсутствуют или исключены
Для успешного выполнения запроса в данных организации должны присутствовать определенные атрибуты (столбцы). Это требование также верно для запросов с включенным параметром автоматического обновления. Если атрибуты (столбцы), которые используются в запросе, отсутствуют при отправке данных, приложение оповещает вас. Вы увидите таблицу с полями атрибутов и запросами, в которых эти поля используются, а также сообщение с предупреждением: "При выполнении эти запросы будут отключены. Если во время выполнения функции создается запрос автоматического обновления, содержащий эти поля, он также будет отключен".
После просмотра отсутствующих атрибутов:
- Если вы решили не продолжать передачу или замену данных, нажмите кнопку Отмена. Эта кнопка возвращает вас на страницу сопоставления полей.
- Если вы решили продолжить отправку данных, даже если отсутствуют атрибуты, нажмите кнопку Далее. Обратите внимание, что этот вариант отключает автоматическое обновление для запросов, перечисленных выше. Вы по-прежнему можете получить доступ к результатам последних запусков этих запросов.
Проверка
После сопоставления атрибутов приложение начнет проверку данных.
В большинстве случаев проверка файла должна завершиться быстро. Если файл данных организации большой, проверка может занять до одной или двух минут.
После завершения этого этапа проверка прошла успешно или не удалось.
Сведения о дальнейших событиях см. в соответствующем разделе:
Проверка выполнена успешно
После успешной проверки Viva Insights начнет обработку новых данных. Обработка может занять от нескольких часов до дня или примерно. Во время обработки вы увидите состояние "Обработка" в таблице Отправка или удаление подключений к > данным в ходе выполнения .
После завершения обработки она либо успешно, либо завершилась сбоем. В зависимости от результата вы получите уведомление об успешном выполнении или об ошибке в правом верхнем углу экрана Подключения к данным .
Обработка выполнена успешно
При успешной обработке вы увидите состояние "Успешно" в таблице журнала отправки или удаления . На этом этапе процесс отправки завершен.
Ниже приведено обычное время, необходимое для отражения организационных данных после их отправки в следующих интерфейсах:
Состояние успешного выполнения отображается в журнале импорта подключений к > данным: несколько часов
Вкладка "Качество данных", гибкие запросы и шаблоны Power BI: от одного до двух дней
Отчет руководителя и руководителя в приложении Teams: следующее еженедельное обновление
После получения состояния "Успешно" вы можете:
Щелкните значок представления (глаза), чтобы просмотреть сводку результатов проверки.
Щелкните значок сопоставления, чтобы просмотреть параметры сопоставления для рабочего процесса.
Примечание.
Каждый клиент может одновременно выполнять только одну отправку. Перед началом рабочего процесса следующего файла данных необходимо завершить рабочий процесс одного файла данных. Это означает, что вы либо будете направлять его к успешной проверке и обработке, либо отказаться от него. Состояние или этап рабочего процесса отправки отображается на вкладке Подключения к данным .
Сбой обработки
Если обработка завершается сбоем, в таблице Отправка или удаление выполняется, вы увидите состояние сбоя. Если щелкнуть ссылку в состоянии, вы запустите объяснение сбоя.
Выберите Изменить или начните новую отправку. Эта кнопка позволяет выполнить следующие действия для файла данных, отправленного ранее.
- Измените, чтобы добавить новые строки или столбцы.
- Удаление атрибутов.
- Замените существующий файл новым.
Примечание.
Сбои обработки, как правило, вызваны внутренними ошибками. Если вы видите постоянные сбои обработки и вы исправили данные в отправленном файле, запишите запрос в службу поддержки.
Сбой проверки
Если проверка данных завершается сбоем, вы увидите новый экран с ошибкой "Проверка завершилась ошибкой" и некоторыми сведениями о сбое. Если вы не хотите продолжать процесс отправки, нажмите кнопку Отмена отправки .
Прежде чем внести изменения в исходный файл и повторить попытку отправки, можно выбрать Скачивание проблем. В этом файле журнала описываются проблемы в данных, которые могли вызвать ошибки проверки. Используйте эти сведения, чтобы решить, что делать дальше: исправить исходные данные или изменить параметры сопоставления.
Рекомендации по исправлению ошибок в данных
Если какая-либо строка или столбец данных имеет недопустимое значение для любого атрибута, вся отправка завершится ошибкой, пока не будет исправлен исходный файл (или вы не исправите сопоставление атрибутов).
Сведения о форматировании файла для предотвращения ошибок см. в статье Правила файлов и ошибки проверки.