Compartilhar via


Solucionar problemas com o Hub de Integridade da Solução

O Hub de Integridade da Solução permite que você tenha a melhor informação sobre o estado do ambiente e detecte problemas com o ambiente do Dynamics 365. O Hub de Integridade da Solução executa regras na instância para validar a configuração do ambiente, que pode ser alterada com o tempo por meio de operações naturais sistema. Algumas regras são específicas do Dynamics 365 Field Service e você pode executar as regras sob demanda quando você tiver um problema. Algumas regras são disparadas automaticamente quando o Field Service é instalado ou atualizado. Execute regularmente o ruleset do Field Service para monitorar a integridade do ambiente.

Veja alguns problemas comuns que o Hub de Integridade da Solução detecta:

  • Se os processos críticos do Field Service estiverem desativados.
  • Se processos que causam uma falha na atualização forem atribuídos a usuários desativados.
  • Se recursos da web personalizados levarem a problemas de tempo de execução.

Além de executar Hub de Integridade da Solução, confira as melhores práticas para personalizar Dynamics 365 Field Service e executar o Solution Checker para melhorar scripts, plugins, HTML e fluxos de trabalho

Pré-requisitos

  • Field Service v8.4.0.338+ (Interface Unificada) ou v7.5.7.87+ (Web)
  • O Hub de Integridade da Solução estende o Verificador do Power Apps para garantir operação íntegra contínua de um ambiente.

Executar a verificação de integridade

Para executar um trabalho de análise do Field Service:

  1. Abra o aplicativo Hub de Integridade da Solução.

    Captura de tela do Hub de Integridade da Solução na navegação.

  2. Selecione Trabalhos de análise e crie um novo trabalho de análise.

  3. Quando a caixa de diálogo abrir, selecione Field Service.

  4. Selecione OK e o trabalho de análise começará.

Ver resultados de verificação de integridade

Quando a execução do trabalho de análise termina, o sistema abre a página de visão geral.

Captura de tela de uma visão geral de trabalho de análise concluído.

No trabalho de análise, cada regra mostra um Status de Retorno indicando se a regra foi aprovada, falhou ou tem um erro de configuração. Se uma regra falhar, uma Gravidade indica a gravidade do problema.

Status de retorno de regra Recomendação
Falha Falhas específicas destacas no sistema; corrija a regra conforme a sugestão.
Aviso Conheça as implicações mencionadas na mensagem da regra.
Passe Indica se não há problemas com essa regra. Todas as regras devem estar nesse estado.

Geração de Ordem de Serviço do Contrato

Gravidade: alta

O que ela verifica

Esta regra verifica se todas as ordens de serviço foram geradas corretamente com base nos acordos.

Porque falha

Esta regra falha porque as recorrências de acordos não foram processadas corretamente e as ordens de serviço não foram geradas como deveriam.

Como corrigir

  1. Identifique o motivo pelo qual o ordem de serviço não foi gerado e a causa da falha.
  2. Corrija o problema.
  3. Para reiniciar a geração do registro, altere o acordo Status do Sistema de volta para 'Estimativa'. Em seguida, altere para "Ativo".

Cuidado

Alterar o status do contrato exclui todos os registros de dados de reserva de contrato existentes com status ativo, mas somente regenera registros para datas futuras.

Geração de contrato de integridade da solução no Hub de Integridade da Solução.

Gravidade: alta

O que ela verifica

Esta regra verifica se há falhas nos fluxos de trabalho relacionados a acordos.

Porque falha

Esta regra falhará se There for um fluxo de trabalho com falha relacionado aos registros de configuração de reserva do acordo ou de configuração de nota fiscal do acordo.

Como corrigir

Select o resultado da análise e Select Resolver.

Verificar se há contratos ativos com datas de término passadas

Gravidade: alta

O que ela verifica

Esta regra verifica acordos em que o Status do Sistema é 'Ativo', mas a data de término está no passado. O status deve ser "Expirado".

Porque falha

Esta regra falha se o status do sistema de um contrato estiver ativo, mesmo que sua data de término esteja no passado.

Como corrigir

Select o resultado da análise, revise o acordo e Select Resolva.

