Gantt de Recursos

Basics

Baixando e Instalando 

Qlik Sense Desktop 

Para instalar a AnyGantt Extension no Qlik Sense Desktop, faça o seguinte:

1. Baixe a AnyGantt Extension para Qlik Sense.
2. Extraia o arquivo.
3. Abra uma janela do Windows Explorer e navegue até o diretório de Extensions do Qlik Sense:
   ..\Users\<UserName>\Documents\Qlik\Sense\Extensions.
4. Copie a pasta anygantt-4x-project para o diretório Extensions.
5. Copie a pasta anygantt-4x-resource para o diretório Extensions.
6. Copie a pasta anygantt-4x-timeline para o diretório Extensions.
7. Reinicie o Qlik Sense Desktop.

Qlik Sense Server 

Para instalar a AnyGantt Extension em um servidor Qlik Sense,

1. Baixe a AnyGantt Extension para Qlik Sense.
2. Abra o Qlik Management Console (QMC): https://<QPS server name>/qmc
3. Selecione Extensions na página inicial do QMC ou no menu suspenso Start.
4. Clique em Import na barra de ações.
5. No diálogo, selecione o arquivo baixado. Deixe a área de senha em branco.
6. Clique em Open na janela do explorador de arquivos.
7. Clique em Import.

Qlik Sense Cloud 

Para instalar a AnyGantt Extension no Qlik Sense Cloud, faça o seguinte:

1. Baixe a AnyGantt Extension para Qlik Sense Cloud.
2. Extraia o arquivo.
3. Acesse o Management Console:
   • adicione /console ao endereço do seu tenant: https://<your tenant address>/console
   • ou use o link de navegação Administration sob o perfil do usuário no hub
4. Vá para a página Extensions e clique em Add.
5. No diálogo, selecione o arquivo com a extensão no pacote – por exemplo, anygantt-4x-resource.zip.
6. Clique em Add.
7. Repita as etapas acima para adicionar outras extensões.
8. No Management Console, vá para a seção Content Security Policy e clique em Add.
9. No diálogo, dê um nome à Content Security Policy – por exemplo, AnyChart.
10. Digite o endereço do servidor de origem: qlik.anychart.com
11. Selecione as seguintes diretrizes:
    • connect-src
    • font-src
    • img-src
    • script-src
    • style-src
12. Clique em Add.

Visão Geral 

O Resource Gantt chart é uma ferramenta que agenda recursos (por exemplo, equipamentos ou funcionários) ao longo de períodos de tempo. É possível exibir múltiplos periods e milestones em uma linha e combinar recursos em grupos.

Leia Quick Start e Dimensions and Measures para aprender como adicionar um Resource Gantt chart e quais dimensões e medidas usar.

No lado esquerdo do gráfico, há uma table que exibe informações de texto sobre dimensões e medidas. Por padrão, ela inclui duas colunas: uma index column mostrando os índices das linhas e uma dimension column mostrando recursos e grupos de recursos.

No lado direito, está a área do gráfico, que exibe elements: periods, representando períodos de tempo; e milestones, representando eventos com duração zero.

As configurações disponíveis de elements incluem: colors / color by expression, labels, tooltips e as settings of periods e milestones especiais. Você também pode adicionar reference lines e reference ranges, configurar a scale, timeline e toolbar, definir o locale e o mês inicial do fiscal year, etc.

Quick Start 

Este tutorial rápido explica como criar um Resource Gantt chart básico.

Antes de tudo, adicione um gráfico vazio à sua folha:

1. Vá para Custom objects > AnyGantt no painel de ativos.
2. Arraste um gráfico AnyGantt Resource vazio para a folha.

Em seguida, adicione duas dimensions, uma representando recursos e a outra representando periods e milestones:

1. Vá para Dimensions no painel de propriedades.
2. Clique em Add dimension e selecione uma dimensão.
3. Clique em Add dimension e selecione uma dimensão.

A dimensão que representa os recursos deve vir primeiro. Se precisar reorganizar as dimensões, basta arrastá-las no painel de propriedades.

Finalmente, adicione duas measures – as datas de início e término:

1. Vá para Measures no painel de propriedades.
2. Clique em Add measure e selecione uma medida.
3. Clique em Add measure e selecione uma medida.
4. Clique na primeira medida e selecione Start no menu suspenso Map as.
5. Clique na segunda medida e selecione Finish no menu suspenso Map as.

Observe que você também pode criar dimensões e medidas a partir de campos ou adicioná-las clicando nos botões no gráfico vazio.

Dimensões e Medidas 

Dimensões 

Para adicionar uma dimensão, faça o seguinte:

1. Vá para Dimensions no painel de propriedades.
2. Clique em Add dimension e selecione uma dimensão.

O Resource chart requer duas dimensões, uma representando recursos e a outra representando periods e milestones. A dimensão que representa os recursos deve vir primeiro. Se precisar reorganizar as dimensões, basta arrastá-las no painel de propriedades.

