[annotator-dev] Using annotateit

Nick Stenning nick.stenning at okfn.org
Wed Sep 28 15:42:23 UTC 2011

Hi there Joyce,

Sorry for taking so long to get back to you on this one. So, to
respond your two issues separately:

1) Implementation of an Annotator backend on Microsoft/IIS technology.

I'm afraid I can't be of much help here -- I know next to nothing
about IIS and about development of Microsoft systems. That said, the
Annotator protocol is documented at


See also the documentation for the "Store" plugin -- the piece of
frontend that communicates with the storage API:


But, fundamentally, the specification is the code of the Annotator Store, at


so I suggest your developers look carefully at what this application
does, and what API it exposes to the Annotator.

If you have specific questions about the "wire format" or the REST
API, please do ask on the mailing list and I (or others) will help you

2) Annotations not showing up in "My Recent Annotations" on annotateit.org

I'll look into this and get back to you. If I look at my account I see
all the recent annotations I've made, so I'm not immediately sure
what's going wrong.

Best wishes,

> Hi Nick,
> Thanks so much for your inquiries below; I had to consult with my engineer to respond properly.  Here are my replies:
> We are using Microsoft IIS to host ASP files that render textual content for academic use. We use Microsoft SQL Server 2005 database as our back-end.
> Our sole purpose of using the Annotator is to allow users to annotate text on the rendered ASP pages and store the annotations in our SQL Server.
> Here are our responses to your questions below:
> 1) The annotations need to be stored in our SQL Server which is a part of our LAN.
> 2) Yes, our annotations need to remain private. And, thus we are concerned of storing them at annotateit.org.
> 3) Yes, because we want to ensure privacy to the users who have created annotations.
> 4) Yes, they are familiar with the technologies mentioned in your email.
> On a side note, we also created an account with annotateIt.org. Is there a way to view all the entered annotations and manage them in AnnotateIt?
> When I go to My Account section after logging in to AnnotateIt, I see a "Recent Annotations" section at the bottom of the page. But, there are no annotations listed there even though I have entered them on my web page?
> In the HTML file, I included the following code snippet:
> .annotator('addPlugin', 'Store', {
> prefix: 'http://annotateit.org/api'
> })
> .annotator('addPlugin', 'Auth', {
> userId: 'userID',
> consumerKey: 'Account ID as listed when I login to my AnnotateIt account',
> accountId: 'Account ID as listed when I login to my AnnotateIt account',
> authToken: 'Auth Token as listed when I login to my AnnotateIt account'
> });
> That's all I did. In this way, the annotations persists when I reopen the HTML page, but they do not show up in the "Recent Annotations" section in my AnnotateIt account.
> Any help would be appreciated.
> Thanks,
> Joyce

More information about the annotator-dev mailing list