Configuring Tables in a Story Report

Objective

After completing this lesson, you will be able to configure tables in an SAP SuccessFactors Story Report.

Table Widgets

Tables can be used on story reports to view and analyze data.

When you add a table to a canvas, a data grid is created. You can change this basic layout using the Designer tools.

  • Use the Builder to select the measures and dimensions to include in the rows and columns of your table.
  • Use the Styling tools to enhance the presentation.
  • Use the Examine panel to create charts and visualizations based on selected areas of the data in your table.

You can add multiple measures and multiple dimensions to your table. You can also apply filters to your measures and dimensions. The table is updated as you make your choices in the Builder.

Screenshot of table widgets.

Adding a Table Widget

To add a table to the canvas:

  1. Under Insert, select the Table icon.

    A table is added to the page.

  2. Use the Builder tab to select the dimensions to include in the rows and columns.
  3. Use the Styling tab to customize the look of the table.

You can change the default design of a table in the Builder tab.

Screenshot of the Builder tab.

The following sections are displayed in the Builder tab:

Data Source

The data source is displayed in this area.

Table Structure

Select between cross-tab and list structures.

You can also select some table Properties:

  • Adaptive column width: Automatically resizes the columns when you resize the table
  • Arrange totals / parents nodes below: Moves totals to the bottom of the table
  • Optimized Presentation: Provides fast-loading, in-cell charts, pixel-level resizing of columns or rows, and smooth scrolling.

Table Widget Video Tutorial

Rows and Columns

All dimensions used to create the table are displayed in this area. You can add additional dimensions to rows and columns.

When you hover over a dimension, you can select Filter to add or modify filters.

To make other modifications to the dimension, select More for additional options.

Filters

All filters that have been applied to the table are listed in the Filters section of the tab and in the table subtitle. Filters that have been manually applied can be removed by choosing the cancel icon beside the filter and more filters can be added here by selecting the Add Filters text at the bottom of the list.

Filters are normally applied as restrictive filters (so that only the selected members are visible), but they can also be applied exclusively by selecting the Exclude selected members checkbox when you select the members; in this case, all members are included in the table except the selected items.

Screenshot of the Set Filters for Job Code.

To create a filter, complete the following steps.

  1. In the BuilderFilters area, select Add Filters, select the dimension you would like to filter.
  2. Choose the members.

    The members you choose appear in the Selected Members list on the right.

  3. Choose whether you want to allow viewers to modify selections. If you allow viewers to modify filter selections, they can either toggle on and off each filter value (with the Multiple Selections option) or select a single filter value (with the Single Selection option).

    Note

    Viewers can reset any changes that they made to filters and input controls to get the original view of the story by selecting Reset/Reset Story on the story toolbar.
  4. Select OK to create the filter.
  5. The filter appears at the top of the table, and in the Filters area in the Builder tab.

Properties

You can choose to Enable Data Analyzer / Data Explorer in view mode.

To enable data analyzer, select the checkbox.

Note

Data Explorer is only available for Classic View Mode. Data Analyzer is only available in Optimized View Mode.

Table Action Menu Options

When you have created a table on a story page, there are several options available in table-specific action and context menus.

  • Table Action Menu: Appears when you use the More Actions button or in other menus.
  • Table Cell (Context) Menus: Affects collections of cells in the table. Appears when you right-click a table cell.
  • Table Body (Dimension Values) Cells: Appears when you right-click a value of a dimension.
Screenshot of the Table Action menu.

Note

The following list are for Optimized Stories. Classic can have different options.

Table Action Menu

The table-specific menu options let you work with the data and change the appearance of the whole table:

Table Action Menu

ActionDescription
Applied to TableContains table details: Filtering and Warnings
FreezeIf you select a cell in a table, you can freeze all rows up to the selected row and all columns up to the selected column.
Swap AxisThis allows you to switch rows and columns for cross-tab tables.
Resize table to fit contentAdjust table size on canvas to fit content.
Linked AnalysisControl linked analysis for the table.
Add (plus icon)Add threshold, hyperlink, or comment.
Show / Hide (eye icon)This allows you to show or hide table elements.
Disable Mouse Actions / Enable Mouse ActionsWhen enabled, you can use the mouse to resize or reposition the table widget.

