Set Up Workstations (1209 onwards)

Created by Migration Bot, Modified on Fri, 23 Oct at 11:24 AM by Migration Bot

Originally written by John Hardwick, last updated Jan 30, 2026, on the Swan Retail knowledge base (FRS).

This routine allows the mapping of device IP addresses to trading locations and can act as a access gate for SwanFRS. For example, if the PO is not from a known IP address range, access to SwanFRS is prohibited.

This feature is controlled via the USE_WORKSTATION_IP application parameter.

There are four settings for workstation control –

Dynamic – use the user's default branch to derive the location of work

In this scenario, it is necessary to set a default IP address for each location. It is recommended that the IP address is set to zeros, although this is not mandatory, however the active and default tick boxes must be set.

This setting should be used when using SwanFRS with dynamically allocated IP addresses.

IP Used – use the computer's IP address cross-referenced with the workstation to derive the location.

When using fixed IP addresses, it will be necessary to set the computer's IP address within the relevant location.

If operating with EPOS tills, it is important to set the word ‘none’ for any IP without a till and the till number for all locations with ‘tilling’ functionality. Where a till is present, the till data path is also required.

If operating with customer facing pole displays, workstation must be switched to on

Use Part IP – as per on, but instead of defining a full IP address, partial IPs may be defined. If an IP of 192.168.50 is set, SwanFRS will assume all IPs in the range 192.168.50.0 to 192.168.50.255 are operational within the specified location.
Multi-mode – use the IP address where possible and if not found use the default location from the user’s login code.

This setting is used when a combination of fixed and dynamically allocation IP addresses are in use. All fixed IPs must be defined within the workstation routine.

If operating with customer facing pole displays, workstation must be switched to on.

Menu Location: System Admin > Utilities > Set Up Workstations

On initial entry to the program, the operator must select a Location from the pick list to the top left side of the screen. Locations are restricted, with the operator only being offered those locations they have visibility of.

Click the NEW button or New on the side panel to generate a new record.
Click the icon to amend an existing record.
Once in amend / insert more, click the to save changes or to abort the action.
Click the CLOSE button, or Back option on the side panel to leave the page (or select another option from the menu)

Item	Description
IP Address	Specify the unique IP of the terminal being defined.
EPOS ID	Specify the reference used by an EPOS system if this workstation is acting as a sales till. When using tills, any workstation which is not a till needs to have the word ‘none’ set. This field should not be null, if not using tills then set to a minus sign or a full stop.
Description	Optionally specify the name of the workstation.
Active	Tick this field to indicate this workstation may be used within SwanFRS. Workstations cannot be removed, once redundant, untick this field.
Default	Click this field to indicate this is the default configuration for this location. One default workstation is required per location.
Till Data Path	Specify the path when linking with an EPOS tilling system. When linked to a till, the connection must have a fixed IP address
Customer Display Device	Optionally choose the name of the device linked to this terminal acting as a customer display device.
Is POS ?	Tick if this device is a POS device
Terminal Type	Used to identify, the IP relates to a card payment device. Choose from Not Set VeriFone SwanPay
Payment Terminal	Specify the type of terminal from the pick list controlled from the selection made in the Terminal Type column.

When operating with workstations, the system will establish the user’s location from the login code and then a check is performed to see if the terminal’s IP address is present in user’s default location list. SwanFRS will block any login attempt if the terminal's IP does not appear in the workstation list for the user’s default login code. It is therefore important to ensure that you have built the terminal IP into all the location / user combinations.

Files from the Confluence page