Todo

Beschreibung

Funktionalität

Todos sind Pendenzen/Aufgaben, die von einem Sachbearbeiter erledigt werden müssen. Sie werden entweder durch einen Prozess oder kontextlos über die Activities CreateUsergroupTodo resp. CreateUserTodo erzeugt.

Todos werden immer einer Benutzergruppe (bevorzugt) oder einem Benutzer zugewiesen. Einer Benutzergruppe zugewiesene Todos können von Mitgliedern, die der entsprechenden Benutzergruppe zugewiesen sind, im Raum MyWork unter Mir zuweisbare Todos zur Erledigung übernommen werden.

Im Raum MyWork werden Todos bearbeitet. Folgende Flyouts sind standardmässig parametriert:

• Mir zugewiesene Todos zeigt mit Query QueryTodosAssignedToCurrentUser alle dem aktuellen Benutzer zur Erledigung zugeteilten Todos an.
  • Öffnen: Führt Activity OpenTodos aus, um die ausgewählten Todos zur Bearbeitung zu öffnen.
  • Zuweisung aufheben: Führt Activity UnassignTodos aus, um die Zuweisung der ausgewählten Usergroup-Todos zu löschen.
  • Neu planen: Führt Activity SetTodoDues aus, um die Fälligkeit (Due) neu zu setzen.
  • Merkzeichen bearbeiten: Führt Activity SetTagsForEntities aus, um die Tags zu bearbeiten.
  • Anzeigen: Führt Activity OpenDisplayGuis aus, um das ausgewählte Todo mit Gui SYS_Todo-Display anzuzeigen.
• Mir zuweisbare Todos zeigt mit Query QueryTodosAssignableToCurrentUser alle dem aktuellen Benutzer zuweisbaren Usergroup-Todos an.
  • Mir zuweisen und öffnen: Führt Activity AssignTodosToCurrentUserAndOpen aus, um die ausgewählten Todos dem aktuellen Benutzer zuzuweisen und zur Bearbeitung zu öffnen.
  • Mir zuweisen: Führt Activity AssignTodosToCurrentUser aus, um die ausgewählten Todos dem aktuellen Benutzer zuzuweisen.
  • Neu planen: Führt Activity SetTodoDues aus, um die Fälligkeit (Due) neu zu setzen.
  • Merkzeichen bearbeiten: Führt Activity SetTagsForEntities aus, um die Tags zu bearbeiten.
  • Anzeigen: Führt Activity OpenDisplayGuis aus, um das ausgewählte Todo mit Gui SYS_Todo-Display anzuzeigen.
• Meine erledigten Todos zeigt mit Query QueryTodosCompletedFromCurrentUser alle vom aktuellen Benutzer erledigten Todos an.
  • Anzeigen: Führt Activity OpenDisplayGuis aus, um das ausgewählte Todo mit Gui SYS_Todo-Display anzuzeigen.

Überwachung im Betrieb

Im Raum Betrieb werden Todos überwacht und können bei Bedarf umgeteilt werden.

• Todos archivieren: Führt Activity ArchiveTodoAsync zum Start der Todo-Archivierung aus.

Folgende Flyouts sind standardmässig parametriert:

• Übersicht listet mit Query QueryTodoOverviewOperation eine Zusammenfassung der offenen Todos für einen Stichtag auf.

• Offene Todos zeigt mit Query QueryTodos alle offenen Todos (TodoState = Open) an.

  • Zuweisen: Führt Activity AssignTodos aus, um die ausgewählten Usergroup-Todos einem Benutzer zuzuweisen. Der ausgewählte Benutzer muss Mitglied der Usergroup sein.
  • Mir zuweisen und öffnen: Führt Activity AssignAndOpenTodo aus, um die ausgewählten Usergroup-Todos sich selbst zuzuweisen und zu öffnen.
  • Zuweisung aufheben: Führt Activity UnassignTodos aus, um die Zuweisung der ausgewählten Usergroup-Todos zu löschen.
  • Besitzer ändern: Führt Activity SetTodoOwners aus, um den Besitzer eines User-Todos zu ändern.
  • Gruppe ändern: Führt Activity SetTodoOwnergroups aus, um die ausgewählten Todos einer anderen Benutzergruppe zuzuweisen.
  • Merkzeichen bearbeiten: Führt Activity SetTagsForEntities aus, um die Tags zu bearbeiten.
  • Gesperrt bis ändern: Führt Activity SetTodosLockedUntil aus, um LockedUntil zu ändern.
  • Neu planen: Führt Activity SetTodoFinalDues aus, um die Fälligkeit eines Todos ( LockedUntil, FinalDue und Due ) neu zu setzen
  • Anzeigen: Führt Activity OpenDisplayGuis aus, um das ausgewählte Todo mit Gui SYS_Todo-Display anzuzeigen.

