Импорт и экспорт списков магазинов для приложения MSI/EXE

  • Статья

Вместо ввода сведений о списке в Магазине непосредственно в Центре партнеров у вас есть возможность добавлять или обновлять сведения, экспортируя их в файл .csv, вводя сведения и ресурсы, а затем импортируя обновленный файл. Этот метод можно использовать для создания списков с нуля или для обновления уже созданных списков.

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

Экспорт списка

На странице описания Магазина для приложения можно добавить языки, а затем щелкнуть "Экспорт", чтобы создать файл .csv с выбранными языками и полями для списка. Кроме того, можно сначала щелкнуть список экспорта, а затем выбрать языки. После успешного экспорта списка скачайте список. В экспортируемом списке вы увидите имена полей, введите и языки, выбранные для списка.

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

  • Столбец "Поле" содержит имя, связанное с каждой частью списка Магазина. Они соответствуют тем же элементам, которые можно указать при создании списков в Центре партнеров, хотя некоторые имена немного отличаются. Для элементов, в которых можно ввести несколько элементов одного типа, вы увидите несколько строк до максимального числа, которое можно указать. Например, для функций продукта вы увидите ProductFeatures1, ProductFeatures2 и т. д., перейдя к ProductFeatures20 (так как вы можете предоставить до 20 функций приложения). См. таблицу ниже, чтобы найти точное сопоставление полей списка Магазина с полями, экспортированными в .csv файле.
  • Столбец "Тип" содержит общие рекомендации по типу сведений, предоставляемых для этого поля, например "Текст" или "Относительный путь".
Имя поля в списке Магазинов в Центре партнеров Соответствующее имя поля в экспортируемом файле .csv
Description Description
Название продукта НаименованиеПродукта
Новые возможности этой версии? WhatsNew
Возможности продукта ProductFeatures1 to ProductFeatures20
Снимки экрана Снимки экрана1 на снимки экрана10
Логотипы магазина (1:1 прямоугольник) StoreLogos1
Логотипы магазина (искусство плаката 2:3) StoreLogos2
Краткое описание ShortDescription
Минимальные требования к оборудованию ТребованияMinimum1 к требованиямMinimum11
Рекомендуемое оборудование RequirementsRecommended1 to RequirementsRecommended11
Условия поиска SearchTerms1 в SearchTerms7
Сведения об авторских правах и товарных знаках Авторские права
Применимые условия лицензии Применимые условия лицензии
Разработано DevelopedBy

Внимание

Не изменяйте имена полей или не удаляйте какие-либо поля в экспортируемом .csv файле. Имя столбцов и элементов в поле должно оставаться неизменным для обработки импортированного файла.

Обновление сведений о списке

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

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

Для многих полей в экспортированных списках требуется запись текста, например те, которые приведены в приведенном выше примере, Description и WhatsNew. Для этих типов полей просто введите соответствующий текст в поле для каждого языка. Обязательно следуйте инструкциям по длине и другим требованиям для каждого поля. Дополнительные сведения об этих требованиях см. в статье "Создание списков в Магазине приложений".

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

Совет

Если ресурсы (снимок экрана или логотип) находятся в той же папке, что и экспортируемый файл .csv, относительный путь будет только именем снимка экрана или логотипа (например, logo.png). Если вы создали вложенную папку для изображений в главной папке с файлом .csv, относительный путь будет начинаться с имени вложенной папки. (Например, если имя вложенной папки — "Изображения", относительный путь будет иметь значение Images/logo.png)

Перечисление импорта

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

Когда вы будете готовы отправить обновленный файл .csv и импортировать данные о списке, выберите "Импорт списка" на странице описания Магазина приложения. При первом импорте списка необходимо отправить список с помощью папки, которая будет иметь экспортируемый файл .csv и все ресурсы. Убедитесь, что в папке есть только один .csv файл, а также все ресурсы, которые вы отправляете.

Внимание

При импорте списка в первый раз необходимо отправить папку. Эта папка должна содержать экспортируемый файл .csv со сведениями о списке и всеми ресурсами (снимками экрана и логотипом), упомянутыми в файле .csv.

Если мы обнаруживаем какие-либо проблемы, вы увидите примечание, указывающее, что сбой импорта. Скачайте отчет, чтобы проверить ошибки. Вам потребуется исправить эти проблемы в файле .csv (или заменить любые недопустимые ресурсы), а затем снова импортировать список.

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

Сообщение об ошибке Смысл и рекомендация
"Файл .csv пуст. Убедитесь, что файл содержит необходимые сведения". Возможно, вы добавили пустой файл .csv. На странице описания Магазина экспортируйте последний файл .csv.
"Поле отсутствует или недопустимо. Используйте правильный шаблон, экспортируя список". Возможно, вы удалили существующее поле или добавили новое поле в экспортированный файл .csv. Экспортируйте файл .csv с страницы описания в Магазине. Не изменяйте поля в файле .csv.
"Коды языка являются недопустимыми или не доступны для языков. Используйте последний шаблон, экспортируя список". Возможно, вы изменили языковой код в экспортируемом файле .csv или добавили новый языковой код, который отсутствует на странице описания в Магазине. На странице описания в Магазине выберите необходимые языки и экспортируйте список.
"Все выбранные языки не присутствуют в импортированном .csv файле. Используйте последний шаблон, экспортируя список". Возможно, вы удалили языковой код в файле .csv. Экспортируйте файл .csv с страницы описания в Магазине. Не изменяйте коды языка в файле .csv.

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