Click here to download this Parallelspace Corporation Technical Note: PSN TN0028: SPS2003 XML Import-Export “Operation” Attribute

Excerpts

operation Attribute

The technical note proposes the addition of an operation attribute to the XML emitted for each exported item by the SPS2003 Upgrade.exe tool.  The schema for the operation attribute would include the following operations:

• operation=”create”
• operation=”delete”
• operation=”remove”
• operation=”replace”
• operation=”update”
• operation=”add”
• operation=”merge”
• operation=”ignore”

operation Attribute Values

operation Attribute Values	Description	Pre-delete Existing Item	Create New Item
operation=”delete”	Delete deletes an existing item imported into SPS2003 during a previous execution of the Import tool; or fails if the item doesn’t exist.	No	No
operation=”remove”	Delete deletes an existing item imported into SPS2003 during a previous execution of the Import tool, if it exists.	No	No
operation=”create”	Create creates a new instance of the exported item; or fails if the item already exists (see replace, update and add)	No	Yes
operation=”replace”	Replace replaces an existing item imported intoSPS2003 during a previous execution of the Import tool by executing a Delete followed by a Create; or fails if the item doesn’t exit.	Yes	Yes
operation=”add”	Add a) creates a new instance of the exported item if the item does *not* exist; or b) replaces an item if the item was imported into SPS2003 during a previous execution of the Import tool.  This operation shouldn’t fail based on previous import operations	a) No b) Yes	a) Yes b) Yes
operation=”merge”	Add a) creates a new instance of the exported item if the item does *not* exist; or b) updates an item if the item was imported into SPS2003 during a previous execution of the Import tool.  This operation shouldn’t fail based on previous import operations	a) No b) No	a) Yes b) No
operation=”update”	Update adds or replaces the values of selected attributes of an existing item imported intoSPS2003 during a previous execution of the Import tool; or fails if the item doesn’t exit.	No	No
operations=”ignore”	Processing for this item is skipped.  The contents of the item are ignored.	n/a	n/a