Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Insert excerptReusable Excerpts - MasterReusable Excerpts - MasternameContact - CPFMnopaneltrue

Queries allow for users to search in AiM with a defined set of criteria. The query results will display a specific set of data based on the criteria selected. The search criteria fields contain operators that can be used to search records in different ways, such as “Starts with”, “Ends with”, or “Contains”.

🔖 Page Summary

Info

The Page Summary section serves as a quick reference point of the steps, after going through the detailed Step-by-Step Tutorial with screenshots.

...

titleWhat is a Query?

...

titleAnatomy of a Query/Search Screen

...

titleQuery Screens Overview

...

titlePersonal Queries

\uD83D\uDCD8 Step-by-Step Tutorial

What is a Query?

Why will a Query help me? When using a database full of information you will want to retrieve very specific records. These records can be obtained by utilizing a query. 

Expand
titleClick here for 👉 What is a Query?
Info

A search exists for every single record in AiM

Query example - You have a $5,000 budget and 12 employees have charged time to this work order and we are currently at $5,800.

Create a query that will tell you - All the jobs that are over budget or I wanna see all the jobs that are 25% of going over budget.

What is a Query?

Queries do not work like Google, Yahoo, and other search engines where you can use multiple words in a single field and get related results. Though the results will be different, every Query screen will have the same buttons and options for building and saving the search.  The part that changes is the data being searched for within the record.

  • A query is a custom search for details about records in AiM.

  • After executing a query it will display a "Browse" list of all the records that match the different search elements.  

  • Queries can be built for a single search or saved for future use.

  • Queries can be shared with other people or groups of people.

  • Saved Queries can be made into a Dashboard Widget and shared with a group.

  • Saved Queries can be used for Highcharts. These are visual displays of the results in the form of a chart or graph.  These charts can be added to Dashboard Widgets.

  • 👉 There is no limit. If the data is in the system, you can query it!

Info

A personal query is a custom search for desired information based specifically on the user creating it.
Optionally, it may be associated to a role for more global usage.

Examples of some common Queries

  • Show all Work Orders for a specific building.

  • Show all Work Orders assigned to a specific person.

  • Show all Purchase Orders to a specific vendor.

  • List all active properties.

  • Find my "Employee Profile".

  • Display all emergency or high priority Work Orders.

Anatomy of a Query/Search Screen

Expand
titleClick here for 👉 Anatomy of a Query/Search Screen

Anatomy of a Search/Query Screen 

  1. From the WorkDesk, you can click on any module in the left hamburger icon Menu.

  2. In the next screen, you will find additional left menu options, some of which have a magnify glass icon next to them.

  3. Click on a magnify glass icon next to your menu choice for which you would like to create a query for.

  4. These three buttons can be found at the top-left of a query screen:

image-20241120-193506.pngImage Removed
  • Execute - Runs the query

  • Basic Search/Advanced Search - This is a toggle. The button will show which option you will go to by clicking it. NOT which option you are on.

Basic vs Advanced Search
Basic Search - Gives the user a limited number of options for searching. This is often sufficient for more users.
Advanced Search - Gives the user access to more query options to do more complex queries.

Info

By default, all users start with Basic Search. Your System Administrator can change your default for you.

  • Reset - Resets the entire query screen. This is useful when your search results appear to be wrong. You can click Reset and start over knowing all fields have been reset to their default settings.

  1. Below is a screenshot of the search page for Asset Package, under the Asset Management module. Under Action in the left menu, you will find the link to open and begin creating a New Query.

  2. Below Action, View will be empty until the Query has been saved.

Info

Queries you have already created can also be edited and either replace the original query or saved as a completely new query.

screenshot-search-query-screen_aj.jpgImage Removed

Query Screens Overview

Below are detailed descriptions for navigating the screens found when creating a Query.

Starting a Search

Expand
titleClick here for ➡️ Starting a Search

Starting a Search

From your WorkDesk, click on the hamburger icon on the left to expand your top-most search options/how you want to start your search.

  • The Module - The top level category of records

  • The + Sign - Starts a New Record

  • The Magnify Glass - Takes you to the search screen

  • The Record Name (under the Module) - Takes you to a new blank screen

QueryOverview1-cropped.jpgImage Removed

Opening a Record & Starting a New Query/Search from that Record

Expand
titleClick here for ➡️ Opening & Starting a Search from a Record

Opening a Record

  • What the screen looks like after opening with the Record Name (under the Module level of data)

  • In the next screen, the Record Name can be found at the top: In this example, Personal Query is the record name.

  • Next you would click on Search to dive deeper into this screen.

QueryOverview2-cropped.jpgImage Removed

The Search/Query Screen (for the Record Name Selected: Personal Query)

See the previous section, Anatomy of a Search/Query Screen, for more details.

  • Execute - This will run the query.

  • Basic/Advanced Search - Toggling between the two will show which option you will go to, NOT which option you are on.

  • Reset - Resets the entire query screen.

Under Action on the left of the query screen, click on New Query.

QueryOverview3 - cropped.jpgImage Removed

The New Query Screen

Expand
titleClick here for ➡️ The New Query Screen

The New Query Screen

  1. In the New Query screen, first complete the Title field. The Description field below it is optional.

  2. When Query Listing and Query Count are set to Yes, the Query can be displayed on the Dashboard.

  3. Setting the yellow and/or red flag fields will make the query flag turn yellow or red on the WorkDesk or when it reaches the set number. These fields are optional.

  4. The Chart Type will identify the different charting options to display a visual representation of the data you are about to build a query for.

  5. When you are finished and click on Done, the search will open in build mode.

image-20241120-231120.pngImage Removed
  1. After all criteria are entered, click Save to save the query.

  2. Selecting Execute will take you to the results/Browse View of the query.

image-20241120-231514.pngImage Removed

Query/Search Results (aka Browse View)

Expand
titleClick here for ➡️ Query/Search Results

Query/Search Results (Browse View)

  1. In your query search results, click on a Record link to display the details of that record.

QueryOverview6 - cropped.jpgImage Removed
  1. You can also click the blue Search button to return to the Query screen for the name you chose on the record level under the module you chose (in this example, Personal Query).

QueryOverview7.jpgImage Removed

How the Query Screen Looks After Saving 1+ Queries

Expand
titleClick here for ➡️ How the Query Screen Looks After Saving 1+ Queries

How the Query Screen Looks After Saving 1+ Queries

  • Before we saved a query, the only option under Action was New Query. Now, Edit Query has been added.

  • Under View, there were previously no options. But after saving 1 or more queries, those saved queries are listed under this section.

image-20241120-232028.pngImage Removed

Query Screen Structure, Display Order

Expand
titleClick here for ➡️ Query Screen Structure & Display Order

Query Screen Structure

  • Some query screens might have multiple tables involved.

  • The primary table is listed first.

  • After that, additional tables will have its own headings.

  • If the header is indented, the table is subordinate to the table above it.

image-20241120-232226.pngImage Removed

Display Order

Display Order functionality allows you to specify which fields you want to see and the order you wan to see them in, in the Query Results screen.

QueryOverview10.jpgImage Removed

Ascending/Descending Display Order

Ascending (Asc) or Descending (Dsc) are additional Display Order options.

QueryOverview11.jpgImage Removed

Special Operators

Expand
titleClick here for ➡️ Special Operators

Special Operators

  • Special Operators will be used with new WorkDesk queries to make them easier to share across the units.

  • These operators (=, <, >, null, …) work with dates and allow the query to use the characteristics of dates to pull records in a more focused manner.

QueryOverview12 - cropped.jpgImage Removed

Personal Queries

...

Insert excerpt
Reusable Excerpts - Master
Reusable Excerpts - Master
nameContact - CPFM
nopaneltrue

