Table of Contents

APP - Customizer Screens

Admin Access Screen

The APP Admin Access screen lists all SAP® Business One users who will have access to the Windows based forms loaded by the Customizer and Dashboards modules in APP.

Click the SAP menu option titled TWBS Admin Access under the Administration image10.jpeg Setup image10.jpeg APP Configuration menu to load the APP Admin Access screen.

image44.jpeg

Publish Forms Screen

The APP Customizer Publish Forms screen lists all SAP® Business One forms or other APP registered forms that have been modified through APP Customizer.

Click the SAP menu option titled Publish Forms under the Administration image10.jpeg Setup image10.jpeg APP Configuration image10.jpeg Customizer menu to load the APP Customizer Publish Forms screen.

Once the APP Customizer modifications for a form have been published, users will need to close and reopen any published forms in order for the modifications to be visible to the user.

image44.jpeg

Item Placement

Item Placement functionality allows the user to add objects (labels, text fields, buttons, and tabs) to enhance any SAP® Business One forms or UI-based add-on application screens or edit the properties of existing SAP objects without the use of programming knowledge.

image44.jpeg

Form Properties/Events Screen

The Form Properties/Events screen lists all properties and events for the form.

image315.jpeg

Properties Tab

Events Tab

The events displayed will be filtered by the type of item being configured.

image44.jpeg

Item Placement - Item Configurator Screen

Item Placement capabilities allow the user to add objects (labels, text fields, buttons, and tabs) to enhance any SAP® Business One forms or UI-based add-on application screens or edit the properties of existing SAP objects without the use of programming knowledge.

The Item Configurator screen lists all configured items for a selected form.

When the Item Configurator screen is loaded from the main SAP menu option, no default data is loaded to the screen. The user must select a form from the drop down at the top of the screen to load the data for that specific form.

image316.jpeg

image44.jpeg

Item Placement - Item Properties/Events Screen

Item Placement capabilities allow the user to add objects (labels, text fields, buttons, and tabs) to enhance any SAP® Business One forms or UI-based add-on application screens or edit the properties of existing SAP objects without the use of programming knowledge.

The Item Properties/Events screen lists all properties and events for the configuration item.

If a property does not apply to the item that you are customizing, the fields for that property will be deactivated.

If the Item Type of the object is an edit text field, the user will have access to a button image317.jpeg to the right of the field that will allow the user to change the item to an extended edit text field by clicking on it.

image315.jpeg

Properties Tab

Events Tab

The events displayed will be filtered by the type of item being configured.

image44.jpeg

Process Rules

Process Rules functionality allows the user to add field validations and procedure executions to enhance any SAP® Business One forms or UI-based add-on application screens without the use of programming knowledge.

image44.jpeg

Process Rules Procedure Summary Screen

The Process Rules Procedures Summary screen provides the user with a summary of all Process Rules Procedures that have been created in the APP Customizer.

image320.jpeg

image44.jpeg

Process Rules Event Handler Screen

The Process Rules Event Handler screen lists all of the event customization options for the configuration item. This screen is launched from the Events tab of the Item Properties/Events screen.

image321.jpeg

Changes to the Event option will be reflected on the originating Item Properties/Events screen after applying the modifications.

The Action Success option is only applicable if the Before Action option is set to False.

If the procedure to be executed is a query, the results of the query will be loaded into an SAP® Business One Query screen regardless of the option selected in the definition of the query being executed.

If the procedure to be executed is a query, the results of the query will be loaded into an SAP® Business One Query screen regardless of the option selected in the definition of the query being executed.

If the procedure to be executed is a query, the results of the query will be loaded into an SAP® Business One Query screen regardless of the option selected in the definition of the query being executed.

image44.jpeg

Procedure Handler Screen

The Procedure Handler screen lists all options and properties for procedures.

Macro Tab

image322.jpeg

Pressing the Load Macro Editor button before recording a Macro will load a blank Macro Editor screen.

Pressing the Record button on an existing Macro will result in the loss of previous information from the Macro and the recording of new information. It will not append any previous Macro information.

image325.jpeg

Alerts Tab

image326.jpeg

Severity property applies only to the Status Bar alert type.

Duration property applies only to the Status Bar alert type.

Queries Tab

image330.jpeg

image44.jpeg

Macro Editor Screen

The Macro Editor screen lists the event information for each step of a recorded Macro.

The Macro Editor will only support actions against screens where there are not multiple instances of that screen open in SAP® Business One when the macro is being performed. For example, a macro that performs an action against form #139 (the Sales Order form) should only be performed with one Sales Order form window open.

image332.jpeg

The Action Type Samples Guide section of the guide provides samples for setting up each Action Type.

image44.jpeg

Macro Editor Values Entry Screen

The Macro Editor Values Entry screen provides the means to enter the value associated with a Macro command. It also provides a syntax sample, arguments associated with the command, and an entered value example.

image343.jpeg

image44.jpeg

Macro Editor Line Events Values Entry Screen

The Macro Editor Line Entry Values Entry screen provides the means to enter the details associated with a LineEvents Action Type.

Line Events can be coded to only one form and item at a time.

image344.jpeg

image44.jpeg

SendKeys Action Type Key Reference Guide

Each key is represented by one or more characters.

