Changes between Version 10 and Version 11 of XmlStats

Timestamp:

May 19, 2014, 12:23:38 AM (11 years ago)

Author:

davea

Comment:

--

XmlStats

@@ -1 +1 @@
 = Project statistics data =
 
-Projects export statistics data in XML-format files. Most projects regenerate the files every 24 hours. These files are contained in a download directory, usually PROJECT_URL/stats/.
+Projects export statistics data in XML-format files.
+Most projects regenerate the files every 24 hours.
+These files are contained in a download directory, usually PROJECT_URL/stats/.
 
 The download directory contains the following files:
 
  '''tables.xml'''::
-        This gives the total number of records for each entity type (team, user, and host). It also includes the UNIX time when the files were last generated, and a list of the project's applications, with counts of various things. For example:
+        This gives the total number of teams, users, and hosts.
+        It also includes the UNIX time when the files were last generated,
+        a list of the project's applications,
+        and the list of [BadgeDoc badges] defined by the project.
+        For example:
 {{{
 <tables>
@@ -23 +29 @@
         ...
     </applications>
+    <badges>
+       <badge>
+           <id>10</id>
+           <name>user_pct_2</name>
+           <title>Top 25% in average credit</name>
+           <image_url>img/pct_25.png</image_url>
+       </badge>
+         ...
+    </badges>
 </tables>
 }}}
@@ -32 +47 @@
  '''user.gz'''::
         List of users
+ '''badge_user.gz''':: list of user badge assignments
+ '''badge_team.gz''':: list of team badge assignments
 
+The format of the various XML elements in the output files is as follows.
+ Notes:
 
-The format of the various XML elements in the output files is as follows.  Notes:
-
- * `<cpid>` ('[CrossProjectId cross-project identifier]') is a unique identifier across multiple projects. Accounts with the same email address on different projects will have the same cross-project identifier (as long as at least one computer is attached to both accounts).
- * All 'expavg_credit' values were computed at some point in the past (given by 'expavg_time'). To compute their current values, they must be scaled according to the [CreditStats#rac-decay RAC decay formula].
- * Text fields may contain XML entities. If you aren't using a real XML parser, you need to decode the entities yourself.
+ * `<cpid>` ('cross-project identifier') is a unique identifier across multiple projects.
+  Accounts with the same email address on different projects will have the same cross-project identifier
+  (as long as at least one computer is attached to both accounts).
+ * All 'expavg_credit' values were computed at some point in the past (given by 'expavg_time').
+  To compute their current values, they must be scaled according to the
+  [CreditStats#rac-decay RAC decay formula].
+ * Text fields may contain XML entities.
+  If you aren't using a real XML parser, you need to decode the entities yourself.
 
 '''Team summary'''