JR50942: TW.SYSTEM.CREATEFROMXMLELEMENT REQUIRES ALL ATTRIBUTES TO BE IN UPPERCASE

8.0.1.2-WS-BPM-IFJR50942
Version 8.5 Refresh Pack 6 for the IBM Business Process Manager products

APAR status

• Closed as program error.

Error description

• The JavaScript method
  
    var result =
    tw.system.createFromXmlElement(?businessobjectname?,
    xmlelement)
  
  requires that the name attribute for the column element be in
  uppercase. Because a lowercase attribute value does not work,
  the XML element is ignored and the business object property
  value is not set.
  

Local fix

• Write all attributes in uppercase notation.
  

Problem summary

• The JavaScript API variable =
  tw.system.createFromXmlElement("businessobjectname", xmlelement)
  creates a variable from an XMLElement (refer to the JavaScript
  API reference documentation).
  
  The value of the name attribute of the column element is used to
  find the matching business object property name to map the
  element value. Currently, only uppercase values for the column
  attribute ?name? are supported.
  

Problem conclusion

• A fix is available that removes this limitation. With the fix
  applied, the value of the name attribute of the column element
  can be in any case (lower, upper, or mixed case).
  
  For the mapping the value of the name attribute is translated to
  uppercase and the matching uppercase property name is searched.
  If it is found, the mapping runs; otherwise, the column element
  is skipped.
  
  Business object property names are not case sensitive (for
  example, only one property name of "id, ID, iD, Id" is allowed
  for a business object).
  
  With the fix applied, the following sample works:
   input XMLElement
           <resultSet columnCount="2" recordCount="1">
             <record>
               <column name="name">testName</column>
               <column name="value">testValue</column>
             </record>
           </resultSet>
  
   output BusinessObject variable
           <variable type="NameValuePair[]">
            <item type="NameValuePair">
              <name type="String"><![CDATA[testName]]></name>
              <value type="String"><![CDATA[testValue]]></value>
            </item>
          </variable>
  
  The following example already works before you apply the fix:
   input XMLElement
          <resultSet columnCount="2" recordCount="1">
            <record>
              <column name="NAME">testName</column>
              <column name="VALUE">testValue</column>
            </record>
          </resultSet>
  
       output BusinessObject variable
          <variable type="NameValuePair[]">
            <item type="NameValuePair">
              <name type="String"><![CDATA[testName]]></name>
              <value type="String"><![CDATA[testValue]]></value>
            </item>
          </variable>
  
  On Fix Central (http://www.ibm.com/support/fixcentral), search
  for JR50942:
  
  1. Select IBM Business Process Manager with your edition from
    the product selector, the installed version to the fix pack
    level, and your platform, and then click Continue.
  
  2. Select APAR or SPR, enter JR50942, and click Continue.
  
  When you download fix packages, ensure that you also download
  the readme file for each fix. Review each readme file for
  additional installation instructions and information about the
  fix.
  

Temporary fix

• Not applicable
  

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

  BPM STANDARD

• Fixed component ID

  5725C9500

Applicable component levels

• R801 PSY

     UP