Botão - AJAX/Webview

Os botões podem ser usados no QlikView para executar comandos ou ações; por exemplo, exportar dados para arquivos, iniciar outros aplicativos ou executar macros.

Clique com o botão direito do mouse no objeto para exibir o Menu Objeto.

Botão: Menu Objeto

O menu do objeto pode ser aberto como um menu de contexto ao clicar com o botão direito em um objeto de pasta ou no ícone no título do objeto (se for mostrado).

Os comandos do menu podem variar dependendo se a Exibição na Web for utilizada a partir do QlikView ou se o documento for aberto em um navegador. O menu contém os seguintes comandos:

Propriedades do Botão

O diálogo Propriedades é aberto selecionando Propriedades no menu Objeto . Se o comando Propriedades estiver esmaecido, provavelmente você não possui os privilégios necessários para realizar alterações de propriedades.

Texto do Botão

Insira o texto que deve ser exibido no botão. O valor pode ser inserido como uma fórmula calculada. Clique em para abrir o diálogo Editar Expressão.

Ações

Para incluir uma ação, clique em . O pop-up Configuração da Ação para a nova ação é aberto instantaneamente. Também é possível selecionar uma ação na lista dropdown e clicar em para editar. O ícone move os itens na lista. O ícone remove os itens da lista.

Pop-up Configuração de Ações

• Tipo: Escolha um Tipo na lista suspensa.
• Subtipo: Escolha um Subtipo na lista suspensa. Os subtipos disponíveis dependem do Tipo de Ação escolhido.

Tipos de Ação e Ações

• Seleção

  • Selecionar no Campo: Seleciona os valores e campos especificados. Em Caracteres de Busca, você pode especificar uma máscara de pesquisa. Por exemplo, (A|B) selecionará tanto A quanto B.
  • Selecionar Excluídos: Seleciona os valores excluídos no campo especificado.
  • Selecionar Possíveis: Seleciona os possíveis valores no campo especificado.
  • Alternar Seleção: Alterna entre a seleção atual e a especificada Campo e Caracteres de Busca. Em Caracteres de Busca, você pode especificar uma máscara de pesquisa. Por exemplo, (A|B) selecionará tanto A quanto B.
  • Avançar: Avança um passo na lista de seleções.
  • Voltar: Retrocede um passo na lista de seleções.
  • Selecionar Pareto: Faz uma seleção de pareto no campo especificado com base em uma expressão e porcentagem. Esse tipo de seleção é usado para selecionar os principais colaboradores para uma lista, geralmente na linha de uma regra 80/20 geral. Por exemplo, para localizar os principais clientes que contribuem com 80% do movimento das vendas, deve-se utilizar Cliente como campo, sum(Turnover) deve ser usado como a expressão e 80 deve ser usado como a porcentagem.
  • Bloquear Campo: Trava as seleções no campo especificado.
  • Travar Tudo: Trava todos os valores em todos os campos.
  • Destravar Campo: Destrava as seleções no campo especificado.
  • Destravar Tudo: Destrava todos os valores em todos os campos.
  • Destravar e Limpar tudo: Desbloqueia todos os valores e limpa todas as seleções em todos os campos.
  • Limpar Outros Campos: Limpa todos os campos relacionados, exceto o especificado.
  • Limpar Tudo: Limpa todas as seleções, exceto as bloqueadas.
  • Limpar Campo: Limpa um campo específico.

• Layout

  • Ativar Objeto: Ativa o objeto especificado pelo ID do Objeto. Esse recurso não funciona no cliente Ajax.
  • Ativar Pasta: Ativa a pasta especificada pelo ID da Pasta.
  • Ativar Próxima Pasta: Abre a próxima pasta no documento.
  • Ativar Pasta Anterior: Abre a pasta anterior no documento.
  • Minimizar Objeto: Minimiza o objeto especificado pelo ID do Objeto.
  • Maximizar Objeto: Maximiza o objeto especificado pelo ID do Objeto.
  • Restaurar Objeto: Restaura o objeto especificado pelo ID do Objeto.

