IJ23895: UI MULTILINETEXTBOX - HIDELABEL CONFLICTS WITH REQUIRED WHEN LABELS ARE VERTICAL

APAR status

• Closed as program error.

Error description

• ERROR DESCRIPTION:
  UI MultiLineTextBox - HideLabel Conflicts With Required When
  Labels Are Vertical
  
  PROBLEM:
  Maximo has long provided a hidelabel property in the
  Presentation XML files to suppress field labels in certain
  conditions. That provides developers flexibility to use
  StaticText, Section Labels, or other techniques to avoid
  redundant labels and provide a better experience for users in
  certain complex applications.
  
  Maximo 7.6 introduced the option of having Field Labels
  displayed above the Field Values rather than to the left of the
  Field Values. In most cases, when the Field Labels are on top
  (Vertical) the Field Value appears where the Label would have
  appeared. But if the field happens to be Required, then an
  asterisk appears where the Label would have appeared and the
  Field Value gets pushed down. In certain cases, that defeats
  the purpose of having set hidelabel="true".
  
  For most fields, an acceptable workaround for this issue is to
  add labellayout="horizontal" to the field tag or to the
  section, sectioncol, or other container tag. This overrides the
  global setting for the mxe.webclient.verticalLabels System
  Property and causes the asterisk to appear to the left of the
  Field Value (e.g. - Textbox, MultiPartTextBox) instead of above
  it. However, the labellayout property does not seem to work for
  MultiLineTextBoxes.
  
  Ideally, the UI logic should recognize that if hidelabel="true"
  and the field is required, the asterisk should display on the
  same line and to the left of the Field Value. Alternatively,
  support for the labellayout property should be added to the
  multilinetextbox control so we can at least set it manually
  when needed.
  
  The orange asterisk for required fields should remain to the
  left of fields when using labellayout="horizontal" to the field
  tag even if mxe.webclient.verticalLabels System Property was
  set to 1, but it does not seem to work for MultiLineTextBoxes.
  
  The expectation is that the labellayout="horizontal" setting
  should have the same impact on multilinetextbox tags as it does
  on textbox, multiparttextbox, and other tags. This would be
  less of an issue if the asterisk for required fields were
  considered part of the field value rather than the field label
  but it should still be consistent.
  
  The issue started after upgrading to Maximo 7.6 which
  introduced the option to have field labels appear above fields
  rather than to the left of the field as had always been the
  case for Maximo.
  
  STEPS TO REPRODUCE:
  1) Go to Application Designer and open any application with a
  Description on the main tab and add a new sectionrow tag with 2
  sectioncol tags on the main tab.
  
  2) Add a section tag in each of the sectioncol tags.
  
  3) Add a textbox in the 1st sectioncol and a multiline textbox
  in the 2nd sectioncol and set hidelabel="true" and required =
  "true" on each of them.
  
  4) Use Description as the attribute on both.
  
  5) Go to the app and click on the main tab and look at the
  fields.
  
  6) If your labels are not above the fields on other fields, go
  to System Properties, change the mxe.webclient.verticalLabels
  System Property to "1", do a Live Refresh, and repeat Step 5.
  
  7) You should see the two Description fields appearing on the
  main tab with asterisks above the entry field.
  
  8) Go back to Application Designer, open the same app, and
  export it.
  
  9) Manually edit the exported file to add
  labellayout="horizontal" to the new sectionrow tag. (The
  labellayout property can be added to the sectioncol tag or the
  textbox and multiline textbox tags instead.).
  
  10) Import the modified XML.
  
  11) Go back to the application. You should see that the
  asterisk is now to the left of the textbox but still above the
  multilinetextbox.
  
  CURRENT ERRONEOUS RESULT:
  Asterisk is now to the left of the textbox but still above the
  multilinetextbox.
  
  EXPECTED RESULT:
  The expectation is that the labellayout="horizontal" setting
  should have the same impact on multilinetextbox tags as it does
  on textbox, multiparttextbox, and other tags.
  
  ENVIRONMENT (SYSTEM INFO):
  Tivoli's process automation engine 7.6.1.1-IFIX20191121-0609
  Build 20190514-1348 DB Build V7611-365 HFDB Build HF7611-03
  IBM Maximo Asset Management Work Centers 7.6.0.4 Build $build$
  DB Build V7604-119
  IBM Maximo Asset Management Scheduler 7.6.7.3 Build
  20190514-1348 DB Build V7673-78 HFDB Build HF7673-09
  IBM Tpae Integration Framework 7.6.1.1 Build 20190419-2330 DB
  Build V7611-01
  IBM Maximo for Utilities 7.6.0.2-20191121-1238 Build
  20171128-1353 DB Build V7602-68 HFDB Build HF7602-10
  IBM Maximo Spatial Asset Management 7.6.0.5-20191128-1036 Build
  20190522-1410 DB Build V7605-09 HFDB Build HF7605-03
  IBM Maximo Asset Management 7.6.1.1 Build 20190514-1348 DB
  Build V7611-01
  IoT Connection Utility 7.6.0.2 Build 20190426-2206 DB Build
  V7602-07
  

Local fix

• NA
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * N/A                                                          *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * UI MULTILINETEXTBOX - HIDELABEL CONFLICTS WITH REQUIRED WHEN *
  * LABELS ARE VERTICAL                                          *
  ****************************************************************
  * RECOMMENDATION:                                              *
  ****************************************************************
  

Problem conclusion

• Fixed in control-registry.xml
  

Temporary fix

Comments

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Fix information

• Fixed component name

  SYSTEM CONFIG

• Fixed component ID

  5724R46S1

Applicable component levels