Z-GET06B

Dieses Dokument behandelt die folgenden Themen:


Beschreibung

Informationen über einen Termin, eine Besprechung, einen Merker oder eine Erledigung ausgeben.

Dieses Subprogramm entspricht Z-GET06A mit der Ausnahme, dass es auch die ISN eines Kalendereintrags und die Anzahl der Notizen ausgibt. Bei Kalendereinträgen, die über mehrere Tage gehen, können Sie angeben, dass nur der erste Datensatz ausgegeben wird. Informationen über geheftete Notizen können Sie mit Z-GET06C ausgeben.

Dieses Subprogramm gibt den nächsten Termin, die nächste Besprechung, den nächsten Merker oder die nächste Erledigung aus, beginnend mit dem Datum und der Zeit, die Sie in den Parametern Startdatum und Startzeit angegeben haben. An allen folgenden Tagen werden die Kalendereinträge, die über mehrere Tage gehen, ab Mitternacht ausgegeben (und nicht ab der Uhrzeit, die Sie für den ersten Tag angegeben haben).

Die Parameter Startdatum, Startzeit, Enddatum und Endzeit beziehen sich auf den gesamten Eintrag (so wie er online im "Objekt eingeben"-Schirm definiert wurde; z.B. eine Besprechung, die am 5. Mai um 10:00 beginnt und am 8. Mai um 16:00 endet).

Die ausgegebene Liste ähnelt der Liste, die mit Z-GET03B ausgegeben wird. Die Liste, die mit Z-GET06B ausgegeben wird, enthält jedoch zusätzliche Informationen: jedes Vorkommen eines Eintrags enthält Start- und Enddatum sowie Start- und Endzeit des gesamten Eintrags.

Zusätzlich zu den Parametern, die mit Z-GET03B ausgegeben werden, werden für einen Termin oder eine Besprechung die folgenden Parameter ausgegeben: Agenda, Suchbegriffe, Persoenlich-Flag, Berechtigungsstufen, Startdatum, Startzeit, Enddatum und Endzeit.

Für einen Merker oder eine Erledigung werden nur die ersten 3 Zeilen der Beschreibung ausgegeben (die Parameter Ort, Agenda und Suchbegriffe werden von Merkern und Erledigungen nicht benötigt).

Bei jedem Kalendereintrag beziehen sich die Parameter Aktuelles-Datum, Aktueller-Start und Aktuelles-Ende auf die Start- und Endzeiten jedes einzelnen Tages. Wenn ein Kalendereintrag Mitternacht überschreitet, wird der Eintrag automatisch in mehrere Tageseinträge aufgeteilt.

Bei persönlichen Kalendereinträgen, die nicht zum aufrufenden Büro gehören, werden nur Datum und Uhrzeit ausgegeben. Als Betreff des persönlichen Eintrags wird ein Stern (*) ausgegeben; Beschreibung, Ort, Agenda und Suchbegriffe werden nicht ausgegeben.

Die Zeitzone ist immer GMT. Andere Zeitzonen werden nicht berücksichtigt.

Wenn der Work-Parameter von dem aufrufenden Programm nicht zerstört wird, können Sie dieses Subprogramm iterativ aufrufen, um aufeinander folgende Termine, Besprechungen, Merker und Erledigungen auszugeben.

Parameter

Parameter Format Ein Aus Bemerkung
Return-Code N2 O X Eingabe -1: kein ET.
Buero A8 E   Das Büro, in dem der Kalendereintrag enthalten ist.
Passwort A8 E   Das Passwort des o.g. Büros.
Startdatum A8 E X Format yyyymmdd. Siehe die Beschreibung oben.
Startzeit A8 O X Format hhmm. Siehe die Beschreibung oben.
Enddatum A8   X Format yyyymmdd. Siehe die Beschreibung oben.
Endzeit A8   X Format hhmm. Siehe die Beschreibung oben.
Betreff A20   X Der Betreff des Kalendereintrags.
Beschreibung A60/1:3   X Die Beschreibung des Kalendereintrags.
Ort A60   X Der Ort, an dem die Besprechung oder der Termin stattfindet. Gilt nicht für Merker und Erledigungen.
Agenda A32   X Gilt nur für Besprechungen. Der Name des Dokuments, das mit der Besprechung verknüpft wurde.
Suchbegriffe A15/1:6   X Gilt nur für Termine und Besprechungen. Suchbegriffe sind hilfreich, wenn Sie ein Objekt suchen.
Persoenlich-Flag A1   X Markiert, wenn der Termin oder die Besprechung ein persönliches Objekt ist. Gilt nicht für Merker und Erledigungen.
Berechtigungsstufen A1/1:4   X Gilt nur für Termine und Besprechungen. Die Berechtigungsstufen für Lesen, Ändern, Kopieren und Drucken. Werte 0 bis 9.
Objektnummer N2   X 3=Termin, 16=Besprechung, 28=Merker, 43=Erledigung.
Zeitraum A1   X 1=der gesamte Zeitraum, 2=separate Einträge pro Tag, 3=nur Startzeit. Bei Merkern und Erledigungen wird 3 ausgegeben.
Keine-Zeitbelegung A1   X Leer=der Kalendereintrag belegt Zeit; linke Klammer=der Kalendereintrag belegt keine Zeit. Merker und Erledigungen belegen keine Zeit.
Aktuelles-Datum A8   X Format yyyymmdd. Siehe die Beschreibung oben.
Aktueller-Start A8   X Format hhmm. Siehe die Beschreibung oben.
Aktuelles-Ende A8   X Format hhmm. Siehe die Beschreibung oben.
Kalender-ISN P10   X Die ISN des Kalendereintrags.
Nur-erster-Satz A1 O   Wenn markiert, wird nur der erste Datensatz eines Kalendereintrags, der über mehrere Tage geht (Termin oder Besprechung) und die entsprechende ISN ausgegeben. Wenn das Datum des ersten Datensatzes vor dem Startdatum liegt, wird er nicht ausgegeben.
Notizen N2   X Die Anzahl der Notizen, die an einen Termin oder eine Besprechung geheftet sind.
Work-Parameter A40     Für den internen Gebrauch. Siehe Work-Parameter.

