1. Configuration Guide
  2. XProcessor Gift Cards and Plug-ins
  3. ValueLink Processor
  4. Configuring the ValueLink Processor Content Files

Configuring the ValueLink Processor Content Files

Before configuring the ValueLink Processor plug-in, you must ensure that the XProcessor Extension Application is installed and configured. Setting Up the XProcessor Framework contains more information.

The instructions in this topic explain how to add the following files to the Content module in the EMC:

Table 50-6 ValueLink Processor Content Filenames and Descriptions

Filename Description

ValueLinkProcessor.valuelink

ValueLink Processor configuration.

ValueLinkHostDefault.valuelink

ValueLink Processor connection configuration defined at the Enterprise level, and applies to any property in the Enterprise. This file does not require modifications for each property.

This file and the ValueLinkHost.valuelink file both control the connection settings between the workstations and the ValueLink host.

ValueLinkHost.valuelink

ValueLink Processor connection configuration defined at the Enterprise level. Can be overridden at the property or revenue center level with property-specific values.

ValueLink2Settings

ValueLink2 DLL configuration.
  1. Select the Enterprise level, click Setup, and then click Content.
  2. Double-click the XProcessorConfiguration row in the Name column.
  3. Locate the processor id=”valuelink” entry. The file includes an entry for the ValueLink Processor as shown in the following figure:

    Figure 50-17 XProcessorConfiguration Entry for ValueLink


    This figure shows the XProcessorConfiguration processor id entry for ValueLink, indicated with a red oval surrounding the code.

    If you are using only the ValueLink Processor for gift card service, delete the other entries or use comment marks around them.

  4. Click the insert icon This image shows the Insert icon, which is a green circle with a white plus sign. on the toolbar.
  5. In the Record Name field, enter ValueLinkProcessor.valuelink, and then click OK.

    Ensure that you enter the filename exactly as shown; otherwise problems may occur in the system. Do not include the file extension (for example *.xml or *.dll) in the Record Name field.

  6. Double-click the ValueLinkProcessor.valuelink row.
  7. Set the Content Type to 1 - Loose Xaml so you can see the tags in various colors, making it easier to read.
  8. Click the Import from a file link.
  9. Browse to [Drive Letter]:\MICROS\Simphony2\EMCClient, select ValueLinkProcessor.valuelink, and then click Open.
  10. Edit the ValueLinkProcessor.valuelink file to include the actual Tender/Media and/or Service Charge tags:

    You must modify the imported ValueLinkProcessor.valuelink file so each applicable <macro> entry in the file has the actual EMC record number for the respective Tender/Media or Service Charges. Another option is to remove individual macros you do not intend to use.

    1. Scroll approximately halfway down the file to the tag macro id=”post_redeem”.
    2. Replace [payment-tender-number] and [tender-number] in two places with the actual Tender/Media object record number for the ValueLink Processor.
    3. Replace [service-charge-number] with the actual Service Charge object record number for the ValueLink Processor.

      Note:

      When entering EMC record numbers for macros such as a [payment-tender-number] or a [service-charge-number], remove the placeholder braces, thus leaving only the record number between the Number tags. Brace removal applies when editing all of the imported *.xml files.
  11. Click Save.
  12. Click the insert icon This image shows the Insert icon, which is a green circle with a white plus sign. on the toolbar.
  13. In the Record Name field, enter ValueLinkHostDefault.valuelink, and then click OK.
  14. Double-click the ValueLinkHostDefault.valuelink row.
  15. Click the Import from a file link.
  16. Browse to [Drive Letter]:\MICROS\Simphony2\EMCClient, select ValueLinkHostDefault.valuelink, and then click Open.
  17. Change the ValueLinkHostDefault.valuelink file to include the appropriate entries, replacing the tags in braces with the correct information for the site.

    The comments in the file explain the acceptable values.

  18. Click Save.
  19. Click the insert icon This image shows the Insert icon, which is a green circle with a white plus sign. on the toolbar.
  20. In the Record Name field, enter ValueLinkHost.valuelink, and then click OK.
  21. Double-click the ValueLinkHost.valuelink row.
  22. Click the Import from a file link.
  23. Browse to [Drive Letter]:\MICROS\Simphony2\EMCClient, select ValueLinkHost.valuelink, and then click Open.
  24. Scroll to the Datawire tag. If the <DID> tag is blank (all zeros), the system will trigger the merchant registration process. After completing this registration process, replace the <DID> tag with the new MerchantID number.

    The values for <MerchantID>, <AltMerchantID>, and <TerminalID> are provided by Datawire. The default values provided are not the actual values for these tags.

  25. Click Save.
  26. Click the insert icon This image shows the Insert icon, which is a green circle with a white plus sign. on the toolbar.
  27. In the Record Name field, enter ValueLink2Settings, and then click OK.
  28. Double-click the ValueLink2Settings row.
  29. Click the Import from a file link.
  30. Browse to [Drive Letter]:\MICROS\Simphony2\EMCClient, select ValueLink2Settings, and then click Open.
  31. Change the ValueLink2Settings file if needed.
  32. Click Save.
  33. Update or reload your database on the workstation to ensure that the changes apply to the workstation.

    Updating Workstations After Configuration Changes in the Oracle MICROS Simphony POS User Guide contains information about this process.