Difference between revisions of "Optical code"
(→Multiple codes on a single object {{Version/WinXSince|4.4}}{{Version/XamarinSince|4.4}}) |
|||
| Line 35: | Line 35: | ||
== Multiple codes on a single object {{Version/WinXSince|4.4}}{{Version/XamarinSince|4.4}} == | == Multiple codes on a single object {{Version/WinXSince|4.4}}{{Version/XamarinSince|4.4}} == | ||
It's possible have multiple optical codes on a single object. This allows the same object to be found when you scan any of those codes. | It's possible have multiple optical codes on a single object. This allows the same object to be found when you scan any of those codes. | ||
| − | For such objects, the general scan and potentially the search behaviors are exactly the same as those with only a single code. For example, if an object with multiple codes is found when you scan one of the codes, it could also get unlocked. | + | For [[SYSCLS_OBJECTWITHIDMARKERS|such objects]], the general scan and potentially the search behaviors are exactly the same as those with only a single code. For example, if an object with multiple codes is found when you scan one of the codes, it could also get unlocked. |
| + | |||
| + | [[Category:Client|Optical code]] | ||
== Unlocking objects == | == Unlocking objects == | ||
Revision as of 13:31, 30 May 2023
In order for the users to find objects more efficiently, UBIK® objects can be marked with values for optical codes. Whenever a user scans an optical code, the resulting code value can be used to find all matching objects, namely objects that have the right property.
Contents
Types of optical codes
The following types are supported at the moment:
- Barcode;
- QR Code;
- ID Marker.
Types of scanners
The following scanners are used for scanning:
- ZXing Barcode Scanner (for barcodes and QR codes)
- ID Marker Scanner - based on Metaio. (for ID Markers) This is now obsolete.
- Getac Z710 integrated barcode/qr-code scanner (from version 2.4.4 on)
Searching for objects
UBIK® provides two mechanisms for searching objects: online and offline.
Searching offline
In any case (regardless of the network connection and sync mode), UBIK® always goes through all the objects currently available on the device and find the ones that match the scanned results.
Searching online
When the Internet is available and UBIK® is not running under offline mode, the search result is enhanced by online search. This means any objects that match the scanned results can be found even if they don't yet exist locally.
Presenting results of a search
Once the objects are found, they are displayed in a list. The users can then browse to any of the objects for more information by clicking on the objects.
Multiple codes on a single object
It's possible have multiple optical codes on a single object. This allows the same object to be found when you scan any of those codes. For such objects, the general scan and potentially the search behaviors are exactly the same as those with only a single code. For example, if an object with multiple codes is found when you scan one of the codes, it could also get unlocked.
Unlocking objects
In some scenarios where topics such as security, regulations etc. are of higher importance, some objects can often be locked by default until certain codes are scanned.
 | The unlock codes are always compared case sensitive. |
Unlock after a search
By default, a search is started for every scanned code. If an object is found, it is presented in the UI and unlocked. A group of objects sharing the same unlock code are unlocked as well.
Unlock mode
It's also possible to start a scan with an "unlock mode" (see XAML example below). In this mode, the app doesn't rely on the search mechanism to find the objects and, therefore, doesn't present anything in the UI. Instead, any objects having their unlock code matching the scanned one are unlocked in the background.
- It doesn't matter whether objects having the unlock code are present at the time when that code is scanned or not. The scanned unlock code will be remembered for 15 minutes. If objects carrying that same unlock code show up on the client (locally created or downloaded from the server) within that time, they will have an unlocked status automatically;
- It's possible (but optional) to specify an expected unlock code as well. In that case, nothing gets unlocked if the scanned code doesn't match the specified one.
Example XAML code to enable the unlock mode:
UWP
...
xmlns:controls="using:UBIK.WinX.Controls"
Command="{Binding NavigateToScanPageCommand}">
<Button.CommandParameter>
<controls:KeyValueList>
<controls:KeyValueParameter Key="UnlockMode" Value="true" />
<controls:KeyValueParameter Key="UnlockCode" Value="$LWP01" />
</controls:KeyValueList>
</Button.CommandParameter>
</Button>
Xamarin
...
xmlns:classes="clr-namespace:UBIK.CPL.Classes;assembly=UBIK.CPL"
Command="{Binding NavigateToScanPageCommand}">
<Button.CommandParameter>
<classes:KeyValueList>
<classes:KeyValueParameter Key="UnlockMode" Value="true" />
<classes:KeyValueParameter Key="UnlockCode" Value="$LWP01" />
</classes:KeyValueList>
</Button.CommandParameter>
</Button>
Technical background
In order for objects to be identifiable through optical codes, they have to carry the SYSCLS OBJECTWITHIDMARKER classification.
The data types of different optical codes are listed as follows:
- Barcode - String;
- QR Code - String;
- ID Marker - Integer.
The service query used for online searching is IDMARKERSCANQUERY.
See also
- Find Objects by Optical Codes
- Make an Object be found by Optical Codes
- SYSCLS OBJECTWITHIDMARKER (Classification)
- SYSCLS OBJECTWITHRFIDTAG (Classification)
- SYSCLS IDMARKERSCANQUERY (Classification)
- SYSCLS RFIDTAGSCANQUERY (Classification)