Return-Codes

00 Erfolg
02 Ungültiger Büroname oder - nur im Batch-Betrieb - Büro gesperrt
03 Falsches Passwort
41 Ungültiges Startdatum
42 Ungültige Startzeit
77 Ende der Liste

Subprogramme

Z-120
Z-122
Z-123
Z-160
Z-711
Z-1200&0

Beispiel

0010 *
0020 *  Informationen ueber Termin/Besprechung ausgeben
0030 *
0040 DEFINE DATA
0050 LOCAL
0060 1 RETURN-CODE         (N2)
0070 1 BUERO               (A8)
0080 1 PASSWORT            (A8)
0090 1 STARTDATUM          (A8)
0100 1 STARTZEIT           (A8)
0110 1 ENDDATUM            (A8)
0120 1 ENDZEIT             (A8)
0130 1 BETREFF             (A20)
0140 1 BESCHREIBUNG        (A60/1:3)
0150 1 ORT                 (A60)
0160 1 AGENDA              (A32)
0170 1 SUCHBEGRIFFE        (A15/1:6)
0180 1 PERSOENLICH-FLAG    (A1)
0190 1 BERECHTIGUNGSSTUFEN (A1/1:4)
0200 1 OBJEKTNUMMER        (N2)
0210 1 ZEITRAUM            (A1)
0220 1 KEINE-ZEITBELEGUNG  (A1)
0230 1 AKTUELLES-DATUM     (A8)
0240 1 AKTUELLER-START     (A8)
0250 1 AKTUELLES-ENDE      (A8)
0260 1 KALENDER-ISN        (P10) /* ISN des Datensatzes wird ausgegeben
0270 1 NUR-ERSTER-SATZ     (A1)  /* Nur der erste Datensatz, wenn der Eintrag
0280 *                              ueber mehrere Tage geht
0290 1 NOTIZEN             (N2)  /* Anzahl der Notizen wird ausgegeben
0300 1 WORK-PARAMETER      (A40)
0310 *
0320 END-DEFINE
0330 *
0340 RESET RETURN-CODE
0350 MOVE 'BUERO'    TO BUERO
0360 MOVE 'PASSWORT' TO PASSWORT
0370 MOVE '19971231' TO STARTDATUM
0380 MOVE '2000'     TO STARTZEIT
0390 MOVE 'X'        TO NUR-ERSTER-SATZ
0400 *
0410 REPEAT UNTIL RETURN-CODE NE 0
0420 *
0430   CALLNAT 'Z-GET06B' RETURN-CODE
0440     BUERO
0450     PASSWORT
0460     STARTDATUM
0470     STARTZEIT
0480     ENDDATUM
0490     ENDZEIT
0500     BETREFF
0510     BESCHREIBUNG(*)
0520     ORT
0530     AGENDA
0540     SUCHBEGRIFFE(*)
0550     PERSOENLICH-FLAG
0560     BERECHTIGUNGSSTUFEN(*)
0570     OBJEKTNUMMER
0580     ZEITRAUM
0590     KEINE-ZEITBELEGUNG
0600     AKTUELLES-DATUM
0610     AKTUELLER-START
0620     AKTUELLES-ENDE
0630     KALENDER-ISN
0640     NUR-ERSTER-SATZ
0650     NOTIZEN
0660     WORK-PARAMETER
0670 *
0680   IF KALENDER-ISN NE 0
0690     NEWPAGE
0700     WRITE
0710       '=' BUERO /
0720       '=' PASSWORT /
0730       '=' STARTDATUM
0740       '=' STARTZEIT /
0750       '=' ENDDATUM
0760       '=' ENDZEIT /
0770       '=' BETREFF /
0780       '=' BESCHREIBUNG(1) /
0790       '=' ORT /
0800       '=' AGENDA /
0810       '=' SUCHBEGRIFFE(1:3) /
0820       '=' SUCHBEGRIFFE(4:6) /
0830       '=' PERSOENLICH-FLAG
0840       '=' BERECHTIGUNGSSTUFEN(*) /
0850       '=' OBJEKTNUMMER /
0860       '=' ZEITRAUM /
0870       '=' KEINE-ZEITBELEGUNG /
0880       '=' AKTUELLES-DATUM /
0890       '=' AKTUELLER-START /
0900       '=' AKTUELLES-ENDE /
0910       '=' KALENDER-ISN /
0920       '=' NUR-ERSTER-SATZ  /
0930       '=' NOTIZEN  /
0940   END-IF
0950 END-REPEAT
0960 WRITE 'Return-Code ' RETURN-CODE
0970 END