A dimensão que representa os recursos é mostrada na dimension column. A dimensão que representa periods e milestones não é mostrada diretamente.

É possível agrupar recursos e criar uma hierarquia multinível adicionando dimensões extras. Nesse caso, a dimension column exibe recursos e grupos de recursos, organizados em uma estrutura em árvore.

Lembre-se de que você precisa organizar as dimensões hierárquicas na ordem correta, dos níveis mais altos para os mais baixos.

Você pode personalizar o texto exibido na dimension column:

1. Vá para Dimensions no painel de propriedades.
2. Clique em uma dimensão.
3. Insira um valor de string ou uma expressão de string na caixa de entrada Dimension column text.

Por exemplo, você pode usar identificadores numéricos de recursos como uma dimensão e, ao mesmo tempo, exibir os nomes dos recursos na dimension column. Para fazer isso, basta inserir o nome do campo que contém os nomes dos recursos na caixa de entrada Dimension column text. A AnyGantt funciona corretamente apenas com identificadores exclusivos, portanto, o uso desse recurso pode fazer sentido se os nomes dos recursos não forem exclusivos, mas você ainda quiser exibi-los.

Se precisar ocultar valores nulos, desmarque a caixa Include null values nas configurações de cada dimensão. No entanto, se você aplicar essa abordagem a uma árvore de dados desequilibrada, os nós com uma profundidade menor serão ocultados.

Para ocultar valores nulos e visualizar corretamente uma árvore de dados desequilibrada,

1. Vá para Add-ons > Data handling no painel de propriedades.
2. Marque a caixa Unbalanced tree.

Medidas 

Para adicionar uma medida, faça o seguinte:

1. Vá para Measures no painel de propriedades.
2. Clique em Add measure e selecione uma medida.

Você deve mapear as medidas que usa: consulte a seção Mapping para saber mais.

Basta adicionar apenas uma medida – a data de início. No entanto, nesse caso, todos os elementos são mostrados como milestones. Para criar periods, você precisa adicionar uma segunda medida – a data de término. Use mais medidas para exibir informações adicionais em measure columns.

Mapeamento 

Você deve mapear as measures que usa para que elas funcionem corretamente.

Por exemplo, para mapear as datas de início e término exigidas pelos periods, faça o seguinte:

1. Vá para Measures no painel de propriedades.
2. Clique na primeira medida e selecione Start no menu suspenso Map as.
3. Clique na segunda medida e selecione Finish no menu suspenso Map as.

Aqui está a lista completa de mapeamentos disponíveis e seus usos:

• Start – periods, milestones
• Finish – periods
• Data field – mapeamento padrão

Use Data field (o mapeamento padrão) se uma medida representar alguma informação adicional e você quiser exibi-la apenas em uma measure column.

Tabela 

A table à esquerda do gráfico exibe informações de texto.

A index column exibe os índices das linhas, a dimension column mostra as dimensões e as measure columns mostram as medidas. O header no topo da tabela exibe os títulos das colunas.

É possível alterar os títulos e outras configurações das colunas e personalizar a aparência do header e das cells da tabela.

Para desativar ou ativar a table,

1. Vá para Appearance > Table > no painel de propriedades.
2. Alterne o seletor Enabled / Disabled.

Index Column 

A AnyGantt cria automaticamente a index column quando você cria um gráfico. Ela exibe os índices das linhas e seu título padrão é #.

Para configurar a index column, vá para Appearance > Table > Index column no painel de propriedades e faça o seguinte:

• Para desativar ou ativar, alterne o seletor Enabled / Disabled.
• Para definir o modo de numeração, vá para Numbering mode e selecione uma das opções disponíveis.
• Para definir um título personalizado, insira seu texto na caixa de entrada Label.

Os modos de numeração disponíveis incluem: Simple numbering (padrão), Hierarchical numbering e Expression. O modo de numeração Expression requer a inserção de uma expressão na caixa de entrada Numbering expression.

Numeração Simples

Numeração Hierárquica

Numeração por Expressão

Nesta amostra, a index column exibe hierarquicamente os IDs dos recursos:

Pick(Dimensionality(), continent_id, continent_id & '.'
& country_id, continent_id & '.' & country_id & '.' & server_id)

Dimension Column 

A AnyGantt cria automaticamente a dimension column quando você cria um gráfico. Ela mostra a dimensão que representa os recursos e seu título padrão é Name.

Se houver dimensões extras representando grupos de recursos, a AnyGantt as exibirá hierarquicamente, como uma estrutura em árvore.

Para personalizar o título da dimension column,

1. Vá para Appearance > Table > Dimension column no painel de propriedades.
2. Insira seu texto na caixa de entrada Label.

Você também pode personalizar o texto mostrado na dimension column – consulte a seção Dimensions para saber mais.

Measure Columns 

