Contact Us

The Saved Search Progress Bar helps users to better manage tasks in their NetSuite environment. Check out the video below for a brief introduction to the NetSuite Saved Search Progress Bar, including different use cases, how to set up the progress bar, and even how to customize it!

NetSuite Saved Search Progress Bar | Demo

NetSuite Saved Search Progress Bar Example

We have a few easy cases here where the NetSuite Saved Search Progress Bar will compare two variables and show you how close you are to achieving a goal.  More specifically, it does this by comparing a single goal variable versus an incremental variable that is meant to achieve that goal.  As you can see in the image below, the use case in our example here is tracking the number of hours dedicated to a particular task or project:

Saved search progress bar new.

In this image, you will notice that we have included 5 project examples that highlight the functionality of the NetSuite Saved Search Progress Bar:

  1. In the first example line, we have a 25-hour goal with 19 hours of work put towards that goal so far.  The progress bar performs a simple calculation and shows us that there are now 6 hours remaining for that task or project goal.
  2. In the second example line, we see that a goal of 20 hours was set for a project, but that goal has been exceeded by 20 hours.  The progress bar highlights these over-budget hours so you can quickly identify projects that have gone over-budget
  3. The third example line shows us an ongoing project with no established goal, but which has had 300 hours of work put towards it. In this case, the progress bar keeps track of the hours but uses color to signal that a goal may still need to be set.
  4. The fourth example line shows a case in which no goal has been established, and no work has been done towards that goal.  Note that as in the third line example, no goal has been set. But, since no progress has been made on this project yet, the progress bar simply shows "No Goal".
  5. The fifth and final example shows us a project with a 500-hour goal set, but no progress made towards that goal as of yet. Note that this is similar to the first line example, with the only difference being that no progress has been made towards the goal yet.

This same functionality can be applied to any situation where you have a goal and an incremental variable to achieve the goal.  The colors and units can be customized to reflect the functionality you need.

 

Setting Up the Saved Search Progress Bar

Step 1:  To set up this progress bar, the first thing you will have to do is create a Saved Search in NetSuite that compares a goal value to an incremental value.

Step 2:  Get the ID for your goal value from your custom record (or any other record that you want to compare).

Custom record for progress bar.

Step 3:  Next, open up the progress bar .sql code provided below.  You will notice that the code file has 'x' and 'y' values in as placeholders.   The 'y' value is the goal value and the 'x' value is the incremental value.

Step 4:  Go through to each place where you see the 'y' placeholder value and replace it with the ID for your goal value.  

Step 5:  Go through to each place where you see the 'x' placeholder value and replace it with the ID for your incremental value.

Step 6:  Copy your code.

Step 7:  Open your Saved Search.  

NetSuite progress bar saved search.

Step 8:  Under the Results tab, on the Columns subtab, you will need to add a Formula (text) field and paste your code in as the formula.  Remember to click OK to add the field to your saved search.

Step 9:  Save and Run your Saved Search.

That's it!  Your NetSuite Saved Search Progress Bar is all set up.  But what if you want to customize the look and feel of the progress bar to better suit your particular use cases?  There are plenty of ways you can customize the progress bar, but we're going to focus on two prominent features of the progress bar that almost everyone will want to customize... the colors and the unit labels.

 

Using Colors in the NetSuite Progress Bar

The meaning of the colors in the NetSuite Saved Search Progress Bar will be a bit different for each use case. But, the colors are always important and can be adjusted to better fit your needs.  In the example we walked through above, the colors indicate the following:

  • Green indicates progress towards a goal that falls within the budgeted time
  • Grey with white text indicates remaining hours dedicated to a task with a set goal
  • Red indicates hours that were over budget
  • Yellow indicates that no goal has been set, but progress is already being made
  • Grey with black text indicates that no goal has been set, and no progress has been made

However, let's say you want to track progress toward a fundraising goal, or employee volunteer hours... something where surpassing the goal is a good thing.  You could customize the progress bar colors so that, for example:

  • Green could indicate progress made towards the goal
  • Grey could indicate progress that still needs to be made toward the goal
  • Yellow/Gold could indicate when progress meets or surpasses the goal 

Again these are very simple changes, but by using color well, you can have a big impact on how your team manages projects.  Using these visual tools like color, you are taking information that's a bit abstract and making it more tangible for your team.  This can add value to your project management since people are more likely to take appropriate action when the information they are given is more tangible.

 

Using Unit Labels in the NetSuite Progress Bar

You do not need to include unit labels on your saved search bar, but they are often nice to have.

Labels provide context and clarity around the metrics in your Saved Search Progress Bar, which can come in handy in a variety of cases.  Let's say you're bringing someone new onto a project and you want them to reference the progress bar.  Having the metrics labeled means that's one less thing you have to remember to explain them.  When the metrics are labeled, the information in the Progress Bar makes sense even when the person looking at it has little to no other context for the information.

In the example above, we used hours as our example metric, and so we labeled our Progress Bar metrics with the abbreviation 'hrs'.  However, these unit labels can be customized to say anything!  For example, if you're tracking the number of toasters sold, you can change the label to 'toasters'.  If you're tracking how much of a budget has been spent or committed, you could label the column 'dollars'.

