File: item_instance.txt

package info (click to toggle)
opendb 0.81p18-2
  • links: PTS
  • area: main
  • in suites: etch, etch-m68k
  • size: 4,716 kB
  • ctags: 6,787
  • sloc: php: 50,213; sql: 3,098; sh: 272; makefile: 54; xml: 48
file content (58 lines) | stat: -rw-r--r-- 2,466 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
Item Instance issues
--------------------

1)	Introduction

	Item instance functionality allows you to represent multiple
	'copies' of the same item.  For example you may have more than
	one copy of Gladiator in your database.   The actual ownership
	of items is represented at the item_instance level, so you
	can also have multiple instances of an item with different
	owners.

	For example, three different people might have Gladiator, and
	instead of having three distinct items, with reviews as well,
	you can have one, and have the item instances referencing it
	for each owner.

2) Configuration

	Two config variables $CONFIG_VARS['item_input.item_instance_support'] and 
	$item_input['new_instance_owner_only'] have been added to control
	whether you want to enable this functionality and whether instances
	can be across owners.  You will notice a few small changes to 
	item_display.php, especially the 'Status Info:', is now 'Instance Info'.
	
	When item_instance_support is active all item_instances for the current
	title will be displayed.  The actual item_instance being edited (For 
	s_status_type,etc) will be highlighted with a tick.

	Setting $CONFIG_VARS['item_input.new_instance_owner_only']=TRUE, only affects the
	creation of new instances.  All existing instances will be displayed
	in the 'Instance Info' section of item_display.php regardless of
	owner.  This only happens if $CONFIG_VARS['item_input.new_instance_owner_only'] was
	once set to FALSE.

	When a user chooses to 'Delete Item', they are actually deleting the item
	instance.  If once the item instance is deleted, no more instances exist,
	the item will also be deleted.

3)	Issues

	If there are two instance of an item, and the first one is deleted,
	the item_instance instance_no will still be 2.

	If you have $item_input['new_instance_owner_only']=FALSE users besided the
	original owner can add a new instances (copies) of an item and then edit
	the actual item contents as a result.

	If a user updates an instance of an item, and attributes, etc are
	reflected for all instances.

	If the system allows instances belonging to two different users to
	be linked to the one item, then both users have the right to update
	records.  This creates problems when both users are attempting to
	update a record at once.  If one user deletes the item, and
	another user submits a clone request for the item, the second action
	will not work, and the user will lose their work.