Table Header Cells

Table Header Cells

ActionDescription
Add Dynamic TextAdd dynamic text to the title.
Show / HideThis allows you to display or hide table elements.
Swap AxisThis allows you to switch rows and columns.

The table row and column headers (Dimension headers) have their own context menu.

Table Row and Column Headers (Dimension Headers)

ActionDescription
Sort OptionsDecide whether to sort ascending or descending, or to set a custom order.
Display OptionsDisplay information as Description, ID, or ID and Description.
Show / HideThis allows you to decide whether to show Unbooked cells or Total values.

Measure Headers

ActionDescription
In-Cell ChartAdd a bar chart to a measure.
ThresholdsAdd threshold values or ranges to a measure.
Add row / Add columnAdd a calculated member to a dimension.
Add client calculationCreate calculation rows or columns.
Hide row / Hide columnRemoves the rows or columns, but doesn't filter the data.

The table body (dimension value) cells have context menus for rows and columns:

Table Body Cells

ActionDescription
Filter / Filter MemberCreates a simple filter (Filter Member) based on a single member, or creates a complex filter (Filter) that includes a combination of specific cells
Exclude / Exclude MemberExcludes a single member (Exclude Member) or excludes members (Exclude) that are in a combination of specific cells
Sort OptionsDecides whether to sort ascending descending or custom
Add row / Add columnAdds a calculated member to a dimension
Add client calculationCreates calculation rows or columns
Hide row / Hide columnRemoves the rows or columns, but does not filter the data

Table Title

You can change the title of a table. You can include dynamic text from a variety of elements including story filters and filters that are in use in the table.

To change the title, complete the following steps.

  1. Double-click the title of the table.
  2. Adjust the text as needed.
  3. (Optional) To include dynamic text, do the following:a) From the table action menu, select Add Dynamic Text.b) Select the appropriate option.c) Choose Create.
  4. Choose outside the title to save the changes.

Configuring Tables with Aggregation

You can configure the table widget to aggregate data in two different table structures: List with aggregation or Cross-tab. When either of these is configured, the measures selected will be aggregated by the dimensions selected. For a list with aggregation, dimensions will be displayed as individual rows. For a Cross-tab, the dimension can appear both as rows and columns.

Sample cross-tab showing count by gender and location.

To create an aggregated table, complete the following steps.

  1. Under Insert, select the Table icon.

    A table is added to the page.

  2. Select either ListAggregated or Cross-tab.
  3. Select the appropriate measures and dimensions:a) For List, place the measure and dimensions in the columns area.b) For Cross-tab, place measures and dimensions in either the column or row area.

Note

List with aggregation is NOT available in Optimized Story Experience.

Creating Hyperlinks in a Table

You can add a hyperlink to a table or a table cell that takes you to an external URL or another page in the story. A table widget can only have one hyperlink per table.

Typical Use Case: Hyperlink to an Employee File

The screenshot shows an cross-tab table that has a hyperlink to the employee file on the User ID column

You can add a hyperlink to an employee's live profile page in the Story Designer. You need to create a data source that includes the User ID field. The table must be configured as a cross-tab table.

To set up the hyperlink to an employee’s file:

  1. After creating a data source query, in Story Designer, add a Cross-tab type of Table.
  2. Add the needed fields as rows.
  3. Right-click on the User ID cell or column in the table component.
  4. Select Table FunctionsAddHyperlink.
  5. Select External URL as a type of hyperlink and add the SuccessFactors Deeplink URL for live profile https://<SF URL>/sf/liveprofile?selecteduser= . (For example, https://performancemanager.successfactors.eu/sf/liveprofile?selecteduser=).
  6. After the equal sign in the link, select User ID from the IN USE dropdown to append the User ID to the URL.
  7. Check the Open in a new tab hyperlink option. Then click Done.
  8. You will see the Navigate to External URL link appear at the top of the table. Click that and select Show hyperlinks in Table.
  9. Notice that the User IDs are now hyperlinked.
  10. Clicking on the User ID will open a new tab that leads to the Employee File.

