Exercice : créer un modèle d’ordre de travail

  • 7 minutes

Dans cet exercice, vous allez créer un modèle Word comportant les détails des ordres de travail à confier aux techniciens.

Scénario

Vous travaillez dans un magasin de vélos et êtes responsable de l’environnement Dataverse de votre société.

Le responsable du service vous demande de fournir aux techniciens une liste des tâches de maintenance et des réparations qu’ils doivent effectuer pour les clients. L’environnement physique ne permet pas d’utiliser efficacement des ordinateurs ou des tablettes, donc le responsable souhaite que vous imprimiez des formulaires d’ordre de travail à distribuer aux techniciens au début de la journée de travail.

Préparer Dataverse

Pour cet exercice, nous devons créer deux tables :

  • Work Order : informations d’en-tête sur un ordre de travail.

  • Work Order Detail : éléments de ligne de l’ordre de travail ou liste des tâches et des réparations qu’un technicien doit effectuer. Il s’agit d’une table enfant pour la table Work Order.

L’objectif de ce module est axé sur les modèles. Pour accélérer les prochaines étapes, vous pouvez télécharger ce fichier de package comportant les tables vous aidant à continuer.

Procédez comme suit dans un environnement Dataverse dans lequel vous pouvez effectuer l’importation d’une solution, comme un environnement de formation ou de développement dédié :

  1. Connectez-vous au portail Power Apps.

  2. Dans le volet gauche, cliquez sur Solutions. Dans la liste de solutions, sélectionnez Importer une solution.

    Capture d’écran du volet de navigation gauche du portail Power Apps mettant l’accent sur les options de menu Solutions et Importer une solution.

  3. Dans le formulaire Importer une solution, cliquez sur Parcourir pour trouver l’emplacement du fichier zip de la solution. Cliquez sur Suivant pour passer à l’étape suivante.

    Capture d’écran du formulaire Importer une solution mettant l’accent sur les boutons Parcourir et Suivant.

  4. Cliquez sur Importer pour confirmer le traitement du fichier.

    Capture d’écran du formulaire Importer une solution mettant l’accent sur le bouton Importer.

    Lorsque l’importation de la solution est terminée, un message de notification s’affiche dans Power Apps Studio, afin de vous indiquer que le module a été importé correctement. Si vous ne pouvez pas importer la solution, vous aurez peut-être besoin d’autorisations différentes. Adressez-vous à votre administrateur.

  5. Pour vous assurer que toutes les personnalisations sont appliquées dans l’environnement, ouvrez la solution importée.

  6. Sur l’écran de la solution, cliquez sur Publier toutes les personnalisations dans la barre de commandes. Une fois que la notification Publication de toutes les personnalisations réussie, continuez.

    Capture d’écran du portail Power Apps mettant l’accent sur le bouton Publier toutes les personnalisations.

Préparer les tables de données

  1. Prenez le temps de consulter et préparer les tables de données. Cliquez sur Tables dans le volet gauche, puis sélectionnez la table MS Learn Work Order.

    Capture d’écran de la page Tables mettant l’accent sur le bouton Tables et la table MS Learn Work Order.

  2. Dans le volet Colonnes et données MS Learn Work Order de la partie inférieure de l’écran, assurez-vous que les colonnes s’affichant sont les suivantes : Name, Customer Name, Scheduled Date, et Service Technician Name. Vous pouvez y parvenir en cliquant sur le bouton +[nombre] autres sur le côté droit de l’en-tête de colonne. Dans la boîte de dialogue Afficher la colonne existante, recherchez et sélectionnez ces colonnes, puis désélectionnez les autres afin que vos données ressemblent à l’image ci-dessous :

    Capture d’écran du portail Power Apps mettant l’accent sur le volet Colonnes et données Ms Learn Work Order.

  3. Enregistrez vos sélections de colonnes.

  4. Examinons maintenant la table Work Order Detail. Dans le volet Objets sur le côté gauche de votre écran, recherchez Tables et sélectionnez votre table MS Learning Work Order Detail.

    Capture d’écran du volet Objets mettant l’accent sur la table MS Learning Work Order Detail.

  5. Dans votre volet Colonnes et données MS Learning Work Order Detail, cliquez sur le bouton +[nombre] autres et sélectionnez les colonnes suivantes : Name, Completed, Estimated Effort (Minutes) et Service Item.

  6. Créons ensuite une colonne de recherche pour la lier à la table Work Order. Cette opération garantit que nous avons une relation avec la table Work Order. Cliquez sur le bouton + [Nouvelle colonne] à l’extrême droite de la barre de colonnes.

    Capture d’écran de la table MS Learning Work Order Detail mettant l’accent sur le bouton + [Nouvelle colonne].

  7. Dans le volet Nouvelle colonne, saisissez/sélectionnez les valeurs suivantes :

    • Nom d’affichage : Work Order

    • Type de données : Lookup

    • Table associée : MS Learn Work Order

    Cliquez sur Enregistrer pour continuer.

    Capture d’écran du volet Nouvelle colonne mettant l’accent sur les champs Nom d’affichage, Type de données et Table associée.

Ajouter des exemples de données à vos tables

Ensuite, nous devons ajouter des données à nos tables, afin de disposer des données nécessaires pour produire un ordre de travail pour nos techniciens. Pour ajouter ces données, accédez à chaque table et cliquez sur Modifier. Dans la fenêtre qui s’affiche, vous pouvez saisir ces données ligne par ligne.

Voici quelques exemples de données pour vos ordres de travail (sachant que les dates n’ont aucune importance) :

Name Customer Name Scheduled Date Service Technician Name
Réglage du siège d’Eric Solomon Eric Solomon 11/08/2023 Preston Morales
Réparation du pneu d’Henry Ross Henry Ross 11/08/2023 Rory Nyugen

Saisissez les informations suivantes pour les détails de votre ordre de travail :

Name Completed Estimated Effort (Minutes) Service Item Ordre de travail
Lubrifiant pour chaîne Non 10 Lubrifiant pour chaîne Réparation du pneu d’Henry Ross
Ajustement de siège Non 20 Ajustement de siège Réglage du siège d’Eric Solomon
Réparation de pneu Non 15 Réparation de pneu Réparation du pneu d’Henry Ross

Si vous êtes un peu plus avancé, vous pouvez télécharger ces fichiers de valeurs séparées par des virgules (CSV) et les importer dans vos données :

  • Un fichier comportant une liste d’exemples d’ordres de travail. Vous pouvez l’importer directement dans votre table.

  • Un fichier comportant une liste d’exemples de lignes de détail d’ordre de travail.

Pour obtenir de l’aide sur l’importation, consultez Importer à partir d’un fichier Excel ou CSV. Si vous n’êtes pas expérimenté dans l’importation de données, il vous sera peut-être plus facile de saisir manuellement les données des deux tables.

Avec la configuration de nos exemples de données, passons au cœur de l’exercice.

Créer un modèle de document

