EditLookupRecord Functions
The following functions modify the values of one or more fields in a specified FRACAS Lookup Table file:
• EditLookupRecord—Modify the value of a field in the specified file.
• EditLookupRecordSession—Modify the value of a field as described in the previous bullet using a session token returned by the GetSessionToken function.
• EditLookupRecordMultipleValues—Accepts a list of fields to read back from the record that you modified. This allows you to read out a record that user calculations or FRACAS lookups modified in only one step.
• EditRecordLookupMultipleValuesSession—Accepts a list of fields to read back from the record that you just modified using a session token returned by the GetSessionToken function.
 |
Because modifying values for multiple fields is complex, these functions are not usable from the dataengine.asmx test page on the server. When you click one of these functions, only a function description is shown. Key fields cannot be modified.
|
Syntax
The following is the syntax for an HTTP request using the EditLookupRecord function:
POST /WindchillRiskandReliability12.0/DataEngine.asmx/EditLookupRecord HTTP/1.1
Host: HostName
Content-Type: application/x-www-form-urlencoded
Content-Length: length
UserName=string&Password=string&GroupName=string&ProjectName=string&LookupFileName=string&Key1=string&Key2=string&Key3=string&Key4=string&Key5=string
Host: HostName
Content-Type: application/x-www-form-urlencoded
Content-Length: length
UserName=string&Password=string&GroupName=string&ProjectName=string&LookupFileName=string&Key1=string&Key2=string&Key3=string&Key4=string&Key5=string
Parameters
The EditLookupRecord and EditLookupRecordMultipleValues functions use the login parameters for Windchill Risk and Reliability user accounts. The EditLookupRecordSession and EditLookupRecordMultipleValuesSession functions use the single login parameter for sessions. For more information, see Login Parameters.
In addition to login parameters, all EditLookupRecord functions use these parameters:
• ProjectName—The name of the Windchill Risk and Reliability Project. This value is case-sensitive.
• LookupFileName—The name of the FRACAS Lookup Table file. This value is case-sensitive.
• Key1—The value of the first key field. This value is case-sensitive.
• Key2—The value of the second key field. This value is case-sensitive.
• Key3—The value of the third key field. This value is case-sensitive.
• Key4—The value of the fourth key field. This value is case-sensitive.
• Key5—The value of the fifth key field. This value is case-sensitive.
• FieldName—The name of the field that you want to modify in the FRACAS Lookup Table file.
• Value—The value in the field that you want to modify.
The following is an example of an HTTP POST request for the EditLookupRecord function:
POST /WindchillRiskandReliability12.0/DataEngine.asmx/EditLookupRecord 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 &LookupFileName=FRACAS Lookup Table 1&Key1=Hanscom AFB&FieldName=Contact &FieldValue=John Smith
Host: vm-test
Content-Type: application/x-www-form-urlencoded
Content-Length: length
UserName=Bill&Password=passwd&GroupName=Manager&ProjectName=Tablet PC &LookupFileName=FRACAS Lookup Table 1&Key1=Hanscom AFB&FieldName=Contact &FieldValue=John Smith
Returns
If the user is authenticated and the specified parameter values are found, the new field value is inserted and ‘true’ is returned.
<?xml version="1.0" encoding="utf-8"?>
<DataEngineResponse xmlns="http://tempuri.org/">
<Success>true</Success>
</DataEngineResponse>
<DataEngineResponse xmlns="http://tempuri.org/">
<Success>true</Success>
</DataEngineResponse>
If ‘false’ is returned, AdditionalData provides the reason that the call failed.
Specifying Multiple Values
The EditRecordMultipleValues and EditRecordMultipleValuesSession functions are among those that use the FieldList parameter to specify multiple fields. For this function, you can update only one table at time. For more information, see Multiple Field Requests.