FS/FS/h_cust_svc.pm

   1 package FS::h_cust_svc;
   2
   3 use strict;
   4 use vars qw( @ISA $DEBUG );
   5 use Carp;
   6 use FS::Record qw(qsearchs);
   7 use FS::h_Common;
   8 use FS::cust_svc;
   9
  10 @ISA = qw( FS::h_Common FS::cust_svc );
  11
  12 $DEBUG = 0;
  13
  14 sub table { 'h_cust_svc'; }
  15
  16 =head1 NAME
  17
  18 FS::h_cust_svc - Object method for h_cust_svc objects
  19
  20 =head1 SYNOPSIS
  21
  22 =head1 DESCRIPTION
  23
  24 An FS::h_cust_svc object  represents a historical service.  FS::h_cust_svc
  25 inherits from FS::h_Common and FS::cust_svc.
  26
  27 =head1 METHODS
  28
  29 =over 4
  30
  31 =item label END_TIMESTAMP [ START_TIMESTAMP ]
  32
  33 Returns a list consisting of:
  34 - The name of this historical service (from part_svc)
  35 - A meaningful identifier (username, domain, or mail alias)
  36 - The table name (i.e. svc_domain) for this historical service
  37
  38 =cut
  39
  40 sub label {
  41   my $self = shift;
  42   carp "FS::h_cust_svc::label called on $self" if $DEBUG;
  43   my $svc_x = $self->h_svc_x(@_)
  44     or die "can't find h_". $self->part_svc->svcdb. '.svcnum '. $self->svcnum;
  45   $self->_svc_label($svc_x, @_);
  46 }
  47
  48 =item h_svc_x END_TIMESTAMP [ START_TIMESTAMP ]
  49
  50 Returns the FS::h_svc_XXX object for this service as of END_TIMESTAMP (i.e. an
  51 FS::h_svc_acct object or FS::h_svc_domain object, etc.) and (optionally) not
  52 cancelled before START_TIMESTAMP.
  53
  54 =cut
  55
  56 #false laziness w/cust_pkg::h_cust_svc
  57 sub h_svc_x {
  58   my $self = shift;
  59   my $svcdb = $self->part_svc->svcdb;
  60   #if ( $svcdb eq 'svc_acct' && $self->{'_svc_acct'} ) {
  61   #  $self->{'_svc_acct'};
  62   #} else {
  63     warn "requiring FS/h_$svcdb.pm" if $DEBUG;
  64     require "FS/h_$svcdb.pm";
  65     qsearchs( "h_$svcdb",
  66               { 'svcnum'       => $self->svcnum, },
  67               "FS::h_$svcdb"->sql_h_search(@_),
  68             );
  69   #}
  70 }
  71
  72 =back
  73
  74 =head1 BUGS
  75
  76 =head1 SEE ALSO
  77
  78 L<FS::h_Common>, L<FS::cust_svc>, L<FS::Record>, schema.html from the base
  79 documentation.
  80
  81 =cut
  82
  83 1;
  84