Major Changes in dbCCP4i

Changes in Version 0.3

DBviewer

• Add an icon on the job node. If a job has subjobs, in the upper left side, a star '*' is shown.
• Add an up arrow, allow to go from subjob view to top lever job view.
• Replaced textual buttons on tool bar with a set of icons e.g. for zooming in/zooming out etc.
• Uses colour scheme from CCP4i if user has specified custom colours in CCP4i.

DB handler

• Added support for subjobs: it is possible to create jobs within jobs, to represent substeps of a larger process (for example, automated pipeline).
• Added implementation of demonstration SQLite knowledge base.
• Large number of bugs addressed.

Client API

• Added namespacing to Tcl client API: prepend ::dbClientAPI:: to commands or use namespace import.
• Fixed bug where Tcl client API failed if sourced more than once.
• Tcl and Python client APIs updated with commands for interacting with subjobs.
• Tcl client API has functions for interacting with generic SQLite tables, plus additional functions for interacting with demonstration knowledge base.

Changes in Version 0.2

General

• Tested on Windows.
• Installation/setup: the GRAPHVIZ_BIN environment variable is no longer required by dbviewer and has been removed.

DBviewer

• Added 'view Files' feature. Now files including log file, input files, output files and notebook can be viewed from the menu when right click over the job node.
• Added 'select related jobs'. Now any job node, you can select all jobs that directly or in-directly related to the job, including all children and parents.
• Added user's preferences. Now it is possible to save the changes in appearance menu.
• Added 'scale' menu. It is possible to enlarge or shrink the graph by selecting different scale.
• Added 'node' menu. It is allowed to choose to show 'title' or 'taskname' in the job node.
• Add an icon at lower right hand side on job node. If the 'JobQuality' is 1, the icon is a tick; if the 'JobQuality' is -1, the icon is a cross; if the 'JobQuality' is 0, the icon is a question mark.
• Add Zoom in(+)/Zoom out(-) button.

DB handler

• Added 'AddInputFile', 'AddOutputFile', 'ListInputFiles','ListOutputFiles', 'DbReadable', 'DbWriteable', 'DbReacquire' commands.
• Make major command name changes. (see also name changes in API.
• Add a SQLite backend for each project to store JobQuality data.
• Change the broadcast message. Now the xml tags for broadcast message is:

  <db_broadcast>
  <message></message>
  <project></project>
  <jobid></jobid>
  <operation></operation>
  <agent></agent>
  </db_broadcast>
  

• Add 'GetDbItems' command.
• Replace 'database' class with 'ProjectDB' class.
• Add 'AddSubJob','SelectSubJobs','HasSubJobs' commands.

Client API

• Major changes in python API. Now if handler response is 'OK', API returns the actural result. If handler response is 'ERROR', API raises 'DBError' exception.
• In python API,Change DbRegister, now it takes two arguments, user_agent and broadcast flag.
• In python API, changes in handler connection: Remove 'DbStartHander' & 'DbRegister'. HandlerConnection initialisation takes two arguments: user agent and broadcast flag. There are major changes in the name of the methods/procedures. The following table show the changes names in both python & tcl API. tr>

  Old Name	New Name
  handlerconnection	HandlerConnection (only in python)
  OpenDatabase	OpenProject
  CreateDatabase	CreateProject
  CloseDatabase	CloseProject
  NewRecord	NewJob
  DeleteRecord	DeleteJob
  DbReadable	ProjectReadable
  DbWriteable	ProjectWriteable
  DbReacquire	ReacquireProject
  GetAllLinks	GetAllFileLinks
  GetLinks	GetFileLinks
  ListDefDirs	ListDataDirs
  AddDefDirRef	AddDataDirRef
  DeleDefDirRef	DeleteDataDirRef
  GetDefDir	GetDataDir

• In Tcl API, change DbHandlerConnect, add two arguments: userAgent and broadcastFlag.
• In Tcl API, add four procedures:
  • cacheProject: This stores a project data in a database array for use. This can be called from client application when open a project.
  • updateCachedJob: This updates a job in cache. This procedure is called within Client API when receives broadcast message.
  • deleteCachedJob: This deletes a job from cache. This procedure is called within Client API when receives broadcast message.
  • getCachedData: retrives data from the cached project.
  • Add 'AddSubJob','SelectSubJobs','HasSubJobs' commands in both Tcl & python API..

Last Update: $Date: 2008/02/14 15:25:14 $