É possível adicionar colunas exibindo medidas. Por padrão, seus títulos são expressões de medida.

Para criar uma measure column, faça o seguinte:

1. Vá para Measures no painel de propriedades.
2. Clique em Add measure e selecione uma medida. (Pule esta etapa se você já tiver adicionado a medida.)
3. Nas configurações da medida, marque a caixa Show as column.

Não se esqueça de mapear a medida se quiser usá-la para criar periods e milestones. Se você for mostrar a medida apenas em uma coluna, poderá manter o mapeamento padrão.

Para personalizar o título de uma measure column,

1. Vá para Measures no painel de propriedades.
2. Clique em uma medida e insira seu texto na caixa de entrada Label.

Você também pode exibir texto personalizado em uma measure column: adicione um valor de string ou uma expressão de string arbitrária como uma medida e mostre-a em uma coluna. É possível usar símbolos HTML e Unicode.

1. Vá para Measures no painel de propriedades.
2. Clique em Add measure e insira um valor de string ou uma expressão de string na caixa de entrada.
3. Marque a caixa Show as column.

No exemplo abaixo, a primeira measure column representa uma expressão que calcula a duração agregada de períodos estáveis por recurso (servidor):

Interval(Sum({<[status]={'stable'}>}[finish_date])) -
Interval(Sum({<[status]={'stable'}>}[start_date]))

A segunda coluna representa uma expressão de string – ela mostra textos diferentes dependendo de quanto tempo os servidores permaneceram estáveis:

If(Interval(Sum({<[status]={'stable'}>}[finish_date])) -
Interval(Sum({<[status]={'stable'}>}[start_date])) < 20,
'<font color="red">Poor</font>', '<font color="green">Good</font>')

Header 

O header no topo da tabela exibe os títulos de suas colunas.

As seções a seguir explicam como personalizar os títulos:

• Index Column
• Dimension Column
• Measure Columns

Você também pode ir para Appearance > Table > Header no painel de propriedades e configurar o background e a fonte do header:

• Para configurar o background, alterne o Background e use o seletor Fill e as opções de Opacity.
• Para configurar a fonte, alterne o seletor Font e use as opções Style, Color, Size, Family e Shadow.

Cells 

Para configurar as cells da tabela, vá para Appearance > Table > Cells no painel de propriedades e faça o seguinte:

1. Para configurar o preenchimento, selecione um tipo de preenchimento no menu suspenso Fill type e use as opções disponíveis abaixo.
2. Para configurar a fonte, alterne o seletor Font e use as opções Style, Color, Size, Family e Shadow.
3. Para definir a altura, use a opção Rows height.
4. Para configurar o traço, alterne o seletor Rows stroke e use as opções Color, Stroke type e Thickness.

Observe que as configurações de preenchimento, altura e traço afetam tanto a tabela quanto a área onde os elements são exibidos.

Aqui, a altura e a fonte das cells foram ajustadas:

A tabela abaixo explica a diferença entre os diferentes tipos de preenchimento e lista as configurações disponíveis para cada um deles:

Solid Fill

Hierarchy Fill

Odd/Even Fill

Elementos 

Elements são as partes do Resource Gantt chart que representam intervalos de tempo relacionados aos recursos.

Aqui estão os tipos de elements que estão disponíveis na AnyGantt Extension para Qlik:

• actual bars
• milestones

Esta seção explica a diferença entre os tipos e como adicioná-los. Para aprender como configurar os elements, leia a seção Settings of Elements.

Periods 

Periods mostram a duração dos intervalos de tempo.

Para adicionar periods, você precisa adicionar duas measures – as datas de início e término. Faça o seguinte:

1. Vá para Measures no painel de propriedades.
2. Clique em Add measure e selecione uma medida.
3. Clique em Add measure e selecione uma medida.
4. Clique na primeira medida e selecione Start no menu suspenso Map as.
5. Clique na segunda medida e selecione Finish no menu suspenso Map as.

Milestones 

Milestones são elementos que representam eventos com duração zero. Eles exigem apenas uma medida – a data de início.

Para adicionar milestones, basta adicionar periods. Se em seus dados houver itens com apenas datas de início, a AnyGantt os exibirá automaticamente como milestones.

É possível exibir múltiplos milestones em uma linha.

Configurações de Elementos 

Cores 

Você pode colorir periods e milestones como desejar. Duas opções estão disponíveis: a coloração padrão, que é descrita nesta seção, e a coloring by expression, descrita na seção abaixo.

Para alterar as cores padrão e as configurações adicionais de preenchimento e traço, vá para Appearance > Defaults no painel de propriedades, clique em um tipo de elemento que deseja ajustar e faça o seguinte:

• Para configurar o preenchimento, selecione um tipo de preenchimento no menu suspenso Fill type e use as opções disponíveis abaixo.
• Para configurar o traço, use as opções Stroke, Stroke type e Thickness.

