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
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>