ExpenseLine - Global

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 2 min. de leitura
  • A inclusão de script ExpenseLine é usada por vários processos de gestão de custos e também pode ser usada para gerar registros de linha de gasto (fm_expense_line) a partir de seus próprios scripts do lado do servidor.

    Esta inclusão de script requer o plug-in Gestão de custos (com.snc.cost_management).

    ExpenseLine - ExpenseLine (origem do GlideRecord, valor do número, descrição da cadeia de caracteres)

    Construtor do objeto ExpenseLine.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    origem GlideRecord GlideRecord que identifica a origem da despesa
    valor Número Número decimal que identifica o valor da despesa
    descrição Cadeia de caracteres (Opcional) Descrição da despesa.
    Tabela 2. Retorna
    Tipo Descrição
    Objeto ExpenseLine O objeto ExpenseLine acabou de ser instanciado.
    //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()

    Cria um novo registro de linha de gasto.

    Tabela 3. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 4. Retorna
    Tipo Descrição
    Booliano Verdadeiro se a linha de gasto foi criada com sucesso.
    //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()

    Usado internamente pelo método createExpense para processar relacionamentos de IC quando a origem da despesa é um registro cmdb_ci.

    Tabela 5. Parâmetros
    Nome Tipo Descrição
    Nenhum
    Tabela 6. Retorna
    Tipo Descrição
    vazio

    ExpenseLine - setCostSource(GlideRecord costSource)

    Identifica a tabela de valores de origem ou o custo de distribuição que foi a origem da geração da linha de gasto.

    Esta não é a origem (IC, tarefa) da despesa.

    Tabela 7. Parâmetros
    Nome Tipo Descrição
    OrigemDocusto GlideRecord GlideRegistro de custo da tabela de valores de IC, custo de distribuição ou tabela de valores de tarefa. Isso geralmente é usado somente para linhas de gasto geradas pelo sistema.
    Tabela 8. Retorna
    Tipo Descrição
    vazio

    ExpenseLine - setDescription(cadeia de caracteres description)

    Define a descrição de uma despesa.

    Tabela 9. Parâmetros
    Nome Tipo Descrição
    descrição Cadeia de caracteres Descrição da despesa.
    Tabela 10. Retorna
    Tipo Descrição
    vazio

    ExpenseLine - setParent(GlideRecord Expense)

    Define o campo primário na linha de gasto.

    Em geral, isso só é usado pelo sistema ao gerar despesas indiretas, como despesas agregadas de serviço de negócio.

    Tabela 11. Parâmetros
    Nome Tipo Descrição
    despesa GlideRecord Registro de linha de gasto primário.
    Tabela 12. Retorna
    Tipo Descrição
    vazio

    ExpenseLine - setRecurring(booliano recorrente)

    Sinaliza a despesa como recorrente definindo o campo recorrente como verdadeiro.

    As linhas de despesa são definidas como falsas por padrão, portanto, não há necessidade de chamar setRecurring(false).

    Tabela 13. Parâmetros
    Nome Tipo Descrição
    recorrente Booliano Defina como verdadeiro para identificar a linha de gasto como uma despesa recorrente.
    Tabela 14. Retorna
    Tipo Descrição
    vazio

    ExpenseLine - setSummaryType(cadeia de caracteres resumoTipo)

    Define um valor para o campo summary_type da linha de gasto.

    Tabela 15. Parâmetros
    Nome Tipo Descrição
    summaryType Cadeia de caracteres Normalmente, você definiria isso com um valor já especificado na lista de seleção do campo de tipo de resumo de linha de gasto.
    Tabela 16. Retorna
    Tipo Descrição
    vazio
    //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");