ResuctTimelineSchedulePage - Global

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 8 min. de leitura

    • . ResuctTimelineSchedulePage a inclusão de script é uma classe auxiliar para facilitar o trabalho com os dados exibidos nas linhas do tempo.

    O processamento dos dados exibidos em uma linha do tempo começa executando a função correspondente da inclusão de script especificada. Como outras inclusões de script, a sintaxe da linguagem é JavaScript e segue as restrições de segurança padrão desse tipo de recurso. No entanto, como os diferentes tipos de opções de exibição são complexos, uma classe auxiliar foi criada. Para exibir uma linha do tempo, estenda ResuctTimelineSchedulePage e emparelhe-a com a página de programação correspondente. No mínimo, as classes estendidas devem substituir GetItems() , pois este é o manipulador de eventos primário para retornar itens a serem exibidos no cliente.

    O cliente processa os dados que ResuctTimelineSchedulePage retorna em duas fases. A primeira fase faz as atualizações reais na linha do tempo. Imediatamente após, se configurada, a segunda fase exibirá uma caixa de mensagem de sucesso, caixa de mensagem de erro ou aviso de mensagem de diálogo. Na fase um, as opções disponíveis para manipular dados incluem:

    • Não atualizar itens: Este é o comportamento padrão. Não execute nenhuma das etapas restantes na fase um.
    • Atualizar com itens específicos: Isso é feito usando: adicionar() .
    • Renderize a Linha do tempo usando GetItems() Função: Isso é feito usando: SetDoReRenderTimeline (verdadeiro) .
    Nota:
    Se ambos Items de tempo e são retornados e. setDoReRenderTimelineestá definido como verdadeiro , o sistema ignora setDoReRenderTimelinea propriedade e mostra explicitamente somente o. Items de tempo que foram adicionados por adicionar() função.

    As opções disponíveis na fase dois incluem:

    • Não exibir caixas de mensagem: Este é o comportamento padrão.
    • Exibir uma caixa de diálogo de sucesso: Isso é feito usando: SetStatusSuccess() .
    • Exibir uma caixa de diálogo de erro: Isso é feito usando: SetStatusError() .
    • Exibir uma caixa de diálogo Confirmar: Isso é feito usando: SetStatusPrompt() .
    Nota:

    Uma classe de inclusão de script que se estende ResuctTimelineSchedulePage Recebe automaticamente todos os parâmetros de URI do URL original cujo prefixo começa com sysparm_timeline_ . Para acessar os valores destes, use: This.getParameter("sysparm_timeline_VARIABLE"); em sua classe estendida.

    Isso é útil se você precisar exibir uma página de programação de um elemento dinâmico, como de um menu de contexto de uma lista. Ao passar dados dinâmicos por meio do URL, a página de programação inclui automaticamente esses parâmetros dentro das chamadas Ajax e, portanto, estará acessível dentro do ResuctTimelineSchedulePage inclusão de script.

    AbstractTimelineSchedulePage - add(Object ObjTimeline)

    Adiciona um TimelineItem objeto que será retornado ao cliente e exibido adequadamente na linha do tempo.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    ObjTimeline Objeto . TimelineItem objeto a ser adicionado à linha do tempo.
    Tabela 2. Retornos
    Tipo Descrição
    vazio

    AbstractTimelineSchedulePage - addSeparator()

    Adiciona um separador de quadro horizontal à lista de itens da linha do tempo. Todos os itens futuros adicionados via adicionar() será adicionado ao quadro de linha do tempo subsequente.

    Todos os itens futuros adicionados usando adicionar() os métodos são adicionados ao quadro de linha do tempo subsequente.

    Tabela 3. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 4. Retorna
    Tipo Descrição
    vazio

    O exemplo de código a seguir mostra como chamar este método.

    // Inside of a script include that extends AbstractTimelineSchedulePage
      this.addSeparator();

    AbstractTimelineSchedulePage - elementMoveX(cadeia de caracteres SpanSysId, cadeia de caracteres newStartDateTimeMs)

    Manipulador de eventos para quando um período da linha do tempo se move horizontalmente.

    Tabela 5. Parâmetros
    Nome Tipo Descrição
    SpanSysId Cadeia de caracteres O sys ID do período atual que está sendo ajustado.
    NostartDateTimeMs Cadeia de caracteres A nova hora de início do período em milissegundos. Analise a cadeia de caracteres usando ParseInt () antes de realizar qualquer comparação numérica.
    Tabela 6. Retornos
    Tipo Descrição
    vazio

    AbstractTimelineSchedulePage - elementMoveXY(cadeia de caracteres SpanSysId, cadeia de caracteres itemSysId , cadeia de caracteres itemSysId , cadeia de caracteres newItemSysId, cadeia de caracteres newStartDateTimeMs)

    Manipulador de eventos para quando um período da linha do tempo se move horizontalmente e verticalmente.

    Tabela 7. Parâmetros
    Nome Tipo Descrição
    SpanSysId Cadeia de caracteres O sys ID do período atual que está sendo ajustado.
    itemSysId Cadeia de caracteres O sys ID do item da linha do tempo associado ao período atual.
    NoItemSySID Cadeia de caracteres O sys ID do item da linha do tempo (uma linha) para o qual o período atual foi arrastado.
    NostartDateTimeMs Cadeia de caracteres A nova hora de início do período em milissegundos. Analise a cadeia de caracteres usando ParseInt() antes de realizar qualquer comparação numérica.
    Tabela 8. Retornos
    Tipo Descrição
    vazio

    AbstractTimelineSchedulePage - elementMoveY(cadeia de caracteres SpanSysId, cadeia de caracteres itemSysId, cadeia de caracteres newItemSysId)

    Manipulador de eventos para quando um período da linha do tempo se move verticalmente.

    Tabela 9. Parâmetros
    Nome Tipo Descrição
    SpanSysId Cadeia de caracteres O sys ID do período atual que está sendo ajustado.
    itemSysId Cadeia de caracteres O sys ID do item da linha do tempo associado ao período atual.
    NoItemSySID Cadeia de caracteres O sys ID do item da linha do tempo (uma linha) para o qual o período atual foi arrastado.
    Tabela 10. Retornos
    Tipo Descrição
    vazio

    AbstractTimelineSchedulePage - elementSucessor(cadeia de caracteres SpanSysId, cadeia de caracteres newSuccSpanId)

    Manipulador de eventos para quando um relacionamento de linha do tempo foi criado entre dois períodos.

    Tabela 11. Parâmetros
    Nome Tipo Descrição
    SpanSysId Cadeia de caracteres O sys ID do período atual que será um antecessor do relacionamento recém-criado.
    NoSucceSpanId Cadeia de caracteres O sys ID do período sucessor do relacionamento criado.
    Tabela 12. Retornos
    Tipo Descrição
    vazio ReturnValue

    AbstractTimelineSchedulePage - elementTimeAdjEnd(cadeia de caracteres SpanSysId, cadeia de caracteres newEndDateTimeMs)

    Manipulador de eventos para quando a data de término de um período da linha do tempo foi modificada.

    Tabela 13. Parâmetros
    Nome Tipo Descrição
    SpanSysId Cadeia de caracteres O sys ID do período atual que está sendo ajustado.
    NoEndDateTimeMs Cadeia de caracteres A nova hora de término do período em milissegundos. Analise a cadeia de caracteres usando ParseInt() antes de realizar comparações numéricas.
    Tabela 14. Retornos
    Tipo Descrição
    vazio

    AbstractTimelineSchedulePage - elementTimeAdjStart(cadeia de caracteres SpanSysId, cadeia de caracteres newStartDateTimeMs)

    Manipulador de eventos para quando a data de início de um período da linha do tempo foi modificada.

    Tabela 15. Parâmetros
    Nome Tipo Descrição
    SpanSysId Cadeia de caracteres O sys ID do período atual que está sendo ajustado.
    NostartDateTimeMs Cadeia de caracteres A nova hora de início do período em milissegundos. Analise a cadeia de caracteres usando ParseInt() antes de realizar comparações numéricas.
    Tabela 16. Retornos
    Tipo Descrição
    vazio

    AbstractTimelineSchedulePage - getItems()

    Manipulador de eventos para retornar itens de programação a serem exibidos na linha do tempo.

    Tabela 17. Parâmetros
    Nome Tipo Descrição
    nenhum
    Tabela 18. Retornos
    Tipo Descrição
    vazio

    AbstractTimelineSchedulePage - inputBox(cadeia de caracteres strInputText)

    Manipulador de eventos para quando uma cadeia de caracteres foi digitada na caixa de entrada do painel esquerdo.

    Tabela 19. Parâmetros
    Nome Tipo Descrição
    StrInputText Cadeia de caracteres O texto que foi inserido na caixa de entrada no painel esquerdo.
    Tabela 20. Retornos
    Tipo Descrição
    vazio

    AbstractTimelineSchedulePage - itemMove(cadeia de caracteres itemSysId, cadeia de caracteres newItemSysId)

    Manipulador de eventos para quando um item de linha da linha do tempo foi movido e arrastado para outro item de linha.

    Tabela 21. Parâmetros
    Nome Tipo Descrição
    itemSysId Cadeia de caracteres O sys ID do item da linha do tempo associado ao período atual.
    NoItemSySID Cadeia de caracteres O sys ID do item da linha do tempo (uma linha) para o qual o período atual foi arrastado.
    Tabela 22. Retornos
    Tipo Descrição
    vazio

    AbstractTimelineSchedulePage - setDoReRenderTimeline (booliano b)

    Especifica se todos os itens da linha do tempo devem ser renderizados novamente usando GetItems() função.

    Tabela 23. Parâmetros
    Nome Tipo Descrição
    b Booliano Se verdadeiro renderize novamente a linha do tempo fazendo uma nova chamada de evento para o servidor GetItems() manipulador.
    Tabela 24. Retornos
    Tipo Descrição
    vazio

    AbstractTimelineSchedulePage - setPageTitle(cadeia de caracteres strTitle)

    Especifica o texto a ser exibido como o título da linha do tempo.

    O título da página pode ser definido (e atualizado) a partir de qualquer evento interativo; no entanto, é recomendável que seja definido durante GetItems() evento.

    Tabela 25. Parâmetros
    Nome Tipo Descrição
    StrTitle Cadeia de caracteres O texto a ser exibido no título da linha do tempo.
    Tabela 26. Retornos
    Tipo Descrição
    vazio

    AbstractTimelineSchedulePage - setStatusError(cadeia de caracteres strTitle, cadeia de caracteres strMessage )

    Define a solicitação de evento atual como um status de erro com um título e mensagem especificados para exibir na fase dois do GlideTimeline processamento de eventos.

    Tabela 27. Parâmetros
    Nome Tipo Descrição
    StrTitle Cadeia de caracteres O texto a ser exibido no título da caixa de diálogo.
    StrMessage Cadeia de caracteres O texto a ser exibido na caixa de diálogo. O texto pode conter formatação HTML.
    Tabela 28. Retornos
    Tipo Descrição
    vazio

    AbstractTimelineSchedulePage - setStatusPrompt(cadeia de caracteres strTitle, cadeia de caracteres strOkFunction  , cadeia de caracteres strCancelFunction, cadeia de caracteres strCloseFunction)

    Define a solicitação de evento atual como um status de erro de prompt com um título e mensagem especificados para exibir em uma caixa de diálogo de confirmação durante a fase dois do GlideTimeline processamento de eventos. A caixa de confirmação exibe um OK e. Cancelar cada botão gera novos eventos que chamarão as funções especificadas nos argumentos do parâmetro. As funções definidas personalizadas para OK , Cancelar e Fechar receba os mesmos argumentos de parâmetro que os do evento atual.

    A caixa de confirmação exibe um OK e. Cancelar cada botão gera novos eventos que chamarão as funções especificadas nos argumentos do parâmetro.
    Nota:
    As funções definidas personalizadas para OK , Cancelar e Fechar receba os mesmos argumentos de parâmetro que os do evento atual.
    Tabela 29. Parâmetros
    Nome Tipo Descrição
    StrTitle Cadeia de caracteres O texto a ser exibido na caixa de diálogo. O texto pode conter formatação HTML.
    StrOkFunction Cadeia de caracteres A função a ser chamada na classe de inclusão de script atual se os usuários clicarem em OK botão.
    StrCancelFunction Cadeia de caracteres A função a ser chamada na classe de inclusão de script atual se o usuário clicar em Cancelar botão.
    StrCloseFunction Cadeia de caracteres A função a ser chamada na classe de inclusão de script atual se o usuário clicar em Fechar botão.
    Tabela 30. Retornos
    Tipo Descrição
    vazio 
    var MyTimelineScriptIncludeClass = Class.create();
      MyTimelineScriptIncludeClass.prototype = Object.extendsObject(AbstractTimelineSchedulePage, {
      
      getItems: function() {
      //...
      },
      
      elementTimeAdjustEnd: function(spanSysId, newEndDateTimeMs) {
      // Display a status prompt dialog box
      this.setStatusPrompt('Confirm Action', 'Are you sure you want to do that?',
      'this._myOkHandlerFunction',  
      'this._myCancelHandlerFunction',
      'this._myCloseHandlerFunction');
      },
      
      _myOkHandlerFunction: function(spanSysId, newEndDateTimeMs) { // ... },
      
      _myCancelHandlerFunction: function(spanSysId, newEndDateTimeMs) { // ... },
      
      _myCloseHandlerFunction: function(spanSysId, newEndDateTimeMs) { // ... }
      };

    AbstractTimelineSchedulePage - setStatusSuccess(cadeia de caracteres strTitle, cadeia de caracteres strMessage )

    Define a solicitação de evento atual como um status de sucesso com um título e mensagem especificados para exibir na fase dois do GlideTimeline processamento de eventos.

    Tabela 31. Parâmetros
    Nome Tipo Descrição
    StrTitle Cadeia de caracteres O texto a ser exibido no título da caixa de diálogo.
    StrMessage Cadeia de caracteres O texto a ser exibido na caixa de diálogo. O texto pode conter formatação HTML.
    Tabela 32. Retornos
    Tipo Descrição
    vazio