Changes between Version 10 and Version 11 of Notifications


Ignore:
Timestamp:
Nov 3, 2009, 9:44:54 AM (15 years ago)
Author:
romw
Comment:

Begin conversion of User Messages into a notification feed

Legend:

Unmodified
Added
Removed
Modified
  • Notifications

    v10 v11  
    7878If an empty result set is returned by the database, then pass the contents of feeds.xml unmodified.
    7979
     80=== Notification Supported Flag===
     81When the scheduler receives the notification flag it should add any user messages to the BOINC client feed by including a channel and a new item for each user message.
     82
     83Notification flag:
     84{{{
     85<notifications_supported />
     86}}}
     87
     88=== Scheduler Reply ===
     89User messages generally contain information the volunteer needs to know such as there isn’t enough disk space allocated to the project to run a task instance, or they weren’t assigned any work because they ran out of quota.
     90
     91Messages like a project being out of work should not be included in the notification stream.
     92
     93Where possible, notification messages should contain information on how to correct the problem.
     94
     95Channel items:
     96{{{
     97<channel>
     98    <item>
     99        <description>I need more disk space</description>
     100        <pubDate>Mon, 30 Sep 2002 01:56:02 GMT</pubDate>
     101        <guid>http://www.example.com/1</guid>
     102    </item>
     103    <item>
     104        <description>I need more memory</description>
     105        <pubDate>Sun, 29 Sep 2002 19:59:01 GMT</pubDate>
     106        <guid>http://www.example.com/2</guid>
     107    </item>
     108</channel>
     109
     110}}}
     111
     112|| Item Elements || Default value || Description ||
     113|| description || <null> || An xml encoded message that the volunteer needs to act on ||
     114|| pubDate || <scheduler reply time> || RFC 822 representation of the scheduler reply time ||
     115|| guid || <null> || Unique message ID prefixed with the master URL of the project ||
     116
    80117== Project Website ==
    81118A project’s website is the main focal point for adding and removing notification feeds.