OCRotationV2 - Global

OCRotationV2 é uma extensão de OCRotation, que é usada pelo Fullcalendar.io e pelo calendário de plantão DHTMLX.

OCRotationV2 é usado para obter o intervalo de tempo da programação entre duas datas que são filtradas por grupos, rotações, listagens e usuários. Você também pode estender OCRotationV2 para adicionar ou modificar o comportamento. Isso faz parte do On-Call Scheduling.

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 listagens ativas para um determinado ID de rota.

Tabela 3. Parâmetros

Nome	Tipo	Descrição
rotaSysIds	Cadeia de caracteres	Lista separada por vírgulas de valores de rota sys_id (cmn_rota).

Tabela 4. Retorna

Tipo	Descrição
Matriz	Uma matriz de objetos de rotação. 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 rotações ativas para um determinado ID de grupo.

Tabela 5. Parâmetros

Nome	Tipo	Descrição
SYS IDs do grupo	Cadeia de caracteres	Lista separada por vírgulas de valores de sys_id (sys_user_group) de grupo.

Tabela 6. Retorna

Tipo	Descrição
Matriz	Uma matriz de objetos de rotação. Cada um contém os seguintes atributos: sys_id do registro cmn_rota nome do registro cmn_rota grupo sys_id do registro sys_user_group

OCRotationV2 – getSpans()

Obtenha os períodos da data de início 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 um mês antes e a data de término será padronizada um mês após a hora atual. Você também pode usar IDs de grupos, IDs de rotação, 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 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();