Background Color:
 
Background Pattern:
Reset
Search
EMUE Dashboard Online Quick Reference

Introduction:

Welcome to the EMUE Dashboard, Databound Solution's premier tool for monitoring multiple scripts across many PCs. With the EMUE Dashboard you can:

  1. Reduce time spent managing scripts
  2. Detect problems with scripts faster
  3. Detect when a script hasn't run when planned

These three benefits should decrease the amount of time you spend managing your script workload, while also helping the increase the speed and accuracy with which you are able to respond to issues. You can even check it from your smartphone!

Getting Started

There are several tasks you will most likely be performing on a daily basis, and this guide will help you get started quickly. The tasks we will cover in this manual are:

  1. Checking on scripts
  2. Identifying and handling script errors
  3. Identifying and handling scheduled scripts
  4. Reviewing log files with the dashboard
  5. Adding and managing dashboard user accounts
  6. Scheduling scripts in the Dashboard

Click on the headers below to view the sections of the Quick Reference.

Checking on Scripts

Once your dashboard has been created and your systems have been assigned to the dashboard you are ready to check on scripts that are running on one or all of the systems. If you have not yet signed up for the dashboard, contact Databound support for assistance.

Filtering your View

On both the System and Script views you will find a filters section as shown below. You can access this menu by clicking on the upward-facing arrow to the right of the screen.

Within this view we are able to tell the dashboard what statuses to display and which to hide from view.

There are three sections with which we can interact: Displayed Statuses, Hidden Statuses, and Script Category.

  • Displayed Statuses – have labels for statuses that will be shown when viewing the dashboard. You can remove statuses from this field by clicking on the minus sign (-) on the right of the label
  • Hidden Statuses – have labels for statuses that will not be shown when viewing the dashboard. You can choose to add these statuses back to the dashboard view by clicking on the plus sign (+) on the right of the label
  • Script Category – allows the user to type in an existing category label to sort for that category alone. Categories can also be added from this location by clicking on the “Add Category” button located to the right of the script category text box. For more about categories, see "Add Category" in the Managing User Accounts section of this guide.

Using these filtering options can help users quickly identify only the scripts they wish to see.


System View

Below the filters section is the scripts section of the page. In addition to holding the script information, there are many other key functions available here. See more information about the numbers listed after the picture.

 

 

While in the system view, we can see all of the scripts that are active on a particular computer or server. This is useful for managing one computer at a time.

  1. Within this view we have the option to view scripts that are running today, or have run in the past. You can choose between these two options with the “Today” and “History” tabs at the top of the view.
  2. We can also choose how many scripts we want to see on the page by changing the number listed in the “Show Entries” box just below the Today and History tabs. This allows you to view up to 100 scripts on the same page.
  3. We can also control the view further with the use of our Auto-Refresh switch. When this switch shows “On” scripts will update once a minute. If this is changed to “Off”, script updating will be turned off; however, the user can still update the scripts using the refresh button to the right of the switch.
  4. Next, when we need to find a specific script we can use the search function. This will search through all columns of each script for the word or words provided. For example, if I entered the word “Error”, the dashboard will find all scripts that have the status of “Error”.
  5. In the main area of the scripts view there are currently 9 columns. They are:
    1. Status Image – A quickly recognizable image of the status of a script
    2. Status – Word that describes the current state of a script
    3. Process Name – Name of the EMUE script that is reporting to the dashboard
    4. Input File – If the script uses an input file it will be listed here
    5. Expected Start – If the script is scheduled it will have an expected start time
    6. Actual Start – The time the script began to execute
    7. Completion – The time that the script completed
    8. Processed Records – If the script is reading from an input file, then this will record the number of records
    9. Exceptions – Using the &ExceptionCount built-in variable in EMUE, the dashboard can report a numeric value of exceptions which will be shown here
  6. Using this icon you can remove any of the columns listed above. Simply unclick the box next to the column you would like to exclude from the view.
  7. With the gear icon you can change the name (system alias) of the system you are currently working on. Simply click the icon and enter the new name and click “OK”
  8. Navigate between different pages of the dashboard with the Previous, Next, and number buttons on the bottom right of the screen.

Script View

