Changes between Version 2 and Version 3 of TracDev/DataModels

Timestamp:

Oct 28, 2005, 4:32:51 AM (19 years ago)

Author:

Felix Collins

Comment:

Added an example for using the ticket model

TracDev/DataModels

@@ -13 +13 @@
 }}}
 
+The fields on a model object can be edited by treating the object as a dictionary.  If you change any of the fields you must call save_changes() to have them persisted.
+
+To edit a ticket...
+{{{
+#!python
+  import trac.env
+  import trac.ticket.model
+
+  # Open Trac environment
+  t = trac.env.Environment("path/to/trac/env")
+  
+  # Get the ticket you are after (how can we query for tickets?)
+  myticket = trac.ticket.model.Ticket(t, tkt_id=1)
+
+  # Read a ticket field
+  print "Changing description for ticket called %s" %myticket["summary"]
+
+  #Write a ticket field
+  myticket["description"] = "My ticket now has a new description."
+
+  #Save your changes
+  myticket.save_changes("myusername","Just changed the description")
+}}}
+  
 For usage examples, see [source:/trunk/trac/ticket/web_ui.py trac.ticket.web_ui].