Componentes de capacidade e reservas

Instale o. Serviço de campo Plug-in de Gestão de prestadores (com.snc.fsm_contractor_management) para levar em conta os grupos externos ao reservar, definir e atribuir a capacidade de trabalho. Para obter mais informações, consulte Ativar Serviço de campo Gestão de prestadores de serviços.

Ativação de Serviço de campo A Gestão de capacidade e reservas adiciona o menu Gestão de capacidade ao navegador de aplicações e aos seguintes módulos:

Reservas de capacidade : Reserve um percentual de capacidade de disponibilidade de um grupo ou agentes para atender a demandas específicas. Por exemplo, 60% para tipos de trabalho de reparo e 40% para tipos de trabalho de instalação.
Definições de capacidade : Aloque a quantidade correta de trabalho para grupos de trabalho internos ou externos com base em horas definidas, contagem de tarefas ou cronogramas de trabalho do agente. Você pode definir a capacidade para um dia, semana, mês ou ano.
Atribuições de capacidade : Atribua a capacidade e as reservas de capacidade a grupos de trabalho internos e grupos externos de empresas prestadoras.
Usos da capacidade : Exiba o registro da capacidade usada por diferentes grupos e agentes.

Nota:

Você deve selecionar usando programação dinâmica em Método de atribuição para tarefas opção de configuração para permitir que sua aplicação distribua trabalho com base nas regras de gestão de capacidade.

Tabelas

A gestão de capacidade adiciona as tabelas a seguir.

Tabela 1. Tabelas instaladas com a Gestão de capacidade e reservas
Tabela	Descrição
Atribuição de capacidade [wm_capacity_assignment]	Armazena atribuições de definição de capacidade a grupos dentro de um período de tempo específico para ajudar a evitar conflitos de capacidade em um determinado período validando o. em vigor a partir de e. vigente até datas.
Definição de capacidade [wm_capacity_definition]	Armazena os detalhes, como fonte de capacidade, programação de alocação, frequência das definições de capacidade de um grupo ou agente de serviço de campo interno e as regras de reserva a serem usadas durante a atribuição de tarefas.
Canal de demanda [wm_demand_channel]	Armazena os detalhes, como nome, condições e ordem de execução de um canal de demanda.
Métricas de demanda de capacidade [wm_capacity_for_demand]	Armazena os dados de métricas para todas as atribuições de capacidade.
Reserva de capacidade [wm_capacity_reservation]	Armazena a definição de reserva e as condições de exclusão.
Regra de reserva de capacidade [wm_capacity_reservation_rule]	Armazena as regras de reserva e as condições para as quais as reservas devem ser usadas.
Uso de Capacidade [wm_capacity_usage]	Armazena a capacidade usada por um agente de serviço de campo interno ou um grupo em um período específico.

Regras de negócio

A gestão de capacidade adiciona as seguintes regras de negócios.

