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