Os elements suportam os seguintes tipos de preenchimento e configurações:

Fill by Line

Fill by Item

Fill by Group

Colorir por Expressão 

Você pode colorir periods e milestones como desejar. Duas opções estão disponíveis: a coloração padrão, descrita acima, e a coloração por expressão, descrita nesta seção.

A coloração por expressão define as cores usando uma expressão definida pelo usuário. Ao colorir por expressão, você pode definir quais cores usar e com quais valores usá-las, permitindo mais controle sobre como as cores são usadas na visualização. Por exemplo, você pode destacar valores de interesse particular ou diferenciar entre valores dentro de diferentes intervalos de valores. A coloração por expressão também pode ser usada para colorir uma visualização por valores não incluídos na visualização, como colorir tarefas por país, importância ou RAG.

Para colorir um elemento por expressão, faça o seguinte:

1. Vá para Add-Ons > Data settings no painel de propriedades.
2. Clique em Add setting.
3. Selecione um elemento no primeiro menu suspenso.
4. Selecione a opção Color string no segundo menu suspenso.
5. Insira uma expressão na caixa de entrada.

Exemplos 

Aqui estão alguns exemplos para mostrar o que você pode fazer com expressões por cor.

Exemplo: Colorir por um valor de medida único

If(status = 'down', 'salmon', 'yellowgreen')

Neste exemplo, há uma condição. Se o status do servidor for 'down', os periods correspondentes serão coloridos como 'salmon', caso contrário, serão coloridos como 'yellowgreen'.

Exemplo: Colorir por múltiplos valores de medida

If(status = 'down', 'salmon', If(status = 'high load', 'orange', 'yellowgreen'))

Neste exemplo, existem múltiplas condições. Se o status do servidor for 'down', os periods correspondentes serão coloridos como 'salmon'. Se o status do servidor for 'high load', os periods correspondentes serão coloridos como 'orange'. Todos os outros periods serão coloridos como 'yellowgreen'.

Labels 

Labels são objetos de texto que exibem informações adicionais sobre periods e milestones. Cada um dos dois tipos de elementos tem suas próprias configurações de label.

Por padrão, não há labels no gráfico. Para ativá-las, basta definir o texto da label e a AnyGantt exibirá as labels.

Observe que é possível definir o texto da label como um valor de string ou como uma expressão de string arbitrária. O uso de expressões permite destacar valores de interesse particular, exibir valores não incluídos na visualização ou resultados de cálculos, e assim por diante.

Para adicionar labels a um elemento, faça o seguinte:

1. Vá para Add-ons > Label settings no painel de propriedades.
2. Clique em Add label.
3. Selecione um elemento no primeiro menu suspenso.
4. Selecione a opção Text no segundo menu suspenso.
5. Insira um valor de string ou uma expressão de string na caixa de entrada.

Para configurá-las, use as opções abaixo:

• Para definir a posição, use as opções Align e Offset.
• Para configurar o background, alterne o seletor Background e use as opções Fill, Opacity, Corner type, Border type e Border radius.
• Para configurar a fonte, alterne o seletor Font e use as opções Style, Color, Size, Family e Shadow.
• Para definir o limite de caracteres, alterne o seletor Character limit e insira um número na caixa de entrada.

Para gerenciar labels sobrepostas, vá para Add-ons > Label settings no painel de propriedades e desmarque ou marque a caixa Hide overlapped. Esta configuração afeta as labels de todos os tipos de elementos ao mesmo tempo.

Neste exemplo, configurações de fonte personalizadas foram aplicadas às labels dos periods. Elas exibem a seguinte expressão:

If(status = 'down', Upper(status) & '!')

Tooltips 

Tooltips são caixas de texto que aparecem quando o usuário passa o mouse sobre os elementos. Você pode definir um texto de tooltip personalizado separadamente para periods e milestones.

Observe que é possível definir o texto da tooltip como um valor de string ou como uma expressão de string arbitrária. O uso de expressões permite destacar valores de interesse particular, exibir valores não incluídos na visualização ou resultados de cálculos, e assim por diante.

Para desativar ou ativar as tooltips, vá para Interactivity no painel de propriedades e alterne o seletor Tooltips.

Para configurar as tooltips, vá para Add-ons > Tooltip settings no painel de propriedades e faça o seguinte:

• Para configurar o background, alterne o seletor Background e use as opções Fill, Opacity e Border radius.
• Para configurar a fonte, alterne o seletor Font e use as opções Style, Color, Size e Family.

Aqui está como o background e a fonte das tooltips podem parecer após a configuração:

Para definir o texto da tooltip e o limite de caracteres de um elemento, faça o seguinte:

1. Vá para Add-ons > Tooltip settings no painel de propriedades.
2. Clique em Add tooltip.
3. Selecione um elemento no menu suspenso.
4. Insira um valor de string ou uma expressão de string na caixa de entrada.
5. Alterne o seletor Character limit e insira um número na caixa de entrada.
   (Esta opção estará disponível apenas após a definição do texto.)

