.. include:: ../../global.rst K2 Business Apps #################################################################################################### This control allows you to interact with K2 Business Apps. You can perform app specific actions and get or set certain values in the app. .. note:: The K2 Business Apps control is only shown in design time. Properties **************************************************************************************************** Details ==================================================================================================== Name The name of the control. .. _k2ba-property-events: Events ==================================================================================================== Photo Contains the last photo confirmed by the user after using the Start Camera action. Swipe Action ID Contains the last swipe action selected by the user. .. _k2ba-events: Events **************************************************************************************************** On Download Tile Map Finished ==================================================================================================== This event is triggered when the action Download Tile Map is finished. .. _k2ba-events-on-list-view-item-swiped-left: On List View Item Swiped Left ==================================================================================================== This event is triggered when a list view item was swiped left. It will only be called when the rule :ref:`Add List View Swipe Gestures ` has been called before and specified items on the left side. The data source bound to the view will now contain the values for the swiped row. .. _k2ba-events-on-list-view-item-swiped-right: On List View Item Swiped Right ==================================================================================================== This event is triggered when a list view item was swiped right. It will only be called when the rule :ref:`Add List View Swipe Gestures ` has been called before and specified items on the right side. The data source bound to the view will now contain the values for the swiped row. On Photo Ready ==================================================================================================== This event is triggered when a photo is confirmed after starting the camera with the rule Start Camera. OnMaxPhotoLimitExceeded ==================================================================================================== This event is triggered when more photo's are selected than the provided max amount on the `Start Camera`_ method. *it is only possible to select too many photo's in the browser's file selection dialog.* Actions **************************************************************************************************** .. _k2ba-actions-add-list-view-swipe-gestures: Add List View Swipe Gestures ==================================================================================================== This allows you to add swipe actions to list view items and thus only works when called on a list view. You can specify actions on both the left and right side. All text inputs may contain a semicolon separated list in order to specify multiple actions on a side. If you specify multiple items, make sure the lists are of equal length. When an item is selected, one of two events is triggered: :ref:`On List View Item Swiped Left ` or :ref:`On List View Item Swiped Right `. In these events, you can use the property Swipe Action ID to determine which of the actions was selected by the user. Left: Enabled Yes to enable the left items, no (default) to disable them. Left: IDs The identifiers for the left actions. These can be used to determine which action was selected in case there are multiple. Left: Texts The texts that will be shown on the left actions. Left: Icons FontAwesome codes (4 characters) to specify the icon to show on the left actions. Left: Colors Hexadecimal values in the format #rrggbb to set the background color of the left actions. Right: Enabled Yes to enable the right items, no (default) to disable them. Right: IDs The identifiers for the right actions. These can be used to determine which action was selected in case there are multiple. Right: Texts The texts that will be shown on the right actions. Right: Icons FontAwesome codes (4 characters) to specify the icon to show on the right actions. Right: Colors Hexadecimal values in the format #rrggbb to set the background color of the right actions. Debug ==================================================================================================== For internal use only. Download Data Source ==================================================================================================== Downloads a data source so it can be used in offline mode. Download Tile Map ==================================================================================================== Downloads a map that can be used in the Leaflet control. Get Global Parameter ==================================================================================================== Get a previously set global parameter. Get Prefer Work Offline ==================================================================================================== Returns whether the user currently wants to work offline. Is App ==================================================================================================== Returns true when executed in K2 Business Apps and false when executed in the browser. Is Online ==================================================================================================== Returns true when there is internet and the user settings allow us to use it. New GUID ==================================================================================================== Returns a new globally unique identifier. Remove Global Parameter ==================================================================================================== Deletes a global parameter. Resize Image ==================================================================================================== Allows you to resize a given image. The inputs are a K2 image (e.g. from the image attachment control) and the maximum dimension of the image. The output is a K2 image. Scroll To ==================================================================================================== Allows you to scroll to a specified view or control on a view. The method has two inputs: View Name The name of the view as specified on the form. Control Name The name of the control as specified on the view. * If only a view is provided, this method will scroll to that view. * If only a control is provided, this method will scroll to that control. Just remember that form controls are not rendered by K2 Business Apps. * If both a view and a control are provided, this method will scroll to the control on the view. .. Note:: This method also works in the browser. Set Draft Information ==================================================================================================== Allows you to set the title and description of the current draft. Use this to differ between drafts created from the same template. Set Global Parameter ==================================================================================================== Creates a global parameter. Set Language ==================================================================================================== Allows you to force the entire app to a certain language. You can provide either the LCID string or decimal found here. The languages supported are: * English (US) * Dutch (NL) Set List View Layout ==================================================================================================== Allows you to specify a custom layout for a list view by defining a grid and location for each control in the grid. Set Prefer Work Offline ==================================================================================================== Sets whether the user prefers to work in offline mode or online mode. Set Project ==================================================================================================== Sets the project the user is working on. Start Camera ==================================================================================================== Allows you to start the camera from a rule. You can specify the maximum amount of photos that can be taken after another before the camera is closed. After each confirmed photo, the event OnPhotoReady is triggered. The property Photo on the K2 Business Apps control now contains the photo. Submit Form ==================================================================================================== After creating a draft, you may want to remove it from the app at some point. This can be called once all data of a draft has been handled and the form in the app is considered completed. Subscribe To Notification Topic ==================================================================================================== Allow you to subscribe someone to a certain notification topic. Unsubscribe From Notification Topic ==================================================================================================== Allows you to remove someone from a certain notification topic.