Article Details
Id:20621
Product:finPOWER Connect
Type:FIX
Version:4.00.03
Opened:22/08/2023
Closed:24/08/2023
Released:27/09/2023
Job: J031852
High Importance

HTML Widgets; widget.UI.AddressDetails Control; "Show" Properties enhanced

The various Show options on the Address Details HTML Widget control have been enhanced, as the previous implementation could result in data being lost if a particular field was being hidden using these options.

If editing a saved address, and any value being hidden by the below properties would be lost if a value was present, but being hidden. This issue was not present if adding a new address.

For example, if a Client Address had Instructions, but the Address Details control was configured as showInstructions: false, then when the control updated the Client Address, it would be saved without the existing instructions, which was incorrect behaviour.

New Functionality

Now, if any of the Show properties are false, but there is data for the hidden field(s), the field will be displayed as read only. That way the User will know that data is present, but they are not allowed to change it. This will also ensure that when the record is saved again, the field won't lose its data.

If the field is not allowed and there is no data associated with it, then it will be hidden completely as it was before.

The options and properties affected by this change are:

C.adAddress = widget.UI.AddressDetails("adAddress", {
  showDeliveryType: false,
  showPostalId: false,
  showPropertyName: false,
  showInstructions: false,
  showCountry: false,
  showCity: false,
});

These properties can also be updated after the control has been initialised using the following functions:

C.adAddress.ShowDeliveryType(value);
C.adAddress.ShowPostalId(value);
C.adAddress.ShowPropertyName(value);
C.adAddress.ShowInstructions(value);
C.adAddress.ShowCountry(value);
C.adAddress.ShowCity(value);