Z-MOD06

Dieses Dokument behandelt die folgenden Themen:


Beschreibung

Einen Termin oder eine Besprechung ändern.

Wenn der Initiator die Basisdaten einer Besprechung (Datum, Uhrzeit, Betreff, Ort oder Agenda) ändert nachdem die Einladungen versendet wurden, wird eine neue Besprechungsversion erstellt und die alte Version wird als Besprechungshistorie gespeichert. Bis zu 9999 Versionen einer Besprechung können gespeichert. Solange die geänderten Einladungen nicht mit Z-MCONFM versendet werden, ist der Status der Besprechung "in Arbeit".

Wenn andere Besprechungsdaten vom Initiator oder einem Teilnehmer geändert werden (z.B. Suchbegriffe, Berechtigungsstufen, Persönlich-Flag oder Zeitbelegung), wird keine neue Version erstellt.

Der Zeitraum zwischen Startdatum und Enddatum muss entweder kleiner oder gleich 90 Tagen sein (sonst wird der Return-Code 43 ausgegeben).

Startzeit und Endzeit werden als GMT (0) interpretiert.

Wenn Startzeit und Endzeit nicht angegeben werden, wird automatisch der Zeitraum von 0:00 Uhr bis 23:59 Uhr eingetragen.

Wenn der Parameter Keine-Zeitbelegung angegeben wurde, belegt der Termin oder die Besprechung keine Zeit im Kalender. Das bedeutet, wenn ein anderer Teilnehmer eine Besprechung eingibt und den Kalender nach freier Zeit durchsucht, gilt dieser Zeitraum nicht als reserviert.

Wenn der Parameter Keine-Zeitbelegung angegeben wurde (d.h. wenn der Termin oder die Besprechung Zeit im Kalender belegt) und ein anderer Kalendereintrag den angegebenen Zeitraum bereits belegt, wird Return-Code 94 ausgegeben. Alte Versionen einer Besprechung (Historie) werden nicht berücksichtigt.

Wenn der Parameter Taegliche-Eintraege angegeben wurde, belegt der Termin oder die Besprechung an jedem Tag nur den angegebenen Zeitraum. Wenn der Parameter Taegliche-Eintraege nicht angegeben wurde, wird der gesamte Zeitraum reserviert (ab der Startzeit des ersten Tages bis zur Endzeit des letzten Tages).

Um Teilnehmer und Arbeitsmittel für eine Besprechung einzugeben, müssen Sie Z-ADDATT aufrufen.

Um Teilnehmer und Arbeitsmittel, die mit Z-ADDATT eingegeben wurden, nach dem Versenden der Einladungen wieder zu stornieren, müssen Sie Z-UNDO aufrufen.

Wenn Sie eine Besprechung ändern, müssen Sie auch die folgenden Subprogramme aufrufen:

  1. Z-STIME um die Suche nach freier Zeit zu starten wenn Sie den Parameter Freie-Zeitspanne-suchen markiert haben.

  2. Z-MCONFM um die Einladungen zu bestätigen (d.h. versenden).

Notizen können später mit Z-NOTE an den Termin oder die Besprechung geheftet werden.

Die Parameter, die nicht mit Werten gefüllt werden, werden aus der Besprechung oder dem Termin gelöscht. Um die bestehenden Werte beizubehalten, müssen Sie sie daher vor dem Aufruf dieses Subprogramms erneut angeben.

Parameter

