AddToDo

<< Hilfenavigation einblenden

Home > Handbuch > Entwicklerhilfe > Makro-Referenz OmAPI > AddToDo

AddToDo

Makro-Prozedur AddToDo

Eine neue Tätigkeit erstellen.

Syntax

{AddToDo:ForeignDB,ForeignKey,Name,UserName[,StartDate,Duration,Notes,Label,ReminderDate]}

Parameter

ForeignDB: GUID der verknüpften Archiv- oder Kontaktdatenbank. Oder:
"1" keine Verknüpfung
"2" mit Dokument in geöffnetem Archiv verknüpft
"3" mit Kontakt in geöffneter CRM-Datenbank verknüpft

ForeignKey: Schlüsselnummer des Dokuments oder Kontakts.

Name: Bezeichnung der Tätigkeit. Geben Sie kein Komma im Text ein.

UserName: Login-Name des Anwenders, für den die Tätigkeit erstellt wird. Neue User werden automatisch erstellt.

Optionale Parameter:

StartDate: Datum und Zeit der Tätigkeit, Vorgabewert ist die aktuelle Zeit.

Duration: Dauer in Minuten, Vorgabewert ist 10.

Notes: Ausführliche Beschreibung. Geben Sie kein Komma im Text ein.

Label: Hervorhebung mit Farbwerten:
-1: keine
8689404: Wichtig
14982788: Business
6610596: Persönlich
13952740: Urlaub
7649020: Teilnahmepflicht
16051844: Reise
8703700: Vorbereitung
16033476: Geburtstag
12897956: Jubiläum
7661308: Anruf

ReminderDate: Datum und Zeit der Erinnerung. Alternativ zum Datum können Sie die Anzahl der Tage vor dem Tätigkeitsbeginn angeben, beispielsweise "-6.5" steht für 6 Tage und 12 Stunden. Diese Syntax wird am Minuszeichen erkannt.

 

Rückgabewert

Keiner, die Anweisung wird nach Ausführung durch einen Leerstring ersetzt.

Syntax 2 (veraltet)

{AddToDo:Name,Type,User,Private,DocID,Popup[,TodoDate,HintDate,Period]}

Diese Syntax (erster Parameter ist keine GUID und nicht gleich "1", "2" oder "3") ist seit Version 23.0 veraltet und wird in einer zukünftigen Version entfernt. Verwenden Sie diese nicht mehr.

Beschreibung

Die Funktion erstellt eine neue Tätigkeit für den genannten User. Sinnvoll ist dies vor allem bei der zeitgesteuerten Verarbeitung der Verzeichnisüberwachung: wenn das Programm beispielsweise über Nacht die neuen Dokumente indexiert und es dabei zu Fehlern kommt, kann für den Administrator automatisch eine Tätigkeit erstellt werden. Der Administrator sieht dann am nächsten Tag die Tätigkeit zum fehlerhaften Dokument und kann entsprechend reagieren.

Die neue Aufgabe ist erst sichtbar, nachdem die Datentabelle "scheduler" neu eingelesen wurden. Dies kann mit{DBOperation:scheduler,Refresh} im Makro erfolgen oder durch Suchen in der Benutzeroberfläche.

Beispiel

{AddTodo:2,{doc:docid},Rechnung prüfen,{Self:UserName},14.09.2023 10:00:00,10}

{DBOperation:scheduler,Refresh}

Siehe auch

Makro-Referenz

DBSetField

IF-Bedingung

Aufgaben-Verwaltung