DI000213 DI

ID of the data item which is used for the data field

DI002060 Data item

Name of the data item which is used for the data field. This name is displayed in the modules as data field heading in case there is no entry in the DF heading parameter. If there is a deviating entry in the DF heading parameter, it will be used as data field heading in the modules.

DI000984 DT

Data table from which the data item of the data field stems

DI010200 DF heading

Here, an individual heading can be defined for each data field of a data area. The entry defined here is displayed in the user view of the module instead of the name which is displayed in the data item. For buttons or context menu entries (DF behavior c... and m...), this entry is displayed instead of the module name of the module to be opened.

Notes

  • If the data field heading for a particular field is not to be displayed in an area which is no form (Layout parameter = 0 or 1), you have to enter ASCII code 0160 to generate a non-breaking space. To do so, you have to hold down the ALT key while you enter the four digits.
  • In this field, variables(@D, @G and @(System variables) can be used, the values of which are read when the module is opened.
    • Use a double @ to make sure that the variable (e.g. @D) is not read but an @ sign is actually output in the field. E.g.: @@D15 is written in the DF heading, the text @D15 is displayed in the module heading.

DI041088 DF Python ID

Identifier of a data field. It is used in connection with Python to identify the data field.

Notes

  • Names must be usable as Python literals. They must not contain blanks, umlauts, special characters, etc.
  • The DF python ID must be uniquely defined in the data area.
  • Individual Python IDs must start with an L and the license number.
    • Example: L011_request
  • This value can also be preset on the data item in the DI Python ID data field.
    • In this case, the preset Python ID and the "DI:" entry are displayed.
      • If the Python ID in the DI is, e.g., "requested_start", "DI: requested_start" is written in the DF Python ID data field.
    • The preset value can be overwritten. If this value is deleted, the preset from the data item is displayed again.
  • The Python IDs of default data fields cannot be changed.

DI000307 DF

ID of the data field

DI000203 Traffic light DI

Here, a traffic light DI is entered which serves to achieve a traffic light function (highlighting of a field depending on the stored values by the means of traffic lights).

Note

  • The traffic light symbols overwrite the symbol stored in the Symbol ID data field.

DI027481 Action ID

Here, the ID of the objects which are addressed when carrying out an action is entered.

Details

  • A listbox which offers frequently used macros as well as modules that have been changed within the last 30 days for selection is implemented on the field.

Actions can be defined for data fields with the following DF behavior:

  • c2, c4, c5
  • d2, d4, d5
  • e2, e4, e5
  • f2, f4, f5
  • g2, g4, g5
  • m4, m5

DI000111 LBMOD

Here, the ID of the listbox module is stored if you have selectedDF behavior = "li"/"le" for the data field.

Note

  • A listbox which offers the modules that have been changed within the last 30 days for selection is implemented on the field. It may, e.g., serve as input help if new listbox modules have recently been created which are to be stored as a listbox.

DI010190 Action

Name of the module, menu item, or macro entered in the Action ID field which is addressed when an action is carried out

Details

  • In the module, this name is used for buttons as well as in the context menu. It can be overwritten by making a deviating entry in the DF heading field.

DI009468 @L variable

  • Number of the list variables to be referenced The program saves the data field values of marked records in the entered list variable.
    • In the target module, @L must be entered for a data field in Filter from
  • Here, a menu item which is to be overwritten is entered for the Overwrite menu items action.

DI000288 Summarization type

Summarization type of the data field

Values

  • 0: no summarization (for DFs "Summ. type" from DI)
  • 1: sum
  • 2: maximum
  • 3: minimum
  • 4: mean (average)
  • 5: never summarize, always calculate

Notes

  • If no value is entered here, the value in the Summarization type parameter of the data item (DT412) applies to the target module.
    • If the value entered here deviates from that of the DI, the value of the DF overwrides the value of the DI.
    • Summarization type = 5 on a data item (DT412) prevents any summarization and does not allow deviating summarization types in the data field (DT411). For fields with relative values, e.g. percentage specifications, summarization basically does not make any sense. The Never summarize, always calculate summarization type on the data item provides the customizer with a means to prohibit this effectively.
  • If a summarization type is neither stored on the Summarization type parameter of the data field (DT411) nor on the parameter of the same name of the data item (DT412), the following default summarization type is used:
    • Alphanumeric: maximum
    • Numeric: sum
    • Date fields: maximum
    • The values of the checkbox fields are not summarized, the checkboxes are always displayed as deactivated
  • Due to the rounding of individual fields, an incorrect sum may be displayed since it is calculated from the exact values and displayed rounded afterwards due to formatting.

DI001706 Grid

Values

  • For histogram data fields:
    • The grid specifies the scale graduations of the histogram scale.
    • Example: When Grid = 100, the y axis of the scale is divided into steps of hundreds (100, 200, 300, etc.).
  • For time scale data fields (division of the x axis of the time scale):
    • 2: day
    • 3: week
    • 4: month
    • 5: quarter
    • 6: year

Note

  • The scale size can be customized via the Scale and Grid data fields.

DI040119 LB: value transfer

This parameter determines which data field from the listbox is transferred.

Values

  • : The data field is copied from the listbox.
  • : The data field is not copied.

Notes

  • You have to make sure that this parameter is used reasonably.
    • I.e., for listboxes on project ID fields, the LB: Value transfer parameter should be activated for the project ID, not for the name.
  • If this parameter is not activated for any data field in a listbox, nothing from the list can be copied.
  • The parameter can only be activated for one data field in the data area. If it is activated for another data field in addition, the activation is deleted for the first data field.
  • If this parameter is activated, the LB: partial string search field.

DI040815 LB: Partial string search

This parameter defines for the Listbox modules, which data fields are considered in the partial string input.

Values

  • : The data field is considered in the partial string search.
  • : The data field is not considered in the partial string search.

Details

  • If the LB: Value transfer parameter is activated for a data field, this parameter is activated automatically. It can, however, be deactivated manually.
  • In a listbox module you can also set multiple fields or no field at all for the substring search.

Example

  • This way you cannot only input the table in the listbox of the DT data field in the Data Dictionary, but also the beginning of the table name in order to filter the LB contents.

Note

  • If a listbox contains the value to be copied, a respective name, and an additional detailed description, it is recommended to only use value and name in the partial string search. If you include the explanation in the continuous text, this is likely to produce too many unintentional hits.

DI040118 Input only via listbox

If this parameter is activated, data field input is restricted to the values from the listbox.

Values

  • : Data field input is restricted to values from the listbox.
  • : Data field input is not restricted.

Note

  • If a value which is not contained in the listbox is entered in a listbox data field manually or via Drag&Drop, the input is ignored and the field remains empty. The user must repeat the input or select a valid value from the listbox.

DI001995 Window

Specifies in which of the module's sub-windows the data field will be displayed. The following division description applies to PLANTA Standard. In customized solutions, the files can be divided differently, according to customer requirements.

Details

  • Window 1: Left-hand data window
    • Identifying data (e.g. idents and names)
  • Window 2: Central data window
    • Other data (e.g. dates and durations)
  • Window 3: Right-hand data window
    • Scale fields and items displayed below a scale (e.g. bars).
  • Window 9: Invisible data window
    • Fields that are hidden when starting the module but can be unhidden by the user. They have the DF options checkbox activated.
    • Fields that are hidden in the module and cannot be unhidden by the user, but that are visible in the filter criteria. They have the Filter criteria checkbox activated and the DF options checkbox deactivated.
    • Fields that are completely invisible for users. They can neither be unhidden by the user, nor be viewed in the filter criteria. Both the DF options and Filter criteria checkboxes are deactivated.

Notes

  • If a field in a data area is moved to an invisible window (window 9), the Filter criteria and DF options parameters will be deactivated automatically.
  • If a field is to be displayed in window 1 (or window 2), you have to enter a value in the Width W2 (or Width W3) data field in the Other Module Parameters module.
    • When creating a new module in the Modules module, a width will be set for window 1 via the standard value in Width W1. It is therefore not necessary to specify a width explicitly.

DI000221 DF behavior

Here, the data field behavior is defined. Depending on the data item of the data field, the listbox on the DF behavior parameter only shows values which are possible for the data field which is currently edited.

FunctionValueSee also:Notes
Backgrounda

Action on OLE

a2: Menu item

a4: Module/Macro

a5: Module subclass

When selecting one of these values, symbol 000984 is automatically entered on the respective data field and the DF height = 40 is allocated to optimize the OLE representation.

See also: Customize Action on OLE

Password fieldb

Barba

Click on the

c2: Menu item

c4: Module/Macro

c5: Module subclass

Can only be selected with button DI 004336
Date listboxes (for date fields)cc
Overwrite Menu Item

d2: with menu item

d4: with module / with macro

Can only be selected with button DI 004336
Link

e2: Menu item

e4: Module/Macro

c5: Module subclass

See also: Customize Link

Action when double-clicking

f2: Menu item

f4: Module/Macro

f5: Module subclass



Action when pressing ENTER

g2: Menu item

g4: Module/Macro

g5: Module subclass



Hyperlinkh
See also: Embed Hyperlink

Hotkeyhk

Hyperlink for outputho

Input fieldi

i2: Checkbox - only for Y types



Listboxesli: implicit

le: explicit


Context menu

m4: Module/Macro

m5: Module subclass

Can only be selected with button DI 004336
Mark down
mi: input

mo: output



Output fieldo

o2: Checkbox - only for Y types



IronPython Scriptpy
Can only be selected with button DI 004336
Browser control data fieldwe
Can only be selected with button DI 004336
Adaptive Card Designer data fieldad
Can only be selected with button DI 004336
Application Linkal
Can only be selected with button DI 004336



Note

  • To open a method with data field behavior *5, it must have the following signature:
def my_method(self, applied_dfc, clicked_df): pass
PY

DI002926 Mandatory

Here you can define whether a data field is a mandatory data field.

Values

  • : This data field is a mandatory field. When a record is created or changed, an entry must be made in this data field. Otherwise, the changes will not be saved.
  • : This data field is no mandatory field.

Details

  • The Mandatory function can be applied to all fields that do not accept an empty value or zero, since space or zero do not count as entry.
  • Using it for checkbox fields is not reasonable since here a check only takes place for activated checkboxes.
  • Key data fields (Idents) do not have to be set to Mandatory since they are automatically mandatory entries so that, according to the data base rules, the record becomes valid.
  • The mandatory function has no effect on date data fields. It is possible to save even if such a data field is blank. However, it can be queried using another DI.

Note

  • For mandatory data fields, an * is displayed automatically behind the heading.

DI000223 Default value

Here, the respective value is entered, with which the respective data field is filled by default upon creation of a record. Here, the data area must be set to Create = .

Details

  • If the required data field is contained in a subordinate area which is set to Create = , but is to be filled with a default value when creating a parent data area, the data field must additionally be included in the creation area with its default value and possibly be set to Window = 9.

Special values

  • @/@D/@G/@U: the value of a variable (e.g. today's date or resource) is entered.

DI000220 Sort sequence

Here, the number which specifies the order by which is sorted within the respective data area is input/output. A minus sign (e.g. -1) means: sorting in descending order. If no sort sequence is defined for any of the fields, the respective data area will be sorted by the DDI of the data area.

Details

  • The sort criteria take effect when carrying out a search or when clicking on the Sort menu item.
  • Sorting only takes effect within a data area.
  • It must be specified consecutively.

DI001714 Filter from

Here you can set filter criteria by which the data of a module is filtered. Absolute values or Customizing Using Variables can be entered.

Details

  • The field can be preset by the customizer. In such a case, the data is filtered when the module is opened.
  • Or the user can fill the field himself/herself with the required value in the Filter Criteria module. In such a case, the data is filtered after clicking on the Filter or Filter additively button.

Notes

  • For virtual data fields, the value in this field is marked red and bold.
  • If no filter criteria have been preset, all data will be found when filtering.
  • If you often filter on the same data field, it is advisable to set a respective index in the database.

DI001718 Filter to

For description, see Filter from

DI040816 Regular expression

In this field, regular expressions for filtering are stored.

Note

DI056857 Use filter for

Values

  • 0: Everywhere
    • For structures, the filter is used at every level.
  • 1: Only on top level
    • Filter only takes effect at the highest level (only usable for structures)
  • 2: Not on top level
    • Filter does not take effect at the highest level (only usable for structures)

Example

  • The IT-ST resource has child resources R48 and R9.
  • In the Resource Structure module, only the IT-ST resource and the parent external resource are to be displayed (here R9).
  • For this purpose, make the following settings in the data area:
    • Filter from = IT-ST and Use filter on = 1 for the Resource (Resource ID) data field.
    • Filter from = 1E and Use filter on = 2 for the Resource type data field.
  • Result: After opening the module, only the IT-ST resource and the subordinate resource R9 are displayed.
See also: Filter

DI056858 Filter deactivated

If this parameter is activated, all entries in the Filter from, Filter to, Regular expression, and Use filter on parameters of the respective data item are ignored when filtering. In order to illustrate this, all 4 fields are highlighted in gray.

See also: Filter

DI000234 Symbol ID

ID of the symbol that is to apply to the data field

Notes

Details

  • For the data field heading, the symbol defined in the Hdg symbol ID parameter applies.

DI002031 Symbol

Preview of the data field symbol which is defined via the Symbol ID parameter

DI010197 Hdg symbol ID

ID of the data field heading symbol

Note

  • If a symbol for the data field heading is entered at data field level, it overrides a possibly existing deviating heading symbol at skin level (Heading symbol in DT030).

DI010201 Hdg symbol

Preview of the data field symbol which is defined via the Hdg symbol ID parameter

DI029731 Effect ID

ID of the data field effect

Notes

  • The effect affects the entire field content (font and background).

DI000258 Format ID

Here, the ID of a date or number format is for the data item entered/displayed.

Note

DI002076 Format

Here, a preview of the format which has been specified for the selected data field in the Format ID parameter is displayed.

DI003701 DF height

Here, the height of the data field in the selected data area is displayed/defined.

Values

  • Specified in tenths of a millimeter.

DI003703 DF width

Here, the width of the data field in the selected data area is displayed/defined.

Values

  • Specified in tenths of a millimeter.

Notes

  • If the heading or the value of the data field cannot be displayed in the set width at the surface of the respective module, the data will be truncated and displayed with an ellipsis.
  • If the cursor is positioned over the truncated data, the complete data is displayed in a tool tip.

DI027098 Hdg height

Here, the height of the data field heading in the selected data area is displayed/defined.

Values

  • Specified in tenths of a millimeter.

DI027099 Hdg width

Here, the height of the heading in the data area is displayed/defined.

Values

  • Specified in tenths of a millimeter.

DI000232 Y Pos. H

Here, the y position of the data field heading in the selected data area is displayed/defined.

Values

  • Specified in tenths of a millimeter.

Notes

  • This parameter only takes effect in data areas with Layout = 2 (form).
  • Data field headings cannot be displayed in the module without the corresponding data fields.

DI000233 X pos. H

Here, the x position of the data field heading in the selected data area is displayed/defined.

Values

  • Specified in tenths of a millimeter.

Notes

  • This parameter only takes effect in data areas with Layout = 2 (form).
  • Data field headings cannot be displayed in the module without the corresponding data fields.

DI000230 Y pos. F

Here, the y position of the data field in the selected data area is displayed/defined.

Values

  • Specified in tenths of a millimeter.

Notes

  • This parameter only takes effect in data areas with Layout = 2 (form).
  • Data fields can be displayed in the module without the corresponding data field headings.

DI000231 X pos. F

Here, the x position of the data field in the selected data area is displayed/defined.

Values

  • Specified in tenths of a millimeter.

Notes

  • This parameter only takes effect in data areas with Layout = 2 (form).
  • Data fields can be displayed in the module without the corresponding data field headings.

DI022738 Alignment

Defines the alignment of the data field.

Values

  • 0: No alignment
  • 1: Left aligned
  • 2: Centered
  • 3: Right aligned

Notes

  • Checkboxes are always centered, regardless of the alignment.
  • Number fields are right-aligned and text fields are left-aligned by default.

DI001992 Pos.

Automatically incrementing number. When moving via Drag&Drop moving and creating a data field, the pos. is set automatically. In modules in which data fields are created, this field should be included in window 9 as the first order criterion.

Note

  • The position is the tab order of the data fields at the same time.

DI040869 Hotkey

The entered value defines a shortcut for activating the corresponding button.

Example:

  • Value: A
  • In the module, the respective button can be activated via the ALT + A key combination.

DI040918 Tooltip

Here, an individual tooltip can be stored. It is displayed if you move the cursor over the corresponding field in the target module. The following external variables can be used

Field TypeVariablesNotes/examples
Regular data fields@uid - DF ID of the data fields
@content - Content of the data field is displayed.

Bar@startDateH(date format) - start date of the bar is output
@endDateH(date format) - end date of the bar is output
@duration - number of days between start and end date is output.
@wdDuration - number of days between start and end date, excluding weekends and holidays, is output
@ds, @de - start date/end date
@ms, @me - start month/end month
@qs, @qe - start quarter/end quarter
@ws, @we - start week/end week
@ys, @ye - start year/end year of the histogram bar
@wys and @wye - start year/end year of the calendar week
Note:
Histograms@value - value of the histogram bar on which the cursor is placed (e.g. bars for projects with code B)
@v_sum - sum of the values for the bars of a group (of a type) (e.g. bars for projects A-E)
@hdg - name of the histogram (=DI name of the SUBDI)
@ds, @de - start day/end day
@ms, @me - start month/end month
@qs, @qe - start quarter / end quarter
@ws, @we - start week/end week
@ys, @ye - start year/end year of the histogram bar
@wys and @wye - start year/end year of the calendar week

Example

Entry in the customizer
Output at the surface
Start: @startDateH(dd.MM.yy)

End @endDateH(dd.MM.yy)

Duration: @wdDuration days


Start: 07/01/2009

End 07/15/2009

Duration: 10 days

Information

  • The field is an I-text and is displayed in the translation modules.

DI003388 DF options

This parameter serves to determine whether data fields in the context menu for hiding/unhiding of data fields can be hidden/unhidden.

Values

  • : The data field can be displayed or hidden.
  • : The data field cannot be displayed or hidden.

Note

  • If a field in a data area is moved to an invisible window (window 9), the DF options parameter is deactivated automatically.

DI059179 Bar modification mode: Create bar

Activating this checkbox enables the graphical creation of bars. It is recommended to only set one date type to "creation" (e.g. actual dates or required dates).

DI059181 Bar modification mode: edit dates: "Actual" menu item

Activating the checkbox enables

  • graphical editing of dates of the respective bar with Edit → Task actual start and Edit → Task actual end.
  • scrolling to actual dates via the View → Bar tracking menu items.

DI059180 Bar modification mode: edit dates: "Requested" menu item

Activating the checkbox enables

  • graphical editing of dates of the respective bar with Edit → Task requested start and Edit → Task requested end.
  • scrolling to requested dates via the View → Bar tracking menu items.

Activating this checkbox enables you to graphically link the bar, change the link type by right-clicking, and delete the link in the Gantt chart.

Requirements

  • In the link area, a Linkage DI is available for the bar you wish to link.

DI059183 Bar modification: edit start

Activating this checkbox enables the graphical editing of start dates.

DI059184 Bar modification: edit end

Activating this checkbox enables the graphical editing of end dates.

DI059268 Bar modification: Move

Activating this checkbox enables the graphical moving of bars.

DI059185 Bar modification: All modifiable

Activating this checkbox enables the graphical moving of a bar, as well as the editing of start and end dates.

Note

DI051832 Bar link (DF Python ID)

By entering the DF Python ID of a bar, this data field becomes an auxiliary bar field. It is displayed at the position defined in the Docking point parameter. Note

  • The auxiliary bar field must be located in the same field as the respective bar.

DI040921 Bar link (DF ID)

By entering the DF ID of a bar, this data field becomes an auxiliary bar field. It is displayed at the position defined in the Docking point parameter. Note

  • The auxiliary bar field must be located in the same field as the respective bar.

DI040917 Dock point

This parameter serves to determine the position of the auxiliary bar field defined in the Bar link (DF Python ID) data field.

Values

  • 0: Start date is beginning of bar
  • 1: Start date is end of bar
  • 2: Start date is center of bar

Tip

  • When you use "0” as a value for positioning an auxiliary field infront of the bar, the data field width and the X position of the field should be defined in addition (e.g. DF width = 200, X pos. F = -200), so that the field is not positioned at the bar itself.

DI026689 Multiline

This parameter controls whether line breaks are possible in the respective data field.

Values

  • : By pressing ENTER, a line break is inserted. If the DF width is reached, an automatic line break occurs.
  • : By pressing ENTER, you navigate to the next input field. If the DF width is reached, the data is displayed truncated with an ellipsis. If the cursor is positioned over the truncated data, the complete data is displayed in a tool tip.

DI027601 No. of lines

For data fields for which the Multiline parameter is activated you can use this parameter to define how many lines may be written in this data field.

Notes

  • If the maximum number of lines is reached, no other manual line breaks or no other text can be entered, if this causes an automatic line break. In such a case, the The maximum amount of lines in the continuous text field has been reached. message is displayed.
  • The corresponding data field is hidden by default but the user can unhide it if required.
  • Values from 0 to 9999 can be entered.

DI001993 Filter criteria

This parameter defines whether the data field is displayed in the Filter Criteria.

Values

  • : The data field is available as a search criterion in the options form.
  • : The data field is not available as a search criterion in the options form. However, an entry in the Filter from or Filter to takes effect regardless.

Notes

  • If a field in a data area is moved to an invisible window (window 9), the Filter criteria parameter is deactivated automatically.
  • Can be used for filter criteria which the user can neither see nor change.
  • Can be used for data fields which cannot be searched for, e.g.: date/histogram bars, projected/summarized values.
  • Especially in multi-user mode, large sequential search runs can cause computer overload. Hence, especially where mass data is affected, we recommend to restrict the filter criteria visible to the user.

DI029687 DF output

Preview of the data field heading as displayed in the module

DI003102 DF type

The field is automatically filled with the value from the (DF type) field of DT412.

DI040844 Incarnation DI

The field is automatically filled with the value from the (Incarnation DI) field of DT412.

DI040843 Fetch exit DI

The field is automatically filled with the value from the (Fetch exit DI) field of DT412.

DI040845 DI class

Here, the class of the hyperlink is displayed.

DI041524 Listbox module

Here, the title of the listbox module stored in the LBMOD data field is displayed.

DI041308 DBOLE value

Here, the ID of the OLE object which is used on the data field is displayed. The field is automatically filled as soon as an OLE entry has been made in the Default value field. For more information, please refer to the Embed OLEs section of Module Workflow Level 1.

DI040904 IronPython script

On this parameter you can store IronPython scripts that are carried out on the client. Via these scripts, a value range can be customized on part of the client.

Notes

  • In order to run !IronPython scripts on the client, the DF behavior must be set to py.

DI040968 Data field configuration

On this parameter you can store configuration parameters for data fields.

Usage

DI056920 Print text

Here, an individual print output text or variables for print output objects can be defined for a print area.

Possible variables:

  • @mod_name - module name
  • @cur_column - current column
  • @cur_row - current row
  • @cur_page_h - current page (horizontal counting)
    • 1,2,3
    • 4,5,6
  • @cur_page_v - current page (vertical counting)
    • 1,3,5
    • 2,4,6
  • @total_pages - page number
  • @date_time(F) - time specific for the print preview
  • @date_time(h:mm:ss) - time specification
  • @date_time(dd.MM.yy HH:mm:ss) - time for the print preview
    • In these variables, only standard format strings can be used. For further information, please see here.

DI041307 DBOLE

Preview of the OLE object which has been assigned to the data field

DI000106 Structure summarization

Summarizes data fields in data areas with Structure display = along the structure (e.g. planned load along the project structure)

DI062619 Active

Marks the data field as active or inactive depending on whether the respective data item is active or inactive

Note

  • If you try to assign an inactive data item to a data area as a data field, a message indicating this is displayed.

DI066279 Active chart variant

Defines which chart variant is to be displayed if there are multiple chart configurations for a data field.

The parameter can be edited in the following module by users with modification rights: