AddChangeOrder

EventNames:

  • AddChangeOrder_Restrictions

  • AddChangeOrder_Pre

  • AddChangeOrder_Post

Parameters

Type

Name

Description

ChangeOrder

changeOrder

The changeOrder which should get / is added.

Restrictions and Pre:
In Restrictions and Pre you have the all the properties available on the object like _NewNumber, _NewTitle(Item,CO), _NewDescription(Item,CO), _NewApproveDeadline and NewRouting.

Post:
In POST you have the full powerVaultChangeOrder object, because at this point the Change Order exists.

File[]

files

The Files to be tracked by the Change Order.

Item[]

items

The Items to be tracked by the Change Order.
User Defined Link properties are added and removed directly on the items.

File[]

attachments

Files to be attached to the Change Order.

Comment[]

comments

Multiple comments for the ChangeOrder including there attached files.

Email[]

emails

Multiple emails to send out upon completion.

bool

successful

Post:
The information whether the Web Service call was successful or not is only available in Post events.

Unexpected Behaviour

AddChangeOrder event is raised when clicking in Vault Client on New Change Order… -> Save.
Afterwards it fires EditChangeOrder.
No CommitChangeOrder is called.

The argument files contains only the files that are directly linked to the ChangeOrder, and not the primary-links of the linked Items!

The argument comments contains the newly added comments.
A negative Id value is returned in Pre events and even the values for all other properties except Subject (CO), Message and Attachments can only be retrieved in in Post events.

Examples:
AddChangeOrder_Restrictions:

Register-VaultEvent -EventName AddChangeOrder_Restrictions -Action 'RestrictAddChangeOrder'

function RestrictAddChangeOrder($changeOrder, $files, $items, $attachments, $comments, $emails) {
	#Write event code here
}

AddChangeOrder_Pre:

Register-VaultEvent -EventName AddChangeOrder_Pre -Action 'PreAddChangeOrder'

function PreAddChangeOrder($changeOrder, $files, $items, $attachments, $comments, $emails) {
	#Write event code here
}

AddChangeOrder_Post:

Register-VaultEvent -EventName AddChangeOrder_Post -Action 'PostAddChangeOrder'

function PostAddChangeOrder($changeOrder, $files, $items, $attachments, $comments, $emails, $successful) {
	#Write event code here
}