OCRotationV2 - Global

  • Versão de lançamento: Zurich
  • Atualizado 31 de jul. de 2025
  • 2 min. de leitura
  • . OCRotationV2 a inclusão de script é uma extensão de OCRotation Inclusão de script, que é usada por Fullcalendar.io e pelo calendário de plantão DHTMLX.

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

    OCRotationV2 - getGroups()

    Retorna uma matriz de grupos que têm rotações 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 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
    • sys_id de rota 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 sys_id do 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 término for fornecida, a data de início será padronizada como um mês antes e a data de término será padronizada como um mês após a hora atual. Você também pode usar IDs de grupos, IDs de escala, IDs de escala 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, texto, descrição, cor, textColor, start_date, end_date.
    Obtenha todos os períodos do período padrão
    var spans = new OCRotationV2().getSpans();
    var firstSpanStartDate = spans[0].start_date; // get the first span's start date
    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();
    
    Obtenha os períodos do grupo de rede para o período padrão
    var spans = new OCRotationV2()
         .setGroupIds("287ebd7da9fe198100f92cc8d1d2154e")
         .getSpans();
    
    Períodos do usuário 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();