• Marcador

  • Aplicar Marcador: Aplica o marcador especificado pelo ID do Marcador. Se dois marcadores tiverem o mesmo ID, o marcador do documento será aplicado. Para aplicar o marcador de servidor, especifique IDdoservidor/marcador. 
  • Criar Marcador: Cria um marcador a partir da seleção atual. Especifique o ID do Marcador e o Nome do Marcador. Selecione Oculto para criar um marcador oculto.
  • Substituir Marcador: Substitui o marcador especificado pelo ID do Marcador com a seleção atual.

• Imprimir

  • Imprimir Objeto: Imprime o objeto especificado pelo ID do Objeto. Especifique o Nome da Impressora se o objeto tiver que ser enviado para outra impressora que não seja a padrão. (Não disponível como disparador de pasta e documento.)
  • Imprimir Pasta: Imprime a pasta especificada pelo ID da Pasta. (Não disponível como disparador de pasta e documento.) Esse recurso não funciona no cliente AJAX.
  • Imprimir Relatório: Imprime o relatório especificado pelo ID do Relatório. Especifique o Nome da Impressora se o relatório tiver que ser enviado para outra impressora que não seja a padrão. Marque a caixa de seleção Mostrar Caixa de Diálogo de Impressão se quiser que a caixa de impressão do Windows seja exibida. (Não disponível como disparador de pasta e documento.)
• Externo: Alguns clientes podem não lidar com esta configuração.

• Exportar: Exporta uma tabela que contém um conjunto específico de campos, mas apenas os registros aplicáveis de acordo com as seleções efetuadas são exportados. Clique no botão Configuração na página Ações para abrir a caixa de diálogo Configuração da ação Exportar. Não está disponível como documento ou gatilho de pasta.

  Nota informativaEsse recurso não funciona no cliente AJAX.
• Acionar: Aciona um programa externo. As seguintes configurações podem ser definidas no diálogo Ações:
  • Aplicativo: Clique em Pesquisar... para localizar o aplicativo que deve ser iniciado. (Não disponível como disparador de pasta e documento.)
  • Nome do arquivo: Insira o caminho para o arquivo que deve ser aberto com o aplicativo especificado acima. (Não disponível como disparador de pasta e documento.)
  • Parâmetros: Especifique os parâmetros para a linha de comando na qual o aplicativo é iniciado. (Não disponível como disparador de pasta e documento.)
  • Diretório de trabalho: Define o diretório de trabalho para que o aplicativo seja iniciado. (Não disponível como disparador de pasta e documento.)
  • Sair do aplicativo quando o QlikView é fechado: Força a saída do aplicativo quando o QlikView é fechado. (Não disponível como disparador de pasta e documento.)
  Nota informativaEsse recurso não funciona no cliente AJAX.
  

• Abrir URL: Você pode usar Abrir URL para abrir uma URL para um documento do QlikView desde outro documento do QlikView (encadeamento de documentos). Essa configuração abre a URL no navegador Web padrão. Esta função não pode ser usada como um disparador de documento e de pasta. Se estiver usando AbrirURL, certifique-se de inserir o nome do documento na string de ação em letras minúsculas.
  Onde possível, use Abrir documento do QlikView, em vez de Abrir URL.

  Nota informativaO uso de Javascript em URLs é impedido por padrão.

  Você pode permitir Javascript em URLs alterando o parâmetro PreventJavascriptInObjectActions no arquivo custom.config.

• Abrir documento do QlikView: Você pode usar Abrir documento do QlikView para abrir um documento do QlikView desde outro documento do QlikView (encadeamento de documentos). Essa função não pode ser usada como um documento ou gatilho de pasta. Para obter mais informações, consulte Exemplos de encadeamento de documentos.