Aqui está um exemplo de uma expressão para configurar o texto da tooltip:

'<b>' & Date(start_date, 'MM.DD') & ' – ' & Date(finish_date, 'MM.DD') &
' (' & (Interval(finish_date) - Interval(start_date)) & ' d)</b>' &
'<br><i>' & Capitalize(status) & '</i>' & 

'<br><br>Server: ' & server_name &
'<br>Location: ' & country_name

Configurações de Períodos 

Periods suportam os seguintes recursos: Colors, Color by Expression, Tooltips, Labels. Eles também suportam algumas configurações especiais, descritas nas subseções abaixo.

Marcadores de Início e Término 

Você pode ativar os marcadores de início e/ou término dos periods:

1. Vá para Appearance > Defaults no painel de propriedades.
2. Clique em Periods.
3. Vá para Start marker ou End marker.
4. Alterne o seletor Disabled / Enabled.

Para configurá-los, use as opções abaixo:

• Para definir o tipo (forma), selecione um dos tipos integrados no menu suspenso Type.
• Para configurar o preenchimento e o traço, use as opções Fill, Stroke e Thickness.
• Para definir o tamanho, use a opção Size.

Configurações de Milestones 

Milestones têm as seguintes configurações gerais: Colors, Color by Expression, Tooltips, Labels. Eles também suportam algumas configurações especiais, descritas nas subseções abaixo.

Tipo e Tamanho 

Na seção Appearance > Defaults > Milestones do painel de propriedades, você pode ajustar o tipo e o tamanho (bem como colors) dos milestones.

Para definir o tamanho, use a opção Size.

Para definir o tipo, use uma das seguintes opções:

	Clique no pictograma "icon" e selecione um ícone integrado (forma) no menu suspenso.
	Clique no pictograma "image" e insira um link para uma imagem personalizada na caixa de entrada Image URL.

Aqui está um dos ícones integrados:

Você também pode usar uma expressão definida pelo usuário para atribuir diferentes imagens personalizadas a diferentes milestones:

1. Vá para Add-Ons > Data settings no painel de propriedades.
2. Clique em Add setting.
3. Selecione Milestones no primeiro menu suspenso.
4. Selecione a opção Image url no segundo menu suspenso.
5. Insira uma expressão na caixa de entrada.

No exemplo abaixo, os milestones são representados como imagens diferentes dependendo do status do servidor. A seguinte expressão é usada:

If(status = 'down', 'https://qlik.anychart.com/static/qlik-demo-apps/milestone-icon-x.png',
If(status = 'high load', 'https://qlik.anychart.com/static/qlik-demo-apps/milestone-icon-arrow-up.png',
If(status = 'stable', 'https://qlik.anychart.com/static/qlik-demo-apps/milestone-icon-arrow-up-in-a-circle.png')))

Outros Recursos 

Linhas de Referência 

Uma reference line é uma linha que intercepta a área do gráfico a partir de um determinado ponto na timeline.

Você pode adicionar uma ou várias reference lines a um gráfico para indicar uma determinada data ou datas. A reference line é desenhada apenas se estiver dentro do intervalo de exibição atual.

Observe que é possível especificar o valor que define a posição de uma reference line como um valor de data ou como uma expressão de data arbitrária.

Para adicionar uma reference line, faça o seguinte:

1. Vá para Add-ons > Reference lines no painel de propriedades.
2. Clique em Add reference line.
3. Insira um valor de data ou uma expressão de data na caixa de entrada Date.

Em seguida, configure-a:

• Para adicionar um rótulo de texto, insira uma string de texto na caixa de entrada Label.
• Para configurar o traço, use as opções Stroke, Stroke type e Thickness.
• Para configurar a posição do rótulo, use as opções Label orientation e Label position.
• Para configurar a fonte, alterne o seletor Font e use as opções Style, Color, Size, Family e Shadow.

Intervalos de Referência 

Um reference range é uma área que intercepta a área do gráfico a partir de um determinado intervalo de pontos na timeline.

Você pode adicionar um ou vários reference ranges a um gráfico para indicar um determinado período ou períodos de tempo. O reference range é desenhado apenas se estiver dentro do intervalo de exibição atual.

Observe que é possível especificar os valores que definem a posição de um reference range como valores de data ou como expressões de data arbitrárias.

Para adicionar um reference range, faça o seguinte:

1. Vá para Add-ons > Reference range no painel de propriedades.
2. Clique em Add reference range.
3. Insira um valor de data ou uma expressão de data na caixa de entrada From.
4. Insira um valor de data ou uma expressão de data na caixa de entrada To.

Em seguida, configure-o:

• Para adicionar um rótulo de texto, insira uma string de texto na caixa de entrada Label.
• Para configurar o preenchimento, use as opções Color e Opacity.
• Para configurar a posição do rótulo, use as opções Label orientation e Label position.
• Para configurar a fonte, alterne o seletor Font e use as opções Style, Color, Size, Family e Shadow.

Escala 

A AnyGantt Extension opera uma scale, que você pode configurar. É possível definir o intervalo de datas que o gráfico exibe por padrão, bem como o mínimo e o máximo da scale.

Observe que você pode especificar todas essas datas como valores de data ou como expressões de data arbitrárias.

Intervalo de Exibição Padrão 

Por padrão, o gráfico é reduzido ao máximo. Ele também pode ser ampliado para um intervalo de datas personalizado. No entanto, os usuários ainda poderão reduzir o gráfico usando a toolbar (ou a roda do mouse) – se o mínimo e o máximo da scale permitirem.

Para definir o intervalo de exibição padrão, faça o seguinte:

1. Vá para Appearance > Scale > Display range no painel de propriedades.
2. Alterne Display range de Auto para Custom.
3. Insira um valor de data ou uma expressão de data na caixa de entrada From.
4. Insira um valor de data ou uma expressão de data na caixa de entrada To.

No exemplo a seguir, o intervalo de exibição padrão é definido entre 1º e 15 de julho de 2019:

Date#('07.01.2019', 'MM.DD.YYYY')

Date#('07.15.2019', 'MM.DD.YYYY')

Aqui está como o gráfico com essas configurações aparece por padrão:

Mínimo e Máximo 

Quando você reduz o gráfico ao máximo usando a toolbar (ou a roda do mouse), você vê o intervalo de datas entre o mínimo e o máximo da scale. Por padrão, a AnyGantt os ajusta para exibir todos os elements do gráfico.

Para definir a data mínima da scale,

1. Vá para Appearance > Scale > Minimum no painel de propriedades.
2. Alterne Minimum de Auto para Custom.
3. Se necessário, marque a caixa Soft para ativar o soft mode.
4. Insira um valor de data ou uma expressão de data na caixa de entrada.

Para definir a data máxima da scale,

1. Vá para Appearance > Scale > Maximum no painel de propriedades.
2. Alterne Maximum de Auto para Custom.
3. Se necessário, marque a caixa Soft para ativar o soft mode.
4. Insira um valor de data ou uma expressão de data na caixa de entrada.

Neste exemplo, o mínimo é definido como 10 dias antes da data de início real mais antiga, e o máximo é definido como 10 dias após a data de término real mais recente:

Min(start_date) - 10

Max(finish_date) + 10

Aqui está como o gráfico com essas configurações aparece quando é reduzido ao máximo:

Modo Soft 

Para ativar o modo soft, marque a caixa Soft ao definir o mínimo e o máximo da scale.

O modo soft ajusta o mínimo e o máximo aos elements do gráfico. Isso é importante quando há elementos ou partes de elementos anteriores ao mínimo ou posteriores ao máximo.

Por exemplo, se você definir o mínimo como 1º de julho de 2019 e ativar o modo soft, o gráfico ainda mostrará todos os elementos e partes de elementos anteriores a essa data. Ativar o modo soft tanto para o mínimo quanto para o máximo garante que sempre seja possível reduzir o gráfico (usando a toolbar) para ver todos os elementos.

Abaixo há um Gantt chart com o mínimo e o máximo da scale definidos como 10 e 20 de julho de 2019:

Date#('07.01.2019', 'MM.DD.YYYY')

Date#('07.15.2019', 'MM.DD.YYYY')

O modo soft está desativado tanto para o mínimo quanto para o máximo:

Aqui está o mesmo gráfico com o modo soft ativado apenas para o mínimo:

Aqui, o modo soft está ativado apenas para o máximo:

Gaps 

Você pode adicionar um gap mínimo e um máximo – espaços em branco à esquerda e à direita do espaço ocupado pelos elements:

1. Vá para Appearance > Scale > Gaps no painel de propriedades.
2. Alterne Gaps de Auto para Custom.
3. Selecione Percents ou Pixels no menu suspenso Unit type.
4. Use as opções Minimum gap e Maximum gap.

Além disso, certifique-se de que os seletores Minimum e Maximum acima estejam alternados para Auto: as configurações de mínimo e máximo substituem as configurações de gaps.

Aqui, o gap mínimo está definido como 20% e o máximo como 50%:

Timeline 

Uma timeline é um conjunto de linhas (níveis) acima da área do gráfico, onde as datas são exibidas.

A apresentação de datas e intervalos na timeline é afetada pelas configurações de fiscal year e pelo locale.

Níveis da Timeline 

Por padrão, existem três níveis na timeline. Cada nível exibe uma determinada unidade de tempo, dependendo do nível de zoom atual e das settings of zoom levels.

Para abrir as configurações de um nível, faça o seguinte:

1. Vá para Appearance > Timeline no painel de propriedades.
2. Clique em Top level / Middle level / Bottom level