Notas e limitações

  • A regra é válida para acordos com data de término nos últimos 90 dias.
  • A regra considera os 5.000 principais acordos com status de sistema ativo e data de término no passado.
  • A regra valida apenas acordos que tenham configurações de reserva de acordo e datas de reserva de acordo.

Verificar se faltam bibliotecas nos formulários

Gravidade: média

O que ela verifica

Esta regra detecta se There são formulários do Field Service no sistema que não possuem bibliotecas do Field Service.

Porque falha

Esta regra falhará se alguma biblioteca do Field Service estiver faltando para um formulário do Field Service.

Observação

Esta regra pode mostrar uma falha de falso positivo no formulário 'Nível de preço'.

Como corrigir

Adicione as bibliotecas ausentes ao formulário. Você pode obter a lista de bibliotecas necessárias comparando com outro formulário da mesma tabela ou de outra organização. Entre em contato com o suporte para obter assistência.

Verificar se os formulários têm personalizações não íntegras

Gravidade: alta

O que ela verifica

Para todos os formulários ordem de serviço, esta regra verifica se o número de controles de subgrade ou controles de pesquisa excede o limite, o que pode afetar o desempenho. O limite é de 4 subgrades ou 20 pesquisas. Essa regra aciona uma notificação aos administradores do sistema informando quais formulários têm muitos controles de subgrade ou controles de pesquisa.

Um controle de subgrade é uma tabela no formato que lista os registros de outra tabela. Por exemplo, o controle de subgrade do produto ordem de serviço no formulário ordem de serviço que está incluído no Field Service pronto para uso.

Um controle de pesquisa é um campo no formulário que pesquisa os registros de outra tabela e permite selecionar um ou mais registros para preencher o campo.

Porque falha

Esta regra falhará se a guia padrão (a primeira guia) de qualquer formulário ordem de serviço tiver mais de 4 controles de subgrade ou 20 controles de pesquisa. O número de controles na guia padrão do formulário afeta o desempenho do carregamento.

Como corrigir

Reduza o número de campos de pesquisa e controles de subgrade na guia padrão. Mova-os para outras guias no formulário ou oculte-os do formulário se não forem necessários.

Confira mais formas de Melhorar o tempo de carregamento do formulário.

Verifique se o nível necessário de campos foi modificado

Gravidade: alta

O que ela verifica

Esta regra verifica se o nível obrigatório de um campo obrigatório do sistema no formulário ordem de serviço ou Contrato foi modificado.

Porque falha

Esta regra falhará se o nível obrigatório de um campo obrigatório do sistema no formulário pronto para uso do Field Service ordem de serviço ou do Contrato for modificado.

Como corrigir

  1. Em Power Apps, Select Tabelas>Todas e pesquise por ordem de serviço ou Acordo.
  2. Select a tabela.
  3. Em Esquema, selecione Colunas. Localize e Select o campo listado na análise.
  4. No painel Editar coluna , altere Obrigatório para 'Negócios Obrigatórios' e salve.

Observação

Esta regra é implementada apenas para o campo obrigatório pronto para uso nos formulários ordem de serviço e Contrato.

Verificações de incompatibilidade de revisão em datas de reserva de acordo com configurações de reserva de acordo

Gravidade: alta

O que ela verifica

Esta regra valida se as revisões da Data de reserva do contrato correspondem às revisões da Configuração de reserva do contrato correspondente.

Porque falha

Esta regra falha se There for uma incompatibilidade com o valor de revisão de uma data de reserva de acordo e sua configuração de reserva de acordo correspondente. Esta regra considera apenas registros de data de reserva ativa cuja data de reserva seja inferior a 90 dias. Se There for uma incompatibilidade, o sistema poderá não gerar um ordem de serviço para essa data de reserva.

Como corrigir

Entre em contato com o suporte.

Notas e limitações

Esta regra considera os 5.000 principais registros ativos de Data de reserva do contrato nos últimos três meses com base na última data de reserva.

Verificações de incompatibilidade de revisão em datas de faturas de acordo com configurações de faturas de acordo

Gravidade: alta

O que ela verifica

Esta regra valida se as revisões da Data da nota fiscal do contrato correspondem à revisão da Configuração da nota fiscal do contrato correspondente.

Porque falha

