In this article
- Open the report Page Editor for the page in which you wish to create the Hit List.
- To insert a Hit List on your report page, drag-and-drop it from the Visual Components toolbox into the Page Editor or right-click in the Page Editor and select Insert Component > Hit List.
- Save the changes.
- In the Report toolbox, double-click the Hit List or right-click and choose Edit to open the Hit List Designer .as shown below.
- To define which questions are to be displayed in the table, drag-and-drop them from the Data Source onto the Hit List .
- To rearrange elements within the hit list or remove them from the list, use standard Windows selection techniques to select the items, then drag them to the desired location or right-click and select Delete to remove them.
Figure 1 - The Hit List Designer page
You can add to the Hit List any questions from the data source, including Interview Start, Interview End, Interview Status and Extended Status (available for CATI only), and loop reference questions. Grids must be expanded before you can add the elements. Use standard Windows selection techniques for selecting multiple fields.
Note: Any questions that can be indexed must be indexed to be used in Hit Lists with full sort/search functionality. Non-indexed questions may be used, but these cannot be set to Searchable or Sortable (go to Field Properties for more information). In the event you use a question that has not been indexed, you will be notified.
Figure 2 - Dragging questions from the Data Source into the Hit List designer
Each element in the hit list has its own properties sheet (go to Field Properties for more information).
Adding a Survey Link to a Hit List
You can add one or more survey links to a hit list (go to Survey Link Component for more information). To do this:
- Click the Add Survey Link link above the hit list designer area.
- Click on the component to select it, then drag it to the desired location in the hit list.
- Right-click on the component and select Properties to set/change the survey link component's properties (go to Field Properties for more information).
A Survey Link component is added at the bottom of the list of questions .
Figure 3 - Adding a Survey Link to a hit list
Adding Additional Columns from a Table Lookup Question
If you have in the data source a table lookup question where the table includes one or more 'Additional columns', these additional columns can be included in a hit list if so desired.
In the Data Source toolbox, expand the table lookup question. In the event the table lookup question included additional columns, these will appear under the question (arrowed in the example below), on the same level as the 'standard' table lookup answers (ringed in the example) .
Note: When a table lookup question with a lot of answers is expanded in the Data Source toolbox, this can take some time. Therefore only the first 100 answers will be retrieved. In the event the answer you are looking for is outside the top 100, use the search facility to locate the answer.
Figure 4 - Example of the Data Source toolbox with a table lookup additional column
When you are creating the hit list, merely drag the additional column(s) into the hit list as you would a 'standard' question. The columns will be added to the hit list and will appear in the table as any other column.
If a single view element is added to the report page (go to About Single Views for more information), then the additional columns can also be included here.
Rendering Style Property
When the hit list Rendering Style property is set to v2.0 (go to General Properties for more information), the hit list allows report viewers to control which columns in the hit list are to be displayed (in v1.0 this functionality is not available). The report designer will add to the hit list all the columns that he/she wants to be available, but can decide to set some of these columns to be Hidden by default (go to Field Properties for more information). When the hit list is rendered for the viewer, a button displays a drop-down list of all the columns that are available in the hit list (including those that the designer has designated as "Hidden"), and the viewer can then select those columns he/she wishes to be displayed .
Figure 5 - Example of a hit list using the v2.0 rendering style
Note that in the example above, the hit list is divided into several pages. Click the Previous / Next buttons to move between the pages.
The report viewer can click the +/- button (ringed) to open the list of all available columns . He/she can then check the boxes for those columns he/she wishes to see, and click Apply to refresh the hit list.
Figure 6 - Example of the list of available columns
Click the Filter button at the top-left corner of the hit list (ringed) .to open a filter drop-down. Here, if the Allow Searching property has been selected for the hit list (go to Layout Properties for more information), then the viewer can apply filters to the hit list columns. In this case the Interview End column is being filtered. Additional fields such as date or input fields become available as appropriate when filter options are selected.
Figure 7 - Example of a hit list filter