To customize the labels on your Saved Search Progress Bar, simply follow the instructions outlined below.

 

Customizing the Saved Search Progress Bar

You'll notice through this article that we've included 3 versions of the NetSuite Saved Search Progress Bar Code, and each has its own purpose.

Primary Code File

The primary code file that you will want to work from is the .sql code for the Progress Bar.  This is the file you use when you initially set up the Progress Bar, and we recommend making any future changes or customizations to the Progress Bar within this file.

Note:  Remember that any time you make edits to your .sql code file, you will need to copy and paste the newly edited code into the saved search Formula (text) field over the top of what was previously there, and Save and Run the Saved Search again.  Until you do, your customizations won't show up in your Progress Bar.

CSS.HTML File: Reference when Customizing Colors

At some point, you will likely want to change some of the HTML or CSS associated with the Progress Bar, for instance, if you would like to change some of the colors. When making changes involving HTML or CSS, you may want to reference the progress bar CSS.HTML file.  This file is laid out in a concise and easily readable format where you can quickly view the CSS/HTML code that you would like to make changes to.  (In the primary .sql file, it's a bit harder to read the HTML with the SQL in between it.)  After referencing the CSS.HTML file, you will need to go in and make your changes in your actual SQL file.

.sql File with Comments: Reference when Customizing Labels

When you wish to customize unit labels, you can simply open the .sql Code with Comments, and look for the comments which identify the locations in the code where you can add your labels.   When you have found the label locations, you can switch over to the plain .sql file, find those same locations in the code, and add in the unit labels.

 

NetSuite Saved Search Progress Bar .sql Code

Here is the .sql code for the Saved Search Progress Bar with placeholder variables 'x' and 'y':

  • x = custom event time used
  • y = estimated time override
'
' || CASE WHEN NVL({y}, 0) <= 0 OR {x} IS NULL THEN '' WHEN {x} <= {y} THEN TO_CHAR({x}) WHEN {x} > {y} THEN TO_CHAR({y}) END || '
' || CASE WHEN NVL({y}, 0) <= 0 OR {x} IS NULL THEN '' WHEN {x} < {y} THEN TO_CHAR({y} - {x}) ELSE '' END || '
' || CASE WHEN NVL({y}, 0) <= 0 OR {x} IS NULL THEN '' WHEN {x} > {y} THEN TO_CHAR({x} - {y}) ELSE '' END || '
' || CASE WHEN NVL({y}, 0) <= 0 AND NVL({x}, 0) > 0 THEN TO_CHAR({x}) END || '
' || CASE WHEN NVL({y}, 0) <= 0 AND NVL({x}, 0) <= 0 THEN 'No Goal!' END || '
'

NetSuite Progress Bar .sql Code with Comments

Here is the .sql code for the Saved Search Progress Bar with comments that can help you to more easily navigate and maximize your use of the code:

'
x.*/ WHEN {x} > {y} /*Case-when statements in SQL must return a char so we convert the numeric value using the TO_CHAR() method.*/ THEN TO_CHAR({y} / {x}) END )) END || '%">' || /*Number that should display in the green bar.*/ CASE /*Since we cannot assign variables in the version of SQL that we use, we must perform a null check in each block that will use the values x and y.*/ WHEN NVL({y}, 0) <= 0 OR {x} IS NULL THEN '' WHEN {x} <= {y} THEN TO_CHAR({x}) /*Location to add units. */ WHEN {x} > {y} THEN TO_CHAR({y}) /*Location to add units. */ END || '
' || /*Number that should display in the remainder progress bar.*/ CASE WHEN NVL({y}, 0) <= 0 OR {x} IS NULL THEN '' WHEN {x} < {y} THEN TO_CHAR({y} - {x}) /*Location to add units. */ ELSE '' END || '
' || /*Number displayed in overvalue bar. This should be the amount by which x is greater than y.*/ CASE /*Null check.*/ WHEN NVL({y}, 0) <= 0 OR {x} IS NULL THEN '' WHEN {x} > {y} THEN TO_CHAR({x} - {y}) /*Location to add units. */ ELSE '' END || '
' || CASE WHEN NVL({y}, 0) <= 0 AND NVL({x}, 0) > 0 THEN TO_CHAR({x}) /*Location to add units. */ END || '
' || /*If the values x and y are both null or 0, We display "No Goal!" on a grey background.*/ CASE WHEN NVL({y}, 0) <= 0 AND NVL({x}, 0) <= 0 THEN 'No Goal!' END || '
'

NetSuite Progress Bar CSS.HTML Code

Here is the plain CSS/HTML code that helps you customize the visual aspects of the NetSuite Saved Search Progress Bar more easily without all the .sql code present:

Get stuck in a step during this article?

We like to update our blogs and articles to make sure they help resolve any troubleshooting difficulties you are having. Sometimes there is a related feature to enable or field to fill out that we miss during the instructions. If this article didn't help you resolve the issue, please use the chat and let us know so that we can update this article!

Hopefully, this post gives you something to work with while trying to understand NetSuite and what it can do for your business. If you have any questions and want some free consulting advice, feel free to contact our team. Anchor Group is a certified NetSuite Partner, and our crew of consultants and developers is equipped to help with all kinds of NetSuite projects, large or small!

Contact Us

Tagged with Training, Solutions