Creating grouped link lists

The following describes how you can create an element. To see which functions are available when creating an element, see the section on Functions.

Procedure

Activate the App Designer in the Administration app
In the app of your choice, open a data record in read- or edit mode.
Click Customize in the toolbar of the App Designer.
When you are at the location at which you wish to insert a new element, click the respective button to insert the new element, for example, Extend z-layout.
Select Grouped link list.
The element is inserted. If necessary, you can move the element to another position.

Functions

Heading

The following options are available to change a static header or title.

Function	Description
	With this button, you remove the current header.
	With this button, you select a header. In the list, you can find all texts available for the open app.
	With this button, you change the text of the header. Note This text may appear in different locations. If you edit the text, it will be changed in all locations. System texts cannot be edited.
	Using this button, you can enter a new text. The Key (ID) field is completed automatically and you do not have to change it. You can enter the text in any of the languages which are available in SmartWe.

Data record type

Select the Data record type, for example, tasks.

Query parameters

In the Query parameters area, you can define extensive settings. With these settings, you influence which data is displayed.

Function	Description
Restricting link types	You can restrict which link types are displayed, so that only the specific link types you want are displayed. The field is then only selectable if link types are available for the data record type which has been set.
Restricting roles	To further restrict the displayed links, you can select the role of your choice. You can only select the field if you have selected one link type in the Restrict link types field. If you have selected several or no link types, then the Restrict role field is deactivated.

Query parameters: Adjust filter

With the Adjust filter function, you can define comprehensive filter settings.

Note

Certain filter conditions cannot be applied if a mobile app is used in offline mode. This includes the link conditions, complex queries in expert mode, and all date jokers excluding: current week, current week+?, current week-?, yesterday, yesterday+?, yesterday-?, today, today+?, today-?, tomorrow, tomorrow +? and tomorrow-?.

The adjustments are available in two modes, the Standard mode and the Expert mode.

Function	Description
Default mode	If you click the Adjust filter button, you open the default mode. In the default mode, you can define the same settings as in a view filter. SmartWe Online Help: Filter
Expert mode	You select the expert mode via the button. In the expert mode, you can define your filter conditions via a code. For the filter criteria, you use the field names as defined in the Data record types area. Possible relational operators: =, !=, <, >, <=, and >= You can create chains of operators by using: and or or. You can compare all fields with the following data types: string, boolean, decimal, and int. Example You would like to filter all tasks which have a value entered in the Priority field and which have not yet been completed. To do so, enter the following code: Copy PRIORITY != '' and WORKINGPERCENT < 100 For the Linked data records data source, you can add target to the field name: Copy target.PRIORITY != '' and target.WORKINGPERCENT < 100

Function

Description

Default mode

If you click the Adjust filter button, you open the default mode.

In the default mode, you can define the same settings as in a view filter.

SmartWe Online Help: Filter

Expert mode

You select the expert mode via the button.

In the expert mode, you can define your filter conditions via a code.

For the filter criteria, you use the field names as defined in the Data record types area.
Possible relational operators: =, !=, <, >, <=, and >=
You can create chains of operators by using: and or or.
You can compare all fields with the following data types: string, boolean, decimal, and int.

Example

You would like to filter all tasks which have a value entered in the Priority field and which have not yet been completed. To do so, enter the following code:

Copy

PRIORITY != '' and WORKINGPERCENT < 100

For the Linked data records data source, you can add target to the field name:

Copy

target.PRIORITY != '' and target.WORKINGPERCENT < 100

Sorting

In the Sorting area, you can set the fields you wish to use to sort the displayed data records by.

Function	Description
	Select the field by which you want to sort the list.
	Select whether you want to sort by ascending or descending order.
	If you wish to sort by other fields, then click Add sort criterion. For each sort field which has been inserted, you can decide whether the sorting should be ascending or descending.

Display

In the Display area, you define which information is displayed for data records.

Option/Field	Description
Standard	Default means that the settings of the linked data record are adopted. You can define this default settings via the Display options for data record types menu entry in the view menu of the App Designer toolbar. Display options for data record types Deactivate the Default option if you want to define custom settings for the element.
1. row	The value in the 1. row is displayed in large font and as a rule contains essential information on the data record, for example, the Keyword for a task. Note SmartWePremium After clicking this button you can enter a script. Scripting in the App Designer
2. row	The value in the 2. row is displayed in a smaller font and contains additional information on the data record, for example, the Editor of a task. Note SmartWePremium After clicking this button you can enter a script. Scripting in the App Designer