FS/FS/cdr.pm

   1 package FS::cdr;
   2
   3 use strict;
   4 use vars qw( @ISA @EXPORT_OK $DEBUG );
   5 use Exporter;
   6 use Tie::IxHash;
   7 use Date::Parse;
   8 use Date::Format;
   9 use Time::Local;
  10 use FS::UID qw( dbh );
  11 use FS::Conf;
  12 use FS::Record qw( qsearch qsearchs );
  13 use FS::cdr_type;
  14 use FS::cdr_calltype;
  15 use FS::cdr_carrier;
  16 use FS::cdr_upstream_rate;
  17
  18 @ISA = qw(FS::Record);
  19 @EXPORT_OK = qw( _cdr_date_parser_maker _cdr_min_parser_maker );
  20
  21 $DEBUG = 0;
  22
  23 =head1 NAME
  24
  25 FS::cdr - Object methods for cdr records
  26
  27 =head1 SYNOPSIS
  28
  29   use FS::cdr;
  30
  31   $record = new FS::cdr \%hash;
  32   $record = new FS::cdr { 'column' => 'value' };
  33
  34   $error = $record->insert;
  35
  36   $error = $new_record->replace($old_record);
  37
  38   $error = $record->delete;
  39
  40   $error = $record->check;
  41
  42 =head1 DESCRIPTION
  43
  44 An FS::cdr object represents an Call Data Record, typically from a telephony
  45 system or provider of some sort.  FS::cdr inherits from FS::Record.  The
  46 following fields are currently supported:
  47
  48 =over 4
  49
  50 =item acctid - primary key
  51
  52 =item calldate - Call timestamp (SQL timestamp)
  53
  54 =item clid - Caller*ID with text
  55
  56 =item src - Caller*ID number / Source number
  57
  58 =item dst - Destination extension
  59
  60 =item dcontext - Destination context
  61
  62 =item channel - Channel used
  63
  64 =item dstchannel - Destination channel if appropriate
  65
  66 =item lastapp - Last application if appropriate
  67
  68 =item lastdata - Last application data
  69
  70 =item startdate - Start of call (UNIX-style integer timestamp)
  71
  72 =item answerdate - Answer time of call (UNIX-style integer timestamp)
  73
  74 =item enddate - End time of call (UNIX-style integer timestamp)
  75
  76 =item duration - Total time in system, in seconds
  77
  78 =item billsec - Total time call is up, in seconds
  79
  80 =item disposition - What happened to the call: ANSWERED, NO ANSWER, BUSY
  81
  82 =item amaflags - What flags to use: BILL, IGNORE etc, specified on a per channel basis like accountcode.
  83
  84 =cut
  85
  86   #ignore the "omit" and "documentation" AMAs??
  87   #AMA = Automated Message Accounting.
  88   #default: Sets the system default.
  89   #omit: Do not record calls.
  90   #billing: Mark the entry for billing
  91   #documentation: Mark the entry for documentation.
  92
  93 =item accountcode - CDR account number to use: account
  94
  95 =item uniqueid - Unique channel identifier (Unitel/RSLCOM Event ID)
  96
  97 =item userfield - CDR user-defined field
  98
  99 =item cdr_type - CDR type - see L<FS::cdr_type> (Usage = 1, S&E = 7, OC&C = 8)
 100
 101 =item charged_party - Service number to be billed
 102
 103 =item upstream_currency - Wholesale currency from upstream
 104
 105 =item upstream_price - Wholesale price from upstream
 106
 107 =item upstream_rateplanid - Upstream rate plan ID
 108
 109 =item rated_price - Rated (or re-rated) price
 110
 111 =item distance - km (need units field?)
 112
 113 =item islocal - Local - 1, Non Local = 0
 114
 115 =item calltypenum - Type of call - see L<FS::cdr_calltype>
 116
 117 =item description - Description (cdr_type 7&8 only) (used for cust_bill_pkg.itemdesc)
 118
 119 =item quantity - Number of items (cdr_type 7&8 only)
 120
 121 =item carrierid - Upstream Carrier ID (see L<FS::cdr_carrier>)
 122
 123 =cut
 124
 125 #Telstra =1, Optus = 2, RSL COM = 3
 126
 127 =item upstream_rateid - Upstream Rate ID
 128
 129 =item svcnum - Link to customer service (see L<FS::cust_svc>)
 130
 131 =item freesidestatus - NULL, done (or something)
 132
 133 =item freesiderewritestatus - NULL, done (or something)
 134
 135 =item cdrbatch
 136
 137 =back
 138
 139 =head1 METHODS
 140
 141 =over 4
 142
 143 =item new HASHREF
 144
 145 Creates a new CDR.  To add the CDR to the database, see L<"insert">.
 146
 147 Note that this stores the hash reference, not a distinct copy of the hash it
 148 points to.  You can ask the object for a copy with the I<hash> method.
 149
 150 =cut
 151
 152 # the new method can be inherited from FS::Record, if a table method is defined
 153
 154 sub table { 'cdr'; }
 155
 156 sub table_info {
 157   {
 158     'fields' => {
 159 #XXX fill in some (more) nice names
 160         #'acctid'                => '',
 161         'calldate'              => 'Call date',
 162         'clid'                  => 'Caller ID',
 163         'src'                   => 'Source',
 164         'dst'                   => 'Destination',
 165         'dcontext'              => 'Dest. context',
 166         'channel'               => 'Channel',
 167         'dstchannel'            => 'Destination channel',
 168         #'lastapp'               => '',
 169         #'lastdata'              => '',
 170         'startdate'             => 'Start date',
 171         'answerdate'            => 'Answer date',
 172         'enddate'               => 'End date',
 173         'duration'              => 'Duration',
 174         'billsec'               => 'Billable seconds',
 175         'disposition'           => 'Disposition',
 176         'amaflags'              => 'AMA flags',
 177         'accountcode'           => 'Account code',
 178         #'uniqueid'              => '',
 179         'userfield'             => 'User field',
 180         #'cdrtypenum'            => '',
 181         'charged_party'         => 'Charged party',
 182         #'upstream_currency'     => '',
 183         'upstream_price'        => 'Upstream price',
 184         #'upstream_rateplanid'   => '',
 185         #'ratedetailnum'         => '',
 186         'rated_price'           => 'Rated price',
 187         #'distance'              => '',
 188         #'islocal'               => '',
 189         #'calltypenum'           => '',
 190         #'description'           => '',
 191         #'quantity'              => '',
 192         'carrierid'             => 'Carrier ID',
 193         #'upstream_rateid'       => '',
 194         'svcnum'                => 'Freeside service',
 195         'freesidestatus'        => 'Freeside status',
 196         'freesiderewritestatus' => 'Freeside rewrite status',
 197         'cdrbatch'              => 'Batch',
 198     },
 199
 200   };
 201
 202 }
 203
 204 =item insert
 205
 206 Adds this record to the database.  If there is an error, returns the error,
 207 otherwise returns false.
 208
 209 =cut
 210
 211 # the insert method can be inherited from FS::Record
 212
 213 =item delete
 214
 215 Delete this record from the database.
 216
 217 =cut
 218
 219 # the delete method can be inherited from FS::Record
 220
 221 =item replace OLD_RECORD
 222
 223 Replaces the OLD_RECORD with this one in the database.  If there is an error,
 224 returns the error, otherwise returns false.
 225
 226 =cut
 227
 228 # the replace method can be inherited from FS::Record
 229
 230 =item check
 231
 232 Checks all fields to make sure this is a valid CDR.  If there is
 233 an error, returns the error, otherwise returns false.  Called by the insert
 234 and replace methods.
 235
 236 Note: Unlike most types of records, we don't want to "reject" a CDR and we want
 237 to process them as quickly as possible, so we allow the database to check most
 238 of the data.
 239
 240 =cut
 241
 242 sub check {
 243   my $self = shift;
 244
 245 # we don't want to "reject" a CDR like other sorts of input...
 246 #  my $error =
 247 #    $self->ut_numbern('acctid')
 248 ##    || $self->ut_('calldate')
 249 #    || $self->ut_text('clid')
 250 #    || $self->ut_text('src')
 251 #    || $self->ut_text('dst')
 252 #    || $self->ut_text('dcontext')
 253 #    || $self->ut_text('channel')
 254 #    || $self->ut_text('dstchannel')
 255 #    || $self->ut_text('lastapp')
 256 #    || $self->ut_text('lastdata')
 257 #    || $self->ut_numbern('startdate')
 258 #    || $self->ut_numbern('answerdate')
 259 #    || $self->ut_numbern('enddate')
 260 #    || $self->ut_number('duration')
 261 #    || $self->ut_number('billsec')
 262 #    || $self->ut_text('disposition')
 263 #    || $self->ut_number('amaflags')
 264 #    || $self->ut_text('accountcode')
 265 #    || $self->ut_text('uniqueid')
 266 #    || $self->ut_text('userfield')
 267 #    || $self->ut_numbern('cdrtypenum')
 268 #    || $self->ut_textn('charged_party')
 269 ##    || $self->ut_n('upstream_currency')
 270 ##    || $self->ut_n('upstream_price')
 271 #    || $self->ut_numbern('upstream_rateplanid')
 272 ##    || $self->ut_n('distance')
 273 #    || $self->ut_numbern('islocal')
 274 #    || $self->ut_numbern('calltypenum')
 275 #    || $self->ut_textn('description')
 276 #    || $self->ut_numbern('quantity')
 277 #    || $self->ut_numbern('carrierid')
 278 #    || $self->ut_numbern('upstream_rateid')
 279 #    || $self->ut_numbern('svcnum')
 280 #    || $self->ut_textn('freesidestatus')
 281 #    || $self->ut_textn('freesiderewritestatus')
 282 #  ;
 283 #  return $error if $error;
 284
 285   $self->calldate( $self->startdate_sql )
 286     if !$self->calldate && $self->startdate;
 287
 288   #was just for $format eq 'taqua' but can't see the harm... add something to
 289   #disable if it becomes a problem
 290   if ( $self->duration eq '' && $self->enddate && $self->startdate ) {
 291     $self->duration( $self->enddate - $self->startdate  );
 292   }
 293   if ( $self->billsec eq '' && $self->enddate && $self->answerdate ) {
 294     $self->billsec(  $self->enddate - $self->answerdate );
 295   }
 296
 297   $self->set_charged_party;
 298
 299   #check the foreign keys even?
 300   #do we want to outright *reject* the CDR?
 301   my $error =
 302        $self->ut_numbern('acctid')
 303
 304   #add a config option to turn these back on if someone needs 'em
 305   #
 306   #  #Usage = 1, S&E = 7, OC&C = 8
 307   #  || $self->ut_foreign_keyn('cdrtypenum',  'cdr_type',     'cdrtypenum' )
 308   #
 309   #  #the big list in appendix 2
 310   #  || $self->ut_foreign_keyn('calltypenum', 'cdr_calltype', 'calltypenum' )
 311   #
 312   #  # Telstra =1, Optus = 2, RSL COM = 3
 313   #  || $self->ut_foreign_keyn('carrierid', 'cdr_carrier', 'carrierid' )
 314   ;
 315   return $error if $error;
 316
 317   $self->SUPER::check;
 318 }
 319
 320 =item is_tollfree
 321
 322   Returns true when the cdr represents a toll free number and false otherwise.
 323
 324 =cut
 325
 326 sub is_tollfree {
 327   my $self = shift;
 328   ( $self->dst =~ /^(\+?1)?8(8|([02-7])\3)/ ) ? 1 : 0;
 329 }
 330
 331 =item set_charged_party
 332
 333 If the charged_party field is already set, does nothing.  Otherwise:
 334
 335 If the cdr-charged_party-accountcode config option is enabled, sets the
 336 charged_party to the accountcode.
 337
 338 Otherwise sets the charged_party normally: to the src field in most cases,
 339 or to the dst field if it is a toll free number.
 340
 341 =cut
 342
 343 sub set_charged_party {
 344   my $self = shift;
 345
 346   my $conf = new FS::Conf;
 347
 348   unless ( $self->charged_party ) {
 349
 350     if ( $conf->exists('cdr-charged_party-accountcode') && $self->accountcode ){
 351
 352       my $charged_party = $self->accountcode;
 353       $charged_party =~ s/^0+//
 354         if $conf->exists('cdr-charged_party-accountcode-trim_leading_0s');
 355       $self->charged_party( $charged_party );
 356
 357     } else {
 358
 359       if ( $self->is_tollfree ) {
 360         $self->charged_party($self->dst);
 361       } else {
 362         $self->charged_party($self->src);
 363       }
 364
 365     }
 366
 367   }
 368
 369 #  my $prefix = $conf->config('cdr-charged_party-truncate_prefix');
 370 #  my $prefix_len = length($prefix);
 371 #  my $trunc_len = $conf->config('cdr-charged_party-truncate_length');
 372 #
 373 #  $self->charged_party( substr($self->charged_party, 0, $trunc_len) )
 374 #    if $prefix_len && $trunc_len
 375 #    && substr($self->charged_party, 0, $prefix_len) eq $prefix;
 376
 377 }
 378
 379 =item set_status_and_rated_price STATUS [ RATED_PRICE ]
 380
 381 Sets the status to the provided string.  If there is an error, returns the
 382 error, otherwise returns false.
 383
 384 =cut
 385
 386 sub set_status_and_rated_price {
 387   my($self, $status, $rated_price) = @_;
 388   $self->freesidestatus($status);
 389   $self->rated_price($rated_price);
 390   $self->replace();
 391 }
 392
 393 =item calldate_unix
 394
 395 Parses the calldate in SQL string format and returns a UNIX timestamp.
 396
 397 =cut
 398
 399 sub calldate_unix {
 400   str2time(shift->calldate);
 401 }
 402
 403 =item startdate_sql
 404
 405 Parses the startdate in UNIX timestamp format and returns a string in SQL
 406 format.
 407
 408 =cut
 409
 410 sub startdate_sql {
 411   my($sec,$min,$hour,$mday,$mon,$year) = localtime(shift->startdate);
 412   $mon++;
 413   $year += 1900;
 414   "$year-$mon-$mday $hour:$min:$sec";
 415 }
 416
 417 =item cdr_carrier
 418
 419 Returns the FS::cdr_carrier object associated with this CDR, or false if no
 420 carrierid is defined.
 421
 422 =cut
 423
 424 my %carrier_cache = ();
 425
 426 sub cdr_carrier {
 427   my $self = shift;
 428   return '' unless $self->carrierid;
 429   $carrier_cache{$self->carrierid} ||=
 430     qsearchs('cdr_carrier', { 'carrierid' => $self->carrierid } );
 431 }
 432
 433 =item carriername
 434
 435 Returns the carrier name (see L<FS::cdr_carrier>), or the empty string if
 436 no FS::cdr_carrier object is assocated with this CDR.
 437
 438 =cut
 439
 440 sub carriername {
 441   my $self = shift;
 442   my $cdr_carrier = $self->cdr_carrier;
 443   $cdr_carrier ? $cdr_carrier->carriername : '';
 444 }
 445
 446 =item cdr_calltype
 447
 448 Returns the FS::cdr_calltype object associated with this CDR, or false if no
 449 calltypenum is defined.
 450
 451 =cut
 452
 453 my %calltype_cache = ();
 454
 455 sub cdr_calltype {
 456   my $self = shift;
 457   return '' unless $self->calltypenum;
 458   $calltype_cache{$self->calltypenum} ||=
 459     qsearchs('cdr_calltype', { 'calltypenum' => $self->calltypenum } );
 460 }
 461
 462 =item calltypename
 463
 464 Returns the call type name (see L<FS::cdr_calltype>), or the empty string if
 465 no FS::cdr_calltype object is assocated with this CDR.
 466
 467 =cut
 468
 469 sub calltypename {
 470   my $self = shift;
 471   my $cdr_calltype = $self->cdr_calltype;
 472   $cdr_calltype ? $cdr_calltype->calltypename : '';
 473 }
 474
 475 =item downstream_csv [ OPTION => VALUE, ... ]
 476
 477 =cut
 478
 479 my %export_names = (
 480   'simple'  => {
 481     'name'           => 'Simple',
 482     'invoice_header' => "Date,Time,Name,Destination,Duration,Price",
 483   },
 484   'simple2' => {
 485     'name'           => 'Simple with source',
 486     'invoice_header' => "Date,Time,Called From,Destination,Duration,Price",
 487                        #"Date,Time,Name,Called From,Destination,Duration,Price",
 488   },
 489   'default' => {
 490     'name'           => 'Default',
 491     'invoice_header' => 'Date,Time,Number,Destination,Duration,Price',
 492   },
 493   'source_default' => {
 494     'name'           => 'Default with source',
 495     'invoice_header' => 'Caller,Date,Time,Number,Destination,Duration,Price',
 496   },
 497   'accountcode_default' => {
 498     'name'           => 'Default plus accountcode',
 499     'invoice_header' => 'Date,Time,Account,Number,Destination,Duration,Price',
 500   },
 501 );
 502
 503 my $duration_sub = sub {
 504   my($cdr, %opt) = @_;
 505   if ( $opt{minutes} ) {
 506     $opt{minutes}. ( $opt{granularity} ? 'm' : ' call' );
 507   } else {
 508     sprintf('%.2fm', $cdr->billsec / 60 );
 509   }
 510 };
 511
 512 my %export_formats = (
 513   'simple' => [
 514     sub { time2str('%D', shift->calldate_unix ) },   #DATE
 515     sub { time2str('%r', shift->calldate_unix ) },   #TIME
 516     'userfield',                                     #USER
 517     'dst',                                           #NUMBER_DIALED
 518     $duration_sub,                                   #DURATION
 519     #sub { sprintf('%.3f', shift->upstream_price ) }, #PRICE
 520     sub { my($cdr, %opt) = @_; $opt{money_char}. $opt{charge}; }, #PRICE
 521   ],
 522   'simple2' => [
 523     sub { time2str('%D', shift->calldate_unix ) },   #DATE
 524     sub { time2str('%r', shift->calldate_unix ) },   #TIME
 525     #'userfield',                                     #USER
 526     'src',                                           #called from
 527     'dst',                                           #NUMBER_DIALED
 528     $duration_sub,                                   #DURATION
 529     #sub { sprintf('%.3f', shift->upstream_price ) }, #PRICE
 530     sub { my($cdr, %opt) = @_; $opt{money_char}. $opt{charge}; }, #PRICE
 531   ],
 532   'default' => [
 533
 534     #DATE
 535     sub { time2str('%D', shift->calldate_unix ) },
 536           # #time2str("%Y %b %d - %r", $cdr->calldate_unix ),
 537
 538     #TIME
 539     sub { time2str('%r', shift->calldate_unix ) },
 540           # time2str("%c", $cdr->calldate_unix),  #XXX this should probably be a config option dropdown so they can select US vs- rest of world dates or whatnot
 541
 542     #DEST ("Number")
 543     sub { my($cdr, %opt) = @_; $opt{pretty_dst} || $cdr->dst; },
 544
 545     #REGIONNAME ("Destination")
 546     sub { my($cdr, %opt) = @_; $opt{dst_regionname}; },
 547
 548     #DURATION
 549     $duration_sub,
 550
 551     #PRICE
 552     sub { my($cdr, %opt) = @_; $opt{money_char}. $opt{charge}; },
 553
 554   ],
 555 );
 556 $export_formats{'source_default'} = [ 'src', @{ $export_formats{'default'} }, ];
 557 $export_formats{'accountcode_default'} =
 558   [ @{ $export_formats{'default'} }[0,1],
 559     'accountcode',
 560     @{ $export_formats{'default'} }[2..5],
 561   ];
 562
 563 sub downstream_csv {
 564   my( $self, %opt ) = @_;
 565
 566   my $format = $opt{'format'};
 567   return "Unknown format $format" unless exists $export_formats{$format};
 568
 569   #my $conf = new FS::Conf;
 570   #$opt{'money_char'} ||= $conf->config('money_char') || '$';
 571   $opt{'money_char'} ||= FS::Conf->new->config('money_char') || '$';
 572
 573   eval "use Text::CSV_XS;";
 574   die $@ if $@;
 575   my $csv = new Text::CSV_XS;
 576
 577   my @columns =
 578     map {
 579           ref($_) ? &{$_}($self, %opt) : $self->$_();
 580         }
 581     @{ $export_formats{$format} };
 582
 583   my $status = $csv->combine(@columns);
 584   die "FS::CDR: error combining ". $csv->error_input(). "into downstream CSV"
 585     unless $status;
 586
 587   $csv->string;
 588
 589 }
 590
 591 =back
 592
 593 =head1 CLASS METHODS
 594
 595 =over 4
 596
 597 =item invoice_formats
 598
 599 Returns an ordered list of key value pairs containing invoice format names
 600 as keys (for use with part_pkg::voip_cdr) and "pretty" format names as values.
 601
 602 =cut
 603
 604 sub invoice_formats {
 605   map { ($_ => $export_names{$_}->{'name'}) }
 606     grep { $export_names{$_}->{'invoice_header'} }
 607     keys %export_names;
 608 }
 609
 610 =item invoice_header FORMAT
 611
 612 Returns a scalar containing the CSV column header for invoice format FORMAT.
 613
 614 =cut
 615
 616 sub invoice_header {
 617   my $format = shift;
 618   $export_names{$format}->{'invoice_header'};
 619 }
 620
 621 =item import_formats
 622
 623 Returns an ordered list of key value pairs containing import format names
 624 as keys (for use with batch_import) and "pretty" format names as values.
 625
 626 =cut
 627
 628 #false laziness w/part_pkg & part_export
 629
 630 my %cdr_info;
 631 foreach my $INC ( @INC ) {
 632   warn "globbing $INC/FS/cdr/*.pm\n" if $DEBUG;
 633   foreach my $file ( glob("$INC/FS/cdr/*.pm") ) {
 634     warn "attempting to load CDR format info from $file\n" if $DEBUG;
 635     $file =~ /\/(\w+)\.pm$/ or do {
 636       warn "unrecognized file in $INC/FS/cdr/: $file\n";
 637       next;
 638     };
 639     my $mod = $1;
 640     my $info = eval "use FS::cdr::$mod; ".
 641                     "\\%FS::cdr::$mod\::info;";
 642     if ( $@ ) {
 643       die "error using FS::cdr::$mod (skipping): $@\n" if $@;
 644       next;
 645     }
 646     unless ( keys %$info ) {
 647       warn "no %info hash found in FS::cdr::$mod, skipping\n";
 648       next;
 649     }
 650     warn "got CDR format info from FS::cdr::$mod: $info\n" if $DEBUG;
 651     if ( exists($info->{'disabled'}) && $info->{'disabled'} ) {
 652       warn "skipping disabled CDR format FS::cdr::$mod" if $DEBUG;
 653       next;
 654     }
 655     $cdr_info{$mod} = $info;
 656   }
 657 }
 658
 659 tie my %import_formats, 'Tie::IxHash',
 660   map  { $_ => $cdr_info{$_}->{'name'} }
 661   sort { $cdr_info{$a}->{'weight'} <=> $cdr_info{$b}->{'weight'} }
 662   grep { exists($cdr_info{$_}->{'import_fields'}) }
 663   keys %cdr_info;
 664
 665 sub import_formats {
 666   %import_formats;
 667 }
 668
 669 sub _cdr_min_parser_maker {
 670   my $field = shift;
 671   my @fields = ref($field) ? @$field : ($field);
 672   @fields = qw( billsec duration ) unless scalar(@fields) && $fields[0];
 673   return sub {
 674     my( $cdr, $min ) = @_;
 675     my $sec = eval { _cdr_min_parse($min) };
 676     die "error parsing seconds for @fields from $min minutes: $@\n" if $@;
 677     $cdr->$_($sec) foreach @fields;
 678   };
 679 }
 680
 681 sub _cdr_min_parse {
 682   my $min = shift;
 683   sprintf('%.0f', $min * 60 );
 684 }
 685
 686 sub _cdr_date_parser_maker {
 687   my $field = shift;
 688   my %options = @_;
 689   my @fields = ref($field) ? @$field : ($field);
 690   return sub {
 691     my( $cdr, $datestring ) = @_;
 692     my $unixdate = eval { _cdr_date_parse($datestring, %options) };
 693     die "error parsing date for @fields from $datestring: $@\n" if $@;
 694     $cdr->$_($unixdate) foreach @fields;
 695   };
 696 }
 697
 698 sub _cdr_date_parse {
 699   my $date = shift;
 700   my %options = @_;
 701
 702   return '' unless length($date); #that's okay, it becomes NULL
 703   return '' if $date eq 'NA'; #sansay
 704
 705   if ( $date =~ /^([a-z]{3})\s+([a-z]{3})\s+(\d{1,2})\s+(\d{1,2}):(\d{1,2}):(\d{1,2})\s+(\d{4})$/i && $7 > 1970 ) {
 706     my $time = str2time($date);
 707     return $time if $time > 100000; #just in case
 708   }
 709
 710   my($year, $mon, $day, $hour, $min, $sec);
 711
 712   #$date =~ /^\s*(\d{4})[\-\/]\(\d{1,2})[\-\/](\d{1,2})\s+(\d{1,2}):(\d{1,2}):(\d{1,2})\s*$/
 713   #taqua  #2007-10-31 08:57:24.113000000
 714
 715   if ( $date =~ /^\s*(\d{4})\D(\d{1,2})\D(\d{1,2})\D+(\d{1,2})\D(\d{1,2})\D(\d{1,2})(\D|$)/ ) {
 716     ($year, $mon, $day, $hour, $min, $sec) = ( $1, $2, $3, $4, $5, $6 );
 717   } elsif ( $date  =~ /^\s*(\d{1,2})\D(\d{1,2})\D(\d{4})\s+(\d{1,2})\D(\d{1,2})\D(\d{1,2})(\D|$)/ ) {
 718     ($mon, $day, $year, $hour, $min, $sec) = ( $1, $2, $3, $4, $5, $6 );
 719   } else {
 720      die "unparsable date: $date"; #maybe we shouldn't die...
 721   }
 722
 723   return '' if ( $year == 1900 || $year == 1970 ) && $mon == 1 && $day == 1
 724             && $hour == 0 && $min == 0 && $sec == 0;
 725
 726   if ($options{gmt}) {
 727     timegm($sec, $min, $hour, $day, $mon-1, $year);
 728   } else {
 729     timelocal($sec, $min, $hour, $day, $mon-1, $year);
 730   }
 731 }
 732
 733 =item batch_import HASHREF
 734
 735 Imports CDR records.  Available options are:
 736
 737 =over 4
 738
 739 =item file
 740
 741 Filename
 742
 743 =item format
 744
 745 =item params
 746
 747 Hash reference of preset fields, typically cdrbatch
 748
 749 =item empty_ok
 750
 751 Set true to prevent throwing an error on empty imports
 752
 753 =back
 754
 755 =cut
 756
 757 my %import_options = (
 758   'table'   => 'cdr',
 759
 760   'formats' => { map { $_ => $cdr_info{$_}->{'import_fields'}; }
 761                      keys %cdr_info
 762                },
 763
 764                           #drop the || 'csv' to allow auto xls for csv types?
 765   'format_types' => { map { $_ => ( lc($cdr_info{$_}->{'type'}) || 'csv' ); }
 766                           keys %cdr_info
 767                     },
 768
 769   'format_headers' => { map { $_ => ( $cdr_info{$_}->{'header'} || 0 ); }
 770                             keys %cdr_info
 771                       },
 772
 773   'format_sep_chars' => { map { $_ => $cdr_info{$_}->{'sep_char'}; }
 774                               keys %cdr_info
 775                         },
 776
 777   'format_fixedlength_formats' =>
 778     { map { $_ => $cdr_info{$_}->{'fixedlength_format'}; }
 779           keys %cdr_info
 780     },
 781 );
 782
 783 sub _import_options {
 784   \%import_options;
 785 }
 786
 787 sub batch_import {
 788   my $opt = shift;
 789
 790   my $iopt = _import_options;
 791   $opt->{$_} = $iopt->{$_} foreach keys %$iopt;
 792
 793   FS::Record::batch_import( $opt );
 794
 795 }
 796
 797 =item process_batch_import
 798
 799 =cut
 800
 801 sub process_batch_import {
 802   my $job = shift;
 803
 804   my $opt = _import_options;
 805   $opt->{'params'} = [ 'format', 'cdrbatch' ];
 806
 807   FS::Record::process_batch_import( $job, $opt, @_ );
 808
 809 }
 810 #  if ( $format eq 'simple' ) { #should be a callback or opt in FS::cdr::simple
 811 #    @columns = map { s/^ +//; $_; } @columns;
 812 #  }
 813
 814 =back
 815
 816 =head1 BUGS
 817
 818 =head1 SEE ALSO
 819
 820 L<FS::Record>, schema.html from the base documentation.
 821
 822 =cut
 823
 824 1;
 825