Considerações de personalização para o formulário de ordem de serviço

Este artigo lista considerações comuns ao personalizar o formulário de ordem de serviço no Dynamics 365 Field Service. Além disso, este artigo lista componentes de código ou controles PCF que estão disponíveis no designer de formulários ao editar um formulário de ordem de trabalho. Os criadores podem usar esses componentes em seus formulários e visualizações para personalizar a experiência para seus usuários. Saiba mais sobre Controles de Código na documentação para desenvolvedores do Power Apps.

Cabeçalho do formulário de ordem de trabalho e barra de comandos

• Cabeçalho: totalmente personalizável. Os criadores podem alterar as informações mostradas no Maker Portal. Eles também podem ocultar seções ou guias e criar as próprias guias personalizadas.
• Alternadores de formulário: os criadores podem controlar quais formulários os usuários podem ver com base em funções de segurança.
• Barra de comandos: usa a barra de comandos simplificada por padrão. Os administradores podem desativar a configuração Mostrar Comandos da Ordem de Serviço Simplificados. Se um comando personalizado desaparecer, você pode ir ao portal do criador e torná-lo visível novamente.

Subgrades da ordem de serviço como pop-ups

Configure subentidades de ordem de trabalho para aparecerem como caixas de diálogo e edite-as sem sair do formulário de ordem de trabalho. Essa configuração ajuda os expedidores a manter o contexto da ordem de serviço. Os administradores podem ativar a configuração Registros da Subgrade da Ordem de Serviço abertos como pop-ups em Configurações do Field Service>Outros.

Comandos simplificados de ordem de trabalho

A barra de comandos da ordem de serviço usa a exibição simplificada por padrão e só mostra os comandos mais relevantes. Para exibir todos os comandos, os administradores podem desativar a configuração Mostrar Comandos de Ordem de Trabalho Simplificados nas Configurações> de Serviçode Campo Ordem de Trabalho / Reserva.

Você pode personalizar a barra de comandos para mostrar os comandos relevantes no contexto.

Status personalizados de ordem de serviço

Não edite os status do sistema de ordens de trabalho porque as tarefas do sistema e os plug-ins dependem desses status. Em vez disso, os administradores podem criar substatus de ordem de serviço personalizados que mapeiam para os status do sistema da ordem de serviço. Para obter mais informações, consulte Não editar valores do conjunto de opções (escolha).

Adicionar mapas ao formulário de ordem de trabalho

Se você remover manualmente o controle de mapas do formulário padrão de ordem de trabalho, não pode adicioná-lo de novo.

Para ativar o botão de mapas no designer do formulário, adicione a máscara ValidForMap a pelo menos um dos atributos do tipo de endereço no formulário.

<DisplayMask>ValidForAdvancedFind\|ValidForForm\|ValidForGrid\|ValidForMap</DisplayMask>

1. Crie uma solução em um ambiente sandbox que inclua o formulário ao qual você quer adicionar o controle de mapas. Exporte como solução gerenciada.

2. No arquivo customizations.xml da solução, vá para a seção formxml.