• Executar Macro: Insira o caminho e o nome da macro a ser executada. Digite qualquer nome para o qual é possível criar posteriormente uma macro na caixa de diálogo Editar Módulo, ou uma expressão calculada para atualização dinâmica.
• Definir Variável: Atribui um valor à variável especificada.
• Mostrar Informações: Mostra as informações associadas, como um arquivo de texto ou uma imagem para o campo especificado por Campo. Esse recurso não funciona no cliente AJAX.
• Fechar Este Documento: Fecha o documento QlikView ativo.
• Executar Script: Executa uma recarga no documento atual. Esse recurso não funciona no cliente do AJAX e no plug-in para IE.

• Atualização Dinâmica: Realiza uma atualização dinâmica dos dados no documento carregado no momento. O comando para a atualização dinâmica deve ser inserido no campo Comando.
  O uso desejado da Atualização Dinâmica permite que um administrador do QlikView alimente valores limitados de dados em um documento do QlikView a partir de uma única origem sem recarregar o documento. Assim, a análise pode ser realizada por vários clientes com conexão com o QlikView Server.

  Nota informativaAs informações carregadas são armazenadas apenas na RAM de forma que todos os dados adicionados ou atualizados usando a Atualização Dinâmica serão perdidos se o documento for recarregado.

  A seguinte gramática descreve os comandos possíveis e seus componentes que podem ser usados com o recurso Atualização Dinâmica:

  • statements ::= statement { “;” statement }
  • statement ::= insert_statement | update_statement | delete_statement | begin_transaction_statement | commit_transaction_statement
  • insert_statement ::= "INSERT" "INTO" ("*" | table_name) field_list "VALUES" value_list {"," value_list} ["KEY" ["AUTO" | (" (" field_list ")")] ["REPLACE" (["WITH" "ONE"] | "EACH") ]]
  • update_statement ::= "UPDATE" ("*" | table_name) set_clause {"," | set_clause} "WHERE" condition ["AUTO" "INSERT"]
  • delete_statement ::= "DELETE" "FROM" ("*" | table_name] "WHERE" condition
  • begin_transaction_statement ::= "BEGIN" ("TRANSACTION" | "TRAN") [trans_name]
  • commit_transaction_statement ::= "COMMIT" ["TRANSACTION" | "TRAN"] [trans_name]
  • table_name ::= identifier | quoted_name
  • field_list ::= "(" field_name {"," field_name} ")"
  • value_list ::= "("value {"," value} ")"
  • set_clause ::= "SET" field_name "=" any_valid_non_aggregated_qlikview_expression
  • field_name ::= identifier | quoted string
  • value ::= identifier | any_qlikview_number | quoted string
  • condition ::= any_valid_non_aggregated_qlikview_expression
  • identifier ::= any_qlikview_identifier
  • quoted_string ::= "[" [^]]+ "]"

  Exemplo:  

  UPDATE AbcTable SET Discount = 123 WHERE AbcField=1

  Nota informativa Para usar esse recurso, a Atualização Dinâmica deve ser permitida tanto no Documento quanto no Servidor.

Exemplos de encadeamento de documentos

Você pode usar Abrir documento do QlikView para criar o encadeamento de documentos.

As seguintes configurações podem ser aplicadas:

• Estado de transferência: para transferir as seleções do documento original para o documento de destino. Primeiramente, o documento de destino será apagado das seleções.

• Aplicar estado sobre a seleção atual: para manter as seleções do documento de destino e aplicar as seleções do documento original sobre elas.

  Nota informativa O uso de Aplicar estado sobre a seleção atual pode retornar resultados inesperados se as seleções feitas nos dois documentos estiverem em conflito.

• Abrir na mesma janela: para abrir o novo documento na mesma guia do navegador ao usar o cliente AJAX ZFC.

  Nota informativaA ação Abrir documento do QlikView não é compatível com usuários fora do domínio ao usar o QlikView Plug-in.

Documentos do QlikView: A extensão do arquivo de destino deve ser incluída. Caminhos relativos para navegar de um documento do QlikView para outro possuem suporte em todos os clientes, desde que os documentos encadeados sejam armazenados na mesma estrutura de pastas (montagem).

