MonitorProperties

The MonitorProperties element appears in UpdateTestParameters operation invocations. It is a container of MonitorProperty elements, name value pairs used to set new values on the test parameters of previously provisioned tests.

Derived by

Restricting anyType

Content model

Contains elements as defined in the following table.

Component Type Occurs Nillable? Description
SEQUENCE 1..1
MonitorProperty anyType (restriction) 1..* No The MonitorProperty element appears in an UpdateTestParameters operation invocation. The element is a name-value pair used to reset a test parameter value such as ExpirationDate or SummaryFlag.

Referenced by

Example

The following example shows the MonitorProperties element as it appears in an UpdateTestParameters operation invocation.

<prov:UpdateTestParametersRequest>
   <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>

The next example shows how AgentType can be modified:

<prov:UpdateTestParametersRequest>
   <prov:Credentials>
      <prov:UserName>erics</prov:UserName>
      <prov:Password>erics</prov:Password>
   </prov:Credentials>
   <!--1 or more repetitions:-->
   <prov:PartialUpdate monitorId="263014">
      <prov:MonitorProperties>
         <prov:MonitorProperty name="AgentType" value="IE"/>
      </prov:MonitorProperties>
   </prov:PartialUpdate>
</prov:UpdateTestParametersRequest>

The next example shows how one could modify the folder name under which a test is grouped:

<prov:UpdateTestParametersRequest>
   <prov:Credentials>
      <prov:UserName>erics</prov:UserName>
      <prov:Password>erics</prov:Password>
   </prov:Credentials>
   <!--1 or more repetitions:-->
   <prov:PartialUpdate monitorId="263014">
      <prov:MonitorProperties>
         <prov:MonitorProperty name="Folder" value="MultiStep Tests"/>
      </prov:MonitorProperties>
   </prov:PartialUpdate>
</prov:UpdateTestParametersRequest>

In the previous example, if the folder didn't exist, it is created. However, the original folder is not deleted. A test cannot belong to more than one folder. Therefore, the test is only grouped under the new folder after the update.

The next example shows how to modify the test frequency (in minutes):

<prov:UpdateTestParametersRequest>
   <prov:Credentials>
      <prov:UserName>erics</prov:UserName>
      <prov:Password>erics</prov:Password>
   </prov:Credentials>
   <!--1 or more repetitions:-->
   <prov:PartialUpdate monitorId="263014">
      <prov:MonitorProperties>
         <prov:MonitorProperty name="FrequencyInMins" value="20"/>
      </prov:MonitorProperties>
   </prov:PartialUpdate>
</prov:UpdateTestParametersRequest>

The next example illustrates how to change the value of SummaryFlag for a given monitor:

<prov:UpdateTestParametersRequest>
   <prov:Credentials>
      <prov:UserName>erics</prov:UserName>
      <prov:Password>erics</prov:Password>
   </prov:Credentials>
   <!--1 or more repetitions:-->
   <prov:PartialUpdate monitorId="263014">
      <prov:MonitorProperties>
         <prov:MonitorProperty name="SummaryFlag" value="Off"/>
      </prov:MonitorProperties>
   </prov:PartialUpdate>
</prov:UpdateTestParametersRequest>

The next example shows how to change the value of IncludeRenderTime for a given monitor:

<prov:UpdateTestParametersRequest>
   <prov:Credentials>
      <prov:UserName>erics</prov:UserName>
      <prov:Password>erics</prov:Password>
   </prov:Credentials>
   <!--1 or more repetitions:-->
   <prov:PartialUpdate monitorId="263733">
      <prov:MonitorProperties>
         <prov:MonitorProperty name="IncludeRenderTime" value="On"/>
      </prov:MonitorProperties>
</prov:UpdateTestParametersRequest>

IpVersion can also be modified using a monitor properties. However, since IpVersion determines the sites on which a monitor can run, you are required to submit a new site list when updating this parameter.

<prov:UpdateTestParametersRequest>
   <prov:Credentials>
      <prov:UserName>erics</prov:UserName>
      <prov:Password>erics</prov:Password>
   </prov:Credentials>
   <!--1 or more repetitions:-->
   <prov:PartialUpdate monitorId="263733">
      <prov:MonitorProperties>
         <prov:MonitorProperty name="IpVersion" value="IPv6_preferred"/>
      </prov:MonitorProperties>
      <prov:MonitorSites>
            <prov:MonitorSite siteId="777"/>
            <prov:MonitorSite siteId="872"/>
            <prov:MonitorSite siteId="873"/>
            <prov:MonitorSite siteId="880"/>
            <prov:MonitorSite siteId="881"/>
            <prov:MonitorSite siteId="887"/>
      </prov:MonitorSites>            
   </prov:PartialUpdate>
</prov:UpdateTestParametersRequest>