Entering Information in a Form

How are dates entered?
How are numbers entered?
How are values from a list selected?
How is input by string used?
What is “marking unfilled”?

Information is entered using special controls, such as input fields, checkboxes, buttons, links, etc.

See also:

Controls (ordinary application)

Controls (managed application)

Date entry

Depending on settings, a date can be entered in the following formats:

  • DD.MM.YY – day of month, number of month, and two last digits of the year number;

  • DD.MM.YYYY – day of month, number of month, and number of year.

A date can also include time in the format HH:MM:SS (hours, minutes, and seconds).

You don't need to enter separating dots and colons as they are always present in the Date input field.

You can specify dates using the following methods:

  • Using the calendar: press the selection button (F4 key);

  • Using spin button: the value is changed selectively (day, month or year) by pointing to the required date component.

If you enter partial date and press Enter or switch to another control, the value is automatically completed based on the current date.

In the managed forms, if you edit date in an input field (by typing directly in the field or by selecting it from the calendar) using "Date+Time" representation, but the format string restricts the display to date only or date with partial time, hidden part of the time value is not cleared – it remains the same as before editing; only the part of time specified in the format string is cleared. Here editing in the input field means entering a new full date that completely replaces the previous value. If an input field box displays both date and time and you only change, for example, the digit of thy day of the month number, time is not cleared.

If invalid data is entered into input field of a managed form and a control is switched or a form is closed, a message will be displayed that will contain the text "Incorrect data entered into field" and the "OK" button. Clicking "OK" will return the user to editing such incorrect data.

Entering numbers

Numeric values can be entered manually or using the application's built-in calculator. The calculator can be opened by pressing the button located in a field or the F4 key.

Fractional part, if any, of the attribute being entered may be typed after a comma or period, which cause switching to the fractional part entry.

To make the number negative (if the attribute you are entering can take negative values), press the "-" key. To make a negative number positive, press the same key (-).

The negative numbers are automatically highlighted by red color.

In some cases you enter numerical values using special controls placed in forms. There can be spin control associated with a numerical attribute or the adjustment button placed in the text box.

If invalid data is entered into input field of a managed form and a control is switched or a form is closed, a message will be displayed that will contain the text "Incorrect data entered into field" and the "OK" button. Clicking "OK" will return the user to editing such incorrect data.

Selecting a Value from a List

A list of values can be opened in a separate form (document list, report list, etc.) using selection button, or in a dropdown list.

There are several options available to select a required value from a separate form: double-clicking it, pressing Enter or using a form selection button (most frequently Add button; for details, see the configuration description).

To clear the value selected from the list, use the clear button in this field (if available) or press Shift+F4.

When a reference value is selected in the text box, and the selected object is marked for deletion, appropriate message is displayed to the user. You can confirm your selection of the marked object (which will result in actual selection), or decline which will keep the selection form open to enter another value.

Input by String

Another way to enter data is to type the required value directly into the input field. You have to enter an item code or name for the catalog, chart of characteristic types, chart of calculation types and chart of accounts, enter representation for enumeration, and enter document number for document. You may also use other attributes defined during configuration development of the object being edited in the input field.

System behavior varies depending on the application run mode (managed or ordinary) and form type (in the managed application run mode).

Input by string in the ordinary application run mode

If you enter text that identifies the required object unambiguously (the text can be incomplete), the application displays the remaining part of this object's attribute you are typing. If you move to another control at that moment or press the Enter key, the application fills the input field with the found value (reference).

If the text you have typed is incomplete and there are multiple objects that match this text, when you move to another control or press the Enter key, the application composes a list of these objects and displays it as a drop-down list for you to select from. If the list is longer than 50 items, the application will display the warning: "More than 50 items found! Please, provide a more specific string or use the selection button." If no objects match the specified text, the application displays warning: "Incorrect data entered in the control. Do you wish to continue?" If you select No, you can continue to enter data in this input field. If you select Yes, you will move to the next control. In this case the attribute value remains indefinite when you save the form.

If the text you have typed is complete but there are several objects that match it, the application also composes a list of these objects and displays it as a drop-down menu for you to select from.

If there are multiple fields defined during configuration of the input field to be used for searching, the found values are displayed in the list in the order specified during configuration development. If there are several values with the same representation found in an object when searching by multiple fields (for example, the nomenclature code is 20001 and its article is also 20001), this object will appear in the list only once.

You cannot enter text for attributes of undefined types (for example, of the compound type) unless you specify a specific data type.

Input by string in the managed application run mode

If the form was created as an Ordinary form, system behavior for input by string will be similar to that in the Ordinary application run mode.

If it is a Managed form, system behavior for input by string in this form is as follows:

When you finish entering text and make a pause, the system receives a selection list. Automatic selection in managed form input fields will be initiated during any editing attempt of a text contained in these fields. The list will be opened only if multiple values are found or if a string value is edited in the input field. At that the list is available for selection simultaneously with the string entry. If a non-string type is edited in the text box and the list only includes one value, it is immediately filled in the text box. If multiple values exist, the list is opened with its first item highlighted. Contrary to the Ordinary application run mode, strings are not completed automatically.

If a value is filled in an input field by input by string (irrespective of availability of a list and the number of items in such a list), the user will not be taken to the next field if the Tab or Shift+Tab keys were not used while other keys (Enter, Down, …) or timeout were used to initiate input by string or selection from an input by string list.
Ctrl+Enter keyboard shortcut acts in an input field in the same manner as Enter to process input by string operations (switching to an opened list, selection from the list).

If you change text in an input field and finish entering (by navigating to another field, pressing Enter, Tab, or Shift+Tab; at that using Enter for navigation unlike Tab or Shift+Tab operates by skipping the field marked for "Skip upon entry" or when Tab or Shift+Tab is pressed in the selection list – in other situations no navigation to the next form element will be executed), then, for a single-value list, this value is filled in the input field while for multi-value list the list opens for modal selection. At that the first item in the list is activated.

If you finish entering text and the list contains more than 50 items, appropriate warning is issued.

If the list is opened, you can select the required value whenever you want.

If a dropdown list is opened, clicking left and right arrows will be transferred to the managed input field.

If the specified text cannot be found, a respective dialog will be displayed prompting you to select one of the following options:

  • Select from List – a value should be selected from a list. This button is only available in the dialog if a value can be added from a list for the edited data type;
  • Continue entry – keep editing the text in the text box;
  • Cancel entry – return to the value previously available in the managed field.

In the web client it is not allowed to enter symbols that are not XML compatible. If a special character is entered into a text box by software, in the Chrome and Safari web browsers it will be replaced with ‘?' character and this text box will not be available for editing.

Marking Unfilled

Certain fields in a form may be required for filling. If any such field is not filled, a thin red dotted line is displayed in it. When the form is closed a message about unfilled fields in normally displayed. If data is entered, the line is not displayed.

In a table, unfilled entries are marked as follows:

  • If the table has no rows, only the first row is highlighted;
  • If the table is non-empty, all its rows are highlighted with red color.

 

See also: 

Using the Mouse 

Using Keyboard Shortcuts

1C:Enterprise Developer's Community