Adding Comments to a Data Cell

You can view and create comments on table data cells.

Prerequisites

To set or change the comment limit for your model, go to Start of the navigation pathSystem Next navigation step Administration Next navigation step System ConfigurationEnd of the navigation path, and update the value for Limit of comment threads per Model.

To add comments to data cells, you need to enable the Allow Data Point Comments option in the Properties section of the builder panel.

Note

The Allow Data Point Comments option is kept on for exiting tables but is disabled by default for newly created ones.

Context

You can leave comments on cells from any type of acquired model. When a story is opened, comment mode is on by default.

Note

You can't add comments to table cells from blended models or live data models (except SAP BW and SAP BPC live data models).

You can’t add comments to tables in a section.

You can’t add comments to tables in a digital boardroom presentation.

To view the existing comments, add a new comment, and delete any comment, you would need the following permissions.
  • You should have Read, Create, and Delete permissions for the object-type Comment in the tenant.

  • You should have Add Comment, View Comment, and Delete Comment permissions on the model to comment on datapoints.
  • You should have Add Comment, View Comment, and Delete Comment permissions on the story.

Note

If any one permission is missing in the combination, then you won't be able to perform the relevant action.

When commenting on a data point, the data context is taken into account. Only users who share the data context can view the comment. The data context is composed of the following:
  • All dimensions visible on the table.
  • Page, chart, and story filters.
  • Data access control and role-level security.
Note

When trying to add comments, you might see the following message:

Comments were not saved due to data access control or role-level security, conflicting dimension members, or dimension members missing from the model.

There a few scenarios where you can see this message:

  • You try to add a comment to an unbooked cell, but you don't have the read access to one or more of the dimension members that make up its data context.

  • You try to add a comment to an unbooked cell, but there're conflicting dimension members.

For example:

RMStoryTennisShoes is a restricted measure defined in the story that restricts the Product dimension to Tennis Shoes. One comment is successfully added for Tennis Shoes but a comment can't be added to the unbooked cell in the row below, as there is a conflict of dimension members.

There are also rare cases where you try to add a comment to a booked cell, but one or more of the dimension members that make up its data context have been deleted from the model, or the read access to one or more of the dimension members that make up its data context has been removed.

Note

You can’t add comments to data cells sourced from calculations defined in the table, except restricted measures (or accounts). However, these measures (or accounts) cannot be based on any underlying restricted or calculated measures (or accounts) that are created in the table, but they can be based on underlying calculated measures (or calculated accounts, i.e., accounts with formulas) defined in the Modeler.

Note

When commenting on a data cell sourced from a restricted measures (or account) defined in the table, the context includes the specific filters on dimensions used to create the restricted measure (or account). The comment will display in other tables and stories that apply the same filter combinations to the dimension.

For example:
  • You put a comment on a restricted measure based on account values that apply a filter on the region dimension to limit the member to 'North America'.

  • The comment will display in other tables or stories that apply the same filters to limit the region dimension to 'North America'.

Note

You can add comments to data cells sourced from calculations defined in the Modeler, which include calculated accounts (accounts with formulas), calculated measures, and conversion measures. The context of such comments does not include the specific filters on dimensions or variables used to create such a calculation, but it does include its name (or ID). Even with other tables and stories that apply the same filter combinations to these dimensions, as long as the calculation with the same name (or ID) is not available, the same comment won’t display.

For example:

The calculated measure in the column of this table is calculated by the following formula:

RESTRICT([amount] ,[d/Version] = "public.Actual" )

A data point comment of “Comment1” is added to the data cell (but managed and shown in the comment column) sourced from this calculated measure, with the version dimension filtered to Actual via the formula.

The table above is built on the same model and has a filter that restricts measure to Amount, which is the base measure of the calculated measure mentioned above. However, even though the data cell also has its version dimension filtered to Actual, the comment of the first table is not shown in this one, as the calculation with the same name is not available. Rather, you can add a different comment, like “Comment2”.

You can also add comments to data cells sourced from calculations mentioned above that include variables, which can be of number, dimension, and currency types. The same rule regarding the data context also applies: the name (or ID) of the calculation is included in the data context. For example:

