Result List

You can use this visualization to see underlying data from the index after a chart visualization, or after a search from the Search Field visualization to display results.

You typically configure this visualization associated with a List Details visualization:

  • Result list visualization: Shows a list of all items. Users can sort this list and click items.
  • List Details visualization: After selecting an item in the list, the user can see the detail of this item. The detail item contains: general information and actions, details sections, related items linked to the selected item, charts.

This task shows you how to:

Define the Data to Show

  1. In the Properties panel, go to Data.
  2. Select a data query and a Result Set.

Define the Chart Title and Icon

  1. In the Properties panel, go to Style.
  2. Specify the chart title.

    Note: To localize this title in other languages, click , and select a translation key. You define keys and translation values in the Translation menu.

  3. Select the icon that represents your chart.

Format the Display of Hit Elements

You can define the formatting of the fields displayed in title, subtitle, and body in the hit content.

  1. In the Properties panel, go to Data.
  2. In the Hit Content section, choose the hit content element on which you want to apply some formatting, that is Title, Subtitle, or Body, and click .
    A panel appears on the left.



  3. From Format, you can select a number format, such as a currency, a number with digits.
  4. You can also define a font weight (bold, italic), a default value, and the tooltip to display on the UI.

Show Images in Hit Results

You can configure the display of specific pictures for each hit, to have a preview of the selected object. It can be a 2D image of a part, an equipment picture, etc.

  1. In the Properties panel, go to Data.
  2. In the Hit Content section, select Show image.
  3. From Field to use as image URL, select the field, which contains a URL pointing to an external picture for each hit.

    Note: You can use images ingested through Data Factory Studio and stored on the DFS Object Storage service of the 3DEXPERIENCE platform. In that case, you must:
    1. Configure a Semantic Graph Index unit storage data model class, with a property containing the image file id that is pushed in the object storage.
    2. Configure an Index Tabular Data pipeline to ingest the file id from a source file (CSV, JSON, or Parquet).



Add Pagination

To avoid infinite scroll in the Result list, you can choose to enable pagination.

  1. In the Properties panel, go to Data.
  2. In the Sort and Limits section, select Use Pagination.

Configure Sorting

You can specify the fields available in the Result List to filter the results.

  1. In the Properties panel, go to Data.
  2. In the Sort and Limits section, select Include Sort.
  3. For Default Sort, select the field on which results are sorted by default.
  4. Optional: Configure more Sort Fields.

Reduce the Scope of Dimensions with Local Filters

For a visualization that displays data for a dimension (for example, in a chart axis), it may be useful to focus on specific values for that dimension. You can do so using a local (internal) filter.

For example, if you have a priority dimension that contains Very Minor, Minor, Major, and Critical priorities, you may want to display values for the Major and Critical priorities only.

Important: Unlike Filters, you cannot select Local Filters on the visualization UI.

  1. In the Properties panel, go to Data.
  2. In the Local Filters section, specify the dimensions for which you want to filter data out as follows:
    1. From Field, select the dimension on which you want to apply the filtering.
    2. From Filtering mode, select Include or Exclude.
    3. From Values, select the set of values to include or exclude from the dimension.

    For example, for the Status dimension, you can exclude NULL values.



Configure On-Click Effects for Results

You can specify several types of interactions for your visualization hits. For example, you can configure an on-click effect so that clicking a result opens the result details in the Hit details visualization.

  1. In the Properties panel, go to Action.
  2. In the Effects (On click) section, click .
  3. Specify the on-click effect by selecting a behavior:
    OptionDescription
    Set variable
    1. In Information Source, select the hit attribute on which you want to add the on-click effect.
    2. In Target Studio variable, select the data query variable to open and display the detail column (if it is not empty) and identify the selected item within the list.
    Filter

    Filters screen data with the content dropped on the screen.

    Select 3DPart

    Allows you to set the visualization focus on a part of a product structure.

    1. Optionally, activate Focus on 3D Part, if you want to zoom on the part in the product structure.
    2. For Information type, select:

      • Reference ID: It is useful to identify one or several occurrences of a part in the loaded structure. However, you cannot differentiate specific occurrences of the same part. To use this option, also select the Reference ID Source.

      • Occurrence Path: It is useful when a part is used several times in your 3D model, as it allows you to identify the specific occurrences of the part in the loaded structure. For example, for a car, you can have 4 wheels, but you want to identify precisely each of the wheels. To use this option, also select the Occurrence Path Source.

  4. Optional: Select Add drag button in the first column to add a drag icon in that column for users to drop objects in another 3DEXPERIENCE platform widget.
    1. In Information source, select the field to use as data source.
    2. In Object type, specify the name of the object to drag.
    3. For 3DEXPERIENCE Service, select the variable which contains the id of the 3DEXPERIENCE Service from which the data comes from. For example, 3DSpace.

Copy Data On-Drag

You can specify objects that Data Viewers can drag to another 3DEXPERIENCE platform widget, to refresh the display of that widget.

  1. In the Properties panel, go to Action.
  2. In the Copy data (On drag) section, configure the objects that users can drop in another 3DEXPERIENCE platform widget.
    1. In Information source, select the field to use as data source.
    2. In Object type, specify the name of the object to drag.
    3. For 3DEXPERIENCE Service, select the variable that contains the id of the 3DEXPERIENCE Service from which the data comes. For example, 3DSpace.