We can access the script view from the menu on the left side of the screen. If this menu isn’t expanded, you can expand the menu by clicking the right facing arrows at the top left of the screen as shown here.

This view shows all scripts registered to the Dashboard across all systems. This option is helpful when managing multiple PCs or multiple locations, and when searching for specific messages (e.g. “Error”) across all PCs. This view has the same options as the System View; however, it contains all of the scripts available to the dashboard user and an additional column to identify the system that the script is running on.


Schedule View

In the schedule view we can see all of our scheduled, upcoming scripts on a calendar.

The schedule view looks different from the two previous views, and has a variety of options.

In order to view the scripts that are scheduled on a specific system we must select that system from the right of the screen under the “Dashboard Systems” header by clicking the checkbox next to the correct name.

Note: If there are multiple systems available to the dashboard, you can select any or all of the systems to simultaneously view the scheduled scripts.


There are four ways of interacting with the schedule view. They are:

  1. Using the left and right arrow selection buttons on the upper left side of the screen. Clicking these will increase or decrease the date range by one unit (Month, Week, Day)
  2. Selecting how many days you see in the view. This can be one month, one week, or one day at a time. Simply click on the appropriate unit at the top of the view to change the display.
  3. Selecting one or more systems to change the display. This is useful when determining when scripts should be scheduled to run.
  4. Double clicking on any script schedule in this view to access script options.

Reviewing log files with the Dashboard

With the EMUE Dashboard, we have access to the script’s log files directly from the Dashboard

To access a log, first navigate to the system or script view. Next, click on a script to open its menu.

From the expanded view, click on the details button to see all of the log files associated with the script.

Right clicking on the blue file name allows us to copy the link and paste it into Windows Explorer to open the file in windows.

If the file to review is a simple text file (.txt), we can right click on the log and select “Open link in new tab”, and the contents of the file will be displayed in a new browser tab.

This saves time navigating through multiple file folders to find the information we are looking for.

Identifying and handling script errors

Once a script has been identified as being in an error state, several things will change in the Dashboard.

  • The status icon will change to a red circle with an exclamation point.
  • The status word will change to “Error”
  • The row will turn red

Once an error is spotted, we should follow the steps below to resolve the error:

  1. Review the script’s logs (if applicable) to see if adjustments need to be made to the script or process. Reviewing the logs first may prevent the user from having to access the host PC or server in order to resolve the issue.
  2. If necessary, review the EMUE script on its host PC to correct the error
  3. Return to the EMUE Dashboard and in the system or script view, click on script showing an error status
  4. Click on the checkbox next to the error status under Script Actions
  5. Click the “Mark All Errors As Resolved” button to clear the row color and change the status to “Error (Resolved)”

By completing these actions, you can keep track of errors which have been resolved and those which are still outstanding. This will not affect changes in the script, only in how it is displayed in the dashboard.

Identifying and handling scheduled scripts

We have the ability to see scripts that are scheduled to run today as well as scripts that were scheduled, but did not run when they were supposed to.

There are a couple of noticeable differences between a script that’s running and one that is scheduled. These differences include:

  1. Clock status icon
  2. Status word of “Scheduled
  3. A date and time in the expected start time column

Missed Scheduled Start

If for some reason a scheduled script doesn’t start when it is expected to (server is offline for maintenance, PC is turned off, etc.) then the Dashboard will let us know by changing the scheduled line.

Once a script is identified as having missed a scheduled start, the row is colored yellow, and the icon now has a yellow triangle that indicates that the script has failed to start.

This row will give us the information necessary to act on scripts that haven’t run.

Adding and managing Dashboard user accounts

To access user account information, start by clicking on the “Manage Dashboard” menu item on the right side of the Dashboard.

On this screen we have 7 options that we may need to change occasionally. They are:

  1. Add User
  2. Remove User
  3. Edit User Role
  4. Alias System
  5. Set Timezone
  6. Add Category
  7. Remove Category

Add User

To add a user to the Dashboard, first click on the “Add User” button on the Manage Dashboard screen. This will bring up a popup that will ask us for two pieces of information – The user name and the new user’s role.

  • The User Name should be the new user’s email address (ex. newuser@hospital.org)
  • The role should fit the user’s main dashboard usage role as outlined below:
    • Dashboard Admin – Create users and alter dashboard settings for scripts
    • Dashboard User – Change dashboard settings for scripts (this does not alter the EMUE scripts themselves)
    • Dashboard Readonly – can view the dashboard and change their personal view, but cannot make changes to dashboard script settings or users

