Retrieve methods

There are two ways to retrieve objects from the Dynamics GP service. Objects can be retrieved individually or as a list.

When objects are retrieved individually, you must specify the unique key value for the object you want to retrieve. The "GetByKey" methods in the Dynamics GP service are used to retrieve individual objects.

When objects are returned as a list, you will supply a set of criteria that indicate which objects you want to retrieve. The Dynamics GP service has criteria objects that you will use to specify criteria. The "GetList" methods in the Dynamics GP service are used to retrieve lists of objects.

Individual objects in the Dynamics GP service can contain a significant amount of data. When a list of objects is retrieved from the service, a large amount of data would need to be returned. A summary object contains the most important details of the main object. For example, the CustomerSummary object contains the important details of a Customer object.

To speed the request for a list of objects, the summary version of the object is returned by most of the "GetList" methods in the Dynamics GP service. For some of the smaller objects, the corresponding "GetList" methods return the actual objects in the list.