Relatórios tabulares em espaços gerenciados

Você pode gerar relatórios tabulares para aplicativos que exigem governança de dados rigorosa. Com os mesmos princípios usados para desenvolver modelos de dados de aplicativos para uso em espaços gerenciados, você pode preparar seu aplicativo para recursos de relatórios no aplicativo. Isso é conseguido usando a sintaxe com reconhecimento de espaço no script de carregamento.

Ao desenvolver um aplicativo em preparação para publicação em um espaço gerenciado, considere o seguinte:

• O modelo pode ser desenvolvido antes ou depois da publicação do aplicativo. Se você criar o modelo antes da publicação, use o complemento para alterar o ID do aplicativo conectado após a publicação.

• Uma lista de distribuição deve ser adicionada ao aplicativo antes de publicá-lo. Durante o desenvolvimento, isso pode consistir em fontes de dados simuladas, em vez de fontes de dados reais. As fontes na lista de distribuição são referenciadas no script de carregamento, portanto, o script deve ser escrito em preparação para publicação, usando sintaxe com reconhecimento de espaço. Essa sintaxe é usada automaticamente por padrão se você fizer upload de uma lista de distribuição como um arquivo de origem.

• Após a publicação, os ativos de relatório (modelo, filtros e tarefas de relatório) podem ser recriados conforme desejado, com base no caso de uso de relatório do aplicativo publicado. As fontes de dados reais utilizadas na lista de distribuição devem ser adicionadas ao espaço gerenciado.

Configurações de relatório tabular existentes

Se você criou uma configuração de relatórios e uma lista de distribuição antes de 26 de março de 2024, precisará estar ciente das alterações no processo de upload de arquivos para listas de distribuição.

Para aplicativos criados antes de 26 de março de 2024, um arquivo de origem da lista de distribuição carregado na seção Relatórios foi automaticamente renomeado e adicionado ao espaço. A referência a esse arquivo renomeado foi adicionada automaticamente ao script de carregamento. O arquivo de origem carregado não é mais renomeado quando adicionado ao espaço.

Para continuar usando as configurações de relatório existentes ao publicar esses aplicativos, siga a seção correspondente abaixo, dependendo das fontes da sua lista de distribuição. Como alternativa, recrie sua configuração de relatórios do zero, usando os guias mostrados posteriormente nesta página.

Se você tiver carregado um arquivo de origem

Abra o Editor da carga de dados e observe as referências de nome de arquivo na seção de script da Lista de Distribuição. Ajuste a sintaxe para que eles usem uma referência com reconhecimento de espaço apontando para o espaço atual, em vez de qualquer espaço específico. Por exemplo, uma referência de arquivo pode ser semelhante a:

FROM "lib://DataFiles/reporting_source_your_app_ID.xlsx"

Altere isso para:

FROM "lib://:DataFiles/reporting_source_your_app_ID.xlsx"

Você pode ver que o ID do aplicativo de origem está contido no nome do arquivo. Se você quiser que esse script exato seja executado ao publicar o aplicativo, adicione seu arquivo de lista de distribuição real ao espaço gerenciado, com esse nome exato.

Alternativamente, você pode renomear o arquivo de origem no espaço de desenvolvimento, atualizar o script de carregamento e depois publicar. Por fim, adicione o arquivo da lista de distribuição real, com o nome atualizado.

Se você usou fontes de dados remotas manualmente no script

Se, em vez disso, você configurou manualmente o script de carregamento para contar com outras fontes de dados para a lista de distribuição, basta ajustar o script de carregamento para conter referências relativas e com reconhecimento de espaço às fontes de dados (se isso ainda não tiver sido feito).

Para obter mais informações e exemplos específicos, consulte Fontes de dados para aplicativos em espaços gerenciados.

Fluxo de trabalho

Siga a sequência abaixo para trabalhar com relatórios tabulares em um espaço gerenciado.

Desenvolvimento de aplicativos

Desenvolva o aplicativo em seu espaço de desenvolvimento (espaço pessoal ou compartilhado), como faria normalmente, em preparação para publicá-lo no espaço gerenciado.

Desenvolver o modelo e os filtros

Se desejar, você pode criar o modelo de relatório e os filtros antes de publicar o aplicativo. Isso pode ser útil como um estágio no desenvolvimento do aplicativo, mas os modelos e filtros adicionados ao aplicativo de origem não são retidos na cópia publicada.

Se você criar o modelo antes de publicar e quiser usá-lo para o aplicativo publicado, use o recurso Alterar conexão do modelo no suplemento para alterar o ID do aplicativo conectado. Consulte Alterar a conexão do modelo.

Prepare a referência da lista de distribuição