Parameter Format Ein Aus Bemerkung
Return-Code N2 O X Eingabe -1: kein ET.
Buero A8 E   Das Büro, das den zu ändernden Kalendereintrag (Termin oder Besprechung) enthält.
Passwort A8 E   Das Passwort des o.g. Büros.
Kalender-ISN P10 E X Eingabe: die ISN des ersten Satzes des zu ändernden Kalendereintrags. Ausgabe: die ISN des ersten Satzes des geänderten Kalendereintrags.
Startdatum A8 E   Das Startdatum für den Termin oder die Besprechung. Format yyyymmdd.
Startzeit A4 O   Die Startzeit für den Termin oder die Besprechung. Format hhmm.
Enddatum A8 O   Das Enddatum für den Termin oder die Besprechung. Format yyyymmdd.
Endzeit A4 O   Die Endzeit für den Termin oder die Besprechung. Format hhmm.
Objektnummer N2 O   3=Termin, 16=Besprechung. Wenn nicht angegeben, wird der Objekttyp nicht geändert.
Taegliche-Eintraege A1 O   Wenn markiert, belegt der Termin oder die Besprechung an jedem Tag nur den angegebenen Zeitraum. Wenn nicht markiert, wird der gesamte Zeitraum reserviert (ab der Startzeit des ersten Tages bis zur Endzeit des letzten Tages).
Vorhandene-Eintraege-ignorieren A1 O   Wenn markiert, wird der Termin oder die Besprechung geändert obwohl der Zeitraum bereits durch einen anderen Kalendereintrag belegt ist.
Betreff A20 E/O   Der Betreff des Termins oder der Besprechung. Sie müssen mindestens einen der folgenden Parameter angeben: Betreff, Beschreibung oder Ort.
Beschreibung A60/1:3 E/O   Eine kurze Beschreibung für den Termin oder die Besprechung. Sie müssen mindestens einen der folgenden Parameter angeben: Beschreibung, Betreff oder Ort.
Ort A60 E/O   Der Ort, an dem der Termin oder die Besprechung stattfindet. Sie müssen mindestens einen der folgenden Parameter angeben: Ort, Betreff oder Beschreibung.
Agenda A32 O   Der Name des Dokuments, das mit dem Termin oder der Besprechung verknüpft werden soll.
Suchbegriffe A15/1:6 O   Suchbegriffe sind hilfreich, wenn Sie ein Objekt suchen. Sie können bis zu 6 Suchbegriffe eingeben. Ein Suchbegriff darf keinen Stern (*) enthalten.
Persoenlich-Flag A1 O   Nur in einem Privatbüro erlaubt. Wenn gefüllt, ist der Termin oder die Besprechung ein persönliches Objekt.
Berechtigungsstufen A1/1:4 O   Die Berechtigungsstufen für Lesen, Ändern, Kopieren und Drucken. Werte 0 bis 9. Sie können auch den Wert X angeben; dies gewährleistet absoluten Schutz.
Keine-Zeitbelegung A1 O   Wenn gefüllt, belegt der Termin oder die Besprechung keine Zeit im Kalender.
Zusage-Absage A1 O   Gilt nur für eine Einladung zu einer Besprechung, die sich im Büro eines eingeladenen Teilnehmers befindet. 1=zusagen, 2=absagen und in den Kalender eintragen. Mit Z-ACCEPT oder Z-CAN06 können Sie absagen und stoppen; diese Funktion wird nicht von Z-MOD06 ausgeführt.
Freie-Zeitspanne-suchen A1 O   Wenn markiert, wird in den Besprechungsdatensätzen ein spezielles Flag gesetzt. Mit Z-STIME können Sie dann die Kalender aller Teilnehmer nach gemeinsamer freier Zeit durchsuchen. Diese Funktion wird nicht von Z-MOD06 ausgeführt.

Return-Codes

00 Erfolg
02 Ungültiger Büroname oder - nur im Batch-Betrieb - Büro gesperrt
03 Falsches Passwort
04 ISN wurde nicht gefunden
09 ISN zeigt nicht auf das richtige Objekt
13 Ungültige Objektnummer
18 API-Kontext-Buffer ist nicht verfügbar
24 Datenschutz-Sicherheitsübertretung
41 Ungültiges Startdatum
42 Ungültige Startzeit
43 Ungültiges Enddatum
44 Ungültige Endzeit
51 Ungültiger Name (Betreff, Beschreibung oder Ort fehlt)
53 Das gewünschte Objekt (Agenda) existiert nicht
54 Mindestens ein Suchbegriff war ungültig
57 Das Dokument (Agenda) enthält keinen Text
61 Ungültige Berechtigungsstufe(n)
93 Berechtigungsstufen dürfen nicht höher sein als die im Profil
94 Angegebener Zeitraum ist bereits belegt
96 Datum, Uhrzeit, Betreff, Ort oder Agenda kann nur vom Initiator geändert werden
98 Zusage/Absage kann nur von einem Teilnehmer erteilt werden, nicht vom Initiator. Oder ungültiger Wert im Parameter Zusage-Absage.

Subprogramme

N-IDATCM
N-NAMMOD
Z-0106A
Z-0106AN
Z-0106B
Z-0106C
Z-0420
Z-0420A
Z-100
Z-110
Z-120
Z-122
Z-123
Z-124
Z-135
Z-160
Z-165
Z-175
Z-180
Z-185
Z-190
Z-209
Z-216
Z-223
Z-711
Z-711A
Z-728
Z-731
Z-737
Z-740
Z-741
Z-742
Z-743
Z-751
Z-120&0

Beispiel

