Each set of Reading Tools is made up of individual tools (e.g., Related Studies, Online Forums, etc.) with each tool consisting of a number of relevant databases. These databases can be added, edited or deleted. The groupings can also be reordered.
Metadata for items in a grouping. The Journal Manager can alter the title of the tool. It also provides an option to determine whether the author's keywords (the default) or the author's name (e.g., for use with Author's Other Works) will be used for the searching of the database. A second option, used with Define Terms, allows the reader to select the search term by double clicking on any word in the text of the item being read in the journal. Journal Managers can use these options in building their own reading tools.
Edit searches for each tool. Using Search, the Journal Manager can edit or delete the search URL for each database in a tool, as well as reorder the databases that appear in the tool. For each database, a URL is provided that will enable the reader to learn more about the database, and a URL for that enables the search to be conducted using the author's keywords or the author's name (See Metadata under Contexts in Reading Tools). There are two types of searches that can be set up, a GET search, and if that will not work with the database a POST search.
GET Searches
For GET searches, run a search and look at the resulting URL. E.g., on Google, a search for "FOOBAR" gives the URL
http://www.google.ca/search?hl=en&q=FOOBAR&meta=
Since we need the parameter that specifies the search term to appear last in the URL, we can shuffle the parameters in the GET query string to give
http://www.google.ca/search?hl=en&meta=&q=FOOBAR
giving us a search URL of
http://www.google.ca/search?hl=en&meta=&q=
for the RT. However, since the other parameters are unnecessary in this case, we can use a simplified URL of
http://www.google.ca/search?q=
for the RT.
POST Searches
For POST forms, it is more complicated. Again, looking at Google, you can view the page's source, and notice<form action="/search" ...>, giving us a starting base URL ofhttp://www.google.com/search. You can then look at each of the<input ...> and<select ... > elements in the form, and add them asname=value pairs separated by& to the end of the URL. The element that specifies the textbox that accepts user-entered text (in Google's case, namedq), should go at the end of the URL asname=. So for Google we gethttp://www.google.com/search?q=.
A somewhat easier way for POST forms is to copy the HTML source to a file, changemethod=post tomethod=get in the appropriate form field, and change the form'saction= value such that it is a complete URL, e.g.,http://www.google.com/search rather than just/search. You can then view the modified HTML file in your browser and use the GET method above to construct the URL.
As some search engines do not support GET queries, if you find that the above method does not work, you can enter POST form data in the "Search post data" field. If the example given above required that the data be posted, you would enterhttp://www.google.com/search for the search URL andq= for the post data. Note that the parameter specifying the term to be searched must always come last in the post data, if applicable, and otherwise last in the search URL field.
Make sure you test the URLs make sure they work correctly, by appending a term to the URL and testing it to see if it shows the expected search results. Note that with POST forms this might not always be possible, depending on the site. For URLs that don't have proper search engines another possibility is to use Google and restrict by site. You can use a query likesite:mysite.com FOOBAR in Google to search for the term "FOOBAR" only within mysite.com. This is used in the current RTs for several sites.