Отправка данных организации (первая отправка)

Данные организации могут отображаться в приложении расширенной аналитики Microsoft Viva Аналитика одним из двух способов: через Azure Active Directory, который является источником по умолчанию, или через файл .csv, который вы отправляете администратором.

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

Важно!

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

Рабочий процесс

После подготовки исходных данных процесс отправки выполняет следующие действия, которые описаны в следующих разделах:

  1. Вы отправляете файл .csv.
  2. Вы сопоставляете поля.
  3. Приложение проверяет данные. (Если проверка не прошла успешно, можно выбрать один из нескольких вариантов, описанных в разделе Сбой проверки.)
  4. Приложение обрабатывает ваши данные. (Если обработка не выполнена успешно, можно выбрать один из нескольких вариантов, описанных в разделе Сбой обработки.)

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

File upload

Чтобы отправить файл .csv, выполните следующие действия.

  1. На странице Организационные данные выберите .csv отправить. Снимок экрана: центр страницы данных организации.

  2. Введите имя отправки.

  3. В разделе Отправить файл выберите .csv файл, который нужно отправить.

    Убедитесь, что файл .csv:

    • В кодировке UTF-8
    • Не открывается в другой программе при запуске процесса отправки
    • Не более 1 ГБ

    Снимок экрана: параметр

Примечание.

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

  1. Чтобы отправить, нажмите кнопку Далее. Чтобы отменить отправку, нажмите кнопку Отмена.

Сопоставление полей

После отправки файла вы увидите страницу сопоставления полей. Чтобы просмотреть аналитические сведения из данных, необходимо сопоставить поля (столбцы) из файла .csv с именами полей, распознаваемые приложением.

Существует два типа полей: system default и Custom.

Системное значение по умолчанию (обязательное или необязательное)

Системные поля по умолчанию могут быть обязательными ( PersonId, ManagerId и Organization) или необязательными. Эти поля представляют атрибуты, которые Viva Аналитика знает и использует в конкретных вычислениях, помимо группирования и фильтрации.

Важно!

Каждое обязательное поле должно иметь допустимое значение, отличное от NULL, в каждой строке. Необходимо сопоставить все необходимые Viva Аналитика значения, даже если заголовки столбцов в файлах .csv не соответствуют имени Viva Аналитика значения.

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

Чтобы узнать, является ли поле обязательным или необязательным, обратитесь к разделу Атрибуты Viva справа от списка сопоставления. Обязательные атрибуты имеют метку "Обязательный", а необязательные атрибуты имеют метку "Необязательный".

Снимок экрана: атрибуты Viva и сопоставленные и несопоставленные поля.

Пользовательские

Настраиваемые поля — это необязательные атрибуты, которые можно создать. В следующем разделе, шаг 2a, объясняется сопоставление и именование пользовательского атрибута.

Сопоставление полей

Выполните следующие действия, чтобы сопоставить данные .csv с атрибутами Viva Аналитика.

Важно!

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

  1. Для каждого обязательного поля Viva Аналитика:

    1. Найдите соответствующий заголовок столбца в разделе Имя исходного столбца. Чтобы предотвратить ошибку проверки позже, убедитесь, что этот столбец является правильным типом данных.
    2. В столбце Сопоставление с полем Viva Аналитика откройте раскрывающийся список и выберите атрибут Viva Аналитика, соответствующий заголовку столбца, указанному на шаге а.

    Снимок экрана: сопоставление атрибутов Viva.

    Совет

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

  2. Повторите шаги 1a и 1b для настраиваемых и необязательных полей.

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

      Важно!

      Не загружайте TimeZone в качестве столбца. Появится сообщение об ошибке.

  3. Завершив сопоставление атрибутов, нажмите кнопку Далее в левом нижнем углу экрана.

После сопоставления полей приложение проверяет и обрабатывает данные, как описано в следующих разделах. Если проверка и обработка прошли успешно, входные данные для процесса отправки будут завершены.

Проверка

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

Снимок экрана: проверка выполняется.

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

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

Сведения о дальнейших событиях см. в соответствующем разделе:

Проверка выполнена успешно

Сбой проверки

Проверка выполнена успешно

После успешной проверки Viva Аналитика начинает обработку новых данных. Обработка может занять от нескольких часов до дня или примерно так. Во время обработки вы увидите состояние "Обработка" в таблице Отправка или удаление подключений к > данным в ходе выполнения .

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

Обработка выполнена успешно

При успешной обработке вы увидите состояние "Успешно" в таблице журнала отправки или удаления . На этом этапе процесс отправки завершен.

Снимок экрана: успешная обработка.

После получения состояния "Успешно" вы можете:

  • Щелкните значок представления (глаза), чтобы просмотреть сводку результатов проверки. Снимок экрана: результаты проверки.
  • Щелкните значок сопоставления, чтобы просмотреть параметры сопоставления для рабочего процесса. Снимок экрана: параметры сопоставления.

Примечание.

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

Сбой обработки

Если обработка завершается сбоем, в таблице Отправка или удаление выполняется, вы увидите состояние сбоя. Если щелкнуть ссылку в состоянии, вы запустите объяснение сбоя.

Снимок экрана: сбой обработки.

Выберите Изменить или начните новую отправку. Эта кнопка позволяет снова начать процесс отправки.

Примечание.

Сбои обработки, как правило, вызваны внутренними ошибками. Если вы видите постоянные сбои обработки и вы исправили данные в отправленном файле, запишите запрос в службу поддержки.

Сбой проверки

Если проверка данных завершается сбоем, появится новый экран с ошибкой "Проверка завершилась ошибкой" и некоторыми сведениями о сбое. Если вы не хотите продолжать процесс отправки, нажмите кнопку Отмена отправки .

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

Рекомендации по исправлению ошибок в данных

Этот раздел содержит справку по исправлению данных в отправленном исходном файле, который вызывает ошибки проверки.

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

Правила для заголовков полей

Все имена заголовков полей или столбцов должны:

  • Начните с буквы (а не цифры).
  • Содержат только буквенно-цифровые символы (буквы и цифры, например Date1).
  • Не имеют начальных или конечных пустых пробелов или специальных символов (не буквенно-цифровых, например @, #, %, ). &
Правила для значений полей

Значения полей в строках данных должны соответствовать следующим правилам форматирования:

  • Значения полей EffectiveDate и HireDate должны быть в формате ММ/ДД/ГГГГ.
  • Обязательные значения полей PersonId и ManagerId должны быть допустимым адресом электронной почты (например, gc@contoso.com).
  • Значения полей слоя должны содержать только числа.
  • Значения поля HourlyRate должны содержать только числа, которые приложение предполагает, что для вычислений и анализа данных используются в долларах США.

Примечание.

В настоящее время приложение не выполняет конвертацию валюты для данных HourlyRate . Все вычисления и анализ данных предполагают, что данные будут в долларах США.

Правила для символов в значениях полей

Следующие правила полей применяются к символам в значениях полей:

  • В значениях полей разрешены двубайтовые символы, например японские символы.
  • Максимальная длина символов значений полей в строках составляет 128 КБ, что составляет около 1024 x 128 символов.
  • Символы "Новая строка" (\n) не допускаются в значениях полей.

Подготовка данных организации