Running data rules

Use the POST executeTasks command to run data rules. Then use the output to analyze conditions that are found during data profiling, to assess data quality, to provide input to a data integration effort, or to establish a baseline for validating and measuring data quality over time.

Command

POST executeTasks

Parameters

There are no parameters for this command. Instead, you embed the XML string that defines the column analysis in the body of the POST request.

HTTP method

Table 1. HTTP method
HTTP method	URI pattern	Data format	Success codes	Error codes
POST	executeTasks	XML	200	400 (bad request) or 500 (server error)

Example HTTP request

https://ServerName:9443/ibm/iis/ia/api/executeTasks

Example XML string: Running three rules

The following example runs three rules: rule1, rule2, and rule3:

<?xml version="1.0" encoding="UTF-8"?>
<iaapi:Project xmlns:iaapi="http://www.ibm.com/investigate/api/iaapi" 
	name="projectName">
  <Tasks>
    <RunRules>
      <ExecutableRule name="rule1"/>
      <ExecutableRule name="rule2"/>
      <ExecutableRule name="rule3"/>
    </RunRules>
  </Tasks>
</iaapi:Project>

Example XML string: Running rules on a schedule

The following example runs three rules on a schedule:

<?xml version="1.0" encoding="UTF-8"?>
 <iaapi:Project xmlns:iaapi="http://www.ibm.com/investigate/api/iaapi" 
	name="projectName">
   <Tasks>
     <RunRules>
        <SampleOptions type="every_nth" size="1000" nthvalue="10"/>
        <Schedule startDate="2010-02-09T18:56:31+01:00" 
          runUntil="2010-02-15T10:00:00+01:00" nbOfInstances="10">
            <ScheduleRepeat second="0" minute="0" hour="12" 
              dayOfMonth="*" month="*" dayOfWeek="?" year="*"/>
        </Schedule>
       <ExecutableRule name="rule1"/>
       <ExecutableRule name="rule2"/>
       <ExecutableRule name="rule3"/>
     </RunRules>
   </Tasks>
 </iaapi:Project>