GlideTimeline - Global

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 12 min. de leitura

    • A API GlideTimeline fornece a implementação principal para configurar e exibir uma linha do tempo do kit de ferramentas de janelamento do Glide.

    Por segurança, o GlideTimeline já foi instanciado como uma única variável de instância chamada GlideTimeline. Todas as configurações devem ser feitas na seção de script do cliente da página de programação correspondente que faz referência a esta variável de instância.

    GlideTimeline – groupByParent(Booliano b)

    Especifica se os itens da linha do tempo devem ser agrupados ou não por seu primário. Se verdadeiro, todos os itens secundários serão aninhados dentro de seus primários. Isso afeta a ordem de exibição e os secundários sempre serão listados imediatamente após o primário. O valor padrão da propriedade groupByParent é falso.

    Se verdadeiro, todos os itens secundários serão aninhados dentro de seus primários. Isso afeta a ordem de exibição e os secundários sempre serão listados imediatamente após o primário. O valor padrão da propriedade groupByParent é falso.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    b Booliano Se verdadeiro, exibirá Itens da linha do tempo agrupados por primário.
    Tabela 2. Retornos
    Tipo Descrição
    vazio 
    glideTimeline.groupByParent(true);

    GlideTimeline - registerEvent(cadeia de caracteres strServerEvent, cadeia de caracteres strScriptIncludeName)

    Registra o evento do servidor de linha do tempo especificado. O strServerEvent deve ser um dos eventos permitidos para que o registro funcione corretamente. Quando o evento ocorre, o GlideTimeline envia uma solicitação ao servidor e processa o evento conforme tratado dentro da classe strScriptIncludeName.

    O strServerEvent deve ser um dos eventos permitidos para que o registro funcione corretamente. Quando o evento ocorre, o GlideTimeline envia uma solicitação ao servidor e processa o evento conforme tratado dentro da classe strScriptIncludeName.

    Tabela 3. Parâmetros
    Nome Tipo Descrição
    strServerEvent Cadeia de caracteres Especifica um dos seguintes eventos que diferenciam maiúsculas de minúsculas:
    • getItems
    • elementMoveX
    • elementMoveY
    • elementMoveXY
    • elementSuccessor
    • elementTimeAdjustStart
    • elementTimeAdjustEnd
    • inputBox
    • itemMove
    strScriptIncludeName Cadeia de caracteres Especifica o nome da classe que receberá o strServerEvent. Esta classe deve ser definida em uma inclusão de script que estende ResumoTimelineSchedulePage.
    Tabela 4. Retornos
    Tipo Descrição
    vazio 
    glideTimeline.registerEvent("getItems", "TimelineGanttSchedulePage");

    GlideTimeline – setAutoRefresh(Number intSeconds)

    Especifica o número de segundos de espera antes de executar uma atualização automática dos dados na linha do tempo. Definir o número de segundos como 0 desativará a atualização automática. Por padrão, a atualização automática está desabilitada. Se intSeconds for maior que 0 e menor que o tempo mínimo permitido em segundos (10), ele será definido como 10 segundos.

    Definir o número de segundos como 0 desativará a atualização automática. Por padrão, a atualização automática está desabilitada. Se intSeconds for maior que 0 e menor que o tempo mínimo permitido em segundos (10), ele será definido como 10 segundos.

    Tabela 5. Parâmetros
    Nome Tipo Descrição
    intSegundos Número Um número inteiro que especifica o tempo em segundos entre as atualizações automáticas.
    Tabela 6. Retornos
    Tipo Descrição
    vazio 
    glideTimeline.setAutoRefresh(15); // Sets the interval for auto-refreshing to 15 seconds.

    GlideTimeline – setDefaultPointIconClass(cadeia de caracteres icon_class)

    Especifica a classe de ícone padrão a ser usada para períodos de linha do tempo com duração zero se nenhuma classe de ícone tiver sido especificada explicitamente nas propriedades do período da linha do tempo retornado do servidor. O valor padrão da propriedade setDefaultPointIconClass é milestone.

    O valor padrão da propriedade setDefaultPointIconClass é milestone.

    Tabela 7. Parâmetros
    Nome Tipo Descrição
    ícone_classe Cadeia de caracteres Cadeia de caracteres que especifica um dos seguintes valores:
    • marco
    • azul_quadrado
    • sepia_square
    • verde_quadrado
    • quadrado_vermelho
    • preto_quadrado
    • círculo_azul
    • círculo_sépia
    • círculo_verde
    • círculo_vermelho
    • círculo_preto
    Tabela 8. Retornos
    Tipo Descrição
    vazio 
    glideTimeline.setDefaultPointIconClass('blue_circle');

    GlideTimeline – setExtraAjaxParam(cadeia de caracteres strName, cadeia de caracteres strValue)

    Permite que a configuração de parâmetros adicionais no script do cliente seja disponibilizada para os eventos de Inclusão de script correspondentes usando o método getParameter(). Os parâmetros de URI prefixados com sysparm_timeline_ serão incluídos automaticamente em todas as chamadas AJAX do lado do servidor.

    Os parâmetros de URI prefixados com sysparm_timeline_ serão incluídos automaticamente em todas as chamadas AJAX do lado do servidor.

    Tabela 9. Parâmetros
    Nome Tipo Descrição
    strName Cadeia de caracteres O nome do parâmetro de URI.
    strValue Cadeia de caracteres O valor de strName.
    Tabela 10. Retornos
    Tipo Descrição
    vazio 
    glideTimeline.setExtraAjaxParam("sysparm_timeline_limit", "5");

    GlideTimeline – setInitialViewRange(cadeia de caracteres objStartDate, cadeia de caracteres objEndDate)

    Especifica o intervalo visível inicial da linha do tempo. O formato das datas de início e de término deve estar no formato de carimbo de data/hora padrão: aaaa-MM-dd HH:mm:ss. O intervalo padrão é o intervalo que especifica o ponto do Período da Linha do tempo mais antigo até o fim do Período da Linha do tempo mais recente. Se a propriedade initialViewRange for especificada, ela substituirá o intervalo padrão.

    O formato das datas de início e de término deve estar no formato de carimbo de data/hora padrão: aaaa-MM-dd HH:mm:ss. O intervalo padrão é o intervalo que especifica o ponto do Período da Linha do tempo mais antigo até o fim do Período da Linha do tempo mais recente. Se a propriedade initialViewRange for especificada, ela substituirá o intervalo padrão.

    Tabela 11. Parâmetros
    Nome Tipo Descrição
    objStartDate Cadeia de caracteres A hora de início do intervalo de exibição no formato: aaaa-MM-dd HH:mm:ss .
    objEndDate Cadeia de caracteres A hora de término do intervalo de exibição no formato: aaaa-MM-dd HH:mm:ss .
    Tabela 12. Retornos
    Tipo Descrição
    vazio 
    // Sets the initial range to begin on June 20th, 2010 at 8:00 AM and end on June 28th, 2010 at 2:00 PM UTC time.
      glideTimeline.setInitialViewRange("2010-06-20 08:00:00", "2010-06-28 14:00:00");

    GlideTimeline – setInitialViewRange(Number objStartDate, Number objEndDate)

    Especifica o intervalo visível inicial da linha do tempo. O intervalo padrão é o intervalo que especifica o ponto do Período da Linha do tempo mais antigo até o fim do Período da Linha do tempo mais recente. Se a propriedade initialViewRange for especificada, ela substituirá o intervalo padrão.

    O intervalo padrão é o intervalo que especifica o ponto do Período da Linha do tempo mais antigo até o fim do Período da Linha do tempo mais recente. Se a propriedade initialViewRange for especificada, ela substituirá o intervalo padrão.

    Tabela 13. Parâmetros
    Nome Tipo Descrição
    objStartDate Número A hora de início do intervalo de exibição em milissegundos.
    objEndDate Número A hora de término em milissegundos.
    Tabela 14. Retornos
    Tipo Descrição
    vazio 
    // Sets the initial range to begin on June 20th, 2010 at 8:00 AM and end on June 28th, 2010 at 2:00 PM UTC time.
      glideTimeline.setInitialViewRange(1277046000000, 1277647200000);

    GlideTimeline – setInitialViewRange(cadeia de caracteres objStartDate, número objEndDate)

    Especifica o intervalo visível inicial da linha do tempo. O intervalo padrão é o intervalo que especifica o ponto do Período da Linha do tempo mais antigo até o fim do Período da Linha do tempo mais recente. Se a propriedade initialViewRange for especificada, ela substituirá o intervalo padrão.

    O intervalo padrão é o intervalo que especifica o ponto do Período da Linha do tempo mais antigo até o fim do Período da Linha do tempo mais recente. Se a propriedade initialViewRange for especificada, ela substituirá o intervalo padrão.

    Tabela 15. Parâmetros
    Nome Tipo Descrição
    objStartDate Cadeia de caracteres A hora de início do intervalo de exibição no formato: aaaa-MM-dd HH:mm:ss .
    objEndDate Número A hora de término em milissegundos.
    Tabela 16. Retornos
    Tipo Descrição
    vazio

    ExemploExplicação

    // Sets the initial range to begin on June 20th, 2010 at 8:00 AM and end on June 28th, 2010 at 2:00 PM UTC time.
      glideTimeline.setInitialViewRange("2010-06-20 08:00:00", 1277647200000);

    GlideTimeline – setInitialViewRange(Number objStartDate, String objEndDate)

    Especifica o intervalo visível inicial da linha do tempo. O intervalo padrão é o intervalo que especifica o ponto do Período da Linha do tempo mais antigo até o fim do Período da Linha do tempo mais recente. Se a propriedade initialViewRange for especificada, ela substituirá o intervalo padrão.

    O intervalo padrão é o intervalo que especifica o ponto do Período da Linha do tempo mais antigo até o fim do Período da Linha do tempo mais recente. Se a propriedade initialViewRange for especificada, ela substituirá o intervalo padrão.

    Tabela 17. Parâmetros
    Nome Tipo Descrição
    objStartDate Número A hora de início do intervalo de exibição em milissegundos.
    objEndDate Cadeia de caracteres A hora de término do intervalo de exibição no formato: aaaa-MM-dd HH:mm:ss .
    Tabela 18. Retornos
    Tipo Descrição
    vazio

    ExemploExplicação

    // Sets the initial range to begin on June 20th, 2010 at 8:00 AM and end on June 28th, 2010 at 2:00 PM UTC time.
      glideTimeline.setInitialViewRange(1277046000000, "2010-06-28 14:00:00");

    GlideTimeline – setReadOnly(Booliano b)

    Habilita ou desabilita todas as interações de eventos da linha do tempo. Se habilitada, a interação do evento será determinada a partir dos atributos correspondentes especificados por cada item da linha do tempo. O valor padrão da propriedade readOnly é falso.

    Se habilitada, a interação do evento será determinada a partir dos atributos correspondentes especificados por cada item da linha do tempo. O valor padrão da propriedade readOnly é falso.

    Tabela 19. Parâmetros
    Nome Tipo Descrição
    b Booliano Se verdadeiro, marca a linha do tempo inteira como somente leitura (não interativa).
    Tabela 20. Retornos
    Tipo Descrição
    vazio 
    glideTimeline.setReadOnly(true);

    GlideTimeline – showDependencyLines(Booliano b)

    Especifica se as linhas de dependência devem ser mostradas ou não entre períodos de linha do tempo. Este método se aplica somente se o conjunto de itens da linha do tempo retornados do servidor incluir relacionamentos de dependência. O valor padrão da propriedade showDependencyLines é falso.

    Este método se aplica somente se o conjunto de itens da linha do tempo retornados do servidor incluir relacionamentos de dependência. O valor padrão da propriedade showDependencyLines é falso.

    Tabela 21. Parâmetros
    Nome Tipo Descrição
    b Booliano Se verdadeiro, exibe linhas de dependência na linha do tempo; caso contrário, não.
    Tabela 22. Retornos
    Tipo Descrição
    vazio 
    glideTimeline.showDependencyLines(true);

    GlideTimeline - showGridLines(booliano bShowGridlines, valor numérico)

    Especifica se as linhas de grade devem ser mostradas ou não para cada linha de dados na linha do tempo. Por padrão, as linhas de grade estão habilitadas.

    Por padrão, as linhas de grade estão habilitadas.

    Tabela 23. Parâmetros
    Nome Tipo Descrição
    bMostrar linhas de grade Booliano Se verdadeiro, a linha do tempo mostrará linhas de grade; caso contrário, não exibirá linhas de grade.
    valor Número valor
    Tabela 24. Retornos
    Tipo Descrição
    vazio ValorDeRetorno 
    glideTimeline.showGridLines(false); // Disables grid lines.

    GlideTimeline – showLeftPane(Booliano b)

    Especifica se o painel esquerdo deve ser mostrado ou não na linha do tempo. O valor padrão da propriedade leftPane é verdadeiro.

    O valor padrão da propriedade leftPane é verdadeiro.

    Tabela 25. Parâmetros
    Nome Tipo Descrição
    b Booliano Se verdadeiro, a linha do tempo mostrará o painel esquerdo; caso contrário, o painel esquerdo não será exibido.
    Tabela 26. Retornos
    Tipo Descrição
    vazio 
    glideTimeline.showLeftPane(false);

    GlideTimeline – showLeftPaneAsTree(booliano b)

    Especifica como mostrar itens secundários no painel esquerdo da linha do tempo. Os itens secundários são exibidos como nós recuados aninhados com capacidade de expandir e recolher ou em um único nível de recuo. O valor padrão da propriedade showLeftPaneAsTree é falso.

    O valor padrão da propriedade showLeftPaneAsTree é falso.

    Tabela 27. Parâmetros
    Nome Tipo Descrição
    b Booliano Se verdadeiro, os nós de item secundário serão mostrados como recuados com a capacidade de expandir/recolher; caso contrário, todos os itens do painel esquerdo serão exibidos em um único nível de recuo.
    Tabela 28. Retornos
    Tipo Descrição
    vazio 
    glideTimeline.showLeftPaneAsTree(true);

    GlideTimeline – showLeftPaneInputBox(booliano b, cadeia de caracteres strDefaultValue)

    Especifica se a caixa de entrada de texto deve ser mostrada ou não na parte inferior do painel esquerdo com um valor padrão conforme especificado por strDefaultValue. Se o painel esquerdo for desativado por meio de showLeftPane(), a caixa de entrada não ficará visível. O valor padrão da propriedade showLeftPaneInputBox é falso.

    Se o painel esquerdo for desativado por meio de showLeftPane(), a caixa de entrada não ficará visível. O valor padrão da propriedade showLeftPaneInputBox é falso.

    Tabela 29. Parâmetros
    Nome Tipo Descrição
    b Booliano Se verdadeiro, mostra a caixa de entrada do painel esquerdo.
    strDefaultValue Cadeia de caracteres O valor padrão a ser exibido na caixa de entrada.
    Tabela 30. Retornos
    Tipo Descrição
    vazio 
    glideTimeline.showLeftPaneInputBox(true, 'Add a new task ...');

    GlideTimeline – showSummaryPane(Booliano b)

    Especifica se o painel de resumo deve ser mostrado ou não na parte inferior da linha do tempo. O valor padrão da propriedade showSummaryPane é verdadeiro.

    O valor padrão da propriedade showSummaryPane é verdadeiro.

    Tabela 31. Parâmetros
    Nome Tipo Descrição
    b Booliano Se verdadeiro, a linha do tempo incluirá o painel de resumo; caso contrário, o painel de resumo não será exibido.
    Tabela 32. Retornos
    Tipo Descrição
    vazio 
    glideTimeline.showSummaryPane(false);

    GlideTimeline - showTimelineText(Booliano b)

    Especifica se o texto da linha do tempo deve ser mostrado ou não abaixo de cada Período da Linha do tempo no painel da linha do tempo primário. O valor padrão da propriedade showTimelineText é falso.

    O valor padrão da propriedade showTimelineText é falso.

    Tabela 33. Parâmetros
    Nome Tipo Descrição
    b Booliano Se verdadeiro, exibe o texto descritivo abaixo de cada Período da Linha do tempo; caso contrário, nenhum texto será exibido abaixo de cada período da linha do tempo.
    Tabela 34. Retornos
    Tipo Descrição
    vazio 
    glideTimeline.showTimelineText(true);

    GlideTimeline – snapVertScrollingIntoRows(booliano b)

    Especifica se o movimento vertical dos objetos de extensão da linha do tempo (se registrados corretamente para executar este evento) deve ou não ajustar o encaixe na linha mais próxima. Por padrão, este valor está habilitado.

    Por padrão, este valor está habilitado.

    Tabela 35. Parâmetros
    Nome Tipo Descrição
    b Booliano Se verdadeiro, encaixa o movimento vertical dos objetos de extensão da linha do tempo em linhas; caso contrário, os itens serão movidos exatamente em relação ao mouse.
    Tabela 36. Retornos
    Tipo Descrição
    vazio 
    glideTimeline.snapVertScrollingIntoRows(false);

    GlideTimeline – ordenarByLeftLabelText(Booliano b)

    Especifica se os itens devem ser agrupados ou não pelo texto do rótulo esquerdo. O valor padrão da propriedade sortByLeftLabelText é falso.

    O valor padrão da propriedade sortByLeftLabelText é falso.

    Tabela 37. Parâmetros
    Nome Tipo Descrição
    b Booliano Se verdadeiro, classifica os itens da linha do tempo em ordem alfabética pelo texto especificado no rótulo esquerdo de cada item.
    Tabela 38. Retornos
    Tipo Descrição
    vazio 
    glideTimeline.sortByLeftLabelText(true);

    GlideTimeline – classificadoByStartDate(Booliano b)

    Especifica se deve ou não classificar a lista de itens da linha do tempo retornados pela data de início mais antiga dos objetos de período da linha do tempo de um item. Se groupByParent() estiver definido como verdadeiro, os itens serão classificados após o agrupamento. O valor padrão da propriedade sortByStartDate é falso.

    Se groupByParent() estiver definido como verdadeiro, os itens serão classificados após o agrupamento. O valor padrão da propriedade sortByStartDate é falso.

    Tabela 39. Parâmetros
    Nome Tipo Descrição
    b Booliano Se verdadeiro, classifica os itens da linha do tempo cronologicamente a partir da data de início mais antiga.
    Tabela 40. Retornos
    Tipo Descrição
    vazio 
    glideTimeline.sortByStartDate(true);

    GlideTimeline – ordenarByTimelineLabelText(Booliano b)

    Especifica se a lista de itens da linha do tempo retornada deve ou não ser classificada em ordem alfabética de acordo com o texto que foi especificado para mostrar no painel da linha do tempo.

    Nota:
    Esta ordem de classificação ainda se aplica mesmo se o texto da linha do tempo tiver sido definido como falso por meio do método showTimelineText(). Além disso, se groupByParent() estiver definido como verdadeiro, os itens serão classificados corretamente após o agrupamento.

    O valor padrão da propriedade sortByTimelineLabelText é falso.

    Tabela 41. Parâmetros
    Nome Tipo Descrição
    b Booliano Se verdadeiro, classifica os itens da linha do tempo em ordem alfabética pelo texto especificado no texto do período da linha do tempo de cada item.
    Tabela 42. Retornos
    Tipo Descrição
    vazio 
    glideTimeline.sortByTimelineLabelText(true);