Zum Hauptinhalt springen
Version: 5.5

Customer Service

Dieser Service bietet eine Schnittstelle zum Zugriff auf die Kundendaten die in TimePunch hinterlegt sind.

CreateCustomer

Diese Methode erzeugt ein neues Kundenobjekt und liefert es zurück. Die Kundendaten sind zu diesem Zeitpunkt noch nicht in der Datenbank gespeichert.

CustomerDto CreateCustomer(  
out TpFault fault,
TpAuthentication authentication);
Needed Permissioncustomers@manage
NameModifierDescription
faultOutContains the error if an exception occurs.
authenticationUser authentication
Return valueNew CustomerDTO object with the preset of customer data.

SaveCustomers

Diese Methode speichert die übergebenen Kundendaten in die Datenbank und liefert als Ergebnis die gespeicherten Daten wieder zurück.

CustomerDto[] SaveCustomers(  
out TpFault fault,
TpAuthentication authentication,
CustomerDto[] customers);
Needed Permissioncustomers@import
NameModifierDescription
faultOutContains the error if an exception occurs.
authenticationUser authentication
customersArray of customer data to store in the database
Return valueThe customer data that has been stored in the database.

ImportCustomers

Diese Methode importiert die übergebenen Kundendaten in die Datenbank. Der Unterschied zum Speichern ist, dass die Kundendaten nicht anhand der ID, sondern der Kunden-Ref.Nr und des Namens identifiziert werden. Bei gleicher Kunden Referenz und Namen wird der Datensatz aktualisiert.

CustomerDto[] ImportCustomers(  
out TpFault fault,
TpAuthentication authentication,
CustomerDto[] customers);
Needed Permissioncustomers@import
NameModifierDescription
faultOutContains the error if an exception occurs.
authenticationUser authentication
customersArray of customer data to import in the database
Return valueThe customer data that has been stored in the database.

LoadCustomers

Diese Methode lädt die mit Kundendaten der übergebenen Kunden Schlüssel. Die Methode sollte der Suche bevorzugt werden, wenn die IDs der Kundendaten bekannt sind.

CustomerDto[] LoadCustomers(  
out TpFault fault,
TpAuthentication authentication,
Guid[] customerIds);
Needed Permissioncustomers@access
NameModifierDescription
faultOutContains the error if an exception occurs.
authenticationUser authentication
customerIdsArray of customer ids to load from the database
Return valueThe customer data that has been loaded from the database.

MarkCustomersAsDeleted

Diese Methode markiert die Kundendaten als gelöscht. Die Daten werden dabei nicht physisch gelöscht.

void MarkCustomersAsDeleted(  
out TpFault fault,
TpAuthentication authentication,
Guid[] customerIds);
Needed Permissioncustomers@manage
NameModifierDescription
faultOutContains the error if an exception occurs.
authenticationUser authentication
customerIdsArray of customer ids to mark as deleted in database

DeleteCustomers

Diese Methode versucht die Kundendaten physisch in der Datenbank zu löschen. Sollte der Kunde bereits verwendet werden, ist das physische Löschen nicht mehr möglich. In diesem Fall sollte der Kunde als gelöscht markiert werden.

void DeleteCustomers(  
out TpFault fault,
TpAuthentication authentication,
Guid[] customerIds);
Needed Permissioncustomers@manage
NameModifierDescription
FaultOutContains the error if an exception occurs.
AuthenticationUser authentication
customerIdsArray of customer ids to physically delete in database

SearchCustomers

Diese Methode sucht nach allen Kunden anhand des vorgegebenen Suchobjekts.

CustomerDto[] SearchCustomers(  
out TpFault fault,
TpAuthentication authentication,
CustomerSearchDto templateCustomer);
Needed Permissioncustomers@access
NameModifierDescription
FaultOutContains the error if an exception occurs.
AuthenticationUser authentication
templateCustomerSearch object that holds the properties used for searching the real customers
Return valueFound customer data

SearchActiveCustomers

Diese Methode sucht nach alle aktiven Kunden anhand des vorgegebenen Suchobjekts.

CustomerDto[] SearchCustomers(  
out TpFault fault,
TpAuthentication authentication,
CustomerSearchDto templateCustomer);
Needed Permissioncustomers@access
NameModifierDescription
FaultOutContains the error if an exception occurs.
AuthenticationUser authentication
templateCustomerSearch object that holds the properties used for searching the real customers
Return valueFound customer data