3. Adicione o seguinte controle de mapas ao <controlDescriptions>.

        <controlDescription forControl="{8b67ae03-1701-54d2-09be-35295876ca8a}">

        <customControl id="{4273EDBD-AC1D-40d3-9FB2-095C621B552D}">

        <parameters>

        <datafieldname>msdyn\_mapcontrol</datafieldname>

        </parameters>

        </customControl>

        <customControl formFactor="0" name="MscrmControls.Map.MapControl">

        <parameters>

        <value>msdyn\_mapcontrol</value>

        <mapSourceSwitch isGroup="true" static="true">CoordinatesGroup</mapSourceSwitch>

        <latitude>msdyn\_latitude</latitude>

        <longitude>msdyn\_longitude</longitude>

        <addressEditableSwitch isGroup="true" static="true">isAddressEditableYesGroup</addressEditableSwitch>

        <outputLatitude>msdyn\_latitude</outputLatitude>

        <outputLongitude>msdyn\_longitude</outputLongitude>

        </parameters>

        </customControl>

        <customControl formFactor="1" name="MscrmControls.Map.MapControl">

        <parameters>

        <value>msdyn\_mapcontrol</value>

        <mapSourceSwitch isGroup="true" static="true">CoordinatesGroup</mapSourceSwitch>

        <latitude>msdyn\_latitude</latitude>

        <longitude>msdyn\_longitude</longitude>

        <addressEditableSwitch isGroup="true" static="true">isAddressEditableYesGroup</addressEditableSwitch>

        <outputLatitude>msdyn\_latitude</outputLatitude>

        <outputLongitude>msdyn\_longitude</outputLongitude>

        </parameters>

        </customControl>

        <customControl formFactor="2" name="MscrmControls.Map.MapControl">

        <parameters>

        <value>msdyn\_mapcontrol</value>

        <mapSourceSwitch isGroup="true" static="true">CoordinatesGroup</mapSourceSwitch>

        <latitude>msdyn\_latitude</latitude>

        <longitude>msdyn\_longitude</longitude>

        <addressEditableSwitch isGroup="true" static="true">isAddressEditableYesGroup</addressEditableSwitch>

        <outputLatitude>msdyn\_latitude</outputLatitude>

        <outputLongitude>msdyn\_longitude</outputLongitude>

        </parameters>

        </customControl>

        </controlDescription>

1. Pesquise "Mapas" no mesmo arquivo.

2. Adicione o controle com o código seguinte à linha e célula onde você quer adicioná-lo.

    <control disabled="false" id="msdyn\_mapcontrol" classid="{F9A8A302-114E-466A-B582-6771B2AE0D92}" uniqueid="{8b67ae03-1701-54d2-09be-35295876ca8a}" datafieldname="msdyn\_mapcontrol"/>

1. Salve o arquivo e crie um novo arquivo zip da solução gerenciada.

2. Importe a solução no ambiente afetado.

Controles do formulário de ordem de trabalho

Os seguintes controles estão disponíveis para uso em formulários personalizados de ordem de trabalho. Revise cada controle para opções e limitações. Para adicionar um controle a um formulário, siga estes passos, a menos que instruído de forma diferente na descrição do controle:

1. Faça login no Power Apps e selecione o ambiente onde deseja personalizar o formulário de ordem de trabalho.

2. Abra sua solução e selecione Tabelas>>.

3. Selecione o formulário que deseja personalizar e selecione Editar.

4. Selecione Componente e procure pelo componente que você quer adicionar. Arraste e solte o componente no formulário.

5. Salve e publique o formulário.

Recapitulação da ordem de serviço com o Copilot

Um controle que resume ordens de trabalho e agendamentos associados, incluindo notas da linha do tempo, com a ajuda do Copilot no Field Service. Atualmente, o Copilot não consegue resumir campos personalizados. Ele só resume campos padrão.

Esse controle funciona em formulários de ordem de trabalho padrão e personalizados, mas não em entidades que não são de ordem de trabalho.

Status da ordem de serviço

Um controle para selecionar o status e substatus da ordem de trabalho. Você pode adicionar substatus de sistema personalizados. O Field Service não dá suporte ao status personalizado do sistema. Se você adicionar um, ele não terá um ícone de status. Não é possível alterar as cores de status do sistema.

Esse controle funciona em outras entidades, mas:

• Não suporta ícones.
• Todas as cores de status são roxas.

Prioridade da ordem de serviço

Um controle para definir a prioridade de uma ordem de trabalho. Você pode adicionar prioridades e cores personalizadas.

Esse controle funciona no formulário de ordem de trabalho e na grade de ordem de trabalho, mas não em entidades que não sejam ordens de trabalho.

Contagem da linha do tempo

Um controle que mostra o número de notas na linha do tempo. Selecionar o número para acessar a aba de linha do tempo no formulário.

• Este controle não funciona em entidades personalizadas, mesmo que elas tenham o controle de linha do tempo integrado.
• Este controle dá suporte a formulários da ordem de serviço personalizados.

