RESTful API Reference › RESTful Web Services and CA Process Automation › Catalyst REST › Dataset REST Examples › UpdateDatasetParameters

UpdateDatasetParameters

To update dataset parameters using REST, specify the name of the parameter from the QueryDatasetParameters response. You can use expressions in the value.

For example, send an HTTP POST request to:

http://<hostname>:7000/node/rest/CA:00074_CA:00074:01/_ops/UpdateDatasetParameters

Include a request header:

Content-Type=application/xml

For example:

<UpdateDatasetParametersRequest 
                      
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
                      xsi:type="p1:UpdateDatasetParametersRequest"
xmlns:p1="http://ns.ca.com/2011/09/pam-ops" 
>
  <Dataset>
    <PathName>/TestDatasets/TestDataset</PathName>
<Parameters>
      <Param>
        <Name>Datasets["/TestDatasets/TestDataset"].Zipcode</Name>
<Value>Datasets["/TestDatasets/TestDataset"].Zipcode + 
100</Value>
  <Type>Integer</Type>
      </Param>
    </Parameters>
  </Dataset>
</UpdateDatasetParametersRequest>

The response contains the updated dataset:

<?xml version="1.0" encoding="UTF-8"?>
<pam-ops:UpdateDatasetParametersResponse
             xmlns:pam-ops="http://ns.ca.com/2011/09/pam-ops"
             xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
             xsi:type="pam-ops:UpdateDatasetParametersResponse">
  <Dataset>
    <PathName>/TestDatasets/TestDataset</PathName>
    <Parameters>
      <Param>
        <Name>Datasets["/TestDatasets/TestDataset"].Name</Name>
        <Value>Harry Truman</Value>
        <Label>Name</Label>
        <Type>String</Type>
      </Param>
      <Param>
        <Name>Datasets["/TestDatasets/TestDataset"].Address</Name>
        <Value>1400 Pennsylvania Avenue</Value>
        <Label>Address</Label>
        <Type>String</Type>
      </Param>
      <Param>
        <Name>Datasets["/TestDatasets/TestDataset"].City</Name>
        <Value>DC</Value>
        <Label>City</Label>
        <Type>String</Type>
      </Param>
      <Param>
        <Name>Datasets["/TestDatasets/TestDataset"].Zipcode</Name>
        <Value>2300</Value>
        <Label>Zipcode</Label>
        <Type>Integer</Type>
      </Param>

Note: Before updating a global dataset, make sure that the dataset has been checked in at least once.