ParseAggregate Method

Parses the aggregate returned from another component's GetDetailAggregate method.

Syntax

[VB.NET]
Public Sub ParseAggregate(ByVal Aggregate As String)

[C#]
public void ParseAggregate(string aggregate);

Remarks

This method takes the XML aggregate returned from the FDMSRetail or FDMSECommerce component, parses it, and then fills all the properties of the FDMSDetailRecord component. While normally you can pass the results of the GetDetailAggregate method call directly to the FDMSSettle component, sometimes it is necessary to adjust the contents of the XML aggregate first.

For example, to add a gratuity to a charge:

  FDMSDetailRecord.ParseAggregate(FDMSRetail.GetDetailAggregate())
  FDMSDetailRecord.Gratuity = "500"
  FDMSDetailRecord.TransactionAmount = FDMSDetailRecord.TransactionAmount + FDMSDetailRecord.Gratuity
  FDMSSettle.DetailRecords.Add(New FDMSRecordType(FDMSDetailRecord.GetDetailAggregate()))

NOTE: This method has a corresponding asynchronous version (ParseAggregateAsync) for use in the WinRT environment.