![Page 1: Opmantek - Custom Queries in Open-AudIT v1...• How Open-AudIT differentiates queries, reports, and summaries, and how you can edit each • How to piece together the tables and fields](https://reader033.vdocuments.site/reader033/viewer/2022050105/5f43d766b2538717a02aca3d/html5/thumbnails/1.jpg)
OPMANTEKNETWORK MANAGEMENT AND IT AUDIT SOFTWARE
Developing Custom Queries with Open-AudIT - v1.0, June 2018
![Page 2: Opmantek - Custom Queries in Open-AudIT v1...• How Open-AudIT differentiates queries, reports, and summaries, and how you can edit each • How to piece together the tables and fields](https://reader033.vdocuments.site/reader033/viewer/2022050105/5f43d766b2538717a02aca3d/html5/thumbnails/2.jpg)
We will send you the recording.
Submit your questions anytime. We’ll do Q&A throughout.
Please complete the Exit survey.
![Page 3: Opmantek - Custom Queries in Open-AudIT v1...• How Open-AudIT differentiates queries, reports, and summaries, and how you can edit each • How to piece together the tables and fields](https://reader033.vdocuments.site/reader033/viewer/2022050105/5f43d766b2538717a02aca3d/html5/thumbnails/3.jpg)
Topics for Today
No matter how many canned reports you have, there’s always a need for a modification
or a custom report. Join us for this 45-minute session while we learn:
• How Open-AudIT differentiates queries, reports, and summaries, and how you can edit each
• How to piece together the tables and fields in the Open-AudIT database to create any kind of
report you want, quickly and easily
• Methods for troubleshooting your custom query, and ensuring it’s running as quickly and
efficiently as possible
• What resources are available to help you when you get stuck
![Page 4: Opmantek - Custom Queries in Open-AudIT v1...• How Open-AudIT differentiates queries, reports, and summaries, and how you can edit each • How to piece together the tables and fields](https://reader033.vdocuments.site/reader033/viewer/2022050105/5f43d766b2538717a02aca3d/html5/thumbnails/4.jpg)
IT Service Management Maturity Model
CHAOTIC• Ad Hoc• Undocumented• Unpredictable• Multiple help desks• Minimal IT operations• User call notification
REACTIVE• Fight fires• Inventory• Desktop software
distribution• Initiate problem
management process• Alert and event
management• Measure component
availability (up/down)
PROACTIVE• Analyze trends• Set thresholds• Predict problems• Measure application
availability• Automate• Mature problem
configuration, change, asset andperformance mgmt. processes
SERVICES• IT as a service provider• Define services, classes,
pricing• Understand costs• Guarantee SLAs• Measure and report
service availability• Integrate processes• Capacity Mgmt.
VALUE• IT as a strategic business
partner• IT and business metric
linkage• IT/business collaboration
improves business process• Real-time infrastructure• Business planning
Tool Leverage
Operational Process Engineering
Service Delivery Process Engineering
Service & Account Management
Manage IT as a Business
Level 0
Level 1
Level 2
Level 3
Level 4
Increasing Performance & Value to Organization
![Page 5: Opmantek - Custom Queries in Open-AudIT v1...• How Open-AudIT differentiates queries, reports, and summaries, and how you can edit each • How to piece together the tables and fields](https://reader033.vdocuments.site/reader033/viewer/2022050105/5f43d766b2538717a02aca3d/html5/thumbnails/5.jpg)
Open-SourceOpen-AudIT Community
Commercial SolutionsOpen-AudIT Professional/Enterprise
Architecting a Solution
![Page 6: Opmantek - Custom Queries in Open-AudIT v1...• How Open-AudIT differentiates queries, reports, and summaries, and how you can edit each • How to piece together the tables and fields](https://reader033.vdocuments.site/reader033/viewer/2022050105/5f43d766b2538717a02aca3d/html5/thumbnails/6.jpg)
References
Open-AudIT Home Page
https://community.opmantek.com/display/OA/HomeOpen-AudIT Forums
https://www.open-audit.org/phpBB3/Open-AudIT Questions Board
https://community.opmantek.com/display/OA/questions/all
You should bookmark these…
![Page 7: Opmantek - Custom Queries in Open-AudIT v1...• How Open-AudIT differentiates queries, reports, and summaries, and how you can edit each • How to piece together the tables and fields](https://reader033.vdocuments.site/reader033/viewer/2022050105/5f43d766b2538717a02aca3d/html5/thumbnails/7.jpg)
QUERIES, REPORTS AND SUMMARIES, AND HOW TO EDIT EACH
![Page 8: Opmantek - Custom Queries in Open-AudIT v1...• How Open-AudIT differentiates queries, reports, and summaries, and how you can edit each • How to piece together the tables and fields](https://reader033.vdocuments.site/reader033/viewer/2022050105/5f43d766b2538717a02aca3d/html5/thumbnails/8.jpg)
Open-AudIT
• WHAT
• Queries provide fast, filtered access to information stored in the dB
• Summaries provide a method for creating an organized menu, or summary, based on a
series of parameters
• Reports are only available in Professional/Enterprise and are specialized, time-limited
queries. These cannot be edited; however, queries can be created with similar filters
• Queries, Summaries, and Reports can all be accessed via the API or scheduled as a task for
creation and emailing
Queries, Reports and Summaries
https://community.opmantek.com/pages/viewpage.action?pageId=25297103
![Page 9: Opmantek - Custom Queries in Open-AudIT v1...• How Open-AudIT differentiates queries, reports, and summaries, and how you can edit each • How to piece together the tables and fields](https://reader033.vdocuments.site/reader033/viewer/2022050105/5f43d766b2538717a02aca3d/html5/thumbnails/9.jpg)
Open-AudIT
• Summaries
• Manage -> Summaries -> List Summaries• Summaries use the “group by” concept
• Extra columns add to the device list after the Summary
Editing Summaries
https://community.opmantek.com/display/OA/Summaries
![Page 10: Opmantek - Custom Queries in Open-AudIT v1...• How Open-AudIT differentiates queries, reports, and summaries, and how you can edit each • How to piece together the tables and fields](https://reader033.vdocuments.site/reader033/viewer/2022050105/5f43d766b2538717a02aca3d/html5/thumbnails/10.jpg)
Open-AudIT
• Queries
• Manage -> Queries -> List Queries
Editing Queries and Summaries
https://community.opmantek.com/display/OA/Queries
![Page 11: Opmantek - Custom Queries in Open-AudIT v1...• How Open-AudIT differentiates queries, reports, and summaries, and how you can edit each • How to piece together the tables and fields](https://reader033.vdocuments.site/reader033/viewer/2022050105/5f43d766b2538717a02aca3d/html5/thumbnails/11.jpg)
BUILDING A SQL STATEMENT
![Page 12: Opmantek - Custom Queries in Open-AudIT v1...• How Open-AudIT differentiates queries, reports, and summaries, and how you can edit each • How to piece together the tables and fields](https://reader033.vdocuments.site/reader033/viewer/2022050105/5f43d766b2538717a02aca3d/html5/thumbnails/12.jpg)
Open-AudIT
• Process Outline
• Reverse engineer similar queries to see how they are constructed and filters built
• Define the information you need in the query and how that information will be used
• Identify which table(s) the information you need is located
• Admin -> Database -> List Tables
• Each Collection in the Wiki includes a list of fields
• Refer to the online guides for specific examples
• Start from an existing query, remove fields not needed, and add in yours
• Add filters LAST
How to Build a Query
![Page 13: Opmantek - Custom Queries in Open-AudIT v1...• How Open-AudIT differentiates queries, reports, and summaries, and how you can edit each • How to piece together the tables and fields](https://reader033.vdocuments.site/reader033/viewer/2022050105/5f43d766b2538717a02aca3d/html5/thumbnails/13.jpg)
Open-AudIT
• Custom fields allow users to expand Open-AudIT to include additional fields like simple text, list
boxes with defined entries, and date fields
• The “fields” table defines the custom field
• The “field” table (note, no “s”) contains the data stored in the field
• First, join the system table to the field table -
LEFT JOIN field ON (system.id = field.system_id)
• Then, filter on the field number and (optionally) a desired value –
WHERE @filter AND field.fields_id = '1' AND field.value = 'yes'
Including Custom Fields in Queries
https://community.opmantek.com/x/lxCCAQ
![Page 14: Opmantek - Custom Queries in Open-AudIT v1...• How Open-AudIT differentiates queries, reports, and summaries, and how you can edit each • How to piece together the tables and fields](https://reader033.vdocuments.site/reader033/viewer/2022050105/5f43d766b2538717a02aca3d/html5/thumbnails/14.jpg)
TROUBLESHOOTING YOUR QUERY
![Page 15: Opmantek - Custom Queries in Open-AudIT v1...• How Open-AudIT differentiates queries, reports, and summaries, and how you can edit each • How to piece together the tables and fields](https://reader033.vdocuments.site/reader033/viewer/2022050105/5f43d766b2538717a02aca3d/html5/thumbnails/15.jpg)
Open-AudIT
• Copy your SQL to a text editor
• Check for use of the single quote ( ‘ ) rather than backticks ( ` )
• Backticks enclose fields, single quotes enclose values
• Double-check table names (parent defining tables vs content tables – i.e. fields vs field)
• Reduce SQL to bare bones; make sure that works
• Add fields, then filters back in one at a time until the query breaks
• Remember – this is a web application, you can right-click on most links and menus and open
them in a new browser tab or window.
Troubleshooting Your Query
![Page 16: Opmantek - Custom Queries in Open-AudIT v1...• How Open-AudIT differentiates queries, reports, and summaries, and how you can edit each • How to piece together the tables and fields](https://reader033.vdocuments.site/reader033/viewer/2022050105/5f43d766b2538717a02aca3d/html5/thumbnails/16.jpg)
ADDITIONAL RESOURCES
![Page 17: Opmantek - Custom Queries in Open-AudIT v1...• How Open-AudIT differentiates queries, reports, and summaries, and how you can edit each • How to piece together the tables and fields](https://reader033.vdocuments.site/reader033/viewer/2022050105/5f43d766b2538717a02aca3d/html5/thumbnails/17.jpg)
Open-AudIT
• Open-AudIT Wiki - https://community.opmantek.com/display/OA/Home
• MySQL Tutorials - http://www.mysqltutorial.org/• MariaDB Tutorials - https://mariadb.org/learn/
• Commercial Licenses for Open-AudIT Professional/Enterprise include Support & Maintenance,
which includes help writing Queries and Summaries (amongst other things)
Additional Resources for Building Queries
![Page 18: Opmantek - Custom Queries in Open-AudIT v1...• How Open-AudIT differentiates queries, reports, and summaries, and how you can edit each • How to piece together the tables and fields](https://reader033.vdocuments.site/reader033/viewer/2022050105/5f43d766b2538717a02aca3d/html5/thumbnails/18.jpg)
CONTACT FOR FOLLOW UP
Commercial enquiries:
Tom WiriAccount Executive+1 (512) [email protected]
Technical enquiries:
Mark HenrySenior Engineer+1 (207) [email protected]