AddListValue Functions
The
AddListValue and
AddListValueSession functions add a choice to a specified list, creating the list if it does not exist. These two functions differ only in respect to parameters for login. For more information, see
Login Parameters.
Syntax
The following is the syntax for an HTTP request:
POST /WindchillRiskandReliability12.0/DataEngine.asmx/AddListValue HTTP/1.1
Host: HostName
Content-Type: application/x-www-form-urlencoded
Content-Length: length
UserName=string&Password=string&GroupName=string&ProjectName=string
&ListCode=string&DisplayText=string
Parameters
In addition to login parameters, both the AddListValue and AddListValueSession functions use these parameters:
• ProjectName—The name of the Windchill Risk and Reliability Project. This value is case-sensitive.
• ListCode—The code for the list. This value is not case-sensitive.
• DisplayText—The text to display for the list choice in Windchill Risk and Reliability. This value is case-sensitive.
The following is an example of an HTTP POST request:
POST /WindchillRiskandReliability12.0/DataEngine.asmx/AddListValue HTTP/1.1
Host: vm-test
Content-Type: application/x-www-form-urlencoded
Content-Length: length
UserName=Bill&Password=passwd&GroupName=Manager&ProjectName=Tablet
PC&ListCode=technicians&DisplayText=John Doe
Returns
If the user is authenticated and the specified parameter values are found, the value entered for DisplayText is added as a choice to the specified list. If this list does not exist, it is created. A choice cannot be added to a non-overridable list.
<?xml version="1.0" encoding="utf-8"?>
<DataEngineFileListResponse xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns="http://www.ptc.com/Windchill Risk and Reliability/12.0/">
<Success>true</Success>
</DataEngineResponse>
If the call fails, the AdditionalData field provides the reason for the failure.