OCRotationV2 - Global

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 2 min. de leitura
  • A inclusão de script OCRotationV2 é uma extensão da inclusão de script OCRotation, que é usada pelo Fullcalendar.io e pelo calendário de plantão DHTMLX.

    Use esta inclusão de script para obter o intervalo de tempo da programação entre duas datas que são filtradas por grupos, rotas, escalas e usuários. Você também pode estender o OCRotationV2 para adicionar ou modificar o comportamento. Isso faz parte do Agendamento de plantão.

    OCRotationV2 - getGroups()

    Retorna uma matriz de grupos que têm rotas ativas.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 2. Retorna
    Tipo Descrição
    Matriz Uma matriz de objetos de grupo. Cada um contém os seguintes atributos:
    • sys_id do registro sys_user_group
    • nome do registro sys_user_group

    OCRotationV2 – getRostersByRotas(cadeia de caracteres rotaSysIds)

    Retorna uma matriz de escalas ativas para um determinado ID de escala.

    Tabela 3. Parâmetros
    Nome Tipo Descrição
    rotaSysIds Cadeia de caracteres Lista separada por vírgulas de valores de sys_id de escala (cmn_rota).
    Tabela 4. Retornos
    Tipo Descrição
    Matriz Uma matriz de objetos de escala. Cada um contém os seguintes atributos:
    • sys_id do registro cmn_rota_roster
    • nome do registro cmn_rota_roster
    • rota sys_id do registro cmn_rota

    OCRotationV2 – getRotasByGroup(cadeia de caracteres groupSysIds)

    Retorna uma matriz de rotas ativas para um determinado ID de grupo.

    Tabela 5. Parâmetros
    Nome Tipo Descrição
    SysIdsGrupo Cadeia de caracteres Lista separada por vírgulas de valores de sys_id de grupo (sys_user_group).
    Tabela 6. Retornos
    Tipo Descrição
    Matriz Uma matriz de objetos de escala. Cada um contém os seguintes atributos:
    • sys_id do registro cmn_rota
    • nome do registro cmn_rota
    • sys_id do grupo do registro sys_user_group

    OCRotationV2 - getSpans()

    Obtenha os períodos da data de início especificada até a data de término especificada. Se nenhuma data de início e de término forem fornecidas, a data de início será padronizada para um mês antes e a data de término será padronizada para um mês após a hora atual. Você também pode usar os IDs de grupos, IDs de escala, IDs de listagem e IDs de usuário para filtrar ainda mais os períodos.

    Tabela 7. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 8. Retorna
    Tipo Descrição
    Matriz Uma matriz de períodos. Cada um contém os seguintes atributos: id, sys_id, table, rota_id, roster_id, user_id, text, description, color, textColor, start_date, end_date.
    Obter todos os períodos para o período padrão
    var spans = new OCRotationV2().getSpans();
    var firstSpanStartDate = spans[0].start_date; // get the first span's start date
    Obter todos os períodos entre 1º de abril de 2014 e 5 de junho de 2014
    var spans = new OCRotationV2()
        .setStartDate("2014-04-01")
        .setEndDate("2014-06-05")
        .getSpans();
    
    Obter períodos do grupo de rede para o período padrão
    var spans = new OCRotationV2()
         .setGroupIds("287ebd7da9fe198100f92cc8d1d2154e")
         .getSpans();
    
    Obter períodos do usuário da ITIL entre 1º de janeiro de 2014 e 31 de janeiro de 2014
    var spans = new OCRotationV2()
        .setStartDate("2014-01-01")
        .setEndDate("2014-01-31")
        .setUserIds("681b365ec0a80164000fb0b05854a0cd")
        .getSpans();