Esta regra falha se There for uma incompatibilidade com o valor de revisão da data da nota fiscal do acordo e sua configuração de nota fiscal do acordo correspondente. Esta regra considera registros de data de nota fiscal de acordo ativo cuja data de nota fiscal é inferior a 90 dias. Se houver uma incompatibilidade, o sistema talvez não gere uma fatura para essa data.

Como corrigir

Entre em contato com o suporte.

Notas e limitações

Esta regra considera os 5.000 principais ativos Data da nota fiscal do acordo registros nos últimos três meses com base na última data da nota fiscal.

Personalizações no módulo do aplicativo 'Connected Field Service'

Gravidade: baixa

O que ela verifica

Esta regra verifica se There são personalizações do módulo do aplicativo Connected Field Service que está sendo descontinuado e não deve ser personalizado.

Porque falha

Esta regra falhará se There houver alguma personalização no módulo do aplicativo Connected Field Service na organização.

Como corrigir

Remova as personalizações do módulo do aplicativo Connected Field Service.

Conjuntos de opções personalizadas

Gravidade: alta

O que ela verifica

Esta regra detecta se There são personalizações para qualquer conjunto de opções no Field Service que não deveria ser personalizado. Personalizar conjuntos de opções pode levar a um comportamento inesperado.

Porque falha

Esta regra falhará se There houver alguma personalização em qualquer um dos conjuntos de opções padrão do Field Service. Adições aos conjuntos de opções não contam como falhas, apenas modificações nas opções nos conjuntos de opções.

Como corrigir

Remova manualmente as personalizações dos conjuntos de opções do Field Service.

Recursos da Web personalizados

Gravidade: alta

O que ela verifica

Esta regra detecta quais recursos da Web personalizados não fazem parte do pacote do Field Service. Os recursos da Web personalizados não são atualizados com uma atualização do Field Service e podem levar a problemas de funcionalidade.

Porque falha

Esta regra falhará se existir algum recurso da Web personalizado que não faça parte do pacote do Field Service.

Como corrigir

Remova as personalizações por meio da interface do usuário das camadas de solução nos recursos da Web que são personalizados. Quando o Field Service é atualizado, os recursos da Web podem ser atualizados corretamente.

Excluir verificação do fluxo de trabalho dos números exclusivos do Field Service

Gravidade: baixa a média

O que ela verifica

Esta regra valida se o fluxo de trabalho de exclusão automática de números em massa é executado corretamente.

Porque falha

Esta regra falha se o fluxo de trabalho de exclusão de número exclusivo estiver falhando.

Como corrigir

Select o resultado da análise e Select Resolver.

Processos excluídos

Gravidade: alta

O que ela verifica

Esta regra verifica se há processos excluídos.

Porque falha

Esta regra falhará se qualquer um dos processos prontos para uso do Field Service for excluído.

Como corrigir

Entre em contato com o suporte.

Etapas de processamento de mensagens do SDK excluídas

Gravidade: alta

O que ela verifica

Esta regra verifica se há etapas de processamento de mensagens do SDK excluídas.

Porque falha

Esta regra falhará se qualquer uma das etapas de processamento de mensagens prontas para uso do Field Service SDK for excluída.

Como corrigir

Entre em contato com o suporte.

Recursos da Web excluídos

Gravidade: alta

O que ela verifica

Esta regra verifica se há recursos da web excluídos.

Porque falha

Esta regra falhará se algum dos recursos da Web prontos para uso do Field Service tiver sido excluído do sistema.

Como corrigir

Entre em contato com o suporte.

Etapas de processamento de mensagens do SDK desativadas

Gravidade: alta

O que ela verifica

Esta regra verifica se há alguma etapa de processamento de mensagens do SDK desabilitada. As etapas de processamento de mensagens do SDK desativadas resultarão no comportamento incorreto quando o Field Service for usado.

Porque falha

Esta regra falhará se qualquer uma das etapas de processamento de mensagens do Field Service SDK estiver desabilitada.

Como corrigir

Habilite as etapas de processamento de mensagens do SDK que estejam desabilitadas.

Configuração de Metadados de Definição de Reserva do Field Service

Gravidade: alta

O que ela verifica