Se você colocar esse controle na mesma guia do controle da linha do tempo, a contagem não aumentará automaticamente quando você adicionar uma nova observação. Atualize a página para ver o número atualizado. Se as atividades e as observações estiverem desabilitadas para a entidade da ordem de serviço, a contagem sempre mostrará zero (o que é preciso).

Cartão de localização

Um controle que mostra o local onde concluir o trabalho e as informações sobre o local funcional, quando disponíveis.

• Este controle funciona em formulários de ordens de serviço personalizadas, mas não funciona em outras entidades além da ordem de serviço.

O nível de zoom padrão está atualmente fixo, e você não pode alterá-lo. O seletor de local funcional só mostra a entidade mais filha e não mostra a navegação estrutural dos níveis mais altos, como Edifício > Andar > Sala.

Cartão de contato

Um controle que mostra o contato da conta de cobrança ou do serviço e o relatório por contato (quando disponível).

• Este controle funciona em formulários da ordem de serviço personalizados. Se você colocá-lo em um formulário que não é de ordem de trabalho, o controle não entra no modo de edição.

O contato pode ser mapeado para o contato da conta de cobrança, o contato da conta de serviço ou relatado pelo contato. Não funciona com nenhum outro tipo de contato. A pesquisa não funciona quando apontada para campos sem contato.

Cartão de ativo

Um controle que mostra ativos do ativo primário e quaisquer ativos secundários definidos pelos produtos, serviços e tarefas na ordem de trabalho. O controle renderiza os nós filho de um ativo.

Você pode adicionar esse controle a formulários personalizados de ordem de trabalho, mas ele não funciona em entidades que não sejam de ordem de trabalho.

Se você posicionar o controle em um layout de três colunas, o ícone para abrir a visualização de ativos na tela inteira não carrega porque o controle se adapta a formatos restritos.

Cartão da reserva

Um controle que ajuda os gerentes de serviço a garantir que as ordens de serviço estejam avançando, fornecendo recomendações sobre a próxima ação. Para pedidos de trabalho não programados, sugere uma reserva. Para ordens de serviço agendadas, ele mostra os detalhes da reserva. Quando você conclui a ordem de trabalho, ela fornece um resumo.

• Este controle não funciona com entidades fora da ordem de serviço.
• Este controle exige que o mapeamento do status do sistema, do substatus e da resolução primária esteja configurado corretamente. Do contrário, haverá falha no carregamento do controle. Especificamente, se o status do sistema não for mapeado para o campo de status do sistema da ordem de serviço correto.

Cartão do resumo financeiro

Um controle que resume o custo e o preço de uma ordem de serviço com base nos produtos e nos serviços relacionados.

• Este controle funciona em formulários da ordem de serviço personalizados.

Garanta que os recursos de custo e precificação estejam habilitados para ver os dados nesse controle. Você pode definir um valor de proximidade diferente de NTE (limite máximo) para esse controle do que o valor definido para a ordem de serviço.

Subgrade Produtos e serviços

Um controle que você usa para editar os produtos e serviços em uma ordem de trabalho. Atualize de forma integrada a duração e as quantidades estimadas e reais e altere o status. Você pode fazer alterações detalhadas nos campos no painel lateral.

• Este controle funciona em formulários da ordem de serviço personalizados.
• O controle está associado a produtos da ordem de serviço. Você pode optar por mapear uma segunda entidade:
  • Produtos da ordem de serviço: a guia Serviços está em branco
  • Serviços da ordem de serviço: a guia Produto é vinculada aos serviços da ordem de serviço, mas a guia continua fazendo referência a produtos na interface.
• Este controle não funciona na entidade da ordem de serviço, pois tem uma dependência do produto da ordem de serviço e dos serviços da ordem de serviço.

Valores personalizados para produtos ou status de serviço não são suportados. Você não pode ocultar a guia de produto ou serviços. Ambas as guias precisam de uma entidade mapeada.

Cartão do resumo das tarefas

Um controle que resume as tarefas em uma ordem de serviço.

• Este controle funciona em formulários da ordem de serviço personalizados.

