ExpenseLine - Global

The ExpenseLine script include is used by various cost management processes and can also be used for generating expense line (fm_expense_line) records from your own server-side scripts.

This script include requires the Cost Management (com.snc.cost_management) plugin.

ExpenseLine - ExpenseLine (GlideRecord source, Number amount, String description)

Constructor for ExpenseLine object.

表 : 1. Parameters

Name	Type	Description
source	GlideRecord	GlideRecord identifying the source of the expense
amount	Number	Decimal number identifying the amount of the expense
description	String	(Optional) Description of the expense.

表 : 2. Returns

Type	Description
ExpenseLine object	The ExpenseLine object just instantiated.

//get some random CI to be used as an expense source
        var ci = new GlideRecord("cmdb_ci_server");
        ci.query();
        ci.next();
        
        //create expense line
        var exp = new ExpenseLine(ci, 234.56, "Test expense line");

ExpenseLine - createExpense()

Creates a new expense line record.

表 : 3. Parameters

Name	Type	Description
None

表 : 4. Returns

Type	Description
Boolean	True if the expense line was successfully created.

//get some random CI to be used as an expense sourcevar ci =new GlideRecord("cmdb_ci_server");
ci.query();
ci.next();
 
//create expense line
var exp =new ExpenseLine(ci,234.56,"Test expense line");
exp.setSummaryType("run_business");
var success = exp.createExpense();

ExpenseLine - processCIParents()

Used internally by the createExpense method to process CI relationships when the expense source is a cmdb_ci record.

表 : 5. Parameters

Name	Type	Description
None

表 : 6. Returns

Type	Description
void

ExpenseLine - setCostSource(GlideRecord costSource)

Identifies the source rate card or distribution cost that was the source of expense line generation.

This is not the source (CI, task) of the expense.

表 : 7. Parameters

Name	Type	Description
costSource	GlideRecord	GlideRecord of CI rate card cost, distribution cost, or task rate card. This is generally only used for system-generated expense lines.

表 : 8. Returns

Type	Description
void

ExpenseLine - setDescription(String description)

Defines the description of an expense.

表 : 9. Parameters

Name	Type	Description
description	String	Description of expense.

表 : 10. Returns

Type	Description
void

ExpenseLine - setParent(GlideRecord expense)

Sets the parent field on the expense line.

This is generally only used by the system when generating indirect expenses such as business service aggregated expenses.

表 : 11. Parameters

Name	Type	Description
expense	GlideRecord	Parent expense line record.

表 : 12. Returns

Type	Description
void

ExpenseLine - setRecurring(Boolean recurring)

Flags the expense as recurring by setting the recurring field to true.

Expense lines are set to false by default so there is no need to call setRecurring(false).

表 : 13. Parameters

Name	Type	Description
recurring	Boolean	Set to true to identify expense line as a recurring expense.

表 : 14. Returns

Type	Description
void

ExpenseLine - setSummaryType(String summaryType)

Sets a value for the expense line summary_type field.

表 : 15. Parameters

Name	Type	Description
summaryType	String	Typically you would set this to a value already specified in the expense line summary type field choice list.

表 : 16. Returns

Type	Description
void

//get some random CI to be used as an expense sourcevar ci =new GlideRecord("cmdb_ci_server");
ci.query();
ci.next();
 
//create expense line
var exp =new ExpenseLine(ci,234.56,"Test expense line");
exp.setSummaryType("run_business");