summaryrefslogtreecommitdiff
path: root/htdocs/docs/man/part_pkg.txt
blob: 02aa109a0901ebe410eaf46944b37c8680717e43 (plain)
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
NAME
    FS::part_pkg - Object methods for part_pkg objects

SYNOPSIS
      use FS::part_pkg;

      $record = new FS::part_pkg \%hash
      $record = new FS::part_pkg { 'column' => 'value' };

      $custom_record = $template_record->clone;

      $error = $record->insert;

      $error = $new_record->replace($old_record);

      $error = $record->delete;

      $error = $record->check;

DESCRIPTION
    An FS::part_pkg object represents a billing item definition.
    FS::part_pkg inherits from FS::Record. The following fields are
    currently supported:

    pkgpart - primary key (assigned automatically for new billing item definitions)
    pkg - Text name of this billing item definition (customer-viewable)
    comment - Text name of this billing item definition (non-customer-viewable)
    setup - Setup fee
    freq - Frequency of recurring fee
    recur - Recurring fee
    setup and recur are evaluated as Safe perl expressions. You can
    use numbers just as you would normally. More advanced semantics
    are not yet defined.

METHODS
    new HASHREF
        Creates a new billing item definition. To add the billing
        item definition to the database, see the section on
        "insert".

    clone
        An alternate constructor. Creates a new billing item
        definition by duplicating an existing definition. A new
        pkgpart is assigned and `(CUSTOM) ' is prepended to the
        comment field. To add the billing item definition to the
        database, see the section on "insert".

    insert
        Adds this billing item definition to the database. If there
        is an error, returns the error, otherwise returns false.

    delete
        Currently unimplemented.

    replace OLD_RECORD
        Replaces OLD_RECORD with this one in the database. If there
        is an error, returns the error, otherwise returns false.

    check
        Checks all fields to make sure this is a valid billing item
        definition. If there is an error, returns the error,
        otherwise returns false. Called by the insert and replace
        methods.

VERSION
    $Id: part_pkg.txt,v 1.3 1999-04-08 13:39:32 ivan Exp $

BUGS
    It doesn't properly override FS::Record yet.

    The delete method is unimplemented.

    setup and recur semantics are not yet defined (and are
    implemented in FS::cust_bill. hmm.).

SEE ALSO
    the FS::Record manpage, the FS::cust_pkg manpage, the
    FS::type_pkgs manpage, the FS::pkg_svc manpage, the Safe
    manpage. schema.html from the base documentation.

HISTORY
    ivan@sisd.com 97-dec-5

    pod ivan@sisd.com 98-sep-21

    $Log: part_pkg.txt,v $
    Revision 1.3  1999-04-08 13:39:32  ivan
    convert from pod for 1.2.0 release
 Revision 1.5 1998/12/31 01:04:16 ivan doc

    Revision 1.3 1998/11/15 13:00:15 ivan bugfix in clone method,
    clone method doc clarification