---
sourceDocument: Yokohama Gestão de serviços de campo
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/yokohama/field-service-management

 Release :

    - yokohama

ft:locale :

    - pt-BR

ft:publication_title :

    - Yokohama Gestão de serviços de campo

ft:clusterId :

    - fsm

bundleId :

    - fsm

workflow :

    - Customer and Industry


---

# Serviço de campo Componentes de Planejamento de território

# Serviço de campo Componentes de Planejamento de território {#ariaid-title1}

* Versão de lançamento: Yokohama
* 
* Atualizado 30 de jan. de 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 8 min. de leitura

Vários tipos de componentes são instalados com o. Serviço de campoRecurso de Planejamento de território, incluindo tabelas, função, inclusões de script e regras de negócios.

## Tabelas {#territory-planning-components-fsm__section_fm1_t1j_stb}

Serviço de campo O Planejamento de território adiciona as tabelas a seguir.{#territory-planning-components-fsm__table_w5n_3bj_stb__entry__2}

| Tabela | Descrição |
|-|-|
| Território sn_tp_territory | Armazena informações sobre territórios, como o nome de um território. |
| Condição do território sn_tp_territory_condition | Armazena condições adicionadas a um território para filtrar o território com melhor correspondência para uma ordem de serviço ou tarefa de ordem de serviço. |
| Região do território sn_tp_territory_geography | Armazena as informações do script geoJSON geradas automaticamente ao desenhar uma região geográfica para os territórios. |
| Grupo de territórios sn_tp_territory_group | Armazena informações sobre os grupos de qualificação, expedição e atribuição atribuídos a um território. |
| Substituição da associação de territórios sn_tp_territory_membership_override | Armazene informações se o agente ou a equipe é membro primário ou secundário do território. |
| Modelo de território sn_tp_territory_model | Armazene informações sobre o modelo de território padrão e seus territórios e recursos mapeados. |
| Origem do modelo de território sn_tp_territory_model_source | Armazene informações sobre as tabelas de origem mapeadas para o modelo de território, como wm_task e wm_order. |
| Gerente de território sn_tp_territory_manager | Armazena informações sobre os gerentes do território. |
[Tabela 1. Tabelas instaladas com o. Serviço de campoRecurso de Planejamento de território]

{#territory-planning-components-fsm__table_w5n_3bj_stb}

## Funções {#territory-planning-components-fsm__section_bzj_v1j_stb}

Serviço de campo O Planejamento de território adiciona as seguintes funções.{#territory-planning-components-fsm__table_rsw_l3l_stb__entry__2}

| Funções | Descrição |
|-|-|
| Serviço de campo Alocação de recursos de edição do território \[sn_fsm_tp.fsm_territory_edit_resource_allocation\] | Edite a alocação de recursos que estão associados ao selecionado Serviço de campoterritório. |
| FSM Territory Planner \[sn_fsm_tp.fsm_territory_planner\] | Criar novo Serviço de campoterritórios, juntamente com a capacidade de exibir os existentes Serviço de campoterritórios, gerencie a alocação de recursos em territórios e outros. |
| FSM - leitura do território \[sn_fsm_tp.fsm_territory_read\] | Exibição Serviço de campodados do território. |
| Administrador do território \[sn_tp.territory_admin\] | Crie novos modelos de território, origens e regras de correspondência. |
| Alocação de recursos de edição do território \[sn_tp.territory_edit_resource_allocation\] | Edite a alocação de recursos que estão associados ao território selecionado. |
| Gravação da geografia do território \[sn_tp.territory_geography_write\] | Crie, atualize ou exclua a região geográfica do território. |
| Planejador de território \[sn_tp.territory_planner\] | Exiba territórios, alocações de recursos e outros, além da capacidade de criar novos territórios. |
| Leitura do território \[sn_tp.territory_read\] | Exibindo dados do território. |
| Gerenciador de recursos do território \[sn_tp.territory_resource_manager\] | Gerencie recursos do território em que o usuário conectado foi atribuído como gerente de recursos |
| Gerente de território \[sn_tp.territory_manager\] \[sn_tp.territory_resource_manager\] | Gerencie territórios e suas informações relacionadas. Além disso, herda a função de gerente de recursos de território. |
| Gerente de território do FSM \[sn_fsm_tp.fsm_territory_manager\] \[sn_tp.territory_manager\] \[sn_tp.territory_resource_manager\] | Gerencie territórios de serviço de campo e suas informações relacionadas. Além disso, herda a função de gerente de recursos de território. |
| Gerente de recursos de território do FSM \[sn_fsm_tp.fsm_resource_manager\] \[sn_tp.territory_manager\] \[sn_tp.territory_resource_manager\] | Gerencie recursos de serviço de campo do território em que o usuário conectado foi atribuído como gerente de recursos |
[Tabela 2. Funções instaladas com o. Serviço de campoRecurso de Planejamento de território]

{#territory-planning-components-fsm__table_rsw_l3l_stb}

## Inclusões de script {#territory-planning-components-fsm__section_xxx_dml_stb}

Serviço de campo O Planejamento de território adiciona as seguintes inclusões de script.{#territory-planning-components-fsm__table_dzh_mml_stb__entry__2}

| Inclusão de script | Descrição |
|-|-|
| FieldServiceTerrioryPlanning | Contém as funções de utilitário para fornecer dados, como detalhes do território, grupos de atribuição ou outros para agentes de dados. |
| MatchTerrioryCondition | Contém as funções de utilitário Filtrar territórios para tarefa de ordem de serviço com base nas condições de filtragem usadas pelas regras de correspondência de planejamento de território​. |
| TerritoryFilters | Contém métodos para que todos os qualificadores de referência filtrem o território com base nos grupos, agentes, equipes e território primário correspondentes. |
| TerritoryMatchingDimensionLocation | Contém as funções do utilitário para filtrar territórios com base no local da tarefa a ser usado pela Regra de correspondência​. |
| Ajudantes de Planejamento de Território | Contém métodos auxiliares para a implementação geral do planejamento de território. |
| TerritoryPlaningAJAX | Classe Ajax que fornece funções auxiliares para verificar se o plug-in de planejamento de território está ativo, obter o modelo padrão, preencher o território no formulário de tarefa de ordem de serviço e valida o grupo de atribuição selecionado para uma tarefa de ordem de serviço. |
[Tabela 3. Inclusões de script instaladas com Serviço de campoRecurso de Planejamento de território]

{#territory-planning-components-fsm__table_dzh_mml_stb}

## Regras de negócio {#territory-planning-components-fsm__section_yrd_gbj_stb}

Serviço de campo O Planejamento de território adiciona as seguintes regras de negócios.{#territory-planning-components-fsm__table_amv_vjl_stb__entry__3}

| Regra de negócio | Tabela | Descrição |
|-|-|-|
| Excluir substituição de agente | Grupo de territórios \[sn_tp_territory_group\] | Exclui o registro de associação modificado de um agente se o grupo correspondente for excluído​do território. |
| Excluir substituição de membro da equipe | Grupo de territórios \[sn_tp_territory_group\] | Exclui o registro de associação modificado de uma equipe se o grupo correspondente for excluído​do território. |
| Preencha os grupos de atribuição | Grupo de territórios \[sn_tp_territory_group\] | Preenche automaticamente os grupos de atribuição correspondentes ao adicionar um grupo de expedição ao território. |
| Atualize o território se não corresponder | Tarefa de ordem de serviço \[wm_task\] | Valida e atribui o melhor território para o grupo de atribuição selecionado​se allow_assignment_override for selecionado. |
| Validar grupo de qualificação | Ordem de serviço \[wm_order\] | Verifica se a ordem de serviço tem um grupo de qualificação válido​. |
| Permitir somente território de grupo exclusivo | Grupo de territórios \[sn_tp_territory_group\] | Impede a adição de uma combinação de grupos duplicados que inclui qualificação, expedidor e atribuição a um território. |
| Permitir somente usuários exclusivos | Substituição da associação de territórios \[sn_tp_territory_membership_override\] | Impede a seleção de usuário duplicado para um território na tabela de substituição de associação de território​. |
| Calcule a caixa delimitadora de geografia | Região do território \[sn_tp_territory_geography\] | Calcula o valor máximo ou mínimo de latitude e longitude da geografia do território definido GeoJSON​. |
| Verifique e crie associação à equipe | Tarefa de ordem de serviço \[wm_task\] | Cria um novo registro de associação de território para a equipe atribuída dinamicamente ao salvar a tarefa de ordem de serviço, definindo as datas "De" e "Até" para corresponder às datas "Início efetivo" e "Término efetivo" da equipe. |
| Validações de data de associação | Substituição da associação de territórios \[sn_tp_territory_membership_override\] | Valida as datas inseridas em De e. Para campos na tabela de substituição de associação do território para um membro do território. |
| Validar campo de cor | Território \[sn_tp_territory\] | Valida o código hexadecimal da cor de um território. |
| Validar primário | Território \[sn_tp_territory\] | Valida a hierarquia de um território primário. |
| Validar tabela de origem para o modelo | Origem do modelo de território \[sn_tp_territory_model_source\] | Impede entradas duplicadas para um modelo e tabela de origem na origem do modelo de território. |
| Validar condição de território | Condição do território \[sn_tp_territory_condition\] | Impede a criação de entradas duplicadas para condições de território para um território específico. |
| Valide o nome geográfico do território | Região do território \[sn_tp_territory_geography\] | Impede a criação de entradas duplicadas para uma nova região geográfica do território. |
| Valide o nome do modelo de território | Modelo de território \[sn_tp_territory_model\] | Impede a criação de entradas duplicadas para um novo modelo de território. |
| Valide o nome do território | Território \[sn_tp_territory\] | Impede a criação de entradas duplicadas para um novo território. |
| Validar usuário e território | Substituição da associação de territórios \[sn_tp_territory_membership_override\] | Garante que o usuário adicionado à tabela de substituição de associação do território esteja associado ao território |
[Tabela 4. Regras de negócios para Serviço de campoPlanejamento de território]

{#territory-planning-components-fsm__table_amv_vjl_stb}

## Propriedades {#territory-planning-components-fsm__section_r2q_vfq_5zb}

Serviço de campo O Planejamento de território adiciona as seguintes propriedades do sistema. {#territory-planning-components-fsm__table_s2q_vfq_5zb__entry__2}

| Propriedade | Descrição |
|-|-|
| sn_fsm.use_query_rules | Quando a configuração for "verdadeiro", as regras da tabela "sn_query_rule" controlarão quais dados relacionados à Gestão de serviços de campo um usuário pode ler. Isso inclui ordens de serviço (WO) e tarefas de ordem de serviço (WOT). Se definido como "falso", esses registros não serão filtrados com base em regras e os usuários poderão acessá-los sem restrições baseadas em regras. * Tipo: booleano * Valor padrão : Falso * Local: Tudosys_properties_list.do {#territory-planning-components-fsm__ul_ubb_4q2_stb} |
| sn_tp.max_coordinates_allowed | Número máximo de coordenadas permitidas na Geografia GeoJSON. Esta propriedade é somente leitura e não é editável. * Tipo: inteiro * Valor padrão : 3250 * Local: TudoPlanejamento de territóriosPropriedades {#territory-planning-components-fsm__ul_q3y_3l2_xzb} |
| sn_tp.percentage_overlap | Valor percentual (variando de 0 a 100) que indica o limite para sobreposição geográfica entre territórios. O padrão é definido como 5%. * Tipo: inteiro * Valor padrão: 5 * Local: TudoPlanejamento de territóriosPropriedades {#territory-planning-components-fsm__ul_gb5_kl2_xzb} |
[Tabela 5. Propriedades para Serviço de campoPlanejamento de território]

{#territory-planning-components-fsm__table_s2q_vfq_5zb}

## Regras de consulta {#territory-planning-components-fsm__section_ybh_fm1_rzb}

Serviço de campo O Planejamento de território adiciona a seguinte regra de consulta. Você pode encontrar a regra de consulta a seguir clicando em Tudosn_query_rule_list.do{#territory-planning-components-fsm__table_zbh_fm1_rzb__entry__2}

| Regra de consulta | Descrição |
|-|-|
| Tarefa do wm - Meu território atribuído | Permite que os administradores habilitem a segurança de dados para agentes, expedidores e qualificadores para ordens de serviço e tarefas de ordem de serviço. Isso os ajuda a ver as ordens de serviço e tarefas de ordem de serviço criadas em seus territórios. Marque WO - My territorye. WOT - MY Territorytabelas como ativas. |
[Tabela 6. Regra de consulta para Serviço de campoPlanejamento de território]

{#territory-planning-components-fsm__table_zbh_fm1_rzb}

## Trabalhos agendados {#territory-planning-components-fsm__section_ybh_fm1_rab}

Serviço de campoO Planejamento de território adiciona o seguinte Otimização de cronogramasadiciona os seguintes trabalhos agendados. Você pode encontrar os seguintes trabalhos agendados clicando em Tudosn_schedulejobs.do{#territory-planning-components-fsm__table_zbh_fm1_rab__entry__2}

| Trabalho agendado | Descrição |
|-|-|
| Planejamento de território- Calcular territórios sobrepostos | Calcula as sobreposições para agentes e regiões geográficas. |
| Planejamento de território - Calcular territórios sobrepostos - Agente | Calcula as sobreposições dos agentes. Quando executado, o trabalho agendado aciona eventos para calcular a sobreposição entre dois agentes. |
| Planejamento de território - Calcular territórios sobrepostos - Geografia | Calcula as sobreposições para regiões geográficas. Quando executado, o trabalho agendado aciona eventos para calcular a sobreposição entre duas regiões geográficas. |
[Tabela 7. Trabalhos agendados para Otimização de cronogramas]

{#territory-planning-components-fsm__table_zbh_fm1_rab}

## Serviço de campo Propriedades do console de Planejamento de território {#ariaid-title2}

O console de Planejamento de território usa as seguintes propriedades.
Você pode encontrar essas propriedades clicando em Serviços de CampoPlanejamento de territóriosPropriedades.{#territory-planning-properties-fsm__table_kkv_np2_stb__entry__2}

| Propriedades | Definição |
|-|-|
| sn_fsm_tp.territory_membership_override_to_date | Determina o campo de data padrão do agente até quando adicionado ao território usando o. Agentes sugeridos . Os agentes estão disponíveis no território até a data especificada. |
| sn_fsm_tp.territory_max_zoom_level | Define o nível máximo de zoom automático para o mapa. Os valores válidos estão entre 1 e 20. * Tipo: inteiro * Valor padrão : 12 {#territory-planning-properties-fsm__ul_c3d_1q2_stb} |
| sn_fsm_tp.overlay_markers_type | Determina a exibição dos dados, como agentes e equipes, com base na porta ou território de exibição. * Tipo : Lista de seleção * Valor padrão Janela de visualização {#territory-planning-properties-fsm__ul_wd2_1hh_pvb} |
| sn_fsm_tp.territory_initial_zoom | Define o nível de zoom inicial do mapa. * Tipo: inteiro * Valor padrão: 3 {#territory-planning-properties-fsm__ul_i4c_gq2_stb} |
| sn_fsm_tp.territory_transparency_level | Determina a opacidade de uma área geográfica recém-criada no mapa. * Tipo: inteiro * Valor padrão: 1 {#territory-planning-properties-fsm__ul_ubb_4q2_stb} |
| sn_fsm_tp.territory_map_type | Usa diferentes tipos de exibições de mapa para visualizar territórios, como roadmap, satélite, híbrido e terreno. * Tipo: lista de seleção * Valor padrão : roadmap {#territory-planning-properties-fsm__ul_jqr_wq2_stb} |
| sn_fsm_tp.max_territories_for_scheduling | Determina o número máximo de territórios que estão prontos para agendar tarefas de ordem de serviço. * Tipo: inteiro * Valor padrão: 100 {#territory-planning-properties-fsm__ul_gdd_2r2_stb} |
| Nível de opacidade do mapa térmico no mapa | Determina a opacidade do mapa térmico. Os valores válidos estão entre 0,0 e 1,0. * Tipo: inteiro * Valor padrão : 0,6 {#territory-planning-properties-fsm__ul_c2l_2dp_dyb} |
| Raio de influência de pontos de dados no mapa térmico | Determina o raio que influencia o ponto de dados no mapa térmico. * Tipo: inteiro * Valor padrão : 20 (pixels) {#territory-planning-properties-fsm__ul_qqk_rdp_dyb} |
[Tabela 8. Propriedades de Planejamento de território]

{#territory-planning-properties-fsm__table_kkv_np2_stb}