Configurer les tâches pour les clients externes

Avertissement

Les contrôles collaboration pour les applications pilotées par modèle sont définis pour être mis hors service en mai 2024. Le retrait sera effectué en deux phases pour assurer une transition en douceur. Le tableau suivant détaille les chronologie du processus de mise hors service et ses impacts :

Timeframe	Action	Impact
Février 2024	Les contrôles de collaboration ne seront plus disponibles pour l’installation à partir d’AppSource.	- Les nouveaux déploiements des contrôles de collaboration dans les environnements Power Apps ne sont pas possibles. - Les installations existantes ne sont pas affectées.
Mai 2024	Le service interne qui alimente les contrôles sera mis hors service.	- Les contrôles cesseront de prendre en charge l’intégration à Microsoft 365 et retourneront des erreurs aux utilisateurs. Les données générées et gérées par le biais des contrôles ne seront pas affectées. Pour plus d’informations, consultez le tableau plus loin dans cet article.

Les artefacts créés et gérés via les contrôles continueront d’exister une fois le service mis hors service.

Contrôle	Impact
Approbations	Les approbations créées dans le contrôle Approbations restent dans l’application Approbations, mais ne sont plus accessibles dans le contrôle Approbations.
Files	Les fichiers gérés dans le contrôle Fichiers restent dans SharePoint, mais ne sont plus accessibles dans le contrôle Fichiers.
Réunions	Les réunions créées dans le contrôle Réunion resteront dans les calendriers Outlook et Teams, mais ne seront plus accessibles dans le contrôle Réunions.
Notes	Les notes créées dans le contrôle Notes restent dans la table notes Dataverse.
Tâches	Les tâches créées dans le contrôle Task restent dans le Planificateur, mais ne sont plus accessibles dans le contrôle Task.

Nous vous recommandons de supprimer les contrôles de collaboration et le connecteur Collaboration de toutes les solutions Power Apps et de préparer les utilisateurs à la mise hors service à venir des contrôles de collaboration.

Les tâches externes qui peuvent être affectées à des utilisateurs qui ne font pas partie de votre organization ou n’ont pas accès à votre application, comme l’attribution d’une tâche à un client.

Pour l’activer, vous avez besoin d’une étape supplémentaire pour transmettre une chaîne XML à chaque instance de contrôle PCF Tasks attaché au composant de sous-grille sur le formulaire MDA souhaité. La chaîne XML est une requête paramétrée qui permet au contrôle d’extraire les données requises d’une table qui contient des informations client.

Pour créer des tâches externes, procédez comme suit :

1. Créez une entité personnalisée telle que Client ou réutilisez une entité client existante comme Contacts.

2. Créez des champs qui contiennent les informations suivantes :

   1. Nom
   2. E-mail
   3. Parent (recherche dans la table parente, par exemple Inspections)

   Remarque

   L’entité client créée est l’endroit où le contrôle de tâche extrait les informations client lors de l’attribution d’une tâche externe. Le champ Parent garantit que l’entité cliente est liée à un enregistrement d’inspection.

3. Générez un fichier XML Fetch pour permettre au contrôle PCF d’extraire les informations client appropriées.

   Configurer le schéma XML

   Voici la définition de schéma pour la configuration des tâches Fetch XML. Tout fichier FETCH XML doit être conçu pour répondre aux exigences suivantes :

   • Le résultat de la requête retourne les propriétés suivantes pour chaque objet utilisateur :
     • ID
     • Displayname
     • e-mail, utilisez l’alias si nécessaire.
   • La requête doit contenir le paramètre @top pour permettre à l’appelant de limiter le nombre de résultats.
   • La requête doit avoir @rootEntityId paramètre pour filtrer les résultats uniquement par enregistrements associés, si nécessaire.
   • La requête doit avoir @useName paramètre pour autoriser le filtrage des résultats par nom
   • La requête doit avoir @useIdentifier paramètre pour permettre d’extraire uniquement les utilisateurs sélectionnés.

   Schéma XML de configuration et exemple

   La configuration du schéma XML extrait les données de la table client. Vous pouvez ajuster le <fetch/> nœud pour spécifier votre propre requête afin d’afficher les utilisateurs de n’importe quelle autre table personnalisée.

   Remarque

   L’entité, le nom d’attribut et l’attribut d’ordre ci-dessus dans le xml sont au format PublisherPrefix_TableColumn .

   
   <custom-tasks> 
   <custom-task id="external" name="External" for="guest"> 
   <fetch top="@top"> 
   <entity name="[Name of table, e.g. Crb2891_customer]"> 
   <attribute name="[Name of ID column, e.g. Crb2891_customerid]" alias="id" /> 
   <attribute name="[Name of primary name column, e.g. Crb2891_name]" alias="displayname" /> 
   <attribute name="[Name of email column, e.g. Crb2891_email]" alias="email" /> 
   <order attribute ="[Name of primary name column, e.g. Crb2891_name]" descending="false" /> 
   <filter type="and"> 
   <condition attribute="[Name of parent lookup column, e.g. Crb2891_parent]" operator="eq" value="@rootEntityId" /> 
   <condition attribute="[Name of primary name column, e.g. Crb2891_name]" operator="like" value="@userName" /> 
   <condition attribute="[Name of email column, e.g. Crb2891_email]" operator="like" value="@userIdentifier" /> 
   </filter> 
   </link-entity> 
   </entity> 
   </fetch> 
   </custom-task> 
   </custom-tasks> 
   
   

4. Liez les contrôles Task à la sous-grille dans le concepteur de formulaires classique. Sélectionnez Enregistrer , puis Basculer vers le mode classique.

5. Parcourez le concepteur de formulaires classique jusqu’à ce que vous trouviez l’onglet Tâches . Double-cliquez sur la sous-grille pour ouvrir sa boîte de dialogue de propriété.

   

6. Dans la boîte de dialogue de propriété, définissez les propriétés comme indiqué dans l’image suivante :

   

7. Accédez à l’onglet Contrôles et sélectionnez la propriété Tâches personnalisées pour ajouter le code XML Fetch généré.

8. Coller le code XML d’extraction

   

   

9. Sélectionnez OK dans les fenêtres Configurer la propriété « Tâches personnalisées » et Définir les propriétés.

10. Enregistrer et publier.

Voir aussi

• Intégrer les applications Web
• Schéma de manifeste pour les développeurs publics en préversion pour Teams