Considérations de personnalisation pour le formulaire d’ordre de travail

Cet article répertorie les considérations courantes lors de la personnalisation du formulaire de l’ordre de travail dans Dynamics 365 Field Service. De plus, cet article liste les composants de code ou contrôles PCF disponibles dans le concepteur de formulaires lors de la modification d’un bon de commande. Les créateurs peuvent utiliser ces composants sur leurs formulaires et vues pour personnaliser l’expérience de leurs utilisateurs. En savoir plus sur les contrôles de code dans la documentation développeur Power Apps.

En-tête du formulaire d’ordre de travail et barre de commandes

• En-tête : Entièrement personnalisable. Les créateurs peuvent modifier les informations affichées dans Maker Portal. Ils peuvent également masquer des sections ou des onglets et créer leurs propres onglets personnalisés.
• Sélecteurs de formulaire : les créateurs peuvent contrôler quels formulaires les utilisateurs peuvent voir en fonction des rôles de sécurité.
• Barre de commandes : utilise la barre de commandes simplifiée par défaut. Les administrateurs peuvent désactiver le paramètre Afficher les commandes d’ordre de travail simplifiées. Si une commande personnalisée a disparu, vous pouvez aller sur le portail créateur et la rendre visible à nouveau.

Sous-grilles d’ordres de travail sous forme de pop-ups

Configurez les sous-entités des ordres de travail pour qu’elles apparaissent sous forme de boîtes de dialogue et modifiez-les sans quitter le formulaire de commande. Cette configuration aide les répartiteurs à conserver le contexte de l’ordre de travail. Les administrateurs peuvent activer le paramètre Ouvrir les enregistrements de la sous-grille des ordres de travail dans des fenêtres contextuelles dans Paramètres de Field Service>Autres.

Commandes simplifiées des ordres de travail

La barre de commandes de l’ordre de travail utilise la vue simplifiée par défaut et affiche uniquement les commandes les plus pertinentes. Pour afficher toutes les commandes, les administrateurs peuvent désactiver le paramètre Afficher des commandes simplifiées dans les paramètres> de servicesur le terrain Ordre de travail / Réservation.

Vous pouvez personnaliser la barre de commandes pour afficher les commandes pertinentes dans votre contexte.

Statuts personnalisés des ordres de travail

Ne modifiez pas les statuts système des ordres de travail, car les tâches système et les modules externes s’appuient sur ces statuts. Au lieu de cela, les administrateurs peuvent créer des sous-statuts d'ordre de travail personnalisés qui correspondent aux statuts système de l'ordre de travail. Pour plus d’informations, consultez Ne modifiez pas les valeurs groupe d’options (choix).

Ajouter des cartes au formulaire de bon de travail

Si vous retirez manuellement le contrôle des cartes du formulaire de commande de travail par défaut, vous ne pouvez pas le réajouter.

Pour activer le bouton maps dans le concepteur de formulaires, ajoutez le masque ValidForMap à au moins un des attributs de type d’adresse du formulaire.

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

1. Créez une solution sur un environnement bac à sable qui inclut le formulaire auquel vous souhaitez ajouter le contrôle des cartes. Exportez-la comme solution gérée.

2. Dans le fichier customizations.xml de la solution, accédez à la section formxml.

3. Ajoutez le contrôle de carte suivant à <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. Recherchez « Cartes » dans le même fichier.

2. Ajoutez le contrôle avec le code suivant à la ligne et à la cellule où vous souhaitez l’ajouter.

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

1. Sauvegardez le fichier et créez un nouveau fichier zip de solution gérée.

2. Importez la solution dans l’environnement concerné.

Contrôles des formulaires de commande de travail

Les contrôles suivants sont disponibles pour être utilisés sur des formulaires de commande personnalisés. Examinez chaque contrôle pour les options et les limites. Pour ajouter un contrôle à un formulaire, suivez ces étapes sauf indication contraire dans la description du contrôle :

1. Connectez-vous à Power Apps et sélectionnez l’environnement où vous souhaitez personnaliser le formulaire de commande de travail.

2. Ouvrez votre solution et sélectionnez Tables>Work Order>Formulaires.

3. Sélectionnez le formulaire que vous souhaitez personnaliser et sélectionnez Modifier.

4. Sélectionnez Composant et recherchez le composant que vous souhaitez ajouter. Glisser-déposer le composant sur le formulaire.

5. Enregistrez et publiez le formulaire.

Récapitulatif des ordres de travail de Copilot

Un contrôle qui résume les ordres de travail et les réservations associées, y compris les notes de calendrier, avec l’aide de Copilot dans le service de terrain. Copilot ne peut actuellement pas résumer les champs personnalisés. Il résume uniquement les champs par défaut.

Ce contrôle fonctionne sur les formulaires par défaut et personnalisés des ordres de travail, mais pas sur les entités non liées aux ordres de travail.

Statut de l’ordre de travail

Une commande permettant de sélectionner le statut et le sous-statut de l’ordre de travail. Vous pouvez ajouter des sous-statuts système personnalisés. Field Service ne prend pas en charge l’état du système personnalisé. Si vous en ajoutez un, il n’a pas d’icône d’état. Vous ne pouvez pas modifier les couleurs du statut du système.