* Besprechung aendern
* 
DEFINE DATA
LOCAL
*
* Parameter von Z-GET06B. 
* Einige davon werden von Z-MOD06 benutzt.
*
1 RETURN-CODE         (N2)
1 BUERO               (A8)
1 PASSWORT            (A8)
1 STARTDATUM          (A8)
1 STARTZEIT           (A4)
1 ENDDATUM            (A8)
1 ENDZEIT             (A4)
1 BETREFF             (A20)
1 BESCHREIBUNG        (A60/1:3)
1 ORT                 (A60)
1 AGENDA              (A32)
1 SUCHBEGRIFFE        (A15/1:6)
1 PERSOENLICH-FLAG    (A1)
1 BERECHTIGUNGSSTUFEN (A1/1:4)
1 OBJEKTNUMMER        (N2)
1 ZEITRAUM            (A1)
1 KEINE-ZEITBELEGUNG  (A1)
1 AKTUELLES-DATUM     (A8)
1 AKTUELLER-START     (A8)
1 AKTUELLES-ENDE      (A8)
1 KALENDER-ISN        (P10) 
1 NUR-ERSTER-SATZ     (A1)
1 NOTIZEN             (N2)
1 WORK-PARAMETER      (A40)
*
*
* Restliche Parameter fuer Z-MOD06.
*
1 MOD06-RETURN-CODE       (N2)
1 TAEGLICHE-EINTRAEGE     (A1)
1 VORHANDENE-EINTRAEGE-IGNORIEREN (A1)
1 FREIE-ZEITSPANNE-SUCHEN (A1)
1 ZUSAGE-ABSAGE           (A1)
*
END-DEFINE
*
*
RESET RETURN-CODE
MOVE 'Buero'    TO BUERO
MOVE 'Passwort' TO PASSWORT
MOVE '20001231' TO STARTDATUM
MOVE '2000'     TO STARTZEIT
MOVE 'X'        TO NUR-ERSTER-SATZ
*
REPEAT UNTIL RETURN-CODE NE 0
*
* Kalenderinformation ausgeben
*
  CALLNAT 'Z-GET06B'
    RETURN-CODE
    BUERO
    PASSWORT
    STARTDATUM
    STARTZEIT
    ENDDATUM
    ENDZEIT
    BETREFF
    BESCHREIBUNG(*)
    ORT
    AGENDA
    SUCHBEGRIFFE(*)
    PERSOENLICH-FLAG
    BERECHTIGUNGSSTUFEN(*)
    OBJEKTNUMMER
    ZEITRAUM
    KEINE-ZEITBELEGUNG
    AKTUELLES-DATUM
    AKTUELLER-START
    AKTUELLES-ENDE
    KALENDER-ISN
    NUR-ERSTER-SATZ
    NOTIZEN
    WORK-PARAMETER
*
* Informationen ueber gefundene Besprechung
*
  IF RETURN-CODE EQ 0
    IF BETREFF EQ 'Dringend'
        AND OBJEKTNUMMER EQ 16
      NEWPAGE
      WRITE
        '=' BUERO /
        '=' PASSWORT /
        '=' STARTDATUM
        '=' STARTZEIT /
        '=' ENDDATUM
        '=' ENDZEIT /
        '=' BETREFF /
        '=' BESCHREIBUNG(1) /
        '=' ORT /
        '=' AGENDA /
        '=' SUCHBEGRIFFE(1:3) /
        '=' SUCHBEGRIFFE(4:6) /
        '=' PERSOENLICH-FLAG
        '=' BERECHTIGUNGSSTUFEN(1:4) /
        '=' OBJEKTNUMMER /
        '=' ZEITRAUM /
        '=' KEINE-ZEITBELEGUNG /
        '=' AKTUELLES-DATUM /
        '=' AKTUELLER-START /
        '=' AKTUELLES-ENDE /
        '=' KALENDER-ISN /
        '=' NUR-ERSTER-SATZ /
        '=' NOTIZEN /
*
* Betreff der Besprechung aendern
*
      MOVE 'Sehr-dringend' TO BETREFF
*
* Besprechung aendern. Neuer Betreff ist "Sehr-dringend".
* Teilnehmerliste besteht aus 2 Teilnehmern.
*
      IF ZEITRAUM EQ '2'         /* Taegliche Eintraege
        MOVE 'X' TO TAEGLICHE-EINTRAEGE
      ELSE
        RESET TAEGLICHE-EINTRAEGE
      END-IF
*
      CALLNAT 'Z-MOD06'
        MOD06-RETURN-CODE
        BUERO
        PASSWORT
        KALENDER-ISN
        STARTDATUM
        STARTZEIT
        ENDDATUM
        ENDZEIT
        OBJEKTNUMMER
        TAEGLICHE-EINTRAEGE
        VORHANDENE-EINTRAEGE-IGNORIEREN
        BETREFF
        BESCHREIBUNG(*)
        ORT
        AGENDA
        SUCHBEGRIFFE(*)
        PERSOENLICH-FLAG
        BERECHTIGUNGSSTUFEN(*)
        KEINE-ZEITBELEGUNG
        ZUSAGE-ABSAGE
        FREIE-ZEITSPANNE-SUCHEN
*
      IF MOD06-RETURN-CODE NE 0
        MOVE MOD06-RETURN-CODE TO RETURN-CODE
      ELSE
        ESCAPE BOTTOM
      END-IF
END-IF
  END-IF
END-REPEAT
IF RETURN-CODE = 0
  WRITE 'Besprechung wurde geaendert'
ELSE
  WRITE 'Besprechnung wurde NICHT geaendert. Return-Code: ' RETURN-CODE
END-IF
END