Tabela 2. Regras de negócio instaladas com a Gestão de capacidade e reservas
Regra de negócio	Tabela	Descrição
Evite conflitos no período de tempo de capacidade	Atribuição de capacidade [wm_capacity_assignment]	Monitore o período definido para a Atribuição de capacidade para garantir que nenhum grupo tenha várias atribuições de capacidade no mesmo período ou intervalos sobrepostos.
Atualizar capacidade na mudança de tarefa	Tarefa de ordem de serviço [wm_task]	Adicione ou atualize a capacidade quando uma tarefa é atribuída ou não atribuída. Você pode atualizar a capacidade quando a duração estimada de trabalho ou viagem mudar.
Atualizar capacidade na exclusão de tarefa	Tarefa de ordem de serviço [wm_task]	Atualize a capacidade usada sempre que uma tarefa em aberto for excluída na janela fornecida.
Valide o valor da capacidade	Definição de capacidade [wm_capacity_definition]	Valida o valor da capacidade fornecida para a definição de capacidade. A capacidade deve ser um valor inteiro positivo diferente de zero.
Valide em vigor até e em vigor a partir de	Atribuição de capacidade [wm_capacity_assignment]	Valida as datas inseridas em Em vigor até e. Em vigor a partir de campos na tabela de atribuição de capacidade. O sistema calcula o. Vigente até data baseada no valor inserido em Repita para campo se Capacidade de o valor não está selecionado como para a programação do agente. . Em vigor a partir de o valor deve ser sempre igual ou igual à data atual e antes ou igual a Vigente até data. Ao atualizar a atribuição de capacidade, o. Vigente até o valor não pode ser definido como uma data anterior à existência do uso de capacidade.
Valide o valor percentual alocado	Regra de reserva de capacidade [wm_capacity_reservation_rule]	Valida o valor percentual alocado na tabela Regra de reserva de capacidade. Este valor não deve ser um número inteiro positivo zero menor ou igual a 100.
Atualize o domínio para atribuição de capacidade	Atribuição de capacidade [wm_capacity_assignment]	O sistema atribui domínios a registros com base nas informações no Tipo campo. Se o Tipo for "Agentes internos do território" ou "Grupo de prestadores de território", o domínio será definido usando o. Território campo. Para qualquer outro tipo, o domínio é determinado pelo Grupo campo.
Atualize a tabela de métricas de demanda de capacidade	Substituição da atribuição de capacidade [wm_capacity_override]	Atualiza o. Métricas de demanda de capacidade tabela em que a data ou os dias de corte da programação agregada do agente são atualizados para um território.
Atualizar capacidade na mudança de tarefa	Tarefa de ordem de serviço [wm_task]	Permite que você personalize o cálculo da capacidade definindo condições para deduzir a capacidade do uso da capacidade.
Não permitir mudanças na definição de capacidade	Definição de capacidade [wm_capacity_definition]	Impede modificações nas definições de capacidade quando elas estão em uso.
Substituir agent-schedule	Substituição da atribuição de capacidade [wm_capacity_override]	Evita substituições de cronogramas gerenciados pelo sistema de programação do agente.
Exiba atualização sobre o uso de capacidade	Buckets de capacidade [wm_capacity_bucket]	Impede a atualização de valores de capacidade e tempo quando existem registros de uso de capacidade.
Limite um canal de demanda por reserva	Regra de reserva de capacidade [wm_capacity_reservation_rule]	Garante que cada regra de reserva de capacidade esteja associada a apenas um canal de demanda.
Impedir nome duplicado, condição	Canal de demanda [wm_demand_channel]	Garante que os canais de demanda não tenham nomes e condições duplicados.
Impedir a atualização do registro para inativo	Canal de demanda [wm_demand_channel]	Impede a mudança do status do canal de demanda para Inativo quando o canal de demanda ainda está em uso.
Remover capacidade para tarefa incompatível	Tarefa de ordem de serviço [wm_task]	Remove alocações de capacidade de tarefas que não oferecem suporte ao gerenciamento de capacidade.
Restringir mudanças na definição	Definição de capacidade [wm_capacity_definition]	Impede mudanças Capacidade de Valor da definição de capacidade para Programação do agente quando há registros de substituição de atribuição de capacidade.
Para verificar o uso não inferior a 0	Uso de Capacidade [wm_capacity_usage]	Valida se os valores de uso da capacidade são maiores ou iguais a 0.
Valide diferentes tipos de substituições	Substituição da atribuição de capacidade [wm_capacity_override]	Valida se diferentes tipos de substituições estão em conformidade com as restrições de negócios.
Validar campos	Substituição da atribuição de capacidade [wm_capacity_override]	Garante que os campos obrigatórios sejam preenchidos para substituição de capacidade.
Valide campos com base no tipo	Atribuição de capacidade [wm_capacity_assignment]	Garante que os campos obrigatórios sejam preenchidos com base no tipo de atribuição de capacidade.
Validar ao excluir a definição	Definição de capacidade [wm_capacity_definition]	Garante que as definições de capacidade não estejam em uso antes da exclusão.
Valide a definição geral	Definição de capacidade [wm_capacity_definition]	Valida a definição de capacidade antes de adicioná-la ou atualizá-la.
Valide buckets de capacidade sobrepostos	Buckets de capacidade [wm_capacity_bucket]	Impede a definição de intervalos de tempo sobrepostos em buckets de capacidade.
Validar percentual alocado	Programação de alocação [wm_allocation_schedule]	Valida o valor da porcentagem alocada. O valor deve ser um número inteiro positivo menor ou igual a 100.
Validar percentual alocado	Detalhes da programação de alocação [wm_allocation_schedule_detail]	Valida o valor da porcentagem alocada. O valor deve ser um número inteiro positivo menor ou igual a 100.
Validar intervalo	Detalhes da programação de alocação [wm_allocation_schedule_detail]	Valida se os intervalos de tempo não se sobrepõem.
Validar recorrência	Substituição da atribuição de capacidade [wm_capacity_override]	Valida se as regras de recorrência na substituição de capacidade estão configuradas corretamente.
Validar percentual total	Buckets de capacidade [wm_capacity_bucket]	Garante que a porcentagem total alocada em todos os buckets de capacidade não exceda 100.
Validação para classificação	Substituição da atribuição de capacidade [wm_capacity_override]	Valida a ordem de classificação das reservas de capacidade para garantir a prioridade adequada.

