Item Placement Tool

PATH: Administration > Add-Ons > B1 Usability Package > Module configuration > Beas usability extension >"New Edit Item" button.

Configurations of window layout can be changed by using the Item Placement Tool

The Edit Item Placement Tool configuration window consists of three main sections:
Top section: Serves as a definition of the environment.
Bottom left section: Lists the changed fields of the given window.
Right window section: Editable properties of the fields listed on the left.

Edit_Item_placement

Window sys_itemreplacement_edit.psr

See Overview

The Item Placement Tool can be accessed in the following ways:

- Ctrl + double-click on a field which should be edited.

- Right-click, select the tab with the beas Usability Package Icon "Setup Overview". This will display all available Item Placement Tool configurations.

Choose the Item Placement Tool configuration you would like to work on by double-clicking on the line, or by highlighting the line and clicking on the edit button.

edititemplacementtoolopen

The window to be edited should not be closed while being edited in the Item Placement Tool.

The field to be edited is marked with a "frame" and is highlighted in the Item Placement Tool (line 4 in this example) and the details of this field are displayed to the right of it.

The window to be edited is displayed with a yellow background which indicates that it is in "edit mode" (See image above)

If a setting is changed in the Item Placement Tool this is immediately visible in the original window. Unfortunately, an automatic preview is not possible. To create the correct result, click "Refresh window". In the original window the default color is displayed and can be edited and checked normally.

When clicking on the Item Placement Tool window, it will automatically come into focus and the original window automatically returns to "edit mode".

Move Field

Change the mode to "edit mode" (yellow background) in order to move a field.

Click on the corresponding field and hold the left mouse button.

Drag the field to the desired position while holding down the left mouse key. If the field is to be positioned below an already existing field, simply drag the field into the existing field and it will automatically be positioned below. You can add and edit an extensive list of properties of a given field in the right window section of the Item placement configuration window.

User Defined Fields (UDF)

Unlike in SAP Business One it is not possible to define one's own UDF's in Beas. However, in most windows UDF1 to UDF4 of the type: "string" are available, furthermore also UDF5 to UDF15 e.g. in Bill of Materials, work plan, article version, and many others.

Special feature UDF1 .. UDF4

These are defined in the setup wizard and are immediately active and correctly positioned in all corresponding windows.

UDF1-4 are area-related and not window-related e.g. Routing Position: These are relevant for "Routing Catalog", "Routing" (List and edit window), Work order routing plan (List and edit window), as well as Precalculation. Formatting and definition of further properties is done directly via the setup wizard and also stored in the setup wizard. Definition of user dependencies is not possible.

Example: Configuration Wizard > Bill of Materials > Definition UDF1–4

udf1-4

Utilization UDF 5–15

If UDF 5 to UDF 15 are available in a window, they can be added via the Item Placement Tool.

These are always of the type "String" but their properties can always be changed in the field "Format" to the types Decimal or Date. However, they are always saved as a string.

A UDF is added in the following way:

1. Click on "Line Add"

2. Select the corresponding UDF from the field "Element". This can be named UDF5 or <tablename>_UDF5, e.g. BEAS_STL_HEADER_UDF5

3. Select Type "Column"

4. Select "Title" and "Format"

5. Click on "Rebuild"

6. The field is now at the top left. It can now be moved with the mouse to the correct position

7. Define and save other properties

Using template fields

In some windows Templatefield1 .... Templatefieldx are available. These sometimes have different lengths and types. These fields are not linked to the database and can be used for a wide variety of purposes.

They can be integrated in the same way as UDF fields.

However, loading and saving must be defined individually. This can be done via Validation Configuration – Event: select "Form Load" / "Form Add" / "Form Updated" from the drop-down.

User-Dependent Definition

There can be more than one configuration, e.g. user-dependent go to: User

All configurations that fall under the user rule and are active are always considered here.

If more than one definition exist, they must be opened via Right-click – beas Usability Package – Integration Icon – Setup Overview. Here more definitions can be made or existing ones can be changed.

Beas_Usability_Ext
Window sys_trigger_browse.psr

A configuration is linked to a window. You can define more than one configuration for a window. A definition can be e.g. user-dependent.

•	B1UP license is required.

•	Only Beas windows can be changed. Beas windows can always be recognized by the Beas logo in the bottom right corner.

•	The UDF fields 1–4 cannot be changed here.

•	Windows of the type "List" or "Structure" cannot be customized .

