KDSmart Tips & Troubleshooting

This page contains a few general usage tips for KDSmart.

Select any heading to expand/display expand or contract contract the section.


Tips

Determining The Android Version

For support purposes you may be asked to provide the version number of Android you are using. This is a simple check to perform on your phone or tablet by performing the following:

  1. From the home screen select settings Settings.
  2. Scroll down to the bottom and select either About Phone or About Device.
  3. For:
KDSmart Permission Requirements
Instruction Example
  1. From the home screen select settings Settings.
 
  1. Scroll down to the bottom and select either About Phone or About Device.
 
  1. Earlier versions the Android Version will appear in this list.
(Select to zoom)
  1. Later versions select the Software info item and Android Version should appear at the top.
(Select to zoom)


Android Permissions

Android has introduced more stringent application security which affects KDSmart and any other Android application. Permission is required at the initial application installation, and maybe requested again following installing any application updates.

Note: Without allowing permissions an application will not work, or be unable to use all it’s functionality.

Upon initial KDSmart installation a message similar to the following example will be displayed. Selecting Allow will enable KDSmart to work.

Android Permission Request (Select to zoom)


Note: If ‘Deny’ is selected KDSmart will display an advisory message (appearing in background of above image) with a cancel cancel-btn2 and accept accept-btn2 button. Selecting:

  • Cancel will stop KDSmart; and
  • Accept will cause Android to redisplay the approval request message again.

Selecting “Don’t ask again”, if it is displayed, and “Deny” will require a visit to Android settings to restart the request process. See Restoring/Changing Permissions below for instructions.

The next example shows the permission request following an update to KDSmart, which must be accepted before the application will open.

Android Access Permissions Request (Select to zoom)


Why Must I Grant Access?

Applications, including KDSmart, need to access the storage/memory on the device be able to:

  • Load your Trial/Nursery data;
  • To add to or make changes to that data; and
  • To save your data.

Quite simply, without Allowing any permission, KDSmart Will Not Work.

Other features KDSmart can use on the device, such as the camera, microphone, etc. are also affected. The following table shows KDSmart permission requirements for the application or specific features to work:

KDSmart Permission Requirements
Permission
Required
Description
Camera Required if the camera is to be used by KDSmart.
Location Required if the location option has been enabled.
Microphone Required to record any audio notes using the microphone in KDSmart.
Storage KDSmart will not work without being given Storage Permission. This is required to store any data on the device e.g. sample data, Trial Import or Export, Traits, Tags, etc.
Bluetooth Required if bluetooth barcode scanners or scales are to be used.


Restoring/Changing Permissions

At some stage you may have denied KDSmart access, e.g. to the camera, or Never ask again has been selected. These settings can be changed as by using the following procedure.

Procedure to change KDSmart Permissions
Step Action
1 On the Android device, select the system Settings settings
2 Select Applications
3 Select KDSmart
4 Select Permissions
5
Enable the required permission.
Remember Storage is mandatory to use KDSmart and the other settings are needed if that functionality is required.
Permission Settings (Select to zoom)

Note: Selecting More or the highlighted menu button illustrated at (1) displays All permissions. These additional settings will also affect KDSmart behaviours for certain features.


Database Integrity Check

This database check and repair is mainly relevant in situation where the following error occurs:

Example Error Requiring DB Integrity Check/Repair (select to zoom)

This function checks the KDSmart database for the existence of duplicate samples for a Trait Instance, Plot, Sub-Plot in each Trial and removes the sample if the Trait Value is null.

Note: If any duplicate samples are found containing a value , the following error message
“Duplicate Samples with a value Please contact Diversity Arrays and send them your Database”
will be displayed and the Check/Repair processing will stop.

Should repair display this message and is unable to proceed, please export the database and report the issue separately attaching the database in the email, or use an alternative file transfer method if the file is too large for email.
Tip: The option to export the Database is located just above the Database Integrity Check button.

Steps to execute the Database Integrity Check
Step Action
1 At the Home screen or menu by select Manage Devices kds_devices
2

Within the Database tab select Database Integrity Check

Database Integrity Check (select to zoom)

Note: Depending upon the size of Trials within the KDSmart database this check could take more than 10-15 minutes. The check can be cancelled however any errors present may not be repaired.