Vous avez créé les tables Work Order et Work Order Detail, et vous avez ajouté des enregistrements à chacune. Vous pouvez maintenant créer le modèle de document.

  1. Dans la solution importée, recherchez l’application pilotée par modèle MS Learn - Word Templates - Exercise 3, puis cliquez sur Lire. (Vous devez ouvrir l’application et la publier avant de la lire, si vous ne l’avez pas encore publiée.)

    Capture d’écran du portail Power Apps mettant l’accent sur l’application pilotée par modèle sélectionnée et le bouton Lire.

  2. Sélectionnez l’un de vos enregistrements d’ordre de travail, puis Télécharger le modèle dans le menu déroulant Modèles Word.

    Capture d’écran d’un exemple d’application pilotée par modèle affichant une liste de comptes actifs et le premier enregistrement sélectionné et mettant l’accent sur l’option Télécharger le modèle du menu Modèles Word.

    Important

    Vous ne verrez pas le menu déroulant Modèles Word s’afficher jusqu’à ce que vous ayez sélectionné un élément de vos ordres de travail.

  3. Dans le formulaire Télécharger le modèle, laissez la table par défaut MS Learn Work Order dans le menu déroulant Entité. Pour vous assurer que la liste des tâches est accessible dans le modèle, sélectionnez MS Learning Work Order Detail dans la liste Relation 1:N. Cliquez sur Télécharger pour passer à l’étape suivante.

    Capture d’écran du formulaire Télécharger le fichier pour créer un modèle mettant l’accent sur l’entité sélectionnée, les choix de relation et le bouton Télécharger.

  4. Ouvrez le fichier modèle Word que vous avez téléchargé sur votre ordinateur et activez la modification. (Recherchez le fichier dans votre dossier Downloads ou à l’emplacement où vos téléchargements sont enregistrés.) Vous devrez probablement cliquer sur Activer la modification.

  5. Cliquez sur l’onglet Développeur, puis ouvrez le volet Mappage XML.

  6. Dans le volet Mappage XML, sélectionnez le composant urn:microsoft-crm/document-template/msls_mslearnworkorder dans la liste déroulante Composant XML personnalisé. Développez ensuite les champs sous la liste déroulante msls_mslearnworkorder.

    Capture d’écran du portail Power Apps mettant l’accent sur le volet Mappage XML.

  7. Créez la partie d’en-tête du formulaire d’ordre de travail en sélectionnant les composants msls_scheduleddate, msls_servicetechnicianname et msls_customername.

    N’oubliez pas de cliquer avec le bouton droit sur chacun d’eux, puis de sélectionner Insérer un contrôle de contenu. Insérez chacun d’eux sous forme de texte brut. Accédez ensuite à une nouvelle ligne de votre document pour insérer l’élément suivant.

     > [!div class="mx-imgBorder"]

    Capture d’écran de Word mettant l’accent sur le volet Mappage XML du menu Développeur et l’option Composant XML personnalisé.

  8. Ajoutez un titre, une mise en forme et des libellés au modèle, afin que les techniciens puissent identifier les valeurs. Vous pouvez placer votre curseur en dehors des champs du modèle pour ajouter des en-têtes à l’aide de vos touches fléchées. Une fois terminé, votre modèle devrait ressembler à l’image suivante :

    Capture d’écran de l’option Composant XML personnalisé et du champ Ajouter un titre.

  9. Pour répertorier les tâches d’un ordre de travail, vous devez ajouter une table à trois colonnes et deux lignes dans le modèle.

  10. Ajoutez des en-têtes à votre table pour les colonnes « Service Item », « Estimated Effort » et « Completed? » Vous pouvez ajouter des couleurs/ombres comme vous le souhaitez dans votre table, comme dans tout document Word, mais cela n’est pas nécessaire.

  11. Dans la première ligne de données de cette table, ajoutez les champs msls_serviceitem, msls_estimatedeffortsinminutes et msls_completed en tant que contrôles en texte brut. Vous pouvez rechercher ces champs en développant la table msls_msls_mslearningworkorderdetail_WorkOrder_ en bas de la liste Composant XML. (N’oubliez pas que vous devez cliquer avec le bouton droit, sélectionner Insérer un contrôle de contenu, puis sélectionner Texte brut, comme ci-dessus.)

    Capture d’écran de Microsoft Word mettant l’accent sur la relation détaillée de l’ordre de travail, les champs sélectionnés et la définition de table dans le document.

  12. Afin que toutes les tâches d’ordre de travail soient répertoriées dans la table, sélectionnez la ligne de table entière. Ensuite, dans le volet Mappage XML, sélectionnez la relation msls_msls_mslearningworkorderdetail_WorkOrder_, cliquez avec le bouton droit, puis insérez un contrôle de type Extensible.

    Capture d’écran du volet de mappage XML dans Word mettant l’accent sur l’option Extensible pour la relation détaillée de l’ordre de travail et sur la première ligne sélectionnée de la table dans le document.

  13. Enregistrez le document, puis chargez-le sur Dataverse. Sélectionnez un enregistrement d’ordre de travail, puis Charger le modèle dans le menu déroulant Modèles Word.

    Capture d’écran d’une liste de comptes actifs et du premier enregistrement sélectionné mettant l’accent sur l’option Charger le modèle du menu Modèles Word.

  14. Sélectionnez le fichier Word modèle sur votre ordinateur local, puis cliquez sur Charger.

    Capture d’écran du formulaire Sélectionner le fichier à charger comme modèle mettant l’accent sur les boutons Choisir un fichier et Charger.

  15. Une fois le modèle chargé, vous pouvez l’utiliser pour la génération de documents standardisés. Sélectionnez un enregistrement d’ordre de travail, puis le nouveau modèle dans la section Modèles Word personnels du menu déroulant Modèles Word.

    Capture d’écran de l’option de modèle chargé dans la section Modèles Word personnels du menu Modèles Word.

  16. Le document généré est alors téléchargé sur votre ordinateur. Ouvrez-le, puis vérifiez qu’il comporte les détails de l’ordre de travail, y compris la liste des tâches du technicien. À ce stade, vous pouvez l’imprimer pour le mettre à la disposition du technicien.

    Capture d’écran du document Word généré à partir du modèle avec l’en-tête, les libellés et les données de l’enregistrement sélectionné et la mise en forme appliquée.

Étapes suivantes

Vous savez maintenant comment créer un modèle Word basé sur un ensemble de tables Dataverse associées, y compris une série d’enregistrements répétés en fonction du nombre d’enregistrements applicables. À présent, vous allez découvrir comment créer une feuille de calcul Excel dynamique basée sur une table Dataverse.