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

Artigo
11/27/2023

Este artigo lista considerações comuns ao personalizar o formulário de ordem de serviço no Dynamics 365 Field Service.

Abrir subgrades da ordem de serviço como caixas de diálogo pop-up

Configure as subentidades da ordem de serviço para aparecerem como caixas de diálogo e edite-as sem ter que sair do formulário de ordem de serviço. Essa configuração ajuda os expedidores a manter o contexto da ordem de serviço. Os administradores podem habilitar a configuração Registros da Subgrade de Ordem de Serviço Abertos como Pop-ups na área de configurações. Para obter mais informações, consulte Outras configurações.

Mostrar comandos de ordem de serviço simplificados

A barra de comandos da ordem de serviço usa a exibição simplificada por padrão e só mostra os comandos mais relevantes. Um administrador pode desativar a configuração Mostrar Comandos de Ordem de Serviço Simplificados para mostrar todos os comandos. Para obter mais informações, consulte Configurações da ordem de serviço/reserva.

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

Status de ordem de serviço personalizados

Os status do sistema de ordem de serviço jamais devem ser editados porque os trabalhos e plug-ins do sistema dependem desses status. Em vez disso, os administradores podem criar substatus de ordem de serviço personalizados que mapeiam os status do sistema de ordem de serviço. Para obter mais informações, consulte Não editar valores do conjunto de opções (escolha).

Adicionar Bing Mapas ao formulário de ordem de serviço

Se o controle do Bing Maps for removido manualmente do formulário de ordem de serviço pronto para uso, ele não poderá ser adicionado de volta.

Para habilitar o botão do Bing Maps em designer de formulários, pelo menos um dos atributos do tipo endereço deve ter a máscara ValidForMap adicionada no formulário.

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

Crie uma solução no ambiente de área restrita que inclua o formulário ao qual o controle do Bing Mapas precisa ser adicionado. Exporte como solução gerenciada.
No arquivo customizations.xml da solução, vá para a parte formxml dele.
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>

Pesquise por "Bing Maps" no mesmo arquivo.
Adicione o controle com o código a seguir à linha e célula onde ele precisa ser adicionado.

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

Salve o arquivo e crie um novo arquivo zip de solução gerenciada a partir dele.
Importe a solução no ambiente afetado.

Dica

Se o controle do mapa ainda não estiver visível no formulário após seguir essas etapas, tente remover as personalizações ativs do formulário.

Componentes da nova experiência da ordem de serviço

A nova experiência da ordem de serviço apresenta diversos componentes de código novos para os fabricantes usarem nos formulários e nas exibições. As seções a seguir listam opções e limitações desses controles de código. Para obter mais informações sobre como trabalhar com controles de código, consulte Controles de código na documentação do desenvolvedor do Power Apps.

Dica

Configure a segurança em nível de campo para garantir que os usuários só atualizem os campos desejados. Em alguns casos, por exemplo, se um campo em um formulário estiver definido como somente leitura, os usuários ainda poderão atualizar alguns campos. No entanto, o sistema não vai salvar o formulário atualizado se o usuário não tiver a segurança no nível de campo correta.

Formulário da ordem de serviço

Cabeçalho do formulário 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.
Seletores de formulário: os criadores podem controlar quais formulários os usuários podem ver com base em direitos de acesso.
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 adicionado personalizado desaparecer, você poderá ir até o Maker Portal e torná-lo visível novamente

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

Um controle que resume ordens de serviço e reservas associadas, inclusive observações de linha do tempo com a ajuda do Copilot no Field Service.

Esse controle atua nos formulários da ordem de serviço padrão e personalizado, mas não funciona em outras entidades diferentes da ordem de serviço.

Atualmente, o Copilot não consegue resumir campos personalizados. Ele só resume campos padrão.

Status da ordem de trabalho

Um controle para selecionar o status e o substatus da ordem de serviço.

Você pode adicionar substatus de sistema personalizados.
Você pode usar o controle suspenso de status em outras entidades, mas:
- Ele não dá suporte a ícones
- Todas as cores de status são roxas

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 cores de status do sistema.

Prioridade da ordem de serviço

Um controle para definir a prioridade de uma ordem de serviço. Ele funciona no formulário da ordem de serviço e na grade da ordem de serviço.

Você pode adicionar prioridades e cores personalizadas.
Você pode usar o controle em formulários da ordem de serviço, mas ele não funciona em outras entidades diferentes da ordem de serviço.

Contagem da linha do tempo

