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

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Gestão de serviços de campo Xanadu

ft:clusterId :

    - fsm

bundleId :

    - fsm

workflow :

    - Customer and Industry


---

# Serviço de campo Componentes do Planejamento de territórios

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

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 8 min. de leitura

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

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

Serviço de campo O Planejamento de territórios adiciona as seguintes tabelas.{#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 as condições adicionadas a um território para filtrar o melhor território correspondente a uma ordem de serviço ou tarefa de ordem de serviço. |
| Região do território sn_tp_territory_geografia | Armazena as informações do script geoJSON que são geradas automaticamente ao desenhar uma região 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 for 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 recurso Serviço de campo de Planejamento de territórios]

{#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órios adiciona as funções a seguir.{#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 de território \[sn_fsm_tp.fsm_territory_edit_resource_allocation\] | Edite a alocação de recursos associados ao território Serviço de campo selecionado. |
| Planejador de territórios do FSM \[sn_fsm_tp.fsm_territory_planner\] | Crie novos territórios Serviço de campo junto com a capacidade de exibir os territórios Serviço de campo existentes, gerenciar a alocação de recursos em territórios e outros. |
| Leitura de território do FSM \[sn_fsm_tp.fsm_territory_read\] | Exibir Serviço de campo dados do território. |
| Administrador de 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 de território \[sn_tp.territory_edit_resource_allocation\] | Edite a alocação de recursos associados ao território selecionado. |
| Gravação da região do território \[sn_tp.territory_geografia_write\] | Crie, atualize ou exclua a região 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 de território \[sn_tp.territory_read\] | Exibição de dados do território. |
| Gerente de recursos do território \[sn_tp.territory_resource_manager\] | Gerenciar 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 do território. |
| Gerente de territórios 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 do 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\] | Gerenciar 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 campo recurso de Planejamento de territórios]

{#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órios adiciona as seguintes inclusões de script.{#territory-planning-components-fsm__table_dzh_mml_stb__entry__2}

| Inclusão de script | Descrição |
|-|-|
| FieldServiceTerritoryPlanning | Contém as funções de utilitário para fornecer dados, como detalhes de território, grupos de atribuição ou outros, para agentes de dados. |
| MatchTerritoryCondition | Contém as funções de utilitário Filtrar territórios para a tarefa de ordem de serviço com base nas condições de filtragem usadas pelas regras de correspondência de planejamento de territórios​. |
| TerritoryFilters | Contém métodos para todos os qualificadores de referência para filtrar o território com base nos grupos, agentes, equipes e território primário correspondentes. |
| TerritoryMatchingDimensionLocation | Contém as funções de utilitário para filtrar territórios com base no local da tarefa a ser usado pela regra de correspondência​. |
| TerritoryPlanningHelpers | Contém métodos auxiliares para implementação geral do planejamento de territórios. |
| TerritoryPlanningAJAX | Classe Ajax que fornece funções de ajuda 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 validar o grupo de atribuição selecionado para uma tarefa de ordem de serviço. |
[Tabela 3. Inclusões de script instaladas com o recurso Serviço de campo de Planejamento de territórios]

{#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órios adiciona as seguintes regras de negócio.{#territory-planning-components-fsm__table_amv_vjl_stb__entry__3}

| Regra de negócio | Tabela | Descrição |
|-|-|-|
| Excluir substituição do 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. |
| Preencher 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. |
| Atualizar território se não houver correspondência | 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 estiver 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órios de grupo exclusivos | 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órios​. |
| Calcular caixa delimitadora de geografia | Região do território \[sn_tp_territory_geografia\] | Calcula o valor máximo ou mínimo de latitude e longitude do GeoJSON de geografia do território definido​. |
| Verificar e criar associação de 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 de "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 nos campos De e Até na tabela de substituição de associação de 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 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. |
| Validar nome da região do território | Região do território \[sn_tp_territory_geografia\] | Impede a criação de entradas duplicadas para uma nova região de território. |
| Validar 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. |
| Validar 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 de território esteja associado ao território |
[Tabela 4. Regras de negócio para Serviço de campo Planejamento de territórios]

{#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órios 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 "verdadeira", 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: Todossys_properties_list.do {#territory-planning-components-fsm__ul_ubb_4q2_stb} |
| sn_tp.max_coordenadas_permitidas | Número máximo de coordenadas permitidas na região GeoJSON. Esta propriedade é somente leitura e não é editável. * Tipo: inteiro * Valor padrão: 3250 * Local: TodosPlanejamento de territóriosPropriedades {#territory-planning-components-fsm__ul_q3y_3l2_xzb} |
| sn_tp.percentage_overlap | Valor percentual (de 0 a 100) que indica o limite de sobreposição geográfica entre territórios. O padrão é definido como 5%. * Tipo: inteiro * Valor padrão: 5 * Local: TodosPlanejamento de territóriosPropriedades {#territory-planning-components-fsm__ul_gb5_kl2_xzb} |
[Tabela 5. Propriedades para Serviço de campo Planejamento de territórios]

{#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órios adiciona a seguinte regra de consulta. Você pode encontrar a seguinte regra de consulta clicando em Todossn_query_rule_list.do{#territory-planning-components-fsm__table_zbh_fm1_rzb__entry__2}

| Regra de consulta | Descrição |
|-|-|
| Tarefa 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 as tarefas de ordem de serviço criadas em seus territórios. Marque as tabelas WO - My territory e WOT - MY Territory como ativas. |
[Tabela 6. Regra de consulta para Serviço de campo Planejamento de territórios]

{#territory-planning-components-fsm__table_zbh_fm1_rzb}

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

Serviço de campo O Planejamento de territórios adiciona o seguinte Otimização de cronogramas adiciona os seguintes trabalhos agendados. Você pode encontrar os seguintes trabalhos agendados clicando em Todossn_schedulejobs.do{#territory-planning-components-fsm__table_zbh_fm1_rab__entry__2}

| Trabalho agendado | Descrição |
|-|-|
| Planejamento de territórios - Calcular territórios sobrepostos | Calcula as sobreposições para agentes e regiões. |
| Planejamento de territórios - 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órios - Calcular territórios sobrepostos - Geografia | Calcula as sobreposições para regiões. Quando executado, o trabalho agendado aciona eventos para calcular a sobreposição entre duas regiões. |
[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órios {#ariaid-title2}

O console de Planejamento de territórios 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 limite padrão do agente quando adicionado ao território usando a guia 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 do 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 de dados como agentes e equipes com base na janela de exibição ou no território. * Tipo: lista de seleção * Valor padrão: janela de visualização {#territory-planning-properties-fsm__ul_wd2_1hh_pvb} |
| sn_fsm_tp.territory_inicial_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 o quão opaca uma área geográfica recém-criada aparecerá 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 programar 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 dos 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 do Planejamento de territórios]

{#territory-planning-properties-fsm__table_kkv_np2_stb}