Os exemplos a seguir mostram como gravar o caminho do arquivo no arquivo de destino:

Exemplo: Arquivo localizado na mesma estrutura de pastas (mesma montagem).

• Se o arquivo de destino estiver na mesma pasta:
  DestinationDoc.qvw

• Se o arquivo de destino estiver em uma subpasta:
  SubFolder/DestinationDoc.qvw

• Se o arquivo de destino estiver em uma pasta superior:
  ../DestinationDoc.qvw

• Se o arquivo de destino estiver em uma pasta superior e paralela:
  ../ParallelFolder/DestinationDoc.qvw

Exemplo: Arquivo localizado em uma estrutura de pastas diferente (diferente montagem). O caminho relativo entre montagens diferentes possui suporte apenas no cliente Ajax.

• Se o arquivo de destino estiver em uma montagem diferente:
  ../DifferentMount/DestinationDoc.qvw

Exemplo: Usando o caminho de montagem para apontar para um documento do QlikView. A definição do caminho para pastas montadas possui suporte apenas no cliente Ajax.

• Se o arquivo de destino estiver na mesma pasta montada:
  \Mount\DestinationDoc.qvw

• Se o arquivo de destino estiver em uma pasta montada diferente:
  \DifferentMount\DestinationDoc.qvw

  Nota informativaO encadeamento de documentos com pastas montadas não funciona com o QlikView Plug-in.

Exemplo: Usando o caminho absoluto para apontar para um documento do QlikView. O uso de caminhos absolutos para o encadeamento de documentos possui suporte no cliente Ajax e no QlikView Desktop.

• Caminho absoluto para a pasta raiz ou montagem local:
  C:\...\DestinationDoc.qvw

• Caminho absoluto para um compartilhamento de rede:
  \\SharedStorage\...\DestinationDoc.qvw

Aplicativos do QlikView do hub do Nuvem do Qlik Sense: você precisa do AppId, e não do caminho. Os aplicativos precisam ser preparados e atualizados no QlikView Desktop. O AppId é encontrado na URL quando o aplicativo é aberto no hub.

Exemplo

Se a URL for https://qcs.us.qlikcloud.com/qv/opendoc.htm?document=1cc71b323f172f93a8121ce1456cdg. O AppId será 1cc71b323f172f93a8121ce1456cdg.

 

Condição para Habilitar

Insira uma expressão que determinará o status do botão. Se a expressão retornar 0, o botão será desabilitado; se a expressão retornar 1, o botão será habilitado. Se não for digitada nenhuma expressão, 1 será assumido. Os botões desabilitados devido ao status subjacente não podem ser habilitados por meio de uma condição. O valor pode ser inserido como uma fórmula calculada. Clique em para abrir o diálogo Editar Expressão.

Propriedades do Botão: Apresentação

Estilo de Fundo

Aqua

Padrão para novos botões. Fornece um botão arredondado com aparência vítrea tridimensional. Clique em para definir uma cor.

Plano

Produz um botão QlikView tradicional simples. Clique em para definir uma cor.

Padrão do Sistema

Fornece um sólido plano de fundo na cor definida para botões no sistema operacional.

Imagem Única

Usa uma imagem para o botão. Clique em para procurar uma imagem.

Imagem Combinada

Produz um botão de imagem com três partes, uma para cada estado possível (ativo, inativo ou pressionado). Clique em para procurar uma imagem. O arquivo de imagem deve conter três imagens do botão lado a lado; a primeira do botão ativo, a segunda de um botão pressionado e a terceira de um botão desativado (inativo).

Transparência

Define o nível de transparência do fundo do objeto inserindo um valor ou arrastando o deslizador. Em 100%, o plano de fundo ficará totalmente transparente.

Alinhamento do Texto

Alinhamento À esquerda, Centralizado ou À direita do texto do botão.

Mais.../Menos...

Estilos

