1 package FS::access_right;
5 use FS::Record qw( qsearch qsearchs );
11 FS::access_right - Object methods for access_right records
17 $record = new FS::access_right \%hash;
18 $record = new FS::access_right { 'column' => 'value' };
20 $error = $record->insert;
22 $error = $new_record->replace($old_record);
24 $error = $record->delete;
26 $error = $record->check;
30 An FS::access_right object represents a granted access right. FS::access_right
31 inherits from FS::Record. The following fields are currently supported:
35 =item rightnum - primary key
52 Creates a new right. To add the right to the database, see L<"insert">.
54 Note that this stores the hash reference, not a distinct copy of the hash it
55 points to. You can ask the object for a copy with the I<hash> method.
59 # the new method can be inherited from FS::Record, if a table method is defined
61 sub table { 'access_right'; }
65 Adds this record to the database. If there is an error, returns the error,
66 otherwise returns false.
70 # the insert method can be inherited from FS::Record
74 Delete this record from the database.
78 # the delete method can be inherited from FS::Record
80 =item replace OLD_RECORD
82 Replaces the OLD_RECORD with this one in the database. If there is an error,
83 returns the error, otherwise returns false.
87 # the replace method can be inherited from FS::Record
91 Checks all fields to make sure this is a valid right. If there is
92 an error, returns the error, otherwise returns false. Called by the insert
97 # the check method should currently be supplied - FS::Record contains some
98 # data checking routines
104 $self->ut_numbern('rightnum')
105 || $self->ut_text('righttype')
106 || $self->ut_text('rightobjnum')
107 || $self->ut_text('rightname')
109 return $error if $error;
116 # Used by FS::Upgrade to migrate to a new database.
118 sub _upgrade_data { # class method
119 my ($class, %opts) = @_;
121 my @unmigrated = ( qsearch( 'access_right',
122 { 'righttype'=>'FS::access_group',
123 'rightname'=>'Engineering configuration',
126 qsearch( 'access_right',
127 { 'righttype'=>'FS::access_group',
128 'rightname'=>'Engineering global configuration',
132 foreach ( @unmigrated ) {
133 my $rightname = $_->rightname;
134 $rightname =~ s/Engineering/Dialup/;
135 $_->rightname($rightname);
136 my $error = $_->replace;
137 die "Failed to update access right: $error"
139 my $broadband = new FS::access_right { $_->hash };
140 $rightname =~ s/Dialup/Broadband/;
141 $broadband->rightnum('');
142 $broadband->rightname($rightname);
143 $error = $broadband->insert;
144 die "Failed to insert access right: $error"
158 L<FS::Record>, schema.html from the base documentation.