Versions Compared

Old Version 1

changes.mady.by.user Susanne Tilgner

Saved on

compared with

New Version Current

changes.mady.by.user Lars Schubert

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Excerpt
nameen Definition of Context for Commenting (comments)

Um einen Kommentar zuordnen zu können, wird dieser mit einer frei zu definierenden Menge von sog. Kontexten abgelegt. Durch diese Kontexte lässt sich der Kommentar etwa einer Datenkonstellation, einer Filterkonstellation, einer bestimmten Visualisierung, einem spezifischen Dashboard oder einer beliebigen anderen Einschränkung zuordnen. Beispielsweise, dass der aktuelle Kommentar für das “Jahr 2017” im “Land Deutschland” gilt.

Ein Kontext ist immer durch einen key z.B. eine Dimension und einen value z.B. eine Ausprägung beschrieben. In den Beispielen oben wären die keys “Jahr” oder “Land”und die values “2017”bzw.“Deutschland”. Die Kontexte können statisch im GPS festgelegt werden oder in BI-Umgebungen wie die SAP Analytics, die ein Skripting ermöglichen auch dynamisch über die Skriptsprache. Wird die Kommentierung in einer Visualisierung von uns genutzt, so werden für Datenpunktkommentare automatisch Datenkontexte für die dem Datenpunkt zugrundeliegende Datenhierarchie anlegt. Für einen Visualisierungskommentar, der die Visualisierung als Ganzes beschreibt, wird automatisch ein Umgebungskontext angelegt, der auf eine zufällig generierte und persistierte ID der Visualisierung verweist.Aus der Menge der Kontexte zu einem Kommentar wird implizit eine Hierarchie gebildet, die in unserer eigenständigen Kommentarkomponente unter “more specific comment(s)”abgebildet wird. So wird es möglich, dass wenn als Kontext beispielsweise ausschließlich der Name des Dashboards als Umgebungskontext definiert wurde, unter dem Punkt für die weiteren Kommentare solche auftauchen, die vorher in einem anderen Kontext geschrieben wurden, der zusätzlich zu dem Namen des Dashboards beispielsweise auch noch eine Ausprägung der Dimension “Jahr” als Datenkontext festgelegt hatten und somit spezifischer als die aktuelle Menge von Kontexten festlegt sind.

Kontextarten

Umgebungskontext

Der “Environment Context” ist dazu gedacht den Kommentarraum auf Eigenschaften einzuschränken, die nicht von den Daten abhängig sind. So könnte der Kommentarraum beispielsweise auf das aktuelle Dashboard eingegrenzt werden. Ein Umgebungskontext ist auch durch eine Kombination von key und value definiert. In unserem Beispiel könnte der key also etwas wie “Dashboard Name”und der value z.B. “Sales Dashboard” sein.

Datenkontext

Der “Data Context” ist dazu gedacht den Kommentarraum auf eine gewisse Datenkonstellation einzuschränken. Er enthält zusätzlich zu den Eigenschaften key und value noch die optionalen Eigenschaften keyText und valueText. Diese dienen dazu den Anzeigenamen aus der Datenquelle (wenn denn vorhanden) für die Dimension und den Member zu pflegen, da dies die Darstellung von einem Kommentar zugehörigen Kontexten verständlicher macht. Da Dashboards und Datenlagen sehr divers und dynamisch sein können, werden diese in Umgebungen mit Skripting-Möglichkeiten meistens direkt ausgelesen und so gepflegt. Als Datenkontext könnte also beispielsweise festgelegt werden, dass der key “Jahr” mit dem value “2017” definiert ist.

Festlegungsarten von Kontexten

Statische Kontexte

Die “Static Contexts” werden im GPS festgelegt und gelten so unabhängig von beispielsweise per Skripting festgelegten Filterzuständen über die gesamte Laufzeit hinweg. Ein Static Context könnte bspw. dafür verwendet werden, den Kommentarraum auf das aktuelle Dashboard einzugrenzen. Dafür wäre der Type “EnvironmentContext” zu wählen.

