Versions Compared

Key

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

Anchor
Top
Top

Panel
titleColor#ffffff
titleBGColor#009cae
titleOverview

This guide is intended for customers who have MealViewer integrated with their Edison software. It will highlight the features and settings required to create an interface between MealViewer and Edison in order to digitally display menu information in your cafeterias.

...

.


MCS - MealViewer Integration Tutorial VideoVideo Table of Contents


Tip

You may follow along in the video using this Integration Guide.


View file
nameMCS_MV_Integration.mp4
height250
  • Introduction (0.00)
  • MealViewer Menu Groups (1:30)
  • MealViewer Blocks (3:50)
  • MealViewer Display Groups (6:32)
  • Mass Update (8:20)
  • Enable MealViewer Integration (9:30)
  • Enable Agent Mode (10:15)
  • Synchronize (11:35)
  • Conclusion (12:25)


Warning

All items within a recipe need to have all nutrition values established before you continue MealViewer Setup. To check the nutrition, please review Item Setup.


MealViewer Integration Setup (Optional)

Important Edison - MealViewer Configuration Steps

Info
titlePlease Note

Depending on your District, configurations may not be necessary. Please contact your Heartland consultant for more information.


MealViewer Menu GroupsMealViewer Display Groups
MealViewer BlocksMealViewer Menu and Display Groups Mass Update

...

Note

MealViewer Menu Groups, Blocks, and Display Groups are not required; however, they should be established before enabling Synchronization.


...

Required MealViewer Integration Setup (Required)
Enable MealViewer Integration
Enable Agent Mode
MealViewer Status & Sync


...

Anchor
MVMenuGroups
MVMenuGroups
MealViewer Menu Groups

MealViewer Menu Groups are "buckets" which allow you to categorize the different recipes served in a cafeteria. Set up the Menu Group names here.

...

  1. From the Admin & Maintenance tab, select Advanced Setup. Then, select MealViewer Menu Groups.
  2. Scroll to the bottom of the list and click on the cell next to the asterisk*.
  3. Enter the Menu Group. When finished, select Save Changes.

Assign MealViewer Menu Groups to your Recipes (if applicable)

Assign the MealViewer Menu Groups to your recipes on a menu (if applicable).

...

Info

In the example below, the Mexican PIzza and Black Beans over Rice are assigned to the "SouthWest" Menu Group, the Beef Teriyaki Dipper is assigned to the "Asian" Menu Group, and so on. Anything assigned to the "Default" menu group will be available at any line.

Expand
titleAssign / Reassign MealViewer Menu Groups to your Menus

Assign / Reassign MealViewer Menu Groups to your Menus (Menu Template Level)

Assign or Reassign the MealViewer Menu Groups to your recipes on a menu from the Menu Template level (if applicable).

  1. From the Recipes & Menus option, select Menu Templates.
  2. Select an existing template and click Edit.

  3. Select a menu and a calendar date to edit.
  4. Click the row in the MealViewer Menu Group column to assign or reassign a Menu Group.
    Image Added

Return to Top

...

Anchor
MealViewer Blocks
MealViewer Blocks
MealViewer Blocks

In MealViewer, Blocks determine at what time and location menus are displayed on digital signage and also how menus will be grouped within Digital Suite. They are configured within MealViewer; however, you are able to establish Blocks within Edison to be sent over with your menus when syncing with MealViewer. You can assign the Blocks to menus in the Menu Templates screen.

  1. From the Advanced option, select MealViewer Blocks.
  2. Scroll to the bottom of the list and click in the cell next to the asterisk*.
  3. Enter the Block. When finished, select Save Changes.
Info

If the Block you need for a menu is one of the existing Meal Types (Breakfast, Lunch, Snack), you do not need to add a Block.


Assign MealViewer Blocks to Menus (if applicable)

Blocks are displayed on the Menu Template Maintenance Screen under the MealViewer Block column (if applicable).

Note

The MealViewer Block column is only available if you have created Blocks in MealViewer Block Maintenance.


Anchor
MVMenuTemplates
MVMenuTemplates
Assign MealViewer Blocks to Menu Templates