A Gestão de capacidade adiciona as seguintes regras de negócios para o Agendamento de turno para serviço de campo. O plug-in com.snc.sn_fsm_shift_schdlng deve ser instalado para habilitar essas regras de negócio.

Tabela 3. Regras de negócio instaladas com a Gestão de capacidade e reservas para programação de turnos
Regra de negócio	Tabela	Descrição
Atualizar capacidade para demanda	Agenda do agente [sn_shift_planning_agent_schedule]	Atualiza a capacidade quando as métricas de demanda são atualizadas.
Atualize a tabela de métricas de demanda de capacidade	Solicitação de folga da Agenda do agente [sn_shift_planning_agent_schedule_request]	Atualiza a tabela de métricas de demanda para planejamento de território.

A Gestão de capacidade adiciona as seguintes regras de negócios para o Planejamento de território de serviço de campo. Você deve instalar o plug-in com.snc.fsm_territory_planning para habilitar essas regras de negócio.

Tabela 4. Regras de negócios instaladas com a Gestão de capacidade e reservas para Planejamento de território de serviço de campo
Regra de negócio	Tabela	Descrição
Atualize a tabela de métricas de demanda de capacidade	Substituição da atribuição de capacidade [wm_capacity_override]	Atualiza a tabela Métricas de demanda de capacidade (wm_capacity_for_demand) ao atualizar os valores para Limite agregado da programação do agente ou Data de corte agregada da programação do agente Campos para um território de serviço de campo.
Atualize a tabela de métricas de demanda de capacidade	Entrada de programação cmn_schedule_span
Atualize a tabela de métricas de demanda de capacidade	Atribuição de capacidade [wm_capacity_assignment]
Atualize a tabela de métricas de demanda de capacidade	Território [sn_tp_territory]
Atualize a tabela de métricas de demanda de capacidade	Buckets de capacidade [wm_capacity_bucket]
Atualize a tabela de métricas de demanda de capacidade	Programação de trabalho do agente [agent_work_schedule]
Atualizar canal de demanda no WOT	Tarefa de ordem de serviço [wm_task]
Atualize a tabela de métricas de demanda de capacidade	Programação pessoal do agente [agent_events]
Atualize a tabela de métricas de demanda de capacidade	Regra de reserva de capacidade [wm_capacity_reservation_rule]
Atualize a tabela de métricas de demanda para 1 dia	Substituição da atribuição de capacidade [wm_capacity_override]
Atualize a tabela de métricas de demanda de capacidade	Programação de alocação [wm_allocation_schedule]
Atualize a tabela de métricas de demanda de capacidade	Definição de capacidade [wm_capacity_definition]
Atualize a tabela de métricas de demanda de capacidade	Agendamento [cmn_schedule]
Atualize a tabela de métricas de demanda de capacidade	Detalhes da programação de alocação [wm_allocation_schedule_detail]
Atualize a tabela de métricas de demanda de capacidade	Grupo de territórios [sn_tp_territory_group]
Valide o corte agregado da programação do agente	Território [sn_tp_territory]	Valida o valor agregado de dias de corte da programação do agente ou o campo de data na tabela Território. Os dias de corte da programação do agente devem ser um valor inteiro diferente de zero maior ou igual a 0 e menor ou igual a 30.

