Ligne de dépense : globale

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 2 minutes de lecture

    • L’include de script ExpenseLine est utilisé par divers processus de gestion des coûts et peut également être utilisé pour générer des enregistrements de lignes de dépense (fm_expense_line) à partir de vos propres scripts côté serveur.

    Cet include de script nécessite le module d’extension Gestion des coûts (com.snc.cost_management).

    ExpenseLine : ExpenseLine (source GlideRecord, montant, montant, description de la chaîne)

    Constructeur de l’objet ExpenseLine .

    Tableau 1. Paramètres
    Nom Type Description
    source GlideRecord GlideRecord identifiant la source de la dépense
    calculer le montant de Numéro Nombre décimal identifiant le montant de la dépense
    description Chaîne (Facultatif) Description de la dépense.
    Tableau 2. Renvoie
    Type Description
    Objet ExpenseLine L’objet ExpenseLine vient d’être instancié. 
    //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");

    Ligne de dépense : createExpense()

    Crée un nouvel enregistrement de ligne de dépense.

    Tableau 3. Paramètres
    Nom Type Description
    Aucun
    Tableau 4. Renvoie
    Type Description
    Booléen Vrai si la ligne de dépense a été créée avec succès. 
    //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();

    Ligne de dépense : processCIParents()

    Utilisé en interne par la méthode createExpense pour traiter les relations CI lorsque la source de dépense est un enregistrement cmdb_ci.

    Tableau 5. Paramètres
    Nom Type Description
    Aucun
    Tableau 6. Renvoie
    Type Description
    nul

    ExpenseLine : setCostSource(GlideRecord, costSource)

    Identifie la grille tarifaire source ou le coût de distribution qui a été la source de génération de lignes de dépense.

    Il ne s’agit pas de la source (CI, tâche) de la dépense.

    Tableau 7. Paramètres
    Nom Type Description
    Source de coût GlideRecord GlideRecord du coût de la grille tarifaire de CI, du coût de distribution ou de la grille tarifaire de tâche. Cette option n’est généralement utilisée que pour les lignes de dépense générées par le système.
    Tableau 8. Renvoie
    Type Description
    nul

    ExpenseLine : setDescription (description de la chaîne)

    Définit la description d’une dépense.

    Tableau 9. Paramètres
    Nom Type Description
    description Chaîne Description de la dépense.
    Tableau 10. Renvoie
    Type Description
    nul

    ExpenseLine : setParent(dépense GlideRecord)

    Définit le champ parent sur la ligne de dépense.

    Le système ne l’utilise généralement que lorsqu’il génère des dépenses indirectes telles que les dépenses agrégées des services aux entreprises.

    Tableau 11. Paramètres
    Nom Type Description
    dépense GlideRecord Enregistrement de ligne de dépense parente.
    Tableau 12. Renvoie
    Type Description
    nul

    ExpenseLine : setRecurring(booléen récurrent)

    Marque la dépense comme récurrente en définissant le champ Récurrent sur vrai.

    Les lignes de dépense sont définies sur false par défaut, il n’est donc pas nécessaire d’appeler setRecurring(false).

    Tableau 13. Paramètres
    Nom Type Description
    récurrent Booléen Définissez la valeur sur vrai pour identifier la ligne de dépense comme une dépense récurrente.
    Tableau 14. Renvoie
    Type Description
    nul

    ExpenseLine : setSummaryType (String summaryType)

    Définit une valeur pour le champ summary_type ligne de dépense.

    Tableau 15. Paramètres
    Nom Type Description
    summaryType Chaîne En règle générale, vous devez définir cette valeur sur une valeur déjà spécifiée dans la liste de choix du champ Type de résumé de ligne de dépense.
    Tableau 16. Renvoie
    Type Description
    nul 
    //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");