GetCustomersBySynchronisation
From
(Difference between revisions)
(→Parameters) |
(added information about scrolling through a large result) |
||
| (5 intermediate revisions by one user not shown) | |||
| Line 3: | Line 3: | ||
== Description == | == Description == | ||
| − | + | Retrieve the customer(s), specified by the ID of the customer(s) in the external application data to which they are synchronised to, from the customer synchronisation table. If the last parameter, i.e. afterPK, is not null, the customer record(s) retrieved must have a Primary Key greater than the afterPK. The number of objects returned by a single call is limited, to aquire a complete list, this method should be called repeatedly with the afterPK parameter set to the primary key of the last element in the result of the previous call, until an empty result is returned. | |
| − | If the last parameter, i.e. afterPK, is not null, the customer retrieved must have a Primary Key greater than the afterPK. | + | |
== Parameters == | == Parameters == | ||
| Line 18: | Line 17: | ||
|String | |String | ||
|synchronisationID | |synchronisationID | ||
| − | |The ID of the organisation to which the customer | + | |The ID of the organisation to which the customer record(s) have been synchronised to. It is usually the name of the organisation. |
|---- bgcolor=#EDEDFF | |---- bgcolor=#EDEDFF | ||
|String | |String | ||
|synchronisationReference | |synchronisationReference | ||
| − | |The ID of the customer that has been synchronised in the external record, i.e. accounting package's Account ID. | + | |The ID of the customer record (that has been synchronised) in the external record, i.e. accounting package's Account ID. |
|---- bgcolor=#EDEDFF | |---- bgcolor=#EDEDFF | ||
|String | |String | ||
|afterPK | |afterPK | ||
| − | |The lower bound of the PK of the customer that can be retrieved. | + | |The lower bound of the PK of the customer record(s) that can be retrieved. |
|} | |} | ||
== Return Value == | == Return Value == | ||
[[GetCustomersBySynchronisationResult]] | [[GetCustomersBySynchronisationResult]] | ||
Latest revision as of 23:22, 14 February 2006
Contents |
[edit] Method
GetCustomersBySynchronisationResult getCustomersBySynchronisation(UserIDBean userID, String synchronisationID, String synchronisationReference, String afterPK)
[edit] Description
Retrieve the customer(s), specified by the ID of the customer(s) in the external application data to which they are synchronised to, from the customer synchronisation table. If the last parameter, i.e. afterPK, is not null, the customer record(s) retrieved must have a Primary Key greater than the afterPK. The number of objects returned by a single call is limited, to aquire a complete list, this method should be called repeatedly with the afterPK parameter set to the primary key of the last element in the result of the previous call, until an empty result is returned.
[edit] Parameters
| Type | Name | Description |
|---|---|---|
| UserIDBean | userID | The admin username and password. |
| String | synchronisationID | The ID of the organisation to which the customer record(s) have been synchronised to. It is usually the name of the organisation. |
| String | synchronisationReference | The ID of the customer record (that has been synchronised) in the external record, i.e. accounting package's Account ID. |
| String | afterPK | The lower bound of the PK of the customer record(s) that can be retrieved. |