Queries allow for users to search in AiM with a defined set of criteria. The query results will display a specific set of data based on the criteria selected. The search criteria fields contain operators that can be used to search records in different ways, such as “Starts with”, “Ends with”, or “Contains”.

🔖 Page Summary

Info

The Page Summary section serves as a quick reference point of the steps, after going through the detailed Step-by-Step Tutorial with screenshots.

Expand
titleWhat is a Query?

Expand
titleAnatomy of a Query/Search Screen

Expand
titleQuery Screens Overview
Expand
titleStarting a Search

Expand
titleOpening a Record & Starting a New Query/Search from that Record

Expand
titleThe New Query Screen

Expand
titleQuery/Search Results (aka Browse View)

Expand
titleHow the Query Screen Looks After Saving 1+ Queries

Expand
titleQuery Screen Structure & Display Order

Expand
titleSpecial Operators

Expand
titlePersonal Queries

\uD83D\uDCD8 Step-by-Step Tutorial

What is a Query?

Why will a Query help me? When using a database full of information you will want to retrieve very specific records. These records can be obtained by utilizing a query. 

Expand
titleClick here for 👉 What is a Query?
Info

A search exists for every single record in AiM

Query example - You have a $5,000 budget and 12 employees have charged time to this work order and we are currently at $5,800.

Create a query that will tell you - All the jobs that are over budget or I wanna see all the jobs that are 25% of going over budget.

What is a Query?

Info

Throughout the AiM system, you can create a New Query. Queries are built inside of a search screen. You can access a Query/Search screen in a couple of ways:

  1. Clicking on a magnifying glass icon at any level within the AiM platform.

  2. Inside any Record that you have open, click on the blue Search button. This will take you to the Query/Search screen for that specific Record and the Module it’s in.

Queries do not work like Google, Yahoo, and other search engines where you can use multiple words in a single field and get related results. Though the results will be different, every Query screen will have the same buttons and options for building and saving the search.  The part that changes is the data being searched for within the record.

  • A query is a custom search for details about records in AiM.

  • After executing a query it will display a "Browse" list of all the records that match the different search elements.  

  • Queries can be built for a single search or saved for future use.

  • Queries can be shared with other people or groups of people.

  • Saved Queries can be made into a Dashboard Widget and shared with a group.

  • Saved Queries can be used for Highcharts. These are visual displays of the results in the form of a chart or graph.  These charts can be added to Dashboard Widgets.

  • 👉 There is no limit. If the data is in the system, you can query it!

Info

A personal query is a custom search for desired information based specifically on the user creating it.
Optionally, it may be associated to a role for more global usage.

Examples of some common Queries

  • Show all Work Orders for a specific building.

  • Show all Work Orders assigned to a specific person.

  • Show all Purchase Orders to a specific vendor.

  • List all active properties.

  • Find my "Employee Profile".

  • Display all emergency or high priority Work Orders.

Anatomy of a Query/Search Screen

Expand
titleClick here for 👉 Anatomy of a Query/Search Screen

Anatomy of a Search/Query Screen 

  1. From the WorkDesk, you can click on any module in the left hamburger icon Menu.

  2. In the next screen, you will find additional left menu options, some of which have a magnify glass icon next to them.

  3. Click on a magnify glass icon next to your menu choice for which you would like to create a query for.

  4. These three buttons can be found at the top-left of a query screen:

image-20241120-193506.pngImage Added
  • Execute - Runs the query

  • Basic Search/Advanced Search - This is a toggle. The button will show which option you will go to by clicking it. NOT which option you are on.

Basic vs Advanced Search
Basic Search - Gives the user a limited number of options for searching. This is often sufficient for more users.
Advanced Search - Gives the user access to more query options to do more complex queries.

Info