Nota:

Você deve selecionar usando programação dinâmica em Método de atribuição para tarefas opção de configuração para permitir que sua aplicação distribua trabalho com base nas regras de gestão de capacidade.

Trabalho programado

A Gestão de capacidade e reservas adiciona o seguinte trabalho agendado. Para encontrá-los, navegue até Tudo > sn_schedulejobs.do.

Tabela 5. Trabalho agendado instalado com a Gestão de capacidade e reservas
Trabalho programado	Descrição
Dados de métricas de demanda de capacidade de computação	Calcula e gera dados para o painel Análise de capacidade do território de serviço de campo.

Inclusões de script

A Gestão de capacidade e reservas adiciona as seguintes inclusões de script. Para encontrá-los, navegue até Tudo > Inclusões de script.

Tabela 6. Inclusões de script instaladas com a Gestão de capacidade e reservas
Inclusão de script	Descrição
FSMCapacityAjax	Fornece endpoints AJAX que permitem que scripts de cliente verifiquem a capacidade do agente para tarefas e recuperem detalhes de atribuição dinamicamente do servidor.
FSMCapacityAppnmtBookingUtil	Métodos de utilitário para oferecer suporte ao agendamento de compromissos no FSM. Este método de utilitário recupera grupos de expedição para um local e filtra grupos com base na configuração. Ele também determina os grupos qualificados para atribuição de tarefas durante a programação de compromissos.
FSMCapacityBaseUtil	Classe de utilitário personalizável que estende o FSMCapacityBaseUtilSNC. Esta classe de utilitário fornece métodos para validar e calcular a capacidade.
FSMCapacityBaseUtilSNC	Fornece scripts de utilitário somente leitura para validar e calcular a capacidade.
FSMCapacidadeBucketApi	Gerencia buckets de capacidade, incluindo operações CRUD e alocação de buckets.
FSMCapacidadeBucket ApiSNC	Contém métodos de utilitário para recuperar e mapear buckets de capacidade usados por uma tarefa, com base em detalhes de atribuição e programação. Ele oferece suporte a cálculos avançados de capacidade baseados em bucket e se integra às APIs de uso, reserva e definição.
FSMCapacidadeConstantes	Contém constantes personalizáveis. Estende a classe de constantes de base (FSMCapacityConstantsSNC) e permite substituir ou adicionar novos valores de constante específicos aos requisitos, sem modificar as constantes de base.
FSMCapacidadeConstantsSNC	Contém constantes somente leitura, como nomes de tabela, valores padrão e opções de configuração. Ele centraliza valores estáticos importantes usados em todo o fluxo de trabalho.
FSMCapacidadeCoreApi	Fornece métodos para recuperar e calcular detalhes de capacidade para tarefas, oferecendo suporte ao planejamento de capacidade avançado e ao acompanhamento de uso.
FSMCapacidadeDefiniçãoApi	Fornece classe de API para definições de capacidade. Ele estende a API de base (FSMCapaciityDefinitionApiSNC) e permite gerenciar e substituir a definição de capacidade de acordo com o requisito de negócios.
FSMCapacidadeDefiniçãoApiSNC	Fornece métodos de API para calcular a capacidade total, lidar com substituições e oferecer suporte a diferentes estratégias de cálculo de capacidade com base em atribuição, programação do agente ou horas.
FSMCapacityManagement	Integra-se a várias APIs de gestão de capacidade e reservas para orquestrar verificações, cálculos e atualizações de capacidade. Ele fornece métodos para gerenciar a capacidade, determinando a capacidade para tarefas e a disponibilidade do agente.
FSMCapacityQueryUtil	Classe de utilitário que fornece consulta para encontrar atribuições de programação do agente em uma janela de tempo e recuperar todas as atribuições relevantes com base em qualificadores e intervalos de datas.
FSMCapacidadeReserçãoAlocationApi	Fornece classe de utilitário personalizável para gerenciar capacidade, reservas e alocações. Estende o FSMCapacityReservationAllocationApiSNC.
FSMCapacityReservationAlocationApiSNC	Classe de utilitário somente leitura que lida com capacidade, reservas e alocações. Ele fornece métodos para calcular porcentagens de alocação e capacidades de reserva, oferecendo suporte a programação avançada e planejamento de capacidade.
FSMCapacidadeUsageApi	Classe de API personalizável que gerencia registros de uso de capacidade. Estende o FSMCapacityUsageApiSNC e fornece métodos personalizáveis para lidar com cálculos de uso de capacidade.
FSMCapacidadeUsageApiSNC	Fornece métodos para calcular e recuperar o uso da capacidade total e reservada. Ele aproveita o cache e se integra à definição de capacidade e às APIs de reserva para validar e rastrear o uso com eficiência.
FSMCapacityUtil	Fornece funções de utilitário para garantir verificações de integridade e capacidade de exclusão segura e entidades de Gestão de reservas. Verifica se as definições de capacidade, reservas ou regras de reserva são referenciadas nos registros de uso.
Resposta de CapacidadeOtimização Programada	Contém uma classe de utilitário que fornece métodos para calcular os horizontes de capacidade para grupos ou territórios, a fim de determinar a capacidade disponível e alocada para otimização de tarefas em um intervalo de datas especificado. Nota: O plug-in Otimização de programação (com.snc_schedule_optimization) para Gestão de serviços de campo deve ser instalado para habilitar esta inclusão de script.