Em seguida, configure-o:

• Para desativar ou ativar, alterne o seletor Enabled.
• Para definir a cor de preenchimento, use a opção Fill.
• Para configurar a fonte, alterne o seletor Font e use as opções Style, Color, Size, Family e Shadow.

Níveis de Zoom 

O gráfico pode ser ampliado e reduzido usando a toolbar (ou a roda do mouse). Em cada nível de zoom, os níveis da timeline exibem certas unidades de tempo. Para defini-los,

1. Vá para Appearance > Timeline no painel de propriedades.
2. Clique em Zoom levels para abrir a janela com as configurações.
3. Configure os níveis de zoom.
4. Clique em Save e Close.

Aqui está a janela com as configurações padrão dos níveis de zoom:

Por padrão, existem 9 níveis de zoom. O número máximo disponível de níveis também é 9. Na janela Zoom levels, você pode excluir e duplicar níveis clicando nos botões à direita deles. Para restaurar as configurações padrão, clique em Restore defaults.

Cada nível de zoom contém as configurações dos três níveis da timeline: Top level, Middle level e Bottom level. Para cada nível da timeline, você pode especificar uma unidade de tempo e um número de unidades.

Você deve especificar a maior unidade de tempo para o Top level da timeline e a menor unidade para o Bottom level. A mesma lógica se aplica aos níveis de zoom: o primeiro nível da lista (marcado como Max) é o nível exibido quando o gráfico está totalmente reduzido, e a timeline exibe as maiores unidades de tempo. O último nível de zoom da lista (Min) é o nível exibido quando o gráfico está totalmente ampliado, e a timeline exibe as menores unidades de tempo.

No exemplo abaixo, há um gráfico com apenas um nível de zoom:

Ano Fiscal 

Você pode definir o mês inicial do fiscal year. Esta configuração afeta apenas a apresentação de datas e intervalos na timeline e tooltips, bem como nos rótulos da toolbar. Você pode selecionar outra localidade:

1. Vá para Appearance > Fiscal year no painel de propriedades.
2. Selecione This year / Next year no primeiro menu suspenso.
3. Selecione um mês no segundo menu suspenso.

Cronograma 

É possível definir e destacar o cronograma de trabalho: feriados, fins de semana, horas de trabalho e de folga.

O destaque de feriados e fins de semana é visível quando o gráfico é ampliado para dias. O destaque do horário de trabalho é visível quando é ampliado para horas. (Use a toolbar ou a roda do mouse para ampliar e reduzir o gráfico.)

Para configurar feriados, vá para Appearance > Schedule > Holidays no painel de propriedades e faça o seguinte:

• Para definir feriados, insira seus dados na caixa de entrada Holiday dates.
• Para desativar ou ativar o destaque, alterne o seletor Highlight.
• Para configurar o destaque, use as opções Color e Opacity.

Você pode inserir as datas dos feriados como uma string, separando-as por vírgula:

'07.16.2019, 07.17.2019'

Você também pode usar um campo de dados contendo as datas dos feriados. Combine-os com a função Concat():

Concat(holiday_date, ',')

Para configurar os fins de semana, vá para Appearance > Schedule > Weekends no painel de propriedades:

• Para definir os dias de fim de semana, clique nos botões que representam os dias da semana.
• Para desativar ou ativar o destaque, alterne o seletor Highlight.
• Para configurar o destaque, use as opções Color e Opacity.

Nesta captura de tela, duas cores diferentes destacam o fim de semana e dois feriados:

Para configurar o horário de trabalho, vá para Appearance > Schedule > Working hours no painel de propriedades:

• Para definir o início do horário de trabalho, selecione um horário no menu suspenso Start.
• Para definir o término do horário de trabalho, selecione um horário no menu suspenso Finish.
• Para desativar ou ativar o destaque do tempo de trabalho, alterne o seletor Highlight working time.
• Para desativar ou ativar o destaque do tempo de folga, alterne o seletor Highlight non-working time.
• Para configurar os destaques, use as opções Color e Opacity sob os seletores.

Aqui, o horário de trabalho está colorido de verde e o horário de folga está colorido de cinza:

Localidade 

Por padrão, a AnyGantt lê a localidade do Qlik e a aplica aos formatos de data/hora usados na timeline e tooltips, bem como aos rótulos da toolbar. Você pode selecionar outra localidade:

1. Vá para Appearance > Locale no painel de propriedades.
2. Desmarque a caixa Use Qlik locale.
3. Selecione uma localidade no menu suspenso.

A AnyGantt suporta as seguintes localidades:

• Chinês (República Popular da China)
• Chinês (Taiwan)
• Holandês (Países Baixos)
• Inglês (Estados Unidos)
• Francês (França)
• Alemão (Alemanha)
• Italiano (Itália)
• Japonês (Japão)
• Coreano (Coreia)
• Polonês (Polônia)
• Português (Brasil)
• Russo (Rússia)
• Espanhol (Espanha)
• Sueco (Suécia)
• Turco (Turquia)