Typical Use Case: Hyperlink to Performance Forms

The screenshot shows the configuration of a hyperlink to a performance form

You can also hyperlink to performance forms.

You need to include the Document ID field in the output of your data source, then create the hyperlink as outlined in the previous procedure.

For the link, you will use https://<SF URL>/sf/printPreviewPMForm?fDataId=[Document ID].

Interaction: Table Widgets

Business Example

In this exercise, you will use the table widget to display the Basic User Information Query.

Business Example

In this exercise, you will filter your Employee Information Table using both a filter setting and an Input Control.

Chart Widgets

Sample chart widget.

Create charts in a story report to display your data. The data in your chart is based on an existing data source (query).

From the Builder, you can select a chart type and then pick the measures and dimensions to show in your chart. When you have defined the structure of your chart, you can apply customizations to it.

For the Optimized Design Experience (ODE), all charts are a single dropdown menu.

For the Classic Design Mode, charts are divided into the following categories:

  • Comparison - Compares differences between values or shows a simple comparison of categorical divisions of measures.
  • Trend - Shows a trend in the data values (especially for dimensions that are time-based, such as Year) or the progression of your data and possible patterns.
  • Distribution - Shows distributions between several groups or sets of data.
  • Correlation - Shows the relationship between values or compares multiple measure values. For example, you can view the correlation of two measures and understand the impact of the first measure on the second measure.
  • Indicator - Shows the metrics of a business.
  • More - Shows more options, including percentage.

Chart Widget Video Tutorial

Chart Configuration

Adding a Chart Widget

To add a chart to the canvas, complete the following steps.

  1. From the toolbar, under Insert, select the Chart icon.

    A bar chart is added to your page.

  2. A data source will automatically be selected for your new chart. To change it, in Builder, select Select Model (ODE) /Change Primary Model (classic) and choose a new data source.
Screenshot of the Builder.

When you add the chart to the canvas, you need to select the chart type. Some chart types require a specific number of measures or dimensions and will either not work or not provide good results if you use the wrong parameters.

To set the chart type, complete the following steps.

  1. In the right panelChart Structure section, select the appropriate chart type.
  2. Configure any additional required settings. For example a bar chart is configured as horizontal or vertical.
Select measures and dimensions for you chart.

When you select a chart type, select the measures and dimensions to display in each area of your chart.

You can add multiple measures and multiple dimensions to your chart. You can also apply filters to your measures and dimensions. The chart is updated as you make your choices in the Builder.

To select the measures and dimensions, complete the following step:

In the BuilderMeaures/ Dimensions/ Color section, select the appropriate measures and dimensions. 

Modify the Chart with the Builder

You can change the default design of a chart in the Builder tab.

Renaming Measures and Dimensions

Choose More and Rename.

You might want to use a customized description for a measure or dimension in your chart rather than using the default label.

  1. Select your chart.
  2. In the right panel, open Builder.
  3. Pick your measure or dimension and then select More ActionsRename.
  4. Type a new name for the description.

The new description is displayed in your chart.

Use Color in Charts

A bar chart displaying job code counts across three locations A sidebar shows measures, dimensions, and color settings, with an arrow pointing to the job code legend.

To make your chart more visually appealing, add a Color dimension.

For some chart types, you can use the same dimension for both category and color feeds. This can be useful if you want to hide the legend for a chart, but still want to see the information that the legend would provide. For example, you can display total by employee and add employee to the color dimension as well.

Applying a Chart Filter

You can exclude non-relevant data points or filter data points to focus a chart on a specific set of data. You can filter by interacting with members directly on the chart, or by using the Filter interface. Chart filters apply only to the data displayed in that chart.

Note

You can also apply filters to all charts on a page, or all charts in a story. The concept is covered in a later section.

Note

