XAPCOM Transaction Plug-In

Owned by Anand Rajaraman
Last updated: Jan 13, 2020
4 min read

Installation and Configuration

Configuring XAPCOM

  1. Install and enable the XApCom software according to the Diebold documentation.

  2. Open the Agilis Configuration Utility.

  3. Configure the XApCom settings as follows:

    • Set the Protocol to TCP/IP

    • Set the DVR IP Address field to the IP address of the 3VR appliance

    • Type 7112 in the Port Number field

    • Make note of the Terminal ID, as you will need this information when configuring the 3VR plug-in

    • Check the box to include [√]Printer Text

    • Set the Function Command drop-down list to Consumer and Journal print data.

Configuring 3VR Plug-In

Installing XApCom Transaction Plug-in

  1. Launch 3VR System Manager.

  2. In the Configure panel, click the plus sign beside the appliance name.

  3. Right-click the Plug-ins folder and select Add Plug-in.

  4. In the resulting Confirm dialog box, click Install to proceed.

  5. Navigate to the folder containing the plug-in file (Plugins.XApComTCPTransaction-Release-1.0.0.xxxxx 7.0.3pg)and click to highlight the file.

  6. Click OK. The plug-in will now begin installing.

  7. When the plug-in is installed, it will appear below Plug-ins in System Manager.

Configuring Global Plug-In Settings

  1. Select the XApCom Transaction plug-in.

  2. Click Edit Settings.

    In the Edit Global Settings dialog, configure the following settings as appropriate for the installation:

    • Image Quality Value Controls the quality of images in events generated by the plug-in.

    • Card Number Digits Shown Determines how many digits of the card number will be printed on event cards. The remaining digits will be masked with Xs (for example, the default of 6 digits will
      result in a card number like XXXXXXXXXX386649).

  3. Click OK to save and return to the Configure panel.

Binding Cameras to Plug-In

  1. Select the XApCom Transaction plug-in.

  2. Click the Bound Cameras field then click the ... button.

  3. In the Bind Plug-in to Cameras dialog box, click the check box[√] beside each camera that should be associated with ATM transactions.

  4. Click OK to save your changes and return to the Configure panel.

A pop-up will be displayed notifying you that the 3VR system software must be restarted after making changes. Click OK to close the pop-up message and acknowledge the warning. You will restart software as the last configuration step.

Configuring Per-Camera Settings

  1. After binding cameras to the plug-in, links will appear under Bound Cameras for each camera.

  2. Click a link (for example Edit “1. ATM Camera”) to edit the settings for that camera.

  3. Type the ATM ID in the ATM/Teller ID box.

  4. Click OK to save your changes and return to the Configure panel.

  5. Repeat steps 2-4 for any remaining cameras bound to the XApCom Transaction plug-in.

If multiple ATMs are to be associated with a single camera, the ATM IP Address and ATM ID fields should contain the IP addresses and IDs of all of the ATMs, separated by a comma with no spaces. The values for each ATM should be placed in the same order.

For example, if ATM 1234A (IP address 10.100.2.1) and ATM 5678B (IP address 10.100.2.3) are both to be assigned to camera 1 in the plug-in configuration, the ATM ID for camera 1 should be set to “1234A,5678B” and the ATM IP Address should be set to “10.100.2.1,10.100.2.3”.

Finalize Configuration

Restarting System Software

The 3VR system software must be restarted after initially installing the plug-in or making any changes to its configuration.

  1. In the Configure panel, right-click the appliance name and select Restart 3VR Software.

  2. In the pop-up box that appears, click Restart to proceed. Wait 1-2 minutes for the software to restart.

Verifying Successful Configuration

To verify that the XApCom Transaction plug-in has been correctly configured, check for recent Transaction events in 3VR OpCenter:

  1. In 3VR OpCenter, click the Monitor tab to go to the Monitor panel.

  2. Click camera numbers to select the cameras bound to the XApCom Transaction plug-in.

  3. Click the arrow below the camera selector to open the event type drop-down menu.

  4. Select [√]Transaction and click OK.

  5. If the plug-in has been correctly configured, Transaction events will appear in the Monitor panel as they occur in real-time.

Verify that Transaction events are being generated correctly on all cameras bound to the plug-in during configuration.

ATM Data Capture Plug-In