Enterprise Edition:Context

From version 9.3 HF 2.7 it's possible to transfer the context (=current filter settings in masks) other actions.

Description

The context contains the current settings which the user uses in the active mask. Following settings can be used:

• Filter: The currently selected filter settings
• Axis: The currently displayed and selcted for display elements on the axis
• Position: The current position on the axis is taken as filter in the context (only for matrix masks)

matrix mask, context, position

The context will always be set in the source mask The target responds only to the existing context, the reaction depends on the type of the object.

If there are parameter set in the context, which cannot be interpreted by the called component (eg axial are transferred to a detail record) , they will be ignored by the called component.

Hint  The filter/axis matching between the individual elements is based on the filter name in the mask, this corresponds to the Alias at the level of CoPlanner Cube.

The context of the source mask can be forwarded to the following targets:

• Macros
• Imports
• Masks
• Webpages

Set context in source mask

Depending on the type of mask, you can set all or certain settings:

• Input mask: filter, axis, position
• Single row mask: filter
• Single record mask: filter

The configuration of the context can be made at the following positions in the source mask:

Configuration	Description
Properties measure settings	The context can be configured over the property DetailContext under the properties of measure settings, onto which fall back on the jump of the detail record. Masks, Properties measure settings, DetailContext
MakroDescriptor-listing-editor	The context can be configured over DetailContext at MacroDescriptor-listing-editor when calling a macro. MacroDescriptor-listing-editor, DetailContext
General properties	If a macro will be executed by save, the context of this can be configured via the property MacroOnSaveContext under general properties. Masks, General properties, MacroOnSaveContext

Kontextweitergabe an Zielobjekt Makro

Der Kontext wird sowohl für serverseitige Makros, als auch für clientseitige (= NAV-Aktionen) Makros unterstützt, wobei jedoch das Verhalten unterschiedlich ist:

• Bei serverseitigen Makros werden Filtereinstellungen übernommen, und für die Abarbeitung des aktuellen Befehls/Requests verwendet; Achseinstellungen spielen hier keine Rolle (werden Achseinstellungen in den Filter übernommen, so wird dies gleich wie ein Filter behandelt). Dies bedeutet, dass das zu bearbeitende Datenset durch die im Kontext übergebenen Filter eingeschränkt wird.
• Bei clientseitigen Makros wird der gesamte Kontext an das Zielobjekt einer Nav-Aktion weitergegeben.

Ein Makro ist immer nur Ziel für Einstellungen, die im Kontext weitergegeben werden. Es kann aber selbst keine Einstellungen weitergeben.

Hinweis  Werden über den Kontext Filtereinstellungen für eine Dimension weitergegeben, so dürfen im Makro keine weiteren Filtereinstellungen für diese Dimension definiert werden; das Verhalten des Systems, wenn beides vorhanden ist, ist nicht definiert.

Beispiel: Kontext einer Eingabemaske an Löschmakro übergeben

• Erstellen Sie ein Löschmakro mit einem eingeschränkten Filter über die 'Umsatzerlösarten':

Eingabemaske, Makro

• Binden Sie dieses Makro in die Quellmaske ein und konfigurieren Sie den Kontext mit folgenden Einstellungen:

Objektverwaltung, Makro

• Öffnen Sie die Quellmaske mit Einschränkung des Filters 'Umsatzerlösarten':

Eingabemaske, Filtereinstellungen

• Die Makroausführung in der Quellmaske führt zu dem Ergebnis, dass die Dimension 'Umsatzerlösarten' der Quellmaske nicht an das Makro übergeben wird, da diese im Kontext ausgenommen wurde. Stattdessen wird das Makro mit dem selbst definierten Filter ausgeführt. Wäre diese Dimension im Kontext nicht ausgenommen, würden über das Makro nur jene Umsatzerlöse mit der Umsatzerlösart 'Handelswaren' gelöscht werden.

Kontextweitergabe an Zielobjekt Import

Für ein Importobjekt werden die Filtereinstellungen übernommen. Analog zu Masken können für einzelne Dimensionen entweder Einstellungen im Importobjekt getroffen werden, oder aber die Werte aus dem Kontext übernommen werden. Wird bei einer einzelnen Dimension beides getan, so wird dies vom System nicht unterstützt (das Verhalten des Systems ist undefiniert).

Ein Importobjekt ist immer nur Ziel für Einstellungen, die im Kontext weitergegeben werden. Es kann aber selbst keine Einstellungen weitergeben.

Hinweis  Die Einstellungen können nur für Importobjekte mit Datenquelle „Datendefinition“ gesetzt werden, nicht jedoch für die Typen „SQL“ oder „Text“.

Beispiel: Kontext einer Eingabemaske an Import übergeben

• Erstellen Sie ein Löschmakro mit einem eingeschränkten Filter über die 'Umsatzerlösarten':

Kontextweitergabe an Zielobjekt Maske

Der Kontext kann an Eingabemasken, Zeilensichten und Einzelsatzmasken übergeben werden. Je nach Maskentyp können diese nur bestimmte Werte aus dem Kontext übernehmen:

• Eingabemasken: Filter, Achse, Position
• Zeilensichten: Filter, Position
• Einzelsatzmasken: Filter, Position

Zu setzen ist der Kontext in den Eigenschaften des Measures unter Measureeinstellungen.

Kontextweitergabe an Zielobjekt Webpage

Ist das Zielobjekt eine Webpage, kann der aktuelle Kontext über die URL weitergegeben werden und wird auch bei einem Aufruf aus dem CoPlanner Client entsprechend gesetzt.

Eine Webpage ist immer nur Ziel für Einstellungen, die im Kontext weitergegeben werden. Es kann aber selbst keine Einstellungen weitergeben.

Der CopLink kann im CopContextDialog erstellt werden. Dieser wird durch das Tastenkürzel "Strg J" aus einer Matrix- oder Zeilenmaske heraus geöffnet.

CopContextLinkDialog