Ce contrôle fonctionne sur d’autres entités, mais :

• Il ne prend pas en charge les icônes.
• Toutes les couleurs de statut sont violettes.

Priorité de l’ordre de travail

Un contrôle pour définir la priorité d’un ordre de travail. Vous pouvez ajouter des priorités et des couleurs personnalisées.

Ce contrôle fonctionne sur le formulaire de commande de travail et sur la grille des ordres de travail, mais pas sur les entités non liées aux ordres de travail.

Nombre chronologie

Un contrôle qui affiche le nombre de notes dans la chronologie. Sélectionnez le numéro pour accéder à l’onglet chronologie du formulaire.

• Ce contrôle ne fonctionne pas sur les entités personnalisées, même si elles contiennent le contrôle de chronologie.
• Ce contrôle prend en charge les formulaires de bon de travail personnalisés.

Si vous placez ce contrôle sur le même onglet que le contrôle timeline, le nombre n’augmente pas automatiquement lorsque vous ajoutez une nouvelle note. Actualisez la page pour afficher le nombre mis à jour. Si les activités et les notes sont désactivées pour l'entité de l'ordre de travail, le décompte indique toujours zéro (ce qui est correct).

Fiche magasin

Un contrôle qui montre l’emplacement où effectuer le travail et des informations sur l’emplacement fonctionnel, le cas échéant.

• Ce contrôle fonctionne sur les formulaires de bon de travail personnalisés, mais il ne fonctionne pas sur les entités autres que le bon de travail.

Le niveau de zoom par défaut est actuellement fixe et vous ne pouvez pas le modifier. Le sélecteur de poste technique affiche uniquement l’entité la plus enfant et n’affiche pas le fil d’Ariane des niveaux supérieurs tels que le bâtiment > plancher > Salle.

Fiche contact

Un contrôle qui affiche le contact du service ou du compte de facturation, ainsi que le contact signalé par le contact (si disponible).

• Ce contrôle fonctionne sur les formulaires de bon de travail personnalisés. Si vous le placez sur un formulaire de commande non officiel, le contrôle n’entre pas en mode édition.

Le contact peut être associé au contact du compte de facturation, au contact du compte de service ou au contact à l’origine du signalement. Cela ne fonctionne pas avec tout autre type de contact. La recherche de données ne fonctionne pas lorsqu’elle est dirigée vers des champs non liés.

Carte des actifs

Un contrôle qui affiche les actifs de l’actif principal, ainsi que tous les actifs secondaires définis via les produits, services et tâches de l’ordre de travail. Le contrôle restitue les nœuds enfants d’un actif.

Vous pouvez placer ce contrôle sur des formulaires de commande personnalisés, mais cela ne marche pas sur les entités non liées aux ordres de travail.

Si vous placez le contrôle dans une mise en page de formulaire à trois colonnes, l’icône permettant d’ouvrir la vue plein écran de la ressource ne se charge pas, car le contrôle s’adapte à des facteurs de forme étroits.

Carte de réservation

Un contrôle qui aide les responsables de service à garantir que les ordres de travail progressent en fournissant des recommandations sur l’action suivante. Pour les commandes de travail non planifiées, il suggère une réservation. Pour les commandes de travail planifiées, elle affiche les détails de réservation. Lorsque vous terminez l’ordre de travail, il fournit un résumé.

• Ce contrôle ne fonctionne pas avec les entités autres que les ordres de travail.
• Ce contrôle nécessite que le mappage de l’état du système, du sous-état et de la résolution principale soit configuré correctement. Sinon, le contrôle ne parvient pas à se charger. Plus précisément, si le statut du système ne correspond pas au bon champ d’état du système des ordres de travail.

Carte de synthèse financière

Un contrôle qui résume le coût et le prix d’un bon de travail en fonction des produits et services qui y sont liés.

• Ce contrôle fonctionne sur les formulaires de bon de travail personnalisés.

Assurez-vous que les fonctionnalités de coût et de tarification sont activées pour voir les données dans ce contrôle. Vous pouvez définir une valeur de proximité à ne pas dépasser différente pour ce contrôle plutôt que celle qui est définie pour l’ordre de travail.

Sous-grille des produits et des services

Un contrôle que vous utilisez pour modifier les produits et services dans un ordre de travail. Mettez à jour la durée et les quantités estimées et réelles en ligne et modifiez le statut. Vous pouvez apporter des modifications détaillées aux champs dans la vitre latérale.

• Ce contrôle fonctionne sur les formulaires de bon de travail personnalisés.
• Le contrôle est lié aux produits d’ordre de fabrication. Vous pouvez choisir de mapper une deuxième entité :
  • Produits d’ordre de travail : l’onglet services est vide
  • Services d’ordre de travail : l’onglet Produit est lié aux services d’ordre de travail, mais l’onglet fait toujours référence aux produits dans l’interface.
• Ce contrôle ne fonctionne pas sur l’entité d’ordre de travail car il dépend du produit d’ordre de travail et des services d’ordre de travail.

