Skip to main content

Resolving Connect Messages

Kevin U
  • Updated

About Resolving Connect Messages

If a Connect message from an EHR contains data in the form of a person, room, allergy or diet order that is not mapped to a corresponding MealSuite entity (person, room, allergy, diet order), then the Connect interface cannot process the message. Therefore you are required to resolve the message by mapping the unmapped data. When there are messages that require resolving, the following occurs:

Resolving Mapping Issues on the Connect Mapping Screen

To open the Connect mapping screen to resolve mapping issues, complete the following steps:

  1. From the left navigation sidebar, select People > Connect. A message appears to inform you of the number of Connect messages that require resolving. 

    message_alert_unresolved.png
     
  2. Click the Go To Mapping button (first screenshot below). The Mapping screen appears (second screenshot below). 

    mapping_button.png

    mapping_screen.png
     
  3. Click the tab at the top of the panel for the entity mapping relationships you want to view: People, Rooms, Allergies, Diet Orders. The mapping table appropriate to the entity appears, listing the EHR entity on the left and the mapped entity in your account on the right.

    Any unmapped entity appears at the top of the table, with the MealSuite Data highlighted red with the Unknown text. The example below shows an unmapped room.

    unknown_room.png
     
  4. Refer to the articles below to resolve specific data mapping issues:

Resolving an Unmapped EHR Resident/Patient on the Mapping Screen

For an unmapped EHR resident/patient on the Mapping screen, the following options are available from the Person Name drop-down:

person_name.png

  • Create New person - you can create a new resident/patient profile in your account using the EHR data by selecting Create New Person from the drop-down, and then clicking the Save button at the top right of the screen. 

  • Ignore Person -  you can have the system ignore the message for the resident/patient and all future messages for that resident/patient by selecting the Ignore Person option. Upon selecting this option, the following confirmation message appears: 

    map_to_ignore.png

Resolving an Unmapped EHR Room on the Mapping Screen

For an unmapped EHR room on the Mapping screen, the following options are available from the Main Building | Area | Room | Bed drop-down:

  • Create New Room  - you can create a new room in your account by selecting using the EHR data by selecting Create New Room, and then clicking the Save button at the top right of the screen. The new room is automatically entered into your facility builder hierarchy and automatically assigned to the resident/patient profile. 
  • Ignore Room - If the EHR room is a room that you do not serve food to (such as an emergency room or outpatient room), then you can select Ignore Room from the MealSuite Room drop-down, which will apply the Ignored Room status to the person's profile.

    When a person has the Ignored Room status, they will not be included in people reports and production reports, and as such are not served during meal periods and snack times.

    ignore_room_2024.png
    When selecting the Ignore Room option, the following message appears:
map_to_ignore_room.png

Note the following:

  • If a transfer or admit message is received for a person with the Ignored Room status, then the person's status is changed to Active and their room will be updated to the new room.
  • Diet order, allergy, and demographic messages for a person with the Ignored Room status will continue to be processed.
  • If a person is currently active in the system, and a transfer patient message is received for that person containing a room that is ignored in your account, then the person will be put into the Ignored Room status and their room will be updated to the ignored room.
  • To see how a resident/patient profile appears when it is ignored in your account, see Viewing Profile with an Ignored Room. 

The Auto-Map Rooms Option

On the Rooms tab of the Connect Mapping screen, the Auto-map rooms option is available (screenshot below): 

  • With this option selected, the system will attempt to automatically map an EHR room to an existing room room in your account by looking first at the residence area name and then deducing the room and bed by looking at other existing mapping selections in that residence areas. 
  • With this option not selected, no auto-mapping is attempted, and you will be required to manually map each room. 

    auto_map_rooms.png

Note: The Auto-map rooms option does not create rooms in your account. 

Resolving an Unmapped EHR Allergy on the Mapping Screen

For an unmapped EHR allergy on the Mapping screen, the following options are available from the Allergen Group Name drop-down:

allergy.png

  • Create New Allergy - you can create a new allergen group in your account by selecting Create New Allergy from the drop-down, and then clicking the Save button at the top right of the screen. You will also be required to open the allergen group and add the food items to it, as indicated by a message that appears (below) when clicking Save; to add food items to an allergen group. See Adding Food Items to an Allergen Group. 

    allergen_group_created.png
     
  • Map the EHR allergy to an existing allergen group in your account - from the drop-down, select an existing allergen group in your account to map the EHR allergy to. Note that more than one allergen group can be selected if considered appropriate. 
  • Ignore Allergy - you can ignore the EHR allergy by selecting Ignore Allergy from the drop-down. When the EHR allergy is set to ignore, it is not mapped to an allergen group in your account and any subsequent messages with that EHR allergen will be ignored by the Connect interface.

    map_to_ignore_allergy.png

Resolving an Unmapped EHR Intolerance on the Mapping Screen

For an unmapped EHR intolerance on the Mapping screen, the following options are available from the Allergen Group Name drop-down:

intolerance.png

  • Create New Intolerance - you can create a new preference group in your account by selecting Create New Intolerance from the drop-down, and then clicking the Save button at the top right of the screen. You will also be required to open the preference group and add the food items to it, as indicated by a message that appears (below) when clicking Save; to do so see Preference Group: Adding Ingredients, Prepared Foods, Recipes. 

    allergen_group_created.png
     
  • Map EHR Intolerance to an existing preference group in your account - from the drop-down, select an existing preference group in your account to map the EHR intolerance to. Note that more than one preference group can be selected if considered appropriate. Once selected, the system will then automatically mark that preference group(s) as DNS in the personal menu for the resident/patient profile.
  • Ignore Intolerance - you can ignore the EHR intolerance by selecting Ignore Intolerance. When the EHR intolerance is set to ignore, it is not mapped to a preference group in your account and any subsequent messages with that EHR intolerance will be ignored by the Connect interface.

    map_to_ignore_allergy.png

