This appears to have a very awkward result. (I am using version 1.4.)
(1) I am using the Classification web service to retrieve the names of all of the categories in the repository. (2) I then use the names just found to make a list of categories presented to the user in my application. The user selects a category and then I run a query to retrieve all documents marked by that category, again using a web service.
However, it seems that the category name I need to use in step 2 above is the name specified when the category was first created. This will be different from the name returned in step 1 if the category has been renamed and so my search fails.
E.g. the user selects the category "Cars" from my list. This is the name of the category now, but when first entered it was called "Automobiles". I run my search on "Cars" and nothing is returned. If I had used "Automobiles" instead, the query would have returned the expected result.
As a workaround, I tried to find a way to retrieve the original name for a category, but have not been successful - perhaps someone else knows a way to do that. As the project is not live yet, I can delete all of the categories and enter them again with their correct names - however, it could easily happen that we will want to change a name in the future and then we have a problem.