Zum Hauptinhalt springen
Version: 5.0

TimePunch Common Task Service

Dieser Service enthält Methoden um mit den allgemeinen Tätigkeiten von TimePunch zu arbeiten. Allgemeine Tätigkeiten können in jedem Projekt verwendet werden.

GetActiveCommonTasks

Diese Methode lädt alle allgemeinen aktiven Tätigkeiten. Aktive Tätigkeiten sind solche, bei denen das Gelöscht Flag nicht gesetzt ist.

List<TaskDto> GetActiveCommonTasks(  
out TpFault fault,
TpAuthentication authentication);
Needed PermissioncommonTasks@access
NameModifierDescription
faultOutContains the error if an exception occurs.
authenticationUser authentication
Return valueCollection of active common tasks

GetAllCommonTasks

Diese Methode lädt alle allgemeinen Tätigkeiten, unabhängig davon, ob diese bereits als gelöscht markiert wurden oder nicht.

List<TaskDto> GetAllCommonTasks(  
out TpFault fault,
TpAuthentication authentication);
Needed PermissioncommonTasks@access
NameModifierDescription
faultOutContains the error if an exception occurs.
authenticationUser authentication
Return valueCollection of common tasks

ImportTasks

Diese Methode importiert die übergebenen Tätigkeiten. Im Gegensatz zu der Save Methode werden die Tätigkeiten nicht über die ID, sondern über den Namen gemappt.

List<TaskDto> ImportTasks(  
out TpFault fault,
TpAuthentication authentication,
List<TaskDto> tasks);
Needed PermissioncommonTasks@manage
NameModifierDescription
faultOutContains the error if an exception occurs.
authenticationUser authentication
tasksCollection of common tasks to import
Return ValueReturns a collection of all common tasks

LoadCommonTask

Diese Methode lädt eine einzelne Tätigkeit. Dies kann wichtig sein, wenn für einen Zeiteintrag eine einzelne (evt. sogar gelöschte) Tätigkeit nachgeladen werden muss.

TaskDto LoadCommonTask(  
out TpFault fault,
TpAuthentication authentication,
Guid taskId);
Needed PermissioncommonTasks@access
NameModifierDescription
faultOutContains the error if an exception occurs.
authenticationUser authentication
Return valueThe loaded task

SaveCommonTasks

Diese Methode speichert die übergebene Liste der allgemeinen Tätigkeiten. Wichtig dabei ist, dass die Liste alle aktiven Tätigkeiten enthält. Tätigkeiten die nicht in der Liste enthalten sind, werden automatisch beim Speichern als gelöscht markiert.

void SaveCommonTasks(  
out TpFault fault,
TpAuthentication authentication,
IEnumerable<TaskDto> tasks);
Needed PermissioncommonTasks@manage
NameModifierDescription
faultOutContains the error if an exception occurs.
authenticationUser authentication
tasksCollection of active common tasks