Esta regra valida se o registro de metadados de configuração de reserva do Field Service existe corretamente no sistema. Se o registro estiver ausente, a funcionalidade de agendamento talvez não funcione conforme o esperado.

Porque falha

Esta regra falhará se o registro de metadados de configuração de reserva do Field Service não existir no sistema.

Como corrigir

Entre em contato com o suporte.

Configurações do Field Service

Gravidade: alta

O que ela verifica

Esta regra valida se o registro de configurações do Field Service existe corretamente no sistema.

Porque falha

Esta regra falhará se o registro de configurações do Field Service não existir ou não estiver configurado corretamente.

Como corrigir

O sistema recria esse registro se ele não existir durante o uso normal do Field Service. Se o registro não for regenerado automaticamente, contate o suporte.

Contexto de execução de formulários ausente

Gravidade: alta

O que ela verifica

Esta regra detecta se There há formulários no sistema que têm manipuladores de eventos que fazem referência a bibliotecas do Field Service sem passar o parâmetro de contexto de execução.

Porque falha

Esta regra falha porque o código do Field Service espera que o parâmetro de contexto de execução seja passado no manipulador de eventos OnLoad. Se este valor estiver ausente, ele poderá causar erros quando o formulário for usado.

Observação

O cenário mais comum em que essa regra apresenta uma falha é quando uma cópia de um dos formulários prontos para uso está presente (versões do Field Service anteriores a 8.X) e o Field Service é atualizado. Nesses cenários, esses formulários copiados de versões anteriores do Field Service não teriam o ExecutionContext parameter nesses formulários que não são prontos para uso.

Como corrigir

  1. Em Power Apps, Select Tabelas>Todas e pesquise por ordem de serviço ou Acordo.
  2. Select a tabela.
  3. Em Experiências com dados, selecione Formulários.
  4. Select a aba Eventos .
  5. Select each Manipulador de Eventos e enable Passa o contexto de execução como primeiro parâmetro.
  6. Salve e publique o formulário.

Upgrade do Field Service incompleto

Gravidade: baixa

O que ela verifica

Esta regra detecta se uma atualização do Field Service foi iniciada, mas não concluída com sucesso.

Porque falha

Esta regra falhará se uma atualização do Field Service foi iniciada, mas não concluída com sucesso.

Como corrigir

Reinicie a atualização do Field Service. Quando a atualização for bem-sucedida, esta regra repetirá uma passagem. Se a atualização falhar novamente, entre em contato com o suporte.

Valores de latitude e longitude no registro da conta

Gravidade: baixa

O que ela verifica

Esta regra verifica se há algum valor de latitude ou longitude em um registro de conta.

Porque falha

Esta regra falha se latitude, longitude ou ambas não estiverem presentes em um registro de conta.

Como corrigir

Verifique se o endereço no formulário de conta é fornecido. Nesse caso, geocodifique a conta selecionando o botão de código geográfico na barra de comando do formulário de conta.

Verificação de privilégio para proprietários de Configuração de Criação Automática de Ordens de Serviço de Contratos

Gravidade: alta

O que ela verifica

Esta regra verifica se os proprietários de registros de configuração de reserva de acordo têm os privilégios necessários para criar ordens de serviço.

Porque falha

Esta regra falhará se os proprietários da configuração de reserva do acordo não tiverem o seguinte privilégio:

1.prvCreatemsdyn_workorder

Como corrigir

Atribua o privilégio a cada proprietário de registro de configuração de reserva de acordo.

Verificação de privilégio para proprietários de Configuração de Fatura de Contratos

Gravidade: alta

O que ela verifica

Esta regra verifica se os proprietários dos registros de configuração de faturas do acordo têm os privilégios necessários para criar faturas.

Porque falha

Esta regra falhará se os proprietários da configuração da nota fiscal do acordo não tiverem o seguinte privilégio:

1.prvCreateInvoice

Como corrigir

Atribua o privilégio a cada proprietário de registro de configuração de nota fiscal do acordo.

Definições de processo em status de rascunho

Gravidade: alta

O que ela verifica

Esta regra verifica se alguma definição de processo está em status de rascunho. Se houver processos em status de rascunho, o Field Service não funcionará corretamente.

Porque falha

Esta regra falha se qualquer definição de processo estiver em status de rascunho.

Como corrigir

