In this follow up to my first post about filters. I am going to briefly talk about number filters in MotioPI Professional. Without further ado, let’s dive into number property filters in MotioPI!
Number Property Filters
What are Number Property Filters
Number Property filters in MotioPI are just what they sound like, filters that act on any numerical property of your content. Examples include, but are not limited to: run duration of a report in seconds, the total number of recipients set on a schedule and the size of an output. I will talk briefly about how to set up a Number Property filter and then show them in action for the three examples I listed above.
Using Number Property Filter
Number Property filters are available on nearly any panel that has filtering enabled in MotioPI. A non-exhaustive list would be: Content Panel, Schedule Panel, Output Panel, Validation Panel, and Schedule Delivery Panel. To use a Number Property filter, click on the filters button just like you would to add any other filter.
- Here, you select which property to filter from the dropdown, select which type of range you want to act on, and finally select the number values for your filter. In this specific case, I want to identify reports that store a large number of outputs (let’s say greater than10). These reports may be storing too many outputs, thus cluttering your content store. You may even want to alter the retention policy on these objects later. (You can do that in MotioPI too)!
- Once you have configured your filter press “okay/submit” until you are back on the panel where you created your number filter. Your query is now configured with a number filter. Results will only appear if they match the criteria you just set. Press submit and see the results!
Number Property Filter Examples
Here are three examples of number property filters that may prove useful for you as a Cognos Ninja.
The Run Duration number property can filter the duration of the most recent execution of your report in seconds. This information is extracted for the audit database in your environment. For more information about MotioPI and the audit database you can view our webinar on the topic here.
You can use this filter to find reports that are taking a long time to execute in your environment. For example, a value of 60 will identify reports that take longer than a minute to execute. Whereas, 120 will show reports that take longer than 2 minutes.
TOTAL RECIPIENTS COUNT
Total Recipients Count is the sum total of all the various recipients that can be set on a schedule, to, cc, bcc and mobile recipients. This can be very helpful when identifying all the schedules that are sent out to a large number of recipients, or schedules that are sent to no recipients at all.
For example, this report has 4 recipients, 2 in cc field and 2 in the to field.
Sure enough, it appears when we filter for schedules with 4 total recipients.
You can filter on the output size of your reports by using the KB size filter in the Output Panel. This filter allows the user to identify large reports in their environment. Large outputs may be candidates for removal in order to clear up space on the content store. Alternatively, if the output is so large it may be an indicator that it was incorrectly constructed. In either case, identifying reports over a certain size can give a Cognos administrator insight into their environment.
THINGS TO BE AWARE OF
- Avoid commas when writing entering in a number, express one thousand as 1000 instead of 1,000. Periods will be interpreted as a decimal point.
- If you want MotioPI to identify recently updated content in your Cognos environment. You may need to clear your sessions cache of Cognos content. To clear your cache, press edit -> Clear Cache in the MotioPI menu bar.
- If a number property you expected to see is absent. Shoot us an email at
email@example.com - There may be an alternative way to accomplish your task, or we may even add in your requested filter!
- Be very precise with your filters. If you apply a filter that does not match any of your Cognos content then you will see no results!
- Even if you filter out most objects in your Content store. MotioPI still needs to check them all to see which objects match your filters. In other words, adding filters does not noticeably decrease the time it takes to perform a search.