Tuesday, October 16, 2018
How to fix RITE Gift Compatibility Issues with Other RMS Plug-ins

Overview

There have been a number of reported incidents where RITE Gift stops functioning properly if another RMS plug-in payment method is present (such as a Credit or Gift Card processing plug-in).  This problem occurs because not all of the caveats of RMS Plug-in Development are being followed properly by the other plug-ins or in some cases, the other plug-in has removed some of the settings used to tell RMS about RITE Gift.

Below we have listed two methods for attempting to fix this issue, please try Method A prior to Method B as the second is quite a bit more technical and involved..

Method A: Repairing RITE Gift - RMS Client

If the problem is that the other payment plug-in has removed RITE Gift's RMS settings, this can be corrected by simply repairing the installation of RITE Gift - RMS Client.  To do this please follow these steps:
  1. Close out of both RMS Store Operations Manager and Point of Sale.
  2. Navigate to Start -> Control Panels.
  3. Open the Programs and Features control panel. (In older versions of Windows this will be listed as Add/Remove Programs).
  4. Find the listing for RITE Gift - RMS Client, and select it.
  5. Click the Repair option at the top of the window. (In older versions of Windows, there will be a Change button in the same row, instead click that button and choose Repair from the window that appears afterwards).
  6. Once the RITE Gift - RMS Client installer indicates the repair is complete, you can close any open windows and attempt to use the Plug-in again.

Method B: Reordering RMS Hooks in the Windows Registry

NOTE: This work-around involves making changes to the Windows Registry, which can cause problems with your computer if proper care is not taken.  Please follow these directions explicitly.  RITE is not liable for any losses or damages caused by following the instructions in this document.

To successfully get both plug-ins working properly, please follow these steps:
  1. Close out of both RMS Store Operations Manager and Point of Sale.
  2. Go to Start -> Run.
  3. In the Run window, type in "regedit" (without the quotes), and press OK.
  4. Navigate the keys on the left-hand side in the order HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Retail Management Systems\Store Operations\Hooks.  (On 64-bit machines the path will be HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Retail Management Systems\Store Operations\Hooks.)
  5. Expand the Hooks node, and you should see keys numbered 000 - 030.
  6. Click on each of the numbered keys started with 000 and look on the right-hand side for any node that has an ObjectName that begins with RITE.RITEGift.  (There should 3 of them in total.) These hooks should appear before any other plug-ins (or at least before the other payment plug-ins).
  7. If these hooks are NOT ordered before the other payment plug-ins, reorder the hooks so they are.  This can be done by copying the data from each field (Caption, Description, HookType, ObjectName and Parameter) and pasting them into another open hook higher up in the list.  Then clear out the data from the original hook.
Once you have reordered the hooks so all RITE Gift hooks come first, you will need to ensure your Hook Count is still valid.  To do this:
  1. Find the number of the last Hook where ObjectName is not blank.
  2. Now click on the Hooks node in the left-hand side.
  3. On the right-hand side should be a field called Count.
  4. Ensure Count is set to the number from step 1, plus 1.  (So if the last hook used was 028, Count should be 29).
You are now free to close out of the Registry Editor and open back up RMS Point of Sale.  RITE Gift should now be working with the other payment application.
Microsoft Dynamics Retail Management System

Home | POS Systems | Plug-In Directory | Custom DevelopmentSupport | Partners | About Us | Contact Us | Request Information

RITE - Retail Information Technology Enterprises - Experts in Retail Point of Sales Technology
Phone - St.Cloud, MN area: 320-230-2282, Minneapolis area: 612-216-1480 Chicago, IL area: 312-841-RITE (7483) Idaho/Utah: 208-994-9404
Toll free: 1-888-267-RITE (7483)
© RITE Enterprises, Inc 2006-2018 - All rights reserved