Routing_all_itemplacement

Field descriptions of the Edit item Placement Tool

Header:

Field

Description

Unique ID for the Configuration – Definition.

If an ID is not set manually the system assigns one automatically.

Window ID

ID of the window for which the defined changes should apply.

Tip: The window specified here must be open in order to change its properties.

Description

Text field where the configuration can be described in further detail.

Active

The configuration is only considered if the field is active.

User (empty = All)

You can indicate the validity of the definition / users in the Item Placement Tool, function buttons, and validation configuration.

The following rule applies:

Field is empty: There is no check

Incl. User: The definition is only valid for the specified users

Excl. User: The definition applies to all users except for the users specified here

A user can be:

- SAP User

- SAP user group

- Personnel (Menu: Human Resources > Personnel)

In the selection window the corresponding user can be defined and taken over by the ("transfer button")

User_personnel
Window bde_personal_browse.psr

Category

Defines the category. Configuration groups can also be defined here.

Field Description for further properties

Field

Available for

Description

Info

All

Optional information or remarks.

Data Window

All

DataWindow where the field is located (dw_1 .. dw_7).

Element

All

If you want to create a new field (Bitmap/Text field, Computer field), you can define an own id.

It is not possible to create a new id for an input field.
You must choose an existing field.

If the field is visible, you can change it, but you cannot insert a field 2 times.

You have access to all fields, which were defined in the formula – defined in "DataWindow"

Special fields:

Field

Description

udf1 ... udf4
(or [table_name]_udf1 ..
[table_name].udf4)

You can define these fields in the Configuration Wizard

or with Ctrl + Double-Click on this field.

If you want to move this field or if you want to define additional information which you cannot define in the Configuration wizard, it is possible to make changes here.

udf1..4 loaded and saved automatically in database.

All fields from type varchar(50).
If you need another dataformat, change this in "Format", but all data are saved as string.

udf5..udf15

(or [table_name]_udf5 ..
[table_name].udf15)

In lots of windows there is access to udf5 ... udf15 and it is possible to insert this field with this item placement tool function in the window.

Use these fields if you need additional columns in your window.

udf5..15 loaded and saved automatically in the database

All fields from type varchar(50)
If you need another dataformat, change this in "Format", but all data are saved as string.

userfield1 ... userfieldxx

In a lot of windows userfield1 ... userfieldxx are available

All fields from type varchar(50) or in some windows another length.

If you need another dataformat, change this in "Format", but all data are saved as string.

Beas does not load or save the value from the database. These fields are always empty if you open a window. You can define the source and the update function itself with a small script.

Type

All

Field type: Text Field, Input Field (Column), Form Field (Compute), Picture (Bitmap), or Button.

Title

Column

Column:

Field description, displayed to the left of the field. For this purpose, a second field is generated with the ID of the element "_t", e.g. "UDF" field gets a title field (Text field) "UDF_t".

This text field gets the text that has been entered here.

fieldname

Text:

Text that should be displayed.

Compute:

The formula from which the result should be displayed. DataWindow Style.

Button:

Button text.

Font Size

All

Defines the font size: very small – small – normal – large – very large.

Font Format

All

Defines font format: normal, bold, italic, bold and italic

Read Only

Column

When active, the input field cannot be edited.

Hide

All

When active, the field is no longer visible. If it is a field of the type "Column", the associated text and bitmap fields are also made invisible. The following fields are affected by this:

Title: fieldname + "_t"

Arrow: fieldname + "_pp"

Dropdown Icon: fieldname+"_ppp"

Mandatory Field

Column

If active, an entry in this field is mandatory. Otherwise, any kind of change or addition is blocked.

Focus ALT +

Column

If a letter has been saved, the field can be accessed directly via: "ALT" + the given letter (Hotkey).

Tooltip

All

If a text is specified here, it is displayed as a tooltip in this field.

Bitmap

Icon to be displayed.

Format

Column, Compute

Note:

For the type "Column" this has an effect on the content check which can be specified during the validation.

In numeric format, the alignment is automatically set to the right.

Alignment

Column, Compute, Text, Button

Determines the alignment of the text or the content: Left, Right, or Centered.

TAB Sequence

Column

Determines the TAB order.

V Scrollbar

Column

Enables vertical scroll, automatically scrolls down to the next line if the end of the line is reached by the cursor.

H Scrollbar

Column

Enables horizontal scroll; if the cursor reaches the right side of the column, the text will automatically be shifted to the right and the additional letters can be added.

