CostPlanBatchOperations - Global

. CostPlanBatchOperations a inclusão de script fornece métodos que permitem a criação de um grande número de registros de plano de custo para demandas e projetos usando processamento em lote. Use esta inclusão de script em vez de GlideRecord para criar vários registros de plano de custo com mais eficiência.

Use CostPlanBatchOperations.add() método para adicionar qualquer número de planos de custo a uma fila em lote. Depois de adicionar todos os planos de custo necessários, use CostPlanBatchOperations.process() método para criar/inserir os planos de custo em sua instância. Até que você ligue para CostPlanBatchOperations.process() as solicitações de adição permanecem na fila em lote (elas ainda não foram adicionadas à sua instância). Se, por algum motivo, você precisar remover todos os planos de custo na fila em lote, use CostPlanBatchOperations.Limpar() método.

Para usar esta inclusão de script, você deve ativar o plug-in PPM Standard (com.snc.financial_planning_pmo).

CostPlanBatchOperations - add(Object costPlan)

Adiciona um ou mais planos de custo a uma tarefa especificada (projeto ou demanda). Use este método quando quiser criar vários planos de custo.

Uma vez processados, os planos de custo são inseridos no projeto ou demanda especificado. Em seguida, você pode exibi-los e modificá-los em sua instância. Para obter informações adicionais, consulte Crie um plano de custo do projeto e. Crie um plano de custo de demanda .

Nota:

Este método define apenas os planos de custo a serem adicionados à sua instância. Os planos de custo não são inseridos em sua instância até costPlanBatchOperations.process() é chamado.

Tabela 1. Parâmetros

Nome	Tipo	Descrição
CostPlan	Objeto	Um ou mais objetos ou uma matriz de objetos que descrevem cada um dos planos de custo a serem adicionados a uma tarefa existente.
costPlan.name	Cadeia de caracteres	Nome do plano de custos. Tamanho máximo: 130 caracteres
CostPlan.task	Cadeia de caracteres	Sys_id do projeto ou demanda a ser associado a este plano de custos. Você pode localizar este valor em uma das seguintes tabelas: Projeto [projeto_pm] Tarefa do projeto [tarefa_projeto_pm] Demanda [dmn_demand]
CostPlan.unit_cost	Número	Custo de uma única unidade do recurso especificado.
CostPlan.resource_type	Cadeia de caracteres	Sys_id do registro que define o tipo de custo associado a este plano de custo. Os valores disponíveis para este parâmetro são definidos na tabela Definição de tipo de custo [resource_type_definition].
CostPlan.start_fiscal_period	Cadeia de caracteres	Sys_id do registro que define o período fiscal inicial a ser associado a este plano de custos. Os valores disponíveis para este parâmetro são definidos na tabela Período fiscal [fiscal_period].
CostPlan.end_fiscal_period	Cadeia de caracteres	Sys_id do registro que define o período fiscal final a ser associado a este plano de custos. Os valores disponíveis para este parâmetro são definidos na tabela Período fiscal [fiscal_period].
CostPlan.<optional>	Variado	Opcional. Você pode passar parâmetros adicionais para adicionar a um plano de custos. Os parâmetros disponíveis dependem do tipo de plano de custo que você está criando. Consulte a tabela Plano de custos [cost_plan] para obter a lista de parâmetros adicionais que você pode passar.

Tabela 2. Retornos

Tipo	Descrição
vazio

Este exemplo mostra como adicionar um plano de custo em lote simples.

//Define Array of Cost Plan records in JSON format
var costPlanRecords= [];
costPlanRecords.push({
   name:'Capital Expense',
   task:'f7a36d1bdb58001025c85a35dc96193a', // sys_id of the task
   unit_cost:1000.00, //decimal 
   resource_type:'a546eaf79330120064f572edb67ffb70', // sys_id of the cost type definition
   start_fiscal_period:'091b6e60cb111200f2de77a4634c9c2e', // sys_id of the start fiscal period record 
   end_fiscal_period:'0d1b6e60cb111200f2de77a4634c9c2f',// sys_id of the end fiscal period record 
   quantity:1 // Optional cost plan record attributes
});
 
var costPlanBatchOperations = new CostPlanBatchOperations();
costPlanBatchOperations.add(costPlanRecords);
var costPlanSysIds = costPlanBatchOperations.process();

CostPlanBatchOperations - Limpar()

Remove todos os objetos do plano de custos que foram adicionados usando CostPlanBatchOperations.add() método.

Nota:

Este método só funciona para planos de custo que foram adicionados. Depois que um plano de custos é processado, este método não pode removê-lo. Os planos de custo processados devem ser removidos manualmente por meio da IU.

Tabela 3. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 4. Retorna

Tipo	Descrição
vazio

Este exemplo mostra como limpar a fila em lote após adicionar planos de custo.

//Define Array of Cost Plan records in JSON format
var costPlanRecords= [];
costPlanRecords.push({
   name:'Capital Expense',
   task:'f7a36d1bdb58001025c85a35dc96193a', // sys_id of the task
   unit_cost:1000.00, //decimal 
   resource_type:'a546eaf79330120064f572edb67ffb70', // sys_id of the cost type definition
   start_fiscal_period:'091b6e60cb111200f2de77a4634c9c2e', // sys_id of the start fiscal period record 
   end_fiscal_period:'0d1b6e60cb111200f2de77a4634c9c2f',// sys_id of the end fiscal period record 
   quantity:1 // Optional cost plan record attributes
});
 
var costPlanBatchOperations = new CostPlanBatchOperations();
costPlanBatchOperations.add(costPlanRecords);
var costPlanSysIds = costPlanBatchOperations.process();
costPlanBatchOperations.clear();

CostPlanBatchOperations - Process()

Processa todos os planos de custo que foram adicionados usando CostPlanBatchOperations.add() e cria planos de custo correspondentes e acúmulos relevantes.

Quando os planos de custo são processados com sucesso, a fila do plano de custo é limpa.

Tabela 5. Parâmetros

Nome	Tipo	Descrição
Nenhum

Tabela 6. Retorna

Tipo	Descrição
Matriz	Sys ID para cada plano de custo gerado.

Este exemplo mostra como processar um plano de custo em lote simples.

//Define Array of Cost Plan records in JSON format
var costPlanRecords= [];
costPlanRecords.push({
   name:'Capital Expense',
   task:'f7a36d1bdb58001025c85a35dc96193a', // sys_id of the task
   unit_cost:1000.00, //decimal 
   resource_type:'a546eaf79330120064f572edb67ffb70', // sys_id of the cost type definition
   start_fiscal_period:'091b6e60cb111200f2de77a4634c9c2e', // sys_id of the start fiscal period record 
   end_fiscal_period:'0d1b6e60cb111200f2de77a4634c9c2f',// sys_id of the end fiscal period record 
   quantity:1 // Optional cost plan record attributes
});
 
var costPlanBatchOperations = new CostPlanBatchOperations();
costPlanBatchOperations.add(costPlanRecords);
var costPlanSysIds = costPlanBatchOperations.process();