By default, all users start with Basic Search. Your System Administrator can change your default for you.

  • Reset - Resets the entire query screen. This is useful when your search results appear to be wrong. You can click Reset and start over knowing all fields have been reset to their default settings.

  1. Below is a screenshot of the search page for Asset Package, under the Asset Management module. Under Action in the left menu, you will find the link to open and begin creating a New Query.

  2. Below Action, View will be empty until the Query has been saved.

Info

Queries you have already created can also be edited and either replace the original query or saved as a completely new query.

screenshot-search-query-screen_aj.jpgImage Added

Query Screens Overview

Below are detailed descriptions for navigating the screens found when creating a Query.

Starting a Search

Expand
titleClick here for ➡️ Starting a Search

Starting a Search

From your WorkDesk, click on the hamburger icon on the left to expand your top-most search options/how you want to start your search.

  • The Module - The top level category of records

  • The + Sign - Starts a New Record

  • The Magnify Glass - Takes you to the search screen

  • The Record Name (under the Module) - Takes you to a new blank screen

QueryOverview1-cropped.jpgImage Added

Opening a Record & Starting a New Query/Search from that Record

Expand
titleClick here for ➡️ Opening & Starting a Search from a Record

Opening a Record

  • What the screen looks like after opening with the Record Name (under the Module level of data)

  • In the next screen, the Record Name can be found at the top: In this example, Personal Query is the record name.

  • Next you would click on Search to dive deeper into this screen.

QueryOverview2-cropped.jpgImage Added

The Search/Query Screen (for the Record Name Selected: Personal Query)

See the previous section, Anatomy of a Search/Query Screen, for more details.

  • Execute - This will run the query.

  • Basic/Advanced Search - Toggling between the two will show which option you will go to, NOT which option you are on.

  • Reset - Resets the entire query screen.

Under Action on the left of the query screen, click on New Query.

QueryOverview3 - cropped.jpgImage Added

The New Query Screen

Expand
titleClick here for ➡️ The New Query Screen

The New Query Screen

  1. In the New Query screen, first complete the Title field. The Description field below it is optional.

  2. When Query Listing and Query Count are set to Yes, the Query can be displayed on the Dashboard.

  3. Setting the yellow and/or red flag fields will make the query flag turn yellow or red on the WorkDesk or when it reaches the set number. These fields are optional.

  4. The Chart Type will identify the different charting options to display a visual representation of the data you are about to build a query for.

  5. When you are finished and click on Done, the search will open in build mode.

image-20241120-231120.pngImage Added
  1. After all criteria are entered, click Save to save the query.

  2. Selecting Execute will take you to the results/Browse View of the query.

image-20241120-231514.pngImage Added

Query/Search Results (aka Browse View)

Expand
titleClick here for ➡️ Query/Search Results

Query/Search Results (Browse View)

  1. In your query search results, click on a Record link to display the details of that record.

QueryOverview6 - cropped.jpgImage Added
  1. You can also click the blue Search button to return to the Query screen for the name you chose on the record level under the module you chose (in this example, Personal Query).

QueryOverview7.jpgImage Added

How the Query Screen Looks After Saving 1+ Queries

Expand
titleClick here for ➡️ How the Query Screen Looks After Saving 1+ Queries

How the Query Screen Looks After Saving 1+ Queries

  • Before we saved a query, the only option under Action was New Query. Now, Edit Query has been added.

  • Under View, there were previously no options. But after saving 1 or more queries, those saved queries are listed under this section.

Queries can be built and saved for future use. Queries you have already created can also be edited and either replace the original query or saved as a completely new one.

image-20241120-232028.pngImage Added

Query Screen Structure & Display Order

Expand
titleClick here for ➡️ Query Screen Structure & Display Order

Query Screen Structure

  • Some query screens might have multiple tables involved.

  • The primary table is listed first.

  • After that, additional tables will have its own headings.

  • If the header is indented, the table is subordinate to the table above it.

image-20241120-232226.pngImage Added

Display Order

Display Order functionality allows you to specify which fields you want to see and the order you wan to see them in, in the Query Results screen.

