The Login API specifies that a HTTP POST must have Hardware Id and Locale as path parameters and requires that a username and password be passed as part of the HTTP header.
In ASA the same user and password combination must exist on both ORMPOS and CSC for each agent to enable ASA to login to ORMPOS immediately after it logs into CSC.
Login Structure
ORMPOS provides a REST-ful web service as an API. Before calling most of the other APIs, the login API must be invoked. The ORMPOS API associated with login is:
Class |
|
|---|---|
Method |
|
The hardwareID is the iPad device UDID (The Apple Unique Device Identifier). The user name and password are passed in the request header. From this response, you can get the store ID and register ID to pass in to the open register API.
Username and Password
The ORMPOS username and password is required to be passed as part of the HTTP header information. It is passed as part of the Authorization header property, and the username and password is Base 64 encoded.
Response from ORMPOS
ORMPOS responds with JSON which includes the store id and register id, and these are parsed from the JSON and inserted into the REST session object as commonly required parameters for future requests.
Hardware Id
This is stored as a setting in the settings plist, under this key:
POS_HARDWARE_ID
If this is not entered, a default will be used, in the form of the UIDevice identifierForVendor property. For more information, see the Apple iOS Developer Library UIDevice Class Reference.
This hardware ID has to be configured on the ORMPOS server to allow that specific device to access the ORMPOS services.
An entry for each device ID must be added to this file:
<POS_install_directory>\<client>\pos\config\context\DeviceContext.xml
For example, an entry would be structured like this:
<entry key="[deviceID]>"
<bean class="oracle.retail.stores.mobilepos.status.register.RegisterProfileConfiguration.StoreRegisterPair">
<property name="storeID" value="[storeID]" />
<property name="registerID" value="[registerID]" />
<property name="printerID" value="[printerID]" />
</bean>
</entry>