The conversion measure of “CNY_Currency” has its target currency fixed to CNY while the conversion measure of “dynamic_Currency” has its target currency taken from a currency variable. Even when the currency variable is set to CNY, the same comment for “CNY_Currency” won’t appear for “dynamic_Currency”, as they’re two different conversion measures (with different names). And if the currency variable is changed to another currency, like EUR, the same comment of “comment for dynamic_Currency when the variable = CNY” will remain there, because the name of the conversion measure hasn’t changed.
Note

Comments are not supported when you set a filter using member navigation. For example, in an optimized design experience story or in view mode of an optimized view mode story, a dynamic range filter is set on a user-managed time dimension. If a story in the non-optimized (classic) experience that includes such a filter is converted to one in the optimized story experience, comments will also become unavailable

Note

When flat presentation and one hierarchy are used in two or more filters of a dimension of parent-child hierarchy, comments are not supported on members in flat presentation of this dimension if these members are parent nodes in the other hierarchy.

When a story is opened, Comment Mode is on by default.

When you add or remove dimensions, the existing comments will still be visible if the data context of the cell has not changed. In the example below, the comment on the left was created with a Region filter on Canada. On the right, Region has been added to the visible dimension without a filter. The context of the cell remains the same for both scenarios, therefore the same comment is visible.

Note

When your table has multiple hierarchical dimensions and the comment is added to a lower level member of an inner dimension, you won't see the comment wedge icon when you collapse the outer dimension.

Example:
  • You have two dimensions, Account and Region. In Account you expand Income Statement, and in Region you expand All Companies.

  • You add a comment to North America.

    A colored wedge is displayed to indicate that there is a comment.

  • You then collapse the All Companies hierarchy.

    The wedge is still visible, but it is now transparent.

  • Finally, you collapse the Income Statement hierarchy.

    The comment wedge disappears.

Procedure

  1. Select the data cell to which you want to add a comment.
  2. Right-click and then select Add Data Point Comment.
    A comment dialog is displayed.
  3. Enter your comment in the displayed dialog and select Add Comment to submit the comment.
    The comment is posted as part of a thread - a colored wedge shape is displayed at the top right of the cell.

    Comments on data points are available for other users as soon as they are made.

    Note

    The maximum number of characters of a comment is 10,000.

  4. To reply to a comment on a data point:
    1. Choose the wedge in the data cell.

    2. Select the displayed comment icon () to display the thread to which you want to reply.
    3. Enter your text in the reply box and then select Add Comment.
    Note
    A data point comment also displays the original value of the cell if the data value has changed.
    Note

    When you copy and paste formatted text to your comments, the source format may be lost.

    Note

    Comments are also supported on tables built on BPC or BW live data models. Make sure to enable the Allow Data Point Comments option, and do the following to add and interact with comments on such tables.

    • To add a new comment, right-click the data cell to which you want to add a comment, select Add Data Point Comment, enter your comment in the comment editor, and select Add Comment to submit the comment.

    • To edit an existing comment, choose the wedge in the data cell, select (Edit Comment), enter your comment in the comment editor and select Save to submit the comment.

      The comment will be updated to the text you just submitted and the existing comment will turn into an entry at the top of the comment history.

    • To show the history of a comment, choose the wedge in the data cell and select (Show/Hide History).

      The comment history will be shown below as a list of previous comments in chronological order, with the most recent comment placed at the top. To hide the history, select (Show/Hide History) again.

    • To delete a comment, choose the wedge in the data cell and select (Delete Comment).

    Here are the supported SAP BW versions for adding comments on such tables :

    SAP BW/4HANA 2.0 SP13 or higher. From SP07 to SP12, SAP Note 3244228 Information published on SAP site is required.

    SAP BW/4HANA 2021 SP04 or higher. From SP00 to SP03, SAP Note 3244228 Information published on SAP site is required.

    SAP BW 7.50 SP23 or higher, and SAP Note 3242613 Information published on SAP site, 3133846 Information published on SAP site, and 3169011 Information published on SAP site are required.

    Note

    For SAP Analytics Cloud version 2023.15 or later, which supports rich text formatting, SAP Note 3348600 Information published on SAP site is required.

    Note

    To add comments on tables built on BPC or BW live data models, make sure that your data source has correct CORS settings that cover the Service Path of /sap/bw/ina/Documents. For more information, see Live Data Connections to SAP BW and SAP BW/4HANA or Live Data Connections to SAP BPC Embedded. You can also check this blog post Comments on BW/BPC live Connections in SAP Analytics CloudInformation published on SAP site.

    Note

    Regarding comments on tables built on SAP BW or BPC live data models:

    The icon for editing or deleting comments won’t be available if you don’t have the corresponding SAP BW authorization.

    If you share a story that contains such a table and set a comment-related access, it won't be applied to comments on such a table as they are controlled by SAP BW authorizations. Such an access set when you share an SAP BPC or BW live data model will also not be applied.

    They are not collaborative. For a data cell, only one comment is maintained, with its history displayed if desired.

    Note

    What you need to know about comments on tables built on BW or BPC live data models:

    Individual entries in the comment history can’t be edited or deleted.

    There is no like ( ) functionality.

    The transparent comment wedge icon indicating there is a comment on a child member is not available.

    You can’t add comments to data cells sourced from calculations defined in the table, including restricted measures.

    Not all comments on duplicate nodes or link nodes and their original nodes in a hierarchy defined in the SAP BW are shown if they are managed in the commenting column, but they are shown normally when you remove the column and click their corresponding wedges in data cells.