Perform the following steps to assign a Block to an existing menu template.

  1. From the Recipes and Menus tab, select  AnchorMVMenuTemplatesMVMenuTemplatesMenu Templates.
  2. Select a menu template to edit.
  3. Select a MealViewer Block from the drop-down menu.

    Note

    The MealViewer Block drop-down menu is only available if you have created Blocks in MealViewer Block Maintenance.


  4. Click Save Changes when finished configuring your menu.

...

Expand
titleSelect Blocks when adding a menu to your Site Planning

You may select a MealViewer Block when adding a menu within your Site Planning.

Info

Recipes within a menu that come over to site planning will be assigned to the MealViewer Block associated with the menu.


  1. Select Menu Planning from your Home tab (a site must be selected).
  2. Select a menu from the calendar by double-clicking on the day.
  3. Select Add.
  4. Select Add a Menu.
  5. Select the menu that you would like to add to the Serving Plan.
  6. Select the MealViewer Block you would like to associate with the menu.

Return to Top

...

Anchor
MVDisplayGroups
MVDisplayGroups
MealViewer Display Groups

After you have put together your MealViewer Menu Groups and have assigned them to your recipes, you can create Display Groups.

Info
titleEstablishing MealViewer Display Groups

If you need to create multiple MealViewer Display Groups, proceed to MealViewer Display Groups Mass Update.


Info

Display Groups are the result of the assignment of MealViewer Menu Groups to a line. When the Menu Group is attached to a line with other Menu Groups, it is then communicated to MealViewer that this is how your menus should be displayed on your digital signage.

  1. From the Admin & Maintenance tab, select Site & Categories, then select Sites.
  2. Select a site and then select Edit Site.

  3. Select the checkbox of the MealViewer Menu Group which is associated with each line. 

    Info

    In the example below, the Line 1 Display Group will show recipes from the All American Line and the Hot Line. The Line 2 Display Group will show recipes from the Asian Line and SouthWest Line. The Line 3 Display Group will show recipes from the Gluten-Free Bar, Salad Bar, and the Vegan bar. The Line 4 Display Group will show all recipes which have not been assigned a Menu Group.

Return to Top

...

Anchor
MVMassUpdate
MVMassUpdate

MealViewer Menu Groups Mass Update

  1. From the Admin & Maintenance tab, select Recipes & Menus.
  2. Hover over Mass Update and then select MealViewer Menu Groups.

  3. Select a MealViewer Menu Group for each applicable menu

  4. When finished, select Save Changes.

    Tip

    Search for what you need on this page by pressing ControlF.


Image Added

MealViewer Display Groups Mass Update

The Mass Updates option allows you to easily apply changes to all sites affected by a change in MealViewer Display Groups.

...

  1. From the Admin & Maintenance tab, select Site Sites & Categories.
  2. Hover over Mass Update and then select MealViewer Display Groups.

  3. Edit the Display Groups by selecting the checkboxes of the MealViewer Menu Groups that you want to associate with each MealViewer Display Group.

  4. When finished, select Save Changes.

    Tip

    Search for what you need on this page by pressing ControlF on your keyboard.


...

Expand
titleRemove Display Group

Perform the following steps to remove a Display Group.

  1. Select the Display Group that you would like to remove. You may only select one Display Group at a time.
  2. Select Remove Display Group.
  3. Select Yes to permanantly delete the Display Group.

    Info

    After you select yes, the removed Display Group will turn red and have a line crossed through it.

  4. When finished, select Save Changes.
Menu-Level

...

  1. select 

...

Select a MealViewer Menu Group for each applicable menu

  1. Save Changes

...

  1. .

...

Return to Top

...


Anchor
MVIntegration
MVIntegration
Enable MealViewer Integration