To send characters that aren't displayed when you press a key, such as ENTER or TAB, and keys that represent actions rather than characters, use the codes shown below:

Key Code
Backspace {BACKSPACE}, {BS}, or {BKSP}
Break {BREAK}
Caps Lock {CAPSLOCK}
Delete {DELETE} or {DEL}
Down Arrow{DOWN}
End {END}
Enter {ENTER}
Esc {ESC}
Help {HELP}
Home {HOME}
Insert {INSERT} or {INS}
Left Arrow{LEFT}
Num Lock {NUMLOCK}
Page Down {PGDN}
Page Up {PGUP}
Right Arrow {RIGHT}
Scroll Lock {SCROLLLOCK}
Tab {TAB}
Up Arrow {UP}
F1, F2, F3…{F1}, {F2}, {F3}…
Shift {+}
Ctrl {^}
Alt {%}

To specify the combination of the Shift, Ctrl, or Alt keys with another keystroke, precede the keystroke value with the {+}, {^} or {%} code for the keys to combine.

To specify that any combination of Shift, Ctrl, and Alt should be held down while several other keys are pressed, enclose the code for those keys in parentheses. For example, to specify holding down Shift while E and C are pressed, use “+(EC)”. To specify holding down Shift, while E is pressed, followed by C without Shift, use “+EC”.

SendKeys does not support sending the same keystroke value repeatedly.

SendKeys does not support sending keystroke combinations that are not relevant to SAP® Business One. For example, all of the function keys currently do not have any functionality associated with them.

image44.jpeg

Tab Order Sequence

Tab Order configuration functionality allows the user to establish, edit, and remove custom designated tab orders for forms that will override the normal order of moving between fields on a form.

The tab order cannot be used to set the tab order of columns in an SAP UI grid or matrix object. This is an SAP® Business One UI limitation.

image44.jpeg

Tab Order Configuration Summary Screen

The Tab Order Configuration Summary screen lists all tab sequences associated with a form.

When the Tab Order Configuration Summary screen is loaded from the main SAP menu option, no default data is loaded to the screen. The user must select a form from the drop down at the top of the screen to load the data for that specific form.

image397.jpeg

image398.jpeg

image44.jpeg

Tab Order Configuration Detail Screen

The Tab Order Configuration screen lists all information associated with a tab sequence.

image399.jpeg

image44.jpeg

Mandatory Fields

Mandatory Fields functionality allows the user to establish, edit, and remove custom designated mandatory fields for forms that will operate in addition to the normal required fields on a form.

image44.jpeg

Mandatory Fields Configuration Summary Screen

The Mandatory Fields Configuration Summary screen lists all mandatory fields configurations associated with a form.

When the Mandatory Fields Configuration Summary screen is loaded from the main SAP menu option, no default data is loaded to the screen. The user must select a form from the drop down at the top of the screen to load the data for that specific form.

image400.jpeg

image44.jpeg

Mandatory Fields Configuration Detail Screen

The Mandatory Fields Configuration screen lists all information associated with a mandatory fields configuration.

image401.jpeg

On most SAP® Business One forms, the unique ID of the OK/Add/Update button is “1”.

image44.jpeg

Manage Control State Screen

The Manage Control State screen allows for the management of the visible and enabled properties for all controls on a screen in a centralized interface.

The visible/enabled properties are not being removed from the Form Properties/Events screen. Any values set for controls there in previous versions of APP will retain their values. However, any Manage Control State customized entries will override the Form Properties/Events screen settings.

Only one entry per form control is allowed and modifiable on this screen. Therefore you cannot have one line for a control assigned to or excluding specific users and also have a second line configured differently for the same control.

The customized entry on the Manage Control State screen will be overridden by any customized properties set directly on the control itself.

image402.jpeg

image44.jpeg

Menu Shortcut Screen

Menu shortcut maintenance capabilities allow the user to establish, edit, and remove custom menu options from the SAP® menu structure that are associated with APP Customizer defined procedures.

image404.jpeg

Image should be no larger than 16 pixels by 16 pixels.

image44.jpeg

Customizer User List Screen

Many of the APP Customizer screens allow for the specification of the users, branches, or departments to which the settings either will or will not be applied. The User List screen is commonly used through APP Customizer features to allow for this designation.

To view the user information in the system, click the SAP menu option for Users under the Administration image10.jpeg Setup image10.jpeg General menus to load the Users - Setup screen.

Users Tab

image409.jpeg

Branches Tab

image410.jpeg

Departments Tab

image411.jpeg

image44.jpeg

Color Guide for Color Properties

APP Customizer includes the ability to set values for display colors for several properties of forms and items. Several commonly used colors are referenced below for easy application of the values and the methods that can be used to determine a color are explained.

Commonly Used Color Values

image412.jpeg Red (255)

image413.jpeg Pink (12615935)

image414.jpeg Orange (33023)

image415.jpeg Yellow (65535)

image416.jpeg Lt. Green (8454016)

image417.jpeg Green (65280)

image418.jpeg Lt. Blue (16777088)

image419.jpeg Blue (16744448)

image420.jpeg Purple (8388736)

image421.jpeg White (16777215)

image422.jpeg Gray (12632256)

image423.jpeg Brown (4210816)

Selecting A New Color Value

image424.jpeg

image425.jpeg

image44.jpeg