1 package FS::inventory_item;
5 use FS::Record qw( qsearch qsearchs );
6 use FS::inventory_class;
12 FS::inventory_item - Object methods for inventory_item records
16 use FS::inventory_item;
18 $record = new FS::inventory_item \%hash;
19 $record = new FS::inventory_item { 'column' => 'value' };
21 $error = $record->insert;
23 $error = $new_record->replace($old_record);
25 $error = $record->delete;
27 $error = $record->check;
31 An FS::inventory_item object represents a specific piece of (real or virtual)
32 inventory, such as a specific DID or serial number. FS::inventory_item
33 inherits from FS::Record. The following fields are currently supported:
37 =item itemnum - primary key
39 =item classnum - Inventory class (see L<FS::inventory_class>)
41 =item item - Item identifier (unique within its inventory class)
43 =item svcnum - Customer servcie (see L<FS::cust_svc>)
53 Creates a new item. To add the item to the database, see L<"insert">.
55 Note that this stores the hash reference, not a distinct copy of the hash it
56 points to. You can ask the object for a copy with the I<hash> method.
60 # the new method can be inherited from FS::Record, if a table method is defined
62 sub table { 'inventory_item'; }
66 Adds this record to the database. If there is an error, returns the error,
67 otherwise returns false.
71 # the insert method can be inherited from FS::Record
75 Delete this record from the database.
79 # the delete method can be inherited from FS::Record
81 =item replace OLD_RECORD
83 Replaces the OLD_RECORD with this one in the database. If there is an error,
84 returns the error, otherwise returns false.
88 # the replace method can be inherited from FS::Record
92 Checks all fields to make sure this is a valid item. If there is
93 an error, returns the error, otherwise returns false. Called by the insert
98 # the check method should currently be supplied - FS::Record contains some
99 # data checking routines
105 $self->ut_numbern('itemnum')
106 || $self->ut_foreign_key('classnum', 'inventory_class', 'classnum' )
107 || $self->ut_text('item')
108 || $self->ut_numbern('svcnum')
110 return $error if $error;
121 L<FS::Record>, schema.html from the base documentation.