Import Screen Overview

Accessed from

import screen

This screen handles the actual Import of data in to the app.


Here you control which fields are imported, and which data fields map to which app fields:


Before you actual link the fields you need to select the source data file


Always check the entire list looking for hidden or new fields



Touch Actions


Pressing the 'Import' button starts the import, you will see a dialog whilst this is running


Pressing the 'Cancel' button exits without importing any data


Phone Buttons


The Back button takes you back to the Previous Screen


Notes


The import will read the entire file in chunks,
if you get out of memory errors you may need to use smaller files
email me if you need help





Select Import Source

At the start of the import you need to select the source data file.

import source title

Select the type of the source

source any file

Imports data from a file, you will be prompted to find a file;

either from a list of files in the '/bookshelf/exports' folder on the SD card or from a file explorer of your phone:

file explorer dialog

If you have a file explorer installed that isn't being detected,
enable 'Use any File Manager App' in the Settings Screen


file explorer app

source default

Import one of the files previously saved in the exports/imports folders


file explorer app

source type

Type in the full path to the file


type filename

source clipboard

Only available if there is data on the clipboard

It is required to be in the same format as data saved to the clipboard




Main Menu

Accessed by pressing the menu button.

settings

Opens the Settings Screen

app info

Displays help options

help menu


  • F.A.Q.
  • View the full FAQ page directly from the app


  • App Help
  • Where available, these App Help Pages are available either online or offline

    help choice

    (Offline help can be turned on by default in the Settings Screen)


  • Donate
  • donate for an advanced key


  • App/Download Info
  • Visit the website to check latest download info


  • Email Developer
  • You can email the developer directly


  • Tips
  • Displays the quick tips dialog

    app info


  • App Info
  • View the current app version and release notes


  • New Version Info
  • See if a new version is available (and check the main website for latest updates)

    version status





Importing Images

Specify the location of the source images

import images

You need to check the box to import images
Press the button, or the text to select the location of the source images,
(currently you will need a file explorer installed to select a different folder)
note you actually select one on of the image files in the folder with the images to import.


Images will be copied from the selected folder to the main images folder
for this reason it is best not to use the main images folder as the source location (even though the export will handle it)


The export needs to contain an column named "_id_" to link the data to an image file
all text based shelf exports from version 2.4 upwards have this column, xml exports have always had this column





Importing Duplicates

import duplicates

Duplicate entries are detected on the barcode,
they are then not imported.
Ticking this option will allow duplicate barcodes to imported





Field Mappings

Each field in the source data needs mapping to the app fields.

import source title

The name of each field from the file is displayed as a section heading

import field title

Decide if the field is being imported at all

existing app field title

You can select which app field the data will go into


The app tries to automatically match data fields with app fields, based on various similarities

(XML data will always match the in-built fields correctly)


Press the field button to select a different field:

file import field dialog


You can choose to import to a New Field using the center button

Fields that are currently hidden are indicated as [ field ]


If you import two data fields into one app field, the second data field will overwrite the first


If you don't import a shelf field, then the current shelf will be used

hidden app field title

You can still import data into hidden fields, indicated as [ field ]

new app field title

When Importing into a new field, a new custom field will be created for you

the name and type will be defined automatically, it is usually the list type


You will usually find it better to add the custom field before importing





Importing

Choose import to start the import progress.

start import

The import progress will be displayed
The import screen will close when sucessfully finished

import progress

If the import fails, you can try again via the import button





'Book Shelf' developed by Dion Hardy © 2011-2015, All rights reserved
These web pages use css, javascript and do not use cookies