Results

Another way to manage data point comments is by using a dedicated commenting column in your table. This column can be used to view and add comments. For more information on how create this column, see Create Custom Calculations Within Your Table.

Note

If you add a dedicated commenting column, all existing data point comment wedge icons will become invisible.

Note

If you disable the Allow Data Point Comments option, existing data point comments, including those added via data cell context menu or displayed and managed in the dedicated commenting columns, will disappear and you won't be able to edit these comments as a result. They will be shown again once you enable the option.

Next Steps

To create a new comment thread or reply to an existing comment thread, select the target cell in the column and enter your comment in the displayed dialog. Select Add Comment to submit the comment.
Note
The dedicated commenting column is created as a new member of the same dimension and hierarchy level as the member it references. You can change this context by referencing a different column in the commenting formula. Changing the drill state or adding a dimension can impact the context of the referenced cell.
Note
Only the most recent comment in a thread will display in a comment column cell. To view an entire comment thread, double-click in the corresponding cell.
Note

Let's dive into this example. The table on the left is built based on Model_1 while the table on the right is based on Model_2. A model link has been established between Model_1 and Model_2, and Location_1 and Location_2 are linked dimensions. A page filter based on the dimension Location_1 is applied to the table Model_2 apart from the table Model_1 (the filter also affects the dimension Location_2 from Model_2), which makes it a typical case of filtering across models.

When filtering across models, if a story or page filter and a table are based on different models, you are advised to not add comments in such a table (table Model_2 in this example). If you do add comments, you are advised to follow these two suggestions:
  • Put all linked dimensions in the table axis (the linked dimension Location_2 is put in the axis of table Model_2).

  • Use a direct filter (like the page filter on the left), which means a filter based on linked dimensions, instead of an indirect filter (like the page filter on the right, which is based on the dimension Color_1, which is not a linked dimension).

Not following these suggestions may lead to these issues:
  • Comments may be missing after you convert your story to one based on Optimized View Mode or Optimized Design Experience.

  • What is displayed in the table, including dimension members, may change in the case of using an indirect filter.

For more information about filtering across models, see Filter Across Models.

You can export a story as a PDF, PPTX or Google Slides file, comment columns in the visible parts of the story tables will also be exported.

You can also export a table with its comment column as a CSV or XLSX file. Note that you need to set Scope to Point of view in the case of CSV file.

Note

There is a randomness to the result if a story with data point comment indicators is exported. You may not see them in the exported file.