Utiliser des connecteurs personnalisés avec le contrôle de chronologie

Article
03/15/2023

Les connecteurs personnalisés sont une fonctionnalité qui permet aux développeurs de faire apparaître des informations telles que des lignes de tableau, des sources de données externes Dataverse, etc., en tant qu’entrées d’enregistrements dans le composant TimelineWallControl. Il permet un ensemble plus large de scénarios en plus des notes, publications et activités prêtes à l’emploi existantes.

Pour plus d’informations sur la configuration et l’utilisation de la chronologie, consultez les rubriques suivantes :

Les enregistrements configurés dans les connecteurs personnalisés sont une ressource Web JavaScript conforme à l’interface IRecordSource. Le nom d’une ressource Web, ainsi que le constructeur (nom incluant l’espace de noms) et le chemin de ressource Web JSON facultatif, peuvent être ajoutés en tant que configuration de paramètre UClientRecordSourcesJSON dans FormXML.

<UClientRecordSourcesJSON>
  {"recordSources": [{
    "name": "new_SecondaryRecordSource", 
    "constructor": "SampleNamespace.SecondaryRecordSource"}]
  }
</UClientRecordSourcesJSON>

TimelineWallControl doit charger la ressource Web JavaScript, puis créer l’instance de IRecordSource à partir du constructeur configuré.

L’IRecordSource est ensuite initialisé (init), avec une demande de pages d’enregistrements (getRecordsData), une demande pour les détails de filtre (getFilterDetails) et une demande de représentation UX d’un seul enregistrement (getRecordUX).

La réponse des demandes d’enregistrements est conservée pour minimiser le nombre de demandes d’enregistrements qui se produisent dans les scénarios multi-sessions.

Configurer le connecteur personnalisé pour le contrôle de la chronologie

Vous pouvez ajouter ou modifier votre connecteur personnalisé pour le contrôle de la chronologie en le configurant dans l’expérience du créateur.

Sur le contrôle de la chronologie, sélectionnez le formulaire pour lequel vous souhaitez ajouter ou modifier le connecteur personnalisé.
Terminez l’une des options suivantes :
- Pour ajouter un nouveau connecteur personnalisé, dans le volet Propriétés pour la table Chronologie, dans Connecteurs personnalisés, sélectionnez Ajouter un connecteur. Le volet Nouveau connecteur personnalisé s’affiche.
- Pour modifier un connecteur personnalisé existant que vous avez déjà téléchargé, dans le volet Propriétés de l’entité de chronologie, sélectionnez le connecteur personnalisé, puis sélectionnez Modifier. Le volet Modifier le connecteur personnalisé s’affiche.
Modifiez le formulaire, puis sélectionnez Enregistrer.

Support de filtre

Le support du filtre de connecteur personnalisé inclut les capacités suivantes.

Ajouter un nouveau type de filtre au groupe de filtre existant
Ajouter un nouveau groupe de filtre
Mettre à jour le nombre de types de filtres existants
Filtrer selon le mot clé de recherche

Les connecteurs personnalisés doivent utiliser les informations de fuseau horaire de l’entité UserSettings du contexte transmis dans init() pour être cohérents avec le rendu de la chronologie.

Portée

La fonctionnalité de connecteurs personnalisés est prise en charge dans les formulaires de table monosession et multisession dans les applications de modèle client Unified Interface.

Hors de portée

La fonctionnalité suivante n’est pas disponible pour la fonctionnalité de connecteurs personnalisés :

Scénarios hors connexion et hors connexion par défaut
Tableaux bord
Emplacements où TimelineWallControl n’est pas disponible (tels que les applications convergées, les applications canevas, Power Pages, les pages personnalisées, etc.)

Limitations connues

Les ressources Web configurées ne sont pas officiellement déclarées en tant que dépendances du formulaire. Cela signifie que l’exportation d’un formulaire n’exportera pas automatiquement les ressources Web et qu’elles devront être ajoutées à cette exportation manuellement. De plus, il peut être facile de supprimer accidentellement ces ressources Web.

Développer une source d’enregistrement

Lors du développement d’une source d’enregistrement, assurez-vous de suivre ces pratiques :

Assurez-vous que vous récupérez les données en toute sécurité. Le modèle de sécurité Unified Interface considère les ressources Web JS et JSON comme non fiables et, par conséquent, ces ressources ne doivent pas contenir de jetons ou de secrets, car elles seraient stockées en texte brut.
Si les données sont dans Dataverse, utilisez l’objet de contexte du comportement init pour faire des requêtes dans Dataverse. Les appels dans Dataverse à partir du contexte ont des requêtes proxy via un iframe sécurisé. C’est ainsi que les sources d’enregistrement prêtes à l’emploi dans TimelineWallControl récupèrent les données.
Si les données sont en dehors de Dataverse, utilisez les mécanismes existants de la plateforme pour récupérer des données externes.
Testez localement les modifications à l’aide de Fiddler : améliorez l’agilité du développement et du débogage des ressources Web JavaScript à l’aide de Fiddler AutoResponder. Plus d’informations : Développement de ressources web de script à l’aide de Fiddler AutoResponder.
Réduire le risque d’attaques XSS : le risque d’attaques XSS se produit lors de l’ajout/de la liaison HTML au DOM. Utilisez du texte brut dans la mesure du possible pour réduire ce risque. Si HTML est requis, vous devez nettoyer ce contenu avant de l’ajouter à l’enregistrement.
Suivez les meilleures pratiques générales pour les scripts client. Plus d’informations : Scripts client dans les applications pilotées par modèle
Assurez des pratiques de conception inclusives, y compris l’utilisation d’outils de test automatisés tels que Accessibility Insights.

Exemple de solution

Vous pouvez commencer avec un exemple de solution de connecteurs personnalisés qui a la ressource Web "SecondaryRecordSource", qui est configurée pour les formulaires "Compte pour les expériences interactives" et "Compte pour les expériences multisession".

Voir aussi

Utiliser la chronologie
Configuration de la chronologie

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).

Partager via