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 os recursos da Web personalizados causarem problemas de execução.
Além de executar o Hub de Integridade da Solução, confira Melhores práticas para a personalização do Dynamics 365 Field Service e Executar o Verificador de Solução para melhorar scripts, plug-ins, HTML e fluxos de trabalho etc.
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:
Abra o aplicativo Hub de Integridade da Solução.
Selecione Trabalhos de análise e crie um novo trabalho de análise.
Quando a caixa de diálogo abrir, selecione Field Service.
Selecione OK e o trabalho de análise começará.
Ver resultados de verificação de integridade
Quando o trabalho de análise terminar de ser executado, o sistema abrirá a página de visão geral.
No trabalho de análise, cada regra mostra um Status de Retorno o que indica se a regra passou, falhou ou tem um erro de configuração. Se uma regra falhar, uma Gravidade indicará 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
Essa regra verifica se todas as ordens de serviço foram geradas corretamente com base em contratos.
Porque falha
Esta regra falha porque as recorrências do contrato não foram processadas corretamente e as ordens de serviço que deveriam ter sido geradas não foram.
Como corrigir
- Identifique o motivo pelo qual a ordem de serviço não foi gerada e a causa da falha.
- Corrija o problema.
- Para reiniciar a geração de registros, altere o Status do Sistema do contrato de volta para 'Estimativa'. Em seguida, altere-o para 'Ativo'.
Cuidado
A alteração do status do contrato exclui todos os registros de dados de reserva de contrato existentes com um status ativo, mas só regenera registros para datas futuras.
Verificar se há um fluxo de trabalho com falha relacionado ao contrato
Gravidade: alta
O que ela verifica
Esta regra verifica se há fluxos de trabalho com falha relacionados aos acordos.
Porque falha
Esta regra falha se houver fluxo de trabalho com falha relacionado à configuração de criação automática de ordens de serviço de contratos ou ao registro de falha na configuração de fatura de contrato.
Como corrigir
Selecione o resultado da análise e selecione Resolver.
Verificar se há contratos ativos com datas de término passadas
Gravidade: alta
O que ela verifica
Esta regra verifica se há contratos nos quais 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, embora sua data de término esteja no passado.
Como corrigir
Selecione o resultado da análise, revise o contrato e selecione Resolver.
Notas e limitações
- A regra valida acordos que têm uma data de término nos últimos 90 dias.
- A regra considera os 5.000 acordos principais com status de sistema ativo e data de término no passado.
- A regra valida apenas contratos que possuem configuração de criação automática de ordens de serviço de contratos e datas de reserva do Contrato.
Verificar se faltam bibliotecas nos formulários
Gravidade: média
O que ela verifica
Esta regra detecta se há formulários do Field Service no sistema que estão com bibliotecas do Field Service ausentes.
Porque falha
Esta regra falha se alguma biblioteca do Field Service estiver ausente para um formulário do Field Service.
Observação
Esta regra pode mostrar uma falha falsa-positiva 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-a com outra forma da mesma tabela ou em 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 de ordem de serviço, esta regra verifica se o número de controles de subgrade ou 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 de produto de ordem de serviço no formulário de 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 falha se a guia padrão (a primeira guia) de qualquer formulário de ordem de serviço tiver mais de 4 controles de subgrades ou 20 controles de pesquisa. O número de controles na guia padrão do formulário afeta o desempenho da carga.
Como corrigir
Reduza o número de campos de pesquisa e controles de subgrade na guia padrão. Mova-os para outras guias do 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 necessário de um campo obrigatório do sistema no formulário Ordem de Serviço ou Contrato foi modificado.
Porque falha
Esta regra falha se o nível necessário de um campo obrigatório do sistema no formulário padrão de Ordem de Serviço ou Acordo do Field Service for modificado.
Como corrigir
- No Power Apps, selecione Tabelas>Todos e procure por Ordem de Serviço ou Contrato.
- Selecione a tabela.
- Em Esquema, selecione Colunas. Localize e selecione o campo listado na análise.
- No painel Editar coluna, altere Obrigatório para 'Negócio Obrigatório' e salve.
Observação
Esta regra é implementada apenas para o campo obrigatório pronto para uso somente em formulários da Ordem de Serviço e do Contrato.
Verifica se há incompatibilidade de revisão nas Datas de Reserva de Contrato nas Configuração de Criação Automática de Ordens de Serviço de Contratos
Gravidade: alta
O que ela verifica
Esta regra valida se as revisões de Data de Reserva do Contrato correspondem às revisões de Configuração de Criação Automática de Ordens de Serviço de Contratos correspondentes.
Porque falha
Esta regra falha se houver uma incompatibilidade com o valor de revisão de uma data de reserva do contrato e sua configuração de reserva do contrato correspondente. Esta regra considera apenas os registos de data de reserva ativos cuja data de reserva é inferior a 90 dias. Se houver uma incompatibilidade, o sistema pode gerar uma 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 registros ativos da Data de Reserva do Contrato nos últimos três meses com base na data da última reserva.
Verifica se há Incompatibilidade de Revisão nas Datas da Fatura do Contrato com as Configurações da Fatura do Contrato
Gravidade: alta
O que ela verifica
Esta regra valida se as revisões da Data de Fatura de Contrato correspondem à revisão da Configuração da Fatura de Contrato correspondente.
Porque falha
Esta regra falha se houver uma incompatibilidade com o valor de revisão da data da fatura do contrato e sua configuração de fatura do contrato correspondente. Esta regra considera os registros de data do acordo ativos cuja data da fatura é 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 registros ativos da Data de Fatura de Contrato nos últimos três meses com base na data da última fatura.
Personalizações no módulo de aplicativo do "Connected Field Service"
Gravidade: baixa
O que ela verifica
Esta regra verifica se há personalizações para um módulo de aplicativo Connected Field Service que está sendo preterido e não deve ser personalizado.
Porque falha
Esta regra falha se 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 há personalizações em qualquer conjunto de opções no Field Service que não devem ser personalizadas. Personalizar conjuntos de opções pode levar a um comportamento inesperado.
Porque falha
Esta regra falha se 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 os recursos da Web personalizados que 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 falha se houver falha em qualquer recurso da Web personalizado que não faz 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 estã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 numeração automática de exclusão 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
Selecione o resultado da análise e selecione Resolver.
Processos excluídos
Gravidade: alta
O que ela verifica
Esta regra verifica se há processos excluídos.
Porque falha
Esta regra falha se algum dos processos prontos para o 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 falha se alguma das etapas de processamento de mensagem de SDK prontos para uso do Field Service 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 falha se qualquer um dos recursos da Web prontos para uso do Field Service forem excluídos 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á etapas de processamento de mensagens do SDK desativadas. As etapas de processamento de mensagens do SDK desativadas resultarão no comportamento incorreto quando o Field Service for usado.
Porque falha
Esta regra falha se alguma das etapas do processamento de mensagens do SDK do Field Service estiverem desabilitadas.
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 dos 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 falha se o registro dos 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 verifica se o registro das configurações do Field Service existe corretamente no sistema.
Porque falha
Esta regra falha 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 há algum formulário no sistema que tenha manipuladores de eventos que façam referência às 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 do contexto de execução seja informado 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
- No Power Apps, selecione Tabelas>Todos e procure por Ordem de Serviço ou Contrato.
- Selecione a tabela.
- Em Experiências com dados, selecione Formulários.
- Selecione a guia Eventos.
- Selecione cada Manipulador de Eventos e habilite Passar o contexto de execução como o primeiro parâmetro.
- Salve e publique o formulário.
Upgrade do Field Service incompleto
Gravidade: baixa
O que ela verifica
Esta regra detecta se o upgrade do Field Service foi iniciado mas não concluído com êxito.
Porque falha
Esta regra falha se uma atualização do Field Service tiver sido iniciada, mas não concluída com êxito.
Como corrigir
Reinicie a atualização do Field Service. Assim que o upgrade for bem-sucedido, essa regra repetirá uma aprovação. Se a atualização falhar novamente, contate o suporte.
Valores de latitude e longitude no registro da conta
Gravidade: baixa
O que ela verifica
Esta regra verifica se há valores de latitude ou longitude em um registro de conta.
Porque falha
Esta regra falha se a latitude, a longitude ou ambos 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 do registro de configuração de criação automática de ordens de serviço de contratos exigiram os privilégios para criar ordens de serviço.
Porque falha
Esta regra falha se os proprietários das configurações de reserva de acordo não tiverem o seguinte privilégio:
1.prvCreatemsdyn_workorder
Como corrigir
Atribua os privilégios a cada proprietário do registro de configuração de criação automática de ordens de serviço de contratos.
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 de registros de configuração de fatura de contrato têm privilégios necessários para criar as faturas.
Porque falha
Esta regra falha se os proprietários da configuração de reserva de acordo não tiverem o seguinte privilégio:
1.prvCreateInvoice
Como corrigir
Atribua os privilégios a cada proprietários de registro de configuração de fatura de contrato.
Definições de processo em status de rascunho
Gravidade: alta
O que ela verifica
Esta regra verifica se quaisquer definições de processo estão em status de rascunho. Se houver processos em status de rascunho, o Field Service não funcionará corretamente.
Porque falha
Esta regra falha se definição do processo estiver em um status de rascunho.
Como corrigir
Reative as definições de processo para que não fiquem no estado 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 algumas definições do processo foram atribuídas aos usuários desativados.
Porque falha
Esta regra falha se quaisquer definições de processo forem atribuídos aos usuários desabilitados, o que poderá fazer com que as atualizações falhem.
Como corrigir
Altere 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 ou não em uma configuração de criação automática de ordens de serviço de contratos e, em caso afirmativo, verifica se é um valor de configuração de recorrência válido.
Porque falha
Esta regra falha se um contrato tiver o Status do Sistema como 'Ativo' e seu registro de configuração de criação automática de ordens de serviço de contratos tiver Gerar Ordem de Trabalho Automaticamente 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 atual instalada do Field Service é compatível com a versão do Agendamento de Recursos Universal.
Porque falha
Essa regra falha 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 contenha 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.
Verificar se a numeração automática foi habilitada
Gravidade: baixa
O que ela verifica
A 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 a exclusividade na numeração das tabelas do Field Service.
Porque falha
A regra falha se a numeração automática não estiver ativada para a organização.
Como corrigir
Aceite a numeração automática no Field Service. Na área Configurações, selecione # 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 atual instalada do Field Service é compatível com a versão do Project Service Automation instalada.
Porque falha
Esta regra falha 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 que têm acesso ao aplicativo móvel do Field Service recebem a função de Field Service-Recurso e o perfil de segurança de campo Field Service-Recurso.
Porque falha
Esta regra falha se um trabalhador da linha de frente tem acesso ao aplicativo móvel do Field Service sem a função Field Service-Recurso ou o perfil de segurança de campo Field Service-Recurso. Se houver mais de uma unidade de negócio na organização, a unidade de negócios do usuário é exibida.
Como corrigir
Adicione a função de segurança Field Service-Recurso e o perfil de segurança de campo do Field Service-Recurso ao usuário. Saiba mais: Configurar 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 algumas instâncias do fluxo de trabalho em espera foram atribuídas aos usuários desativados. Esses fluxos de trabalho não conseguirão gerar corretamente os registros que devem gerar.
Porque falha
Esta regra falha se um fluxo de trabalho no estado suspenso foi atribuído a uma conta de usuário desativada no estado suspenso com o motivo 'Em espera'.
Como corrigir
Dispare o fluxo de trabalho. Consulte a documentação geral ou entre em contato com o suporte.