Instructions for adding new fields

Version 5.0+ Notes

As of version 5.0 it seems like a good idea to update this section. Rather than writing exhaustive documentation, I will link to specific commits where a field was added. If necessary I will add a field to demonstrate. This is a work in progress.

To collect new data

this commit shows how new fields (price & format) were obtained from Amazon. Ignore the SearchManager changes — they were about handling ASINs better. Other search providers follow a similar pattern.

Old Notes

This is considerably changed as of (somewhere around) v3.4. See notes below.

CatalogueDBAdapter

1. Add to CREATE
2. Add to onUpgrade
3. Add to exportBooks
4. (3.4) Add to getBookFields
5. Add to fetchAllBooks (3.4: not needed)
6. Add to fetchAllBooksByAuthor (3.4: not needed)
7. Add to fetchAllBooksByLoan (3.4: not needed)
8. Add to fetchAllBooksBySeries (3.4: not needed)
9. Add to fetchBook (3.4: not needed)
10. Add to fetchBookByISBN (3.4: not needed)
11. fetchBookByISBNOrCombo (3.4: not needed)
12. Add to searchBooks (3.4: not needed)
13. Add to createBook (3.4: not needed)
14. Add to updateBook (3.4: not needed)

edit_book / edit_book_notes.xml

1. Update edit_book.xml

BookEditFields / BookEditNotes / BookEditAnthology

1. Add private class variable (3.4: not needed)
2. Add to onCreate (3.4: add a field to myFields — see, eg, KEY_PUBLISHER — may want validator, formatter etc)
3. Update populateFields (from database) (3.4: not needed, if it’s just a ‘simple’ field)
4. Update populateFields (from variable / activity – Fields only) (3.4: not needed, if it’s just a ‘simple’ field)
5. Update saveState (3.4: not needed, if it’s just a ‘simple’ field)

BookISBNSearch

1. Update comment in go
2. Update searchGoogle
3. Update searchAmazon

LibraryThingManager (3.4)
update SearchLibraryThingEntryHandler

SearchAmazonHandler

1. Create public class variable (not in 3.4)
2. update GetBook

SearchGoogleBooksEntryHandler

1. Create public class variable (not in 3.4)
2. update GetBook

FieldVisibility

1. Add to setupFields (fields, fieldRs and compulsary)

AdminstrationFunctions

1. Add to exportData (title and rows; moved in 3.4 – now in ExportThread.java)
2. Add to ImportData (not needed in 3.4)