Les valeurs personnalisées pour les produits ou le statut du service ne sont pas prises en charge. Vous ne pouvez pas masquer l’onglet produits ou services. Les deux onglets nécessitent une entité mappée.

Carte des tâches récapitulatives

Un contrôle qui récapitule les tâches d'un ordre de travail.

• Ce contrôle fonctionne sur les formulaires de bon de travail personnalisés.

• Assurez-vous que les champs pourcentage d’avancement, durée estimée et durée réelle sont inclus dans la vue utilisée par le contrôle.

Sous-grille de tâches

Un contrôle que vous utilisez pour gérer des tâches dans un ordre de travail en utilisant des actions en ligne pour marquer les tâches comme terminées et entrer les résultats d’inspection. Vous pouvez apporter des modifications détaillées aux champs dans la vitre latérale.

• Ce contrôle fonctionne sur les formulaires de bon de travail personnalisés.
• Ce contrôle ne fonctionne pas sur les entités autres que les ordres de travail.

Si le champ % terminé n’est pas visible dans la vue, la progression ne s’affiche pas et l’action permettant de marquer comme terminée ou incomplète ne fonctionne pas.

Références > carte d'article de la base de connaissances

Un contrôle que vous utilisez pour voir et lier les Knowledge Articles à un ordre de travail. Le contrôle vous permet également de créer de nouveaux articles directement à partir du bon de travail.

• Ce contrôle fonctionne sur les formulaires de bon de travail personnalisés.
• Il ne fonctionne pas sur les entités autres que les bons de travail, car il dépend fortement des bons de travail et des articles connaissance.

Références > carte de guides

Contrôle qui récapitule les guides Dynamics 365 liés pour les tâches dans l’ordre de travail. Vous ne pouvez pas afficher un aperçu des guides sur le web, mais vous pouvez voir leur nom et leur dossier associé.

• Utilisez ce contrôle sur les formulaires de commande personnalisés.
• Vous ne pouvez pas utiliser ce contrôle sur des entités non issues des ordres de travail car il dépend fortement des tâches de service des ordres de travail et de l’entité des ordres de travail.

Références > Carte média

Contrôle qui affiche les miniatures du média attaché aux notes de chronologie.

• Ce contrôle fonctionne sur les formulaires de bon de travail personnalisés.
• Ce contrôle fonctionne sur les entités personnalisées tant que l’entité a des activités et des notes activées et que le contrôle de chronologie est présent.

Contrôles de la grille des ordres de travail

Les commandes suivantes sont disponibles pour une utilisation sur la grille des ordres de travail.

Grille et barre d’action

Un contrôle pour afficher et sélectionner les bons de travail. Ce contrôle vous permet d’apporter des modifications en ligne à la priorité et d’effectuer d’autres modifications dans le volet latéral. L’état du système est un champ combiné d’état et de sous-état du système.

Vous ne pouvez pas appliquer ce contrôle aux entités autres que les ordres de travail.

Problèmes connus et limitations :

• Lorsque vous appliquez ce contrôle aux sous-réseaux, le sélecteur d’affichage n’est pas visible. Vous ne pouvez voir que la vue que vous sélectionnez dans le portail Maker.
• Si vous avez personnalisé la grille des bons de travail, le nouveau contrôle ne s’affiche pas en raison des règles de superposition des solutions. Supprimez d’abord ces personnalisations pour voir le contrôle.
• La nouvelle expérience de grille ne prend pas en charge le filtrage des colonnes. Passez à la Grille en lecture seule pour filtrer les colonnes.
• Si vous supprimez le nouveau contrôle de grille de l’environnement, vous ne pourrez pas l’installer à nouveau. Contactez le support pour de l’aide.
• La colonne Ressources réservées (msdyn_bookingsummary) fonctionne uniquement avec la nouvelle expérience de l’ordre de travail. Elle n’est pas prise en charge dans l’affichage grille classique.

Menu contextuel

Un menu en ligne lorsque vous choisissez un ordre de travail pour prendre des actions rapides.

• Ce contrôle est disponible pour l’entité d’intervention.
• Les options du menu contextuel changent en fonction de l’état du bon de travail.

Vous ne pouvez pas modifier les éléments du menu contextuel.

Volet latéral

Vous pouvez ouvrir plusieurs formulaires directement à partir du formulaire de bon de travail pour les modifier davantage.

• Ordre de travail : Modifiez les informations dans le volet latéral en modifiant le formulaire Work Order Light.
• Assets : modifiez les informations dans le volet latéral en modifiant le formulaire Ressources client – Simple.

Les volets latéraux suivants affichent le même formulaire que si vous ouvriez l’enregistrement complet :

• Produits : Produit de l’ordre de travail
• Services : Service d’ordre de travail
• Tâches : Tâches relatives au service d’ordre de travail

Vous ne pouvez ouvrir qu’une seule vitre latérale à la fois. Vous ne pouvez pas modifier la largeur du volet.

Étapes suivantes

• Configurer les statuts de réservation
• Création d’un ordre de travail