KostenplanBatchOperations – Global

Die KostenplanBatchOperations Die Skripteinbindung bietet Methoden, die die Erstellung einer großen Anzahl von Kostenplandatensätzen für Bedarfe und Projekte mithilfe der Batch-Verarbeitung ermöglichen. Verwenden Sie diese Skripteinbindung anstelle von GlideRecord Um effizienter mehrere Kostenplandatensätze zu erstellen.

Verwenden Sie KostenplanBatchVorgänge.hinzufügen() Methode zum Hinzufügen einer beliebigen Anzahl von Kostenplänen zu einer Batch-Warteschlange. Sobald Sie alle erforderlichen Kostenpläne hinzugefügt haben, verwenden Sie CostPlanBatchOperations.process() Methode zum Erstellen/Einfügen der Kostenpläne in Ihre Instanz. Bis Sie anrufen CostPlanBatchOperations.process() Methode, verbleiben die Add-Anforderungen in der Batch-Warteschlange (sie wurden Ihrer Instanz noch nicht hinzugefügt). Wenn Sie aus irgendeinem Grund alle Kostenpläne in der Batch-Warteschlange entfernen müssen, verwenden Sie KostenplanBatchVorgänge.Clear() Methode.

Zur Verwendung dieser Skripteinbindung müssen Sie das Plugin „PPM Standard“ (com.snc.Financial_Planning_pmo) aktivieren.

CostPlanBatchOperations – hinzufügen(Objekt-Kostenplan)

Fügt einer angegebenen Aufgabe (Projekt oder Bedarf) einen oder mehrere Kostenpläne hinzu. Verwenden Sie diese Methode, wenn Sie mehrere Kostenpläne erstellen möchten.

Nach der Verarbeitung werden die Kostenpläne in das angegebene Projekt oder den angegebenen Bedarf eingefügt. Sie können sie dann in Ihrer Instanz anzeigen und ändern. Weitere Informationen finden Sie unter Erstellen Sie einen Projektkostenplan Und Erstellen Sie einen Bedarfskostenplan .

Hinweis:

Diese Methode definiert nur die Kostenpläne, die Ihrer Instanz hinzugefügt werden sollen. Die Kostenpläne werden erst in Ihre Instanz eingefügt, wenn costPlanBatchOperations.process() Wird aufgerufen.

Tabelle : 1. Parameter

Name	Typ	Beschreibung
Kostenplan	Objekt	Ein oder mehrere Objekte oder ein Array von Objekten, die jeden der Kostenpläne beschreiben, die einer vorhandenen Aufgabe hinzugefügt werden sollen.
costPlan.name	Zeichenfolge	Name des Kostenplans. Maximale Länge: 130 Zeichen
Kostenplan.Aufgabe	Zeichenfolge	SYS_ID des Projekts oder Bedarfs, das diesem Kostenplan zugeordnet werden soll. Sie können diesen Wert in einer der folgenden Tabellen finden: Projekt [pm_project] Projektaufgabe [pm_project_task] Bedarf [dmn_demand]
Kostenplan.unit_Cost	Anzahl	Kosten einer einzelnen Einheit der angegebenen Ressource.
Kostungsplan.resource_type	Zeichenfolge	SYS_ID des Datensatzes, der den Kostentyp definiert, der diesem Kostenplan zugeordnet ist. Die verfügbaren Werte für diesen Parameter sind in der Tabelle „Kostenartdefinition“ [resource_type_Definition] definiert.
CostPlan.Start_fiscal_period	Zeichenfolge	SYS_ID des Datensatzes, der die erste Geschäftsperiode definiert, die diesem Kostenplan zugeordnet werden soll. Die verfügbaren Werte für diesen Parameter sind in der Tabelle „Geschäftsperiode“ [Fiskalperiode] definiert.
CostPlan.end_Fiskalperiode	Zeichenfolge	SYS_ID des Datensatzes, der die Endgeschäftsperiode definiert, die diesem Kostenplan zugeordnet werden soll. Die verfügbaren Werte für diesen Parameter sind in der Tabelle „Geschäftsperiode“ [Fiskalperiode] definiert.
Kostenplan.<optional>	Variiert	Optional. Sie können zusätzliche Parameter übergeben, um sie einem Kostenplan hinzuzufügen. Die verfügbaren Parameter hängen vom Typ des Kostenplans ab, den Sie erstellen. Eine Liste der zusätzlichen Parameter, die Sie übergeben können, finden Sie in der Tabelle „Kostenplan“ [Cost_Plan].

Tabelle : 2. Rückgaben

Typ	Beschreibung
void

Dieses Beispiel zeigt, wie Sie einen einfachen Batch-Kostenplan hinzufügen.

//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()

Entfernt alle Kostenplanobjekte, die mit hinzugefügt wurden KostenplanBatchVorgänge.hinzufügen() Methode.

Hinweis:

Diese Methode funktioniert nur für Kostenpläne, die hinzugefügt wurden. Sobald ein Kostenplan verarbeitet wurde, kann er mit dieser Methode nicht entfernt werden. Verarbeitete Kostenpläne müssen manuell über die Anwenderoberfläche entfernt werden.

Tabelle : 3. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 4. Ergebnisse

Typ	Beschreibung
void

Dieses Beispiel zeigt, wie die Batch-Warteschlange nach dem Hinzufügen von Kostenplänen gelöscht wird.

//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()

Verarbeitet alle Kostenpläne, die mit hinzugefügt wurden KostenplanBatchVorgänge.hinzufügen() Methode und erstellt entsprechende Kostenpläne und relevante Rollups.

Sobald die Kostenpläne erfolgreich verarbeitet wurden, wird die Kostenplanwarteschlange gelöscht.

Tabelle : 5. Parameter

Name	Typ	Beschreibung
Keine

Tabelle : 6. Ergebnisse

Typ	Beschreibung
Array	SYS-ID für jeden generierten Kostenplan.

Dieses Beispiel zeigt, wie ein einfacher Batch-Kostenplan verarbeitet wird.

//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();