Trier des lignes à l’aide de FetchXml

  • Article

Pour spécifier l’ordre de tri pour les lignes des tables, utilisez l’élément order au sein des élements entity ou link-entity. L'ordre de tri par défaut est croissant.

La requête suivante renvoie les enregistrements de compte dans l’ordre croissant en fonction des valeurs createdon, name et accountnumber.

<fetch>
  <entity name='account'>
    <attribute name='name' />
    <attribute name='accountnumber' />
    <attribute name='createdon' />
    <order attribute='createdon' />
    <order attribute='name' />
    <order attribute='accountnumber' />
  </entity>
</fetch>

L’ordre des éléments détermine la façon dont le tri est appliqué. Pour que le tri soit appliqué à l’aide du paramètre accountnumber, déplacez cet élément à la première position.

<order attribute='accountnumber' />   
<order attribute='createdon' />
<order attribute='name' />

Ordre décroissant

Si vous souhaitez utiliser l’ordre décroissant, définissez l’attribut descending sur true. L’exemple suivant renvoie les enregistrements de compte avec les enregistrements les plus récemment créés en haut.

<fetch>
  <entity name='account'>
    <attribute name='name' />
    <attribute name='createdon' />
    <order attribute='createdon' descending='true' />
  </entity>
</fetch>

Dataverse trie toujours les attributs spécifiés par l’élément link-entity après les attributs de l’élément entity.

L’exemple suivant montre un modèle de tri conventionnel à la fois pour les attributs link-entity et les attributs entity.

<fetch>
  <entity name='account'>
    <attribute name='name' />
    <attribute name='accountnumber' />
    <attribute name='createdon' />
    <link-entity name='account'
      from='accountid'
      to='parentaccountid'
      link-type='inner'
      alias='parentaccount'>
      <attribute name='name'
        alias='parentaccount' />
        <!-- The link-entity parentaccount name -->
      <order attribute='name' />
    </link-entity>
    <!-- The entity account name -->
    <order attribute='name' />
  </entity>
</fetch>

Dans ce cas, les résultats sont classés en utilisant les attributs suivants :

  • Premier => account.name
  • Dernier => parentaccountname.name

Pour vous assurer que l’ordre link-entity est appliqué en premier, déplacez l’élément order de l’élément link-entity vers l’élément entity au-dessus de l’autre élément order et utilisez l’attribut entityname de l’élément order pour faire référence à la valeur alias de link-entity.

<fetch>
  <entity name='account'>
    <attribute name='name' />
    <attribute name='accountnumber' />
    <attribute name='createdon' />
    <link-entity name='account'
      from='accountid'
      to='parentaccountid'
      link-type='inner'
      alias='parentaccount'>
      <attribute name='name'
        alias='parentaccount' />
    </link-entity>
    <!-- The link-entity parentaccount name -->
    <order entityname='parentaccount'
      attribute='name' />
      <!-- The entity account name -->
    <order attribute='name' />
  </entity>
</fetch>

Maintenant, les résultats sont classés en utilisant les attributs suivants :

  • Premier => parentaccount.name
  • Dernier => account.name

Tri des colonnes de recherche et de choix

Les données contenues dans la plupart des types de colonnes sont relativement simples et vous pouvez effectuer des opérations de tri pertinentes. Les colonnes de recherche et de choix sont plus complexes, car les données stockées dans la base de données n’ont pas de sens hors contexte.

Colonnes de recherche

Lorsque vous effectuez un tri à l’aide des colonnes de recherche, les résultats sont triés en utilisant le champ du nom principal de la table associée. La base de données stocke une valeur GUID. La valeur formatée renvoyée est le champ du nom principal correspondant.

Colonnes de choix

Les valeurs de colonnes de choix sont également triées à l’aide des valeurs formatées au lieu des valeurs stockées dans la base de données. Les données de ces colonnes sont stockées sous forme d’entiers. La valeur formatée est une étiquette localisée basée sur la langue de l’utilisateur.

Ce comportement peut être remplacé en définissant l’attribut booléen useraworderby (Utiliser l’ordre brut par) de l’élément fetch. Lorsque cet attribut est défini, tous les tris des colonnes de choix utiliseront les valeurs entières à la place.

Notes

Étant donné que le tri des choix est basé sur l’étiquette localisée de la langue de l’utilisateur, vous obtiendrez un tri différent pour les résultats définis si la langue de l’utilisateur diffère.

Tri et pagination

La façon dont une page est triée fait une grande différence lors de la pagination des données. Si les informations de tri des résultats sont ambiguës, Dataverse ne peut pas renvoyer de manière cohérente ou efficace les données paginées.

Ajoutez un élément de tri à votre requête. Si vous n’ajoutez aucun élément de tri à votre requête, Dataverse ajoute un ordre basé sur la clé primaire de la table. Cependant, lorsque votre requête utilise l’attribut distinct, aucune valeur de clé primaire n’est renvoyée, Dataverse ne peut donc pas ajouter ce tri par défaut. Vous devez spécifier un ordre de pagination. Sans aucun ordre spécifié, les résultats de la requête distinct peuvent être renvoyés dans un ordre aléatoire. En savoir plus sur le renvoi de résultats distincts

La pagination est dynamique. Chaque requête est évaluée de manière indépendante au fur et à mesure qu’elle est reçue. Un cookie de pagination indique à Dataverse la page précédente. Avec ces données de cookie de pagination, Dataverse peut commencer par l’enregistrement suivant après le dernier de la page précédente.

La pagination fonctionnera mieux à l’avenir. Si vous revenez en arrière et récupérez une page que vous avez précédemment récupérée, les résultats peuvent être différents car des enregistrements peuvent être ajoutés, supprimés ou modifiés depuis la dernière récupération de la page. En d’autres termes, si la taille de votre page est de 50 et que vous revenez en arrière, vous obtenez 50 enregistrements, mais ce ne sont peut-être pas les mêmes 50 enregistrements. Si vous continuez à avancer dans les pages d’un jeu de données, vous pouvez vous attendre à ce que tous les enregistrements soient renvoyés dans un ordre cohérent.

Le tri déterministe est important

Le tri déterministe signifie qu’il existe un moyen de calculer un ordre de manière cohérente. Avec un ensemble d’enregistrements donné, les enregistrements sont toujours renvoyés dans le même ordre. Si vous avez besoin d’ordres et de pagination cohérents, vous devez inclure des valeurs de colonne uniques ou semi-uniques et spécifier un ordre pour qu’elles soient évaluées.

Exemple non déterministe

Examinons un exemple qui est non déterministe. Ce jeu de données contient uniquement des informations sur l’État et le Statut et est filtré pour renvoyer uniquement les enregistrements dans un État ouvert. Les résultats sont classés par Statut. Les trois premières pages sont demandées. Les résultats ressemblent à ce qui suit :

État Statut Page 
Ouvert Actif 1. Début
Ouvert Actif 1
Ouvert Actif 1 Fin
Ouvert Actif
Ouvert Actif
Ouvert Inactif
Ouvert Inactif

Le cookie de pagination enregistre les informations sur le dernier enregistrement de la page. Lorsque la page suivante est demandée, le dernier enregistrement de la première page n’est pas inclus. Cependant, compte tenu des données non déterministes, rien ne garantit que les deux autres enregistrements de la première page ne soient pas inclus dans la deuxième page.

Pour obtenir un tri déterministe, ajoutez des ordres aux colonnes contenant des valeurs uniques ou des valeurs semi-uniques.

Exemple déterministe

Cette requête est similaire à la requête non déterministe, mais elle inclut la colonne ID de cas qui inclut des valeurs uniques. Il est également trié par Statut, mais également par ID de cas. Les résultats ressemblent à ce qui suit :

État Statut ID d’incident Page 
Ouvert Actif Incident-0010 1. Début
Ouvert Actif Incident-0021 1
Ouvert Actif Incident-0032 1 Fin
Ouvert Actif Incident-0034
Ouvert Actif Incident-0070
Ouvert Inactif Incident-0015
Ouvert Inactif Incident-0047

Dans la page suivante, le cookie aura Case-0032 stocké comme dernier enregistrement de la première page ; par conséquent, la page deux commencera avec l’enregistrement suivant après cet enregistrement. Les résultats ressemblent à ce qui suit :

État Statut ID d’incident Page 
Ouvert Actif Incident-0010 1. Début
Ouvert Actif Incident-0021 1
Ouvert Actif Incident-0032 1 Fin
Ouvert Actif Incident-0034 2. Début
Ouvert Actif Incident-0070 2
Ouvert Inactif Incident-0015 2 Fin
Ouvert Inactif Incident-0047

Étant donné que cette requête tri les valeurs de colonne uniques, l’ordre est cohérent.

Pratiques recommandées pour les tris lors de la pagination des données

Notes

Lorsque cela est possible, les requêtes doivent être triées en fonction de la clé primaire de la table, car Dataverse est optimisé par défaut pour le tri sur la clé primaire. Le tri en fonction de champs non uniques ou complexes entraîne une surcharge excessive et des requêtes plus lentes.

Lorsque vous récupérez un ensemble limité de données à afficher dans une application, ou si vous devez renvoyer plus de 5 000 lignes de données, vous devez paginer les résultats. Les choix effectués pour déterminer l’ordre des résultats peuvent déterminer si les lignes de chaque page de données que vous récupérez chevauchent d’autres pages. Sans un tri approprié, le même enregistrement peut apparaître sur plusieurs pages.

Pour éviter que le même enregistrement apparaisse sur plusieurs pages, appliquez les pratiques recommandées suivantes :

Il est préférable d’inclure une colonne possédant un identificateur unique. Par exemple :

  • Colonnes de clé primaire de la table
  • Colonnes de numérotation automatique
  • ID utilisateur/contact

Si vous ne pouvez pas inclure une colonne avec un identificateur unique, incluez plusieurs champs qui généreront très probablement des combinaisons uniques. Par exemple :

  • Prénom + nom + adresse e-mail
  • Nom complet + adresse e-mail
  • Adresse e-mail + nom de l’entreprise

Anti-modèles pour les tris lors de la pagination des données

Les choix de tri suivants doivent être évités :

  • Les tris qui n’incluent pas d’identificateurs uniques

  • Les tris sur des champs calculés

  • Tris avec un ou plusieurs champs qui ne fournissent probablement pas un caractère unique, tels que :

    • Statut et état
    • Choix ou Oui/Non
    • Nommez les valeurs par elles-mêmes. Par exemple name, firstname, lastname
    • Champs de texte comme les titres, les descriptions et le texte sur plusieurs lignes
    • Champs de nombres non uniques

Étapes suivantes

Découvrez comment filtrer des lignes.

Filtrer des lignes

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é).