Rules report
This report gives you a complete view of all the rules that were created in a study and includes all the changes that were performed for each rule.
The Rules report offers details about each rule, including rule expression, rule status, the mode in which the rule is contained, as well as information about changes that were made to that rule and the validity of that rule.
This report is available in CSV, PDF and HTML formats.
Modes
This report is available in all 3 modes.
Permission required to run the report
Any user who's assigned the Run the Study Rules Report permission can generate this report.
Filters
Filter | Description |
---|---|
Study Version | Select a study version to display the rules associated with a specific form or question or leave it blank to display all rules in the study. |
Rule State | Select Draft, UAT, Approved or Published to display only rules with a specific state or leave it blank to view all rules in all states. |
Form Title | Select a form title to see all rules that are associated with that form or leave it blank to view all the rules included in all the forms in that study version. |
Question Label | Select a question label to see rules that are associated with that question or leave it blank to view all rules that are associated with all questions included in the form you previously selected. |
Include Audit Trail | Choose Yes to see details about every change that was made to each rule or select No to view only the latest version for each rule. |
File | Choose the output type for the report: CSV, PDF or HTML. |
Field descriptions
Initial fields | Description |
---|---|
Customer Name | A customer's name used to purchase the cloud subscription. |
Study Name | A study's ID as entered by the study manager when they created the study. |
Mode | The mode in which you ran the report. |
Study Version | Number of the study version for which the report is generated. |
Report Generated By | User name of the user who generated the report. |
Created Date | UTC time and date of when this report was run. |
Include Audit Trail | Setting that indicates if you included audit trails in your report or not. |
Do Not Block Users | Setting that will filter out the names of the users in the Action Target field. |
Fields displayed for every selected form title | Description |
---|---|
Visit Name | The name of the visit for which the rule is set. |
Visit RefName | The Reference name of the visit for which the rule is set. |
Form Name | The name of the form that contains the rule. |
Form RefName | The Reference name of the form that contains the rule. |
Target Question | The name of the question that contains the rule. This is the question for which the calculated value or query will appear. |
Question RefName | The Reference name of the question that contains the rule. This is the question for which the calculated value or query will appear. |
Rule Version Number | The number of the rule version included in report. |
Rule Reference ID | The unique ID that was generated for the rule. |
Rule name | The name of the rule as entered by the rule designer. |
Rule Copied |
Reserved for future use Indicates wheter a rule is copied or not. |
Rule Copied From |
Reserved for future use The name of the rule from which the rule was copied from, if applicable. |
Rule Description | The description of the rule as entered by the rule designer. |
Variables | The variables that were defined for the rule. |
Expression | The Javascript expression that was defined for the rule. |
Rule Valid/Invalid | The validity of the rule. This field specifies whether the rule contains any errors. |
Action Type | The type of action that is set for the rule: Create query or Calculate value. |
Action Target | The roles or names of the targets that will be notified when the action is triggered. |
Action Properties | The text of the query message as defined in the Answer type field. |
Rule State | Status of the rule: Draft, UAT, Approved, Published. If audit format is selected all state changes will appear. Otherwise, only the most recent status will be provided for all rules in the study. |
On Publish | Indicates if when a rule gets publish will run on All
Data or Future Data,
according to the configuration on the Rule
Management page.
Note: If the rule gets published using the state slider in Testing mode, this setting can be configured differently when user gets prompted with these two options. |
Mode | The mode where the rule is contained. |
Type of change | Indicates how the rule was modified. If audit format is selected all changes will appear. Otherwise, only the most recent change will be provided for all rules in the study. |
Last modified Date/Time | Date and time (DD-MM-YYYY HH:MM:SS) of when the rule was last modified. |
Last modified by | User name of the user who last modified the rule. |
Parent topic: Report descriptions