Loading a list of and identifying objects identified via a Barcode or QR-Code on the {{UBIKCLIENTUBIK Client}} implies that the object objects and the search mechanism is mechanisms are configured and used accordingly. This guide describes how to prepare objects using {{UBIK Studio}}.
= Studio =Please be aware that since {{Version/ServerSince|4.4.0}} Version 4.4.0 we support defining multiple (optical) codes for one object. Even if we support (for downward compatibility) both approaches (one code per object and multiple codes per object) we recommend to use the new technique even if there is only one code per object. If you are using an older version please navigate to [[HowTo:Make_an_Object_be_found_by_Optical_Codes#Single_Code|Find object with single Code]].
== ID Marker ==
UBIK provides a new Entity called ID Marker {{Version/ServerSince|4.4.0}} since 4.4.0!
ID Markers are used to define the scannable Codes on a central location. We differ 3 types of Codes: RFID, BarCode and QR-Code.
The Code must be entered in the property "MARKER", the type is specified using the property "MAKER_TYPE" and the property OWNER refers to the object/ubiqule which is presented by the code. You can specify as many codes for one object as you like.
If later a code is scanned and found in the ID Markers, the referenced object will be added to the result collection.
=== Preparing an ID Marker Scan-Query ===
We provide a new MetaClass "IDMARKERSCANQUERY ID marker scan queries" deriving from System.Query.QUERY. There is already one instance QRY_IDMARKERSCANQUERY available in it. As this query is used to support the single Code search we recommend to create a new Query instance.
# Create a new instance of IDMARKERSCANQUERY
# Set the property "SUPPORT_MULTI_MARKERS" to true to enable the new technique.
# Set the according filter object ('''FILTEROBJECT''') similar as for other queries
# Add this new query to the list of [[SYSREL INFRASTRUCTURE|Infrastructure objects]]
# Prepare and add a [[QUERYSCOPE]] to the [[ACM]]
# Prepare and add a [[VIEWITEMS|View Item]] to the view set in the [[Context]] of the ACM<br/>[[File:UI_Marker_scaning02.png|800 px|border|alt=infrastructure|infrastructure]]
=== Preparing the object with multiple codes ===
Ensuring the object can be found by the clients offline search we need to classify the object's MetaClass as [[SYSCLS_OBJECTWITHIDMARKERS]] <br/>
As this classification is an autonomous classification there is no need to maintain any properties. The properties and the corresponding values (all MARKERS referring to one object) will be managed by the system and sent to the client automatically. <br/>
[[File:UI_Marker_scaning10.PNG|600 px|border|alt=Classify object with multiple codes|Classify object with multiple codes]]
== Single Code ==
=== Preparing a Scan-Query ===
# [[HowTo:Create a new Query]] classified as [[SYSCLS_IDMARKERSCANQUERY]]
# Set the according filter object ('''FILTEROBJECT''') similar as for other queries (e.g. [[HowTo:Create_a_new_Query]])<br/>[[File:UI_Marker_scaning01.png|420 1200 px|border|alt=Create a new Query|Create a new Query]]# Add this new query to the list of [[infrastructureSYSREL INFRASTRUCTURE|Infrastructure objects]] objects
# Prepare and add a [[QUERYSCOPE]] to the [[ACM]]
# Prepare and add a [[VIEWITEMS|View Item]] to the view set in the [[Context]] of the ACM<br/>[[File:UI_Marker_scaning02.png|420 800 px|border|alt=infrastructure|infrastructure]]
=== Preparing the object ===
# Classify Ensuring the object can be found by the clients offline search we need to classify the object's MetaClass as [[SYSCLS_OBJECTWITHIDMARKER]] and implement the necessary properties<br/>[[File:UI_Marker_scaning03.png|420 px600px|border|alt=Create a new Query|Create a new Query]]
# Enter the value of the Barcode, QR-Code or the Marker ID in the property
= Client ==== Using the scan query ===# Start a scan activity, like the ''QR-Code'' or ''ID-Marker'' activity, if you want to load an object via Barcode or QR-Code# After scanning a known code the client tries to fetch the objects, identified by this code
== See also ==
* [[HowTo:Find_Objects_by_Optical_Codes]]
* [[SYSCLS_OBJECTWITHIDMARKER|Classification for single optical code]]
* [[SYSCLS_OBJECTWITHIDMARKERS|Classification for multiple optical codes]]
[[Category:How-To|Make an Object be found by Optical Codes]][[Category:Pages with broken file links|Make an Object be found by Optical Codes]][[Category:Publishing|Make an Object be found by Optical Codes]]