package FS::Record; use strict; use vars qw($dbdef_file $dbdef $setup_hack $AUTOLOAD @ISA @EXPORT_OK); use subs qw(reload_dbdef); use Exporter; use Carp qw(carp cluck croak confess); use File::CounterFile; use FS::UID qw(dbh checkruid swapuid getotaker datasrc); use FS::dbdef; @ISA = qw(Exporter); @EXPORT_OK = qw(dbh fields hfields qsearch qsearchs dbdef); #ask FS::UID to run this stuff for us later $FS::UID::callback{'FS::Record'} = sub { $File::CounterFile::DEFAULT_DIR = "/usr/local/etc/freeside/counters.". datasrc; $dbdef_file = "/usr/local/etc/freeside/dbdef.". datasrc; &reload_dbdef unless $setup_hack; #$setup_hack needed now? }; =head1 NAME FS::Record - Database record objects =head1 SYNOPSIS use FS::Record; use FS::Record qw(dbh fields qsearch qsearchs dbdef); $record = new FS::Record 'table', \%hash; $record = new FS::Record 'table', { 'column' => 'value', ... }; $record = qsearchs FS::Record 'table', \%hash; $record = qsearchs FS::Record 'table', { 'column' => 'value', ... }; @records = qsearch FS::Record 'table', \%hash; @records = qsearch FS::Record 'table', { 'column' => 'value', ... }; $table = $record->table; $dbdef_table = $record->dbdef_table; $value = $record->get('column'); $value = $record->getfield('column'); $value = $record->column; $record->set( 'column' => 'value' ); $record->setfield( 'column' => 'value' ); $record->column('value'); %hash = $record->hash; $hashref = $record->hashref; $error = $record->insert; #$error = $record->add; #depriciated $error = $record->delete; #$error = $record->del; #depriciated $error = $new_record->replace($old_record); #$error = $new_record->rep($old_record); #depriciated $value = $record->unique('column'); $value = $record->ut_float('column'); $value = $record->ut_number('column'); $value = $record->ut_numbern('column'); $value = $record->ut_money('column'); $value = $record->ut_text('column'); $value = $record->ut_textn('column'); $value = $record->ut_alpha('column'); $value = $record->ut_alphan('column'); $value = $record->ut_phonen('column'); $value = $record->ut_anythingn('column'); $dbdef = reload_dbdef; $dbdef = reload_dbdef "/non/standard/filename"; $dbdef = dbdef; $quoted_value = _quote($value,'table','field'); #depriciated $fields = hfields('table'); if ( $fields->{Field} ) { # etc. @fields = fields 'table'; #as a subroutine @fields = $record->fields; #as a method call =head1 DESCRIPTION (Mostly) object-oriented interface to database records. Records are currently implemented on top of DBI. FS::Record is intended as a base class for table-specific classes to inherit from, i.e. FS::cust_main. =head1 CONSTRUCTORS =over 4 =item new [ TABLE, ] HASHREF Creates a new record. It doesn't store it in the database, though. See L<"insert"> for that. Note that the object stores this hash reference, not a distinct copy of the hash it points to. You can ask the object for a copy with the I method. TABLE can only be omitted when a dervived class overrides the table method. =cut sub new { my $proto = shift; my $class = ref($proto) || $proto; my $self = {}; bless ($self, $class); $self->{'Table'} = shift unless defined ( $self->table ); my $hashref = $self->{'Hash'} = shift; foreach my $field ( $self->fields ) { $hashref->{$field}='' unless defined $hashref->{$field}; #trim the '$' and ',' from money fields for Pg (belong HERE?) #(what about Pg i18n?) if ( datasrc =~ m/Pg/ && $self->dbdef_table->column($field)->type eq 'money' ) { ${$hashref}{$field} =~ s/^\$//; ${$hashref}{$field} =~ s/\,//; } } $self; } sub create { my $proto = shift; my $class = ref($proto) || $proto; my $self = {}; bless ($self, $class); if ( defined $self->table ) { cluck "create constructor is depriciated, use new!"; $self->new(@_); } else { croak "FS::Record::create called (not from a subclass)!"; } } =item qsearch TABLE, HASHREF Searches the database for all records matching (at least) the key/value pairs in HASHREF. Returns all the records found as `FS::TABLE' objects if that module is loaded (i.e. via `use FS::cust_main;'), otherwise returns FS::Record objects. =cut sub qsearch { my($table,$record) = @_; my($dbh) = dbh; my(@fields)=grep exists($record->{$_}), fields($table); my($sth); my($statement) = "SELECT * FROM $table". ( @fields ? " WHERE ". join(' AND ', map { $record->{$_} eq '' ? ( datasrc =~ m/Pg/ ? "$_ IS NULL" : "( $_ IS NULL OR $_ = \"\" )" ) : "$_ = ". _quote($record->{$_},$table,$_) } @fields ) : '' ); $sth=$dbh->prepare($statement) or croak $dbh->errstr; #is that a little too harsh? hmm. #warn $statement #if $debug # or some such; if ( eval ' scalar(@FS::'. $table. '::ISA);' ) { map { eval 'new FS::'. $table. ' ( $sth->fetchrow_hashref );'; } ( 1 .. $sth->execute ); } else { cluck "qsearch: warning: FS::$table not loaded; returning generic FS::Record objects"; map { new FS::Record ($table,$sth->fetchrow_hashref); } ( 1 .. $sth->execute ); } } =item qsearchs TABLE, HASHREF Same as qsearch, except that if more than one record matches, it Bs but returns the first. If this happens, you either made a logic error in asking for a single item, or your data is corrupted. =cut sub qsearchs { # $result_record = &FS::Record:qsearchs('table',\%hash); my(@result) = qsearch(@_); carp "warning: Multiple records in scalar search!" if scalar(@result) > 1; #should warn more vehemently if the search was on a primary key? $result[0]; } =back =head1 METHODS =over 4 =item table Returns the table name. =cut sub table { # cluck "warning: FS::Record::table depriciated; supply one in subclass!"; my $self = shift; $self -> {'Table'}; } =item dbdef_table Returns the FS::dbdef_table object for the table. =cut sub dbdef_table { my($self)=@_; my($table)=$self->table; $dbdef->table($table); } =item get, getfield COLUMN Returns the value of the column/field/key COLUMN. =cut sub get { my($self,$field) = @_; # to avoid "Use of unitialized value" errors if ( defined ( $self->{Hash}->{$field} ) ) { $self->{Hash}->{$field}; } else { ''; } } sub getfield { my $self = shift; $self->get(@_); } =item set, setfield COLUMN, VALUE Sets the value of the column/field/key COLUMN to VALUE. Returns VALUE. =cut sub set { my($self,$field,$value) = @_; $self->{'Hash'}->{$field} = $value; } sub setfield { my $self = shift; $self->set(@_); } =item AUTLOADED METHODS $record->column is a synonym for $record->get('column'); $record->column('value') is a synonym for $record->set('column','value'); =cut sub AUTOLOAD { my($self,$value)=@_; my($field)=$AUTOLOAD; $field =~ s/.*://; if ( defined($value) ) { $self->setfield($field,$value); } else { $self->getfield($field); } } =item hash Returns a list of the column/value pairs, usually for assigning to a new hash. To make a distinct duplicate of an FS::Record object, you can do: $new = new FS::Record ( $old->table, { $old->hash } ); =cut sub hash { my($self) = @_; %{ $self->{'Hash'} }; } =item hashref Returns a reference to the column/value hash. =cut sub hashref { my($self) = @_; $self->{'Hash'}; } =item insert Inserts this record to the database. If there is an error, returns the error, otherwise returns false. =cut sub insert { my $self = shift; my $error = $self->check; return $error if $error; #single-field unique keys are given a value if false #(like MySQL's AUTO_INCREMENT) foreach ( $self->dbdef_table->unique->singles ) { $self->unique($_) unless $self->getfield($_); } #and also the primary key my $primary_key = $self->dbdef_table->primary_key; $self->unique($primary_key) if $primary_key && ! $self->getfield($primary_key); my @fields = grep defined($self->getfield($_)) && $self->getfield($_) ne "", $self->fields ; my $statement = "INSERT INTO ". $self->table. " ( ". join(', ',@fields ). ") VALUES (". join(', ',map(_quote($self->getfield($_),$self->table,$_), @fields)). ")" ; my $sth = dbh->prepare($statement) or return dbh->errstr; local $SIG{HUP} = 'IGNORE'; local $SIG{INT} = 'IGNORE'; local $SIG{QUIT} = 'IGNORE'; local $SIG{TERM} = 'IGNORE'; local $SIG{TSTP} = 'IGNORE'; local $SIG{PIPE} = 'IGNORE'; $sth->execute or return $sth->errstr; ''; } =item add Depriciated (use insert instead). =cut sub add { cluck "warning: FS::Record::add depriciated!"; insert @_; #call method in this scope } =item delete Delete this record from the database. If there is an error, returns the error, otherwise returns false. =cut sub delete { my $self = shift; my($statement)="DELETE FROM ". $self->table. " WHERE ". join(' AND ', map { $self->getfield($_) eq '' #? "( $_ IS NULL OR $_ = \"\" )" ? ( datasrc =~ m/Pg/ ? "$_ IS NULL" : "( $_ IS NULL OR $_ = \"\" )" ) : "$_ = ". _quote($self->getfield($_),$self->table,$_) } ( $self->dbdef_table->primary_key ) ? ( $self->dbdef_table->primary_key) : $self->fields ); my $sth = dbh->prepare($statement) or return dbh->errstr; local $SIG{HUP} = 'IGNORE'; local $SIG{INT} = 'IGNORE'; local $SIG{QUIT} = 'IGNORE'; local $SIG{TERM} = 'IGNORE'; local $SIG{TSTP} = 'IGNORE'; local $SIG{PIPE} = 'IGNORE'; my $rc = $sth->execute or return $sth->errstr; #not portable #return "Record not found, statement:\n$statement" if $rc eq "0E0"; undef $self; #no need to keep object! ''; } =item del Depriciated (use delete instead). =cut sub del { cluck "warning: FS::Record::del depriciated!"; &delete(@_); #call method in this scope } =item replace OLD_RECORD Replace the OLD_RECORD with this one in the database. If there is an error, returns the error, otherwise returns false. =cut sub replace { my ( $new, $old ) = ( shift, shift ); my @diff = grep $new->getfield($_) ne $old->getfield($_), $old->fields; unless ( @diff ) { carp "warning: records identical"; return ''; } return "Records not in same table!" unless $new->table eq $old->table; my $primary_key = $old->dbdef_table->primary_key; return "Can't change $primary_key" if $primary_key && ( $old->getfield($primary_key) ne $new->getfield($primary_key) ); my $error = $new->check; return $error if $error; my $statement = "UPDATE ". $old->table. " SET ". join(', ', map { "$_ = ". _quote($new->getfield($_),$old->table,$_) } @diff ). ' WHERE '. join(' AND ', map { $old->getfield($_) eq '' #? "( $_ IS NULL OR $_ = \"\" )" ? ( datasrc =~ m/Pg/ ? "$_ IS NULL" : "( $_ IS NULL OR $_ = \"\" )" ) : "$_ = ". _quote($old->getfield($_),$old->table,$_) } ( $primary_key ? ( $primary_key ) : $old->fields ) ) ; my $sth = dbh->prepare($statement) or return dbh->errstr; local $SIG{HUP} = 'IGNORE'; local $SIG{INT} = 'IGNORE'; local $SIG{QUIT} = 'IGNORE'; local $SIG{TERM} = 'IGNORE'; local $SIG{TSTP} = 'IGNORE'; local $SIG{PIPE} = 'IGNORE'; my $rc = $sth->execute or return $sth->errstr; #not portable #return "Record not found (or records identical)." if $rc eq "0E0"; ''; } =item rep Depriciated (use replace instead). =cut sub rep { cluck "warning: FS::Record::rep depriciated!"; replace @_; #call method in this scope } =item check Not yet implemented, croaks. Derived classes should provide a check method. =cut sub check { croak "FS::Record::check not implemented; supply one in subclass!"; } =item unique COLUMN Replaces COLUMN in record with a unique number. Called by the B method on primary keys and single-field unique columns (see L). Returns the new value. =cut sub unique { my($self,$field) = @_; my($table)=$self->table; croak("&FS::UID::checkruid failed") unless &checkruid; croak "Unique called on field $field, but it is ", $self->getfield($field), ", not null!" if $self->getfield($field); #warn "table $table is tainted" if is_tainted($table); #warn "field $field is tainted" if is_tainted($field); &swapuid; my($counter) = new File::CounterFile "$table.$field",0; # hack for web demo # getotaker() =~ /^([\w\-]{1,16})$/ or die "Illegal CGI REMOTE_USER!"; # my($user)=$1; # my($counter) = new File::CounterFile "$user/$table.$field",0; # endhack my($index)=$counter->inc; $index=$counter->inc while qsearchs($table,{$field=>$index}); #just in case &swapuid; $index =~ /^(\d*)$/; $index=$1; $self->setfield($field,$index); } =item ut_float COLUMN Check/untaint floating point numeric data: 1.1, 1, 1.1e10, 1e10. May not be null. If there is an error, returns the error, otherwise returns false. =cut sub ut_float { my($self,$field)=@_ ; ($self->getfield($field) =~ /^(\d+\.\d+)$/ || $self->getfield($field) =~ /^(\d+)$/ || $self->getfield($field) =~ /^(\d+\.\d+e\d+)$/ || $self->getfield($field) =~ /^(\d+e\d+)$/) or return "Illegal or empty (float) $field: ". $self->getfield($field); $self->setfield($field,$1); ''; } =item ut_number COLUMN Check/untaint simple numeric data (whole numbers). May not be null. If there is an error, returns the error, otherwise returns false. =cut sub ut_number { my($self,$field)=@_; $self->getfield($field) =~ /^(\d+)$/ or return "Illegal or empty (numeric) $field: ". $self->getfield($field); $self->setfield($field,$1); ''; } =item ut_numbern COLUMN Check/untaint simple numeric data (whole numbers). May be null. If there is an error, returns the error, otherwise returns false. =cut sub ut_numbern { my($self,$field)=@_; $self->getfield($field) =~ /^(\d*)$/ or return "Illegal (numeric) $field: ". $self->getfield($field); $self->setfield($field,$1); ''; } =item ut_money COLUMN Check/untaint monetary numbers. May be negative. Set to 0 if null. If there is an error, returns the error, otherwise returns false. =cut sub ut_money { my($self,$field)=@_; $self->setfield($field, 0) if $self->getfield($field) eq ''; $self->getfield($field) =~ /^(\-)? ?(\d*)(\.\d{2})?$/ or return "Illegal (money) $field: ". $self->getfield($field); #$self->setfield($field, "$1$2$3" || 0); $self->setfield($field, ( ($1||''). ($2||''). ($3||'') ) || 0); ''; } =item ut_text COLUMN Check/untaint text. Alphanumerics, spaces, and the following punctuation symbols are currently permitted: ! @ # $ % & ( ) - + ; : ' " , . ? / May not be null. If there is an error, returns the error, otherwise returns false. =cut sub ut_text { my($self,$field)=@_; $self->getfield($field) =~ /^([\w \!\@\#\$\%\&\(\)\-\+\;\:\'\"\,\.\?\/]+)$/ or return "Illegal or empty (text) $field: ". $self->getfield($field); $self->setfield($field,$1); ''; } =item ut_textn COLUMN Check/untaint text. Alphanumerics, spaces, and the following punctuation symbols are currently permitted: ! @ # $ % & ( ) - + ; : ' " , . ? / May be null. If there is an error, returns the error, otherwise returns false. =cut sub ut_textn { my($self,$field)=@_; $self->getfield($field) =~ /^([\w \!\@\#\$\%\&\(\)\-\+\;\:\'\"\,\.\?\/]*)$/ or return "Illegal (text) $field: ". $self->getfield($field); $self->setfield($field,$1); ''; } =item ut_alpha COLUMN Check/untaint alphanumeric strings (no spaces). May not be null. If there is an error, returns the error, otherwise returns false. =cut sub ut_alpha { my($self,$field)=@_; $self->getfield($field) =~ /^(\w+)$/ or return "Illegal or empty (alphanumeric) $field: ". $self->getfield($field); $self->setfield($field,$1); ''; } =item ut_alpha COLUMN Check/untaint alphanumeric strings (no spaces). May be null. If there is an error, returns the error, otherwise returns false. =cut sub ut_alphan { my($self,$field)=@_; $self->getfield($field) =~ /^(\w*)$/ or return "Illegal (alphanumeric) $field: ". $self->getfield($field); $self->setfield($field,$1); ''; } =item ut_phonen COLUMN Check/untaint phone numbers. May be null. If there is an error, returns the error, otherwise returns false. =cut sub ut_phonen { my($self,$field)=@_; my $phonen = $self->getfield($field); if ( $phonen eq '' ) { $self->setfield($field,''); } else { $phonen =~ s/\D//g; $phonen =~ /^(\d{3})(\d{3})(\d{4})(\d*)$/ or return "Illegal (phone) $field: ". $self->getfield($field); $phonen = "$1-$2-$3"; $phonen .= " x$4" if $4; $self->setfield($field,$phonen); } ''; } =item ut_anything COLUMN Untaints arbitrary data. Be careful. =cut sub ut_anything { my($self,$field)=@_; $self->getfield($field) =~ /^(.*)$/ or return "Illegal $field: ". $self->getfield($field); $self->setfield($field,$1); ''; } =item fields [ TABLE ] This can be used as both a subroutine and a method call. It returns a list of the columns in this record's table, or an explicitly specified table. (See L). =cut # Usage: @fields = fields($table); # @fields = $record->fields; sub fields { my $something = shift; my $table; if ( ref($something) ) { $table = $something->table; } else { $table = $something; } #croak "Usage: \@fields = fields(\$table)\n or: \@fields = \$record->fields" unless $table; my($table_obj) = $dbdef->table($table); croak "Unknown table $table" unless $table_obj; $table_obj->columns; } =head1 SUBROUTINES =over 4 =item reload_dbdef([FILENAME]) Load a database definition (see L), optionally from a non-default filename. This command is executed at startup unless I<$FS::Record::setup_hack> is true. Returns a FS::dbdef object. =cut sub reload_dbdef { my $file = shift || $dbdef_file; $dbdef = load FS::dbdef ($file); } =item dbdef Returns the current database definition. See L. =cut sub dbdef { $dbdef; } =item _quote VALUE, TABLE, COLUMN This is an internal function used to construct SQL statements. It returns VALUE DBI-quoted (see L) unless VALUE is a number and the column type (see L) does not end in `char' or `binary'. =cut sub _quote { my($value,$table,$field)=@_; my($dbh)=dbh; if ( $value =~ /^\d+(\.\d+)?$/ && # ! ( datatype($table,$field) =~ /^char/ ) ! ( $dbdef->table($table)->column($field)->type =~ /(char|binary)$/i ) ) { $value; } else { $dbh->quote($value); } } =item hfields TABLE This is depriciated. Don't use it. It returns a hash-type list with the fields of this record's table set true. =cut sub hfields { carp "warning: hfields is depriciated"; my($table)=@_; my(%hash); foreach (fields($table)) { $hash{$_}=1; } \%hash; } #sub _dump { # my($self)=@_; # join("\n", map { # "$_: ". $self->getfield($_). "|" # } (fields($self->table)) ); #} #sub DESTROY { # my $self = shift; # #use Carp qw(cluck); # #cluck "DESTROYING $self"; # warn "DESTROYING $self"; #} #sub is_tainted { # return ! eval { join('',@_), kill 0; 1; }; # } =back =head1 VERSION $Id: Record.pm,v 1.16 1999-04-10 07:03:38 ivan Exp $ =head1 BUGS This module should probably be renamed, since much of the functionality is of general use. It is not completely unlike Adapter::DBI (see below). Exported qsearch and qsearchs should be depriciated in favor of method calls (against an FS::Record object like the old search and searchs that qsearch and qsearchs were on top of.) The whole fields / hfields mess should be removed. The various WHERE clauses should be subroutined. table string should be depriciated in favor of FS::dbdef_table. No doubt we could benefit from a Tied hash. Documenting how exists / defined true maps to the database (and WHERE clauses) would also help. The ut_ methods should ask the dbdef for a default length. ut_sqltype (like ut_varchar) should all be defined A fallback check method should be provided whith uses the dbdef. The ut_money method assumes money has two decimal digits. The Pg money kludge in the new method only strips `$'. The ut_phonen method assumes US-style phone numbers. The _quote function should probably use ut_float instead of a regex. All the subroutines probably should be methods, here or elsewhere. Probably should borrow/use some dbdef methods where appropriate (like sub fields) =head1 SEE ALSO L, L, L Adapter::DBI from Ch. 11 of Advanced Perl Programming by Sriram Srinivasan. =head1 HISTORY ivan@voicenet.com 97-jun-2 - 9, 19, 25, 27, 30 DBI version ivan@sisd.com 97-nov-8 - 12 cleaned up, added autoloaded $self->any_field calls, moved DBI login stuff to FS::UID ivan@sisd.com 97-nov-21-23 since AUTO_INCREMENT is MySQL specific, use my own unique number generator (again) ivan@sisd.com 97-dec-4 untaint $user in unique (web demo hack...bah) make unique skip multiple-field unique's from dbdef ivan@sisd.com 97-dec-11 merge with FS::Search, which after all was just alternate constructors for FS::Record objects. Makes lots of things cleaner. :) ivan@sisd.com 97-dec-13 use FS::dbdef::primary key in replace searches, hopefully for all practical purposes the string/number problem in SQL statements should be gone? (SQL bites) ivan@sisd.com 98-jan-20 Put all SQL statments in $statment before we $sth=$dbh->prepare( them, for debugging reasons (warn $statement) ivan@sisd.com 98-feb-19 (sigh)... use dbdef type (char, etc.) instead of a regex to decide what to quote in _quote (more sillines...) SQL bites. ivan@sisd.com 98-feb-20 more friendly error messages ivan@sisd.com 98-mar-13 Added import of datasrc from FS::UID to allow Pg6.3 to work Added code to right-trim strings read from Pg6.3 databases Modified 'add' to only insert fields that actually have data Added ut_float to handle floating point numbers (for sales tax). Pg6.3 does not have a "SHOW FIELDS" statement, so I faked it 8). bmccane@maxbaud.net 98-apr-3 commented out Pg wrapper around `` Modified 'add' to only insert fields that actually have data '' ivan@sisd.com 98-apr-16 dbdef usage changes ivan@sisd.com 98-jun-1 sub fields now asks dbdef, not database ivan@sisd.com 98-jun-2 added debugging method ->_dump ivan@sisd.com 98-jun-16 use FS::dbdef::primary key in delete searches as well as replace searches (SQL still bites) ivan@sisd.com 98-jun-22 sub dbdef_table ivan@sisd.com 98-jun-28 removed Pg wrapper around `` Modified 'add' to only insert fields that actually have data '' ivan@sisd.com 98-jul-14 sub fields croaks on errors ivan@sisd.com 98-jul-17 $rc eq '0E0' doesn't mean we couldn't delete for all rdbmss ivan@sisd.com 98-jul-18 commented out code to right-trim strings read from Pg6.3 databases; ChopBlanks is in UID.pm ivan@sisd.com 98-aug-16 added code (with Pg wrapper) to deal with Pg money fields ivan@sisd.com 98-aug-18 added pod documentation ivan@sisd.com 98-sep-6 ut_phonen got ''; at the end ivan@sisd.com 98-sep-27 $Log: Record.pm,v $ Revision 1.16 1999-04-10 07:03:38 ivan return the value with ut_* error messages, to assist in debugging Revision 1.15 1999/04/08 12:08:59 ivan fix up PostgreSQL money fields so you can actually use them as numbers. bah. Revision 1.14 1999/04/07 14:58:31 ivan more kludges to get around different null/empty handling in Perl vs. MySQL vs. PostgreSQL etc. Revision 1.13 1999/03/29 11:55:43 ivan eliminate warnings in ut_money Revision 1.12 1999/01/25 12:26:06 ivan yet more mod_perl stuff Revision 1.11 1999/01/18 09:22:38 ivan changes to track email addresses for email invoicing Revision 1.10 1998/12/29 11:59:33 ivan mostly properly OO, some work still to be done with svc_ stuff Revision 1.9 1998/11/21 07:26:45 ivan "Records identical" carp tells us it is just a warning. Revision 1.8 1998/11/15 11:02:04 ivan bugsquash Revision 1.7 1998/11/15 10:56:31 ivan qsearch gets sames "IS NULL" semantics as other WHERE clauses Revision 1.6 1998/11/15 05:31:03 ivan bugfix for new config layout Revision 1.5 1998/11/13 09:56:51 ivan change configuration file layout to support multiple distinct databases (with own set of config files, export, etc.) Revision 1.4 1998/11/10 07:45:25 ivan doc clarification Revision 1.2 1998/11/07 05:17:18 ivan In sub new, Pg wrapper for money fields from dbdef (FS::Record::fields $table), not keys of supplied hashref. =cut 1;