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

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

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

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

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

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

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

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

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

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

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

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

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

    Как загрузить шаблон Excel из вашего приложения.

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

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

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

    На карте сайта выберите таблицу.

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

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

    Показывает три варианта импорта в Power Apps.

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

    Совет

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

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

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

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

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

      Выбор альтернативных ключей.

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

    Импорт выбранного файла Excel и проверка сопоставления.

  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. В My Imports отслеживайте ход импорта.

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

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

    Примечание

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

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

  4. Выберите задание импорта для просмотра записей, которые не удалось импортировать или которые были импортированы частично. Снимок экрана: запись импорта со столбцами **Успешно**, **Сбои** и **Частичные сбои**.

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

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

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

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

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

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

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

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

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

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

Ограничения

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

Примечание

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

См. также

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