Screen Orientation/Rotation

Android is able to lock or prevent the screen from rotating rotate-btn for all apps on the device. KDSmart behaves in accordance with this Android device setting.

If Android Screen Rotation Is ... Then KDSmart will ...
Enabled Respond to changes in the screen orientation.
Disabled Not detect or respond to changes in the screen orientation.

Note

Automatic rotation is intentionally disabled within the Scoring screen to prevent undesirable screen changes. Various movements of the user and device in the field, such as bending down to inspect a Sub-Plot would cause frequent and unnecessary screen changes.

Steps to rotate the scoring screen (Landscape to Portrait, Portrait to Landscape)
Step Action
1 Ensure Android Screen Rotation is enabled.
2 In KDSmart, exit from the scoring screen to another screen.
3 Turn the device to the required position (portrait or landscape).
4 Return to the Scoring screen which should now display with the desired orientation.


Lists and Select Mode for Multiple Selection

This is a generic tip for KDSmart Trials, Traits and Tag selection lists. The example shown is the Trial list.

Multiple Selection Example (Select to zoom)


When a list of items is displayed, as the Trial list in the left hand image "1" above, a long press on any Trial item will invoke Select Mode.

Once in Select Mode, multiple items may be selected, by touching them as illustrated in the right hand "2" image above where three Trials have been selected. The number of items selected is indicated at the top right, in this example Selected:3 appears.

Selecting the Action button action-menu in the Action Bar (not shown), will perform the chosen action for the selected item(s).

Caution

Please be take care when using the Delete function which will remove the selected Trials. Backup your data regularly to prevent any loss as Delete is final.


Symbols and Buttons

The button symbols used in KDSmart are shown in the following table:

Button Term Description
kds_trials Trials Trials or Nurseries refer to the experiments or research being conducted.
Select Trials on the Home screen to display the list of Trials that have been loaded into KDSmart.
Demonstration Trials are preloaded for familiarisation of KDSmart and training.
kds_tags Tags Manage the Tags used in the Trials.
kds_traits Traits Manage the Traits used in the Trials.
kds_devices Devices Manage devices (scanners, scales, etc.), Bluetooth and Database.
kds_settings Settings Manage the device settings and those that apply to all Trials.
kds_info Information Context help for KDSmart, Information about KDSmart and Licencing.
run-btn Start Start or Run button.
kds-DemoRun Run (Demo db) Start the Active Trial (White boarder indicates the current setting is for a Demonstration database trial).
kds-ProdRun Run (Production db) Start the Active Trial (Yellow boarder indicates the current setting is for a ‘Production’ database trial.
btn_advance Advance Step the current record forward.
btn_retreat Retreat Step the current record backwards.
kds_plots Plot Either a PlotId or a Column and Row pair that uniquely identifies an area (i.e. Plot) within a Trial. Within a Trial each combination or Column/Row must be unique.
organism-types Organism Types Within Settings the type of organism being measured can be specified. This appears in the scoring window.
Each setting has a different image representation for the organism type.


Troubleshooting

Block Trial Issues

The 3.0.28 update has resolved some database issues with Block Trials. However some users may find that after updating KDSmart, their Block Trials do not work anymore. This is due to the Trials not being compatible with the new database version. The following instructions outline a quick fix for this issue:

Fixing Block Trials
Step Action
1.

Navigate to the Devices Screen. The image below shows how to get there from the Main Screen. Select the Devices Button at "1".

Devices Screen

2.

A Fix Block Trials Button has been added and can be seen in the below image at "1".

Fixing Block Trials

3. A list of Block Trials will be displayed. Select the Trial that you want to fix and it should be converted to be compatible with the newest version of KDSmart.


Plot Attribute Alias Issues

The 3.0.28 update to KDSmart has involved a change in the way that Block Trials are handled. Some users may experience issues with the Plot Attribute Alias of a Block Trial if they try to import a Block Trial to KDSmart 3.0.28 if it was exported from an earlier version of KDSmart.


If you have this issue, KDSmart will present options for setting the correct Plot Attribute Alias which can be seen in the below image. Choose the field that should match up with the Plot Attribute Alias and the file will be converted for you.

Fixing Plot Attribute Alias