docs: def _checkListItem(policy_element, policy_name, policy_key, xpath_object, policy_file_data, test_items=True):
      '''
      helper function to process an enabled/disabled/true/falseList set
  
      if test_items is True, it will determine if the policy is enabled or
      disabled returning True if all items are configured in the registry.pol file
      and false if they are not
  
      if test_items is False, the expected strings for the items will be returned
      as a list
  
      returns True if the enabled/disabledList is 100% configured in the
      registry.pol file, otherwise returns False
      '''
      xpath_string = ('.//*[local-name() = "decimal" or local-name() = "delete"'
                      ' or local-name() = "longDecimal" or local-name() = "string"]')
      value_item_child_xpath = etree.XPath(xpath_string)
      expected_strings = []
      for list_element in xpath_object(policy_element):
          configured_items = 0
          required_items = 0
          for item in list_element.getchildren():
              required_items = required_items + 1
              if 'key' in item.attrib:
                  item_key = item.attrib['key']
              else:
                  item_key = policy_key
              if 'valueName' in item.attrib:
                  item_valuename = item.attrib['valueName']
              else:
                  log.error('%s item with attributes %s in policy %s does not '
                            'have the required "valueName" attribute',
                            etree.QName(list_element).localname,
                            item.attrib, policy_element.attrib)
                  break
              for value_item in value_item_child_xpath(item):
                  search_string = _processValueItem(value_item,
                                                    item_key,
                                                    item_valuename,
                                                    policy_element,
                                                    item)
                  if test_items:
                      if _regexSearchRegPolData(re.escape(search_string), policy_file_data):
                          configured_items = configured_items + 1
                          log.debug('found the search string in the pol file,'
                                    '%s of %s items for policy %s are '
                                    'configured in registry.pol',
                                    configured_items, required_items,
                                    policy_name)
                  else:
                      expected_strings.append(search_string)
          if test_items:
              if required_items > 0 and required_items == configured_items:
                  log.debug('%s all items are set', policy_name)
                  return True
      if test_items:
          return False
      else:
          return expected_strings