These are the steps you need to following in order to install the Spawtz RMS integration components.


1) Install Microsoft Dynamics RMS as per their installation instructions.  While doing the installation, make a note of the computer name that the RMS database is installed on, and the name of the database and the username and password used to access that database.


2) Configure RMS to contain all the items that you will be offering for sale, as per the instructions in RMS, and do any other configuration (setting up the touch screens, setting up the cash registers etc).


3) Add the Spawtz specific items to RMS.  The Spawtz specific items are:

 a) Fixture fees

 b) Booking fees

 c) Ad hoc team or user payments


These Spawtz specific items are the items that the point of sale operator will select when someone comes up to them at the reception desk and says that they want to pay their fixture fees, or that they want to pay for a booking, or to make a payment for a membership or any other item on their Spawtz statement.  In the next steps we will configure the integration so that when they select one of the above items, the appropriate Spawtz integration screen will appear and allow them to select the actual fixture or booking, team or user that the payment is being made for.



Once the above steps have been performed once (ie to install and configure the RMS database), you must then follow the steps listed below on each and every RMS Point of Sale computer at your arena:


4) Download and run the following utility.  When asked if you are sure you want to run it etc, click "Yes" or "OK":


http://www.spawtz.com/POSIntegrationConfigurationManager/setup.exe


5) Follow the steps in the installation package above to install the Spawtz POS Integration Configuration Manager.


6) Once the Spawtz POS Integration Configuration Manager has been installed, run it.  By default, an icon for the Spawtz POS Integration Configuration Manager will have been added to the desktop and to the start menu, so run it from either of those locations.


The Spawtz POS Integration Configuration Manager collects all the information necessary to allow RMS to communicate with Spawtz and vice versa.  You will have to run this configuration manager on each POS machine, but you should only need to enter most of the information once.


7) On page one of the Spawtz POS Integration Configuration Manager, select "RMS" as the type of installation and click "Next ->"


5) On page two, enter all the information about the RMS database that you gathered in step 1 above, including the server name, the database name, the database username and the database password.  When that information has been entered, click "Test Database Connection".  The configuration manager will then attempt to connect to the database, and to ensure that the database is an RMS database.  Once that has happened, the "Next ->" button will become enabled and you will be able to proceed.  If the configuration manager is unable to connect to the database, it will display some information about why that was not possible.


8) Click "Next ->" to proceed to page 3


9) On page 3, you must enter your Spawtz license details.  You will have been provided with a license file, and a license secret to go along with that file.  Save the license file to somewhere on the disk or the network that is accessible by this POS machine.  Then click "Browse" and browse to the location of that file, select it and click "Open".  Enter the license secret that you were provided with and then enter the details of the site where your Spawtz online control panel resides (this will be something like "https://mysitename.spawtz.com".  You can enter simply "mysitename" and the configuration manager will format the rest of the url for you)


10) Click "Test Spawtz Connection".  The configuration manager will then attempt to contact the Spawtz installation at the site you entered and will validate the license and license secret combination with that Spawtz installation.  Note that all POS machines must have access to the internet in order for the Spawtz integration to work, so this test must be performed on all POS machines.


11) Once the Spawtz connection has been tested successfully, the "Next ->" button will become enabled.  Click "Next ->" to proceed to page 4.


12) On page 4, you must tell the configuration manager which items in RMS correspond to which Spawtz items.  In step 3 above, you created the RMS items that will be used by POS operators when users want to make a Spawtz payment.  On page 4, you should select the items that you created from the drop down menus accordingly.  For example, if you created a "Fixture fee" item in RMS that you want to be the item that POS users select when a customer wants to pay for a fixture fee, then you should select "Fixture fee" from the drop down list next to the label "Fixture Item :".  Do the same for the booking item and the Ad Hoc Item.  Then click "Next ->"


13) on page 5, you will see a summary of all the configuration information you entered in the previous 4 pages.  Check that all the information is correct, and then click "Configure and Install"


14) The configuration manager will then perform the following steps:

 a) It will add the database information you entered into the registry on the local machine

 b) It will create the Spawtz specific database tables necessary for integration to the RMS database

 c) It will add the license information that you entered into the Spawtz database tables on the RMS database

 d) It will add the Spawtz item to RMS item correlations that you specified into the Spawtz database tables on the RMS database

 e) It will download the required Spawtz RMS integration modules from the internet, install those on the POS machine, and then add the required RMS hooks to the registry to ensure that the Spawtz screens are displayed when the Spawtz items are added to the database


When the configuration manager has completed its work, it will report the outcome of the actions above, and give you a link to a log file detailing that outcome.  If any errors occurred, you should send the contents of that log file to Spawtz.


Once configuration has been completed, you can now use the RMS POS application to accept payments and when you select a Spawtz item, the Spawtz integration screens will appear to allow you to select the appropriate Spawtz item to add to the bill, and when you complete a transaction, RMS will inform Spawtz of the transaction so the user or team statement can be updated in Spawtz.


You must perform steps 4 to 14 on all of the POS machines at your arena, but you will only have to enter most of the data on the first machine.  You must enter the database details on all machines, but once the database data has been added, the rest of the configuration information is read from the database.  The Spawtz connection test must still be performed on each machine, but it is not necessary to add the license information to each machine, as this information is stored in the RMS database.