Правила файлов и ошибки проверки
В этой статье описано, как нужно отформатировать файл отправки, а также приведены ошибки, с которыми вы можете столкнуться при переносе данных в приложение 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 Аналитики.
Правила для значений полей
Значения полей должны быть указаны в правильном типе данных. См. ссылку на атрибуты.
Правила для символов в значениях полей
- Длина символов значений полей в строках не может превышать 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 Аналитики. | Файл содержит несколько исходных столбцов, сопоставленных с полем данных. Убедитесь, что каждый исходный столбец сопоставлен с уникальным полем. | Все | |
| Значения полей | Значения полей должны быть указаны в правильном типе данных. См. ссылку на атрибуты. | Недопустимое значение {header name}. {Header name} должен быть адресом электронной почты после формы employee@contoso.com. |
Все |
| Недопустимое значение {header name}. {Header name} должен быть строкой. | Все | ||
| Все | |||
| Недопустимое значение {header name}. {Имя заголовка} должно быть двойным, следующим за формой 23.75. | Все | ||
| Недопустимое значение {header name}. {Header name} должно быть целым числом. | Все | ||
| Обязательные поля должны иметь значение для каждой строки. | Отсутствует столбец {header name} или {header name}. {Имя заголовка} является обязательным полем, которому требуется значение для каждой строки. Добавьте значение {header name} и отправьте файл еще раз. | Все | |
| Отсутствует значение ManagerId для нового поля PersonId. Поле ManagerId является обязательным. Добавьте соответствующее поле ManagerId и отправьте еще раз. | Все | ||
| Каждый идентификатор PersonId должен иметь уникальный идентификатор ManagerId. | Все | ||
Не может быть циклов, где:
|
Все |