If you add a dimension that contains many members, a filter to restrict the number of members added to the chart may be automatically applied. If you apply your own filter to the chart, all automatically generated filters will be removed. You can manually remove an automatically generated filter using the Cancel icon beside the filter. You can also edit the filter and save modifications.

Chart Filter by Select Member

To apply a chart filter by member, complete the following steps.

  1. Select your chart.
  2. In the right panel, open Builder.
  3. Find the Filter section and choose Add Filters.
  4. Select the Dimension (Member) you would like to filter.
  5. Choose the Members. The members you choose appear in the Member Selection list on the right.
  6. If you want to change the default settings of the filter, you can choose Settings. Key settings are:
    1. Selection Mode: Dynamic or Static. Static selection won't include any future additions to the data source.
    2. Input Control Configuration: Are viewers able to modify selections or delete the filter?
    3. Input Control Configuration: Selection Type. A user can either toggle on and off each filter value (with the Multiple Selections option) or select a single filter value (with the Single Selection option).
  7. Select OK to create the filter.
Apply a chart filter by member, as outlined in the preceding text.

Note

Viewers can reset any changes that they made to filters and input controls to get the original view of the story by selecting Reset / Reset Story on the story toolbar.

Chart Filter by Condition

To apply a chart filter by condition, complete the following steps.

  1. Select your chart.
  2. In the right panel, open Builder.
  3. Find the Filter section and choose Add Filters.
  4. Select the Dimension (Condition) you would like to filter.
  5. Choose the Conditions. The members that match will be returned.
  6. Choose any Restrictions. Restrictions are exclude conditions that cannot be edited for disabled by viewers.
  7. If you want to change the default settings of the filter, you can choose Setting. Key settings are:
    1. Input Control Configuration: Set viewers to be able to modify selections or delete the filter.
    2. Input Control Configuration: Selection Type. A user can either toggle on and off each filter value (with the Multiple Selections option) or select a single filter value (with the Single Selection option).
  8. Select OK to create the filter.

For a Fixed Filter:

  1. Select the Granularity of the date range to Day, Week, Month, Quarter, or Year.
  2. Set the Start and End values for that granularity.
  3. Add Additional Ranges as necessary.

For a Dynamic Filter:

  1. Choose Standard (Uses Current Date) or Offset (You can adjust from the current date).
  2. Select the Granularity of the date range to Day, Month, Quarter, or Year.
  3. Set the Values of Look Back and Look Ahead that are applied to the Current Time Interval for that granularity.
  4. If you selected Offset, choose the Direction, Granularity, and Amount.

    Your values are applied against the current date and are reflected in the value displayed in the Offset Time Interval.

Apply a chart filter by condition, as outlined in the preceding text.

Hint

The start and end values of the date range are visibly displayed as a chart and as text by the Range Title in the dialog box.

Note

Viewers can reset any changes that they made to filters and input controls to get the original view of the story by selecting Reset / Reset Story on the story toolbar.

Chart Filter by Time(Range)

To apply a chart filter by time range, complete the following steps.

  1. Select your chart.
  2. In the right panel, open Builder.
  3. Find the Filter section and choose Add Filters.
  4. Select the Time Dimension (Range) you would like to filter.
  5. Choose Dynamic or Fixed.

    Individual Configurations are described next.

  6. Change Settings for Users. Key settings are:
    1. Input Control Configuration: Are viewers able to modify selections or delete the filter?
    2. Input Control Configuration: Can viewers see any restrictions?
  7. Select OK to create the filter.
Apply a chart filter by time range, as outlined in the preceding text.

Filter Access

In Optimized View, the filter can be accessed in More ActionsApplied to Chart and in the Filters area in the Builder tab.

Screenshot of he filter access menu.

In Classic View, the filter appears at the top of the chart and in the Filters area in the Builder tab.

Classic filter display showing a bar chart.

Enable Explorer / Data Analyzer

In the Properties section of the Builder, you can choose to Enable Data Analyzer / Explorer in view mode.

Select the Enable Data Analyzer.

Note

Data Explorer is only available for Classic View Mode. Data Analyzer is only available in Optimized View Mode.

Charts with Blended Data