• Beendete Todos zeigt mit Query QueryTodos alle erledigten Todos (TodoState = Completed) an.

  • Anzeigen

• Archivierte Todos zeigt mit Query QueryArchivedTodos alle archivierten Todos an.

  • Anzeigen

Bausteine

Entities

• ITodo

• ITodoArchive

Activities

• ArchiveTodoAsync

• AssignAndOpenTodo

• AssignTodos

• AssignTodosToCurrentUser

• AssignTodosToCurrentUserAnd...

• AssignTodoToCurrentUser

• ClearTodo

• CreateUsergroupTodo

• CreateUserTodo

• OpenTodos

• SetTodoDue

• SetTodoDues

• SetTodoFinalDue

• SetTodoFinalDues

• SetTodoLockedUntil

• SetTodoOwnergroups

• SetTodoOwners

• SetTodosLockedUntil

• UnassignTodos

Queries

• QueryArchivedTodos

• QueryAssignableUsersForTodo

• QueryTodoOverview

• QueryTodoOverviewOperation

• QueryTodos

• QueryTodosAssignableToCurre...

• QueryTodosAssignedToCurrent...

• QueryTodosCompletedFromCurr...

• QueryTodosForEntity

ValueLists

• ValueListTodoPriorities

• ValueListTodoSubjects

• ValueListTodoTags

• ValueListTodoTagsAssignable...

• ValueListTodoTagsAssignedTo...

• ValueListTodoTagsCompletedF...

• ValueListTodoTypes

• ValueListTodoTypesAssignabl...

• ValueListTodoTypesAssignedT...

• ValueListTodoTypesCompleted...

Expression Functions

Keine passenden Einträge gefunden.

Entitäten

ITodo

Entität ITodo wird in Tabelle elego.TODO und elego.TODO_TAG persistiert.

Nebst den Standard-Properties hat ein ITodo folgende Eigenschaften:

Eigenschaft	Typ	Beschreibung
TodoType	String	Technische Art des Todos. Definiert die technische Zuständigkeit. Für den verwendeten TodoType muss mit ITodoProvider.RegisterTodoHandler() ein Handler registriert sein. Default: Standalone, Prozess-Kontext: Process
Type	String	Typ-/Kategorie-Code des Todos. Anzeige mit Ressource ValueList.TodoTypes. Prozess-Param: typeValue, wenn nicht definiert, name der TodoPhase.
Subject	String	Betreff bzw. Titel des Todos als Freitext. Prozess-Param: subjectValue
Instruction	String	Arbeitsanweisung oder Beschreibung der Aufgabe. Bei einem Prozess-Todo wird die Anweisung durch den Prozess bestimmt.
AdditionalInformation	String	Zusatzinformationen zum Todo. Prozess-Param: informationValue
Due	Datum/Zeit	Fälligkeitsdatum. Kann bis max. FinalDue verschoben werden. Prozess-Param: dueValue
FinalDue	Datum/Zeit	Endgültiges Fälligkeitsdatum. Die Fälligkeit darf bis zu diesem Datum verschoben werden. Falls nicht gesetzt, gibt es keine Einschränkung. Prozess-Param: phaseDueValue
LockedUntil	Datum/Zeit	Datum, ab dem das Todo erledigt werden darf. Das Todo wird in der Liste der zuweisbaren Todos erst nach diesem Datum angezeigt. Falls nicht definiert, wird der aktuelle Zeitstempel gesetzt. Dadurch kann das Todo sofort erledigt werden. Prozess-Param: lockedUntilValue
Priority	Numerisch	Priorität des Todos. (1=hohe Prio, 3=mittlere Prio, 5=niedrige Prio ). Anzeige mit Ressource ValueList.TodoPriorities. Prozess-Param: priorityValue
Complexity	Numerisch	Komplexität. Default: 1 → Tief, 2 → Mittel, 3 → Hoch. FieldTemplate: SYS_FT_TodoComplexity. Prozess-Param: complexityValue
Owner	EntityLink<User>	Fix zugewiesener Benutzer, der das Todo zu erledigen hat. Im Idealfall wird ein Todo einer Ownergroup zugewiesen. Dadurch wird die Stellvertretung vereinfacht. Prozess-Param: ownerValue
Ownergroup	String	Benutzergruppe, die für das Todo zuständig ist. Benutzer, die der Benutzergruppe zugewiesen sind, können das Todo für sich reservieren und erledigen. (Siehe AssignedTo/ AssignedUntil) Prozess-Param: ownergroupValue
PreferedOwnergroupUser	EntityLink<User>	Bevorzugter Benutzer aus der zugewiesenen Ownergroup, der für die Bearbeitung des Todos vorgesehen ist. Prozess-Param: preferedOwnergroupUser
SearchField1	String	Freies Suchfeld 1. Prozess-Param: searchField1Value
SearchField2	String	Freies Suchfeld 2. Prozess-Param: searchField2Value
SearchField3	String	Freies Suchfeld 3. Prozess-Param: searchField3Value
SearchField4	String	Freies Suchfeld 4. Prozess-Param: searchField4Value
SearchField5	String	Freies Suchfeld 5. Prozess-Param: searchField5Value
SearchField6	String	Freies Suchfeld 6. Prozess-Param: searchField6Value
SearchField7	Numerisch	Freies numerisches Suchfeld 7. Prozess-Param: searchField7Value
SearchField8	Numerisch	Freies numerisches Suchfeld 8. Prozess-Param: searchField8Value
SearchField9	Datum/Zeit	Freies Datums-Suchfeld 9. Prozess-Param: searchField9Value
SearchField10	Datum/Zeit	Freies Datums-Suchfeld 10. Prozess-Param: searchField10Value
AssignedTo	EntityLink<User>	Benutzer, dem das Usergroup-Todo bis AssignedUntil zugewiesen ist.
AssignedUntil	Datum/Zeit	Zeitstempel, bis wann das Usergroup-Todo dem in AssignedTo zugewiesenen Benutzer zugewiesen ist. Nach Ablauf des zugewiesenen Zeitstempels, fällt das Todo in die Gruppe der zuweisbaren Todos, sofern es nicht zwischenzeitlich erledigt wurde. Prozess-Param: reservationDurationMinutes. Wenn definiert, wird die Reservationsdauer (Default: nächster Tag 00:00:00) für ein vom Prozess geöffnetes Usergroup-Todo übersteuert.
CompletedOn	Datum/Zeit	Zeitpunkt der Erledigung.
CompletedBy	EntityLink<User>	Benutzer, der das Todo abgeschlossen hat.
ArchivingPeriodStartedOn	Datum/Zeit	Beginn der Archivierungsfrist.
EntityContext	EntityLink	Kontext-Entität. Prozess-Context: Prozess
Remarks	String	Bemerkungen zum Todo.
Tags	String[]	Sammlung von Schlagwörtern (Tags) zum Todo. Prozess-Param: informationValue

Configs

Keine

Architektur

Todos können von verschiedenen Modulen verwendet werden. Hierzu wird beim ITodoProvider ein TodoHandler registriert, der die Schnittstelle ITodoHandler implementiert und über einen eindeutigen TodoType identifiziert wird.

Der TodoHandler ist für die Definition der GUI sowie die Erzeugung des zugrunde liegenden Datenmodells verantwortlich. Zudem wird er bei jeder Erledigung eines Todos über OnTodoCompleted benachrichtigt.

Aktuell sind folgende Handler implementiert:

• SimpleTodoHandler: Zuständig für alle Todos ohne Modulkontext (TodoType = Standalone).
• ProcessTodoHandler: Zuständig für alle Prozess-Todos (TodoType = Process).

Folgendes Code-Beispiel zeigt, wie für TodoType Process der ITodoHandler ProcessTodoHandler registriert wird:

var tp = _eisEnvironment.GetProvider<ITodoProvider>();
tp.RegisterTodoHandler("Process", new ProcessTodoHandler(this));

GUIs und zugehörige Datenobjekte mit dem Präfix TodoGui werden über den IDynamicGuiProvider an den ITodoProvider delegiert.