Freeside:3:Documentation:Developer/FS/svc hardware

From Freeside
Jump to: navigation, search

NAME

FS::svc_hardware - Object methods for svc_hardware records

SYNOPSIS

 use FS::svc_hardware;

 $record = new FS::svc_hardware \%hash;
 $record = new FS::svc_hardware { 'column' => 'value' };

 $error = $record->insert;

 $error = $new_record->replace($old_record);

 $error = $record->delete;

 $error = $record->check;

DESCRIPTION

An FS::svc_hardware object represents an equipment installation, such as a wireless broadband receiver, satellite antenna, or DVR. FS::svc_hardware inherits from FS::svc_Common.

The following fields are currently supported:

svcnum - Primary key; typenum - Device type number (see FS::hardware_type); ip_addr - IP address; hw_addr - Hardware address; serial - Serial number; smartcard - Smartcard number, for devices that use a smartcard; statusnum - Service status (see FS::hardware_status); note - Installation notes: location on property, physical access, etc.

METHODS

new HASHREF
Creates a new svc_hardware object.
insert
Adds this record to the database. If there is an error, returns the error, otherwise returns false.
delete
Delete this record from the database.
replace OLD_RECORD
Replaces the OLD_RECORD with this one in the database. If there is an error, returns the error, otherwise returns false.
  1. the replace method can be inherited from FS::Record
check
Checks all fields to make sure this is a valid service. If there is an error, returns the error, otherwise returns false. Called by the insert and replace methods.
hardware_type
Returns the FS::hardware_type object associated with this installation.
status_label
Returns the 'label' field of the FS::hardware_status object associated with this installation.
display_hw_addr
Returns the 'hw_addr' field, formatted as a MAC address if the 'svc_hardware-check_mac_addr' option is enabled.

SEE ALSO

FS::Record, FS::svc_Common, schema.html from the base documentation.