ManagedForm.RefreshDataRepresentation

Syntax:

RefreshDataRepresentation(<UpdateItems>)

Parameters:

<UpdateItems> (optional)

Type: FormGroup; FormTable; FormField; Array.
If a parameter is specified, setting of values (and their update) will be executed only for the items specified in the parameter. If an empty array is transferred as a value, no value setting will be performed for any form items.
After calling the method, indication of need to set and update values for the form items is reset: if after calling the method, no form data changes, the text will not be updated for any items except specified ones.
If the parameter has value of type Array, only values of type FormGroup, FormTable, FormField can be array items.
If array contains value of other type, an exception about an invalid type of parameter is generated.
Call for the method RefreshDataRepresentation with the parameter <UpdateItems> is ony reasonable inside the handler ExternalEvent, form timeout handlers and handler NotificationProcessing.
In other event handlers call for this method with the parameter is similar to call for the method without it (data will be set to all control items if needed).

Description:

Enforces refreshing of the form control values.
Is useful for changing the form attribute values outside the form while the form is rendered on the screen.

Availability:

Thin client, web-client, thick client, Mobile application (client).

Note:

In a web-client controls are not refreshed at once, but are refreshed after script is finished executing.

    

1C:Enterprise Developer's Community