You can create charts with data from multiple data sources (Queries). You have already set up linked dimensions between models. For more information on linked dimensions, see the following topic: Configuring Linked Dimensions for Widgets to Use Blended Data.

Sample chart with blended data.

For example, you may want to display the total value of one-time bonuses per Job Title. The employees Job Title is returned in the data source Job Information, which includes the User ID field.

You also have a second data source on Basic User Information, which includes the User ID field as well. The Basic User Information also includes related tables to display the one-time bonus values for each employee. You could link these two data sources on the dimension User ID so that you can chart your requirement.

Sample of a blended data chart.

To create the chart with Blended Data, complete the following steps.

Ensure two or more queries (data sources) that have a linked dimension exist in the story.

  1. On the Story Designer page, add a Chart widget, and select the widget.
  2. Select one of the queries as the primary data source for the chart.
  3. Choose the Add Linked Models link.
  4. Select the appropriate Model that has a linked dimension to the primary data source.

    You can also create a new Linked Dimension at this point.

  5. From both data sources, select the dimensions that can be linked logically and choose Set.

    The linked or the blended data source appears below the primary data source on the Builder panel.

  6. From the blended data source, select Measures and Dimensions that you want to show on your chart.
Screenshot of the builder screen.

After you add the additional data source, you can set the Link Type. By default, the Link Type of the blended data source is All primary data (which is also known as the left-outer join). You can edit the Link Type to All data (also known as outer join) or to Intersecting data only (also known as inner join).

Screenshot of the Link Type menu.

Chart Action Menu Options

When you have created a chart on a story page, there are several options available in chart-specific action and context menus. Different chart types have different options available, and some options are not available when in View mode.

The chart action menu provides options that let you make additional changes to the chart. If you want to make changes to specific areas in a chart, you can use the right-click context menus.

To display the menu, in the chart tile either right-click or select (More Actions).

Screenshot of the More Options menu.

More Actions

ActionDescription
Sort

Allows you to apply an ascending or descending sort to your chart. Select the measure or dimension you want to sort, and the sort direction.

To sort on a measure that is not included in the chart, select Advanced Sorting, choose a measure, and then the sort criteria.

RankShow a specified number of the lowest or highest ranked members.
More OptionsDisplay additional options in the menu.
Linked Analysis (triangle with circles at the points icon)Manage Linked Analysis.
AddFor a list of options you can add, see the next table.
Show / HideThis allows you to show or hide chart elements. By default, most elements are shown.
Edit AxisYou can manually change the axis values.
Collapse Title, Expand TitleCollapse to show only one line of text in the Chart Title or expand to show the full text.

We will now look at Add in the Action Menu.

When you select the + icon (Add) in the Action menu, you can select the following options:

Add in the Action Menu

ActionDescription
Threshold (target board icon with the arrow in its center)This allows you to create thresholds for the chart.
Reference Line (bar chart icon)This allows you to add reference lines to your charts.
Error Bar (vertical barbell icon)This indicates the error or uncertainty in a reported measurement.
Tooltip (text bubble / square icon)This adds information for measures and dimensions that are not in your chart.
Trellis (square of nine blocks icon)This provides a grid of small charts for comparison.
Hyperlink (eight-shaped, paperclip iconThis allows you to add a hyperlink to an external URL, page, or story.
Comment (round speech bubble with a plus icon)This allows you to add a comment to the tile.

We will now look at the Chart Data Point Context Menu.

Chart Data Point Context Menu

ActionDescription
Filter / Filter MemberInclude specific data points.
Exclude / Exclude MemberExclude specific data points.
Break AxisAdd an axis break to the chart.

Hyperlinks

You can add a hyperlink to a page or to an external URL.

To add a hyperlink, complete the following steps:

  1. Select your chart.
  2. In the Action menu, select More ActionsHyperlink.
  3. In the Hyperlink panel, under Link to, select one of the following options:a) Mobile App URLb) External URLc) Page
  4. Select Done.

Interaction: Use a Chart Widget

Business Example

In this exercise, you will use the chart widget to display Job Roles per location.

Summary