• Certifique-se de que os campos % completados, duração estimada e duração real estejam incluídos na visualização usada pelo controle.

Subgrade de Tarefa

Um controle que você usa para gerenciar tarefas em uma ordem de trabalho, usando ações inline para marcar tarefas como concluídas e inserir os resultados da inspeção. Você pode fazer alterações detalhadas nos campos no painel lateral.

• Este controle funciona em formulários da ordem de serviço personalizados.
• Este controle não funciona em entidades fora da ordem de serviço.

Se o campo % concluída não estiver visível na exibição, o progresso não será renderizado e a ação para marcar como completo ou incompleto não funcionará.

Referências > Cartão do artigo de conhecimento

Um controle que você usa para ver e vincular Artigos de Conhecimento a uma ordem de trabalho. O controle também permite criar novos artigos diretamente na ordem de serviço.

• Este controle funciona em formulários da ordem de serviço personalizados.
• Ele não funciona em entidades que não sejam da ordem de serviço porque tem uma forte dependência da ordem de serviço e dos artigos de conhecimento.

Referências > Cartão dos guias

Um controle que resume os Guias vinculados do Dynamics 365 relacionados às tarefas da ordem de serviço. Não é possível visualizar os Guias na Web, mas você pode ver o nome e a pasta associada.

• Use esse controle em formulários personalizados de ordem de trabalho.
• Você não pode usar esse controle em entidades que não sejam ordens de serviço porque ele tem uma forte dependência das tarefas de serviço e da entidade de ordem de serviço.

Referências > Cartão de mídia

Um controle que mostra miniaturas da mídia anexada às anotações da linha do tempo.

• Este controle funciona em formulários da ordem de serviço personalizados.
• Este controle funciona em entidades personalizadas, contanto que as atividades e as notas estejam habilitadas na entidade e o controle de linha do tempo esteja presente.

Controles da grade de ordens de trabalho

Os seguintes controles estão disponíveis para uso na grade de ordens de trabalho.

Grade e barra de ação

Um controle para exibir e selecionar ordens de serviço. Este controle permite editar diretamente a prioridade e fazer mais edições no painel lateral. O status do sistema é um campo combinado de status e substatus do sistema.

Você não pode aplicar esse controle a entidades que não sejam ordens de trabalho.

Limitações e problemas conhecidos:

• Quando você aplica esse controle a subgrids, o seletor de exibição não fica visível. Você só pode ver a visualização selecionada no portal do Criador.
• Se você personalizou a grade da ordem de serviço, o novo controle não será renderizado por causa das regras da camada de solução. Remova essas customizações primeiro para ver o controle.
• A nova experiência da grade não dá suporte à filtragem de colunas. Alterne para a Grade Somente Leitura para filtrar colunas.
• Se remover o novo controle da grade do ambiente, você não poderá reinstalá-lo. Entre em contato com o suporte para obter ajuda.
• A coluna Recursos Reservados (msdyn_bookingsummary) funciona apenas com a nova interface de ordem de trabalho. Não há suporte para ele no modo de exibição de grade clássico.

Menu de contexto

Um menu em linha quando você escolhe uma ordem de serviço para realizar ações rápidas.

• Este controle está disponível para a entidade da ordem de serviço.
• As opções do menu de contexto mudam de acordo com o status da ordem de serviço.

Você não pode alterar os itens no menu de contexto.

Painel lateral

Você pode carregar vários formulários em linha para edições adicionais a partir do formulário de ordem de trabalho.

• Ordem de trabalho: Edite as informações no painel lateral alterando o formulário Work Order Light.
• Ativos: Edite as informações no painel lateral, modificando o formulário Ativos do Cliente – Simples.

Os seguintes painéis laterais renderizam o mesmo formato como se você tivesse aberto o registro completo:

• Produtos: Produto da Ordem de Serviço
• Serviços: Serviço da Ordem de Serviço
• Tarefas: Tarefa de Ordem de Serviço

Você só pode abrir um vidro lateral por vez. Você não pode alterar a largura do painel.

Próximas etapas

• Definir os status de reserva
• Criar uma ordem de serviço