• Texto no Botão: Para definir a cor do texto, clique em . Para definir o tipo da fonte, clique em .
• Fonte do Título: Para definir o tipo da fonte do título, clique em .
• Título Ativo: Para definir a cor de fundo do título ativo, clique em . Para definir a cor do texto, clique em .
• Título Inativo: Para definir a cor de fundo do título inativo, clique em . Para definir a cor do texto, clique em .
• Usar Borda: Marque essa caixa de seleção para utilizar uma borda em torno do objeto de pasta. Clique em para definir a cor da borda.
• Largura da Borda: Especifique a largura da borda no campo de entrada ou arraste o deslizador até a largura desejada. A largura é especificada em pixels.
• Cantos Arredondados: Clique em para abrir o pop-up Cantos Arredondados.
  Nota informativa

  A opção Cantos Arredondados ficará disponível somente se o Modo de Estilo Avançado estiver selecionado em Propriedades de Documento: Geral.

  Selecione Fixo ou Relativo para a redondeza dos cantos e quais cantos serão afetados. Selecione também Inclinação inserindo um valor.

Propriedades do Botão: Título

Título

• Rótulo: Na caixa de texto, é possível especificar um texto que será mostrado no título do objeto de pasta. Se nenhum Rótulo for definido, o nome do campo será usado se Mostrar Título estiver selecionado.

O valor pode ser inserido como uma fórmula calculada.

Clique em para abrir o diálogo Editar Expressão.

• Mostrar Título: Quando esta opção estiver marcada, um título será desenhado na parte superior do objeto de pasta. As listas e outros "objetos da caixa" terão a opção ativada, por padrão, ao contrário de botões, objetos de texto e objetos de linha/seta.

• Alinhamento do Título: Pode ser à esquerda, centralizado ou à direita.

• Título Multilinha (Quebra Automática de Linha): Se esta opção estiver marcada, o texto será mostrado em duas ou mais linhas.

• Número de Linhas: Se várias linhas forem permitidas para o título, especifique o número de linhas no campo de entrada ou arraste o deslizador até o número desejado.

• Alinhamento do Título: Pode ser superior, centralizado ou inferior.

Mais.../Menos...

Ícones no Título

• Menu: Abre o menu Objeto.
• Limpar: Limpa todas as seleções atuais no objeto de pasta ativo.
• Imprimir:  Abre os objetos de pasta selecionados no formato de tabela em outra janela do navegador. Alguns clientes podem não lidar com esta configuração.
• Copiar Dados: Copia os valores de campo no objeto de pasta. Alguns clientes podem não lidar com esta configuração.
• Copiar Imagem para a Área de Transferência: Copia o objeto de pasta como uma imagem na área de transferência. Alguns clientes podem não lidar com esta configuração.
• Enviar para Excel: Exporta os valores possíveis (incluindo os selecionados) para o Microsoft Excel, que será acionado automaticamente se ainda não estiver sendo executado. Os valores exportados serão exibidos em uma coluna de uma nova planilha do Excel. Para que esse recurso funcione, o Microsoft Excel 2007 ou versão posterior deve estar instalado no computador. Alguns clientes podem não lidar com esta configuração.
• Permitir Minimizar: Quando esta opção é marcada, um ícone de minimização é mostrado no título da janela do objeto de pasta, contanto que o objeto possa ser minimizado. Além disso, você poderá minimizar o objeto clicando duas vezes no título.
• Minimização Automática: Essa opção estará disponível quando Permitir Minimizar for selecionado. Quando Minimização Automática for marcada para vários objetos na mesma pasta, todos, exceto um, serão minimizados automaticamente a qualquer momento. Isso é útil, por exemplo, para alternar a exibição de vários gráficos na mesma área de pasta.
• Permitir Minimizar: Quando esta opção é marcada, um ícone de maximização é mostrado no título da janela do objeto de pasta, contanto que o objeto possa ser maximizado. Além disso, você poderá maximizar o objeto clicando duas vezes no título. Se Permitir Minimizar e Permitir Maximizar estiverem marcadas, clicar duas vezes ocasionará a minimização do objeto.
• Texto de Ajuda: Aqui você pode inserir um texto de ajuda a ser mostrado em uma janela pop-up. Essa opção não está disponível no nível de documento. O valor pode ser inserido como uma fórmula calculada. Clique em para abrir o diálogo Editar Expressão.
  Você pode digitar, por exemplo, uma descrição do objeto da pasta. Um ícone de ajuda será incluído no título da janela do objeto. O texto será mostrado em uma janela pop-up quando o ponteiro do mouse estiver sobre o ícone.