The Mealviewer section  tab allows you to establish real-time communication with MealViewer.  In addition to establishing communication, safety checks are in place to ensure communication does not occur in the Edison database if copied into a test environment.

  1. From the Admin & Maintenance tab, select System Settings.
  2. Select the MealViewer tab to enable/disable MealViewer sources and configure MealViewer settings.

    Image RemovedImage Added

    MealViewer Server URL - Use the drop-down menu to select the URL of the MealViewer server.
    API Key - The MealViewer API Key for your District. Select Test Connection to ensure the connection between Edison and MealViewer is set up correctly.

    Enable MealViewer Integration - Place a checkmark in the box to enable MealViewer integration.
    Full-Refresh on Next SyncWhen checked, a Full-Refresh will be performed on the next sync.

    Info

    A Full-Refresh syncs all Site data for each Site.
    Note: Any words in italics indicate MealViewer Terminology.

    • Recipes (Items) including nutrition, allergens, and serving sizes.
      Note: Nutrition should always be recalculated for a recipe if items/ingredients have been changed.
    • Recipe Categories (Item Types)
    • Menu Count Types (Age Groups)
    • Site name
    • Menu planning data listed above (and in accordance with the Exclude 0 Planned Counts and Do Not Display Externally settings) including MealViewer Display Groups and MealViewer Blocks (if established).

    Sync Interval - Enter the number of minutes between synchronizations. To disable automatic synchronization, enter 0. By default, the system will send a MealViewer sync every 15 minutes.
    Synchronize Dates - Enter XX (the number of) days in the past (if you would like to send records for days prior to today) through XX days in the future - Enter the number of days in the future you would like to send records.
    Synchronize Sites - Use the ellipses icon to open the MealViewer Site Filter and establish sites for synchronization.

    Expand
    titleSynchronize Sites

    In the MealViewer Site Filter window, use the magnifier tool or drop-down menu to select a Specific SiteBy Category, or Named Site Filter. You may also select All Sites.

    Synchronize Meals - Select one or more meal types to sync.

    Safety Checks - Safety checks ensure communication does not occur if the Edison database is copied into a test environment.
    Expected SQL Server Instance - Enter the SQL server name used in your production environment. Use the drop-down menu to select how SQL Server should be compared to the running server.
    Normal - Use this option if you only have one SQL server that could be considered correct. The SQL Server instance must match the text entered verbatim.
    Reg. Ex. - You may use this option if you have multiple SQL servers that could be considered correct. The SQL Server instance must match the regular expression entered.
    Ellipsis - Clicking the ellipsis icon loads the information from the currently running SQL Server and quickly sets the correct values above for running in the current environment.

Return to Top

...

Anchor
EnableAgent
EnableAgent
 Enable Agent Mode


Warning

Prior to proceeding to the next step, Agent Mode must be enabled.  For MCS Cloud installations, the HSS support staff need to enable the Edison agent node for the district. For on-premise installations, agent mode is enabled in Admin Console.


  1. Right-click on the Admin Console icon and select Run as Administrator, then log in to the system.

  2. From the Applications drop-down menu, select Connection Methods. Double-click on Edison and select the checkbox to Enable MCS Agent for this Application. Click Ok, then choose Close in theConnection Methods window.

    Warning

    Do not close Admin Console within proceeding to step 3 and 4.


    Note

    The service must be stopped and restarted in order for changes to take effect.


  3. From the Server Admin drop-down menu, select Service Control and then select Stop Service. Click Ok once service has stopped.
  4. From the Server Admin drop-down menu, select Service Control and then select Start Service. Click Ok once service has started.
  5. When finished, close Admin Console.

Return to Top

...

Anchor
MVSync
MVSync
Synchronize MealViewer with Edison

This Option allows you to view the status of your MealViewer sync and to also perform a manual sync between Edison and MealViewer.

...

Details - Shows sync status information.
        Complete - The processing of the sync request succeeded. MealViewer should reflect the newly synced data.
        Pending - The sync request is still processing and will need more time to complete.
        Failed - The processing of the sync request failed. No changes will be visible in MealViewer. Click Sync Now to try the sync again.
Last Completed Sync - Shows the date and time of the last completed sync.
Last Attempted Sync - Shows the date and time of the last attempted sync.
Next Expected Sync - Shows the date and time of the next expected sync.
Sync Now - Select this button to run a manual sync and send any changes to MealViewer. You will see a series of processes as synchronization is completed.

Info

When Full-Refresh is enabled, you may use the calendar tools to select a date range for the sync. When a date range is selected, MCS will only send data within the specified date range.
Note: You may only select up to a 30-day date range.
Image Added

Return to Top