Um controle que mostra as observações numéricas na linha do tempo. Selecione o número para ir até a guia da linha do tempo no formulário.

Este controle não funciona em entidades personalizadas, mesmo que elas tenham o controle da linha do tempo.
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 vai 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 do local

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 da ordem de serviço, mas não funciona em outras entidades diferentes 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 trilha dos níveis mais altos, como Edifício > Andar > Sala.

Cartão do contato

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

Este controle funciona em formulários da ordem de serviço personalizados. Se colocado em um formulário da ordem que não seja de serviço, o controle não acessa o modo de edição.

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

Cartão do ativo

Um controle que mostra os ativos do ativo primário e todos os ativos secundários definidos por meio dos produtos, serviços e tarefas na ordem de serviço. O controle renderiza nós filho de um ativo.

Este controle pode ser colocado em formulários da ordem de serviço, mas não funciona em entidades que não sejam da ordem de serviço.

Se o controle for colocado em um layout de formulário de três colunas, o ícone para abrir a exibição do ativo em tela inteira não será carregado porque o controle se adapta a fatores forma 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 ordens de serviço não programadas, ele oferece uma sugestão de reserva, quando agendada mostra detalhes da reserva e ao concluir a ordem de serviço, você vê um resumo.

Este controle não funciona com entidades que não sejam 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. Mais 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.

Verifique se os recursos de custo e preço estão habilitados para consultar os dados nesse controle. Você pode definir um valor de proximidade NTE diferente para esse controle daquele definido para a ordem de serviço.

Subgrade Produtos e serviços

Um controle que permite editar os produtos e os serviços em uma ordem de serviço. Atualize a duração e as quantidades estimadas e reais em linha e altere o status. Alterações detalhadas feitas nos campos são possíveis no painel lateral.

Este controle funciona em formulários da ordem de serviço personalizados. Lembre-se das limitações a seguir.
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 é associada 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.

Os valores personalizados para status de produtos/serviços não são compatíveis. 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.
Verifique se os campos % concluída, duração estimada e duração real estão incluídos na exibição usada pelo controle.

Subgrade Tarefa

Um controle que permite gerenciar tarefas em uma ordem de serviço usando ações em linha para marcar tarefas como concluídas e inserir resultados da inspeção. Alterações detalhadas feitas nos campos são possíveis no painel lateral.

Este controle funciona em formulários da ordem de serviço personalizados
Este controle não funciona em entidades que não sejam 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 permite ver e vincular artigos de conhecimento a uma ordem de serviço. 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 dependência da ordem de serviço e dos artigos de conhecimento.

Referências > Cartão dos guias

Um controle que resume os Dynamics 365 Guides vinculados a tarefas na ordem de serviço. Você não pode visualizar os guias na web, mas pode ver o nome e a pasta associada.

Este controle pode ser usado em formulários da ordem de serviço personalizados.
Este controle não pode ser usado em entidades que não sejam da ordem de serviço porque tem uma dependência forte das tarefas de serviço da ordem de serviço e da entidade da ordem de serviço.

Referências > Cartão da mídia

Um controle que mostra miniaturas da mídia anexada a observações da linha do tempo.

Este controle funciona em formulários da ordem de serviço personalizados.
Este controle funciona em entidades personalizadas desde que a entidade tenha atividades e observações habilitadas e o controle da linha do tempo esteja presente.

Grade Ordem de serviço

Grade e barra de ação

Um controle para exibir e selecionar ordens de serviço. Este controle permite fazer edições em linha na prioridade e fazer edições adicionais no painel lateral. O status do sistema é um campo combinado de status e substatus do sistema.

Este controle não pode ser aplicado a entidades que não sejam da ordem de serviço

Limitações e problemas conhecidos:

Durante a aplicação do controle a subgrades, o seletor de exibição não é exibido. Somente a exibição selecionada no Maker Portal é mostrada.
Se você tiver personalizado a grade da ordem de serviço, o novo controle não será renderizado por causa das regras da camadas de solução. Remova essas personalizaçõ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) só funciona com a nova experiência da ordem de serviço. Ele não é compatível com a exibição de grade clássica.

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

Existem vários formulários que podem ser carregados em linha para edições futuras no formulário da ordem de serviço.

Ordem de serviço: você pode editar as informações exibidas pelo painel lateral modificando o formulário Luz da Ordem de Serviço.
Ativos: você pode editar as informações exibidas pelo 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 do Serviço da Ordem de Serviço

Somente um painel lateral pode ser aberto por vez. Você não pode alterar a largura do painel.

Compartilhar via