Aqui está um Gantt chart com a localidade chinesa:

Toolbar 

Toolbar é um painel de navegação acima do gráfico. Ele permite que os usuários ampliem e reduzam o gráfico, recolham ou expandam linhas (se houver relações hierárquicas entre elas) e imprimam o gráfico.

Para configurar a toolbar, vá para Appearance > Toolbar no painel de propriedades e faça o seguinte:

• Para desativar ou ativar, desmarque ou marque a caixa Enabled.
• Para definir o tipo de botões, use as opções Icons (padrão), Labels e Both.
• Para selecionar os formatos de impressão a serem exibidos no menu suspenso Print, vá para Print formats e marque as caixas correspondentes.
• Para configurar a fonte, alterne o seletor Font e use as opções Style, Color, Size e Family.

As configurações de estilo e família da fonte afetam apenas os rótulos dos botões (se estiverem ativados). O tamanho e a cor da fonte afetam os rótulos e os ícones, bem como o menu Print. Além disso, o texto dos rótulos é afetado pela localidade.

Aqui está como a toolbar com diferentes tipos de botões aparece:

Icons
Labels
Both

Nesta captura de tela, tanto os rótulos quanto os ícones estão ativados, com a fonte ajustada:

Impressão 

A toolbar no topo do gráfico fornece a interface para impressão.

A AnyGantt suporta impressão multipáginas e vários formatos de impressão de A0 a A6. Você também pode selecionar a orientação paisagem ou retrato e especificar o intervalo de impressão (todas as datas ou apenas as datas visíveis).

Aqui está o menu suspenso Print com as opções disponíveis:

Para selecionar os formatos de impressão a serem exibidos no menu,

1. Vá para Appearance > Toolbar > Print formats no painel de propriedades.
2. Marque as caixas correspondentes.

Interatividade 

Por padrão, os seguintes recursos de interatividade estão disponíveis: seleção, snapshots e tooltips. A roda do mouse é usada para rolar o gráfico verticalmente, mas também pode ser usada para ampliá-lo.

Para desativar ou ativar esses recursos, vá para Interactivity no painel de propriedades e alterne os seguintes seletores:

• Selection
• Snapshots
• Tooltips
• Zoom with mouse wheel

Expandir / Recolher 

Se houver mais de duas dimensions, a AnyGantt organiza a table hierarquicamente. Por padrão, o gráfico é desenhado com todas as linhas expandidas, mostrando todos os níveis da hierarquia.

Os usuários podem recolher e expandir linhas com a ajuda de botões na tabela ou na toolbar.

O gráfico pode ser desenhado com todas as linhas recolhidas, com os elementos filhos carregados ou não. Para gerenciar o estado do gráfico ao carregar, vá para Add-ons > Data handling no painel de propriedades e faça o seguinte:

• Para carregar a árvore inteira ou apenas o nível superior, alterne o seletor Fully expanded.
• Para recolher ou expandir as linhas por padrão, alterne o seletor Collapse on load.

Quando a opção Fully expanded está desativada, apenas os elementos pais de nível superior são carregados. O botão da toolbar Expand All expande apenas os elementos carregados anteriormente, portanto, nesse caso, ele não pode ser usado para expandir a árvore inteira de uma só vez. Para carregar elementos filhos, você deve expandir manualmente seus pais usando os botões da tabela.

Quando a opção Fully expanded está ativada, todos os elementos da árvore são carregados. Se você ativar o Collapse on load, o gráfico será desenhado com todos os elementos filhos recolhidos, mas eles ainda estarão carregados. Nesse caso, o botão da toolbar Expand All expande a árvore inteira de uma só vez.

Condições de Cálculo 

A AnyGantt suporta condições de cálculo: você pode definir uma condição que precisa ser cumprida (verdadeira) para que o objeto seja exibido. Se a condição não for cumprida, uma mensagem personalizada será exibida.

Uma condição de cálculo é útil quando um gráfico ou tabela é muito grande e torna a visualização lenta para responder. Uma condição de cálculo pode ajudar para que, por exemplo, um objeto não seja mostrado até que o usuário tenha filtrado os dados para um nível mais gerenciável, aplicando seleções.

Para adicionar uma condição, faça o seguinte:

1. Vá para Add-ons > Data handling no painel de propriedades.
2. Insira uma expressão na caixa de entrada Calculation condition.
3. Insira um valor de string ou uma expressão de string na caixa de entrada Displayed message.

Por exemplo, a seguinte expressão permite mostrar o gráfico apenas quando o usuário seleciona menos de 20 períodos:

If(Count(period_id) < 20, 1, 0)

Se houver muitos períodos, a AnyGantt exibe esta mensagem:

'There are too many periods (' & Count(period_id) & ').'