• Mudança de Tipo Rápida: Aqui é possível ativar a alternação entre os tipos de gráfico. Não disponível para todos os objetos. Clique em para abrir o pop-up.
• Pop-up Configuração de Tipo Rápida: Marque as caixas dos tipos de gráfico entre os quais deseja alternar usando a alteração rápida de tipo.

Propriedades do Botão: Opções

Opções

Algumas opções podem não estar disponíveis para todos os objetos.

• Somente Leitura: Define o gráfico como apenas leitura, ou seja, não é possível fazer seleções clicando ou pintando com o mouse no gráfico.
• Permitir Mover/Ajustar: Se a seleção desta opção tiver sido cancelada, será impossível mover ou ajustar o objeto de pasta.
• Permitir Copiar/Clonar: Se esta opção tiver sido desmarcada, será impossível criar uma cópia do objeto de pasta. Essa configuração talvez não esteja disponível em todos os clientes.
• Ajustar o Objeto aos Dados: Geralmente, as bordas em torno de todos os objetos de pasta de tabela no QlikView se ajustarão quando as seleções fizerem com que o tamanho da tabela seja menor do que o tamanho alocado para o objeto de pasta. Se essa caixa de seleção for desmarcada, o ajuste automático de tamanho será desativado, deixando qualquer espaço excedente em branco.
• Permitir Mostrar Informações na Legenda: Quando a função Info estiver sendo usada, um ícone de informação será mostrado no título da janela sempre que um valor de campo tiver informações associadas. Se não desejar exibir esse ícone no título, desmarque esta opção. Disponível apenas para lista, caixa de estatísticas, seleção múltipla e caixa de entrada.
• Preservar Posição de Rolagem: Quando essa caixa de verificação e a caixa correspondente no diálogo Preferências do Usuário, Objetos forem marcadas, o QlikView preservará a posição de rolagem vertical, quando for feita uma seleção em objetos de tabela.
• Usar Condição de Exibição: O objeto de pasta será mostrado ou ocultado, de acordo com uma expressão condicional que será avaliada continuamente, dependendo, por exemplo, de seleções, etc. O objeto de pasta somente ficará oculto quando a condição retornar false. O valor pode ser inserido como uma fórmula calculada. Clique em para abrir o diálogo Editar Expressão.
• Normal: Especifique a posição do objeto definindo as margens Esquerda e Superior e Largura e Altura do objeto.
• Minimizado: Especifique a posição do objeto de pasta minimizado definindo as margens Esquerda e Superior e Largura e Altura do objeto minimizado.
• Mais.../Menos...: Estão disponíveis as seguintes opções:
  • Proprietário: Domínio e ID de usuário do proprietário.
  • Compartilhar objeto: Habilite essa opção para compartilhar objetos com outros usuários. Ao habilitar essa seleção, as configurações abaixo serão habilitadas.
  • Compartilhar com: Escolha Compartilhar com todos ou Compartilhar por nome do usuário.

  • Usuários (Domínio\ID de Usuário): Se a opção Compartilhar por nome do usuário for selecionada, uma lista com os usuários adicionados será mostrada.

    Para adicionar usuários, clique em e uma linha será adicionada; realce a linha para desbloqueá-la e editar as informações de usuário. Para remover usuários, clique em depois de cada usuário a ser removido.