Modify a purchase order

Question

This question is regarding SavePurchaseOrder, UpdatePurchaseOrder, and UpdatePurchaseOrderProperties methods in the PurchaseOrderManager class.

1) Is there a functional difference between SavePurchaseOrder and UpdatePurchaseOrder?
2) If I have a purchase order as XML (GetPurchaseOrderAsXml) and I want to change one of the attributes of one of the nodes can I use UpdatePurchaseOrderProperties or am I forced to SavePurchaseOrder even if all I changed was an attribute? If I can use UpdatePurchaseOrderProperties what is the format of the XmlElement for a "property" that is an attribute?

I see that if I want to search the database for a particular purchase order it seems that I am better off programming using the DataSet model. What are the scenarios which I am better off using XML?

Thank you.

Kevin

Answer 1

Hi Kevin,

looks like i am your best friend today ! :)


to change some attributes to a purchase order, you should use UpdatePurchaseOrder this way :
http://msdn.microsoft.com/en-us/library/bb219142.aspx
It is incredibely faster than the save method applied to dataset.

hth,
Cyrebre

Answer 2

But the change is still applied to the DataSet. You are saying that UpdatePurchaseOrder is faster than . . . .

Thank you.

Kevin

Answer 3

I don't understand... What do you mean by 'the change is still applied to dataset' ?

Answer 4

This articl only deals with DataSets. It doesn't use XML at all.

Kevin

Answer 5

Sorry, I posted the wrong link. This one should help you : http://msdn.microsoft.com/en-us/library/microsoft.commerceserver.orders.purchaseordermanager.updatepurchaseorderproperties.aspx

And the method you should use is UpdatePurchaseOrderProperties , not updatepurchaseorder.

hth,
Cyrebre

Answer 6

For example if I want to modify more than one attribute/property on the PurchaseOrder element would I just add another PurchaseOrder element or do I need to call UpdatePurchaseOrderProperties once for each property that I want to modify?

Thanks again.

Kevin

Answer 7

No, the aim of this function is to bulk modify your PO; so you can update a lot of PO With just 1 call.

Cyrebre

Answer 8

Another question if you don't mind. We have "extended" the LineItem and OrderForm. We call our extended version BsiLineItem and BsiOrderForm. If we substitute BsiLineItem for LineItem in the Xml that is passed to UpdatePurchaseOrderProperties and use our extended properties, this will work right?

Kevin

Answer 9

Normally you should extend your webservice too (copy the orderobjectsmapping.xml and orderpipelinemappings.xml to the webservice folder) and then the WS will return you BsiLineItem instead of LineItem.

hth
Cyrebre

Answer 10

We have done this. Is what I see in GetPurchaseOrderAsXml is a structure like:

<LineItems>
   <BsiLineItem . . . . ./>
   <BsiLineItem . . . . ./>

If I want to changed the property/attribute of a *BsiLineItem* can I feed Xml like:

<PurchaseOrderUpdates>
    <BsiLineItem LineItemId=.... PropertyName=... PropertyValue=.... />
    <BsiLineItem LineItemId=.... PropertyName=... PropertyValue=.... />
.  .  .

?

Thank you.

Kevin

Answer 11

I think it's the way it works, but i didn't test it (we don't update lineitems on our site).
But if you try i'm interested in the result.

++
Cyrebre