QueryOverview10.jpgImage Added

Ascending/Descending Display Order

Ascending (Asc) or Descending (Dsc) are additional Display Order options.

QueryOverview11.jpgImage Added

Special Operators

Expand
titleClick here for ➡️ Special Operators

Special Operators

  • Special Operators will be used with new WorkDesk queries to make them easier to share across the units.

  • These operators (=, <, >, null, …) work with dates and allow the query to use the characteristics of dates to pull records in a more focused manner.

QueryOverview12 - cropped.jpgImage Added
Expand
titleClick here for ➡️ Comprehensive List of Special Operators

Qualifier

Actions

Examples

=

Equals To

Only open work orders will return in this search

image-20240329-220031.pngImage Added

>

Greater Than

The dates that will return in this search are later than later Feb, 27, 2024

image-20240329-220208.pngImage Added

<

Less Than

The dates that will return in this search are before Feb, 27, 2024

image-20240329-220553.pngImage Added

<=

Less Than OR Equal To

>=

More Than OR Equal To

<>

Not Equal To

Starts With

The field must start with the data typed

This example would return phases that start with Bean Hall

image-20240329-220943.pngImage Added

End With

The field must end with the data typed

This example would return work orders created by user who ends in “Pitts”

image-20240329-221202.pngImage Added

Null

Do not type in the search field, it must be blank

This example would return all the work orders where the problem code wasn’t entered

Null means “missing or blank”

image-20240329-221409.pngImage Added

Not Null

This example would return all the work orders where the problem code was entered

 

image-20240329-221548.pngImage Added

In

Allows the user to select multiple values. For this example multiple shops are selected.

image-20240329-221850.pngImage Added

Not In

Allows the user to exclude multiple values. For this example the selected shops will be excluded from the search results

image-20240329-221949.pngImage Added

Between

The search results will return work orders within the chosen date range

image-20240329-222344.pngImage Added

Within

The field must be within the listed timeframe (date fields only)

Options: year, month, week, day, hour

  

image-20240329-222552.pngImage Added

Newer Than

The field must be within the listed timeframe (date fields only)

Options: year, month, week, day, hour

Record returned must be more recent than 4 days ago

image-20240329-223101.pngImage Added

Older Than

The field must be within the listed timeframe (date fields only)

Options: year, month, week, day, hour

Record returned must be older than 3 weeks ago

image-20240329-223205.pngImage Added

Last

The field must be within the listed timeframe (date fields only)

Options: year, month, week, day, hour

Record returned within last the month

image-20240329-223321.pngImage Added

Next

The field must be within the listed timeframe (date fields only)

Options: year, month, week, day, hour

Returns records with desired completion date in the next 5 days

image-20240329-223517.pngImage Added

Column

One of the more powerful operators that compares two different database columns

Returns phases where the actual cost has exceeded the estimated cost. Find this in the phases costs:

Options: =Column, >Column, >=Column, <Column, <=Column, >=%Column, <=%Column

image-20240329-223745.pngImage Added

User

Returns all records created by whoever is logged in at the time

image-20240329-224338.pngImage Added

Personal Queries

Click here for 👉 Personal Queries
Expand
titleClick here for 👉 Personal Queries
title
Info

Personal Queries can be created under any Module in AiM.

You can also view All Personal Queries created under All Modules

  1. From the WorkDesk, click on the hamburger icon on the left and click on the System Administration Module

  2. Click on the Magnify Glass icon next to Personal Query

image-20250103-232040.pngImage Added
  1. In the next screen, click Execute to view all your Personal Queries. You will see a list of your personal queries (example screenshot, below).

image-20250103-230206.pngImage Added
  1. Click on one of the Query links to open that page.

  2. Here, you can Edit the chosen query and share the query to group(s).

By default, Personal Queries are “personal” to the user that created them. Personal Queries are not visible to other logins.

Expand
image-20250103-230450.pngImage Added

...