"Script Settings" refer to any settings that can be changed for individual scripts and script views in the dashboard. This does not have an effect on the scripts themselves.

Once you have completed those two fields, click okay to send the new user an email with a link to begin using the dashboard.


Remove User

As individuals leave the organization or transition to other roles, you may need to remove users from the EMUE Dashboard.

In order to remove a user, simply click on their name under the Users category. Once selected, click on “Remove User” to remove them. After clicking the button, a confirmation popup will appear asking you to confirm your desire to delete the individual. Click “OK” and the user is removed from the Dashboard.


Edit User Role

Individuals may need to have their access to the dashboard adjusted from time to time for increased or decreased access to the dashboard without removing them completely. This can be accomplished by editing their role.

To edit a role, first select the individual whose access you need to augment, then click the “Edit User Role” button.

After clicking the button, a popup will appear confirming the individual’s user name and current access. At this point you can select a new role for the user and click “OK” to confirm the new role.


Alias System

Another function available to Dashboard Admins is the ability to give a system a recognizable name by aliasing a system.

Once a system has an alias, it will be shown as that name on the system view mentioned earlier. This can help quickly identify a PC.

To Alias a system, first select the system you would like to name, and then click on the “Alias System” button. A popup will appear that allows you to enter a name that will be assigned to the system.


Set Timezone

If necessary, a Dashboard Admin can change the time zone associated with the dashboard. Usually this option will not need to change after the dashboard has been set up.

To set a time zone, first select a system, the click the “Set Timezone” button. Select the desired time zone from the dropdown list and click “OK” to save the change.


Add Category

Sometimes it is necessary to group scripts together for reviewing purposes. To do so, categories can be created and assigned to scripts on a script-by-script basis.

In the Manage Dashboard screen a Dashboard Admin can create additional categories by first clicking the “Add Category” button. Once clicked, a popup will ask the user to input a new label name. After the name is typed into the text box, click “OK” and the label will be added to the Custom Script Categories. This action can also be completed in the filtering section of the System and Script views.

This will add category labels that can be used on scripts. Users can then assign the categories to a script in the following ways:

System View

Script View

Schedule View

Manage Scripts Menu

1) Select Script

2) Click on the Settings gear

3) Type the categories to assign into the Script Category Text box.

4) Click Save

1) Select Script

2) Click on the Settings gear

3) Type the categories to assign into the Script Category Text box.

4) Click Save

1) Double click on script schedule

2) Click on the Manage Script button

3) Type categories into the Script Category Tag text box

4) Click Save Changes

1) Click the Manage Scripts Menu option

2) Select the system (PC) from the System dropdown

3) Choose the script from the Script dropdown

4) Type categories into the Script Category Tag text box

5) Click Save Changes

 

Remove Category

If a category is no longer being used, it can be removed with the “Remove Category” button.

To remove a category, first select the category from the Custom Script Categories list, then click on the “Remove Category” button. A popup will appear asking you to confirm that you wish to delete the category. Once you click “OK”, the label will be removed and will no longer be associated with any scripts.

Scheduling scripts in the Dashboard

Script Schedules

The EMUE Dashboard allows users to view and interact with script schedule views for EMUE script executions. Once a script has been written and scheduled in the Windows Task Scheduler, EMUE can report script schedules to the dashboard.

Adding Scheduled Scripts to the Dashboard

Once a script is written and scheduled in the Windows Task Scheduler, there are three ways of importing script schedules into the dashboard. They are:

  1. Running the script from the new task in Task Scheduler
  2. Sending scripts manually from the EMUE Dashboard registration tool in EMUE
  3. Letting the task automatically run for the first time

To add a schedule by running a task from the task scheduler. Follow the steps below:

  1. Open Task Scheduler
  2. Find the scheduled task
  3. Right-click the task
  4. Select “Run”

In order to display a script’s schedule in the schedule view without running it, run the EMUE Dashboard registration tool directly from EMUE. To do so:

  1. Open EMUE
  2. Open the “Tools” Menu
  3. Select “Launch Host Dashboard Maintenance”
  4. Enter your Username and Password
  5. Click “Logon”
  6. At the bottom of the screen, click “Send Script Schedules”

