WebSphere brand IBM WebSphere Sensor Events, Version 6.2

updateItem

Purpose

This Web service updates optional attributes for an item in the Location Awareness Services for WebSphere® Sensor Events database. Key properties cannot be changed with this service. You only need to provide the attributes you want to change. To blank out existing attributes, provide blank or null values. A list of groups always replaces the old list of groups.

Syntax

ItemIDWithTimeStamp updateItem (className,KeywordValuePair[] keyPairs,KeywordValuePair[] optPairs,String[] groups,LocaleDescriptor locale)

Input

className: A string that represents name of the class for the item that should be changed.

keyPairs: An array from the type, com.ibm.atlas.adminobjects.lasitemregistration.KeywordValuePair. This parameter is a keyword-value pair that represents key properties. The combination of values has to be unique. The keyword for each keyword-value pair is the name of a key property, and the value is the value for that key property. You can set these with setKeyword() and setValue(). The values must be in the correct type and in the correct format. For example, if the property type is an integer, then the value must also be an integer and can contain any number between 0 and 9.

optPairs: An array from type, com.ibm.atlas.adminobjects.lasitemregistration.KeywordValuePair. This variable is a keyword-value pair that represents optional properties. The keyword for each keyword-value pair is the name of an optional property, and the value is the value for that optional property. You can set these with setKeyword() and setValue(). The values must be in the correct type and in the correct format. For example, if a property type is a date, then the value must be in the MM/dd/yyyy format. You only need to provide attributes you want to change.

groups: An array from the type, String, that, if not set to null, contains the assigned groups for the item. A new list of groups always replaces the old list of groups. To remove group assignments, set a blank list.

locale: If you want to set the default value, you have to input null. See Localization and input parameters for more information about the locale descriptor.

Output

The output from the Web service is an object from the type, ItemIDWithTimeStamp. This contains the item ID and the timestamp of the last update for the new item.


Library | Support | Terms of use

(c) Copyright IBM Corporation 2004, 2009. All rights reserved.
U.S. Government Users Restricted Rights - Use, duplication or disclosure restricted by GSA ADP Schedule Contract with IBM Corp.