This is an old revision of the document!
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
Setup
APP Configuration menu to load the APP Admin Access 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
Setup
APP Configuration
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.
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.
The Form Properties/Events screen lists all properties and events for the form.
The events displayed will be filtered by the type of item being configured.
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.
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
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.
The events displayed will be filtered by the type of item being configured.
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.
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.
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.
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.
The Procedure Handler screen lists all options and properties for procedures.
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.
Severity property applies only to the Status Bar alert type.
Duration property applies only to the Status Bar alert type.
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.
The Action Type Samples Guide section of the guide provides samples for setting up each Action Type.
The value for selection must be an existing option in the combo box.
The form to be closed must have been opened in the same macro session.
Useful with making multiple updates to the form to minimize data reloading. The FormUnfreeze must accompany this action at the end of the updates. Failure to execute the FormUnfreeze action will result in a non-functional form.
APP Customizer will pass the value specified for the OpenExternalProgram action type as if the user had typed the value on the Run command window. In order for a value to work through APP Customizer, it should be able to function if manually typed on the Run command window.
The value will be defaulted by the application but can be altered by the user.
Clicking in the Value column will open the Macro Editor Values Entry screen.
The value for selection must be an existing option in the combo box.
If no value entered, default suppression is 5 seconds.
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.
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.
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.
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.
The Tab Order Configuration Summary screen lists all tab sequences associated with a form.
Click the SAP menu option titled Tab Sequence Configurator under the Administration -Setup -APP Setup -Customizer menu to load the Tab Order Configuration Summary screen.
Note - 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.
To load the data for a specific form directly into the Tab Order Configuration Summary screen, access the form that you want to see the information for. Select the Tab Sequence Configurator option from the APP Customizer -Tab Order menu group option from the right-click menu on the form.
Description - The description given to the tab order sequence.
User List - The list of any specific users associated with the tab order configuration. A blank value means it applies for all users.
User Type - The type of users associated with the tab order configuration. A blank value means it applies for all users.
Exclude - Indicates if the Exclude Selected Items checkbox on the **Tab Order Configuration Detail** screen was selected. “T” indicates it was selected, “F” indicates it was not selected.
Edit button - Edit the tab order sequence details. This button will load the **Tab Order Configuration Detail** screen.
Remove button - Remove the tab order sequence.
Copy To button - Copy the tab order sequence details to another form.
Close button - Close the form.
The Tab Order Configuration screen lists all information associated with a tab sequence.
Click the **Edit** button for a tab sequence on the **Tab Order** **Configuration Summary** screen.
Code - The unique ID given to the tab order configuration.
Form Type - The type of the form for which the tab order configuration is assigned.
Description - The description given to the tab order sequence.
Applicable Users - The specific user(s) to which the tab order sequence is assigned if not assigned to all users.
Exclude Selected Items checkbox - Option to designate that the specific users, branches, and/or departments listed in
the Applicable Users field will be the ones excluded from application of the tab order sequence.
Item UID - The unique item ID of the item in the tab order configuration.
Description - The description of the item in the tab order configuration.
Active checkbox - Indicates if the tab order configuration is active.
Add button - Add an additional item to the tab order sequence.
Remove button - Remove the item from tab order sequence.
Up button - Move the highlighted item one spot higher in the tab order sequence.
Down button - Move the highlighted item one spot lower in the tab order sequence.
OK button - Save the information and close the form.
Cancel button - Close the form.
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.
The Mandatory Fields Configuration Summary screen lists all mandatory fields configurations associated with a form.
Click the SAP menu option titled Mandatory Settings Configurator under the Administration -Setup -APP Setup -Customizer menu to load the Mandatory Fields Configuration Summary screen.
Note - 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.
To load the data for a specific form directly into the Mandatory Fields Configuration Summary screen, access the form that you want to see the information for. Select the Mandatory Settings Configurator option from the APP Customizer -Mandatory Fields menu group option from the right-click menu on the form.
Description - The description given to the mandatory fields. Warning - Indicates if the Warning Only checkbox on the **Mandatory**
Fields Configuration Detail screen was selected.
User List - The list of any specific users associated with the mandatory fields. A blank value means it applies for all users.
User Type - The type of users associated with the mandatory fields. A blank value means it applies for all users.
Exclude - Indicates if the Exclude Selected Items checkbox on the **Mandatory Fields Configuration Detail** screen was selected. “T” indicates it was selected, “F” indicates it was not selected.
Edit button - Edit the mandatory fields details. This button will load the **Mandatory Fields Configuration Detail** screen.
Remove button - Remove an item from the mandatory fields.
Clone button - Create a copy (clone) of the mandatory fields.
Copy To button - Copy the mandatory fields details to another form.
Close button - Close the form.
The Mandatory Fields Configuration screen lists all information associated with a mandatory fields configuration.
Click the **Edit** button for a tab sequence on the **Mandatory Fields** **Configuration Summary** screen.
Code - The unique ID given to the mandatory fields.
Form Type - The type of the form for which the mandatory fields are assigned.
Description - The description given to the mandatory fields. Add/Update UID - The unique ID of the form item that is responsible for the Add/Update functionality of the form.
Note - On most SAP® Business One forms, the unique ID of the OK/Add/Update button is “1”.
Applicable Users - The specific user(s) to which the tab order sequence is assigned if not assigned to all users.
Exclude Selected Items checkbox - Option to designate that the specific users, branches, and/or departments listed in
the Applicable Users field will be the ones excluded from application of the mandatory fields.
Check During Add checkbox
<ul><li><p>
Designates that the verification of completion will be done on add of the object.
</p></li></ul>
Check During Update checkbox - Designates that the verification of completion will be done on update of the object.
Mark Mandatory Fields with Color - Indicates which color will be used to mark fields that are including in the setting of the mandatory fields.
Item UID - The unique item ID of the item in the mandatory fields.
Description - The description of the item in the mandatory fields.
Column - The unique column ID of the item in the mandatory fields if located in a grid/matrix.
Empty Value - Indicates the empty value.
Ignore Last Row checkbox - Designates that the last row will be ignored.
Warning Only checkbox - Designates that the user will be prompted with warning messages only if the designated fields are not completed. This will not prevent the add/update of the object.
Active checkbox - Indicates if the mandatory fields is active.
Add button - Add an additional item to the mandatory fields.
Remove button - Remove the item from the mandatory fields.
OK button - Save the information and close the form.
Cancel button - Close the form.
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.
Note - 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.
Right click the SAP form you want to manage controls for. Select the option titled Manage Control State under the APP Customizer right click menu to load the Manage Control State screen.
Warning - 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.
Warning - The customized entry on the Manage Control State screen will be overriden by any customized properties set directly on the control itself.
Item UID – The unique Item ID of the form control.
Description – The description of the form control.
Item Type – The item type of the form control.
Enable (Add Mode) checkbox – Determines if the control is enabled in Add mode.
Enable (OK Mode) checkbox – Determines if the control is enabled in OK mode.
Enable (Find Mode) checkbox – Determines if the control is enabled in Find mode.
Visible (Add Mode) checkbox – Determines if the control is visible in Add mode.
Visible (OK Mode) checkbox – Determines if the control is visible in OK mode.
Visible (Find Mode) checkbox – Determines if the control is visible in Find mode.
Users - Allows for the assignment of the control modifications to specific users, branches, or departments.
User Settings dropdown - Includes/excludes the users specified in the Users field.
User List Type - Displays User, Branch or Department based upon users specified in the Users field.
OK/Update button – Adds or updates the custom menu option
information.
Cancel button – Close the form.
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.
Coming Soon - Ability to add right
click menus.
Click the SAP menu option titled Add/Edit Menus under the Administration -Setup -APP Setup -Customizer menu to load the Menu Shortcut Maintenance screen.
Code - The unique internal ID for the custom menu option.
Menu UID - The unique Menu ID for the custom menu option.
Menu String - The caption for the custom menu option.
Image - The image associated with the custom menu option.
Note - Image should be no larger than 16 pixels by 16 pixels.
Description - The internal description for the custom menu option.
Parent Menu - Identity of the parent menu used for placement of the custom menu option.
Sub Menu - Identity of the sub menu used for placement of the custom menu option.
Position dropdown - Indicates the position of the custom menu option in relation to the parent menu.
Above
Below
Procedure dropdown - Lists all available APP Customizer procedures defined in the system.
Applicable Users - The specific user(s) to which the tab order sequence is assigned if not assigned to all users.
Exclude Selected Items checkbox - Option to designate that the specific users, branches, and/or departments listed in the Applicable Users field will be the ones excluded from application of the mandatory fields.
Activate checkbox - Indicates if the custom menu option is active.
Add/Update button - Adds or updates the custom menu option information.
Cancel button - Close the form.
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 a commonly used screen amongst customizer features to allow for this designation.
The following methods can be used to launch the User List screen…
Clicking on the
button on the **Item Properties/Events** screen.
Clicking on the
button on the **Process Rules Event Handler** screen.
Clicking on the
button on the **Tab Order Configuration Detail** screen.
Clicking on the
button on the **Mandatory Fields Configuration** **Detail** screen.
Note - To view the user information in the system, click the SAP menu option for Users under the Administration -Setup -General menus to load the Users - Setup screen.
Users Tab
Select checkbox - This checkbox is used to select a user.
User ID - The User ID value of the user from the SAP® Business One Users - Setup screen.
User Code - The User Code value from the SAP® Business One Users - Setup screen.
Branches Tab
Select checkbox - This checkbox is used to select a branch. Name - The branch name value from the SAP® Business One Branches - Setup screen.
Remarks - The branch description value from the SAP® Business One Branches - Setup screen.
Departments Tab
Select checkbox - This checkbox is used to select a department.
Name - The department name value from the SAP® Business One Departments - Setup screen.
Remarks - The department description value from the SAP® Business One Departments - Setup screen.
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
Selecting A Color Value
Click the … button next to the field that you want to specify a color for.
Select a color through one of the following means…
Select a Basic Color or a pre-defined Custom Color.
Drag the crosshairs graphic around the rainbow color chart to determine your color.
Manually enter the Red, Green, Blue (RGB) or Hue, Saturation, Luminescence values for the color.
Click the OK button.