FS/FS/svc_acct_pop.pm

   1 package FS::svc_acct_pop;
   2
   3 use strict;
   4 use vars qw( @ISA @EXPORT_OK @svc_acct_pop %svc_acct_pop );
   5 use FS::Record qw( qsearch qsearchs );
   6
   7 @ISA = qw( FS::Record Exporter );
   8 @EXPORT_OK = qw( popselector );
   9
  10 =head1 NAME
  11
  12 FS::svc_acct_pop - Object methods for svc_acct_pop records
  13
  14 =head1 SYNOPSIS
  15
  16   use FS::svc_acct_pop;
  17
  18   $record = new FS::svc_acct_pop \%hash;
  19   $record = new FS::svc_acct_pop { 'column' => 'value' };
  20
  21   $error = $record->insert;
  22
  23   $error = $new_record->replace($old_record);
  24
  25   $error = $record->delete;
  26
  27   $error = $record->check;
  28
  29   $html = FS::svc_acct_pop::popselector( $popnum, $state );
  30
  31 =head1 DESCRIPTION
  32
  33 An FS::svc_acct object represents an point of presence.  FS::svc_acct_pop
  34 inherits from FS::Record.  The following fields are currently supported:
  35
  36 =over 4
  37
  38 =item popnum - primary key (assigned automatically for new accounts)
  39
  40 =item city
  41
  42 =item state
  43
  44 =item ac - area code
  45
  46 =item exch - exchange
  47
  48 =item loc - rest of number
  49
  50 =back
  51
  52 =head1 METHODS
  53
  54 =over 4
  55
  56 =item new HASHREF
  57
  58 Creates a new point of presence (if only it were that easy!).  To add the
  59 point of presence to the database, see L<"insert">.
  60
  61 =cut
  62
  63 sub table { 'svc_acct_pop'; }
  64
  65 =item insert
  66
  67 Adds this point of presence to the database.  If there is an error, returns the
  68 error, otherwise returns false.
  69
  70 =item delete
  71
  72 Removes this point of presence from the database.
  73
  74 =item replace OLD_RECORD
  75
  76 Replaces OLD_RECORD with this one in the database.  If there is an error,
  77 returns the error, otherwise returns false.
  78
  79 =item check
  80
  81 Checks all fields to make sure this is a valid point of presence.  If there is
  82 an error, returns the error, otherwise returns false.  Called by the insert
  83 and replace methods.
  84
  85 =cut
  86
  87 sub check {
  88   my $self = shift;
  89
  90     $self->ut_numbern('popnum')
  91       or $self->ut_text('city')
  92       or $self->ut_text('state')
  93       or $self->ut_number('ac')
  94       or $self->ut_number('exch')
  95       or $self->ut_numbern('loc')
  96   ;
  97
  98 }
  99
 100 =item text
 101
 102 Returns:
 103
 104 "$city, $state ($ac)/$exch"
 105
 106 =cut
 107
 108 sub text {
 109   my $self = shift;
 110   $self->city. ', '. $self->state.
 111     ' ('. $self->ac. ')/'. $self->exch. '-'. $self->loc;
 112 }
 113
 114 =back
 115
 116 =head1 SUBROUTINES
 117
 118 =over 4
 119
 120 =item popselector [ POPNUM [ STATE ] ]
 121
 122 =cut
 123
 124 sub popselector {
 125   my( $popnum, $state ) = @_;
 126
 127   unless ( @svc_acct_pop ) { #cache pop list
 128     @svc_acct_pop = qsearch('svc_acct_pop', {} );
 129     %svc_acct_pop = ();
 130     push @{$svc_acct_pop{$_->state}}, $_ foreach @svc_acct_pop;
 131   }
 132
 133   my $text = <<END;
 134     <SCRIPT>
 135     function opt(what,href,text) {
 136       var optionName = new Option(text, href, false, false)
 137       var length = what.length;
 138       what.options[length] = optionName;
 139     }
 140
 141     function popstate_changed(what) {
 142       state = what.options[what.selectedIndex].text;
 143       for (var i = what.form.popnum.length;i > 0;i--)
 144                 what.form.popnum.options[i] = null;
 145       what.form.popnum.options[0] = new Option("", "", false, true);
 146 END
 147
 148   foreach my $popstate ( sort { $a cmp $b } keys %svc_acct_pop ) {
 149     $text .= "\nif ( state == \"$popstate\" ) {\n";
 150
 151     foreach my $pop ( @{$svc_acct_pop{$popstate}}) {
 152       my $o_popnum = $pop->popnum;
 153       my $poptext = $pop->text;
 154       $text .= "opt(what.form.popnum, \"$o_popnum\", \"$poptext\");\n"
 155     }
 156     $text .= "}\n";
 157   }
 158
 159   $text .= "}\n</SCRIPT>\n";
 160
 161   $text .=
 162     qq!<SELECT NAME="popstate" SIZE=1 onChange="popstate_changed(this)">!.
 163     qq!<OPTION> !;
 164   $text .= "<OPTION>$_" foreach sort { $a cmp $b } keys %svc_acct_pop;
 165   $text .= '</SELECT>'; #callback? return 3 html pieces?  #'</TD><TD>';
 166
 167   $text .= qq!<SELECT NAME="popnum" SIZE=1><OPTION> !;
 168   foreach my $pop ( @svc_acct_pop ) {
 169     $text .= qq!<OPTION VALUE="!. $pop->popnum. '"'.
 170              ( ( $popnum && $pop->popnum == $popnum ) ? ' SELECTED' : '' ). ">".
 171              $pop->text;
 172   }
 173   $text .= '</SELECT>';
 174
 175   $text;
 176
 177 }
 178
 179 =back
 180
 181 =head1 VERSION
 182
 183 $Id: svc_acct_pop.pm,v 1.6 2001-12-18 06:29:30 ivan Exp $
 184
 185 =head1 BUGS
 186
 187 It should be renamed to part_pop.
 188
 189 popselector?  putting web ui components in here?  they should probably live
 190 somewhere else...
 191
 192 =head1 SEE ALSO
 193
 194 L<FS::Record>, L<FS::svc_acct>, L<FS::part_pop_local>, schema.html from the
 195 base documentation.
 196
 197 =cut
 198
 199 1;
 200