Modes (WorkWith)

Important:

This document applies to K2BTools 13.0 and earlier versions. Current documentation can be found in Standard Actions (WorkWith).

ActionIcon Description

This node is included as a child of WorkWith and SubWorkWith nodes. In it, it is possible to configure how standard actions will be treated in the corresponding WorkWith or SubWorkWith interface.

The developer may choose to disable some of the standard actions in design time, or include conditions that will determine the presence of the action in runtime.

Note that these conditions are not to be used as a security mechanism, but as a usability improvement for the end user. Even with these conditions in place, if the user acceses the transaction directly in one of its modes, the condition will not be evaluated and the user will be able to perform the operation.

To disable a transaction completely use the K2BTools security mechanism.

It is also possible to configure the behaviour of the PDF Report generated by K2BEntityServices in this node.

Runtime appearance

The effects of using this node are visible in the generated interface in the actions that are presented to the user. By default, all actions are visible, in the following example, the PDF Report and the Insert actions are disabled.

ModesDefinition ModesRT
Instance definition Runtime result (before and after changing the default behaviour)

Properties

Category Name Value
Modes Insert Determines if the insert action is active in this interface. This property's default value is loaded from K2BEntityServices Settings.
Update Determines if the update action is active in this interface. This property's default value is loaded from K2BEntityServices Settings.
Delete Determines if the delete action is active in this interface. This property's default value is loaded from K2BEntityServices Settings.
Multiple Delete Determines if the multiple delete action is active in this interface. This property's default value is loaded from K2BEntityServices Settings.
Display (Standalone Action)

Determines if the "standalone" display action is active in this interface. This property's default value is loaded from K2BEntityServices Settings.

Note: The "Standalone" display action is the display action shown as an independent button in the grid.

Display (Description Attribute)

Determines if the "description attribute" display action is active in this interface. This property's default value is loaded from K2BEntityServices Settings.

Note: The "Description attribute" display action is the display action shown as a link in the description attribute in the grid.

Export Determines if the export action is active in this interface. This property's default value is loaded from K2BEntityServices Settings.
Report Determines if the report action is active in this interface. This property's default value is loaded from K2BEntityServices Settings.
Conditions Insert Condition Contains a condition that will be executed in runtime to determine if the insert action will be shown to the user.
Update Condition Contains a condition that will be executed in runtime to determine if the udpate action will be shown to the user.
Delete Condition Contains a condition that will be executed in runtime to determine if the delete action will be shown to the user.
Display Condition Contains a condition that will be executed in runtime to determine if the display action will be shown to the user.
Export Condition Contains a condition that will be executed in runtime to determine if the export action will be shown to the user.
Report Condition Contains a condition that will be executed in runtime to determine if the report action will be shown to the user.
Edit Mode \ Popup Popup Autoresize Defines the value for the "Autoresize" property in the popup window generated to implement the "Popup" Edit Mode.
Popup Width Defines the value for the "Width" property in the popup window generated to implement the "Popup" Edit Mode.
Popup Height Defines the value for the "Height" property in the popup window generated to implement the "Popup" Edit Mode.
Use Popup In Display Mode Indicates if the Display action in this interface should open the transaction in a Popup or in an EntityManager.
Edit Mode \ Master-Detail Show Display Mode In Component Indicates if the Display action in this interface should open the transaction in the transaction pane or in an EntityManager.
Master-Detail Update Indicates if the "Master-Detail Update" action (in the transaction pane) should be generated or not. Only visible if the edit mode for the interface is "Master-Detail".
Master-Detail Delete Indicates if the "Master-Detail Delete" action (in the transaction pane) should be generated or not. Only visible if the edit mode for the interface is "Master-Detail".
No Item Selected Caption Contains the text shown in the transaction pane when it is empty.
Navigation After Insert

Specifies where the user should be redirected to after a successful insert operation. See Changing the navigation after confirming a transaction.

After Update

Specifies where the user should be redirected to after a successful update operation. See Changing the navigation after confirming a transaction.

After Delete

Specifies where the user should be redirected to after a successful delete operation. See Changing the navigation after confirming a transaction.

Multiple Delete Multiple Delete Error Message Error message shown in runtime when the multiple delete action is executed but no items were selected.
Multiple Delete Confirmation Message Confirmation message shown when executing the multiple delete action.
Multiple Delete Success Message Success message shown after executing the multiple delete action successfully.
Multiple Delete Rollback Message Message shown after executing the multiple delete action when an error ocurred and the operations were rollbacked.
Report Configuration Report Layout This property references the report layout object that will be used in the generation of the Report object. This object can be used to define the appearance of the generated PDF file, and default headers/footers.
Export Layout This property references an Export Layout object that can be used to customize the generation of the Excel export file.
Paper Type Indicates the paper size that will be used in the PDF Report generation. This property's default value is loaded from K2BEntityServices Settings.
Orientation Indicates the paper orientation that will be used in the PDF Report generation. This property's default value is loaded from K2BEntityServices Settings.