Dynamische Kontexte

Die “Dynamic Contexts” werden in Umgebungen mit Skripting dort basierend dem aktuellen Zustand gesetzt. Diese werden in der Regel dafür verwendet, dynamisch den aktuellen Filterzustand auf den Daten an die Kommentare weiter zu geben, wodurch ein gepflegter Kommentar dann genau dieser Datenkonstellation zugeordnet wird. Beispielweise kann ein Dropdown in einer Anwendung, dass das aktuelle Jahr auf der Datenquelle filtert gleichzeitig einen Datenkontext an der Kommentarkomponente setzen, der den key “Jahr” mit dem value der im Dropdown ausgewählt wurde zuordnet. Dynamische Kontexte überschreiben die Statischen Kontexte nicht.

Automatische Kontexte

In der Verwendung der Kommentare in Verbindung mit unseren Visualisierungen, werden für Datenpunktkommentare die dem Datenpunkt zugehörige Datenhierarchie und für Visualisierungskommentar die ID der Visualisierung automatisch dem Kommentar zugeordnetIn order to be able to assign a comment, it is stored with a freely definable set of so-called contexts. These contexts allow the comment to be associated with a data constellation, a filter constellation, a specific visualization, a specific dashboard or any other restriction. For example, that the current comment applies to the "year 2021" in the "country Germany".

A context is always described by a key, e.g. a dimension, and a value, e.g. a member. In the examples above, the keys would be 'year' or 'country' and the values would be '2021' or 'Germany'.Contexts can be defined statically in the GPS or dynamically using the scripting language in BI environments that allow scripting, such as SAP Analytics Cloud (SAC). If you use data point comments in a visualization, the contexts of the comments are automatically derived from the dimensions members used in the visualization. For a title comment that describes the visualization as a whole, an environment context is automatically created that refers to a randomly generated and persisted ID of the visualization.

A hierarchy is implicitly formed from the set of contexts for a comment, which is mapped in our independent comment component under "more specific comment(s)". For example, if only one context is specified as the context combination to be displayed, all comments containing at least that context will be displayed here. Assuming that only the name of the dashboard is specified as the context combination, more specific comments about each year will also be displayed here.

Context Types

Environment Context

The "Environment Context" is intended to limit the comment space to properties that are not dependent on the data. For example, the comment area could be restricted to the current dashboard. An Environment Context is also defined by a combination of key and value. In our example, the key could be something like "Dashboard Name" and the value could be "Sales Dashboard".

Data Context

The "Data Context" is used to restrict the comment space to a certain data constellation. In addition to the properties key and value, it also contains the optional properties keyText and valueText. These are used to maintain the display name from the data source (if available) for the dimension and member. This makes the display of contexts associated with a comment easier to understand. Dashboards and data layers can be very diverse and dynamic. Therefore, they are usually read and maintained directly in scripting environments. For example, the data context could be set so that the key 'Year' is defined with the value '2021'.

Context setting types

Static Contexts

The "Static Contexts" are defined in the GPS and thus apply independently of filter states defined by scripting, for example, throughout the entire runtime. A static context could be used, for example, to limit the comment space to the current dashboard. The type "Environment Context" should be selected for this.

Dynamic Contexts

The "Dynamic Contexts" are set in environments with scripting, there based on the current state. These are usually used to dynamically pass on the current filter state on the data to the comments.
In this way, a maintained comment is assigned to exactly this data constellation.

For example, we can connect a dropdown with a selection for the current year. When the dropdown is used, it filters the data source at the same time and adds a data context. This data context then consists of the key "Year" and the value that was selected in the dropdown. Static contexts are of course retained.

Automatic Contexts

Automatic contexts are created when using our visualizations with comments. The data hierarchy associated with the data point is automatically assigned to the comment. The visualization comment is automatically assigned the visualization ID.