The system will report “Beginning transfer of EMUE script schedules”, and then “All EMUE script schedules have been reported to the dashboard.” once the process is complete.

If you do not need to see the schedule immediately, you can also let the script run automatically. This will allow EMUE to poll the Task Scheduler for future script schedules. These schedules will show up in the script view after the first run of the script.


Adding Manual Schedules to the Dashboard

Often times a script will be launched from another EMUE script or batch file. In these instances, no Task Scheduler task would be present, and therefore no task would be reported to the dashboard.

In this case we can manually add a schedule to the Dashboard to represent the script’s normal processing time.

Note: This will not add a scheduled task to the task scheduler.

To add a manual schedule to the EMUE Dashboard, follow the steps below:

  1. Open the EMUE Dashboard
  2. Click the “Manage Scripts” menu on the left side of the screen
  3. Select a system (PC) from the dropdown box
  4. Select a script (this is not available for bulk script changes)
  5. Change the “Define predicted schedule for script” button to “On”
  6. Select when the script runs (Daily, Weekly, Monthly)
  7. Complete the necessary information:
    • Daily:
      1. Task Name
      2. Start
      3. Recur every X days
      4. Repeat task (optional)
      5. Every (interval) (optional)
      6. For a duration of (interval) (optional)
    • Weekly:
      1. Task Name
      2. Start
      3. Recur every X days
      4. Day(s) of recurrence
      5. Repeat task (optional)
      6. Every (interval) (optional)
      7. For a duration of (interval) (optional)
    • Monthly:
      1. Task Name
      2. Start
      3. Month(s) of recurrence
      4. Day(s) or weeks of recurrence
      5. Repeat task (optional)
      6. Every (interval) (optional)
      7. For a duration of (interval) (optional)
  8. Click “Ok”

Completing these steps will create a schedule placeholder in the schedule view.

 

Viewing Scheduled Scripts

Once a script is scheduled and reported to the Dashboard, it is possible to view the script in the EMUE Dashboard on the Schedule view.

To access the schedule view, click on the schedule view link on the left of the dashboard, and once the page loads, select the systems that you wish to view.

By default this view shows one week worth of schedules. In order to change the amount of time visible in the schedule view, select “Month”, “Week”, or “Day” from above the calendar view. This will return the scheduled scripts from within the selected interval.

It is also possible to navigate between different dates by clicking on the right or left arrows above the calendar view to go forward or backward through dates, respectively. For example, with a weekly view selected, clicking on the right arrow will advance the view by one week, showing next week’s scheduled scripts.

After moving away from today’s view, click the “Today” button to return the view to today’s date.

Scheduled scripts can also be viewed on the System View and Script View screens. Only scripts that are scheduled for today will be visible, and can be located on the “Today” tab.

 

Individual Script Schedules

Scripts that are reported to the dashboard are displayed as a colored bar in the schedule view. This bar includes the time it is scheduled to run (expected start and expected end), and the name of the process.

The bar’s size is also changed based on the amount of time the script will take to process. This can be used as a visual indicator of free and scheduled time when scheduling additional scripts.

The schedule’s predicted time is based on the average time the script takes to process, therefore it will accurately reflect the time needed to process each individual script.

 

Script Schedule Settings

From the schedule view it is possible to access a script’s settings. To access the settings window, click on the script’s schedule bar displayed in the schedule view. This opens a new window that allows you to view details about the script’s schedule, including:

  1. Expected Start
  2. Expected End
  3. Script Name
  4. Script Path/Location
  5. Task Name
  6. Task Type (Daily, Weekly, Monthly)
  7. Task Description (when it will run)

The screen also allows changes to the script, including the addition of user defined note information as well as the ability to hide script executions.

User defined information allows users to enter short notes about the process, while hiding script executions will remove the script from view on the dashboard.

Clicking “OK” will save any changes and close the Script Schedule Settings window.

Online Interface Express™ (OLIE), SIGNATURE®, Millennium®, INVISION®, Soarian®, and Med Series4® are trademarks or registered trademarks of Cerner Corporation.