Quando você adiciona uma lista de distribuição a um aplicativo, o script de carregamento do aplicativo é alterado. O script de carregamento de um aplicativo não está acessível em um aplicativo publicado. Portanto, você precisa adicionar uma lista de distribuição ao aplicativo antes de publicá-lo.

Neste estágio, a lista de distribuição precisa simplesmente ser um espaço reservado para o arquivo real ou outras fontes que você usará para a lista de distribuição no espaço gerenciado.

O procedimento é um pouco diferente, dependendo se a sua lista de distribuição é um arquivo de origem ou uma fonte de dados remota adicionada manualmente no script. No entanto, os conceitos subjacentes são os mesmos. Para obter um guia completo que descreve como usar a sintaxe com reconhecimento de espaço no script de carregamento, consulte Fontes de dados para aplicativos em espaços gerenciados.

Opção 1: upload direto do arquivo de origem

Siga o procedimento normal para carregar um arquivo de origem como lista de distribuição: Adicionando a lista de distribuição carregando um arquivo de origem.

Em vez de adicionar os detalhes finalizados do destinatário, você pode inserir os marcadores desejados. O importante aqui é que você carregue um arquivo e que esse arquivo seja automaticamente adicionado ao espaço de desenvolvimento e referenciado no script.

Você pode verificar se a seção Distribution List no script de carregamento contém uma referência com reconhecimento de espaço para o arquivo e não faz referência direta a nenhum espaço específico. Isso é feito automaticamente quando você carrega um arquivo de origem como uma lista de distribuição na seção Relatórios do aplicativo. Deve ser algo assim:

FROM "lib://:DataFiles/My_App_Distribution_List.xlsx"

Este exemplo é uma referência com reconhecimento de espaço que aponta para o espaço atual no qual o aplicativo está localizado. Os dois pontos extras antes de DataFiles fornecem a referência relativa necessária.

Posteriormente, ao publicar o aplicativo no espaço gerenciado, carregue o arquivo da lista de distribuição real no espaço gerenciado. A lista de distribuição real deve ter o mesmo nome de arquivo do arquivo referenciado no script.

Opção 2: Referência manual a fontes de dados no script

Siga o procedimento normal para conectar-se manualmente a fontes de lista de distribuição remota em seu script: Definindo a lista de distribuição manualmente no script de carregamento.

Ao escrever o script para conectar-se às fontes de dados necessárias para sua lista de distribuição, você pode usar referências simuladas aos arquivos e conexões conforme necessário. No seu script, as fontes de dados simplesmente precisam ter os mesmos nomes que terão no espaço gerenciado, e as referências a essas fontes precisam usar sintaxe relativa e com reconhecimento de espaço.

Publicar o aplicativo

Depois de preparar o script de carregamento e a lista de distribuição, o aplicativo estará pronto para ser publicado no espaço gerenciado. Para obter mais informações sobre a publicação de um aplicativo, consulte Publicando aplicativos.

Alterar a conexão do modelo

Se você criou um modelo de relatório antes de publicar o aplicativo, será necessário atualizar o modelo para fazer referência ao ID correto do aplicativo. Uma cópia publicada de um aplicativo terá um ID de aplicativo diferente do aplicativo de origem.

Esse processo é concluído no suplemento Qlik para o Microsoft Excel. Antes de começar, você pode criar uma cópia separada do modelo para diferenciá-lo do modelo do aplicativo de origem.

Para obter instruções completas, consulte Alterando o aplicativo Qlik Sense conectado.

Se, em vez disso, você publicou o aplicativo antes de criar o modelo, agora poderá criar um novo modelo e conectá-lo ao aplicativo de espaço gerenciado.

Adicione as fontes reais da lista de distribuição

No espaço gerenciado, crie os arquivos e conexões necessários para carregar sua lista de distribuição, conforme referenciado no script de carregamento. Esta etapa pode ser concluída a qualquer momento.

As fontes de dados que fornecem a lista de distribuição devem conter os mesmos nomes de parâmetros (nomes de conexões, arquivos e campos) que as fontes da lista de distribuição usadas no script de carregamento do aplicativo de origem.

Quando as fontes conectadas forem adicionadas ao espaço, você poderá recarregar o aplicativo.

Crie os novos ativos de relatório

Agora você pode adicionar ativos de relatórios ao aplicativo. Isso consistirá no modelo, filtros e tarefas de relatório.

Permissões

Os usuários com qualquer uma das seguintes funções no espaço gerenciado podem trabalhar com relatórios tabulares para o aplicativo:

• Proprietário

• Pode gerenciar

• Pode operar (Direito de usuário Professional ou Full User apenas)

Para obter mais informações, consulte Gerenciando permissões em espaços gerenciados.

Limitações