UpdateTestParametersRequest

An UpdateTestParametersRequest is sent on invocations of the UpdateTestParameters operation. It may be used to assign monitors to sites, to update the display name on a test step, or to modify test parameters.

Derived by

Restricting anyType

Content model

Contains elements as defined in the following table.

Component Type Occurs Nillable? Description
SEQUENCE 1..1
Credentials anyType (restriction) 1..1 No A Credentials element contains the username and password of an account user. The element is required in all requests to the Test Management Web Service.
UserName [element Credentials] string 1..1 No The UserName of an employee for an account (and used for authentication).
Password [element Credentials] string 1..1 No A secret used as part of user credentials for authentication. Every request to the Test Management API web service must include a Credentials element. That element itself contains a UserName and a Password element.
PartialUpdate anyType (restriction) 1..* No One or more PartialUpdate elements appear in an UpdateTestParametersRequest. Each PartialUpdate targets a specific monitor. A PartialUpdate may be used to update the list of sites to which a monitor is deployed, the name of a test step, or one or more test parameters such as SummaryFlag, IncludeRenderTime, IP version, etc.

Example

The following example shows how the assignment of monitors to sites can be updated:

<prov:UpdateTestParametersRequest
   xmlns:prov="http://www.gomeznetworks.com/schemas/provisioning">
   <prov:Credentials>
      <prov:UserName>erics</prov:UserName>
      <prov:Password>erics</prov:Password>
   </prov:Credentials>
   <!--1 or more repetitions:-->
   <prov:PartialUpdate monitorId="326334">
      <prov:MonitorSites>
            <prov:MonitorSite siteId="777" siteName="TPNTS7 - MA: Boston"
            city="Lexington" state="MA" countryCode="US" ipV6Enabled="false"/>
            <prov:MonitorSite siteId="865" siteName="TPNPEKSA12 - Beijing China test"
            city="Beijing" state="" countryCode="CN" ipV6Enabled="false"/>
      </prov:MonitorSites>
   </prov:PartialUpdate>
</prov:UpdateTestParametersRequest>

The next example shows how the display name on a test step may be modified:

<prov:UpdateTestParametersRequest
   xmlns:prov="http://www.gomeznetworks.com/schemas/provisioning">
   <prov:Credentials>
      <prov:UserName>erics</prov:UserName>
      <prov:Password>erics</prov:Password>
   </prov:Credentials>
   <!--1 or more repetitions:-->
   <prov:PartialUpdate monitorId="328680">         
         <prov:Steps>
            <prov:Step stepSeqNum="0">
               <prov:DisplayName>Portal Login</prov:DisplayName>
            </prov:Step>
         </prov:Steps>                  
      </prov:PartialUpdate>
</prov:UpdateTestParametersRequest>

The next example shows how the ExpirationDate on a test may be updated:

<prov:UpdateTestParametersRequest xmlns:prov="http://www.gomeznetworks.com/schemas/provisioning">
   <prov:Credentials>
      <prov:UserName>erics</prov:UserName>
      <prov:Password>erics</prov:Password>
   </prov:Credentials>
   <prov:PartialUpdate monitorId="264019">
      <prov:MonitorProperties>
         <prov:MonitorProperty name="ExpirationDate"
            value="2011-07-19T19:24:51.96"/>
      </prov:MonitorProperties>
   </prov:PartialUpdate>
</prov:UpdateTestParametersRequest>

See MonitorProperties for more examples of how test properties can be modified.