Resolving an Unmapped EHR Diet Type on the Mapping Screen

For an unmapped EHR diet type on the Mapping screen, the Diet Order Component drop-down reads Diet by default (first drop-down in the MealSuite Data section). From the Diet Order Type drop-down, select the diet type to map the EHR diet type to (second drop-down in the MealSuite Data section). Click Save to apply your changes. 

diet_type_mapping_screen.png

Note: If your EHR is PCC, then there is the ability to apply flexible mapping to a diet order. For more information and instructions, see PCC Connect Interface Only: Flexible Mapping for a Diet Order.

For an unmapped EHR diet type on the Mapping screen, you also have the option to map it to a diet intervention. To do so:

  1. From the Diet Order Component field (first drop-down in the MealSuite Data section), select Diet Intervention.
  2. From the Diet Order Type field, select the diet type (second drop-down in the MealSuite Data section), select from one of the following options: 

    diet_diet_intervention_mapping_screen.png
     
    • Create New Diet Intervention - you can create a new diet intervention in your account by selecting Create New Diet Intervention from the drop-down, and then clicking the Save button at the top right of the screen. You will also be required to open the diet intervention and add customizations to it; to do so see Modifying a Diet Intervention.
    • Map EHR Diet Intervention to existing diet intervention - from the drop-down, select an existing diet intervention in your account to map the EHR diet intervention to. Note that more than one diet intervention can be selected if considered appropriate.
    • Ignore Diet Intervention - you can ignore the EHR diet intervention by selecting Ignore Diet Intervention. When the EHR diet intervention is set to ignore, it is not mapped to a diet intervention in your account, and any subsequent messages with that EHR diet intervention will be ignored by the Connect interface.
  3. Click Save to apply your changes. 

Resolving an Unmapped EHR Texture Type on the Mapping Screen

For an unmapped EHR texture type on the Mapping screen, the Diet Order Component drop-down reads Texture by default (first drop-down in the MealSuite Data section). From the Diet Order Type drop-down, select the texture type to map the EHR diet type to (second drop-down in the MealSuite Data section). Click Save to apply your changes. 

texture_mapping.png

Note: If your EHR is PCC, then there is the ability to apply flexible mapping to a diet order. For more information and instructions, see PCC Connect Interface Only: Flexible Mapping for a Diet Order.

Resolving an Unmapped EHR Fluid Type on the Mapping Screen

For an unmapped EHR fluid type on the Mapping screen, the Diet Order Component drop-down reads Fluid by default (first drop-down in the MealSuite Data section). From the Diet Order Type drop-down, select the fluid type to map the EHR diet type to (second drop-down in the MealSuite Data section). Click Save to apply your changes. 

fluid_mapping.png


Note: If your EHR is PCC, then there is the ability to apply flexible mapping to a diet order. For more information and instructions, see PCC Connect Interface Only: Flexible Mapping for a Diet Order.

Resolving an Unmapped EHR Diet Intervention on the Mapping Screen

  1. For an unmapped EHR diet intervention on the Mapping screen, the Diet Order Component drop-down reads Diet Intervention by default (first drop-down in the MealSuite Data section). From the Diet Order Type drop-down (second drop-down in the MealSuite Data section), select from one of the following options: 

    intervention_intervention_mapping.png
     
    • Create New Diet Intervention - you can create a new diet intervention in your account by selecting Create New Diet Intervention from the drop-down, and then clicking the Save button at the top right of the screen. You will also be required to open the diet intervention and add customizations to it; to do so see Modifying a Diet Intervention.
    • Map EHR Diet Intervention to existing diet intervention - from the drop-down, select an existing diet intervention in your account to map the EHR diet intervention to. Note that more than one diet intervention can be selected if considered appropriate.
    • Ignore Diet Intervention - you can ignore the EHR diet intervention by selecting Ignore Diet Intervention. When the EHR diet intervention is set to ignore, it is not mapped to a diet intervention in your account, and any subsequent messages with that EHR diet intervention will be ignored by the Connect interface.
  2. Click Save to apply your changes. 

For an unmapped EHR diet intervention on the Mapping screen, you also have the ability to map it to a diet type. To do so:

  1. From the Diet Order Component field, ensure Diet is selected. 
  2. From the Diet Order Type field, select the diet type. 
  3. Click Save to apply your changes. 

    intervention_diet_mapping.png

Resolving Connect Messages from the Connect Screen

To resolve Connect messages from the Connect screen, complete the following steps:

  1. From the left navigation sidebar, select People > Connect. A message appears to inform you of the number of Connect messages that require resolving. 

    message_alert_unresolved.png
     
  2. Click the Resolve Later button to stay on the Connect screen, where messages waiting to be resolved are listed with the Action Needed button. 

    Connect_screen_resolve_messages.png

    Also note that the number of unresolved messages is indicated with a count indicator overtop the Mapping button.

    mapping_badge.png
     
  3. For a message to be resolved, click its Action Needed button. A pop-up specific to the data mapping issue appears. For the pop-up that appears, refer to its associated article below for options to resolve its data mapping issues: 

Resolving Connect Messages from the People Listing Screen

If your account is enabled with a Connect interface to your EHR, then when a profile has an unresolved message from the EHR, a red Connect alert label is displayed in the Alerts column.

resolve_acknowledge_people_listing.png

Hovering your cursor over the alert displays "Unresolved Connect Messages".

unresolved_connect_message_hover.png

To resolve a Connect message from the People Listing screen, click the resident/patient name. A pop-up specific to the data mapping issue appears. For the pop-up that appears, refer to its associated article below for options to resolve its data mapping issues: