Options de configuration du widget de table

L'utilisation de ce widget vous permet d'afficher une table qui inclut une ou plusieurs entités ainsi que les informations associées. Vous pouvez ajouter un widget de table à n'importe quelle page, à l'exception d'une page de liste d'entités.

Vous pouvez utiliser ce widget pour afficher une table incluant plusieurs colonnes de métadonnées d'un type d'entité sur la page de détails d'un autre type d'entité. Vous pouvez aussi l'utiliser pour analyser des informations connexes provenant de plusieurs entités et les afficher dans une table.

Les options suivantes peuvent être configurées lors de la création du widget de table. Pour accéder à l'objet de la page de détails d'une entité, utilisez la variable subject.
Type Description
Entities to query Requête qui utilise l'API de requête. Les entités obtenues sont affichées dans le widget.

Pour suivre l'association opportunities, entrez :

subject.opportunities

Pour ne renvoyer que les résultats contenant une valeur de zone spécifique, entrez le code suivant, qui renvoie la valeur false pour la zone isClosed :

subject.opportunities.where(field("isClosed").contains("false"))

Pour afficher des recommandations pour un alias recommandable, entrez le code suivant, qui utilise l'alias product_recommendations :

subject.recommendations_for("product_recommendations")

Pour afficher des recommandations de participants, entrez le code suivant :

subject.recommendations_of_followees

Valeur par défaut : aucune

Columns > Title Texte à afficher en haut de la colonne.

Valeur par défaut : aucune

Columns > Content

Code Ruby évalué pour fournir le contenu de la cellule de table. Dans des définitions de colonne, la variable entity fait référence à l'entité qui correspond à la ligne affichée.

Pour afficher la première valeur d'une zone, entrez le code suivant. Ce code représente une utilisation simple et classique du widget de table.

entity["field_name"].first

Pour ajouter un lien vers la page de l'entité, entrez le code suivant :

entity_link_to entity.title, entity, :link_class => "ellipsis", :title => entity.title

Pour afficher toutes les valeurs d'une zone, entrez le code suivant :

entity["field_name"].join( ",")

Pour afficher un lien vers une association, entrez le code suivant :

association=entity.associations.first
entity_link_to association.title, association if association

Valeur par défaut : aucune

Columns > Sorting Formula
Remarque : Les colonnes d'un widget de table ne peuvent être triées que si la zone de la collection que vous souhaitez trier a fait l'objet d'une indexation rapide.

Code Ruby qui définit l'ordre de tri pour cette colonne. Si cette zone est vide, le tri n'est pas activé pour cette colonne. Le code est une condition pour un appel sortby vers l'API BigIndex et peut être basé sur une zone ou une formule XPath.

Pour trier par une zone spécifique, entrez le code suivant. Généralement, vous triez sur la même zone que celle affichée dans la colonne.

field("field_name")
Pour disposer de davantage d'algorithmes de tri puissants, utilisez XPath. Pour plus d'informations sur XPath, voir Création du tri personnalisé des résultats et Utilisation de XSL dans Watson Explorer. L'utilisation de XPath peut affecter la performance en fonction du nombre de résultats renvoyés pour la requête et de la complexité de l'expression XPath.
  • Le code suivant tri la colonne author-name selon le nom de famille de l'auteur ; le prénom et le nom de famille étant séparés par un espace. Ce tri est réalisé à l'aide de la fonction substring-after. Gardez en mémoire que la zone author-name doit avoir fait l'objet d'une indexation rapide.

    xpath("substring-after($author-name, ' ')")

Valeur par défaut : aucune

Columns > Sorting

Ordre de tri par défaut. Les utilisateurs peuvent changer l'ordre de tri en cliquant sur le titre de la colonne mais peuvent également choisir le tri par défaut.

Valeur par défaut : Ascending

Results per page

Vous pouvez choisir le nombre de lignes affichées sur chaque page de la table. Un widget de table peut avoir un nombre illimité de pages.

Valeur par défaut : 10

Enable show/hide on columns

Les utilisateurs peuvent déterminer quelles colonnes ils souhaitent voir dans la table, sauf si vous désactiver la fonction. Si elle est activée, la fonction affiche et masque automatiquement des colonnes en fonction de la largeur de la fenêtre du navigateur, sauf si les utilisateurs sélectionnent manuellement des colonnes à afficher ou à masquer. La fonctionnalité d'affichage ou de masquage automatique n'est pas compatible avec Internet Explorer 8, bien que les utilisateurs d'Internet Explorer 8 puissent sélectionner manuellement des colonnes.

Lorsque les utilisateurs ont sélectionné manuellement les colonnes qu'ils souhaitent afficher ou masquer, le widget de table ne peut plus afficher ou masquer automatiquement des colonnes pour ce widget lorsque les utilisateurs visualisent l'application dans le même navigateur sur leurs ordinateurs. Pour restaurer l'affichage et le masquage automatique des colonnes, supprimez les cookies pour le domaine de l'application.

Valeur par défaut : on