Правила файлов и ошибки проверки

  • Статья

В этой статье описано, как нужно отформатировать файл отправки, а также приведены ошибки, с которыми вы можете столкнуться при переносе данных в приложение advanced insights.

Правила файлов и полей

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

Правила для файла

Файл данных должен быть в формате .csv UTF-8, и он не может быть пустым.

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

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

  • Содержат только буквенно-цифровые символы ASCII (буквы и цифры, например Date1) или символы подчеркивания (_). Другие символы не поддерживаются.
  • Содержат значение.
  • Отсутствуют начальные, средние или конечные пробелы, а также специальные буквенно-цифровые символы, такие как @, #, %, или &.
  • Будьте уникальными.
  • Не содержат системных полей, а именно:
    • PeopleHistoricalId
    • StartDate
    • EndDate
    • Домен
    • PopulationType
    • TimeZone
    • StandardTimeZone
    • WorkdayStart
    • WorkDayEnd
    • Выходные дни
    • InferredTeamSize
    • ObjectId
    • Microsoft_

Обязательные поля должны иметь значение для каждой строки.

После отправки файла можно сопоставить только один заголовок столбца с каждым Viva Insights полем данных.

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

Значения полей должны быть указаны в правильном типе данных. См. ссылку на атрибуты.

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

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

Примечание.

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

Правила для значений в поле ManagerId

Каждый идентификатор PersonId должен иметь уникальный идентификатор ManagerId. Другими словами, на одного человека не может быть несколько руководителей.

Не может быть циклов, где:

  • Руководители и сотрудники отчитываются друг перед другом.
  • Руководители отчитывают сотрудников.

Предположим, Дилан является менеджером Криса. Не удалось отобразить данные организации:

  • Крис сообщает Дилану, а также Дилан сообщает Крису.
  • Дилан сообщает Крису.

Обе следующие иерархии могут привести к ошибкам в взаимодействии с конечными пользователями:

Снимок экрана: цикл иерархии менеджера между тремя людьми.

Пример файла экспорта .csv

Ниже приведен пример фрагмента допустимого файла экспорта .csv:

PersonId,EffectiveDate,HireDate,ManagerId,LevelDesignation,Organization,Layer,Area Emp1@contoso.com,12/1/2020,1/3/2014,Mgr1@contoso.com,Junior IC,Sales,8,Southeast Emp2@contoso.com,11/1/2020,1/3/2014,Mgr1@contoso.com,Junior IC,Sales,8,Southeast Emp3@contoso.com,12/1/2020,1/3/2014,Mgr2@contoso.com,Manager,Sales,7,Northeast Emp4@contoso.com,10/1/2020,8/15/2015,Mgr3@contoso.com,Support,Sales,9,Midwest Emp5@contoso.com,11/1/2020,8/15/2015,Mgr3@contoso.com,Support,Sales,9,Midwest Emp6@contoso.com,12/1/2020,8/15/2015,Mgr3@contoso.com,Support,Sales,9,Midwest

Ошибки проверки

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

Категория Связанное правило Сообщение Сфера применения
Расширения файлов и файлов Файл данных должен быть в формате .csv UTF-8, и он не может быть пустым. Файл пуст. Выберите другой файл и отправьте еще раз. .csv только отправка
Этот файл имеет недопустимое расширение "{0}". Выберите файл .csv и отправьте еще раз. .csv только отправка
Недопустимый формат .csv. Число столбцов в строке не соответствует количеству столбцов в заголовке. Пожалуйста, проверка за отсутствующие или неуместные запятые и отправьте еще раз. Все
Найден символ, отличный от UTF-8. Убедитесь, что файл .csv использует кодировку UTF-8, и отправьте его еще раз. Все
Заголовки столбцов Все имена заголовков полей или столбцов должны быть уникальными. Два или более заголовков столбцов в файле одинаковы. Включите уникальные заголовки для каждого столбца. Все
Все имена заголовков полей или столбцов должны содержать значение. Заголовок отсутствует в столбцах {J}. Добавьте имя заголовка в выбранный файл и отправьте еще раз. Все
Все имена заголовков полей или столбцов должны содержать только буквенно-цифровые символы (буквы и цифры, например , Date1) или следующие символы: ~ ! @ # $ % ^ & * + > : <> [] ?. Другие символы не поддерживаются {Header name} содержит неподдерживаемые специальные символы. Удалите специальные символы и отправьте их еще раз.
Все имена заголовков полей или столбцов не должны содержать системные поля. {header name} — системное поле. Переименуйте {header name} так, чтобы оно не использовало системное поле, и отправьте файл еще раз. Все
После отправки файла можно сопоставить только один заголовок столбца с каждым Viva Insights полем данных. Файл содержит несколько исходных столбцов, сопоставленных с полем данных. Убедитесь, что каждый исходный столбец сопоставлен с уникальным полем. Все
Значения полей Значения полей должны быть указаны в правильном типе данных. См. ссылку на атрибуты. Недопустимое значение {header name}. {Header name} должен быть адресом электронной почты после формы employee@contoso.com. Все
Недопустимое значение {header name}. {Header name} должен быть строкой. Все
Недопустимое значение {header name}. {Имя заголовка} должно быть датой, следующей за формой ММ/ДД/ГГГГ. Все
Недопустимое значение {header name}. {Имя заголовка} должно быть двойным, следующим за формой 23.75. Все
Недопустимое значение {header name}. {Header name} должно быть целым числом. Все
Обязательные поля должны иметь значение для каждой строки. Отсутствует столбец {header name} или {header name}. {Имя заголовка} является обязательным полем, которому требуется значение для каждой строки. Добавьте значение {header name} и отправьте файл еще раз. Все
Отсутствует значение ManagerId для нового поля PersonId. Поле ManagerId является обязательным. Добавьте соответствующее поле ManagerId и отправьте еще раз. Все
Каждый идентификатор PersonId должен иметь уникальный идентификатор ManagerId. Все
Не может быть циклов, где:
  • Руководители и сотрудники отчитываются друг перед другом.
  • Руководители отчитывают сотрудников.
 Все