Структура вывода и именование приложений

Последнее обновление: 14.10.2026

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

Структура выходных данных

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

Сохранять иерархию (по умолчанию)

<outputDir>/
  <RelativePath>/
    <ProjectName>/
      build/
      images/
      reports/
      logs/

Выровнять иерархию (--batchFlatOutput)

<outputDir>/
  <ProjectName>/
    build/
    images/
    reports/
    logs/

Сохранение иерархии полезно, когда исходная структура папок отражает организационную группировку (по отделам, регионам или бизнес-подразделениям) и выходная структура должна ее повторять. Преобразование иерархии в плоскую структуру полезно, когда структура папок не имеет значения или когда на последующих этапах удобнее работать с плоским списком.

Если два проекта создают одинаковое имя выходной папки (например, два проекта с именем Sales в разных подкаталогах), QV2QS добавляет _2, _3 и последующие номера, чтобы избежать конфликтов.

Настройки в пакетном режиме

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

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

Рекомендуемый рабочий процесс для пакетного преобразования:

1. Скопируйте все исходные файлы QVW и QVF в локальную рабочую папку. Не выполняйте пакетную конвертацию для рабочих каталогов или сетевых ресурсов.
2. Определите группы приложений QlikView со схожими характеристиками макета (разрешение, фоновые изображения, плотность объектов).
3. Загрузите типовое приложение из каждой группы в режиме одного проекта.
4. Откройте Mockup Studio и поэкспериментируйте с настройками фиксированного холста, масштабирования, обрезки и ограничений размера, пока макет вас не устроит.
5. Зафиксируйте настройки, обеспечивающие наилучший результат для этой группы.
6. Переключитесь в пакетный режим, укажите папку, содержащую эту группу, и примените те же настройки.
7. Повторите для каждой группы приложений.

Этот подход позволяет избежать распространенной ошибки — запуска большого пакета с общими настройками и последующей траты времени на ручную настройку отдельных приложений. Несколько минут тестирования в Mockup Studio на репрезентативной выборке могут сэкономить значительные усилия при обработке большой партии.

Именование приложений в пакетном режиме

При развертывании пакетных преобразований в Qlik Cloud --qsAppName определяет, как именуется каждое приложение:

• Не указано — Каждое приложение называется так же, как проект (<Name>).
• Обычный текст — Значение используется в качестве префикса: <prefix> - <Name>.
• Шаблон с заполнителями — значение рассматривается как строка формата.

В строках шаблонов доступны следующие плейсхолдеры.

Например, --qsAppName "Migrated {name} ({rel})" создает такие названия приложений, как Migrated Sales (region1/finance).

Подробнее

• Параллельное выполнение
• Пакетная отчетность
• Справочник по аргументам