Creating ValueLink Operations Buttons

You need to add a button to POS operations for each supported ValueLink Processor operation to function on the workstation. Each button needs to be set to the Function Run Extensibility App.

The following table lists the ValueLink operations (button names), descriptions, and argument strings that are used in the Page Design module. You will use this information in the subsequent steps.

Table 50-7 ValueLink Operation Buttons

Operation Name	Description	Argument String
Activate	Activate a gift card.	type=dll;appname=XProcessor;filename=ValueLink2.dll;script=Activate;arg=<XProcessorArgs><AccountEntryRules title="Activate" prompt="Enter name or swipe card" entrytype="String" allowmanual="true" allowbarcode="true" allowmagcard="true" allowmicrosemployeecard="false" allowfingerprint="false" maskentry="false"/></XProcessorArgs>
Denominated Activate or Activate Denominated	Activate a denominated gift card.	type=dll;appname=XProcessor;filename=ValueLink2.dll;script=denominated_activate;arg=<XProcessorArgs><AccountEntryRules title="Activate" prompt="Enter name or swipe card" entrytype="String" allowmanual="true" allowbarcode="true" allowmagcard="true" allowmicrosemployeecard="false" allowfingerprint="false" maskentry="false"/></XProcessorArgs>
Activate on Hold	Activate a gift card and change its status to “On Hold” until payment is made.	type=dll;appname=XProcessor;filename=ValueLink2.dll;script=ActivateOnHold;arg=<XProcessorArgs><AccountEntryRules title="Activation on Hold" prompt="Enter name or swipe card" entrytype="String" allowmanual="true" allowbarcode="true" allowmagcard="true" allowmicrosemployeecard="false" allowfingerprint="false" maskentry="false"/></XProcessorArgs>
Denominated Activate On Hold or Activate On Hold Denominated	Activate a denominated gift card and change its status to “On Hold” until payment is made.	type=dll;appname=XProcessor;filename=ValueLink2.dll;script=denominated_ActivateOnHold;arg=<XProcessorArgs><AccountEntryRules title="Activation on Hold" prompt="Enter name or swipe card" entrytype="String" allowmanual="true" allowbarcode="true" allowmagcard="true" allowmicrosemployeecard="false" allowfingerprint="false" maskentry="false"/></XProcessorArgs>
Activation Return	Reverse a gift card activation. This function does not require access to the original check, unlike a touch void.	type=dll;appname=XProcessor;filename=ValueLink2.dll;script=Activation_Return;arg=<XProcessorArgs><AccountEntryRules title="Activation Return" prompt="Enter name or swipe card" entrytype="String" allowmanual="true" allowbarcode="true" allowmagcard="true" allowmicrosemployeecard="false" allowfingerprint="false" maskentry="false"/></XProcessorArgs>
Authorize	Authorize the use of a card for payment. This function is used in conjunction with Finalize	type=dll;appname=XProcessor;filename=ValueLink2.dll;script=authorize;arg=<XProcessorArgs transactionstate="inside"><AccountEntryRules title="Authorize" prompt="Enter name or swipe card" entrytype="String" allowmanual="true" allowbarcode="true" allowmagcard="true" allowmicrosemployeecard="false" allowfingerprint="false" maskentry="false"/></XProcessorArgs>
Batch Activate	Activate multiple gift cards.	type=dll;appname=XProcessor;filename=ValueLink2.dll;script=BatchActivate;arg=<XProcessorArgs><AccountEntryRules title="Batch Activate" prompt="Enter name or swipe card" entrytype="String" allowmanual="true" allowbarcode="true" allowmagcard="true" allowmicrosemployeecard="false" allowfingerprint="false" maskentry="false"/></XProcessorArgs>
Cash Out	Remove the remaining balance of the gift card as a cash payment.	type=dll;appname=XProcessor;filename=ValueLink2.dll;script=cashout;arg=<XProcessorArgs transactionstate="outside"><AccountEntryRules title="Cash Out" prompt="Enter name or swipe card" entrytype="String" allowmanual="true" allowbarcode="true" allowmagcard="true" allowmicrosemployeecard="false" allowfingerprint="false" maskentry="false"/></XProcessorArgs>
Finalize	Use the gift card as payment. This function is used in conjunction with Authorize.	type=dll;appname=XProcessor;filename=ValueLink2.dll;script=finalize;arg=<XProcessorArgs suppressaccountprompt="true" selectpendingoperation="true" transactionstate="inside"><AccountEntryRules title="Finalize" prompt="Enter name or swipe card" entrytype="String" allowmanual="true" allowbarcode="true" allowmagcard="true" allowmicrosemployeecard="false" allowfingerprint="false" maskentry="false"/></XProcessorArgs>
Inquire	Retrieve the current balance of a gift card.	type=dll;appname=XProcessor;filename=ValueLink2.dll;script=Inquire;arg=<XProcessorArgs><AccountEntryRules title="Inquire" prompt="Enter name or swipe card" entrytype="String" allowmanual="true" allowbarcode="true" allowmagcard="true" allowmicrosemployeecard="false" allowfingerprint="false" maskentry="false"/></XProcessorArgs>
Redeem	Use the gift card as payment.	type=dll;appname=XProcessor;filename=ValueLink2.dll;script=Redeem;arg=<XProcessorArgs transactionstate="inside"><AccountEntryRules title="Redeem" prompt="Enter name or swipe card" entrytype="String" allowmanual="true" allowbarcode="true" allowmagcard="true" allowmicrosemployeecard="false" allowfingerprint="false" maskentry="false"/></XProcessorArgs>
Refund	Add value to an active gift card via a return.	type=dll;appname=XProcessor;filename=ValueLink2.dll;script=Refund;arg=<XProcessorArgs transactionstate="inside"<AccountEntryRules title="Refund" prompt="Enter name or swipe card" entrytype="String" allowmanual="true" allowbarcode="true" allowmagcard="true" allowmicrosemployeecard="false" allowfingerprint="false" maskentry="false"/></XProcessorArgs>
Reload	Add value to an active gift card via a payment.	type=dll;appname=XProcessor;filename=ValueLink2.dll;script=Reload;arg=<XProcessorArgs><AccountEntryRules title="Reload" prompt="Enter name or swipe card" entrytype="String" allowmanual="true" allowbarcode="true" allowmagcard="true" allowmicrosemployeecard="false" allowfingerprint="false" maskentry="false"/></XProcessorArgs>
Reload on Hold	Add value to an active gift card and change its status to “On Hold” until payment is made.	type=dll;appname=XProcessor;filename=ValueLink2.dll;script=ReloadOnHold;arg=<XProcessorArgs><AccountEntryRules title="Reload on Hold" prompt="Enter name or swipe card" entrytype="String" allowmanual="true" allowbarcode="true" allowmagcard="true" allowmicrosemployeecard="false" allowfingerprint="false" maskentry="false"/></XProcessorArgs>
Remove on Hold Status	Manually remove a card’s “On Hold” status.	type=dll;appname=XProcessor;filename=ValueLink2.dll;script=RemoveOnHoldStatus;arg=<XProcessorArgs><AccountEntryRules title="Remove on Hold Status" prompt="Enter name or swipe card" entrytype="String" allowmanual="true" allowbarcode="true" allowmagcard="true" allowmicrosemployeecard="false" allowfingerprint="false" maskentry="false"/></XProcessorArgs>
Void Cash Out	Reverse a previously performed cash out operation.	type=dll;appname=XProcessor;filename=ValueLink2.dll;script=void_cashout;arg=<XProcessorArgs transactionstate="outside"><AccountEntryRules title="Void Cash Out" prompt="Enter name or swipe card" entrytype="String" allowmanual="true" allowbarcode="true" allowmagcard="true" allowmicrosemployeecard="false" allowfingerprint="false" maskentry="false"/></XProcessorArgs>
Transaction Cancel	Prompt a workstation operator to void any existing gift card operations when attempting to cancel a transaction.	type=DLL;Appname=XProcessor;FileName=TransCancelExt.dll;

1. Select the Enterprise, property, or revenue center, click Configuration, and then click Page Design.
2. Open the page on which to place ValueLink Processor buttons.
3. On the Edit tab, select the page area in which to define the ValueLink Processor functions.
4. Click Button.
5. On the General subtab, in the Legend field, enter the operation name (button).
6. Select Function from the Type drop-down list.
7. Click the black arrow beneath the Type drop-down list.
8. Select Extensibility from the Type pane, select Run Extensibility App in the Results pane, and then click OK.
9. Click inside the Arguments field (left of the black arrow). The easiest way to complete this field for each operation name is to copy and paste the information from the table in the Arguments String field.

   Ensure that there are no spaces within the string.

10. Repeat steps 4 through 9 to create buttons for each of the ValueLink operations listed in the table.
11. Click Save.