Color

All

Determines the color of the field.

Background

Text, Column, Compute

Determines the background of the field.

Error Color

Column

Determines the background of the field if the content contains errors.

Empty Color

Column

Determines the background of the field when the field is empty and when an input is mandatory.

Tab Object

All

Determines the name of the TAB Object .

Here you can select the tab object in which the field should be located. If the field is moved to a tab area using drag & drop the field are filled automatically.

TAB tab

All

Determines the name of the TAB tab of the tab object selected in "Tab object".
This can either be selected or set automatically if a field is inserted using drag & drop.

Position x/y

All

Define the X-/Y - Position from the field in PBUnit.

0 Point is the left/top position of the current formular (dw_1, dw_2..).

or if the field inside a tab, then 0 position is left/top position from the tab object.

PBUnit: Is a Formular own unit. The size of one Unit is related to the current Zoom factor and default Font size.

Length, Height

All

Defines the length and height of the field in PBUnit. Default Height is always 60.

PBUnit: Is a Formular own unit. The size of one Unit is related to the current Zoom factor and default Font size.

If a drop-down is inserted or the field is moved below another field with a drop-down, it may occur that the field length was not determined correctly.

By using the arrows, the field length can be increased or decreased to match the length of the drop-down.

width_correction

Text Distance

Column

Determines the distance between the text field and the input field (Column).

This is automatically set if the field is moved using drag & drop. It is also possible to set the value manually.

The default value of 200px is used, when there is no manual value set for this parameter. If this is changed to a low value, the text might not be visible, due to the field overlapping the text.

This is only considered if there is no position specified for for the text field separately.

textdistance

Rotation

All

Input is in 1/10th of a degree°, e.g.450 = 45°. Caution: The text will be changed. For input fields, the display is rotated but the input is still displayed in 0°.

Example: Rotation 90°, red background with white text.

rotation

Dropdown

Column

For details click Go to: Drop-down.

dropdown_def_02

Golden Arrow

Column

If a script has been stored, a golden arrow will be displayed to the left of the input field. If the golden arrow is clicked, the script stored here will be executed.

Click

All

A script can be saved here. It will be executed when clicking on the field.

Validation Type

Value

Column

item_valididation

The check of a field can be activated directly here.

The following checks are possible:

no Check	No check takes place.
between	The value must be between two values. Value 1 represents the lower value and value 2 represents the upper value. Therefore, the input value must be greater than 1 and smaller than 2.
smaller	Content must be smaller than the specified value.
bigger	Content must be bigger than the specified value.
contains	A list of values is displayed. Comma is used as a separator. Example: red,blue,yellow In this case, only one of these 3 values is allowed.
SQL Script	The check is performed via a SQL statement. Information can be specified via the placeholder <dw_1.item.fieldname.value>. Return: -1 = Input is faulty. Return: 1 = Input is correct. If the SQL statement returns anything other than -1, the input is also considered to be correct.
beas script	A Beas script will be executed. If the script ends with "return failure", the input is incorrect. If the script ends with "return success" the input is correct.

The check depends on the specified format.

String

A string check takes place. Here the following rules apply:

A < B

A1 < A2

1 < 9

1000 < 90, since the input is always checked character by character and no numeric check is performed.

If the field is of the type "Date" it is converted into the format yyyy/mm/dd e.g. 2018/05/30

Numeric

There is a numerical comparison with 6 decimal places.

If the field is a date field, the date is converted to numeric format e.g. 2018/05/30 is converted to 20180530

Datum

A comparison of dates takes place.

The input of the the values to compare must be inserted in the format yyyy/mm/dd e.g. 2018/05/30

If the field is of the type "String", it will be converted to a date type Datumstyp

If the field is of the type "Numeric" comparison is not possible.

If the field is a different type than the specified format, it will be converted to the appropriate format

Example field type = String, Format = Date

The content is automatically converted to yyyy/mm/dd. If it is empty it will be set to 1900/01/01

Script

Column

If beas script or SQL script is selected in the validation, then the respective script can be defined here.

Error Message

Column

Defines the message which should appear in case of an error .

Timing

Column

Immediately: A check is made as soon as the field has been changed and when saving / adding .

Save: A check is only made when clicking Save or Add.

If there is a dependency on other fields, it is recommended to use the type "Save".

Help URL: https://help.beascloud.com/beas202102/index.html?itemplacementtool.htm