Правила файлов и ошибки проверки
В этой статье описано, как нужно отформатировать файл отправки, а также приведены ошибки, с которыми вы можете столкнуться при переносе данных в приложение advanced insights.
Правила файлов и полей
Если какая-либо строка или столбец данных имеет недопустимое значение для любого атрибута, вся отправка может завершиться ошибкой или выдавать предупреждения в зависимости от того, включена или отключена отправка допустимых строк и исключений строк с недопустимыми данными в расширенной конфигурации .
Если параметр Отправить допустимые строки и исключить строки с недопустимыми данными в расширенной конфигурации отключен, вся отправка завершается ошибкой из-за ошибок проверки до тех пор, пока исходный файл не будет исправлен (или сопоставление не изменит тип проверки атрибута таким образом, чтобы сделать значение допустимым).
Если включен параметр Отправить допустимые строки и исключить строки с недопустимыми данными в разделе Расширенная конфигурация , будут отправлены только строки, включающие допустимые значения, и будут отображаться предупреждения для строк, которые не были приема из-за ошибок. Этот параметр отключен по умолчанию.
Правила для файла
Файл данных должен быть в формате .csv UTF-8, и он не может быть пустым.
Правила для заголовков исходного и целевого полей
Все имена заголовков и столбцов исходного и целевого полей должны:
- Содержат только буквенно-цифровые символы ASCII (буквы и цифры, например Date1) или символы подчеркивания (_). Специальные неальфакнумерные символы, такие как @, #, %, & или другие символы, не поддерживаются.
- Содержат значение.
- Будьте уникальными.
Правила для заголовков пользовательских целевых полей
Все заголовки пользовательских целевых полей или имена столбцов должны:
- Отсутствуют начальные, средние или конечные пробелы.
- Не содержат системных полей, а именно:
- PeopleHistoricalId
- StartDate
- EndDate
- Домен
- PopulationType
- TimeZone
- StandardTimeZone
- WorkdayStart
- WorkDayEnd
- Выходные дни
- InferredTeamSize
- ObjectId
- IsActive
- Начиная с "Microsoft_"
- MetricDate
- PrimaryCollaborator_PersonId
- SecondaryCollaborator_PersonId
Обязательные поля должны иметь значение для каждой строки.
После отправки файла можно сопоставить только один заголовок столбца с каждым 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 только отправка | ||
| Файл данных для импорта на основе API и импорта BLOB-объектов Azure должен быть в формате .zip и содержать один .csv файл в формате UTF-8 и один файл сопоставления .json. Файлы не могут быть пустыми. | Проблема с файлами в файле .zip. Убедитесь, что файл .zip содержит только один .json файл и один .csv файл, и отправьте его еще раз. | Импорт на основе API и импорт BLOB-объектов Azure | |
| Файл .csv в файле .zip пуст. Добавьте непустый файл .csv и отправьте файл .zip еще раз. | Импорт на основе API и импорт BLOB-объектов Azure | ||
| Файл .json в файле .zip пуст. Добавьте непустой файл .json и отправьте файл .zip еще раз. | Импорт на основе API и импорт BLOB-объектов Azure | ||
| Недопустимый файл .json. Используйте допустимый файл .json и отправьте файл .zip еще раз. | Импорт на основе API и импорт BLOB-объектов Azure | ||
| Заголовки столбцов | Все имена заголовков полей или столбцов должны быть уникальными. | Два или более заголовков столбцов в файле одинаковы. Включите уникальные заголовки для каждого столбца. | Все |
| Все имена заголовков полей или столбцов должны содержать значение. | Заголовок отсутствует в столбцах {J}. Добавьте имя заголовка в выбранный файл и отправьте еще раз. | Все | |
| Файл .csv сопоставляется с пустым или пустым полем в файле .json. Сопоставьте его с пустым полем и отправьте файл .zip еще раз. | Импорт на основе API и импорт BLOB-объектов Azure | ||
| Все имена заголовков полей или столбцов должны содержать только буквенно-цифровые символы (буквы и цифры, например , Date1) или следующие символы: ~ ! @ # $ % ^ & * + > : <> [] ?. Другие символы не поддерживаются | {Header name} содержит неподдерживаемые специальные символы. Удалите специальные символы и отправьте их еще раз. | ||
| Все имена заголовков полей или столбцов не должны содержать системные поля. | {header name} — системное поле. Переименуйте {header name} так, чтобы оно не использовало системное поле, и отправьте файл еще раз. | Все | |
| После отправки файла можно сопоставить только один заголовок столбца с каждым Viva Insights полем данных. | Файл содержит несколько исходных столбцов, сопоставленных с полем данных. Убедитесь, что каждый исходный столбец сопоставлен с уникальным полем. | Все | |
| Имена заголовков в файле .csv не соответствуют полям, сопоставленным в файле .json. Убедитесь, что файл .json содержит те же поля, что и файл .csv, и отправьте файл .zip еще раз. | Импорт на основе API и импорт BLOB-объектов Azure | ||
| Количество заголовков в файле .csv не соответствует полям, сопоставленным в файле .json. Убедитесь, что файл .json содержит те же поля, что и файл .csv, и отправьте файл .zip еще раз. | Импорт на основе API и импорт BLOB-объектов Azure | ||
| Все исходные столбцы должны быть сопоставлены с поддерживаемым типом данных | Исходный столбец не сопоставлен с поддерживаемым типом данных. Сопоставьте с поддерживаемым типом данных и отправьте файл еще раз. | Импорт на основе API и импорт BLOB-объектов Azure | |
| Файл .json указывает значение DatasetType, которое не ожидается. Укажите правильное значение и отправьте файл .zip еще раз. | Импорт на основе API и импорт BLOB-объектов Azure |
Ниже приведены ошибки проверки и предупреждения, связанные со значениями полей. Если параметр Отправить допустимые строки и исключить строки с недопустимыми данными в разделе Расширенная конфигурация отключен, это приведет к ошибкам и сбою проверки. Если она включена, она будет передавать только строки, которые содержат допустимые значения, и будет отображать предупреждения для строк, которые не были приема из-за ошибок. Этот параметр отключен по умолчанию.
| Категория | Связанное правило | Сообщение | Ошибка или предупреждение | Сфера применения |
|---|---|---|---|---|
| Значения полей | Файл данных должен быть в формате .csv UTF-8. | Недопустимый формат .csv. Число столбцов в строке не соответствует количеству столбцов в заголовке. Пожалуйста, проверка за отсутствующие или неуместные запятые и отправьте еще раз. | Error | Все |
| Недопустимый формат .csv. Число столбцов в строке не соответствует количеству столбцов в заголовке. Строки с недопустимыми значениями не отправляются. Пожалуйста, проверка за отсутствующие или неуместные запятые и отправьте еще раз. | Предупреждение | Все | ||
| Найден символ, отличный от UTF-8. Убедитесь, что файл .csv использует кодировку UTF-8, и отправьте его еще раз. | Error | Все | ||
| Найден символ, отличный от UTF-8. Строки с недопустимыми значениями не отправляются. Убедитесь, что файл .csv использует кодировку UTF-8, и отправьте его еще раз. | Предупреждение | Все | ||
| Значения полей должны быть указаны в правильном типе данных. См. ссылку на атрибуты. | Недопустимое значение {header name}. {Header name} должен быть адресом электронной почты после формы employee@contoso.com. |
Предупреждение | Все | |
{Header name} содержит недопустимое значение. Строки с недопустимыми значениями не отправляются. {Header name} должен быть адресом электронной почты после формы employee@contoso.com. |
Предупреждение | Все | ||
| Недопустимое значение {header name}. {Header name} должен быть строкой. | Error | Все | ||
| {Header name} содержит недопустимое значение. Строки с недопустимыми значениями не отправляются. {Header name} должен быть строкой. | Предупреждение | Все | ||
| Предупреждение | Все | |||
| Недопустимое значение {header name}. {Имя заголовка} должно быть двойным, следующим за формой 23.75. | Error | Все | ||
| {Header name} содержит недопустимое значение. Строки с недопустимыми значениями не отправляются. {Имя заголовка} должно быть двойным, следующим за формой 23.75. | Предупреждение | Все | ||
| Недопустимое значение {header name}. {Header name} должно быть целым числом. | Error | Все | ||
| {Header name} содержит недопустимое значение. Строки с недопустимыми значениями не отправляются. {Header name} должно быть целым числом. | Предупреждение | Все | ||
| Обязательные поля должны иметь значение для каждой строки. | Отсутствует столбец {header name} или {header name}. {Имя заголовка} является обязательным полем, которому требуется значение для каждой строки. Добавьте значение {header name} и отправьте файл еще раз. | Error | Все | |
| Отсутствует значение ManagerId для нового поля PersonId. Поле ManagerId является обязательным. Добавьте соответствующее поле ManagerId и отправьте еще раз. | Error | Все | ||
| Каждый идентификатор PersonId должен иметь уникальный идентификатор ManagerId. | Все | |||
Не может быть циклов, где:
|
Error | Все |