A Gestão de capacidade e reservas adiciona as seguintes inclusões de script para o Planejamento de território de serviço de campo. Você deve ativar o. Serviço de campo Plug-in Planejamento de território ( .snc.fsm_territory_planning ) para Gestão de serviços de campopara habilitar essas inclusões de script.

Tabela 7. Inclusões de script instaladas com a Gestão de capacidade e reservas para Serviço de campo Planejamento de território
Inclusão de script	Descrição
FSMDemandManagementConstantes	Estende a classe de constantes FSMDemandManagementConstantsSNC. Ele permite substituir ou adicionar novos valores de constante específicos aos seus requisitos sem modificar as constantes somente leitura de base.
ConstantsGestão Demanda de FSMSNC	Define constantes somente leitura, como nomes de fila, chaves de cálculo de métrica e valores de configuração. Ele centraliza constantes numéricas e de cadeia de caracteres importantes para reutilização em toda a aplicação.
FSMServiçoDemandManagementSNC	Fornece funções básicas de utilitário somente leitura, incluindo métodos para calcular e atualizar dados de métricas para territórios e atribuições de capacidade.
FSMDemandManagementUtil	Classe personalizável que estende o FSMDemandManagementUtilSNC. Ele permite substituir ou adicionar métodos de utilitário de gestão de demanda específicos aos seus requisitos.
FSMDemandManagemExtPoint	Fornece um método para recuperar o canal de demanda padrão. Implementa o ponto de extensão FSMDemandManagementExtPoint, permitindo personalizar a gestão de demanda.
FSMDemandManagementQueryUtil	Classe personalizável que estende a classe FSMDemandManagementQueryUtilSNC somente leitura. Você pode substituir ou adicionar novos métodos no FSMDemandManagementQueryUtil para personalizar a gestão de demanda de acordo com seus requisitos.
FSMDemandDemandQueryUtilSNC	Define funções de utilitário, como buscar o canal de demanda padrão, recuperar tarefas de ordem de serviço futuras e excluir registros de métrica. Ele fornece lógica reutilizável para oferecer suporte aos recursos da Gestão de demandas.

Funções

A Gestão de capacidade e reservas adiciona as seguintes funções. Para encontrá-los, navegue até Tudo > Funções.

Tabela 8. Funções instaladas com a Gestão de capacidade e reservas
Funções	Descrição
sn_fsm_capacity_mg.wm_capacity_write	Permite acesso de CRUD a todas as tabelas relacionadas à capacidade
sn_fsm_capacity_mg.wm_capacity_read	Permite acesso de leitura a todas as tabelas relacionadas à capacidade e ao espaço do console de capacidade