Versions Compared

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 wirdIn 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 value. 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. If we use the comments in a visualization, data contexts are automatically created for data point comments for the data hierarchy on which the data point is based. For a visualization 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)". 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

Context Types

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

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'.

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 zugeordnet.