Как импортировать данные

Вы можете импортировать данные, которые хранятся где-либо еще, в свое приложение на основе модели с помощью функции импорта в Power Apps.

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

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

Если вы опытный пользователь и знаете, какие столбцы необходимы для данной таблицы Dataverse, определите собственный исходный файл Excel, CSV или XML, а затем выполните действия, описанные в этой статье о том, как импортировать данные в ваше приложение. Поддерживаются следующие форматы файлов.

• Книга Excel (XLSX)
• Значения, разделенные запятыми (CSV)
• Таблица XML 2003 (XML)

Максимальный допустимый размер ZIP-файлов составляет 32 МБ. Для прочих форматов файлов максимальный разрешенный размер составляет 8 МБ.

Загрузка шаблона Excel

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

1. Откройте свое приложение и в левой части навигации выберите таблицу.

2. На панели команд выберите Шаблоны Excel>Загрузить шаблон.

3. Выберите тип таблицы и представление для загрузки или выберите Редактировать столбцы и выберите строки для включения в шаблон.

4. Выберите Загрузить.

   

Импорт данных

Используйте шаблон, который вы загрузили на предыдущем шаге (измененный с вашими данными), и импортируйте файл в свое приложение.

1. Откройте приложение и в левой части навигации выберите таблицу.

   

2. В строке команд выберите тип файла для импорта:

   • Импорт из Excel: выберите Импорт из Excel, если вы используете шаблон Excel.
   • Импорт из CSV-файла
   • Импорт из XML-файла

   

3. Выберите Выбрать файл и укажите папку, где сохранен файл. Выберите файл, щелкните Открыть и Далее.

   Совет

   Одновременно можно импортировать только один файл. Чтобы добавить файлы, запустите мастер еще раз.

4. Выберите, следует ли Разрешить дубликаты. Дополнительные сведения см. в Настройка правил поиска повторяющихся данных для поддержки правильности данных.

5. Для файлов CSV и XML (пропустите этот шаг, если вы импортируете файл Excel):

   • Для CSV-файла: выберите раскрывающийся список и выберите разделитель данных и разделитель полей, который используется для CSV-файла.

   • Для файла CSV или XML: если определен альтернативный ключ, выберите его в раскрывающемся списке "Альтернативный ключ". Альтернативный ключ используется для уникальной идентификации и обновления строк во время импорта. Дополнительные сведения: Определение альтернативных ключей для ссылки на строки.

     

6. Выберите Проверить сопоставление и убедитесь, что столбцы (поля) правильно сопоставлены. Если все правильно, выберите Завершить импорт.

   

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

   

Проверить сопоставление

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

Условные обозначения:

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

2. Сопоставленные столбцы: правильно сопоставленные столбцы отмечены зеленой галочкой.

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

4. Несопоставленные столбцы: если заголовки столбцов не совпадают, несопоставленные столбцы помечаются красным восклицательным знаком. Чтобы правильно сопоставить столбец, выберите столбец для сопоставления с несопоставленным заголовком столбца вашего файла.

5. Игнорировать (только для необязательных полей): выберите Игнорировать в раскрывающемся списке. Данные из проигнорированных столбцов не импортируются в ваше приложение.

Option set

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

Для этого нажмите кнопку рядом со столбцом набора параметров, выберите значения, а затем выберите ОК.

Раскрывающийся список значений параметров объединяет значения, доступные во входящем файле, со значениями, уже имеющимися в вашем приложении. Например:

• Значения в импортируемом файле: Низкая, Высокая
• Значения, уже имеющиеся в приложении: Холодно, Тепло, Горячо
• Получающиеся целевые значения: Холодно, Тепло, Горячо, Низкая, Высокая

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

Примечание

Столбец в исходном файле можно сопоставить с столбцом "Два параметра" или "Набор параметров с несколькими выборами". При сопоставлении с набором параметров multiselect, если исходный файл содержит значения, недоступные в приложении, новые значения могут быть созданы в Dataverse, если сопоставление импорта имеет значение NotMapped. Если для сопоставления задано значение "Игнорировать", запись может быть успешно импортирована. И для полей "Набор параметров с несколькими выборами" значения не импортируются, а новые значения не создаются в целевой среде.

Сопоставление столбцов подстановки

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

Например, может потребоваться импортировать файл с именем Leads.csv, содержащий строки клиентов. Столбец Клиент в файле Leads.csv содержит связанные данные организаций или контактов. Для сопоставления выберите кнопку Ссылка подстановки рядом со столбцом подстановки. Открывается раздел Ссылка подстановки, в котором перечислены таблицы, связанные с текущей таблицей.

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

Сохранение параметров сопоставления

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

Открытие журнала импорта

После запуска импорта вы можете отслеживать состояние задания импорта и просматривать результаты в журнале импорта.

На последнем этапе мастера импорта выберите Отслеживать ход выполнения, чтобы просмотреть ход выполнения задания импорта.

Если вы пропустили этот шаг, добавьте следующий код к URL-адресу вашего приложения: &newWindow=true&pagetype=entitylist&etn=importfile&viewid=a2927069-e4dc-4e8f-8fb1-d2f6c40c427e&viewType=1039.

Например, если URL-адрес вашего приложения — https://org12345.crm.dynamics.com/main.aspx?appid=00001111-aaaa-2222-bbbb-3333cccc4444, то URL-адрес для просмотра журнала импорта — https://org12345.crm.dynamics.com/main.aspx?appid=00001111-aaaa-2222-bbbb-3333cccc4444&newWindow=true&pagetype=entitylist&etn=importfile&viewid=a2927069-e4dc-4e8f-8fb1-d2f6c40c427e&viewType=1039.

Просмотр статуса импорта и исправление ошибок

После завершения импорта можно просмотреть, какие записи успешно импортированы, а какие не были импортированы или были импортированы частично.

1. Откройте журнал импорта.

2. На странице Мои задания импорта следите за ходом выполнения импорта.

   В столбце Состояние отображается состояние импорта. Состояние выполнения обозначается следующими значениями:

   • Отправлено
   • Анализ
   • Преобразование
   • Импорт
   • Завершено

   Примечание

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

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

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

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

6. На вкладке Сбои экспортируйте строки, которые не удалось импортировать, в новый файл. Выберите Экспортировать строки ошибок.

7. Исправьте ошибки в этом файле и импортируйте его.

Удаление импортированных записей

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

1. Откройте журнал импорта.

2. Выберите импортируемый файл, которую нужно удалить, и выполните одно из следующих действий:

   • Удалить исходный файл импорта. Этот параметр удаляет файл журнала импорта и его сведения.

   • Удалить импортированные записи. Удаляются все записи, которые были импортированы из выбранного файла.

   • Удалить все. Удаляется импортируемый файл вместе с записями, которые были импортированы из этого файла.

Ограничения

• Импорт Excel не поддерживается с виртуальными таблицами или эластичными таблицами
• При импорте из Excel обновляются поля из основной таблицы, однако поля из связанных таблиц игнорируются.
• Задания импорта Excel выполняются параллельно, только если размер файла составляет менее 1 МБ. Файлы размером более 1 МБ обрабатываются последовательно, чтобы избежать исчерпания ресурсов.

Примечание

Чтобы включить параллельную обработку, сохраните каждый файл до 1 МБ. Для .zip файлов распакованный размер также должен быть менее 1 МБ. Обратите внимание, что файлы со специальными символами могут иметь вычисляемый размер, превышающий 1 МБ, даже если исходный файл отображается меньше.

См. также

Загрузка шаблона для импорта данных