Reative as definições de processo para que elas não fiquem em status de rascunho.

Definições de processo de propriedade de usuários desabilitados

Gravidade: média a alta

O que ela verifica

Esta regra verifica se alguma definição de processo é atribuída a usuários desabilitados.

Porque falha

Esta regra falhará se alguma definição de processo for atribuída a usuários desabilitados, o que pode causar falha nas atualizações.

Como corrigir

Alterar o proprietário do processo para um usuário ativo.

Recorrência na configuração de criação automática de ordens de serviço de contratos

Gravidade: alta

O que ela verifica

Esta regra verifica se a configuração de recorrência está definida em uma configuração de reserva de contrato e se é um valor de configuração de recorrência válido.

Porque falha

Esta regra falhará se um contrato tiver o Status do sistema como 'Ativo' e seu registro de configuração de reserva de contrato tiver a opção Gerar automaticamente ordem de serviço definida como 'Sim', mas a configuração de recorrência não estiver configurada ou não estiver configurada corretamente.

Como corrigir

Configure uma recorrência válida em Configuração de reserva de contrato e selecione Contrato>Configuração de reserva de contrato>Recorrência de reserva.

Verificação de compatibilidade da versão do Agendamento de Recursos Universal

Gravidade: baixa

O que ela verifica

Esta regra verifica se a versão instalada atual do Field Service é compatível com a versão do Agendamento de Recursos Universal.

Porque falha

Esta regra falhará se a solução Agendamento de Recursos Universal instalada na organização não for compatível com a versão instalada do Field Service. Isso pode acontecer se outro pacote que contém a solução Agendamento de Recursos Universal for instalado e atualizar a versão da solução Agendamento de Recursos Universal.

Como corrigir

Atualize a solução listada na mensagem de aviso para que ela seja compatível com o Field Service.

Verifique se a numeração automática está habilitada

Gravidade: baixa

O que ela verifica

Esta regra verifica se a numeração automática está ativada para a organização. Recomendamos que os clientes usem a nova funcionalidade de numeração automática para garantir exclusividade na numeração das tabelas do Field Service.

Porque falha

Esta regra falhará se a numeração automática não estiver ativada para a organização.

Como corrigir

Opte pela numeração automática no Field Service. Na área Configurações , Select # Numeração automática.

Verificar se as soluções do Field Service e do Project Service Automation são compatíveis

Gravidade: baixa

O que ela verifica

Esta regra verifica se a versão instalada atual do Field Service é compatível com a versão do Project Service Automation instalada.

Porque falha

Esta regra falhará se a versão da solução Project Service Automation instalada na organização não for compatível com a solução Field Service instalada na organização.

Como corrigir

Atualize a solução listada na mensagem de aviso para que ela seja compatível com o Field Service.

Verificar direitos de acesso de usuários de dispositivo móvel

Gravidade: alta

O que ela verifica

Esta regra verifica se os trabalhadores da linha de frente com acesso ao aplicativo móvel Field Service têm atribuída a função Field Service-Resource e o perfil de segurança de campo Field Service-Resource .

Porque falha

Esta regra falhará se um trabalhador da linha de frente tiver acesso ao aplicativo móvel Field Service sem a função Field Service-Resource ou o perfil de segurança de campo Field Service-Resource . Se There tiver mais de uma unidade de negócios na organização, a unidade de negócios do usuário será exibida.

Como corrigir

Adicione o Field Service-Resource direito de acesso e o perfil de segurança de campo Field Service-Resource ao usuário. Saiba mais: Configure trabalhadores da linha de frente.

Aguardando instâncias de fluxo de trabalho pertencentes a usuários desabilitados

Gravidade: alta

O que ela verifica

Esta regra verifica se alguma instância de fluxo de trabalho em espera está atribuída a usuários desabilitados. Esses fluxos de trabalho não conseguirão gerar corretamente os registros que devem gerar.

Porque falha

Esta regra falhará se um fluxo de trabalho suspenso for atribuído a uma conta de usuário desabilitada no estado suspenso com o motivo "Aguardando".

Como corrigir

Dispare o fluxo de trabalho. Consulte a documentação geral ou entre em contato com o suporte.

Próximas etapas

Solução de problemas do Dynamics 365 Field Service