Estrutura de saída e nomenclatura do aplicativo

Última atualização: 14/10/2026

O QV2QS organiza a saída em lote em uma hierarquia de diretórios e fornece nomenclatura flexível de aplicativo para implementação no Qlik Cloud. Este tópico aborda opções de layout de diretório, recomendações de configurações e modelos de nomenclatura.

Estrutura de saída

Por padrão, o QV2QS espelha a hierarquia de diretórios de origem sob a raiz de saída. Cada projeto gera uma subpasta contendo a saída da compilação, relatórios e logs.

Preservar hierarquia (padrão)

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

Nivelar hierarquia (--batchFlatOutput)

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

Preservar a hierarquia é útil quando a estrutura de pastas de origem reflete agrupamentos organizacionais (por departamento, região ou unidade de negócios) e a saída deve espelhar essa estrutura. Nivelar a hierarquia é útil quando a estrutura de pastas não é relevante ou quando é mais fácil trabalhar com uma lista plana em etapas posteriores.

Se dois projetos gerarem o mesmo nome de pasta de saída (por exemplo, dois projetos chamados Sales em subdiretórios diferentes), o QV2QS acrescenta _2, _3 e números subsequentes para evitar colisões.

Configurações no modo em lote

Todas as configurações de conversão se aplicam uniformemente a todos os projetos do lote. Não há mecanismo para substituições por projeto. A escala fixa do canvas, a escala do objeto, as restrições de tamanho, as dimensões de recorte, a redução do layout, o tratamento do plano de fundo e todas as outras configurações são aplicadas de forma idêntica a cada aplicativo na execução.

Esta aplicação uniforme tem uma implicação prática importante: agrupe aplicações semelhantes ao executar conversões em lote. Aplicativos que compartilham resoluções de tela, layouts de imagem de plano de fundo e dimensionamento de objetos semelhantes funcionam bem em um único lote. Aplicativos com layouts ou padrões de design significativamente diferentes se beneficiam de execuções em lote separadas com configurações diferentes.

Fluxo de trabalho recomendado para conversão em lote:

1. Copie todos os arquivos QVW e QVF de origem para uma pasta de trabalho local. Não execute conversões em lote em diretórios de produção ou compartilhamentos de rede.
2. Identifique grupos de aplicativos QlikView que compartilham características de layout semelhantes (resolução, imagens de plano de fundo, densidade de objetos).
3. Carregue um aplicativo representativo de cada grupo no modo de projeto único.
4. Abra o Mockup Studio e experimente as configurações de canvas fixo, dimensionamento, recorte e restrição de tamanho até que o layout esteja satisfatório.
5. Anote as configurações que produzem o melhor resultado para esse grupo.
6. Alterne para o modo em lote, aponte para a pasta que contém esse grupo e aplique as mesmas configurações.
7. Repita para cada grupo de aplicativos.

Esta abordagem evita o erro comum de executar um grande lote com configurações genéricas e depois gastar tempo ajustando manualmente aplicativos individuais. Alguns minutos de testes no Mockup Studio com uma amostra representativa podem economizar um esforço significativo em um grande lote.

Nomeação de aplicativos no modo em lote

Ao implantar conversões em lote no Qlik Cloud, --qsAppName controla como cada aplicativo é nomeado:

• Não especificado — Cada aplicativo recebe o nome do projeto (<Name>).
• Texto simples — O valor é usado como prefixo: <prefix> - <Name>.
• Modelo com marcadores de posição — O valor é tratado como uma string de formato.

Os seguintes marcadores de posição estão disponíveis em strings de modelo.

Por exemplo, --qsAppName "Migrated {name} ({rel})" produz nomes de aplicativos como Migrated Sales (region1/finance).

Saiba mais

• Execução paralela
• Relatórios em lote
• Referência de argumentos