Changes between Version 12 and Version 13 of S3/S3Tracking

Timestamp:

10/09/12 13:46:04 (12 years ago)

Author:

Fran Boon

Comment:

update to current

S3/S3Tracking

@@ -40 +40 @@
                         ...)
 
-s3xrc.model.configure(table,
-                      super_entity=db.sit_trackable, # <= configure sit_trackable as super-entity
-                      ...)
+s3db.configure(table,
+               super_entity=db.sit_trackable, # <= configure sit_trackable as super-entity
+               ...)
 }}}
 
@@ -54 +54 @@
                         ...)
 
-s3xrc.model.configure(table,
-                      super_entity=(db.org_site, db.sit_trackable), # <= multiple allowed!
-                      ...)
+s3db.configure(table,
+               super_entity=(db.org_site, db.sit_trackable), # <= multiple allowed!
+               ...)
 }}}
 
@@ -66 +66 @@
 
 You can create an S3Trackable by using the {{{s3tracker}}} function with the table and the record ID:
-
 {{{
 trackable = s3tracker(db.my_table, 1)
 }}}
 
-This works fine with record UUIDs too:
-
+Instead of the table, you can specify the tablename:
 {{{
-trackable = s3tracker(db.my_table, uuid="9207324b-5dc6-439b-9410-8920cbaf8a34")
-}}}
-
-Instead of the table, you can also specify the tablename:
-
-{{{
-trackable = s3tracker("my_table", uuid="9207324b-5dc6-439b-9410-8920cbaf8a34")
+trackable = s3tracker(tablename="my_table", record_id=1)
 }}}
 
 You can also specify a query:
-
 {{{
-trackable = s3tracker(db.my_table.uuid == "9207324b-5dc6-439b-9410-8920cbaf8a34")
+query = (db.my_table.uuid == "9207324b-5dc6-439b-9410-8920cbaf8a34")
+trackable = s3tracker(query=query)
 }}}
 
 or a record (must be a Row instance):
-
 {{{
 record = db(db.my_table.uuid == "9207324b-5dc6-439b-9410-8920cbaf8a34").select(limitby=(0, 1)).first()
-trackable = s3tracker(record)
-}}}
-
-or a set of records (must be a Rows instance):
-
-{{{
-records = db(db.my_table.id.belongs(1, 2, 3, 4)).select()
-trackable = s3tracker(records)
+trackable = s3tracker(record=record)
 }}}
 
@@ -115 +99 @@
 
 To retrieve the base location of an object, use {{{get_base_location()}}}:
-
 {{{
 base_location = s3tracker(db.pr_person, 1).get_base_location()
@@ -123 +106 @@
 
 To set the base location of an object, use set_base_location():
-
 {{{
 s3tracker(db.pr_person, 1).set_base_location(25) # <= use the record ID of a gis_location
@@ -129 +111 @@
 
 Other ways to specify the location:
-
 {{{
 # Using a location record
@@ -147 +128 @@
 
 When setting/retrieving the current location of an object, you can additionally specify a time point:
-
 {{{
 from datetime import datetime, timedelta
@@ -157 +137 @@
 
 To set a current location, you can use {{{set_location()}}}.
-
 {{{
 s3tracker(db.pr_person, 1).set_location(25, timestmp=datetime.utcnow())